@ones-editor/editor 0.0.3-beta.2 → 0.0.3-beta.200

package/@ones-editor/core/src/core/doc/doc.d.ts

@@ -150,6 +150,9 @@ export interface OnesEditorRemoteUsers extends TypedEmitter<RemoteUsersEvents> {
     getFixedUserColor: (userId: string, type: 'flag' | 'selection') => string;
     destroy: () => void;
 }
+export interface OnesEditorDocVersionExtra {
+    memo?: string;
+}
 export interface DocVersion {
     version: number;
     tag?: string;
@@ -168,6 +171,8 @@ export interface DocVersion {
         userId: string;
         displayName: string;
     };
+    tagId: string;
+    extra?: OnesEditorDocVersionExtra;
 }
 export interface OnesEditorDocServerMeta {
     serverId?: string;
@@ -179,15 +184,20 @@ export interface RecognizeLinkResult {
     providerName?: string;
     url: string;
 }
+export interface InsertBlockOptions {
+    noScroll?: boolean;
+    noFocus?: boolean;
+}
+export type UpdateBlockOptions = InsertBlockOptions;
 export interface OnesEditorDoc {
     registerCallback: (callbacks: OnesEditorDocCallbacks) => void;
     unregisterCallback: (callbacks: OnesEditorDocCallbacks) => void;
     toJSON: () => DocObject;
     getContainerBlocks: (containerId: string) => DocBlock[];
     getBlockData: (containerId: string, blockIndex: number) => DocBlock;
-    localUpdateBlockText: (containerId: string, blockIndex: number, actions: DocBlockTextActions) => DocBlockText;
+    localUpdateBlockText: (containerId: string, blockIndex: number, actions: DocBlockTextActions, options?: UpdateBlockOptions) => DocBlockText;
     localUpdateBlockData: (containerId: string, blockIndex: number, delta: DocBlockDelta, newRange: OnesEditorDocRange) => DocBlock;
-    localInsertBlock: (containerId: string, blockIndex: number, data: DocBlock, newRange: OnesEditorDocRange) => DocBlock;
+    localInsertBlock: (containerId: string, blockIndex: number, data: DocBlock, newRange: OnesEditorDocRange, options?: InsertBlockOptions) => DocBlock;
     localDeleteBlock: (containerId: string, blockIndex: number, newRange: OnesEditorDocRange) => DocBlock;
     localInsertChildContainer: (containerId: string, blocks: DocBlock[]) => void;
     localDeleteChildContainers: (containerIds: string[]) => void;
@@ -234,6 +244,7 @@ export interface OnesEditorDocVersionHelper {
     revertVersion: (ver: number) => Promise<void>;
     createVersion: (tag: string, publish: boolean) => Promise<DocVersion>;
     parseHistoryData: (historyData: OnesEditorDocHistoryData, handler: OnesEditorHistoryDataParseHandler) => void;
+    updateVersionExtra: (version: number, tagId: string, extra: OnesEditorDocVersionExtra) => Promise<void>;
 }
 export interface OnesEditorComment {
     id: string;

package/@ones-editor/core/src/core/doc/rich-text/insert-text.d.ts

@@ -1,3 +1,4 @@
-import { DocBlockText, DocBlockTextActions, DocBlockTextAttributes } from '../doc';
+import { DocBlockText, DocBlockTextActions, DocBlockTextAttributes, DocBox, DocBlockTextOp } from '../doc';
 export declare function insertText(richText: DocBlockText, offset: number, text: string | DocBlockText, attributes: DocBlockTextAttributes | null): DocBlockText;
+export declare function createBoxOp(boxData: DocBox): DocBlockTextOp;
 export declare function createInsertOps(offset: number, text: string | DocBlockText, attributes: DocBlockTextAttributes | null): DocBlockTextActions;

package/@ones-editor/core/src/core/doc/to-plain-text.d.ts

@@ -3,3 +3,4 @@ export declare const FILL_CHAR = "\u200B";
 export declare function toPlainText(ops: Op[], options?: {
     boxReplacement: string;
 }): string;
+export declare function toPlainTextKeepLength(ops: Op[]): string;

package/@ones-editor/core/src/core/editor/actions/auto-insert-block.d.ts

@@ -1,3 +1,3 @@
-import { DocBlock, OnesEditorDocRange } from '../../doc';
+import { InsertBlockOptions, DocBlock, OnesEditorDocRange } from '../../doc';
 import { OnesEditor } from '../../types';
-export declare function editorAutoInsertBlock(editor: OnesEditor, blockData: DocBlock, containerId?: string, blockIndex?: number, newRange?: OnesEditorDocRange): import("../../types").BlockElement;
+export declare function editorAutoInsertBlock(editor: OnesEditor, blockData: DocBlock, containerId?: string, blockIndex?: number, newRange?: OnesEditorDocRange, insertBlockOptions?: InsertBlockOptions): import("../../types").BlockElement;

package/@ones-editor/core/src/core/editor/actions/break-text-block.d.ts

@@ -1,6 +1,8 @@
 import { BlockElement, BreakTextOptions, OnesEditor } from '../../types';
+import { DocBlockAttributes } from '../../doc';
 export interface BreakTextBlockResult {
     block: BlockElement;
     newBlock: BlockElement;
 }
+export declare function copyBlockAttributes(editor: OnesEditor, block: BlockElement): DocBlockAttributes;
 export declare function editorBreakTextBlock(editor: OnesEditor, block: BlockElement, offset: number, options?: BreakTextOptions): BreakTextBlockResult;

package/@ones-editor/core/src/core/editor/actions/delete-block-text.d.ts

@@ -1,2 +1,2 @@
-import { OnesEditor, BlockElement } from '../../types';
-export declare function editorDeleteBlockText(editor: OnesEditor, block: BlockElement, offset: number, count: number): number;
+import { OnesEditor, BlockElement, InsertTextOptions } from '../../types';
+export declare function editorDeleteBlockText(editor: OnesEditor, block: BlockElement, offset: number, count: number, options?: InsertTextOptions): number;

package/@ones-editor/core/src/core/editor/actions/focus-to-end.d.ts

@@ -1,3 +1,2 @@
 import { OnesEditor } from '../../types';
-export declare function editorSelectEnd(editor: OnesEditor): void;
 export declare function editorFocusToEnd(editor: OnesEditor): void;

package/@ones-editor/core/src/core/editor/actions/insert-block.d.ts

@@ -1,3 +1,3 @@
-import { DocBlock, OnesEditorDocRange } from '../../doc';
+import { DocBlock, InsertBlockOptions, OnesEditorDocRange } from '../../doc';
 import { OnesEditor, BlockElement } from '../../types';
-export declare function editorInsertBlock(editor: OnesEditor, containerId: string, blockIndex: number, blockData: DocBlock, newRange: OnesEditorDocRange): BlockElement;
+export declare function editorInsertBlock(editor: OnesEditor, containerId: string, blockIndex: number, blockData: DocBlock, newRange: OnesEditorDocRange, options?: InsertBlockOptions): BlockElement;

package/@ones-editor/core/src/core/editor/actions/insert-text.d.ts

@@ -1,6 +1,7 @@
-import { OnesEditor, BlockElement } from '../../types';
+import { OnesEditor, BlockElement, InsertTextOptions } from '../../types';
 import { DocBlockText, DocBox } from '../../doc';
-export declare function editorInsertTextToBlock(editor: OnesEditor, block: BlockElement, offset: number, text: string | DocBlockText): DocBlockText;
+export declare function getTextAttributes(editor: OnesEditor, containerId: string, blockIndex: number, offset: number): import("quill-delta/dist/AttributeMap").default | undefined;
+export declare function editorInsertTextToBlock(editor: OnesEditor, block: BlockElement, offset: number, text: string | DocBlockText, options?: InsertTextOptions): DocBlockText;
 export declare function editorInsertBoxToBlock(editor: OnesEditor, block: BlockElement, offset: number, boxData: DocBox): DocBlockText;
 export declare function editorInsertTextToBlockEx(editor: OnesEditor, text: string | DocBlockText, containerId: string, blockIndex: number, offset: number): DocBlockText;
 export declare function editorInsertText(editor: OnesEditor, text: string | DocBlockText): void;

package/@ones-editor/core/src/core/editor/editor-dom/dom-events.d.ts

@@ -1,5 +1,5 @@
 import { OnesEditor } from '../../types';
-export type DomEventCallback = (editor: OnesEditor, event: Event, data: unknown) => void;
+export type DomEventCallback<T = Event> = (editor: OnesEditor, event: T, data: unknown) => void;
 declare class DomEventHandler {
     editor: OnesEditor;
     dom: Element | Document | Window;
@@ -12,10 +12,10 @@ declare class DomEventHandler {
 }
 export declare class EditorDomEvents {
     private editor;
-    handlers: Map<Window | Element | Document, DomEventHandler[]>;
+    handlers: Map<Element | Document | Window, DomEventHandler[]>;
     constructor(editor: OnesEditor);
     destroy(): void;
-    addEventListener(element: Element | Document | Window, eventName: string, eventHandler: DomEventCallback, data?: unknown): void;
+    addEventListener<T = Event>(element: Element | Document | Window, eventName: string, eventHandler: DomEventCallback<T>, data?: unknown): void;
     removeEventListener(element: Element | Document | Window | null, eventName: string | null, eventHandler: DomEventCallback): void;
     removeAllListeners(element: Element | Document | Window, eventName?: string): void;
 }

package/@ones-editor/core/src/core/editor-doc/editor-doc.d.ts

@@ -1,5 +1,5 @@
 import { EditorDocLocalActionCallbacks, OnesEditor } from '../types';
-import { BuildResourceUrlOptions, DocBlock, DocBlockDelta, DocBlockText, DocBlockTextActions, DocObject, OnesEditorDoc, OnesEditorDocCallbacks, OnesEditorDocRange, OnesEditorDocServerMeta, OnesEditorDocStatus, UploadResourceOptions, UploadResourceResult } from '../doc';
+import { BuildResourceUrlOptions, InsertBlockOptions, DocBlock, DocBlockDelta, DocBlockText, DocBlockTextActions, DocObject, OnesEditorDoc, OnesEditorDocCallbacks, OnesEditorDocRange, OnesEditorDocServerMeta, OnesEditorDocStatus, UploadResourceOptions, UploadResourceResult, UpdateBlockOptions } from '../doc';
 import { EventCallbacks } from '../../utils';
 export default class EditorDoc extends EventCallbacks<OnesEditorDocCallbacks> implements OnesEditorDoc, OnesEditorDocCallbacks {
     private editor;
@@ -13,9 +13,10 @@ export default class EditorDoc extends EventCallbacks<OnesEditorDocCallbacks> im
     getVersionHelper(): import("../doc").OnesEditorDocVersionHelper | undefined;
     getContainerBlocks(containerId: string): DocBlock[];
     getBlockData(containerId: string, blockIndex: number): DocBlock;
-    localUpdateBlockText(containerId: string, blockIndex: number, actions: DocBlockTextActions): DocBlockText;
+    verifyBlockWritable(containerId: string, blockIndex: number): void;
+    localUpdateBlockText(containerId: string, blockIndex: number, actions: DocBlockTextActions, options?: UpdateBlockOptions): DocBlockText;
     localUpdateBlockData(containerId: string, blockIndex: number, delta: DocBlockDelta, newRange: OnesEditorDocRange): DocBlock;
-    localInsertBlock(containerId: string, blockIndex: number, data: DocBlock, newRange: OnesEditorDocRange): DocBlock;
+    localInsertBlock(containerId: string, blockIndex: number, data: DocBlock, newRange: OnesEditorDocRange, options?: InsertBlockOptions): DocBlock;
     localDeleteBlock(containerId: string, blockIndex: number, newRange: OnesEditorDocRange): DocBlock;
     localDeleteChildContainers(containerIds: string[]): void;
     localInsertChildContainer(containerId: string, blocks: DocBlock[]): void;
@@ -38,4 +39,5 @@ export default class EditorDoc extends EventCallbacks<OnesEditorDocCallbacks> im
     getRemoteUsers(): import("../doc").OnesEditorRemoteUsers;
     destroy(): void;
     getServerMeta(): OnesEditorDocServerMeta;
+    reset(doc: OnesEditorDoc): void;
 }

package/@ones-editor/core/src/core/index.d.ts

@@ -7,6 +7,7 @@ export * from './decorators';
 export * from './doc';
 export * from './editor';
 export * from './selection';
+export * from './selection/actions';
 export * from './keyboard';
 export * from './converter';
 export * from './command-providers';

package/@ones-editor/core/src/core/input-handler/input-handler.d.ts

@@ -1,5 +1,5 @@
 import { EditorInputCallbacks } from '../composition/editor-input';
-import { OnesEditor, OnesEditorInputHandler, OnesEditorUndoAction, RemoteChangeType } from '../types';
+import { OnesEditor, OnesEditorInputHandler, OnesEditorUndoAction, RemoteChangeType, PasteOptions } from '../types';
 import { DocObject } from '../doc';
 export declare class EditorInputHandlers implements EditorInputCallbacks {
     editor: OnesEditor;
@@ -11,7 +11,10 @@ export declare class EditorInputHandlers implements EditorInputCallbacks {
     onRemoteChanged(type: RemoteChangeType): void;
     onCompositionStart(event: Event): void;
     onUpdateCompositionText(event: Event, text: string, end: boolean): void;
+    onCopy(event: ClipboardEvent): void;
+    onCut(event: ClipboardEvent): void;
     onPaste(event: ClipboardEvent): void;
+    onPasteText: (text: string, options?: PasteOptions) => Promise<void>;
     onFocus(): void;
     onBlur(): void;
     addHandler(handler: OnesEditorInputHandler): void;
@@ -23,5 +26,6 @@ export declare class EditorInputHandlers implements EditorInputCallbacks {
     defaultInsertText(editor: OnesEditor, containerId: string, blockIndex: number, offset: number, text: string): void;
     defaultHandleKeydown(editor: OnesEditor, event: KeyboardEvent): boolean;
     pasteDoc(doc: DocObject): Promise<void>;
+    private pasteDocs;
     destroy(): void;
 }

package/@ones-editor/core/src/core/input-handler/remove-quoted.d.ts

@@ -0,0 +1,2 @@
+import { BlockElement, OnesEditor } from '../types';
+export declare function removeQuoted(editor: OnesEditor, block: BlockElement): boolean;

package/@ones-editor/core/src/core/selection/actions/index.d.ts

@@ -22,5 +22,5 @@ import { editorMovePageUp } from './move-page-up';
 import { editorMovePageDown } from './move-page-down';
 import { editorSelectPageUp } from './select-page-up';
 import { editorSelectPageDown } from './select-page-down';
-import { editorSelectAll } from './select-all';
-export { editorMoveLeft, editorMoveRight, editorMoveUp, editorMoveDown, editorSelectDown, editorSelectUp, editorSelectLeft, editorSelectRight, editorMoveWordLeft, editorMoveWordEnd, editorSelectWordLeft, editorSelectWordEnd, editorMoveHome, editorMoveEnd, editorSelectHome, editorSelectEnd, editorMovePageUp, editorMovePageDown, editorSelectPageUp, editorSelectPageDown, editorSelectLineHome, editorSelectLineEnd, editorMoveLineHome, editorMoveLineEnd, editorSelectAll, };
+import { editorSelectAll, editorSelectContainer, isContainerSelectedAllChildBlocks } from './select-all';
+export { editorMoveLeft, editorMoveRight, editorMoveUp, editorMoveDown, editorSelectDown, editorSelectUp, editorSelectLeft, editorSelectRight, editorMoveWordLeft, editorMoveWordEnd, editorSelectWordLeft, editorSelectWordEnd, editorMoveHome, editorMoveEnd, editorSelectHome, editorSelectEnd, editorMovePageUp, editorMovePageDown, editorSelectPageUp, editorSelectPageDown, editorSelectLineHome, editorSelectLineEnd, editorMoveLineHome, editorMoveLineEnd, editorSelectAll, editorSelectContainer, isContainerSelectedAllChildBlocks, };

package/@ones-editor/core/src/core/selection/actions/select-all.d.ts

@@ -1,2 +1,4 @@
-import { OnesEditor } from '../../types';
+import { ContainerElement, OnesEditor, SimpleSelectionRange } from '../../types';
+export declare function isContainerSelectedAllChildBlocks(container: ContainerElement, range: SimpleSelectionRange): boolean;
 export declare function editorSelectAll(editor: OnesEditor): boolean;
+export declare function editorSelectContainer(editor: OnesEditor, container: ContainerElement): void;

package/@ones-editor/core/src/core/selection/actions/select-block.d.ts

@@ -0,0 +1,2 @@
+import { OnesEditor } from '../../types';
+export declare function editorSelectBlock(editor: OnesEditor): void;

package/@ones-editor/core/src/core/selection/actions/word-offset.d.ts

@@ -1,3 +1,3 @@
 import { OnesEditor, SimpleBlockPosition } from '../../types';
 export declare function editorGetWordLeftPos(editor: OnesEditor, type: 'move' | 'select'): SimpleBlockPosition | null;
-export declare function editorGetWordEndPos(editor: OnesEditor, type: 'move' | 'select'): SimpleBlockPosition | null;
+export declare function editorGetWordRightPos(editor: OnesEditor, type: 'move' | 'select'): SimpleBlockPosition | null;

package/@ones-editor/core/src/core/selection/editor-selection.d.ts

@@ -1,5 +1,5 @@
 import { EditorCaret } from '../blocks/text-blocks/caret/editor-caret';
-import { OnesEditorSelection, BlockElement, BlockPosition, SelectionRange, OnesEditor, ChangeSelectionOptions, DeleteBlockEventOptions } from '../types';
+import { OnesEditorSelection, BlockElement, BlockPosition, SelectionRange, OnesEditor, DeleteBlockEventOptions, ChangeSelectionOptions } from '../types';
 export declare class EditorSelection implements OnesEditorSelection {
     readonly editor: OnesEditor;
     readonly caret: EditorCaret;
@@ -16,7 +16,7 @@ export declare class EditorSelection implements OnesEditorSelection {
     getEndBlock(): BlockElement;
     selectBlock(block: BlockElement, start: number, end?: number): void;
     setSelection(anchor: BlockPosition, focus?: BlockPosition, options?: ChangeSelectionOptions): SelectionRange;
-    setRange(range: SelectionRange): SelectionRange;
+    setRange(range: SelectionRange, options?: ChangeSelectionOptions): SelectionRange;
     updateSelection(): void;
     getFocusedPos(): BlockPosition;
     getAnchorPos(): BlockPosition;
@@ -29,6 +29,7 @@ export declare class EditorSelection implements OnesEditorSelection {
     private verifyPos;
     private updateFocusedBlock;
     verify(): void;
+    to(type: 'text' | 'markdown' | 'html'): string;
     private removeAllBlockFocusedClass;
     private setBlockFocused;
 }

package/@ones-editor/core/src/core/selection/index.d.ts

@@ -1,2 +1,3 @@
 export * from './editor-position';
 export * from './range';
+export * from './range-from-point';

package/@ones-editor/core/src/core/selection/range/simple-range.d.ts

@@ -1,5 +1,5 @@
 import { OnesEditorDocRange } from '../../doc';
-import { OnesEditor, SelectionRange, SelectedBlock, ContainerElement } from '../../types';
+import { OnesEditor, SelectionRange, SelectedBlock, ContainerElement, SimpleSelectionRange } from '../../types';
 import { EditorSimpleBlockPosition } from '../editor-position';
 interface SimpleRangeOptions {
     anchor: EditorSimpleBlockPosition;
@@ -26,5 +26,6 @@ export default class EditorSimpleSelectionRange implements SelectionRange {
     getFocusedPos(): EditorSimpleBlockPosition;
     clone(): EditorSimpleSelectionRange;
     toDocRange(): OnesEditorDocRange;
+    static from(editor: OnesEditor, other: SimpleSelectionRange): EditorSimpleSelectionRange;
 }
 export {};

package/@ones-editor/core/src/core/selection/select-handler.d.ts

@@ -1,13 +1,17 @@
 import { OnesEditorSelectionHandler, BlockPosition, OnesEditor } from '../types';
+import { AutoScroll } from '../../utils';
 export declare class EditorSelectionHandler implements OnesEditorSelectionHandler {
     editor: OnesEditor;
     startPos: BlockPosition | null;
     lastCaretRect: DOMRect;
     mouseDownEvent: MouseEvent | null;
+    autoScroll: AutoScroll | null;
     constructor(editor: OnesEditor);
     isSelecting(): boolean;
     stopSelection(): void;
-    handleMouseDown: (event: MouseEvent) => void;
+    handleMouseDown: (event: MouseEvent, options: {
+        autoScroll: boolean;
+    }) => void;
     handleMouseMove: (event: MouseEvent) => void;
     handleMouseUp: (event: MouseEvent) => void;
     handleDblClick(event: MouseEvent): void;

package/@ones-editor/core/src/core/settings/index.d.ts

@@ -3,7 +3,7 @@ export default class DefaultSettingsProvider implements OnesEditorSettingsProvid
     private editor;
     constructor(editor: OnesEditor);
     getKey(key: string): string;
-    getItem(key: string): Promise<string | null>;
-    setItem(key: string, value: string | null): Promise<void>;
-    removeItem(key: string): Promise<void>;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string | null): void;
+    removeItem(key: string): void;
 }

package/@ones-editor/core/src/core/types.d.ts

@@ -1,5 +1,5 @@
 import { TypedEmitter } from 'tiny-typed-emitter';
-import { DocBlock, DocBlockAttributes, DocBlocks, DocBlockText, DocBlockTextAttributes, DocBox, DocEmbedBlock, DocEmbedData, DocInsertion, DocObject, OnesEditorDoc, OnesEditorDocRange } from './doc';
+import { DocBlock, DocBlockAttributes, DocBlocks, DocBlockText, DocBlockTextAttributes, DocBox, DocEmbedBlock, DocEmbedData, DocInsertion, DocObject, InsertBlockOptions, OnesEditorDoc, OnesEditorDocRange } from './doc';
 export type ContainerElement = HTMLDivElement & {
     __neverUse: 'ContainerElement';
 };
@@ -49,12 +49,23 @@ export interface ComplexBlockPosition {
     isSimple: () => false;
 }
 export type BlockPosition = SimpleBlockPosition | ComplexBlockPosition;
+export interface BoxCommands {
+    group: string;
+    commands: CommandItem[];
+    executeCommand: (editor: OnesEditor, block: BlockElement, box: BoxElement, item: CommandItem) => unknown;
+}
+export interface BoxProperties {
+    boxCommands?: Record<string, BoxCommands>;
+    abstract?: string;
+}
 export interface Box {
     boxType: string;
     updateBoxContent: (editor: OnesEditor, boxElement: BoxElement, boxContent: BoxContentElement, boxData: DocBox) => void;
     convertFrom?: (editor: OnesEditor, text: string) => DocBox | null;
+    convertTo?: (editor: OnesEditor, boxData: DocBox, doc: DocObject, type: 'text' | 'html' | 'markdown') => string;
     handleClickBox?: (editor: OnesEditor, box: BoxElement, event: MouseEvent) => void;
     toStandardText?: (editor: OnesEditor, box: DocBox) => Promise<DocBlockText | undefined>;
+    getBoxProperties?: (editor: OnesEditor, boxElement: BoxElement) => BoxProperties;
 }
 export interface Insertion {
     insertionType: string;
@@ -79,12 +90,13 @@ export interface Embed {
     getOptions?: (editor: OnesEditor) => EmbedOptions;
     handleDeleteBlock?: (editor: OnesEditor, block: BlockElement, local: boolean, options: DeleteBlockEventOptions) => void;
     handleUpdateBlock?: (editor: OnesEditor, block: BlockElement, blockData: DocEmbedBlock) => boolean;
-    handleDropOver?: (editor: OnesEditor, block: BlockElement, dragObject: DragObject, x: number, y: number) => DropInsertPos | undefined;
-    handleDrop?: (editor: OnesEditor, block: BlockElement, dragObject: DragObject, insertPos: DropInsertPos, options: DropOptions) => boolean | undefined;
+    handleDropOver?: (editor: OnesEditor, block: BlockElement, dragData: DragObject | DataTransferItemList | null, x: number, y: number) => DropInsertPos | undefined;
+    handleDrop?: (editor: OnesEditor, block: BlockElement, dragData: DragObject | File[], insertPos: DropInsertPos, options: DropOptions) => boolean | undefined;
     convertFrom?: (editor: OnesEditor, srcBlock: BlockElement, options: {
         offset: number;
         data?: DocBlockAttributes;
     }) => ConvertBlockResult | null;
+    toStandardDoc?: (editor: OnesEditor, blockData: DocBlock, doc: DocObject, path: BlockPath) => Promise<DocObject | undefined>;
 }
 export interface ConvertBlockResult {
     blockData: DocBlock;
@@ -96,8 +108,9 @@ export interface DeleteBlockEventOptions {
 }
 export type CommandItemType = 'normal' | 'separator' | 'section';
 export type CommandItemState = 'disabled' | 'checked' | 'selected';
+export type CloseReason = 'selectionChange' | 'clickItem' | 'clickBackground' | 'cancelBar' | 'fromHover' | 'switchItem' | null;
 export interface Closeable {
-    close: () => void;
+    close: (reason: CloseReason) => void;
     click: (item: CommandItem, target: HTMLElement) => void;
 }
 export type CommandItemChildrenPlacement = 'auto' | 'top' | 'left' | 'right' | 'bottom' | 'auto-start' | 'auto-end' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | 'right-start' | 'right-end' | 'left-start' | 'left-end';
@@ -109,7 +122,7 @@ export interface CommandItem {
     value?: string;
     order?: number;
     type?: CommandItemType;
-    element?: HTMLElement;
+    element?: HTMLElement | ((item: CommandItem) => HTMLElement);
     icon?: string;
     childrenType?: 'menu' | 'toolbar';
     children?: CommandItem[];
@@ -121,6 +134,11 @@ export interface CommandItem {
     manualShowChildren?: boolean;
     childrenPlacement?: CommandItemChildrenPlacement;
     childrenOffset?: [number, number];
+    subText?: string;
+    defaultCheckedChildren?: string[];
+    ellipsisTooltip?: string;
+    disableTooltip?: boolean;
+    disableReason?: string;
     setCloseable?: (closeable: Closeable) => void;
     beforePopup?: (parent: unknown) => void;
 }
@@ -189,13 +207,13 @@ export interface Block {
     clearSelection: (editor: OnesEditor) => void;
     getBlockProperties?: (editor: OnesEditor, block: BlockElement) => BlockProperties;
     getOptions?: (editor: OnesEditor) => BlockOptions;
-    notify?: (editor: OnesEditor, command: string, params?: unknown) => void;
+    notify?: (editor: OnesEditor, command: string, params?: unknown) => unknown | undefined;
     handleBlockElementUpdated?: (editor: OnesEditor, block: BlockElement, blockData: DocBlock) => void;
     handleContainerResized?: (editor: OnesEditor, block: BlockElement) => void;
     handleDeleteBlock?: (editor: OnesEditor, block: BlockElement, local: boolean, options: DeleteBlockEventOptions) => void;
     handleUpdateBlock?: (editor: OnesEditor, block: BlockElement, blockData: DocBlock) => boolean;
-    handleDropOver?: (editor: OnesEditor, block: BlockElement, dragObject: DragObject, x: number, y: number) => DropInsertPos | undefined;
-    handleDrop?: (editor: OnesEditor, block: BlockElement, dragObject: DragObject, insertPos: DropInsertPos, options: DropOptions) => boolean | undefined;
+    handleDropOver?: (editor: OnesEditor, block: BlockElement, dragData: DragObject | DataTransferItemList | null, x: number, y: number) => DropInsertPos | false | undefined;
+    handleDrop?: (editor: OnesEditor, block: BlockElement, dragData: DragObject | File[], insertPos: DropInsertPos, options: DropOptions) => boolean | undefined;
     getClientRects?: (editor: OnesEditor, block: BlockElement, range: SelectionRange) => DOMRect[];
     getMinWidth?: (editor: OnesEditor, block: BlockElement) => number | undefined;
     convertFrom?: (editor: OnesEditor, srcBlock: BlockElement, options: {
@@ -203,7 +221,7 @@ export interface Block {
         data?: DocBlockAttributes;
     }) => ConvertBlockResult | null;
     selectionToDoc?: (editor: OnesEditor, selectedBlock: SelectedBlock) => DocObject;
-    convertTo?: (editor: OnesEditor, blockData: DocBlock, doc: DocObject, type: 'text' | 'html' | 'markdown') => string;
+    convertTo?: (editor: OnesEditor, blockData: DocBlock, doc: DocObject, type: 'text' | 'html' | 'markdown', path: BlockPath) => string;
     toStandardDoc?: (editor: OnesEditor, blockData: DocBlock, doc: DocObject) => Promise<DocObject | undefined>;
     getBlockStyles?: (editor: OnesEditor, block: BlockElement) => BlockStyles;
     blockToDoc?: (srcDoc: DocObject, srcBlockData: DocBlock, childBlockConverter: (srcDoc: DocObject, srcBlockData: DocBlock) => DocObject) => DocObject;
@@ -219,9 +237,12 @@ export interface TextKindBlock extends Block {
 export interface NextContainerOptions {
     noWrap?: boolean;
 }
+export interface GetChildContainerOptions {
+    visibleOnly?: boolean;
+}
 export interface ComplexKindBlock extends Block {
     enableKeyboardSelect?: boolean;
-    getChildContainers: (editor: OnesEditor, complexBlock: BlockElement) => ContainerElement[];
+    getChildContainers: (editor: OnesEditor, complexBlock: BlockElement, options?: GetChildContainerOptions) => ContainerElement[];
     getNextContainer: (editor: OnesEditor, complexBlock: BlockElement, childContainer: ContainerElement, type: MoveDirection, options?: NextContainerOptions) => ContainerElement | null;
     getSelectedContainers: (editor: OnesEditor, complexBlock: BlockElement, start: ComplexBlockPosition, end: ComplexBlockPosition) => ContainerElement[];
     adjustSelectionPos?: (editor: OnesEditor, complexBlock: BlockElement, anchor: ComplexBlockPosition, focus: ComplexBlockPosition) => {
@@ -325,18 +346,19 @@ export interface OnesEditorBlockRenderers {
 export type OnesEditorDocSource = 'text/html' | 'text/office-html' | 'text/plain' | 'text/markdown' | 'image/*' | 'text/x-ones-editor-doc' | '*';
 export type OnesEditorDocs = Partial<Record<OnesEditorDocSource, DocObject>>;
 export interface OnesEditorDataConverter {
-    fromData: (editor: OnesEditor, data: DataTransfer) => Promise<OnesEditorDocs | undefined>;
+    fromData: (editor: OnesEditor, data: DataTransfer, options?: PasteOptions) => Promise<OnesEditorDocs | undefined>;
 }
 export interface OnesEditorDataConverters {
-    fromData: (editor: OnesEditor, data: DataTransfer) => Promise<OnesEditorDocs | undefined>;
+    fromData: (editor: OnesEditor, data: DataTransfer, options?: PasteOptions) => Promise<OnesEditorDocs | undefined>;
     addConverter: (converter: OnesEditorDataConverter) => void;
 }
 export interface BreakTextOptions {
     forceInsertAfter?: boolean;
     newBlockData?: DocBlock;
+    copyBlockAttributes?: boolean;
 }
 export interface OnesEditorEvents {
-    'docChanged': (editor: OnesEditor) => void;
+    'docChanged': (editor: OnesEditor, local: boolean) => void;
     'readonlyChanged': (editor: OnesEditor) => void;
     'selectionChanged': (editor: OnesEditor) => void;
     'focusBlockChanged': (editor: OnesEditor, newBlock: BlockElement | null, oldBlock: BlockElement | null) => void;
@@ -345,15 +367,17 @@ export interface OnesEditorEvents {
     'resize': (editor: OnesEditor) => void;
     'load': (editor: OnesEditor, reload: boolean) => void;
     'click': (editor: OnesEditor, event: MouseEvent) => void;
+    'clickLink': (editor: OnesEditor, event: MouseEvent, link: Element) => void;
     'beforeClearSelection': (editor: OnesEditor) => void;
     'afterClearSelection': (editor: OnesEditor) => void;
     'blur': (editor: OnesEditor) => void;
     'focus': (editor: OnesEditor) => void;
+    'containerRemount': (editor: OnesEditor, containerId: string) => void;
 }
 export interface OnesEditorSettingsProvider {
-    getItem: (key: string) => Promise<string | null>;
-    setItem: (key: string, value: string | null) => Promise<void>;
-    removeItem: (key: string) => Promise<void>;
+    getItem: (key: string) => string | null;
+    setItem: (key: string, value: string | null) => void;
+    removeItem: (key: string) => void;
 }
 export interface OnesEditorOptionalOptions {
     shortcuts?: ShortcutRecords[];
@@ -361,6 +385,7 @@ export interface OnesEditorOptionalOptions {
     components?: OnesEditorComponents;
     colors?: string[];
     scrollContainer?: HTMLElement;
+    enableComments?: boolean;
     settingsProvider?: OnesEditorSettingsProvider;
 }
 export interface OnesEditorOptions {
@@ -368,6 +393,7 @@ export interface OnesEditorOptions {
     componentsOptions: {
         [index: string]: unknown;
     };
+    enableComments?: boolean;
     scrollContainer?: HTMLElement;
 }
 export interface OnesEditorComponents {
@@ -401,7 +427,7 @@ export declare class OnesEditorCustomDataWrapper<T> {
     private editor;
     private data;
     constructor(editor: OnesEditor, data: T);
-    getData<T>(): T;
+    getData(): T;
     getEditor(): OnesEditor;
     destroy(): void;
 }
@@ -411,10 +437,11 @@ export interface CloneBlockResultInfo {
     blockIdMap: Map<string, string>;
 }
 export interface OnesEditorDomEvents extends OnesEditorCustom {
-    addEventListener: (element: Element | Document | Window, eventName: string, eventHandler: (editor: OnesEditor, event: Event) => void) => void;
+    addEventListener: <T = Event>(element: Element | Document | Window, eventName: string, eventHandler: (editor: OnesEditor, event: T) => void) => void;
     removeEventListener: (element: Element | Document | Window | null, eventName: string | null, eventHandler: (editor: OnesEditor, event: Event) => void) => void;
     removeAllListeners: (element: Element | Document | Window, eventName?: string) => void;
 }
+export type InsertTextOptions = InsertBlockOptions;
 export interface OnesEditor extends TypedEmitter<OnesEditorEvents> {
     readonly parent: HTMLElement;
     readonly rootElement: HTMLDivElement;
@@ -479,7 +506,7 @@ export interface OnesEditor extends TypedEmitter<OnesEditorEvents> {
     contains: (node: Node) => boolean;
     getSelectedText: () => string;
     clearSelectedContents: () => void;
-    insertBlock: (containerId: string, blockIndex: number, blockData: DocBlock, newRange?: OnesEditorDocRange) => BlockElement;
+    insertBlock: (containerId: string, blockIndex: number, blockData: DocBlock, newRange?: OnesEditorDocRange, options?: InsertBlockOptions) => BlockElement;
     insertEmbed: (containerId: string, blockIndex: number, embedType: string, embedData: DocEmbedData, newRange?: OnesEditorDocRange) => BlockElement;
     deleteBlock: (block: BlockElement, newRange?: OnesEditorDocRange) => void;
     getTextPosition: () => BlockTextPosition;
@@ -490,8 +517,8 @@ export interface OnesEditor extends TypedEmitter<OnesEditorEvents> {
     getBlockText: (block: BlockElement) => DocBlockText;
     setBlockText: (block: BlockElement, text: DocBlockText) => void;
     getBoxData: (box: BoxElement) => DocBox;
-    deleteTextFromBlock: (block: BlockElement, offset: number, count: number) => number;
-    insertTextToBlock: (block: BlockElement, offset: number, text: string | DocBlockText) => DocBlockText;
+    deleteTextFromBlock: (block: BlockElement, offset: number, count: number, options?: InsertTextOptions) => number;
+    insertTextToBlock: (block: BlockElement, offset: number, text: string | DocBlockText, options?: InsertTextOptions) => DocBlockText;
     insertBoxToBlock: (block: BlockElement, offset: number, boxData: DocBox) => DocBlockText;
     mergeTextBlock: (block1: BlockElement, block2: BlockElement, options?: {
         focus?: boolean;
@@ -499,6 +526,7 @@ export interface OnesEditor extends TypedEmitter<OnesEditorEvents> {
     breakTextBlock: (block: BlockElement, offset: number, options?: BreakTextOptions) => BlockElement;
     insertTextBlock: (text?: string | DocBlockText, containerId?: string, blockIndex?: number, options?: {
         newRange?: OnesEditorDocRange;
+        insertBlockOptions?: InsertBlockOptions;
     }) => BlockElement;
     insertDoc: (block: BlockElement, offset: number, doc: DocObject, cloneDocResult?: CloneBlockResultInfo) => void;
     insertDocAt: (container: ContainerElement, blockIndex: number, doc: DocObject, cloneDocResult?: CloneBlockResultInfo) => BlockElement[];
@@ -520,7 +548,7 @@ export interface OnesEditorSelection {
     readonly startBlock: BlockElement;
     readonly endBlock: BlockElement;
     setSelection: (anchor: BlockPosition, focus?: BlockPosition, options?: ChangeSelectionOptions) => SelectionRange;
-    setRange: (range: SelectionRange) => SelectionRange;
+    setRange: (range: SelectionRange, options?: ChangeSelectionOptions) => SelectionRange;
     selectBlock: (block: BlockElement, start: number, end?: number) => void;
     updateSelection: (old: SelectionRange | null) => void;
     updateLastCaretRect: () => void;
@@ -528,8 +556,12 @@ export interface OnesEditorSelection {
     getAnchorPos: () => BlockPosition;
     getFocusedPos: () => BlockPosition;
     scrollIntoView: () => void;
+    to: (type: 'text' | 'markdown' | 'html') => string;
 }
 export type RemoteChangeType = 'UpdateBlockText' | 'UpdateBlockData' | 'InsertBlock' | 'DeleteBlock' | 'InsertChildContainer' | 'DeleteChildContainer';
+export type PasteOptions = {
+    toPlainText?: boolean;
+};
 export interface OnesEditorInput {
     readonly inputElement: HTMLInputElement;
     destroy: () => void;
@@ -541,6 +573,7 @@ export interface OnesEditorInput {
     handleKeyDown: (event: KeyboardEvent) => void;
     handleChanged: (action: OnesEditorUndoAction) => void;
     handleRemoteChanged: (type: RemoteChangeType) => void;
+    handlePasteText: (text: string, options?: PasteOptions) => void;
     addHandler: (handler: OnesEditorInputHandler) => void;
     removeHandler: (handler: OnesEditorInputHandler) => void;
     defaultInsertText: (editor: OnesEditor, containerId: string, blockIndex: number, offset: number, text: string) => void;
@@ -549,7 +582,9 @@ export interface OnesEditorInput {
 export interface OnesEditorSelectionHandler {
     isSelecting: () => boolean;
     stopSelection: () => void;
-    handleMouseDown: (event: MouseEvent) => void;
+    handleMouseDown: (event: MouseEvent, options: {
+        autoScroll: boolean;
+    }) => void;
     handleMouseMove: (event: MouseEvent) => void;
     handleMouseUp: (event: MouseEvent) => void;
     handleDblClick: (event: MouseEvent) => void;
@@ -560,14 +595,17 @@ export interface OnesEditorCaret {
     visible: () => boolean;
 }
 export interface OnesEditorInputHandler {
+    order?: number;
     handleBeforeInsertText?: (editor: OnesEditor, containerId: string, blockIndex: number, offset: number, text: string) => boolean;
     handleAfterInsertText?: (editor: OnesEditor, containerId: string, blockIndex: number, offset: number, text: string) => boolean;
     handleBeforeKeyDown?: (editor: OnesEditor, event: KeyboardEvent) => boolean;
     handleAfterKeyDown?: (editor: OnesEditor, event: KeyboardEvent) => boolean;
-    handleBeforePaste?: (editor: OnesEditor, event: ClipboardEvent, doc: OnesEditorDocs) => Promise<boolean>;
-    handleAfterPaste?: (editor: OnesEditor, event: ClipboardEvent, doc: OnesEditorDocs) => Promise<boolean>;
+    handleBeforeCopy?: (editor: OnesEditor, event: ClipboardEvent, doc: DocObject) => DocObject | boolean | undefined;
+    handleBeforeCut?: (editor: OnesEditor, event: ClipboardEvent) => DocObject | boolean | undefined;
+    handleBeforePaste?: (editor: OnesEditor, event: ClipboardEvent | null, doc: OnesEditorDocs) => Promise<boolean>;
+    handleAfterPaste?: (editor: OnesEditor, event: ClipboardEvent | null, doc: OnesEditorDocs) => Promise<boolean>;
     handleBeforePasteDoc?: (editor: OnesEditor, doc: DocObject) => Promise<boolean>;
-    handleAfterPasteDoc?: (editor: OnesEditor, doc: DocObject) => Promise<boolean>;
+    handleAfterPasteDoc?: (editor: OnesEditor, doc: DocObject, cloneDocResult: CloneBlockResultInfo) => Promise<boolean>;
     handleChanged?: (editor: OnesEditor, action: OnesEditorUndoAction) => void;
     handleRemoteChanged?: (editor: OnesEditor, type: RemoteChangeType) => void;
     handleCompositionStart?: (editor: OnesEditor, containerId: string, blockIndex: number, offset: number) => void;
@@ -579,6 +617,7 @@ export interface OnesEditorBlocks {
     getBlockClass: (type: string) => Block;
     createBlock: (path: BlockPath, container: ContainerElement, block: DocBlock) => BlockElement;
     forEach: (callback: (blockClass: Block) => void) => void;
+    hasBlock: (type: string) => boolean;
 }
 export interface OnesEditorEmbeds {
     registerEmbedClass: (embedClass: Embed) => void;
@@ -589,6 +628,7 @@ export interface OnesEditorBoxes {
     registerBoxClass: (boxClass: Box) => void;
     getBoxClass: (type: string) => Box;
     createBox: (blockContent: BlockContentElement, box: DocBox) => BoxElement;
+    forEach: (callback: (boxClass: Box) => void) => void;
 }
 export interface OnesEditorInsertions {
     registerInsertionClass: (insertionClass: Insertion) => void;

package/@ones-editor/core/src/helper/block-helper.d.ts

@@ -1,2 +1,2 @@
-import { BlockElement } from '../core';
+import { BlockElement } from '../core/types';
 export declare function isRootBlock(block: BlockElement): boolean;

package/@ones-editor/core/src/helper/find-block.d.ts

@@ -0,0 +1,3 @@
+import { BlockElement, OnesEditor } from '../core/types';
+export declare function findPrevVisibleSimpleBlock(editor: OnesEditor, block: BlockElement): BlockElement | null;
+export declare function findNextVisibleSimpleBlock(editor: OnesEditor, block: BlockElement): BlockElement | null;

package/@ones-editor/core/src/helper/index.d.ts

@@ -3,3 +3,4 @@ import type { OnesEditorHoveringBlockFilter, OnesEditorHoveringBlockFinder } fro
 export { OnesEditorHoveringBlock, OnesEditorHoveringBlockFilter, OnesEditorHoveringBlockFinder };
 export * from './block-helper';
 export * from './run-once';
+export * from './find-block';