@wangeditor-kai/editor 5.6.37

package/dist/core/src/utils/dom.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @description DOM 操作 part1 - DOM7 文档 https://framework7.io/docs/dom7.html
+ * @author wangfupeng
+ */
+import $, { Dom7Array } from 'dom7';
+import DOMNode = globalThis.Node;
+import DOMComment = globalThis.Comment;
+import DOMElement = globalThis.Element;
+import DOMText = globalThis.Text;
+import DOMRange = globalThis.Range;
+import DOMSelection = globalThis.Selection;
+import DOMStaticRange = globalThis.StaticRange;
+export { Dom7Array } from 'dom7';
+export default $;
+export declare enum NodeType {
+    ELEMENT_NODE = 1,
+    TEXT_NODE = 3,
+    CDATA_SECTION_NODE = 4,
+    PROCESSING_INSTRUCTION_NODE = 7,
+    COMMENT_NODE = 8,
+    DOCUMENT_NODE = 9,
+    DOCUMENT_TYPE_NODE = 10,
+    DOCUMENT_FRAGMENT_NODE = 11
+}
+export declare const isDocument: (value: any) => value is Document;
+export declare const isShadowRoot: (value: any) => value is ShadowRoot;
+export declare const isDataTransfer: (value: any) => value is DataTransfer;
+export declare const isUnprocessedListElement: (el: Element) => boolean;
+export declare const isHTMLElememt: (value: any) => value is HTMLElement;
+export { DOMComment, DOMElement, DOMNode, DOMRange, DOMSelection, DOMStaticRange, DOMText, };
+export type DOMPoint = [Node, number];
+/**
+ * Returns the host window of a DOM node
+ */
+export declare const getDefaultView: (value: any) => Window | null;
+/**
+ * Check if a value is a DOM node.
+ */
+export declare const isDOMNode: (value: any) => value is DOMNode;
+/**
+ * Check if a DOM node is a comment node.
+ */
+export declare const isDOMComment: (value: any) => value is DOMComment;
+/**
+ * Check if a DOM node is an element node.
+ */
+export declare const isDOMElement: (value: any) => value is DOMElement;
+/**
+ * Check if a value is a DOM selection.
+ */
+export declare const isDOMSelection: (value: any) => value is DOMSelection;
+/**
+ * Check if a DOM node is an element node.
+ */
+export declare const isDOMText: (value: any) => value is DOMText;
+/**
+ * Checks whether a paste event is a plaintext-only event.
+ */
+export declare const isPlainTextOnlyPaste: (event: ClipboardEvent) => boolean | null;
+/**
+ * Normalize a DOM point so that it always refers to a text node.
+ */
+export declare const normalizeDOMPoint: (domPoint: DOMPoint) => DOMPoint;
+/**
+ * Determines wether the active element is nested within a shadowRoot
+ */
+export declare const hasShadowRoot: () => boolean;
+/**
+ * Get the element with the specified id
+ */
+export declare const getElementById: (id: string) => null | HTMLElement;
+/**
+ * Get the nearest editable child and index at `index` in a `parent`, preferring `direction`.
+ */
+export declare const getEditableChildAndIndex: (parent: DOMElement, index: number, direction: "forward" | "backward") => [DOMNode, number];
+/**
+ * Get the nearest editable child at `index` in a `parent`, preferring
+ * `direction`.
+ */
+export declare const getEditableChild: (parent: DOMElement, index: number, direction: "forward" | "backward") => DOMNode;
+/**
+ * Get a plaintext representation of the content of a node, accounting for block
+ * elements which get a newline appended.
+ *
+ * The domNode must be attached to the DOM.
+ */
+export declare const getPlainText: (domNode: DOMNode) => string;
+/**
+ * 在下级节点中找到第一个 void elem
+ * @param elem elem
+ */
+export declare function getFirstVoidChild(elem: DOMElement): DOMElement | null;
+/**
+ * 遍历一个 elem 内所有的 text node ，执行函数
+ * @param elem elem
+ * @param handler handler
+ */
+export declare function walkTextNodes(elem: DOMElement, handler: (textNode: DOMNode, parent: DOMElement) => void): void;
+/**
+ * 获取 tagName lower-case
+ * @param $elem $elem
+ */
+export declare function getTagName($elem: Dom7Array): string;

package/dist/core/src/utils/hotkeys.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @description 快捷键
+ * @author wangfupeng
+ */
+/**
+ * Hotkeys.
+ */
+declare const _default: {
+    isBold: (event: KeyboardEvent) => boolean;
+    isCompose: (event: KeyboardEvent) => boolean;
+    isMoveBackward: (event: KeyboardEvent) => boolean;
+    isMoveForward: (event: KeyboardEvent) => boolean;
+    isDeleteBackward: (event: KeyboardEvent) => boolean;
+    isDeleteForward: (event: KeyboardEvent) => boolean;
+    isDeleteLineBackward: (event: KeyboardEvent) => boolean;
+    isDeleteLineForward: (event: KeyboardEvent) => boolean;
+    isDeleteWordBackward: (event: KeyboardEvent) => boolean;
+    isDeleteWordForward: (event: KeyboardEvent) => boolean;
+    isExtendBackward: (event: KeyboardEvent) => boolean;
+    isExtendForward: (event: KeyboardEvent) => boolean;
+    isExtendLineBackward: (event: KeyboardEvent) => boolean;
+    isExtendLineForward: (event: KeyboardEvent) => boolean;
+    isItalic: (event: KeyboardEvent) => boolean;
+    isMoveLineBackward: (event: KeyboardEvent) => boolean;
+    isMoveLineForward: (event: KeyboardEvent) => boolean;
+    isMoveWordBackward: (event: KeyboardEvent) => boolean;
+    isMoveWordForward: (event: KeyboardEvent) => boolean;
+    isRedo: (event: KeyboardEvent) => boolean;
+    isSplitBlock: (event: KeyboardEvent) => boolean;
+    isTransposeCharacter: (event: KeyboardEvent) => boolean;
+    isUndo: (event: KeyboardEvent) => boolean;
+    isTab: (event: KeyboardEvent) => boolean;
+    isSelectAll: (event: KeyboardEvent) => boolean;
+};
+export default _default;

package/dist/core/src/utils/key.d.ts

@@ -0,0 +1,11 @@
+/**
+ * An auto-incrementing identifier for keys.
+ */
+/**
+ * A class that keeps track of a key string. We use a full class here because we
+ * want to be able to use them as keys in `WeakMap` objects.
+ */
+export declare class Key {
+    id: string;
+    constructor();
+}

package/dist/core/src/utils/line.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @description Utilities for single-line deletion
+ */
+import { Range } from 'slate';
+import { IDomEditor } from '../editor/interface';
+/**
+ * A helper utility that returns the end portion of a `Range`
+ * which is located on a single line.
+ *
+ * @param {Editor} editor The editor object to compare against
+ * @param {Range} parentRange The parent range to compare against
+ * @returns {Range} A valid portion of the parentRange which is one a single line
+ */
+export declare const findCurrentLineRange: (editor: IDomEditor, parentRange: Range) => Range;

package/dist/core/src/utils/ua.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @description 通过 UA 判断浏览器
+ * @author wangfupeng
+ */
+export declare const IS_IOS: boolean;
+export declare const IS_APPLE: boolean;
+export declare const IS_FIREFOX: boolean;
+export declare const IS_FIREFOX_LEGACY: boolean;
+export declare const IS_SAFARI: boolean;
+export declare const IS_EDGE_LEGACY: boolean;
+export declare const IS_CHROME_LEGACY: boolean;
+export declare const IS_CHROME: boolean;
+export declare const IS_QQBROWSER: boolean;
+export declare const HAS_BEFORE_INPUT_SUPPORT: boolean;

package/dist/core/src/utils/util.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @description 工具函数
+ * @author wangfupeng
+ */
+/**
+ * 获取随机数字符串
+ * @param prefix 前缀
+ * @returns 随机数字符串
+ */
+export declare function genRandomStr(prefix?: string): string;
+export declare function promiseResolveThen(fn: Function): void;
+/**
+ * 追加 url query 参数
+ * @param url url
+ * @param data data
+ */
+export declare function addQueryToUrl(url: string, data: object): string;
+/**
+ * 替换 html 特殊字符，如 > 替换为 >
+ * @param str html str
+ */
+export declare function replaceHtmlSpecialSymbols(str: string): string;
+/**
+ *【反转】替换 html 特殊字符，如 > 替换为 >
+ * @param str html str
+ */
+export declare function deReplaceHtmlSpecialSymbols(str: string): string;
+export declare const toString: (val: unknown) => string;

package/dist/core/src/utils/vdom.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @description vdom 相关方法
+ * @author wangfupeng
+ */
+import { VNode, VNodeStyle, Props, Dataset } from 'snabbdom';
+export type PatchFn = (oldVnode: VNode | Element, vnode: VNode) => VNode;
+/**
+ * 创建 snabbdom patch
+ * @returns snabbdom patch 函数
+ */
+export declare function genPatchFn(): PatchFn;
+/**
+ * 整理 vnode.data ，将暴露出来的零散属性（如 id className data-xxx）放在 data.props 或 data.dataset
+ * @param vnode vnode
+ */
+export declare function normalizeVnodeData(vnode: VNode): void;
+/**
+ * 给 vnode 添加 prop
+ * @param vnode vnode
+ * @param newProp { key: val }
+ */
+export declare function addVnodeProp(vnode: VNode, newProp: Props): void;
+/**
+ * 给 vnode 添加 dataset
+ * @param vnode vnode
+ * @param newDataset { key: val }
+ */
+export declare function addVnodeDataset(vnode: VNode, newDataset: Dataset): void;
+/**
+ * 给 vnode 添加样式
+ * @param vnode vnode
+ * @param newStyle { key: val }
+ */
+export declare function addVnodeStyle(vnode: VNode, newStyle: VNodeStyle): void;

package/dist/core/src/utils/weak-maps.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @description 对象关联关系（部分参考 slate-react weak-maps.ts）
+ * @author wangfupeng
+ */
+import { Emitter } from 'event-emitter';
+import { Ancestor, Editor, Node, Path, Range } from 'slate';
+import { VNode } from 'snabbdom';
+import { IEditorConfig } from '../config/interface';
+import { IDomEditor } from '../editor/interface';
+import HoverBar from '../menus/bar/HoverBar';
+import Toolbar from '../menus/bar/Toolbar';
+import { IBarItem } from '../menus/bar-item/index';
+import PanelAndModal from '../menus/panel-and-modal/BaseClass';
+import TextArea from '../text-area/TextArea';
+import { PatchFn } from '../utils/vdom';
+import { Key } from './key';
+export declare const EDITOR_TO_TEXTAREA: WeakMap<IDomEditor, TextArea>;
+export declare const TEXTAREA_TO_EDITOR: WeakMap<TextArea, IDomEditor>;
+export declare const TOOLBAR_TO_EDITOR: WeakMap<Toolbar, IDomEditor>;
+export declare const EDITOR_TO_TOOLBAR: WeakMap<IDomEditor, Toolbar>;
+export declare const HOVER_BAR_TO_EDITOR: WeakMap<HoverBar, IDomEditor>;
+export declare const EDITOR_TO_HOVER_BAR: WeakMap<IDomEditor, HoverBar>;
+export declare const BAR_ITEM_TO_EDITOR: WeakMap<IBarItem, IDomEditor>;
+export declare const EDITOR_TO_PANEL_AND_MODAL: WeakMap<IDomEditor, Set<PanelAndModal>>;
+export declare const PANEL_OR_MODAL_TO_EDITOR: WeakMap<PanelAndModal, IDomEditor>;
+export declare const EDITOR_TO_CONFIG: WeakMap<IDomEditor, IEditorConfig>;
+export declare const IS_FIRST_PATCH: WeakMap<TextArea, boolean>;
+export declare const TEXTAREA_TO_PATCH_FN: WeakMap<TextArea, PatchFn>;
+export declare const TEXTAREA_TO_VNODE: WeakMap<TextArea, VNode>;
+export declare const NODE_TO_VNODE: WeakMap<Node, [number, VNode]>;
+export declare const NODE_TO_HTML: WeakMap<Node, String>;
+/**
+ * Two weak maps that allow us rebuild a path given a node. They are populated
+ * at render time such that after a render occurs we can always backtrack.
+ */
+export declare const NODE_TO_INDEX: WeakMap<Node, number>;
+export declare const NODE_TO_PARENT: WeakMap<Node, Ancestor>;
+/**
+ * Weak maps that allow us to go between Slate nodes and DOM nodes. These
+ * are used to resolve DOM event-related logic into Slate actions.
+ */
+export declare const EDITOR_TO_ELEMENT: WeakMap<Editor, HTMLElement>;
+export declare const EDITOR_TO_PLACEHOLDER: WeakMap<Editor, string>;
+export declare const ELEMENT_TO_NODE: WeakMap<HTMLElement, Node>;
+export declare const KEY_TO_ELEMENT: WeakMap<Key, HTMLElement>;
+export declare const NODE_TO_ELEMENT: WeakMap<Node, HTMLElement>;
+export declare const NODE_TO_KEY: WeakMap<Node, Key>;
+export declare const EDITOR_TO_WINDOW: WeakMap<Editor, Window>;
+/**
+ * Weak maps for storing editor-related state.
+ */
+export declare const IS_FOCUSED: WeakMap<Editor, boolean>;
+export declare const IS_DRAGGING: WeakMap<Editor, boolean>;
+export declare const IS_CLICKING: WeakMap<Editor, boolean>;
+export declare const CHANGING_NODE_PATH: WeakMap<Editor, Path>;
+export declare const EDITOR_TO_SELECTION: WeakMap<Editor, Range>;
+export declare const EDITOR_TO_EMITTER: WeakMap<Editor, Emitter>;
+export declare const EDITOR_TO_CAN_PASTE: WeakMap<Editor, boolean>;