artalk 2.9.0 → 2.10.0

package/dist/main.d.cts

@@ -52,7 +52,7 @@ declare interface ActionBtnOptions {
     confirmText?: string;
 }
 
-declare class Api extends Api_2<void> {
+export declare class Api extends Api_2<void> {
     private _opts;
     constructor(opts: ApiOptions);
     /**
@@ -828,6 +828,44 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
             msg?: string;
         }>>;
     };
+    sso: {
+        /**
+         * @description Validates a third-party OIDC access token by calling the issuer's /userinfo endpoint, requires a verified email claim, then mints an Artalk session JWT. Use when the surrounding application already runs OIDC and you want Artalk comments to inherit that session without showing Artalk's own login UI.
+         *
+         * @tags Auth
+         * @name AuthSsoExchange
+         * @summary Exchange an external IdP access token for an Artalk JWT
+         * @request POST:/sso/exchange
+         * @response `200` `HandlerResponseUserLogin` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `401` `(HandlerMap & {
+         msg?: string,
+
+         })` Unauthorized
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         * @response `502` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Gateway
+         * @response `503` `(HandlerMap & {
+         msg?: string,
+
+         })` Service Unavailable
+         */
+        authSsoExchange: (body: HandlerParamsAuthSSOExchange, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserLogin, HandlerMap & {
+            msg?: string;
+        }>>;
+    };
     stats: {
         /**
          * @description Get the statistics of various data analysis
@@ -1186,12 +1224,40 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
             msg?: string;
         }>>;
         /**
-         * @description Vote for a specific comment or page
+         * @description Get vote status for a specific comment or page
+         *
+         * @tags Vote
+         * @name GetVote
+         * @summary Get Vote Status
+         * @request GET:/votes/{target_name}/{target_id}
+         * @response `200` `HandlerResponseVote` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        getVote: (targetName: "comment" | "page", targetId: number, params?: RequestParams) => Promise<HttpResponse<HandlerResponseVote, HandlerMap & {
+            msg?: string;
+        }>>;
+        /**
+         * @description Create a new vote for a specific comment or page
          *
          * @tags Vote
-         * @name Vote
-         * @summary Vote
-         * @request POST:/votes/{type}/{target_id}
+         * @name CreateVote
+         * @summary Create Vote
+         * @request POST:/votes/{target_name}/{target_id}/{choice}
          * @response `200` `HandlerResponseVote` OK
          * @response `403` `(HandlerMap & {
          msg?: string,
@@ -1206,7 +1272,7 @@ 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 & {
+        createVote: (targetName: "comment" | "page", targetId: number, choice: "up" | "down", vote: HandlerParamsVoteCreate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseVote, HandlerMap & {
             msg?: string;
         }>>;
     };
@@ -1233,7 +1299,7 @@ declare interface ApiHandlerPayload {
     need_auth_login: object;
 }
 
-declare interface ApiHandlers {
+export declare interface ApiHandlers {
     add: <T extends PayloadKey>(action: T, handler: (data: ApiHandlerPayload[T]) => Promise<void>) => void;
     remove: (action: PayloadKey) => void;
     get: () => ApiHandler[];
@@ -1268,14 +1334,14 @@ export declare interface ApiVersionData {
  * @see https://artalk.js.org
  */
 declare class Artalk {
-    ctx: ContextApi;
-    constructor(conf: Partial<ArtalkConfig>);
+    ctx: Context;
+    constructor(conf: ConfigPartial);
     /** Get the config of Artalk */
-    getConf(): ArtalkConfig;
+    getConf(): Config;
     /** Get the root element of Artalk */
     getEl(): HTMLElement;
     /** Update config of Artalk */
-    update(conf: Partial<ArtalkConfig>): this;
+    update(conf: ConfigPartial): void;
     /** Reload comment list of Artalk */
     reload(): void;
     /** Destroy instance of Artalk */
@@ -1289,135 +1355,32 @@ declare class Artalk {
     /** Set dark mode */
     setDarkMode(darkMode: boolean): void;
     /** Init Artalk */
-    static init(conf: Partial<ArtalkConfig>): Artalk;
+    static init(conf: ConfigPartial): Artalk;
     /** Use plugin, the plugin will be used when Artalk.init */
     static use<T = any>(plugin: ArtalkPlugin<T>, options?: T): void;
     /** Load count widget */
-    static loadCountWidget(c: Partial<ArtalkConfig>): void;
+    static loadCountWidget(c: ConfigPartial): void;
     /** @deprecated Please use `getEl()` instead */
     get $root(): HTMLElement;
     /** @description Please use `getConf()` instead */
-    get conf(): ArtalkConfig;
+    get conf(): Config;
 }
 export default Artalk;
 
-export declare interface ArtalkConfig {
-    /** 装载元素 */
-    el: string | HTMLElement;
-    /** 页面唯一标识（完整 URL） */
-    pageKey: string;
-    /** 页面标题 */
-    pageTitle: string;
-    /** 服务器地址 */
-    server: string;
-    /** 站点名 */
-    site: string;
-    /** 评论框占位字符 */
-    placeholder: string;
-    /** 评论为空时显示字符 */
-    noComment: string;
-    /** 发送按钮文字 */
-    sendBtn: string;
-    /** 评论框穿梭（显示在待回复评论后面） */
-    editorTravel: boolean;
-    /** 表情包 */
-    emoticons: object | any[] | string | false;
-    /** Gravatar 头像 */
-    gravatar: {
-        /** API 地址 */
-        mirror: string;
-        /** API 参数 */
-        params: string;
-    };
-    /** 头像链接生成器 */
-    avatarURLBuilder?: (comment: CommentData) => string;
-    /** 分页配置 */
-    pagination: {
-        /** 每次请求获取数量 */
-        pageSize: number;
-        /** 阅读更多模式 */
-        readMore: boolean;
-        /** 滚动到底部自动加载 */
-        autoLoad: boolean;
-    };
-    /** 内容限高 */
-    heightLimit: {
-        /** 评论内容限高 */
-        content: number;
-        /** 子评论区域限高 */
-        children: number;
-        /** 滚动限高 */
-        scrollable: boolean;
-    };
-    /** 评论投票按钮 */
-    vote: boolean;
-    /** 评论投票反对按钮 */
-    voteDown: boolean;
-    /** 评论预览功能 */
-    preview: boolean;
-    /** 评论数绑定元素 Selector */
-    countEl: string;
-    /** PV 数绑定元素 Selector */
-    pvEl: string;
-    /** 统计组件 PageKey 属性名 */
-    statPageKeyAttr: string;
-    /** 夜间模式 */
-    darkMode: boolean | 'auto';
-    /** 请求超时（单位：秒） */
-    reqTimeout: number;
-    /** 平铺模式 */
-    flatMode: boolean | 'auto';
-    /** 嵌套模式 · 最大层数 */
-    nestMax: number;
-    /** 嵌套模式 · 排序方式 */
-    nestSort: 'DATE_ASC' | 'DATE_DESC';
-    /** 显示 UA 徽标 */
-    uaBadge: boolean;
-    /** 评论列表排序功能 (显示 Dropdown) */
-    listSort: boolean;
-    /** 图片上传功能 */
-    imgUpload: boolean;
-    /** 图片上传器 */
-    imgUploader?: (file: File) => Promise<string>;
-    /** Image lazy load */
-    imgLazyLoad?: 'native' | 'data-src';
-    /** 版本检测 */
-    versionCheck: boolean;
-    /** 引用后端配置 */
-    useBackendConf: boolean;
-    /** 语言本地化 */
-    locale: I18n | string;
-    /** 后端版本 (系统数据，用户不允许更改) */
-    apiVersion?: string;
-    /** Plugin script urls */
-    pluginURLs?: string[];
-    /** Replacer for marked */
-    markedReplacers?: ((raw: string) => string)[];
-    /** Marked options */
-    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;
-    pvAdd?: boolean;
-    beforeSubmit?: (editor: EditorApi, next: () => void) => void;
-}
+export declare type ArtalkConfig = Config;
 
-export declare type ArtalkPlugin<T = any> = (ctx: ContextApi, options?: T) => void;
+export declare type ArtalkPlugin<T = any> = (ctx: Context, options?: T) => void;
 
 declare namespace ArtalkType {
     export {
         I18n,
         I18nKeys,
+        Api,
+        ApiHandlers,
+        Config,
+        ConfigPartial,
         ArtalkConfig,
-        LocalUser,
+        ConfigManager,
         CommentData,
         ListData,
         PageData,
@@ -1430,19 +1393,35 @@ declare namespace ArtalkType {
         ApiVersionData,
         ListFetchParams,
         ListLastFetchData,
+        DataManager,
         DataManagerApi,
         NotifyLevel,
         UserInfoApiResponseData,
         FetchError,
+        Context,
         ContextApi,
+        LocalUser,
+        UserManager,
+        List,
+        ListLayout,
         EditorState,
+        Editor,
         EditorApi,
+        EditorPluginManager,
         ListErrorData,
         ListFetchedArgs,
         EventPayloadMap,
+        EventHandler,
+        Event_2 as Event,
+        EventOptions,
+        EventManager,
         ArtalkPlugin,
+        SidebarLayer,
         SidebarShowPayload,
-        Layer
+        Layer,
+        LayerManager,
+        CheckerManager,
+        Services
     }
 }
 export { ArtalkType }
@@ -1475,30 +1454,26 @@ declare interface CheckerCtx {
     set<K extends keyof CheckerStore>(key: K, val: CheckerStore[K]): void;
     getOpts(): CheckerLauncherOptions;
     getApi(): Api;
-    getUser(): User;
+    getUser(): UserManager;
     hideInteractInput(): void;
     triggerSuccess(): void;
     cancel(): void;
 }
 
-/**
- * Checker 发射台
- */
-declare class CheckerLauncher {
-    private opts;
-    constructor(opts: CheckerLauncherOptions);
-    checkCaptcha: (payload: CheckerCaptchaPayload) => Promise<void>;
-    checkAdmin: (payload: CheckerPayload) => Promise<void>;
-    fire(checker: Checker, payload: CheckerPayload, postFire?: (c: CheckerCtx) => void): void;
-}
-
 declare interface CheckerLauncherOptions {
-    getCtx: () => ContextApi;
     getApi: () => Api;
+    getLayers: () => LayerManager;
+    getUser: () => UserManager;
     getCaptchaIframeURL: () => string;
     onReload: () => void;
 }
 
+export declare interface CheckerManager {
+    checkCaptcha: (payload: CheckerCaptchaPayload) => Promise<void>;
+    checkAdmin: (payload: CheckerPayload) => Promise<void>;
+    check: (checker: Checker, payload: CheckerPayload, beforeCheck?: (c: CheckerCtx) => void) => void;
+}
+
 declare interface CheckerPayload {
     onSuccess?: () => void;
     onMount?: (dialogEl: HTMLElement) => void;
@@ -1518,7 +1493,7 @@ declare class CommentActions {
     private getApi;
     constructor(comment: CommentNode);
     /** 投票操作 */
-    vote(type: 'up' | 'down'): void;
+    vote(choice: 'up' | 'down'): void;
     /** 管理员 - 评论状态修改 */
     adminEdit(type: 'collapsed' | 'pending' | 'pinned', btnElem: ActionBtn): void;
     /** 管理员 - 评论删除 */
@@ -1645,14 +1620,6 @@ declare class CommentNode {
     getOpts(): CommentOptions;
 }
 
-declare type CommentNode_2 = {
-    id: number;
-    comment: CommentData;
-    children: CommentNode_2[];
-    parent?: CommentNode_2;
-    level: number;
-};
-
 declare interface CommentOptions {
     onAfterRender?: () => void;
     onDelete?: (c: CommentNode) => void;
@@ -1663,14 +1630,14 @@ declare interface CommentOptions {
     voteDown: boolean;
     uaBadge: boolean;
     nestMax: number;
-    gravatar: ArtalkConfig['gravatar'];
-    heightLimit: ArtalkConfig['heightLimit'];
-    avatarURLBuilder: ArtalkConfig['avatarURLBuilder'];
-    scrollRelativeTo: ArtalkConfig['scrollRelativeTo'];
-    dateFormatter: ArtalkConfig['dateFormatter'];
+    gravatar: Config['gravatar'];
+    heightLimit: Config['heightLimit'];
+    avatarURLBuilder: Config['avatarURLBuilder'];
+    scrollRelativeTo: Config['scrollRelativeTo'];
+    dateFormatter: Config['dateFormatter'];
     getApi: () => Api;
-    replyComment: ContextApi['replyComment'];
-    editComment: ContextApi['editComment'];
+    replyComment: Context['replyComment'];
+    editComment: Context['editComment'];
 }
 
 declare interface CommonApiVersionData {
@@ -1686,23 +1653,175 @@ declare interface CommonConfData {
 
 declare interface CommonJSONResult {
     /** Data */
-    data: any;
+    data?: any;
     /** Message */
-    msg: string;
+    msg?: string;
 }
 
 declare type CommonMap = Record<string, any>;
 
-declare abstract class Component {
-    ctx: ContextApi;
-    $el: HTMLElement;
-    get conf(): ArtalkConfig;
-    constructor(ctx: ContextApi);
-    getEl(): HTMLElement;
+export declare interface Config {
+    /** Element selector or Element to mount the Artalk */
+    el: string | HTMLElement;
+    /** Unique page identifier */
+    pageKey: string;
+    /** Title of the page */
+    pageTitle: string;
+    /** Server address */
+    server: string;
+    /** Site name */
+    site: string;
+    /** Placeholder text for the comment input box */
+    placeholder: string;
+    /** Text to display when there are no comments */
+    noComment: string;
+    /** Text for the send button */
+    sendBtn: string;
+    /** Movable comment box (display below the comment to be replied) */
+    editorTravel: boolean;
+    /** Emoticons settings */
+    emoticons: object | any[] | string | false;
+    /** Gravatar avatar settings */
+    gravatar: {
+        /** API endpoint */
+        mirror: string;
+        /** API parameters */
+        params: string;
+    };
+    /** Avatar URL generator function */
+    avatarURLBuilder?: (comment: CommentData) => string;
+    /** Pagination settings */
+    pagination: {
+        /** Number of comments to fetch per request */
+        pageSize: number;
+        /** "Read more" mode */
+        readMore: boolean;
+        /** Automatically load more comments when scrolled to the bottom */
+        autoLoad: boolean;
+    };
+    /** Height limit configuration */
+    heightLimit: {
+        /** Maximum height for comment content */
+        content: number;
+        /** Maximum height for child comments */
+        children: number;
+        /** Whether the content is scrollable */
+        scrollable: boolean;
+    };
+    /** Voting feature for comments */
+    vote: boolean;
+    /** Downvote button for comments */
+    voteDown: boolean;
+    /** Page Vote Widget */
+    pageVote: {
+        /** Up Vote Button Selector */
+        upBtnEl: string;
+        /** Down Vote Button Selector */
+        downBtnEl: string;
+        /** Up Vote Count Selector */
+        upCountEl: string;
+        /** Down Vote Count Selector */
+        downCountEl: string;
+        /** Active class name if the vote is already cast */
+        activeClass: string;
+    } | boolean;
+    /** Preview feature for comments */
+    preview: boolean;
+    /** Selector for the element binding to the comment count */
+    countEl: string;
+    /** Selector for the element binding to the page views (PV) count */
+    pvEl: string;
+    /** Attribute name for the PageKey in statistics components */
+    statPageKeyAttr: string;
+    /** Dark mode settings */
+    darkMode: boolean | 'auto';
+    /** Request timeout (in seconds) */
+    reqTimeout: number;
+    /** Flat mode for comment display */
+    flatMode: boolean | 'auto';
+    /** Maximum number of levels for nested comments */
+    nestMax: number;
+    /** Sorting order for nested comments */
+    nestSort: 'DATE_ASC' | 'DATE_DESC';
+    /** Display UA badge (user agent badge) */
+    uaBadge: boolean;
+    /** Show sorting dropdown for comment list */
+    listSort: boolean;
+    /** Enable image upload feature */
+    imgUpload: boolean;
+    /** Image uploader function */
+    imgUploader?: (file: File) => Promise<string>;
+    /** Image lazy load mode */
+    imgLazyLoad: false | 'native' | 'data-src';
+    /** Enable version check */
+    versionCheck: boolean;
+    /**
+     * Use remote configuration (from the backend server)
+     *
+     * @deprecated
+     * The `useBackendConf` is always `true` and planned to be removed in the future.
+     *
+     * Please use `preferRemoteConf` to control the priority of the remote and local configuration.
+     *
+     * @default true
+     */
+    useBackendConf: boolean;
+    /**
+     * Prefer to use the local configuration if available
+     *
+     * @note
+     * If `true`, the local config will be used as a fallback (remote config first).
+     *
+     * If `false`, the local config will override the remote config (local config first).
+     *
+     * @default false
+     */
+    preferRemoteConf: boolean;
+    /** Localization settings */
+    locale: I18n | string;
+    /** Backend API version (system data, not allowed for user modification) */
+    apiVersion: string;
+    /** URLs for plugin scripts */
+    pluginURLs?: string[];
+    /** Replacers for the marked (Markdown parser) */
+    markedReplacers?: ((raw: string) => string)[];
+    /** Options for the marked (Markdown parser) */
+    markedOptions?: MarkedOptions;
+    /** Modifier for list fetch request parameters */
+    listFetchParamsModifier?: (params: any) => void;
+    /**
+     * Custom date formatter
+     * @param date - The Date object to format
+     * @returns Formatted date string
+     */
+    dateFormatter?: (date: Date) => string;
+    /** List unread highlight (enable by default in artalk-sidebar) */
+    listUnreadHighlight: boolean;
+    /** The relative element for scrolling (useful if artalk is in a scrollable container) */
+    scrollRelativeTo?: () => HTMLElement;
+    /** Page view increment when comment list is loaded */
+    pvAdd: boolean;
+    /** Immediately fetch comments when Artalk instance is initialized */
+    fetchCommentsOnInit: boolean;
+    /** Callback before submitting a comment */
+    beforeSubmit?: (editor: Editor, next: () => void) => void;
+}
+
+export declare interface ConfigManager {
+    watchConf: Context['watchConf'];
+    get: () => Config;
+    update: (conf: ConfigPartial) => void;
 }
 
+export declare type ConfigPartial = DeepPartial<Config>;
+
+declare type Constructor<T, S = Services_2, D extends readonly (keyof S)[] = any> = (...args: {
+    [K in keyof D]: D[K] extends keyof S ? S[D[K]] : never;
+}) => T;
+
 declare enum ContentType {
     Json = "application/json",
+    JsonApi = "application/vnd.api+json",
     FormData = "multipart/form-data",
     UrlEncoded = "application/x-www-form-urlencoded",
     Text = "text/plain"
@@ -1711,32 +1830,72 @@ declare enum ContentType {
 /**
  * Artalk Context
  */
-export declare interface ContextApi extends EventManagerFuncs<EventPayloadMap> {
-    /** Artalk 根元素对象 */
-    $root: HTMLElement;
-    /** 依赖注入函数 */
-    inject<K extends keyof TInjectedServices>(depName: K, obj: TInjectedServices[K]): void;
-    /** 获取依赖对象 */
-    get<K extends keyof TInjectedServices>(depName: K): TInjectedServices[K];
-    /** 配置对象 */
-    conf: ArtalkConfig;
-    /** marked 依赖对象 */
+export declare interface Context extends EventManager<EventPayloadMap>, DependencyContainer<Services> {
+    /** @deprecated Use `getData()` or `inject('data')` instead. */
+    readonly data: Services['data'];
+    /** @deprecated Use `getUser()` or `inject('user')` instead. */
+    readonly user: Services['user'];
+    /** @deprecated Use `inject('editor')` instead. */
+    readonly editor: Services['editor'];
+    /** @deprecated Use `inject('list')` instead. */
+    readonly list: Services['list'];
+    /** @deprecated Use `inject('layers')` instead. */
+    readonly layerManager: Services['layers'];
+    /** @deprecated Use `inject('checkers')` instead. */
+    readonly checkerLauncher: Services['checkers'];
+    /** @deprecated Use `inject('sidebar')` instead. */
+    readonly sidebarLayer: Services['sidebar'];
+    /** @deprecated Use `inject('editorPlugs')` instead. */
+    readonly editorPlugs: Services['editorPlugs'];
+    /**
+     * The root element of Artalk
+     *
+     * @deprecated Use `getEl()` instead
+     */
+    readonly $root: HTMLElement;
+    /** Get the root element */
+    getEl(): HTMLElement;
+    /**
+     * Inject a dependency object
+     *
+     * @deprecated Use `inject()` instead
+     */
+    get<T extends keyof Services>(key: T): Services[T];
+    /**
+     * Get config object
+     *
+     * @deprecated Use `getConf()` and `updateConf()` instead
+     */
+    readonly conf: Config;
+    /** Get the config */
+    getConf(): Config;
+    /** Update the config */
+    updateConf(conf: ConfigPartial): void;
+    /** Watch the config */
+    watchConf<T extends (keyof Config)[]>(keys: T, effect: (val: Pick<Config, T[number]>) => void): void;
+    /** Get the marked instance */
     getMarked(): Marked | undefined;
-    /** 获取 API 以供 HTTP 请求 */
+    /** Set dark mode */
+    setDarkMode(darkMode: boolean | 'auto'): void;
+    /** Translate i18n message */
+    $t(key: keyof I18n, args?: {
+        [key: string]: string;
+    }): string;
+    /** Get HTTP API client */
     getApi(): Api;
-    /** Get API handlers */
+    /** Get HTTP API handlers */
     getApiHandlers(): ApiHandlers;
-    /** 获取数据管理器对象 */
-    getData(): DataManagerApi;
-    /** 评论回复 */
-    replyComment(commentData: CommentData, $comment: HTMLElement): void;
-    /** 编辑评论 */
-    editComment(commentData: CommentData, $comment: HTMLElement): void;
-    /** 获取评论数据 */
+    /** Get Data Manager */
+    getData(): DataManager;
+    /** Get User Manager */
+    getUser(): UserManager;
+    /** Fetch comments */
     fetch(params: Partial<ListFetchParams>): void;
-    /** 重载评论数据 */
+    /** Reload comments */
     reload(): void;
-    /** 列表滚动到第一个评论的位置 */
+    /** Destroy */
+    destroy(): void;
+    /** Goto the first comment of the list */
     listGotoFirst(): void;
     /** Get the comment data list */
     getComments(): CommentData[];
@@ -1752,39 +1911,32 @@ export declare interface ContextApi extends EventManagerFuncs<EventPayloadMap> {
      * @deprecated Use `getCommentNodes()` instead
      */
     getCommentList(): CommentNode[];
-    /** 显示侧边栏 */
-    showSidebar(payload?: SidebarShowPayload): void;
-    /** 隐藏侧边栏 */
-    hideSidebar(): void;
-    /** 编辑器 - 显示加载 */
+    /** Reply to a comment */
+    replyComment(commentData: CommentData, $comment: HTMLElement): void;
+    /** Edit a comment */
+    editComment(commentData: CommentData, $comment: HTMLElement): void;
+    /** Show loading of the editor */
     editorShowLoading(): void;
-    /** 编辑器 - 隐藏加载 */
+    /** Hide loading of the editor */
     editorHideLoading(): void;
-    /** 编辑器 - 显示提示消息 */
+    /** Show notify of the editor */
     editorShowNotify(msg: string, type: NotifyLevel): void;
-    /** 评论框 - 复原状态 */
+    /** Reset the state of the editor */
     editorResetState(): void;
-    /** 验证码检测 */
+    /** Show the sidebar */
+    showSidebar(payload?: SidebarShowPayload): void;
+    /** Hide the sidebar */
+    hideSidebar(): void;
+    /** Check captcha */
     checkCaptcha(payload: CheckerCaptchaPayload): Promise<void>;
-    /** 管理员检测 */
+    /** Check admin */
     checkAdmin(payload: CheckerPayload): Promise<void>;
-    /** i18n 翻译 */
-    $t(key: keyof I18n, args?: {
-        [key: string]: string;
-    }): string;
-    /** 设置夜间模式 */
-    setDarkMode(darkMode: boolean | 'auto'): void;
-    /** 获取配置 */
-    getConf(): ArtalkConfig;
-    /** 获取挂载元素 */
-    getEl(): HTMLElement;
-    /** 更新配置 */
-    updateConf(conf: Partial<ArtalkConfig>): void;
-    /** 监听配置更新 */
-    watchConf<T extends (keyof ArtalkConfig)[]>(keys: T, effect: (val: Pick<ArtalkConfig, T[number]>) => void): void;
 }
 
-export declare interface DataManagerApi {
+/** @deprecated Use `Context` instead. */
+export declare type ContextApi = Context;
+
+export declare interface DataManager {
     getLoading(): boolean;
     setLoading(val: boolean): void;
     getListLastFetch(): ListLastFetchData | undefined;
@@ -1803,35 +1955,40 @@ export declare interface DataManagerApi {
     updatePage(pageData: PageData): void;
 }
 
-declare class Editor extends Component implements EditorApi {
-    private ui;
-    private state;
-    getUI(): EditorUI;
-    getPlugs(): PlugManager | undefined;
-    getState(): EditorState;
-    constructor(ctx: ContextApi);
-    getHeaderInputEls(): {
-        name: HTMLInputElement;
-        email: HTMLInputElement;
-        link: HTMLInputElement;
-    };
-    getContentFinal(): string;
-    getContentRaw(): string;
-    getContentMarked(): string;
-    setContent(val: string): void;
-    insertContent(val: string): void;
-    focus(): void;
-    reset(): void;
-    resetState(): void;
-    setReply(comment: CommentData, $comment: HTMLElement): void;
-    setEditComment(comment: CommentData, $comment: HTMLElement): void;
-    showNotify(msg: string, type: any): void;
-    showLoading(): void;
-    hideLoading(): void;
-    submit(): void;
+/** @deprecated Use `DataManager` instead. */
+export declare type DataManagerApi = DataManager;
+
+declare type DeepPartial<T> = T extends (...args: any[]) => unknown ? T : T extends Element | Date | RegExp ? T : T extends readonly unknown[] ? {
+    [K in keyof T]: DeepPartial<T[K]>;
+} : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+
+export declare const Defaults: Readonly<RequiredExcept<Config, ExcludedKeys>>;
+
+declare interface DependencyContainer<S = Services_2> {
+    provide<K extends keyof S, T extends S[K] = any, D extends readonly (keyof S)[] = any>(key: K, impl: Constructor<T, S, D>, deps?: D, opts?: ProvideFuncOptions): void;
+    inject<T = undefined, K extends keyof S = any>(key: K): T extends undefined ? S[K] : T;
 }
 
-export declare interface EditorApi extends Component {
+export declare interface Editor {
+    /**
+     * Get the editor element
+     *
+     * @deprecated Use `getEl()` instead.
+     */
+    readonly $el: HTMLElement;
+    /**
+     * Get editor options
+     */
+    getOptions(): EditorOptions;
+    /**
+     * Get the editor element
+     */
+    getEl(): HTMLElement;
+    /**
+     * Get the editor UI instance
+     */
     getUI(): EditorUI;
     /**
      * Get the header input elements
@@ -1896,13 +2053,36 @@ export declare interface EditorApi extends Component {
     /**
      * Start replying a comment
      */
+    setReplyComment(commentData: CommentData, $comment: HTMLElement, scroll?: boolean): void;
+    /**
+     * Start replying to a comment
+     *
+     * @deprecated Use `setReplyComment()` instead.
+     */
     setReply(commentData: CommentData, $comment: HTMLElement, scroll?: boolean): void;
     /**
      * Start editing a comment
      */
     setEditComment(commentData: CommentData, $comment: HTMLElement): void;
+    /**
+     * Get plugin manager
+     */
+    getPlugins(): PluginManager | undefined;
+    /**
+     * Get plugin manager
+     *
+     * @deprecated Use `getPlugins()` instead.
+     */
+    getPlugs(): PluginManager | undefined;
+    /**
+     * Set plugin manager
+     */
+    setPlugins(plugins: PluginManager): void;
 }
 
+/** @deprecated Use `Editor` instead. */
+export declare type EditorApi = Editor;
+
 declare interface EditorEventPayloadMap {
     mounted: undefined;
     unmounted: undefined;
@@ -1915,17 +2095,24 @@ declare interface EditorEventPayloadMap {
         $input: HTMLInputElement;
     };
     'content-updated': string;
-    'panel-show': EditorPlug;
-    'panel-hide': EditorPlug;
+    'panel-show': EditorPlugin;
+    'panel-hide': EditorPlugin;
     'panel-close': undefined;
     'editor-close': undefined;
     'editor-open': undefined;
+    'editor-submit': undefined;
+    'editor-submitted': undefined;
+}
+
+declare interface EditorOptions {
+    getEvents: () => EventManager;
+    getConf: () => ConfigManager;
 }
 
 /**
  * Editor 插件
  */
-declare class EditorPlug {
+declare class EditorPlugin {
     protected kit: PlugKit;
     $btn?: HTMLElement;
     $panel?: HTMLElement;
@@ -1947,6 +2134,17 @@ declare class EditorPlug {
     useEditorStateEffect(stateName: EditorState, effectFn: (comment: CommentData) => () => void): void;
 }
 
+export declare interface EditorPluginManager {
+    getPlugins: () => EditorPlugin[];
+    getEvents: () => EventManager<EditorEventPayloadMap>;
+    getEditor: () => Editor;
+    getOptions: () => PluginManagerOptions;
+    get<T extends typeof EditorPlugin>(plug: T): InstanceType<T> | undefined;
+    openPluginPanel: (plug: EditorPlugin) => void;
+    closePluginPanel: () => void;
+    getTransformedContent: (rawContent: string) => string;
+}
+
 export declare type EditorState = 'reply' | 'edit' | 'normal';
 
 declare interface EditorUI extends Record<keyof typeof Sel, HTMLElement> {
@@ -2053,8 +2251,8 @@ declare const en: {
     accountMergeConfirm: string;
     dismiss: string;
     merge: string;
-    frontend: string;
-    backend: string;
+    client: string;
+    server: string;
     loading: string;
     loadFail: string;
     editing: string;
@@ -2078,7 +2276,7 @@ declare interface EntityCookedComment {
     date: string;
     email_encrypted: string;
     id: number;
-    ip_region: string;
+    ip_region?: string;
     is_allow_reply: boolean;
     is_collapsed: boolean;
     is_pending: boolean;
@@ -2153,31 +2351,37 @@ declare interface EntityCookedUserForAdmin {
     receive_email: boolean;
 }
 
-declare type EventHandler<T> = (payload: T) => void;
+declare interface Event_2<T, K extends keyof T = keyof T> extends EventOptions {
+    name: K;
+    handler: EventHandler<T[K]>;
+}
+export { Event_2 as Event }
+
+export declare type EventHandler<T> = (payload: T) => void;
 
-declare class EventManager<PayloadMap> implements EventManagerFuncs<PayloadMap> {
+export declare interface EventManager<T = EventPayloadMap> {
+    on<K extends keyof T>(name: K, handler: EventHandler<T[K]>, opts?: EventOptions): void;
+    off<K extends keyof T>(name: K, handler: EventHandler<T[K]>): void;
+    trigger<K extends keyof T>(name: K, payload?: T[K]): void;
+}
+
+declare class EventManager_2<T> implements EventManager<T> {
     private events;
     /**
      * Add an event listener for a specific event name
      */
-    on<K extends keyof PayloadMap>(name: K, handler: EventHandler<PayloadMap[K]>, opts?: EventOptions): void;
+    on<K extends keyof T>(name: K, handler: EventHandler<T[K]>, opts?: EventOptions): void;
     /**
      * Remove an event listener for a specific event name and handler
      */
-    off<K extends keyof PayloadMap>(name: K, handler: EventHandler<PayloadMap[K]>): void;
+    off<K extends keyof T>(name: K, handler: EventHandler<T[K]>): void;
     /**
      * Trigger an event with an optional payload
      */
-    trigger<K extends keyof PayloadMap>(name: K, payload?: PayloadMap[K]): void;
-}
-
-declare interface EventManagerFuncs<PayloadMap> {
-    on<K extends keyof PayloadMap>(name: K, handler: EventHandler<PayloadMap[K]>, opts?: EventOptions): void;
-    off<K extends keyof PayloadMap>(name: K, handler: EventHandler<PayloadMap[K]>): void;
-    trigger<K extends keyof PayloadMap>(name: K, payload?: PayloadMap[K]): void;
+    trigger<K extends keyof T>(name: K, payload?: T[K]): void;
 }
 
-declare interface EventOptions {
+export declare interface EventOptions {
     once?: boolean;
 }
 
@@ -2185,7 +2389,7 @@ declare interface EventOptions {
 export declare interface EventPayloadMap {
     created: undefined;
     mounted: undefined;
-    updated: ArtalkConfig;
+    updated: Config;
     unmounted: undefined;
     'list-fetch': Partial<ListFetchParams>;
     'list-fetched': ListFetchedArgs;
@@ -2208,6 +2412,8 @@ export declare interface EventPayloadMap {
     'sidebar-hide': undefined;
 }
 
+declare type ExcludedKeys = FunctionKeys<Config>;
+
 export declare interface FetchError extends Error {
     code: number;
     message: string;
@@ -2233,8 +2439,17 @@ declare interface FullRequestParams extends Omit<RequestInit, 'body'> {
     cancelToken?: CancelToken;
 }
 
+declare type FunctionKeys<T> = Exclude<{
+    [K in keyof T]: NonNullable<T[K]> extends (...args: any[]) => any ? K : never;
+}[keyof T], undefined>;
+
 declare type HandlerMap = Record<string, any>;
 
+declare interface HandlerParamsAuthSSOExchange {
+    /** External IdP access token (e.g. an Auth0 access token) */
+    token: string;
+}
+
 declare interface HandlerParamsCaptchaVerify {
     /** The captcha value to check */
     value: string;
@@ -2412,7 +2627,7 @@ declare interface HandlerParamsUserUpdate {
     receive_email: boolean;
 }
 
-declare interface HandlerParamsVote {
+declare interface HandlerParamsVoteCreate {
     /** The user email */
     email?: string;
     /** The username */
@@ -2483,7 +2698,7 @@ declare interface HandlerResponseCommentCreate {
     date: string;
     email_encrypted: string;
     id: number;
-    ip_region: string;
+    ip_region?: string;
     is_allow_reply: boolean;
     is_collapsed: boolean;
     is_pending: boolean;
@@ -2512,7 +2727,7 @@ declare interface HandlerResponseCommentGet {
 declare interface HandlerResponseCommentList {
     comments: EntityCookedComment[];
     count: number;
-    page: EntityCookedPage;
+    page?: EntityCookedPage;
     roots_count: number;
 }
 
@@ -2524,7 +2739,7 @@ declare interface HandlerResponseCommentUpdate {
     date: string;
     email_encrypted: string;
     id: number;
-    ip_region: string;
+    ip_region?: string;
     is_allow_reply: boolean;
     is_collapsed: boolean;
     is_pending: boolean;
@@ -2705,6 +2920,8 @@ declare interface HandlerResponseUserUpdate {
 
 declare interface HandlerResponseVote {
     down: number;
+    is_down: boolean;
+    is_up: boolean;
     up: number;
 }
 
@@ -2750,54 +2967,21 @@ export declare interface Layer {
     getEl: () => HTMLElement;
 }
 
-declare class Layer_2 implements Layer {
-    private $el;
-    private opts;
-    private allowMaskClose;
-    private onAfterHide?;
-    constructor($el: HTMLElement, opts: LayerOptions);
-    setOnAfterHide(func: () => void): void;
-    setAllowMaskClose(allow: boolean): void;
-    getAllowMaskClose(): boolean;
-    getEl(): HTMLElement;
-    show(): void;
-    hide(): void;
+export declare interface LayerManager {
+    create(name: string, el?: HTMLElement): Layer;
     destroy(): void;
-}
-
-declare class LayerManager {
-    private wrap;
-    constructor(ctx: ContextApi);
     getEl(): HTMLElement;
-    create(name: string, el?: HTMLElement): Layer_2;
 }
 
-declare interface LayerOptions {
-    onShow: () => void;
-    onHide: () => void;
-}
+declare type Lifecycle = 'transient' | 'singleton';
 
-declare interface LayoutOptions {
-    /** The comments wrap of list */
-    $commentsWrap: HTMLElement;
-    nestSortBy: ListNest.SortByType;
-    nestMax: number;
-    flatMode: boolean;
-    createCommentNode(comment: CommentData, replyComment?: CommentData): CommentNode;
-    findCommentNode(id: number): CommentNode | undefined;
-}
-
-declare class List extends Component {
-    /** 列表评论集区域元素 */
-    $commentsWrap: HTMLElement;
-    getCommentsWrapEl(): HTMLElement;
-    protected commentNodes: CommentNode[];
-    getCommentNodes(): CommentNode[];
-    constructor(ctx: ContextApi);
-    getListLayout({ forceFlatMode }?: {
+export declare interface List {
+    getEl: () => HTMLElement;
+    getCommentsWrapEl: () => HTMLElement;
+    getLayout: (arg: {
         forceFlatMode?: boolean;
-    }): ListLayout;
-    private initCrudEvents;
+    }) => ListLayout;
+    getCommentNodes: () => CommentNode[];
 }
 
 export declare interface ListData {
@@ -2836,20 +3020,9 @@ export declare interface ListLastFetchData {
     data?: ListData;
 }
 
-declare class ListLayout {
-    private options;
-    constructor(options: LayoutOptions);
-    private getStrategy;
-    import(comments: CommentData[]): void;
-    insert(comment: CommentData, replyComment?: CommentData): void;
-}
-
-declare namespace ListNest {
-    export {
-        makeNestCommentNodeList,
-        CommentNode_2 as CommentNode,
-        SortByType
-    }
+export declare interface ListLayout {
+    import: (comments: CommentData[]) => void;
+    insert: (comment: CommentData, replyComment?: CommentData) => void;
 }
 
 export declare const loadCountWidget: typeof Artalk.loadCountWidget;
@@ -2872,8 +3045,6 @@ export declare interface LocalUser {
     is_admin: boolean;
 }
 
-declare function makeNestCommentNodeList(srcData: CommentData[], sortBy?: SortByType, nestMax?: number): CommentNode_2[];
-
 export declare interface NotifyData {
     /** 通知 ID */
     id: number;
@@ -2912,57 +3083,77 @@ export declare interface PageData {
 
 declare type PayloadKey = keyof ApiHandlerPayload;
 
+declare class PluginManager implements EditorPluginManager {
+    opts: PluginManagerOptions;
+    private plugins;
+    private openedPlug;
+    private events;
+    constructor(opts: PluginManagerOptions);
+    getPlugins(): EditorPlugin[];
+    getEvents(): EventManager_2<EditorEventPayloadMap>;
+    getEditor(): Editor;
+    getOptions(): PluginManagerOptions;
+    private clear;
+    private loadPluginUI;
+    /** Load the plug btn and plug panel on editor ui */
+    private loadPluginItem;
+    get<T extends typeof EditorPlugin>(plug: T): InstanceType<T> | undefined;
+    /** Open the editor plug panel */
+    openPluginPanel(plug: EditorPlugin): void;
+    /** Close the editor plugin panel */
+    closePluginPanel(): void;
+    /** Get the content which is transformed by plugs */
+    getTransformedContent(rawContent: string): string;
+}
+
+declare interface PluginManagerOptions {
+    getArtalkRootEl: () => HTMLElement;
+    getEditor: () => Editor;
+    getConf: () => ConfigManager;
+    getUser: () => UserManager;
+    getApi: () => Api;
+    getData: () => DataManager;
+    getCheckers: () => CheckerManager;
+    onSubmitted: () => void;
+}
+
 /**
  * PlugKit provides a set of methods to help you develop editor plug
  */
 declare class PlugKit {
-    private plugs;
-    constructor(plugs: PlugManager);
+    private plugins;
+    constructor(plugins: PluginManager);
     /** Use the editor */
-    useEditor(): EditorApi;
-    /**
-     * Use the context of global
-     *
-     * @deprecated The calls to this function should be reduced as much as possible
-     */
-    useGlobalCtx(): ContextApi;
+    useEditor(): Editor;
     /** Use the config of Artalk */
-    useConf(): ArtalkConfig;
+    useConf(): Config;
     /** Use the http api client */
     useApi(): Api;
+    /** Use the data manager */
+    useData(): DataManager;
     /** Use the user manager */
-    useUser(): User;
+    useUser(): UserManager;
+    /** Use the checkers */
+    useCheckers(): CheckerManager;
     /** Use the ui of editor */
     useUI(): EditorUI;
     /** Use the events in editor scope */
-    useEvents(): EventManager<EditorEventPayloadMap>;
+    useEvents(): EventManager_2<EditorEventPayloadMap>;
     /** Listen the event when plug is mounted */
     useMounted(func: () => void): void;
     /** Listen the event when plug is unmounted */
     useUnmounted(func: () => void): void;
     /** Use the deps of other plug */
-    useDeps<T extends typeof EditorPlug>(plug: T): InstanceType<T> | undefined;
+    useDeps<T extends typeof EditorPlugin>(plug: T): InstanceType<T> | undefined;
+    /** Use the root element of artalk */
+    useArtalkRootEl(): HTMLElement;
 }
 
-declare class PlugManager {
-    editor: EditorApi;
-    private plugs;
-    private openedPlug;
-    private events;
-    getPlugs(): EditorPlug[];
-    getEvents(): EventManager<EditorEventPayloadMap>;
-    private clear;
-    constructor(editor: EditorApi);
-    private loadPluginUI;
-    /** Load the plug btn and plug panel on editor ui */
-    private loadPluginItem;
-    get<T extends typeof EditorPlug>(plug: T): InstanceType<T> | undefined;
-    /** Open the editor plug panel */
-    openPlugPanel(plug: EditorPlug): void;
-    /** Close the editor plug panel */
-    closePlugPanel(): void;
-    /** Get the content which is transformed by plugs */
-    getTransformedContent(rawContent: string): string;
+declare type PrimitiveKey = string | number | symbol;
+
+declare interface ProvideFuncOptions {
+    /** Lifecycle (default: 'singleton') */
+    lifecycle?: Lifecycle;
 }
 
 declare type QueryParamsType = Record<string | number, any>;
@@ -3019,6 +3210,8 @@ declare class Render {
 
 declare type RequestParams = Omit<FullRequestParams, 'body' | 'method' | 'query' | 'path'>;
 
+declare type RequiredExcept<T, K extends keyof T> = Required<Omit<T, K>> & Pick<T, K>;
+
 declare type ResponseFormat = keyof Omit<Body, 'body' | 'bodyUsed'>;
 
 declare const Sel: {
@@ -3037,42 +3230,29 @@ declare const Sel: {
     $plugPanelWrap: string;
 };
 
-/**
- * Services
- *
- * @description Call these services by `ctx.get('serviceName')` or `ctx.serviceName`
- */
-declare const services: {
-    i18n(ctx: ContextApi): void;
-    user(ctx: ContextApi): User;
-    layerManager(ctx: ContextApi): LayerManager;
-    checkerLauncher(ctx: ContextApi): CheckerLauncher;
-    editor(ctx: ContextApi): Editor;
-    list(ctx: ContextApi): List;
-    sidebarLayer(ctx: ContextApi): SidebarLayer;
-    editorPlugs(): PlugManager | undefined;
+export declare interface Services {
+    config: ConfigManager;
+    events: EventManager;
+    data: DataManager;
+    api: Api;
+    apiHandlers: ApiHandlers;
+    editor: Editor;
+    editorPlugs: EditorPluginManager | undefined;
+    list: List;
+    sidebar: SidebarLayer;
+    checkers: CheckerManager;
+    layers: LayerManager;
+    user: UserManager;
+}
+
+declare type Services_2 = {
+    [key: PrimitiveKey]: any;
 };
 
-declare class SidebarLayer extends Component {
-    layer?: Layer_2;
-    $header: HTMLElement;
-    $closeBtn: HTMLElement;
-    $iframeWrap: HTMLElement;
-    $iframe?: HTMLIFrameElement;
-    constructor(ctx: ContextApi);
-    /** Refresh iFrame when show */
-    private refreshWhenShow;
-    /** Animation timer */
-    private animTimer?;
-    /** 显示 */
-    show(conf?: SidebarShowPayload): Promise<void>;
-    /** 隐藏 */
-    hide(): void;
-    private authCheck;
-    private initLayer;
-    private createIframe;
-    private getDarkMode;
-    private iframeLoad;
+export declare interface SidebarLayer {
+    onUserChanged: () => void;
+    show: (conf?: SidebarShowPayload) => void;
+    hide: () => void;
 }
 
 export declare interface SidebarShowPayload {
@@ -3092,45 +3272,8 @@ export declare interface SiteData {
     first_url: string;
 }
 
-declare type SortByType = 'DATE_DESC' | 'DATE_ASC' | 'SRC_INDEX' | 'VOTE_UP_DESC';
-
-declare type TInjectedServices = {
-    [K in keyof TServiceInjectors]: ReturnType<TServiceInjectors[K]>;
-};
-
-declare type TKeysOnlyReturn<T extends TObjectWithFuncs, V> = {
-    [K in keyof T]: ReturnType<T[K]> extends V ? K : never;
-}[keyof T];
-
-declare type TObjectWithFuncs = {
-    [k: string]: (...args: any) => any;
-};
-
-declare type TOmitConditions = TKeysOnlyReturn<TServiceImps, void>;
-
-declare type TServiceImps = typeof services;
-
-declare type TServiceInjectors = Omit<TServiceImps, TOmitConditions>;
-
 export declare const use: typeof Artalk.use;
 
-declare class User {
-    private opts;
-    private data;
-    constructor(opts: UserOpts);
-    getData(): LocalUser;
-    /** Update user data and save to localStorage */
-    update(obj?: Partial<LocalUser>): void;
-    /**
-     * Logout
-     *
-     * @description Logout will clear login status, but not clear user data (name, email, link)
-     */
-    logout(): void;
-    /** Check if user has filled basic data */
-    checkHasBasicUserInfo(): boolean;
-}
-
 export declare interface UserData {
     /** 用户 ID */
     id: number;
@@ -3168,8 +3311,19 @@ export declare interface UserInfoApiResponseData {
     notifies_count: number;
 }
 
-declare interface UserOpts {
-    onUserChanged?: (user: LocalUser) => void;
+export declare interface UserManager {
+    getData: () => LocalUser;
+    update: (dta: Partial<LocalUser>) => void;
+    logout: () => void;
+    checkHasBasicUserInfo: () => boolean;
 }
 
 export { }
+
+
+
+declare global {
+  interface Window {
+    ArtalkPlugins?: { [name: string]: ArtalkPlugin }
+  }
+}