@ones-editor/editor 2.0.5-beta.28 → 2.0.5-beta.30

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-drop-target-finder.d.ts

@@ -0,0 +1,10 @@
+import { DropTargetFinder } from '../../../../@ones-editor/drop-target';
+import { BlockElement, OnesEditor } from '../../../../@ones-editor/core';
+export declare class CalloutDropTargetFinder implements DropTargetFinder {
+    private editor;
+    constructor(editor: OnesEditor);
+    private checkBlockAllowToDrop;
+    finder(editor: OnesEditor, source: BlockElement | null, x: number, y: number): BlockElement | null;
+    destroy(): void;
+    static init(editor: OnesEditor): CalloutDropTargetFinder;
+}

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, BlockProperties } from '../../../../@ones-editor/core';
+export declare function getBlockProperties(editor: OnesEditor): 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,3 @@
+import { BlockElement, CommandItem, OnesEditor } from '../../../../../@ones-editor/core';
+export declare const EMPTY_ICON = "";
+export declare function createDeleteIconItem(editor: OnesEditor, block: BlockElement): CommandItem;

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/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/composition/editor-input.d.ts

@@ -27,7 +27,7 @@ export declare class EditorInput implements OnesEditorInput {
     callbacks: EditorInputCallbacks;
     inputElement: HTMLInputElement;
     constructor(editor: OnesEditor, callbacks: EditorInputCallbacks);
-    private isInCommandbar;
+    private isInCommandBar;
     destroy(): void;
     getInput(): HTMLInputElement;
     focus(): 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/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/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/selection/editor-selection.d.ts

@@ -17,9 +17,7 @@ export declare class EditorSelection implements OnesEditorSelection {
     selectBlock(block: BlockElement, start: number, end?: number, options?: ChangeSelectionOptions): void;
     setSelection(anchor: BlockPosition, focus?: BlockPosition, options?: ChangeSelectionOptions): SelectionRange;
     setRange(range: SelectionRange, options?: ChangeSelectionOptions): SelectionRange;
-    updateSelection(oldRange: SelectionRange | null, options?: {
-        focusBlockChanged: boolean;
-    }): void;
+    updateSelection(): void;
     getFocusedPos(): BlockPosition;
     getAnchorPos(): BlockPosition;
     selectionChanging(anchor: BlockPosition, focus: BlockPosition): boolean;

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 } from './doc';
+import { DocBlock, DocBlockAttributes, DocBlockDelta, DocBlocks, DocBlockText, DocBlockTextAttributes, DocBox, DocEmbedBlock, DocEmbedData, DocInsertion, DocObject, InsertBlockOptions, OnesEditorDoc, OnesEditorDocRange } from './doc';
 export type ContainerElement = HTMLDivElement & {
     __neverUse: 'ContainerElement';
 };
@@ -118,6 +118,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 +148,10 @@ export interface CommandItem {
     hideGroupItem?: boolean;
     setCloseable?: (closeable: Closeable) => void;
     beforePopup?: (parent: unknown) => void;
+    /**
+     * defaults to true
+     */
+    shouldShown?: (currentBlock: BlockElement | undefined, menuType: CommandItemMenuType) => boolean;
 }
 export interface BlockCommandItem extends CommandItem {
     blockId: string;
@@ -172,10 +177,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 +235,17 @@ 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;
 export interface DropOptions {
     isSourceBlock: boolean;
     targetBlock: BlockElement;
@@ -217,9 +266,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: DropInsertPos, 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 +279,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 +307,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 +496,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 +537,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;
@@ -568,9 +618,7 @@ export interface OnesEditorSelection {
     setSelection: (anchor: BlockPosition, focus?: BlockPosition, options?: ChangeSelectionOptions) => SelectionRange;
     setRange: (range: SelectionRange, options?: ChangeSelectionOptions) => SelectionRange;
     selectBlock: (block: BlockElement, start: number, end?: number, options?: ChangeSelectionOptions) => void;
-    updateSelection: (old: SelectionRange | null, options?: {
-        focusBlockChanged: boolean;
-    }) => void;
+    updateSelection: (old: SelectionRange | null) => void;
     updateLastCaretRect: () => void;
     getSuggestedCaretX: () => number | undefined;
     getAnchorPos: () => BlockPosition;

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/drop-target/src/drop-indicator.d.ts

@@ -1,4 +1,4 @@
-import { BlockElement, DropInsertPos, OnesEditor } from '../../../@ones-editor/core';
+import { BlockContentElement, BlockElement, DropInsertPos, OnesEditor } from '../../../@ones-editor/core';
 export declare const INDICATOR_SIZE = 2;
 interface DropTarget {
     block: BlockElement;
@@ -9,9 +9,10 @@ export default class DropIndicator {
     private indicator;
     target: DropTarget | null;
     constructor(editor: OnesEditor);
+    createIndicator(): void;
     show(block: BlockElement, insertPos: DropInsertPos): void;
     hide(): void;
     private getIndicatorRect;
-    getViewRect(block: BlockElement): DOMRect;
+    getViewRect(block: BlockElement | BlockContentElement): DOMRect;
 }
 export {};

package/@ones-editor/drop-target/src/drop-target.d.ts

@@ -1,8 +1,12 @@
-import { BlockElement, ContainerElement, OnesEditor } from '../../../@ones-editor/core';
+import { BlockElement, CombineToCreateOptions, ContainerElement, OnesEditor } from '../../../@ones-editor/core';
 import DropIndicator from './drop-indicator';
 export interface DropHandler {
     handleDrop: (editor: OnesEditor, dragData: BlockElement | File[], targetContainer: ContainerElement, blockIndex: number) => boolean | undefined;
 }
+export type DropTargetFinderId = keyof any;
+export interface DropTargetFinder {
+    finder: (editor: OnesEditor, source: BlockElement | null, x: number, y: number) => BlockElement | null;
+}
 export default class OnesEditorDropTarget {
     private editor;
     indicator: DropIndicator;
@@ -12,9 +16,12 @@ export default class OnesEditorDropTarget {
         dropEffect: 'move' | 'none';
     } | undefined;
     handlers: DropHandler[];
+    dropTargetFinders: Map<string | number | symbol, DropTargetFinder>;
+    combineToCreate: CombineToCreateOptions[];
     constructor(editor: OnesEditor);
     destroy(): void;
     addHandler(handler: DropHandler): void;
+    addFinder(id: DropTargetFinderId, finder: DropTargetFinder): void;
     static register(editor: OnesEditor): OnesEditorDropTarget;
     static get(editor: OnesEditor): OnesEditorDropTarget;
     static find(editor: OnesEditor): OnesEditorDropTarget | null;

package/@ones-editor/drop-target/src/find-drop-target.d.ts

@@ -1,3 +1,3 @@
 import { BlockElement, OnesEditor } from '../../../@ones-editor/core';
-export declare function findTargetBlock(editor: OnesEditor, x: number, y: number): BlockElement | null;
+export declare function findTargetBlock(editor: OnesEditor, x?: number, y?: number): BlockElement | null;
 export declare function canInsertAsSibling(editor: OnesEditor, block: BlockElement): boolean;

package/@ones-editor/drop-target/src/index.d.ts

@@ -1,5 +1,7 @@
+import { INDICATOR_SIZE } from './drop-indicator';
 import OnesEditorDropTarget from './drop-target';
 import type { DropHandler } from './drop-target';
 import { patchInsertFile } from './handlers/patch-insert-file';
+export type { DropTargetFinder, DropTargetFinderId } from './drop-target';
 export * from './drag-object';
-export { OnesEditorDropTarget, DropHandler, patchInsertFile };
+export { OnesEditorDropTarget, DropHandler, patchInsertFile, INDICATOR_SIZE };

package/@ones-editor/find-dialog/src/shortcuts.d.ts

@@ -1,9 +1,7 @@
 import { OnesEditor } from '../../../@ones-editor/core';
 import './locale';
 export declare function handleFindReplace(editor: OnesEditor): boolean;
-declare function handleReplaceAndFind(editor: OnesEditor): boolean;
 declare const FindReplaceShortcuts: {
     'CtrlOrCmd+F': typeof handleFindReplace;
-    'CtrlOrCmd+Shift+H': typeof handleReplaceAndFind;
 };
 export { FindReplaceShortcuts, };

package/@ones-editor/heading-collapse/src/heading-collapse-button/heading-utils.d.ts

@@ -1,2 +1,3 @@
-import { BlockElement } from '../../../../@ones-editor/core';
+import { BlockElement, OnesEditor } from '../../../../@ones-editor/core';
 export declare function isTitleBlock(block: BlockElement): boolean;
+export declare function canShowCollapseButtons(editor: OnesEditor, hoverBlock: BlockElement | null): boolean;

package/@ones-editor/heading-collapse/src/index.d.ts

@@ -3,3 +3,4 @@ import './style.scss';
 export * from './heading-collapse-button';
 export * from './keyboard';
 export * from './doc-event';
+export { isHeadingCollapsed } from './doc-event/collapse-handler';