@ones-editor/editor 2.0.8-beta.1 → 2.1.0

package/@ones-editor/block-menu/src/block-menu/items/insert-block-items/index.d.ts

@@ -1,5 +1,5 @@
 import { BlockElement, OnesEditor } from '../../../../../../@ones-editor/core';
 import type { GetAllQuickMenuItemsOptions } from '../../../../../../@ones-editor/ui';
 import type { BlockMenuItem } from '../types';
-export declare function getAllInsertBlockItems(editor: OnesEditor, source: 'insert-block' | 'insert-block-before', options: GetAllQuickMenuItemsOptions): BlockMenuItem[];
+export declare function getAllInsertBlockItems(editor: OnesEditor, block: BlockElement, source: 'insert-block' | 'insert-block-before', options: GetAllQuickMenuItemsOptions): BlockMenuItem[];
 export declare function executeInsertBlockCommand(editor: OnesEditor, block: BlockElement, item: BlockMenuItem, insertAbove?: boolean): Promise<BlockElement | null> | undefined;

package/@ones-editor/block-menu/src/block-menu-button/drag-preview/element-to-data-url.d.ts

@@ -1,2 +1,2 @@
 import { OnesEditor } from '../../../../../@ones-editor/core';
-export declare function elementToDataUrl(editor: OnesEditor, element: HTMLElement): Promise<string>;
+export declare function elementToDataUrl(editor: OnesEditor, element: HTMLElement, marginIncluded?: boolean): Promise<string>;

package/@ones-editor/block-menu/src/block-menu-button/index.d.ts

@@ -1,19 +1,8 @@
-import { BlockElement, OnesEditor } from '../../../../@ones-editor/core';
-import EmptyBlockMenu from '../empty-block-menu';
-import BlockMenu from '../block-menu';
-export default class OnesEditorBlockMenuButton {
+import { OnesEditor } from '../../../../@ones-editor/core';
+import OnesEditorBlockMenuButton from './menu-button';
+export default class OnesEditorBlockMenuButtons {
     private editor;
-    buttonElement: HTMLButtonElement;
-    emptyBlockMenu: EmptyBlockMenu;
-    blockMenu: BlockMenu;
-    private dragHandler;
+    rootButton: OnesEditorBlockMenuButton;
     constructor(editor: OnesEditor);
     destroy(): void;
-    handleHoverBlock: (hoverBlock: BlockElement | null, oldBlock: BlockElement | null, event: MouseEvent) => void;
-    handleButtonClick: () => void;
-    updatePlaceholder: (block: BlockElement) => void;
-    handleChanged: () => void;
-    createButton(): HTMLButtonElement;
-    setButtonType(type: 'move' | 'insert'): void;
-    updateButton(block: BlockElement): void;
 }

package/@ones-editor/block-menu/src/block-menu-button/menu-button/index.d.ts

@@ -0,0 +1,23 @@
+import { BlockElement, OnesEditor } from '../../../../../@ones-editor/core';
+import EmptyBlockMenu from '../../empty-block-menu';
+import BlockMenu from '../../block-menu';
+export default class OnesEditorBlockMenuButton {
+    private editor;
+    buttonElement: HTMLButtonElement;
+    emptyBlockMenu: EmptyBlockMenu;
+    blockMenu: BlockMenu;
+    private dragHandler;
+    constructor(editor: OnesEditor);
+    destroy(): void;
+    handleHoverBlock: (hoverBlock: BlockElement | null, oldBlock: BlockElement | null, target: EventTarget | null, oldTarget: EventTarget | null) => void;
+    showRootButton(hoverBlock: BlockElement): void;
+    showParentButton(hoverBlock: BlockElement): boolean;
+    removeParentButton: () => void;
+    addButtonToView(block: BlockElement): void;
+    handleButtonClick: () => void;
+    updatePlaceholder: (block: BlockElement) => void;
+    handleChanged: () => void;
+    createButton(): HTMLButtonElement;
+    setButtonType(type: 'move' | 'insert'): void;
+    updateButton(block: BlockElement): void;
+}

package/@ones-editor/callout-block/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@ones-editor/callout-block",
+  "version": "1.0.0",
+  "type": "module",
+  "private": true,
+  "main": "./src/index.ts",
+  "devDependencies": {
+    "@types/lodash.isequal": "^4.5.7"
+  },
+  "types": "src/index.d.ts"
+}

package/@ones-editor/callout-block/src/callout-block/callout-block-content.d.ts

@@ -0,0 +1,3 @@
+import type { OnesEditor, BlockPath, BlockElement } from '../../../../@ones-editor/core';
+import type { DocCalloutBlockData } from './types';
+export declare function createCalloutBlockContent(editor: OnesEditor, path: BlockPath, blockElement: BlockElement, blockData: DocCalloutBlockData): import("@ones-editor/core").BlockContentElement;

package/@ones-editor/callout-block/src/callout-block/callout-block-doc.d.ts

@@ -0,0 +1,2 @@
+import { DocCalloutBlockData } from './types';
+export declare function isCalloutBlockData(v: unknown): v is DocCalloutBlockData;

package/@ones-editor/callout-block/src/callout-block/callout-block.d.ts

@@ -0,0 +1,3 @@
+import type { ComplexKindBlock } from '../../../../@ones-editor/core';
+declare const CalloutBlock: ComplexKindBlock;
+export { CalloutBlock, };

package/@ones-editor/callout-block/src/callout-block/callout-converter-interceptor.d.ts

@@ -0,0 +1,8 @@
+import { BlockConverter, ConverterInterceptor } from '../../../../@ones-editor/input-handlers';
+import { OnesEditor, BlockElement, OnesEditorCustom } from '../../../../@ones-editor/core';
+export declare class CalloutConverterInterceptor implements ConverterInterceptor, OnesEditorCustom {
+    constructor(editor: OnesEditor);
+    handler(editor: OnesEditor, block: BlockElement, converter: BlockConverter): boolean;
+    destroy(): void;
+    static init(editor: OnesEditor): CalloutConverterInterceptor;
+}

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

@@ -0,0 +1,11 @@
+import type { OnesEditorInputHandler, OnesEditor, OnesEditorCustom, DocObject } from '../../../../@ones-editor/core';
+export declare class CalloutInputHandler implements OnesEditorInputHandler, OnesEditorCustom {
+    constructor(editor: OnesEditor);
+    private pasteHasForbidden;
+    private handleBackspaceEvent;
+    handleBeforeKeyDown(editor: OnesEditor, event: KeyboardEvent): boolean;
+    handleBeforePasteDoc(editor: OnesEditor, doc: DocObject): Promise<boolean>;
+    handleAfterPaste(): Promise<boolean>;
+    destroy(): void;
+    static init(editor: OnesEditor): void;
+}

package/@ones-editor/callout-block/src/callout-block/callout-last-callout-payload.d.ts

@@ -0,0 +1,9 @@
+import { OnesEditor, OnesEditorCustom } from '../../../../@ones-editor/core';
+import { CalloutBlockPayload } from './types';
+export declare class CalloutLastUpdateData implements OnesEditorCustom {
+    private lastCalloutBlockPayload;
+    get(): CalloutBlockPayload;
+    update(payload: Partial<CalloutBlockPayload>): void;
+    destroy(): void;
+    static init(editor: OnesEditor): CalloutLastUpdateData;
+}

package/@ones-editor/callout-block/src/callout-block/callout-options.d.ts

@@ -0,0 +1,2 @@
+import { BlockOptions } from '../../../../@ones-editor/core';
+export declare function getOptions(): BlockOptions;

package/@ones-editor/callout-block/src/callout-block/callout-properties.d.ts

@@ -0,0 +1,2 @@
+import type { OnesEditor, BlockElement, BlockProperties } from '../../../../@ones-editor/core';
+export declare function getBlockProperties(editor: OnesEditor, blockElement: BlockElement): BlockProperties;

package/@ones-editor/callout-block/src/callout-block/callout-quick-menu-item-filter.d.ts

@@ -0,0 +1,8 @@
+import { OnesEditor, OnesEditorCustom } from '../../../../@ones-editor/core';
+import type { QuickMenuItem, QuickMenuItemFilter } from '../../../../@ones-editor/ui';
+export declare class CalloutQuickMenuItemFilter implements QuickMenuItemFilter, OnesEditorCustom {
+    constructor(editor: OnesEditor);
+    filter(editor: OnesEditor, items: QuickMenuItem[], from: string): QuickMenuItem[];
+    destroy(): void;
+    static init(editor: OnesEditor): CalloutQuickMenuItemFilter;
+}

package/@ones-editor/callout-block/src/callout-block/command-items/bg-color-item.d.ts

@@ -0,0 +1,22 @@
+import { BlockElement, CommandItem, OnesEditor, OnesEditorCustom } from '../../../../../@ones-editor/core';
+import { ColorPaletteItem } from '../../../../../@ones-editor/ui-base';
+import { ColorId } from '../types';
+export declare class BgColorItem implements CommandItem, OnesEditorCustom {
+    private editor;
+    id: string;
+    name: string;
+    manualShowChildren: boolean;
+    dropdown: boolean;
+    childrenPlacement: "bottom-start";
+    private bgColorButton;
+    bgColorPaletteItem: ColorPaletteItem;
+    element: HTMLButtonElement;
+    children: CommandItem[];
+    private constructor();
+    private createPaletteButton;
+    private getBgColorFromBlock;
+    updateButtonColor(bgColor: ColorId): void;
+    updateItem(block: BlockElement): void;
+    destroy(): void;
+    static get(editor: OnesEditor): BgColorItem;
+}

package/@ones-editor/callout-block/src/callout-block/command-items/delete-icon-item.d.ts

@@ -0,0 +1,4 @@
+import { BlockElement, CommandItem, OnesEditor } from '../../../../../@ones-editor/core';
+export declare const EMPTY_ICON = "";
+export declare function createDeleteIconItem(editor: OnesEditor, block: BlockElement): CommandItem;
+export declare function updateDeleteIconStatus(editor: OnesEditor, block: BlockElement): void;

package/@ones-editor/callout-block/src/callout-block/command-items/preset-item.d.ts

@@ -0,0 +1,16 @@
+import { BlockElement, CommandItem, OnesEditor } from '../../../../../@ones-editor/core';
+import { CalloutBlockPayload } from '../types';
+export type PresetId = `preset-${0 | 1}`;
+type Preset = CalloutBlockPayload & {
+    name: string;
+};
+export declare function isPresetId(id: string): id is PresetId;
+export declare function getPresetId(id: PresetId): string;
+export declare function getPreset(id: PresetId): Preset;
+export declare function getPresetIcon(id: string): string;
+export declare function getPresetPayload(presetId: PresetId): {
+    backgroundColor: number;
+    icon: "preset-0" | "preset-1";
+};
+export declare function createPresetItem(presetId: PresetId, editor: OnesEditor, block: BlockElement): CommandItem;
+export {};

package/@ones-editor/callout-block/src/callout-block/converter.d.ts

@@ -0,0 +1,3 @@
+import { OnesEditor, DocBlock, DocObject, BlockPath } from '../../../../@ones-editor/core';
+export declare function toStandardDoc(editor: OnesEditor, blockData: DocBlock, doc: DocObject): Promise<DocObject>;
+export declare function convertTo(editor: OnesEditor, blockData: DocBlock, doc: DocObject, type: 'text' | 'html' | 'markdown', path: BlockPath): string;

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

@@ -0,0 +1,4 @@
+import { DocBlock } from '../../../../@ones-editor/core';
+import { ColorId } from './types';
+export declare function checkBlockAllowInCallout(block: DocBlock): boolean;
+export declare function getHexBackgroundColor(backgroundColor: ColorId): string;

package/@ones-editor/callout-block/src/callout-block/index.d.ts

@@ -0,0 +1 @@
+export { CalloutBlock } from './callout-block';

package/@ones-editor/callout-block/src/callout-block/types.d.ts

@@ -0,0 +1,9 @@
+import { DocBlock } from '../../../../@ones-editor/core';
+export type ColorId = number;
+export interface DocCalloutBlockData extends DocBlock {
+    type: 'callout';
+    icon: string;
+    backgroundColor: ColorId;
+    children: string[];
+}
+export type CalloutBlockPayload = Pick<DocCalloutBlockData, 'icon' | 'backgroundColor'>;

package/@ones-editor/callout-block/src/index.d.ts

@@ -0,0 +1,3 @@
+import './index.scss';
+import './locale';
+export { CalloutBlock } from './callout-block';

package/@ones-editor/callout-block/src/locale/en-us.d.ts

@@ -0,0 +1,12 @@
+declare const _default: {
+    callout: {
+        name: string;
+        command: {
+            presetInfo: string;
+            presetAlert: string;
+            clearEmoji: string;
+            background: string;
+        };
+    };
+};
+export default _default;

package/@ones-editor/callout-block/src/locale/index.d.ts

@@ -0,0 +1 @@
+export {};

package/@ones-editor/callout-block/src/locale/ja-jp.d.ts

@@ -0,0 +1,12 @@
+declare const _default: {
+    callout: {
+        name: string;
+        command: {
+            presetInfo: string;
+            presetAlert: string;
+            clearEmoji: string;
+            background: string;
+        };
+    };
+};
+export default _default;

package/@ones-editor/callout-block/src/locale/zh-cn.d.ts

@@ -0,0 +1,12 @@
+declare const _default: {
+    callout: {
+        name: string;
+        command: {
+            presetInfo: string;
+            presetAlert: string;
+            clearEmoji: string;
+            background: string;
+        };
+    };
+};
+export default _default;

package/@ones-editor/context-menu/src/helper/command-items.d.ts

@@ -23,4 +23,5 @@ export default class ContextMenuCommandItems {
     private secureEnvTips;
     private isFocusImageBlock;
     private isFocusImageTypeEmbed;
+    private isEmptyImageTypeEmbed;
 }

package/@ones-editor/core/src/core/blocks/common/block-wrapper.d.ts

@@ -1,9 +1,10 @@
-import { OnesEditor, BlockElement, BlockPosition, ConvertBlockResult, SelectionRange, BlockStyles } from '../../types';
+import { OnesEditor, BlockElement, BlockPosition, ConvertBlockResult, SelectionRange, BlockStyles, ContainerElement } from '../../types';
 import { DocBlock, DocBlockAttributes } from '../../doc';
 export declare function getBlockTextLength(editor: OnesEditor, block: BlockElement): number;
 export declare function clearAllSelection(editor: OnesEditor): void;
 export declare function updateBlockSelection(editor: OnesEditor, block: BlockElement, from: BlockPosition, to: BlockPosition): void;
 export declare function getRootBlock(block: BlockElement): BlockElement;
+export declare function getClosestContainerByCondition(_block: BlockElement, condition: (container: ContainerElement) => boolean): BlockElement | undefined;
 export declare function getBlockMinWidth(editor: OnesEditor, block: BlockElement): number | undefined;
 export declare function handleBlockElementUpdated(editor: OnesEditor, block: BlockElement, data: DocBlock): void;
 export declare function convertBlockFrom(editor: OnesEditor, block: BlockElement, type: string, options: {

package/@ones-editor/core/src/core/blocks/common/insert-empty-block.d.ts

@@ -1,3 +1,4 @@
-import { OnesEditor } from '../../types';
+import { ContainerBlockOverrideInsertEmptyBlockInsideOptions, OnesEditor } from '../../types';
+export declare function getContainerBlockOverrideOptions(editor: OnesEditor, containerID: string, blockType?: string): ContainerBlockOverrideInsertEmptyBlockInsideOptions | undefined;
 export declare function insertEmptyEmbedBlock(editor: OnesEditor, embedType: string, containerId: string, blockIndex: number, data?: Record<string, unknown>): Promise<import("../../types").BlockElement | null>;
-export declare function insertEmptyBlock(editor: OnesEditor, type: string, containerId: string, blockIndex: number, data?: Record<string, unknown>): Promise<import("../../types").BlockElement | null> | null;
+export declare function insertEmptyBlock(editor: OnesEditor, type: string, containerId: string, blockIndex: number, data?: Record<string, unknown>, item?: Record<string, unknown>): Promise<import("../../types").BlockElement | null> | null;

package/@ones-editor/core/src/core/blocks/embed-blocks/embed-block/common.d.ts

@@ -1,3 +1,4 @@
 import { BlockElement } from '../../../types';
+export declare function isColumnsBlock(block: BlockElement): boolean;
 export declare function isEmbedBlock(block: BlockElement): boolean;
 export declare function getEmbedType(block: BlockElement): string;

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

@@ -1,3 +1,4 @@
 import EmbedBlock from './embed-block';
 export * from './common';
+export * from './helper';
 export { EmbedBlock };

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

@@ -25,12 +25,12 @@ export declare class EditorInput implements OnesEditorInput {
     editor: OnesEditor;
     composing: boolean;
     callbacks: EditorInputCallbacks;
-    inputElement: HTMLInputElement;
+    inputElement: HTMLTextAreaElement;
     constructor(editor: OnesEditor, callbacks: EditorInputCallbacks);
     private isInCommandBar;
     destroy(): void;
-    getInput(): HTMLInputElement;
-    focus(): void;
+    getInput(): HTMLTextAreaElement;
+    focus(options?: FocusOptions): void;
     isInDisableScrollMask(target: Node): boolean;
     handleWindowBlur: () => void;
     handleWindowFocus: () => void;

package/@ones-editor/core/src/core/containers/children.d.ts

@@ -1,5 +1,8 @@
-import { BlockElement, ContainerElement } from '../types';
-export declare function getChildBlocks(container: ContainerElement): BlockElement[];
+import { BlockElement, ContainerElement, OnesEditor } from '../types';
+export declare function getChildBlocks(container: ContainerElement, traverseChild?: {
+    condition: (block: BlockElement) => boolean;
+    editor: OnesEditor;
+}): BlockElement[];
 export declare function getFirstChildBlock(container: ContainerElement): BlockElement;
 export declare function getLastChildBlock(container: ContainerElement): BlockElement;
 export declare function getChildBlockCount(container: ContainerElement): number;

package/@ones-editor/core/src/core/containers/element.d.ts

@@ -4,3 +4,4 @@ export declare function getContainerById(editor: OnesEditor, containerId: string
 export declare function getExistsContainerById(editor: OnesEditor, containerId: string): ContainerElement | null;
 export declare function getContainerBlocksElement(container: ContainerElement): ContainerBlocksElement;
 export declare function getContainerToolsElement(container: ContainerElement): ContainerToolsElement;
+export declare function isContainerBlocksElement(element: Element): element is ContainerBlocksElement;

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

@@ -1,3 +1,3 @@
-import { DocBlock, OnesEditorDoc } from './doc';
-export declare function createContainer(doc: OnesEditorDoc, blocks: DocBlock[]): string;
+import { DocBlock, DocObject, OnesEditorDoc } from './doc';
+export declare function createContainer(doc: OnesEditorDoc, docsOrDocObject: DocBlock[] | DocObject): string;
 export declare function createEmptyContainer(doc: OnesEditorDoc, text?: string): string;

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

@@ -244,7 +244,7 @@ export interface OnesEditorDoc extends OnesEditorDocServer {
     recognizeLink?: (link: string) => Promise<RecognizeLinkResult>;
     beginBatchUpdate: () => number;
     endBatchUpdate: () => number;
-    triggerReAuth?: () => void;
+    triggerReAuth?: (auto?: boolean) => void;
 }
 export interface OnesEditorDocHistoryData {
     user: {

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

@@ -1,4 +1,4 @@
 import { DocObject } from '../../../doc';
 import { BlockElement, CloneBlockResultInfo, ContainerElement, OnesEditor } from '../../../types';
 export declare function editorInsertDoc(editor: OnesEditor, block: BlockElement, offset: number, insertedDoc: DocObject, cloneDocResult?: CloneBlockResultInfo): void;
-export declare function editorInsertDocAt(editor: OnesEditor, container: ContainerElement, blockIndex: number, insertedDoc: DocObject, cloneDocResult?: CloneBlockResultInfo): BlockElement[];
+export declare function editorInsertDocAt(editor: OnesEditor, container: ContainerElement, blockIndex: number, _docToInsert: DocObject, cloneDocResult?: CloneBlockResultInfo): BlockElement[];

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

@@ -42,7 +42,7 @@ export default class EditorDoc extends EventCallbacks<OnesEditorDocCallbacks> im
     broadcastMessage(data: unknown): void;
     getUser(): import("../doc").OnesEditorUser;
     getRemoteUsers(): import("../doc").OnesEditorRemoteUsers;
-    triggerReAuth(): void | undefined;
+    triggerReAuth(auto?: boolean): void;
     destroy(): void;
     getServerMeta(): OnesEditorDocServerMeta;
     reset(doc: OnesEditorDoc): void;

package/@ones-editor/core/src/core/editor-doc/handle-block-data-changed.d.ts

@@ -1,2 +1,3 @@
+import type { DocBlockDelta } from '../doc';
 import { OnesEditor } from '../types';
-export declare function onBlockDataChanged(editor: OnesEditor, containerId: string, blockIndex: number): void;
+export declare function onBlockDataChanged(editor: OnesEditor, containerId: string, blockIndex: number, delta?: DocBlockDelta): 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, InsertBlockOptions, OnesEditorDoc, OnesEditorDocRange, UpdateBlockOptions } from './doc';
+import { DocBlock, DocBlockAttributes, DocBlockDelta, DocBlocks, DocBlockText, DocBlockTextAttributes, DocBox, DocEmbedBlock, DocEmbedData, DocInsertion, DocObject, InsertBlockOptions, OnesEditorDoc, OnesEditorDocRange, UpdateBlockOptions } from './doc';
 export type ContainerElement = HTMLDivElement & {
     __neverUse: 'ContainerElement';
 };
@@ -87,6 +87,7 @@ export interface EmbedOptions {
 }
 export interface Embed {
     embedType: string;
+    adjustableMinHeight?: number;
     createEmbedContent: (editor: OnesEditor, content: BlockContentElement, block: DocEmbedBlock, path: BlockPath, container: ContainerElement, blockElement: BlockElement) => void;
     convertTo?: (editor: OnesEditor, blockData: DocEmbedBlock, doc: DocObject, type: 'text' | 'html' | 'markdown') => string;
     getBlockProperties?: (editor: OnesEditor, block: BlockElement) => BlockProperties;
@@ -94,7 +95,7 @@ export interface Embed {
     handleDeleteBlock?: (editor: OnesEditor, block: BlockElement, local: boolean, options: DeleteBlockEventOptions) => void;
     handleUpdateBlock?: (editor: OnesEditor, block: BlockElement, blockData: DocEmbedBlock) => boolean;
     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;
+    handleDrop?: (editor: OnesEditor, block: BlockElement, dragData: DragObject | File[], insertPos: DropInsertResolvedPos, options: DropOptions) => boolean | undefined;
     convertFrom?: (editor: OnesEditor, srcBlock: BlockElement, options: {
         offset: number;
         data?: DocBlockAttributes;
@@ -118,6 +119,7 @@ export interface Closeable {
     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';
+export type CommandItemMenuType = 'inline' | 'sibling';
 export interface CommandItem {
     id: string;
     name: string;
@@ -147,6 +149,14 @@ export interface CommandItem {
     hideGroupItem?: boolean;
     setCloseable?: (closeable: Closeable) => void;
     beforePopup?: (parent: unknown) => void;
+    /**
+     * defaults to true
+    */
+    shouldShown?: (currentBlock: BlockElement | undefined, menuType: CommandItemMenuType) => boolean;
+    /**
+     * defaults to true
+    */
+    clickToClose?: boolean;
 }
 export interface BlockCommandItem extends CommandItem {
     blockId: string;
@@ -172,10 +182,47 @@ export interface BlockProperties {
     blockCommands?: Record<string, BlockCommands>;
     abstract?: string;
 }
+export interface DropHandler {
+    handleDrop: (editor: OnesEditor, dragData: BlockElement | File[], targetContainer: ContainerElement, blockIndex: number) => boolean | undefined;
+}
+export interface CombineToCreateOptions {
+    /**
+     * @returns sideway: 两侧合并（左右 indicator）
+     *
+     * body: 中间合并（target block 激活）（暂未实现）
+     */
+    combinable: (editor: OnesEditor, source: BlockElement, target: BlockElement) => undefined | 'sideway' | 'body';
+    onCombine: (editor: OnesEditor, source: BlockElement, target: BlockElement, position: CombineDropInsertPos['pos'], dragObject: DragObject | null, handlers: DropHandler[]) => BlockElement | undefined;
+}
+export type ContainerBlockOverrideInsertEmptyBlockInsideOptionsDict = Record<string, ContainerBlockOverrideInsertEmptyBlockInsideOptions>;
+export type ContainerBlockOverrideInsertEmptyBlockInsideOptions = {
+    item?: CommandItem;
+    data?: Record<string, unknown>;
+};
 export interface BlockOptions {
     name: string;
     insertBlockCommandItems?: CommandItem[];
+    overrideInertEmptyBlockInsideOptions?: ContainerBlockOverrideInsertEmptyBlockInsideOptionsDict;
     handleInsertEmptyBlock?: (editor: OnesEditor, options: InsertEmptyBlockOptions) => Promise<BlockElement | null>;
+    isMenuButtonBaseContainer?: (container: ContainerElement) => boolean;
+    combineToCreate?: CombineToCreateOptions;
+    /**
+     * defaults to true.
+     *
+     * 'without-margin': include margin for dragging preview computing.
+     */
+    draggingPreview?: boolean | 'margin-included';
+    innerToc?: boolean;
+    blockMenu?: {
+        showComment?: boolean;
+        showLocker?: boolean;
+    };
+    findPreviewElement?: (editor: OnesEditor, complexBlock: BlockElement) => HTMLElement;
+    headingCollapsable?: boolean;
+    /**
+     * 拖拽时，是否显示缩略图容器自带的阴影，默认为 false
+     */
+    previewNoShadow?: boolean;
 }
 export interface StandardDragObject {
     type: 'block';
@@ -193,10 +240,18 @@ export interface CustomDragObject {
 }
 export type DragObject = StandardDragObject | CustomDragObject;
 export interface CustomDropInsertPos {
+    type: 'custom';
     rect: DOMRect;
     data: unknown;
+    targetBlock?: BlockElement;
 }
-export type DropInsertPos = 'before' | 'after' | CustomDropInsertPos;
+export type CombineDropInsertPos = {
+    type: 'combine';
+    pos: 'left' | 'right';
+    onCombine: CombineToCreateOptions['onCombine'];
+};
+export type DropInsertPos = 'before' | 'after' | CombineDropInsertPos | CustomDropInsertPos | 'before-container' | 'after-container';
+export type DropInsertResolvedPos = Exclude<DropInsertPos, 'before-container' | 'after-container'>;
 export interface DropOptions {
     isSourceBlock: boolean;
     targetBlock: BlockElement;
@@ -217,9 +272,9 @@ export interface Block {
     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;
+    handleUpdateBlock?: (editor: OnesEditor, block: BlockElement, blockData: DocBlock, delta?: DocBlockDelta) => boolean;
     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;
+    handleDrop?: (editor: OnesEditor, block: BlockElement, dragData: DragObject | File[], insertPos: DropInsertResolvedPos, options: DropOptions) => boolean | ContainerElement | undefined;
     getClientRects?: (editor: OnesEditor, block: BlockElement, range: SelectionRange) => DOMRect[];
     getMinWidth?: (editor: OnesEditor, block: BlockElement) => number | undefined;
     convertFrom?: (editor: OnesEditor, srcBlock: BlockElement, options: {
@@ -230,7 +285,7 @@ export interface Block {
     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;
+    blockToDoc?: (srcDoc: DocObject, srcBlockData: DocBlock, childBlockConverter: (srcDoc: DocObject, srcBlockData: DocBlock) => DocObject, cloneDocResult?: CloneBlockResultInfo) => DocObject;
     getResources?: (editor: OnesEditor, data: DocBlock) => string[] | null;
     replaceResources?: (data: DocBlock, resources: Map<string, string>) => void;
 }
@@ -258,6 +313,7 @@ export interface ComplexKindBlock extends Block {
     getTextToolbarReferenceClient?: (editor: OnesEditor, complexBlock: BlockElement) => DOMRect | undefined;
     isChildContainerVisible?: (editor: OnesEditor, complexBlock: BlockElement, childContainer: ContainerElement) => boolean;
     showChildContainer?: (editor: OnesEditor, complexBlock: BlockElement, childContainer: ContainerElement) => void;
+    beforeInsertDoc?: (editor: OnesEditor, container: ContainerElement, insertDoc: DocObject) => DocObject | undefined;
 }
 export interface SelectedBlock {
     block: BlockElement;
@@ -446,7 +502,7 @@ export declare class OnesEditorCustomDataWrapper<T> {
     getEditor(): OnesEditor;
     destroy(): void;
 }
-export type OnesEditorCustomCreator = (editor: OnesEditor) => OnesEditorCustom;
+export type OnesEditorCustomCreator<T extends OnesEditorCustom = OnesEditorCustom> = (editor: OnesEditor) => T;
 export interface CloneBlockResultInfo {
     containerIdMap: Map<string, string>;
     blockIdMap: Map<string, string>;
@@ -487,7 +543,7 @@ export interface OnesEditor extends TypedEmitter<OnesEditorEvents> {
     readonly settingsProvider: OnesEditorSettingsProvider;
     version: string;
     readonly: boolean;
-    addCustom: <T extends OnesEditorCustom>(name: string, creator: OnesEditorCustomCreator) => T;
+    addCustom: <T extends OnesEditorCustom>(name: string, creator: OnesEditorCustomCreator<T>) => T;
     getCustom: <T extends OnesEditorCustom>(name: string) => T;
     replaceCustom: <T extends OnesEditorCustom>(name: string, newCustom: T) => T;
     findCustom: <T extends OnesEditorCustom>(name: string) => T | null;
@@ -499,7 +555,7 @@ export interface OnesEditor extends TypedEmitter<OnesEditorEvents> {
     createBox: (blockContent: BlockContentElement, box: DocBox) => BoxElement;
     createInsertion: (blockContent: BlockContentElement, insertion: DocInsertion) => InsertionElement;
     destroy: () => void;
-    focus: () => void;
+    focus: (options?: FocusOptions) => void;
     focusToBlock: (block: BlockElement, options?: {
         tryFocusToChildSimpleBlock?: boolean;
     }) => void;
@@ -583,7 +639,7 @@ export type PasteOptions = {
     toPlainText?: boolean;
 };
 export interface OnesEditorInput {
-    readonly inputElement: HTMLInputElement;
+    readonly inputElement: HTMLTextAreaElement;
     destroy: () => void;
     focus: () => void;
     handleDocumentSelectionChange: () => void;

package/@ones-editor/core/src/core/undo-manager/undo-manager.d.ts

@@ -16,6 +16,8 @@ declare class UndoManager implements OnesEditorUndoManager, EditorDocLocalAction
     private endGroup;
     hasGroup(): boolean;
     runInGroup<T>(action: () => T): T;
+    private verifyPos;
+    private checkRange;
     undo(): boolean;
     redo(): boolean;
     canUndo(): boolean;

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

@@ -1,8 +1,9 @@
 import { TypedEmitter } from 'tiny-typed-emitter';
-import { TextBlockContentChild } from '../core/blocks/text-blocks/base/child';
+import type { TextBlockContentChild } from '../core/blocks/text-blocks/base/child';
 import { BlockElement, OnesEditor, OnesEditorCustom } from '../core/types';
 export interface OnesEditorHoveringBlockEvents {
     change: (block: BlockElement | null, old: BlockElement | null, event: MouseEvent) => void;
+    targetChange: (block: BlockElement | null, old: BlockElement | null, target: EventTarget | null, oldTarget: EventTarget | null) => void;
     childChange: (block: BlockElement | null, child: TextBlockContentChild | null, old: TextBlockContentChild | null, event: MouseEvent) => void;
 }
 export interface OnesEditorHoveringBlockFilter extends OnesEditorCustom {
@@ -14,6 +15,7 @@ export interface OnesEditorHoveringBlockFinder extends OnesEditorCustom {
 export default class OnesEditorHoveringBlock extends TypedEmitter<OnesEditorHoveringBlockEvents> {
     private editor;
     private hoveringBlock;
+    private hoveringElem;
     private hoveringTextChild;
     private filters;
     private finders;

package/@ones-editor/core/src/i18n/en-us.d.ts

@@ -12,6 +12,7 @@ declare const _default: {
     };
     common: {
         cancel: string;
+        downloadAsImage: string;
     };
     docx: {
         imageExportFailed: string;

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

@@ -14,6 +14,7 @@ declare const langs: {
         };
         common: {
             cancel: string;
+            downloadAsImage: string;
         };
         docx: {
             imageExportFailed: string;
@@ -33,6 +34,7 @@ declare const langs: {
         };
         common: {
             cancel: string;
+            downloadAsImage: string;
         };
         docx: {
             imageExportFailed: string;
@@ -52,6 +54,7 @@ declare const langs: {
         };
         common: {
             cancel: string;
+            downloadAsImage: string;
         };
         docx: {
             imageExportFailed: string;