siyuan 0.8.4 → 0.8.6

package/CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog
 
-## 0.8.5 2023-09
+## 0.8.7 2023-10
+
+## 0.8.6 2023-10-17
+
+* [Update some definitions](https://github.com/siyuan-note/petal/pull/17)
+
+## 0.8.5 2023-10-10
+
+* [Add plugin event bus `open-menu-doctree`](https://github.com/siyuan-note/siyuan/issues/9351)
 
 ## 0.8.4 2023-09-19
 

package/package.json

@@ -12,6 +12,6 @@
         "README.md",
         "siyuan.d.ts"
     ],
-    "version": "0.8.4",
+    "version": "0.8.6",
     "repository": "https://github.com/siyuan-note/petal"
 }

package/siyuan.d.ts

@@ -1,16 +1,19 @@
-import type * as types from "./types";
-import {IProtyle} from "./types/protyle";
+export * from "./types";
+
+import {IProtyle, Lute, Protyle, Toolbar} from "./types/protyle";
+import {IMenuBaseDetail} from "./types/events";
+import {IGetDocInfo, IGetTreeStat} from "./types/response";
 
 declare global {
-    interface Window extends Global {
+    export interface Window extends Global {
     }
 }
 
-type TEventBus = keyof IEventBusMap
+export type TEventBus = keyof IEventBusMap
 
-type TCardType = "doc" | "notebook" | "all"
+export type TCardType = "doc" | "notebook" | "all"
 
-type TProtyleAction = "cb-get-append" | // 向下滚动加载
+export type TProtyleAction = "cb-get-append" | // 向下滚动加载
     "cb-get-before" | // 向上滚动加载
     "cb-get-unchangeid" | // 上下滚动，定位时不修改 blockid
     "cb-get-hl" | // 高亮
@@ -25,7 +28,7 @@ type TProtyleAction = "cb-get-append" | // 向下滚动加载
     "cb-get-html" | // 直接渲染，不需要再 /api/block/getDocInfo，否则搜索表格无法定位
     "cb-get-history" // 历史渲染
 
-type TOperation =
+export type TOperation =
     "insert"
     | "update"
     | "delete"
@@ -57,7 +60,7 @@ type TOperation =
     | "setAttrViewColCalc"
     | "updateAttrViewColNumberFormat"
 
-type TAVCol =
+export type TAVCol =
     "text"
     | "date"
     | "number"
@@ -70,34 +73,85 @@ type TAVCol =
     | "email"
     | "phone"
 
-interface Global {
+export interface Global {
     Lute: Lute;
 }
 
-interface IEventBusMap {
-    "click-blockicon": types.events.IClickBlockIconDetail;
-    "click-editorcontent": types.events.IClickEditorContentDetail;
-    "click-editortitleicon": types.events.IClickEditorTitleIconDetail;
-    "click-pdf": types.events.IClickPdfDetail;
-    "destroy-protyle": types.events.IDestroyProtyleDetail;
-    "input-search": types.events.IInputSearchDetail;
-    "loaded-protyle-dynamic": types.events.ILoadedProtyleDynamicDetail;
-    "loaded-protyle": types.events.ILoadedProtyleDetail;
-    "open-menu-av": any;
-    "open-menu-blockref": types.events.IOpenMenuBlockRefDetail;
-    "open-menu-breadcrumbmore": types.events.IOpenMenuBreadcrumbMoreDetail;
-    "open-menu-content": types.events.IOpenMenuContentDetail;
-    "open-menu-fileannotationref": types.events.IOpenMenuFileAnnotationRefDetail;
-    "open-menu-image": types.events.IOpenMenuImageDetail;
-    "open-menu-link": types.events.IOpenMenuLinkDetail;
-    "open-menu-tag": types.events.IOpenMenuTagDetail;
-    "open-noneditableblock": types.events.IOpenNonEditableBlockDetail;
-    "open-siyuan-url-block": types.events.IOpenSiyuanUrlBlockDetail;
-    "open-siyuan-url-plugin": types.events.IOpenSiyuanUrlPluginDetail;
-    "ws-main": types.events.IWebSocketMainDetail;
+export interface IEventBusMap {
+    "click-blockicon": {
+        menu: EventMenu,
+        protyle: IProtyle,
+        blockElements: HTMLElement[],
+    };
+    "click-editorcontent": {
+        protyle: IProtyle,
+        event: MouseEvent,
+    };
+    "click-editortitleicon": {
+        menu: EventMenu,
+        protyle: IProtyle,
+        data: IGetDocInfo,
+    };
+    "click-pdf": {
+        event: MouseEvent,
+    };
+    "destroy-protyle": {
+        protyle: IProtyle,
+    };
+    "input-search": {
+        protyle: Protyle,
+        config: ISearchOption,
+        searchElement: HTMLInputElement,
+    };
+    "loaded-protyle-dynamic": {
+        protyle: IProtyle,
+        positon: "afterend" | "beforebegin",
+    };
+    "loaded-protyle": {
+        protyle: IProtyle,
+    };
+    "open-menu-av": IMenuBaseDetail & { selectRowElements: HTMLElement[] };
+    "open-menu-blockref": IMenuBaseDetail;
+    "open-menu-breadcrumbmore": {
+        menu: EventMenu,
+        protyle: IProtyle,
+        data: IGetTreeStat,
+    };
+    "open-menu-content": IMenuBaseDetail & { range: Range };
+    "open-menu-fileannotationref": IMenuBaseDetail;
+    "open-menu-image": IMenuBaseDetail;
+    "open-menu-link": IMenuBaseDetail;
+    "open-menu-tag": IMenuBaseDetail;
+    "open-menu-doctree": {
+        menu: EventMenu,
+        elements: NodeListOf<HTMLElement>,
+        type: "doc" | "docs" | "notebook",
+    };
+    "open-noneditableblock": {
+        protyle: IProtyle,
+        toolbar: Toolbar,
+    };
+    "open-siyuan-url-block": {
+        url: string,
+        id: string,
+        focus: boolean,
+        exist: boolean,
+    };
+    "open-siyuan-url-plugin": {
+        url: string,
+    };
+    "ws-main": IWebSocketData;
+}
+
+export interface IPosition {
+    x: number;
+    y: number;
+    w?: number;
+    h?: number;
+    isLeft?: boolean;
 }
 
-interface ITab {
+export interface ITab {
     id: string;
     headElement: HTMLElement;
     panelElement: HTMLElement;
@@ -112,7 +166,7 @@ interface ITab {
     close: () => void;
 }
 
-interface IModel {
+export interface IModel {
     ws: WebSocket;
     app: App;
     reqId: number;
@@ -121,7 +175,7 @@ interface IModel {
     send(cmd: string, param: Record<string, unknown>, process?: boolean): void;
 }
 
-interface ICustomModel extends IModel {
+export interface ICustomModel extends IModel {
     tab: ITab;
     data: any;
     type: string;
@@ -138,21 +192,21 @@ interface ICustomModel extends IModel {
     destroy?(): void;
 }
 
-interface IDockModel extends Omit<ICustomModel, "beforeDestroy"> {
+export interface IDockModel extends Omit<ICustomModel, "beforeDestroy"> {
 }
 
-interface ITabModel extends ICustomModel {
+export interface ITabModel extends ICustomModel {
 }
 
-interface IObject {
+export interface IObject {
     [key: string]: string;
 }
 
-interface I18N {
+export interface I18N {
     [key: string]: any;
 }
 
-interface ILuteNode {
+export interface ILuteNode {
     TokensStr: () => string;
     __internal_object__: {
         Parent: {
@@ -162,70 +216,78 @@ interface ILuteNode {
     };
 }
 
-interface ISearchOption {
-    page?: number
-    group?: number,  // 0：不分组，1：按文档分组
-    hasReplace?: boolean,
-    method?: number //  0：文本，1：查询语法，2：SQL，3：正则表达式
-    hPath?: string
-    idPath?: string[]
-    k: string
-    r?: string
+export interface ISearchOption {
+    page?: number;
+    removed?: boolean;  // 移除后需记录搜索内容 https://github.com/siyuan-note/siyuan/issues/7745
+    name?: string;
+    sort?: number;  //  0：按块类型（默认），1：按创建时间升序，2：按创建时间降序，3：按更新时间升序，4：按更新时间降序，5：按内容顺序（仅在按文档分组时），6：按相关度升序，7：按相关度降序
+    group?: number;  // 0：不分组，1：按文档分组
+    hasReplace?: boolean;
+    method?: number; //  0：文本，1：查询语法，2：SQL，3：正则表达式
+    hPath?: string;
+    idPath?: string[];
+    k: string;
+    r?: string;
     types?: {
-        mathBlock: boolean
-        table: boolean
-        blockquote: boolean
-        superBlock: boolean
-        paragraph: boolean
-        document: boolean
-        heading: boolean
-        list: boolean
-        listItem: boolean
-        codeBlock: boolean
-        htmlBlock: boolean
-        embedBlock: boolean
-    }
+        mathBlock: boolean,
+        table: boolean,
+        blockquote: boolean,
+        superBlock: boolean,
+        paragraph: boolean,
+        document: boolean,
+        heading: boolean,
+        list: boolean,
+        listItem: boolean,
+        codeBlock: boolean,
+        htmlBlock: boolean,
+        embedBlock: boolean,
+        databaseBlock: boolean,
+    };
 }
 
-interface IWebSocketData {
-    cmd: string
-    callback?: string
-    data: any
-    msg: string
-    code: number
-    sid: string
+export interface IWebSocketData {
+    cmd: string;
+    callback?: string;
+    data: any;
+    msg: string;
+    code: number;
+    sid: string;
 }
 
-interface IPluginDockTab {
-    position: "LeftTop" | "LeftBottom" | "RightTop" | "RightBottom" | "BottomLeft" | "BottomRight",
-    size: { width: number, height: number },
-    icon: string,
-    hotkey?: string,
-    title: string,
-    index?: number,
-    show?: boolean
+export interface IPluginDockTab {
+    position: "LeftTop" | "LeftBottom" | "RightTop" | "RightBottom" | "BottomLeft" | "BottomRight";
+    size: {
+        width: number,
+        height: number,
+    };
+    icon: string;
+    hotkey?: string;
+    title: string;
+    index?: number;
+    show?: boolean;
 }
 
-interface IMenuItemOption {
-    label?: string,
-    click?: (element: HTMLElement) => void,
-    type?: "separator" | "submenu" | "readonly",
-    accelerator?: string,
-    action?: string,
-    id?: string,
-    submenu?: IMenuItemOption[]
-    disabled?: boolean
-    icon?: string
-    iconHTML?: string
-    current?: boolean
-    bind?: (element: HTMLElement) => void
-    index?: number
-    element?: HTMLElement
+export interface IMenuItemOption {
+    iconClass?: string;
+    label?: string;
+    click?: (element: HTMLElement, event: MouseEvent) => boolean | void | Promise<boolean | void>;
+    type?: "separator" | "submenu" | "readonly";
+    accelerator?: string;
+    action?: string;
+    id?: string;
+    submenu?: IMenuItemOption[];
+    disabled?: boolean;
+    icon?: string;
+    iconHTML?: string;
+    current?: boolean;
+    bind?: (element: HTMLElement) => void;
+    index?: number;
+    element?: HTMLElement;
 }
 
-interface ICommandOption {
-    langKey: string, // 用于区分不同快捷键的 key
-    langText?: string, // 快捷键功能描述文本
+export interface ICommandOption {
+    langKey: string // 用于区分不同快捷键的 key
+    langText?: string // 快捷键功能描述文本
     /**
      * 目前需使用 MacOS 符号标识，顺序按照 ⌥⇧⌘，入 ⌥⇧⌘A
      * "Ctrl": "⌘",
@@ -238,59 +300,59 @@ interface ICommandOption {
      */
     hotkey: string,
     customHotkey?: string,
-    callback?: () => void   // 其余回调存在时将不会触
+    callback?: () => void // 其余回调存在时将不会触
     globalCallback?: () => void // 焦点不在应用内时执行的回调
     fileTreeCallback?: (file: any) => void // 焦点在文档树上时执行的回调
-    editorCallback?: (protyle: any) => void     // 焦点在编辑器上时执行的回调
-    dockCallback?: (element: HTMLElement) => void    // 焦点在 dock 上时执行的回调
+    editorCallback?: (protyle: any) => void // 焦点在编辑器上时执行的回调
+    dockCallback?: (element: HTMLElement) => void // 焦点在 dock 上时执行的回调
 }
 
-interface IProtyleOption {
-    action?: TProtyleAction[],
-    mode?: "preview" | "wysiwyg",
-    blockId: string
-    key?: string
+export interface IProtyleOption {
+    action?: TProtyleAction[];
+    mode?: "preview" | "wysiwyg";
+    blockId: string;
+    key?: string;
     scrollAttr?: {
         rootId: string,
         startId: string,
-        endId: string
+        endId: string,
         scrollTop: number,
         focusId?: string,
-        focusStart?: number
-        focusEnd?: number
-        zoomInId?: string
-    }
-    defId?: string
+        focusStart?: number,
+        focusEnd?: number,
+        zoomInId?: string,
+    };
+    defId?: string;
     render?: {
-        background?: boolean
-        title?: boolean
-        gutter?: boolean
-        scroll?: boolean
-        breadcrumb?: boolean
-        breadcrumbDocName?: boolean
-    }
+        background?: boolean,
+        title?: boolean,
+        gutter?: boolean,
+        scroll?: boolean,
+        breadcrumb?: boolean,
+        breadcrumbDocName?: boolean,
+    };
     typewriterMode?: boolean;
 
     after?(protyle: Protyle): void;
 }
 
-interface IOperation {
-    action: TOperation, // move， delete 不需要传 data
-    id?: string,
-    avID?: string,  // av
-    format?: string // updateAttrViewColNumberFormat 专享
-    keyID?: string // updateAttrViewCell 专享
-    rowID?: string // updateAttrViewCell 专享
-    data?: any, // updateAttr 时为  { old: IObject, new: IObject }, updateAttrViewCell 时为 {TAVCol: {content: string}}
-    parentID?: string
-    previousID?: string
-    retData?: any
-    nextID?: string // insert 专享
-    srcIDs?: string[] // insertAttrViewBlock 专享
-    name?: string // addAttrViewCol 专享
-    type?: TAVCol // addAttrViewCol 专享
-    deckID?: string // add/removeFlashcards 专享
-    blockIDs?: string[] // add/removeFlashcards 专享
+export interface IOperation {
+    action: TOperation; // move， delete 不需要传 data
+    id?: string;
+    avID?: string; // av
+    format?: string; // updateAttrViewColNumberFormat 专享
+    keyID?: string; // updateAttrViewCell 专享
+    rowID?: string; // updateAttrViewCell 专享
+    data?: any; // updateAttr 时为  { old: IObject, new: IObject }, updateAttrViewCell 时为 {TAVCol: {content: string}}
+    parentID?: string;
+    previousID?: string;
+    retData?: any;
+    nextID?: string; // insert 专享
+    srcIDs?: string[]; // insertAttrViewBlock 专享
+    name?: string; // addAttrViewCol 专享
+    type?: TAVCol; // addAttrViewCol 专享
+    deckID?: string; // add/removeFlashcards 专享
+    blockIDs?: string[]; // add/removeFlashcards 专享
 }
 
 export function fetchPost(url: string, data?: any, callback?: (response: IWebSocketData) => void, headers?: IObject): void;
@@ -308,46 +370,46 @@ export function openWindow(options: {
     width?: number,
     tab?: ITab,
     doc?: {
-        id: string,     // 块 id
+        id: string; // 块 id
     },
 }): void;
 
 export function openTab(options: {
     app: App,
     doc?: {
-        id: string,     // 块 id
-        action?: string[] // cb-get-all：获取所有内容；cb-get-focus：打开后光标定位在 id 所在的块；cb-get-hl: 打开后 id 块高亮
-        zoomIn?: boolean // 是否缩放
-    },
+        id: string, // 块 id
+        action?: string[], // cb-get-all：获取所有内容；cb-get-focus：打开后光标定位在 id 所在的块；cb-get-hl: 打开后 id 块高亮
+        zoomIn?: boolean, // 是否缩放
+    };
     pdf?: {
         path: string,
         page?: number,  // pdf 页码
         id?: string,    // File Annotation id
-    },
+    };
     asset?: {
         path: string,
-    },
-    search?: ISearchOption
+    };
+    search?: ISearchOption;
     card?: {
         type: TCardType,
         id?: string, //  cardType 为 all 时不传，否则传文档或笔记本 id
-        title?: string //  cardType 为 all 时不传，否则传文档或笔记本名称
-    },
+        title?: string, //  cardType 为 all 时不传，否则传文档或笔记本名称
+    };
     custom?: {
-        title: string,
-        icon: string,
-        data?: any
         id: string, // 插件名称+页签类型：plugin.name + tab.type
-    }
-    position?: "right" | "bottom",
-    keepCursor?: boolean // 是否跳转到新 tab 上
-    removeCurrentTab?: boolean // 在当前页签打开时需移除原有页签
-    afterOpen?: () => void // 打开后回调
+        icon: string,
+        title: string,
+        data?: any,
+    };
+    position?: "right" | "bottom";
+    keepCursor?: boolean; // 是否跳转到新 tab 上
+    removeCurrentTab?: boolean; // 在当前页签打开时需移除原有页签
+    afterOpen?: () => void; // 打开后回调
 }): ITab
 
 export function getFrontend(): "desktop" | "desktop-window" | "mobile" | "browser-desktop" | "browser-mobile";
 
-export function getBackend(): "windows" | "linux" | "darwin" | "docker" | "android" | "ios"
+export function getBackend(): "windows" | "linux" | "darwin" | "docker" | "android" | "ios";
 
 export function adaptHotkey(hotkey: string): string;
 
@@ -375,15 +437,15 @@ export abstract class Plugin {
     protyleSlash: {
         filter: string[],
         html: string,
-        id: string
-        callback(protyle: Protyle): void
+        id: string,
+        callback(protyle: Protyle): void,
     }[];
 
     constructor(options: {
         app: App,
         name: string,
-        i18n: I18N
-    })
+        i18n: I18N,
+    });
 
     onload(): void;
 
@@ -409,10 +471,10 @@ export abstract class Plugin {
      */
     addStatusBar(options: {
         element: HTMLElement,
-        position?: "right" | "left"
-    }): HTMLElement
+        position?: "right" | "left",
+    }): HTMLElement;
 
-    openSetting(): void
+    openSetting(): void;
 
     loadData(storageName: string): Promise<any>;
 
@@ -433,8 +495,8 @@ export abstract class Plugin {
         destroy?: (this: ITabModel) => void,
         resize?: (this: ITabModel) => void,
         update?: (this: ITabModel) => void,
-        init: (this: ITabModel) => void
-    }): () => ITabModel
+        init: (this: ITabModel) => void,
+    }): () => ITabModel;
 
     /**
      * Must be executed before the synchronous function.
@@ -446,10 +508,10 @@ export abstract class Plugin {
         destroy?: (this: IDockModel) => void,
         resize?: (this: IDockModel) => void,
         update?: (this: IDockModel) => void,
-        init: (this: IDockModel) => void
-    }): { config: IPluginDockTab, model: IDockModel }
+        init: (this: IDockModel) => void,
+    }): { config: IPluginDockTab, model: IDockModel };
 
-    addCommand(options: ICommandOption): void
+    addCommand(options: ICommandOption): void;
 
     addFloatLayer(options: {
         ids: string[],
@@ -457,45 +519,22 @@ export abstract class Plugin {
         x?: number,
         y?: number,
         targetElement?: HTMLElement
-    }): void
-}
-
-export class Protyle {
-
-    public protyle: any;
-
-    constructor(app: App, element: HTMLElement, options?: IProtyleOption)
-
-    isUploading(): boolean
-
-    destroy(): void
-
-    resize(): void
-
-    reload(focus: boolean): void
-
-    /**
-     * @param {boolean} [isBlock=false]
-     * @param {boolean} [useProtyleRange=false]
-     */
-    insert(html: string, isBlock?: boolean, useProtyleRange?: boolean): void
-
-    transaction(doOperations: IOperation[], undoOperations?: IOperation[]): void;
+    }): void;
 }
 
 export class Setting {
     constructor(options: {
         height?: string,
         width?: string,
-        destroyCallback?: () => void
-        confirmCallback?: () => void
-    })
+        destroyCallback?: () => void,
+        confirmCallback?: () => void,
+    });
 
     addItem(options: {
-        title: string
-        description?: string
-        actionElement?: HTMLElement
-        createActionElement?(): HTMLElement
+        title: string,
+        description?: string,
+        actionElement?: HTMLElement,
+        createActionElement?(): HTMLElement,
     }): void;
 
     open(name: string): void;
@@ -533,9 +572,9 @@ export class Dialog {
         content: string,
         width?: string
         height?: string,
-        destroyCallback?: (options?: IObject) => void
-        disableClose?: boolean
-        disableAnimation?: boolean
+        destroyCallback?: (options?: IObject) => void,
+        disableClose?: boolean,
+        disableAnimation?: boolean,
     });
 
     destroy(options?: IObject): void;
@@ -564,108 +603,12 @@ export class Menu {
     close(): void;
 }
 
-export class Lute {
-    public static WalkStop: number;
-    public static WalkSkipChildren: number;
-    public static WalkContinue: number;
-    public static Version: string;
-    public static Caret: string;
-
-    public static New(): Lute;
-
-    public static EChartsMindmapStr(text: string): string;
-
-    public static NewNodeID(): string;
-
-    public static Sanitize(html: string): string;
-
-    public static EscapeHTMLStr(str: string): string;
-
-    public static UnEscapeHTMLStr(str: string): string;
-
-    public static GetHeadingID(node: ILuteNode): string;
-
-    public static BlockDOM2Content(html: string): string;
-
-    private constructor();
-
-    public BlockDOM2Content(text: string): string;
-
-    public BlockDOM2EscapeMarkerContent(text: string): string;
-
-    public SetTextMark(enable: boolean): void;
-
-    public SetHeadingID(enable: boolean): void;
-
-    public SetProtyleMarkNetImg(enable: boolean): void;
-
-    public SetSpellcheck(enable: boolean): void;
-
-    public SetFileAnnotationRef(enable: boolean): void;
-
-    public SetSetext(enable: boolean): void;
-
-    public SetYamlFrontMatter(enable: boolean): void;
-
-    public SetChineseParagraphBeginningSpace(enable: boolean): void;
-
-    public SetRenderListStyle(enable: boolean): void;
-
-    public SetImgPathAllowSpace(enable: boolean): void;
-
-    public SetKramdownIAL(enable: boolean): void;
-
-    public BlockDOM2Md(html: string): string;
-
-    public BlockDOM2StdMd(html: string): string;
-
-    public SetGitConflict(enable: boolean): void;
-
-    public SetSuperBlock(enable: boolean): void;
-
-    public SetTag(enable: boolean): void;
-
-    public SetMark(enable: boolean): void;
-
-    public SetSub(enable: boolean): void;
-
-    public SetSup(enable: boolean): void;
-
-    public SetBlockRef(enable: boolean): void;
-
-    public SetSanitize(enable: boolean): void;
-
-    public SetHeadingAnchor(enable: boolean): void;
-
-    public SetImageLazyLoading(imagePath: string): void;
-
-    public SetInlineMathAllowDigitAfterOpenMarker(enable: boolean): void;
-
-    public SetToC(enable: boolean): void;
-
-    public SetIndentCodeBlock(enable: boolean): void;
-
-    public SetParagraphBeginningSpace(enable: boolean): void;
-
-    public SetFootnotes(enable: boolean): void;
-
-    public SetLinkRef(enalbe: boolean): void;
-
-    public SetEmojiSite(emojiSite: string): void;
-
-    public PutEmojis(emojis: IObject): void;
-
-    public SpinBlockDOM(html: string): string;
-
-    public Md2BlockDOM(html: string): string;
-
-    public SetProtyleWYSIWYG(wysiwyg: boolean): void;
-
-    public MarkdownStr(name: string, md: string): string;
+export class EventMenu {
+    public menus: IMenuItemOption[];
 
-    public IsValidLinkDest(text: string): boolean;
+    constructor();
 
-    public BlockDOM2InlineBlockDOM(html: string): string;
+    public addSeparator(index?: number): void;
 
-    public BlockDOM2HTML(html: string): string;
+    public addItem(menu: IMenuItemOption): void;
 }

package/types/events.d.ts

@@ -1,237 +1,8 @@
-import type { IProtyle } from "./protyle";
-import {Menu} from "./../siyuan";
+import type {IProtyle} from "./protyle";
+import {EventMenu} from "./../siyuan";
 
-//#region click-block-icon
-interface IBlockIconDetail {
-    menu: InstanceType<typeof Menu>;
+export interface IMenuBaseDetail {
+    menu: EventMenu;
     protyle: IProtyle;
-    data?: IDocumentData;
-    blockElements?: HTMLElement[];
+    element: HTMLElement;
 }
-
-interface IDocumentData {
-    id: string;
-    ial: Record<string, string>;
-    icon: string;
-    name: string;
-    rootID: string;
-    refIDs: string[];
-    refCount: number;
-    subFileCount: number;
-}
-
-/**
- * `click-blockicon`
- */
-export interface IClickBlockIconDetail extends IBlockIconDetail {
-    blockElements: HTMLElement[];
-}
-
-/**
- * `click-editortitleicon`
- */
-export interface IClickEditorTitleIconDetail extends IBlockIconDetail {
-    data: IDocumentData;
-}
-//#endregion click-block-icon
-
-//#region click-editor-content
-/**
- * `click-editorcontent`
- */
-export interface IClickEditorContentDetail {
-    event: PointerEvent;
-    protyle: IProtyle;
-}
-//#endregion click-editor-content
-
-//#region click-pdf
-/**
- * `click-pdf`
- */
-export interface IClickPdfDetail {
-    event: PointerEvent;
-}
-//#endregion click-pdf
-
-//#region protyle
-/**
- * `loaded-protyle`
- */
-export interface ILoadedProtyleDetail extends IProtyle {
-}
-
-/**
- * `loaded-protyle-dynamic`
- */
-export interface ILoadedProtyleDynamicDetail {
-    protyle: IProtyle;
-    positon: string;
-}
-
-/**
- * `destroy-protyle`
- */
-export interface IDestroyProtyleDetail {
-    protyle: IProtyle;
-}
-//#endregion protyle
-
-//#region input-search
-interface IInputSearchConfig {
-    removed: boolean;
-    k: string;
-    r: string;
-    hasReplace: boolean;
-    method: number;
-    hPath: string;
-    idPath: string[];
-    group: number;
-    sort: number;
-    types: {
-        blockquote: boolean;
-        codeBlock: boolean;
-        document: boolean;
-        embedBlock: boolean;
-        heading: boolean;
-        htmlBlock: boolean;
-        list: boolean;
-        listItem: boolean;
-        mathBlock: boolean;
-        paragraph: boolean;
-        superBlock: boolean;
-        table: boolean;
-    };
-    page: number;
-}
-
-interface IInputSearchProtyle {
-    protyle: IProtyle;
-}
-
-/**
- * `input-search`
- */
-export interface IInputSearchDetail {
-    config: IInputSearchConfig;
-    protyle: IInputSearchProtyle;
-    searchElement: HTMLInputElement;
-}
-//#endregion input-search
-
-//#region open-menu
-interface IMenuBaseDetail {
-    menu: InstanceType<typeof Menu>;
-    protyle: IProtyle;
-}
-
-interface IMenuInlineDetail extends IMenuBaseDetail {
-    element: HTMLSpanElement,
-}
-
-interface IBreadcrumbData {
-    imageCount: number;
-    linkCount: number;
-    refCount: number;
-    runeCount: number;
-    wordCount: number;
-}
-
-/**
- * `open-menu-breadcrumbmore`
- */
-export interface IOpenMenuBreadcrumbMoreDetail extends IMenuBaseDetail {
-    data: IBreadcrumbData;
-}
-
-/**
- * `open-menu-content`
- */
-export interface IOpenMenuContentDetail extends IMenuBaseDetail {
-    element: HTMLDivElement,
-    range: Range;
-}
-
-/**
- * `open-menu-blockref`
- */
-export interface IOpenMenuBlockRefDetail extends IMenuInlineDetail {
-}
-
-/**
- * `open-menu-fileannotationref`
- */
-export interface IOpenMenuFileAnnotationRefDetail extends IMenuInlineDetail {
-}
-
-/**
- * `open-menu-image`
- */
-export interface IOpenMenuImageDetail extends IMenuInlineDetail {
-}
-
-/**
- * `open-menu-link`
- */
-export interface IOpenMenuLinkDetail extends IMenuInlineDetail {
-}
-
-/**
- * `open-menu-tag`
- */
-export interface IOpenMenuTagDetail extends IMenuInlineDetail {
-}
-//#endregion open-menu
-
-//#region open-noneditableblock
-interface INonEditableBlockToolbar {
-    element: HTMLDivElement;
-    range: Range;
-    subElement: HTMLDivElement;
-    subElementCloseCB: () => any;
-    toolbarHeight: number;
-}
-
-/**
- * `open-noneditableblock`
- */
-export interface IOpenNonEditableBlockDetail {
-    protyle: IProtyle;
-    toolbar: INonEditableBlockToolbar;
-}
-//#endregion open-noneditableblock
-
-//#region open-siyuan-url
-interface IOpenSiyuanUrlDetail {
-    url: string;
-}
-
-/**
- * `open-siyuan-url-block`
- */
-export interface IOpenSiyuanUrlBlockDetail extends IOpenSiyuanUrlDetail {
-    id: string;
-    focus: boolean;
-    exist: boolean;
-}
-
-/**
- * `open-siyuan-url-plugin`
-*/
-export interface IOpenSiyuanUrlPluginDetail extends IOpenSiyuanUrlDetail {
-}
-//#endregion open-siyuan-url
-
-//#region ws-main
-/**
- * `ws-main`
- */
-export interface IWebSocketMainDetail {
-    cmd?: string
-    callback?: string
-    data?: any
-    msg: string
-    code: number
-    sid?: string
-}
-//#endregion ws-main

package/types/index.d.ts

@@ -1,2 +1,3 @@
-export * as events from "./events";
-export * as protyle from "./protyle";
+export * from "./events";
+export * from "./protyle";
+export * from "./response";

package/types/protyle.d.ts

@@ -1,4 +1,4 @@
-import {App, Lute} from "./../siyuan";
+import {App, ILuteNode, IObject, IOperation, IPosition, IProtyleOption} from "./../siyuan";
 
 // REF: https://github.com/siyuan-note/siyuan/blob/dev/app/src/types/protyle.d.ts
 export interface IProtyle {
@@ -52,3 +52,162 @@ export interface IProtyle {
     undo?: any;
     wysiwyg?: any;
 }
+
+export class Protyle {
+
+    public protyle: IProtyle;
+
+    constructor(app: App, element: HTMLElement, options?: IProtyleOption)
+
+    isUploading(): boolean
+
+    destroy(): void
+
+    resize(): void
+
+    reload(focus: boolean): void
+
+    /**
+     * @param {boolean} [isBlock=false]
+     * @param {boolean} [useProtyleRange=false]
+     */
+    insert(html: string, isBlock?: boolean, useProtyleRange?: boolean): void
+
+    transaction(doOperations: IOperation[], undoOperations?: IOperation[]): void;
+}
+
+export class Toolbar {
+    public element: HTMLElement;
+    public subElement: HTMLElement;
+    public subElementCloseCB: () => void;
+    public range: Range;
+
+    constructor(protyle: IProtyle)
+
+    public render(protyle: IProtyle, range: Range, event?: KeyboardEvent)
+
+    public showContent(protyle: IProtyle, range: Range, nodeElement: Element)
+
+    public showWidget(protyle: IProtyle, nodeElement: HTMLElement, range: Range)
+
+    public showTpl(protyle: IProtyle, nodeElement: HTMLElement, range: Range)
+
+    public showCodeLanguage(protyle: IProtyle, languageElement: HTMLElement)
+
+    public showRender(protyle: IProtyle, renderElement: Element, updateElements?: Element[], oldHTML?: string)
+
+    public setInlineMark(protyle: IProtyle, type: string, action: "range" | "toolbar", textObj?: {
+        color?: string,
+        type: string
+    })
+
+    public getCurrentType(range: Range): string[]
+
+    public showAssets(protyle: IProtyle, position: IPosition, avCB?: (url: string) => void)
+}
+
+export class Lute {
+    public static WalkStop: number;
+    public static WalkSkipChildren: number;
+    public static WalkContinue: number;
+    public static Version: string;
+    public static Caret: string;
+
+    public static New(): Lute;
+
+    public static EChartsMindmapStr(text: string): string;
+
+    public static NewNodeID(): string;
+
+    public static Sanitize(html: string): string;
+
+    public static EscapeHTMLStr(str: string): string;
+
+    public static UnEscapeHTMLStr(str: string): string;
+
+    public static GetHeadingID(node: ILuteNode): string;
+
+    public static BlockDOM2Content(html: string): string;
+
+    private constructor();
+
+    public BlockDOM2Content(text: string): string;
+
+    public BlockDOM2EscapeMarkerContent(text: string): string;
+
+    public SetTextMark(enable: boolean): void;
+
+    public SetHeadingID(enable: boolean): void;
+
+    public SetProtyleMarkNetImg(enable: boolean): void;
+
+    public SetSpellcheck(enable: boolean): void;
+
+    public SetFileAnnotationRef(enable: boolean): void;
+
+    public SetSetext(enable: boolean): void;
+
+    public SetYamlFrontMatter(enable: boolean): void;
+
+    public SetChineseParagraphBeginningSpace(enable: boolean): void;
+
+    public SetRenderListStyle(enable: boolean): void;
+
+    public SetImgPathAllowSpace(enable: boolean): void;
+
+    public SetKramdownIAL(enable: boolean): void;
+
+    public BlockDOM2Md(html: string): string;
+
+    public BlockDOM2StdMd(html: string): string;
+
+    public SetGitConflict(enable: boolean): void;
+
+    public SetSuperBlock(enable: boolean): void;
+
+    public SetTag(enable: boolean): void;
+
+    public SetMark(enable: boolean): void;
+
+    public SetSub(enable: boolean): void;
+
+    public SetSup(enable: boolean): void;
+
+    public SetBlockRef(enable: boolean): void;
+
+    public SetSanitize(enable: boolean): void;
+
+    public SetHeadingAnchor(enable: boolean): void;
+
+    public SetImageLazyLoading(imagePath: string): void;
+
+    public SetInlineMathAllowDigitAfterOpenMarker(enable: boolean): void;
+
+    public SetToC(enable: boolean): void;
+
+    public SetIndentCodeBlock(enable: boolean): void;
+
+    public SetParagraphBeginningSpace(enable: boolean): void;
+
+    public SetFootnotes(enable: boolean): void;
+
+    public SetLinkRef(enalbe: boolean): void;
+
+    public SetEmojiSite(emojiSite: string): void;
+
+    public PutEmojis(emojis: IObject): void;
+
+    public SpinBlockDOM(html: string): string;
+
+    public Md2BlockDOM(html: string): string;
+
+    public SetProtyleWYSIWYG(wysiwyg: boolean): void;
+
+    public MarkdownStr(name: string, md: string): string;
+
+    public IsValidLinkDest(text: string): boolean;
+
+    public BlockDOM2InlineBlockDOM(html: string): string;
+
+    public BlockDOM2HTML(html: string): string;
+}

package/types/response.d.ts

@@ -0,0 +1,20 @@
+import {IObject} from "../siyuan";
+
+export interface IGetDocInfo {
+    ial: IObject;
+    icon: string;
+    id: string;
+    name: string;
+    refCount: number;
+    refIDs: string[];
+    rootID: string;
+    subFileCount: number;
+}
+
+export interface IGetTreeStat {
+    imageCount: number;
+    linkCount: number;
+    refCount: number;
+    runeCount: number;
+    wordCount: number;
+}