roosterjs 8.23.1 → 8.26.0

package/dist/rooster.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 8.23.1)
+// Type definitions for roosterjs (Version 8.26.0)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -338,6 +338,7 @@ function applyTextStyle(container: Node, styler: (node: HTMLElement, isInnerNode
  * @param event The paste event
  * @param callback Callback function when data is ready
  * @param options Options to retrieve more items from the event, including HTML string and other customized items
+ * @param rangeBeforePaste Optional range to be removed when pasting in Android
  * @returns An object with the following properties:
  *  types: Available types from the clipboard event
  *  text: Plain text from the clipboard event
@@ -346,7 +347,7 @@ function applyTextStyle(container: Node, styler: (node: HTMLElement, isInnerNode
  *   When set to undefined, it means can't retrieve HTML string, there may be HTML string but direct retrieving is
  *   not supported by browser.
  */
-function extractClipboardEvent(event: ClipboardEvent, callback: (clipboardData: ClipboardData) => void, options?: ExtractClipboardEventOption): void;
+function extractClipboardEvent(event: ClipboardEvent, callback: (clipboardData: ClipboardData) => void, options?: ExtractClipboardEventOption, rangeBeforePaste?: Range): void;
 
     /**
  * Extract clipboard items to be a ClipboardData object for IE
@@ -376,13 +377,6 @@ function extractClipboardItems(items: DataTransferItem[], options?: ExtractClipb
  */
 function extractClipboardItemsForIE(dataTransfer: DataTransfer, callback: (data: ClipboardData) => void, options?: ExtractClipboardItemsForIEOptions): void;
 
-    /**
- * A type-safe wrapper for Array.prototype.push.apply()
- * @param mainArray The main array to push items into
- * @param itemsArray The items to push to main array
- */
-function arrayPush<T>(mainArray: T[], itemsArray: T[]): void;
-
     /**
  * Browser object contains browser and operating system information of current environment
  */
@@ -529,7 +523,7 @@ function isBlockElement(node: Node): node is HTMLElement;
  * Default value is false
  * @returns True if there isn't any visible element inside node, otherwise false
  */
-function isNodeEmpty(node: Node, trimContent?: boolean): boolean;
+function isNodeEmpty(node: Node, trimContent?: boolean, shouldCountBrAsVisible?: boolean): boolean;
 
     /**
  * Check if the given node is html void element. Void element cannot have children
@@ -662,38 +656,6 @@ function splitTextNode(textNode: Text, offset: number, returnFirstPart: boolean)
  */
 function normalizeRect(clientRect: DOMRect): Rect | null;
 
-    /**
- * Convert a named node map to an array
- * @param collection The map to convert
- */
-function toArray(collection: NamedNodeMap): Attr[];
-
-    /**
- * Convert a named node map to an array
- * @param collection The map to convert
- */
-function toArray(collection: DataTransferItemList): DataTransferItem[];
-
-    /**
- * Convert a collection to an array
- * @param collection The collection to convert
- */
-function toArray<T extends Node>(collection: NodeListOf<T>): T[];
-
-    /**
- * Convert a collection to an array
- * @param collection The collection to convert
- */
-function toArray<T extends Element>(collection: HTMLCollectionOf<T>): T[];
-
-    /**
- * Convert an array to an array.
- * This is to satisfy typescript compiler. For some cases the object can be a collection at runtime,
- * but the declaration is an array. e.g. ClipboardData.types
- * @param array The array to convert
- */
-function toArray<T>(array: readonly T[]): T[];
-
     /**
  * Check if the given object is instance of the target type
  * @param obj Object to check
@@ -990,9 +952,10 @@ class VList {
     /**
      * Change list style of the given range of this list.
      * If some of the items are not real list item yet, this will make them to be list item with given style
-     * @param targetStyle Target list style
+     * @param orderedStyle The style of ordered list
+     * @param unorderedStyle The style of unordered list
      */
-    setListStyleType(targetStyle: NumberingListType | BulletListType | CompatibleBulletListType | CompatibleNumberingListType): void;
+    setListStyleType(orderedStyle?: NumberingListType | CompatibleNumberingListType, unorderedStyle?: BulletListType | CompatibleBulletListType): void;
     /**
      * Append a new item to this VList
      * @param node node of the item to append. If it is not wrapped with LI tag, it will be wrapped
@@ -1793,6 +1756,52 @@ function setMetadata<T>(element: HTMLElement, metadata: T, def?: Definition<T>):
  */
 function removeMetadata(element: HTMLElement): void;
 
+    /**
+ * A type-safe wrapper for Array.prototype.push.apply()
+ * @param mainArray The main array to push items into
+ * @param itemsArray The items to push to main array
+ */
+function arrayPush<T>(mainArray: T[], itemsArray: T[]): void;
+
+    /**
+ * Provide a strong-typed version of Object.keys()
+ * @param obj The source object
+ * @returns Array of keys
+ */
+function getObjectKeys<T extends string | number | symbol>(obj: Record<T, any> | Partial<Record<T, any>>): T[];
+
+    /**
+ * Convert a named node map to an array
+ * @param collection The map to convert
+ */
+function toArray(collection: NamedNodeMap): Attr[];
+
+    /**
+ * Convert a named node map to an array
+ * @param collection The map to convert
+ */
+function toArray(collection: DataTransferItemList): DataTransferItem[];
+
+    /**
+ * Convert a collection to an array
+ * @param collection The collection to convert
+ */
+function toArray<T extends Node>(collection: NodeListOf<T>): T[];
+
+    /**
+ * Convert a collection to an array
+ * @param collection The collection to convert
+ */
+function toArray<T extends Element>(collection: HTMLCollectionOf<T>): T[];
+
+    /**
+ * Convert an array to an array.
+ * This is to satisfy typescript compiler. For some cases the object can be a collection at runtime,
+ * but the declaration is an array. e.g. ClipboardData.types
+ * @param array The array to convert
+ */
+function toArray<T>(array: readonly T[]): T[];
+
     /**
  * RoosterJs core editor class
  */
@@ -2545,14 +2554,15 @@ function applyCellShading(editor: IEditor, color: string | ModeIndependentColor)
  * @param listType The list type to toggle
  * @param startNumber (Optional) Start number of the list
  * @param includeSiblingLists Sets wether the operation should include Sibling Lists, by default true
- * @param listStyle (Optional) the style of an ordered or unordered list. If If not defined, the style will be set to disc or decimal.
+ * @param orderedStyle (Optional) the style of an ordered. If not defined, the style will be set to decimal.
+ * @param unorderedStyle (Optional) the style of an unordered list. If not defined, the style will be set to disc.
  */
-function toggleListType(editor: IEditor, listType: ListType | CompatibleListType, startNumber?: number, includeSiblingLists?: boolean, listStyle?: BulletListType | NumberingListType | CompatibleBulletListType | CompatibleNumberingListType): void;
+function toggleListType(editor: IEditor, listType: ListType | CompatibleListType, startNumber?: number, includeSiblingLists?: boolean, orderedStyle?: NumberingListType | CompatibleNumberingListType, unorderedStyle?: BulletListType | CompatibleBulletListType): void;
 
     /**
  * Split selection into regions, and perform a block-wise formatting action for each region.
  */
-function blockFormat(editor: IEditor, callback: (region: Region, start: NodePosition, end: NodePosition, chains: VListChain[]) => void, beforeRunCallback?: () => boolean): void;
+function blockFormat(editor: IEditor, callback: (region: Region, start: NodePosition, end: NodePosition, chains: VListChain[]) => void, beforeRunCallback?: () => boolean, apiName?: string): void;
 
     /**
  * Commit changes of all list changes when experiment features are allowed
@@ -3475,6 +3485,7 @@ const enum ExperimentalFeatures {
      */
     AutoFormatList = "AutoFormatList",
     /**
+     * @deprecated this feature is always disabled
      * Automatically transform -- into hyphen, if typed between two words.
      */
     AutoHyphen = "AutoHyphen"
@@ -4033,116 +4044,136 @@ const enum SelectionRangeTypes {
  *  Enum used to control the different types of numbering list
  */
 const enum NumberingListType {
+    /**
+     * Minimum value of the enum
+     */
+    Min = 1,
     /**
      * Numbering triggered by 1.
      */
-    Decimal = 0,
+    Decimal = 1,
     /**
      * Numbering triggered by 1-
      */
-    DecimalDash = 1,
+    DecimalDash = 2,
     /**
      * Numbering triggered by 1)
      */
-    DecimalParenthesis = 2,
+    DecimalParenthesis = 3,
     /**
      * Numbering triggered by (1)
      */
-    DecimalDoubleParenthesis = 3,
+    DecimalDoubleParenthesis = 4,
     /**
      * Numbering triggered by a.
      */
-    LowerAlpha = 4,
+    LowerAlpha = 5,
     /**
      * Numbering triggered by a)
      */
-    LowerAlphaParenthesis = 5,
+    LowerAlphaParenthesis = 6,
     /**
      * Numbering triggered by (a)
      */
-    LowerAlphaDoubleParenthesis = 6,
+    LowerAlphaDoubleParenthesis = 7,
     /**
      * Numbering triggered by a-
      */
-    LowerAlphaDash = 7,
+    LowerAlphaDash = 8,
     /**
      * Numbering triggered by A.
      */
-    UpperAlpha = 8,
+    UpperAlpha = 9,
     /**
      * Numbering triggered by A)
      */
-    UpperAlphaParenthesis = 9,
+    UpperAlphaParenthesis = 10,
     /**
      * Numbering triggered by (A)
      */
-    UpperAlphaDoubleParenthesis = 10,
+    UpperAlphaDoubleParenthesis = 11,
     /**
      * Numbering triggered by A-
      */
-    UpperAlphaDash = 11,
+    UpperAlphaDash = 12,
     /**
      * Numbering triggered by i.
      */
-    LowerRoman = 12,
+    LowerRoman = 13,
     /**
      * Numbering triggered by i)
      */
-    LowerRomanParenthesis = 13,
+    LowerRomanParenthesis = 14,
     /**
      * Numbering triggered by (i)
      */
-    LowerRomanDoubleParenthesis = 14,
+    LowerRomanDoubleParenthesis = 15,
     /**
      * Numbering triggered by i-
      */
-    LowerRomanDash = 15,
+    LowerRomanDash = 16,
     /**
      * Numbering triggered by I.
      */
-    UpperRoman = 16,
+    UpperRoman = 17,
     /**
      * Numbering triggered by I)
      */
-    UpperRomanParenthesis = 17,
+    UpperRomanParenthesis = 18,
     /**
      * Numbering triggered by (I)
      */
-    UpperRomanDoubleParenthesis = 18,
+    UpperRomanDoubleParenthesis = 19,
     /**
      * Numbering triggered by I-
      */
-    UpperRomanDash = 19
+    UpperRomanDash = 20,
+    /**
+     * Maximum value of the enum
+     */
+    Max = 20
 }
 
     /**
  *  Enum used to control the different types of bullet list
  */
 const enum BulletListType {
+    /**
+     * Minimum value of the enum
+     */
+    Min = 1,
     /**
      * Bullet triggered by *
      */
-    Disc = 0,
+    Disc = 1,
     /**
      * Bullet triggered by -
      */
-    Dash = 1,
+    Dash = 2,
     /**
      * Bullet triggered by --
      */
-    Square = 2,
+    Square = 3,
     /**
      * Bullet triggered by >
      */
-    ShortArrow = 3,
+    ShortArrow = 4,
     /**
      * Bullet triggered by -> or -->
      */
-    LongArrow = 4,
+    LongArrow = 5,
     /**
      * Bullet triggered by =>
      */
-    UnfilledArrow = 5
+    UnfilledArrow = 6,
+    /**
+     * Bullet triggered by —
+     */
+    Hyphen = 7,
+    /**
+     * Maximum value of the enum
+     */
+    Max = 7
 }
 
     /**
@@ -4178,7 +4209,13 @@ const enum DefinitionType {
     /**
  * Provides a chance for plugin to change the content before it is copied from editor.
  */
-interface BeforeCutCopyEvent extends BasePluginEvent<PluginEventType.BeforeCutCopy> {
+interface BeforeCutCopyEvent extends BeforeCutCopyEventData, BasePluginEvent<PluginEventType.BeforeCutCopy> {
+}
+
+    /**
+ * Data of BeforeCutCopyEvent
+ */
+interface BeforeCutCopyEventData {
     /**
      * Raw DOM event
      */
@@ -4197,6 +4234,12 @@ interface BeforeCutCopyEvent extends BasePluginEvent<PluginEventType.BeforeCutCo
     isCut: boolean;
 }
 
+    /**
+ * Provides a chance for plugin to change the content before it is copied from editor.
+ */
+interface CompatibleBeforeCutCopyEvent extends BeforeCutCopyEventData, BasePluginEvent<CompatiblePluginEventType.BeforeCutCopy> {
+}
+
     /**
  * Editor plugin event interface
  */
@@ -4224,7 +4267,19 @@ interface BeforeDisposeEvent extends BasePluginEvent<PluginEventType.BeforeDispo
     /**
  * Provides a chance for plugin to change the content before it is pasted into editor.
  */
-interface BeforePasteEvent extends BasePluginEvent<PluginEventType.BeforePaste> {
+interface CompatibleBeforeDisposeEvent extends BasePluginEvent<CompatiblePluginEventType.BeforeDispose> {
+}
+
+    /**
+ * Provides a chance for plugin to change the content before it is pasted into editor.
+ */
+interface BeforePasteEvent extends BeforePasteEventData, BasePluginEvent<PluginEventType.BeforePaste> {
+}
+
+    /**
+ * Data of BeforePasteEvent
+ */
+interface BeforePasteEventData {
     /**
      * An object contains all related data for pasting
      */
@@ -4251,21 +4306,46 @@ interface BeforePasteEvent extends BasePluginEvent<PluginEventType.BeforePaste>
     htmlAttributes: Record<string, string>;
 }
 
+    /**
+ * Provides a chance for plugin to change the content before it is pasted into editor.
+ */
+interface CompatibleBeforePasteEvent extends BeforePasteEventData, BasePluginEvent<CompatiblePluginEventType.BeforePaste> {
+}
+
     /**
  * The event to be triggered before SetContent API is called.
  * Handle this event to cache anything you need from editor before it is gone.
  */
-interface BeforeSetContentEvent extends BasePluginEvent<PluginEventType.BeforeSetContent> {
+interface BeforeSetContentEvent extends BeforeSetContentEventData, BasePluginEvent<PluginEventType.BeforeSetContent> {
+}
+
+    /**
+ * Data of BeforeSetContentEvent
+ */
+interface BeforeSetContentEventData {
     /**
      * New content HTML that is about to set to editor
      */
     newContent: string;
 }
 
+    /**
+ * The event to be triggered before SetContent API is called.
+ * Handle this event to cache anything you need from editor before it is gone.
+ */
+interface CompatibleBeforeSetContentEvent extends BeforeSetContentEventData, BasePluginEvent<CompatiblePluginEventType.BeforeSetContent> {
+}
+
     /**
  * Represents a change to the editor made by another plugin
  */
-interface ContentChangedEvent extends BasePluginEvent<PluginEventType.ContentChanged> {
+interface ContentChangedEvent extends ContentChangedEventData, BasePluginEvent<PluginEventType.ContentChanged> {
+}
+
+    /**
+ * Data of ContentChangedEvent
+ */
+interface ContentChangedEventData {
     /**
      * Source of the change
      */
@@ -4274,13 +4354,26 @@ interface ContentChangedEvent extends BasePluginEvent<PluginEventType.ContentCha
      * Optional related data
      */
     data?: any;
+    additionalData?: ContentChangedData;
+}
+
+    /**
+ * Represents a change to the editor made by another plugin
+ */
+interface CompatibleContentChangedEvent extends ContentChangedEventData, BasePluginEvent<CompatiblePluginEventType.ContentChanged> {
 }
 
     /**
  * Represents an event that will be fired when an inline image is edited by user, and the src
  * attribute of the image is about to be changed
  */
-interface EditImageEvent extends BasePluginEvent<PluginEventType.EditImage> {
+interface EditImageEvent extends EditImageEventData, BasePluginEvent<PluginEventType.EditImage> {
+}
+
+    /**
+ * Data of EditImageEvent
+ */
+interface EditImageEventData {
     /**
      * The image element that is being changed
      */
@@ -4301,17 +4394,36 @@ interface EditImageEvent extends BasePluginEvent<PluginEventType.EditImage> {
     newSrc: string;
 }
 
+    /**
+ * Represents an event that will be fired when an inline image is edited by user, and the src
+ * attribute of the image is about to be changed
+ */
+interface CompatibleEditImageEvent extends EditImageEventData, BasePluginEvent<CompatiblePluginEventType.EditImage> {
+}
+
     /**
  * Provides a chance for plugin to change the content before it is pasted into editor.
  */
 interface EditorReadyEvent extends BasePluginEvent<PluginEventType.EditorReady> {
+}
+
+    /**
+ * Provides a chance for plugin to change the content before it is pasted into editor.
+ */
+interface CompatibleEditorReadyEvent extends BasePluginEvent<CompatiblePluginEventType.EditorReady> {
 }
 
     /**
  * Provide a chance for plugins to handle entity related events.
  * See enum EntityOperation for more details about each operation
  */
-interface EntityOperationEvent extends BasePluginEvent<PluginEventType.EntityOperation> {
+interface EntityOperationEvent extends EntityOperationEventData, BasePluginEvent<PluginEventType.EntityOperation> {
+}
+
+    /**
+ * Data of EntityOperationEvent
+ */
+interface EntityOperationEventData {
     /**
      * Operation to this entity
      */
@@ -4338,13 +4450,26 @@ interface EntityOperationEvent extends BasePluginEvent<PluginEventType.EntityOpe
     contentForShadowEntity?: DocumentFragment;
 }
 
+    /**
+ * Provide a chance for plugins to handle entity related events.
+ * See enum EntityOperation for more details about each operation
+ */
+interface CompatibleEntityOperationEvent extends EntityOperationEventData, BasePluginEvent<CompatiblePluginEventType.EntityOperation> {
+}
+
     /**
  * Extract Content with a DOM tree event
  * This event is triggered when getContent() is called with triggerExtractContentEvent = true
  * Plugin can handle this event to remove the UI only markups to return clean HTML
  * by operating on a cloned DOM tree
  */
-interface ExtractContentWithDomEvent extends BasePluginEvent<PluginEventType.ExtractContentWithDom> {
+interface ExtractContentWithDomEvent extends ExtractContentWithDomEventData, BasePluginEvent<PluginEventType.ExtractContentWithDom> {
+}
+
+    /**
+ * Data of ExtractContentWithDomEvent
+ */
+interface ExtractContentWithDomEventData {
     /**
      * Cloned root element of editor
      * Plugin can change this DOM tree to clean up the markups it added before
@@ -4352,6 +4477,15 @@ interface ExtractContentWithDomEvent extends BasePluginEvent<PluginEventType.Ext
     clonedRoot: HTMLElement;
 }
 
+    /**
+ * Extract Content with a DOM tree event
+ * This event is triggered when getContent() is called with triggerExtractContentEvent = true
+ * Plugin can handle this event to remove the UI only markups to return clean HTML
+ * by operating on a cloned DOM tree
+ */
+interface CompatibleExtractContentWithDomEvent extends ExtractContentWithDomEventData, BasePluginEvent<CompatiblePluginEventType.ExtractContentWithDom> {
+}
+
     /**
  * An event fired when pending format state (bold, italic, underline, ... with collapsed selection) is changed
  */
@@ -4359,6 +4493,13 @@ interface PendingFormatStateChangedEvent extends BasePluginEvent<PluginEventType
     formatState: PendableFormatState;
 }
 
+    /**
+ * An event fired when pending format state (bold, italic, underline, ... with collapsed selection) is changed
+ */
+interface CompatiblePendingFormatStateChangedEvent extends BasePluginEvent<CompatiblePluginEventType.PendingFormatStateChanged> {
+    formatState: PendableFormatState;
+}
+
     /**
  * This represents a PluginEvent wrapping native browser event
  */
@@ -4380,13 +4521,7 @@ interface PluginCompositionEvent extends PluginDomEventBase<PluginEventType.Comp
     /**
  * This interface represents a PluginEvent wrapping native ContextMenu event
  */
-interface PluginContextMenuEvent extends PluginDomEventBase<PluginEventType.ContextMenu, MouseEvent> {
-    /**
-     * A callback array to let editor retrieve context menu item related to this event.
-     * Plugins can add their own getter callback to this array,
-     * items from each getter will be separated by a splitter item represented by null
-     */
-    items: any[];
+interface PluginContextMenuEvent extends PluginContextMenuEventData, PluginDomEventBase<PluginEventType.ContextMenu, MouseEvent> {
 }
 
     /**
@@ -4426,11 +4561,7 @@ interface PluginMouseDownEvent extends PluginDomEventBase<PluginEventType.MouseD
     /**
  * This interface represents a PluginEvent wrapping native MouseUp event
  */
-interface PluginMouseUpEvent extends PluginDomEventBase<PluginEventType.MouseUp, MouseEvent> {
-    /**
-     * Whether this is a mouse click event (mouse up and down on the same position)
-     */
-    isClicking?: boolean;
+interface PluginMouseUpEvent extends PluginMouseUpEventData, PluginDomEventBase<PluginEventType.MouseUp, MouseEvent> {
 }
 
     /**
@@ -4442,14 +4573,114 @@ interface PluginInputEvent extends PluginDomEventBase<PluginEventType.Input, Inp
     /**
  * This interface represents a PluginEvent wrapping native scroll event
  */
-interface PluginScrollEvent extends PluginDomEventBase<PluginEventType.Scroll, UIEvent> {
+interface PluginScrollEvent extends PluginScrollEventData, PluginDomEventBase<PluginEventType.Scroll, UIEvent> {
+}
+
+    /**
+ * This represents a PluginEvent wrapping native browser event
+ */
+type CompatiblePluginDomEvent = CompatiblePluginCompositionEvent | CompatiblePluginMouseEvent | CompatiblePluginKeyboardEvent | CompatiblePluginInputEvent | CompatiblePluginScrollEvent;
+
+    /**
+ * This interface represents a PluginEvent wrapping native CompositionEnd event
+ */
+interface CompatiblePluginCompositionEvent extends PluginDomEventBase<CompatiblePluginEventType.CompositionEnd, CompositionEvent> {
+}
+
+    /**
+ * This interface represents a PluginEvent wrapping native ContextMenu event
+ */
+interface CompatiblePluginContextMenuEvent extends PluginContextMenuEventData, PluginDomEventBase<CompatiblePluginEventType.ContextMenu, MouseEvent> {
+}
+
+    /**
+ * The interface represents a PluginEvent wrapping native Keyboard event
+ */
+type CompatiblePluginKeyboardEvent = CompatiblePluginKeyDownEvent | CompatiblePluginKeyPressEvent | CompatiblePluginKeyUpEvent;
+
+    /**
+ * This interface represents a PluginEvent wrapping native KeyDown event
+ */
+interface CompatiblePluginKeyDownEvent extends PluginDomEventBase<CompatiblePluginEventType.KeyDown, KeyboardEvent> {
+}
+
+    /**
+ * This interface represents a PluginEvent wrapping native KeyPress event
+ */
+interface CompatiblePluginKeyPressEvent extends PluginDomEventBase<CompatiblePluginEventType.KeyPress, KeyboardEvent> {
+}
+
+    /**
+ * This interface represents a PluginEvent wrapping native KeyUp event
+ */
+interface CompatiblePluginKeyUpEvent extends PluginDomEventBase<CompatiblePluginEventType.KeyUp, KeyboardEvent> {
+}
+
+    /**
+ * This interface represents a PluginEvent wrapping native Mouse event
+ */
+type CompatiblePluginMouseEvent = CompatiblePluginMouseDownEvent | CompatiblePluginMouseUpEvent | CompatiblePluginContextMenuEvent;
+
+    /**
+ * This interface represents a PluginEvent wrapping native MouseDown event
+ */
+interface CompatiblePluginMouseDownEvent extends PluginDomEventBase<CompatiblePluginEventType.MouseDown, MouseEvent> {
+}
+
+    /**
+ * This interface represents a PluginEvent wrapping native MouseUp event
+ */
+interface CompatiblePluginMouseUpEvent extends PluginMouseUpEventData, PluginDomEventBase<CompatiblePluginEventType.MouseUp, MouseEvent> {
+}
+
+    /**
+ * This interface represents a PluginEvent wrapping native input / textinput event
+ */
+interface CompatiblePluginInputEvent extends PluginDomEventBase<CompatiblePluginEventType.Input, InputEvent> {
+}
+
+    /**
+ * This interface represents a PluginEvent wrapping native scroll event
+ */
+interface CompatiblePluginScrollEvent extends PluginScrollEventData, PluginDomEventBase<CompatiblePluginEventType.Scroll, UIEvent> {
+}
+
+    /**
+ * Data of PluginScrollEvent
+ */
+interface PluginScrollEventData {
+    /**
+     * Current scroll container that triggers this scroll event
+     */
     scrollContainer: HTMLElement;
 }
 
+    /**
+ * Data of PluginMouseUpEvent
+ */
+interface PluginMouseUpEventData {
+    /**
+     * Whether this is a mouse click event (mouse up and down on the same position)
+     */
+    isClicking?: boolean;
+}
+
+    /**
+ * Data of PluginContextMenuEvent
+ */
+interface PluginContextMenuEventData {
+    /**
+     * A callback array to let editor retrieve context menu item related to this event.
+     * Plugins can add their own getter callback to this array,
+     * items from each getter will be separated by a splitter item represented by null
+     */
+    items: any[];
+}
+
     /**
  * Editor plugin event interface
  */
-type PluginEvent = BeforeCutCopyEvent | BeforePasteEvent | ContentChangedEvent | EntityOperationEvent | ExtractContentWithDomEvent | PluginDomEvent | EditorReadyEvent | BeforeDisposeEvent | PendingFormatStateChangedEvent | EnterShadowEditEvent | LeaveShadowEditEvent | EditImageEvent | BeforeSetContentEvent | ZoomChangedEvent;
+type PluginEvent = BeforeCutCopyEvent | BeforePasteEvent | ContentChangedEvent | EntityOperationEvent | ExtractContentWithDomEvent | PluginDomEvent | EditorReadyEvent | BeforeDisposeEvent | PendingFormatStateChangedEvent | EnterShadowEditEvent | LeaveShadowEditEvent | EditImageEvent | BeforeSetContentEvent | ZoomChangedEvent | CompatibleBeforeCutCopyEvent | CompatibleBeforeDisposeEvent | CompatibleBeforePasteEvent | CompatibleBeforeSetContentEvent | CompatibleContentChangedEvent | CompatibleEditImageEvent | CompatibleEditorReadyEvent | CompatibleEntityOperationEvent | CompatibleExtractContentWithDomEvent | CompatiblePendingFormatStateChangedEvent | CompatiblePluginDomEvent | CompatibleEnterShadowEditEvent | CompatibleLeaveShadowEditEvent | CompatibleZoomChangedEvent;
 
     /**
  * A type to extract data part of a plugin event type. Data part is the plugin event without eventType field.
@@ -4476,7 +4707,19 @@ type PluginEventFromTypeGeneric<E extends PluginEvent, T extends PluginEventType
     /**
  * A plugin triggered right after editor has entered Shadow Edit mode
  */
-interface EnterShadowEditEvent extends BasePluginEvent<PluginEventType.EnteredShadowEdit> {
+interface EnterShadowEditEvent extends EnterShadowEditEventData, BasePluginEvent<PluginEventType.EnteredShadowEdit> {
+}
+
+    /**
+ * A plugin triggered right before editor leave Shadow Edit mode
+ */
+interface LeaveShadowEditEvent extends BasePluginEvent<PluginEventType.LeavingShadowEdit> {
+}
+
+    /**
+ * Data of EnterShadowEditEvent
+ */
+interface EnterShadowEditEventData {
     /**
      * The document fragment of original editor content
      */
@@ -4487,10 +4730,16 @@ interface EnterShadowEditEvent extends BasePluginEvent<PluginEventType.EnteredSh
     selectionPath: SelectionPath;
 }
 
+    /**
+ * A plugin triggered right after editor has entered Shadow Edit mode
+ */
+interface CompatibleEnterShadowEditEvent extends EnterShadowEditEventData, BasePluginEvent<CompatiblePluginEventType.EnteredShadowEdit> {
+}
+
     /**
  * A plugin triggered right before editor leave Shadow Edit mode
  */
-interface LeaveShadowEditEvent extends BasePluginEvent<PluginEventType.LeavingShadowEdit> {
+interface CompatibleLeaveShadowEditEvent extends BasePluginEvent<CompatiblePluginEventType.LeavingShadowEdit> {
 }
 
     /**
@@ -4498,7 +4747,13 @@ interface LeaveShadowEditEvent extends BasePluginEvent<PluginEventType.LeavingSh
  * Plugins can handle this event when they need to do something for zoom changing.
  *
  */
-interface ZoomChangedEvent extends BasePluginEvent<PluginEventType.ZoomChanged> {
+interface ZoomChangedEvent extends ZoomChangedEventData, BasePluginEvent<PluginEventType.ZoomChanged> {
+}
+
+    /**
+ * Data of ZoomChangedEvent
+ */
+interface ZoomChangedEventData {
     /**
      * Zoom scale value before this change
      */
@@ -4509,6 +4764,14 @@ interface ZoomChangedEvent extends BasePluginEvent<PluginEventType.ZoomChanged>
     newZoomScale: number;
 }
 
+    /**
+ * Represents an event object triggered from Editor.setZoomScale() API.
+ * Plugins can handle this event when they need to do something for zoom changing.
+ *
+ */
+interface CompatibleZoomChangedEvent extends ZoomChangedEventData, BasePluginEvent<CompatiblePluginEventType.ZoomChanged> {
+}
+
     /**
  * This refers to a "content block" in editor that serves as a content parsing boundary
  * It is most those html block like tags, i.e. &lt;p&gt;, &lt;div&gt;, &lt;li&gt;, &lt;td&gt; etc.
@@ -4621,6 +4884,16 @@ interface CustomData {
     disposer?: (value: any) => void;
 }
 
+    /**
+ * Property that is going to store additional data related to the Content Changed Event
+ */
+interface ContentChangedData {
+    /**
+     * Optional property to store the format api name when using ChangeSource.Format
+     */
+    formatApiName?: string;
+}
+
     /**
  * Default format settings
  */
@@ -5832,8 +6105,9 @@ interface IEditor {
      * @param changeSource The change source to use when fire ContentChangedEvent. When the value is not null,
      * a ContentChangedEvent will be fired with change source equal to this value
      * @param canUndoByBackspace True if this action can be undone when user presses Backspace key (aka Auto Complete).
+     * @param additionalData Optional parameter to provide additional data related to the ContentChanged Event.
      */
-    addUndoSnapshot(callback?: (start: NodePosition, end: NodePosition) => any, changeSource?: ChangeSource | CompatibleChangeSource | string, canUndoByBackspace?: boolean): void;
+    addUndoSnapshot(callback?: (start: NodePosition, end: NodePosition) => any, changeSource?: ChangeSource | CompatibleChangeSource | string, canUndoByBackspace?: boolean, additionalData?: ContentChangedData): void;
     /**
      * Whether there is an available undo/redo snapshot
      */
@@ -6215,8 +6489,9 @@ interface EditorCore extends PluginState  {
  * @param callback The editing callback, accepting current selection start and end position, returns an optional object used as the data field of ContentChangedEvent.
  * @param changeSource The ChangeSource string of ContentChangedEvent. @default ChangeSource.Format. Set to null to avoid triggering ContentChangedEvent
  * @param canUndoByBackspace True if this action can be undone when user press Backspace key (aka Auto Complete).
+ * @param additionalData Optional parameter to provide additional data related to the ContentChanged Event.
  */
-type AddUndoSnapshot = (core: EditorCore, callback: (start: NodePosition, end: NodePosition) => any, changeSource: ChangeSource | CompatibleChangeSource | string, canUndoByBackspace: boolean) => void;
+type AddUndoSnapshot = (core: EditorCore, callback: (start: NodePosition, end: NodePosition) => any, changeSource: ChangeSource | CompatibleChangeSource | string, canUndoByBackspace: boolean, additionalData?: ContentChangedData) => void;
 
     /**
  * Attach a DOM event to the editor content DIV
@@ -6726,6 +7001,16 @@ interface ListFeatureSettings {
      * When delete key is pressed before the first item, indent the correct list of numbers
      */
     maintainListChainWhenDelete: boolean;
+    /**
+     * When press space after *, -, --, ->, -->, >, =>  in an empty line, toggle bullet
+     * @default true
+     */
+    autoBulletList: boolean;
+    /**
+     * When press space after an number, a letter or roman number followed by ), ., -, or between parenthesis in an empty line, toggle numbering
+     * @default true
+     */
+    autoNumberingList: boolean;
 }
 
     /**
@@ -6833,6 +7118,7 @@ interface TextFeatureSettings {
      */
     outdentWhenTabText: boolean;
     /**
+     * @deprecated
      * Requires @see ExperimentalFeatures.AutoHyphen to be enabled
      * Automatically transform -- into hyphen, if typed between two words.
      */
@@ -7036,7 +7322,7 @@ interface ImageEditOptions {
      * Color of resize/rotate border, handle and icon
      * @default #DB626C
      */
-    borderColor?: string;
+    borderColor?: string | ModeIndependentColor;
     /**
      * Minimum resize/crop width
      * @default 10
@@ -7425,6 +7711,7 @@ enum CompatibleExperimentalFeatures {
      */
     AutoFormatList = "AutoFormatList",
     /**
+     * @deprecated this feature is always disabled
      * Automatically transform -- into hyphen, if typed between two words.
      */
     AutoHyphen = "AutoHyphen"
@@ -7890,30 +8177,42 @@ enum CompatibleAlignment {
  *  Enum used to control the different types of bullet list
  */
 enum CompatibleBulletListType {
+    /**
+     * Minimum value of the enum
+     */
+    Min = 1,
     /**
      * Bullet triggered by *
      */
-    Disc = 0,
+    Disc = 1,
     /**
      * Bullet triggered by -
      */
-    Dash = 1,
+    Dash = 2,
     /**
      * Bullet triggered by --
      */
-    Square = 2,
+    Square = 3,
     /**
      * Bullet triggered by >
      */
-    ShortArrow = 3,
+    ShortArrow = 4,
     /**
      * Bullet triggered by -> or -->
      */
-    LongArrow = 4,
+    LongArrow = 5,
     /**
      * Bullet triggered by =>
      */
-    UnfilledArrow = 5
+    UnfilledArrow = 6,
+    /**
+     * Bullet triggered by —
+     */
+    Hyphen = 7,
+    /**
+     * Maximum value of the enum
+     */
+    Max = 7
 }
 
     /**
@@ -8524,86 +8823,94 @@ enum CompatibleNodeType {
  *  Enum used to control the different types of numbering list
  */
 enum CompatibleNumberingListType {
+    /**
+     * Minimum value of the enum
+     */
+    Min = 1,
     /**
      * Numbering triggered by 1.
      */
-    Decimal = 0,
+    Decimal = 1,
     /**
      * Numbering triggered by 1-
      */
-    DecimalDash = 1,
+    DecimalDash = 2,
     /**
      * Numbering triggered by 1)
      */
-    DecimalParenthesis = 2,
+    DecimalParenthesis = 3,
     /**
      * Numbering triggered by (1)
      */
-    DecimalDoubleParenthesis = 3,
+    DecimalDoubleParenthesis = 4,
     /**
      * Numbering triggered by a.
      */
-    LowerAlpha = 4,
+    LowerAlpha = 5,
     /**
      * Numbering triggered by a)
      */
-    LowerAlphaParenthesis = 5,
+    LowerAlphaParenthesis = 6,
     /**
      * Numbering triggered by (a)
      */
-    LowerAlphaDoubleParenthesis = 6,
+    LowerAlphaDoubleParenthesis = 7,
     /**
      * Numbering triggered by a-
      */
-    LowerAlphaDash = 7,
+    LowerAlphaDash = 8,
     /**
      * Numbering triggered by A.
      */
-    UpperAlpha = 8,
+    UpperAlpha = 9,
     /**
      * Numbering triggered by A)
      */
-    UpperAlphaParenthesis = 9,
+    UpperAlphaParenthesis = 10,
     /**
      * Numbering triggered by (A)
      */
-    UpperAlphaDoubleParenthesis = 10,
+    UpperAlphaDoubleParenthesis = 11,
     /**
      * Numbering triggered by A-
      */
-    UpperAlphaDash = 11,
+    UpperAlphaDash = 12,
     /**
      * Numbering triggered by i.
      */
-    LowerRoman = 12,
+    LowerRoman = 13,
     /**
      * Numbering triggered by i)
      */
-    LowerRomanParenthesis = 13,
+    LowerRomanParenthesis = 14,
     /**
      * Numbering triggered by (i)
      */
-    LowerRomanDoubleParenthesis = 14,
+    LowerRomanDoubleParenthesis = 15,
     /**
      * Numbering triggered by i-
      */
-    LowerRomanDash = 15,
+    LowerRomanDash = 16,
     /**
      * Numbering triggered by I.
      */
-    UpperRoman = 16,
+    UpperRoman = 17,
     /**
      * Numbering triggered by I)
      */
-    UpperRomanParenthesis = 17,
+    UpperRomanParenthesis = 18,
     /**
      * Numbering triggered by (I)
      */
-    UpperRomanDoubleParenthesis = 18,
+    UpperRomanDoubleParenthesis = 19,
     /**
      * Numbering triggered by I-
      */
-    UpperRomanDash = 19
+    UpperRomanDash = 20,
+    /**
+     * Maximum value of the enum
+     */
+    Max = 20
 }
 
     /**
@@ -9174,8 +9481,6 @@ class Paste implements EditorPlugin  {
  * - Apply selected item in picker
  *
  * PickerPlugin doesn't provide any UI, it just wraps related DOM events and invoke callback functions.
- * To show a picker UI, you need to build your own UI component. Please reference to
- * https://github.com/microsoft/roosterjs/tree/master/demo/scripts/controls/samplepicker
  */
 class PickerPlugin<T extends PickerDataProvider = PickerDataProvider> implements EditorPlugin  {
     readonly dataProvider: T;
@@ -9388,4 +9693,30 @@ class TableCellSelection implements EditorPlugin  {
     selectTable(): void;
 }
 
+    /**
+ * Automatically transform -- into hyphen, if typed between two words.
+ */
+class AutoFormat implements EditorPlugin  {
+    private editor;
+    private lastKeyTyped;
+    /**
+     * Get a friendly name of this plugin
+     */
+    getName(): string;
+    /**
+     * Initialize this plugin
+     * @param editor The editor instance
+     */
+    initialize(editor: IEditor): void;
+    /**
+     * Dispose this plugin
+     */
+    dispose(): void;
+    /**
+     * Handle events triggered from editor
+     * @param event PluginEvent object
+     */
+    onPluginEvent(event: PluginEvent): void;
+}
+
 }