roosterjs-content-model-types 0.21.2 → 0.22.0

package/lib/editor/IStandaloneEditor.d.ts

@@ -1,3 +1,6 @@
+import type { DOMEventRecord } from '../parameter/DOMEventRecord';
+import type { SnapshotsManager } from '../parameter/SnapshotsManager';
+import type { Snapshot } from '../parameter/Snapshot';
 import type { CompatiblePluginEventType } from 'roosterjs-editor-types/lib/compatibleTypes';
 import type { ContentModelDocument } from '../group/ContentModelDocument';
 import type { ContentModelSegmentFormat } from '../format/ContentModelSegmentFormat';
@@ -7,7 +10,7 @@ import type { EditorEnvironment } from '../parameter/EditorEnvironment';
 import type { ModelToDomOption } from '../context/ModelToDomOption';
 import type { OnNodeCreated } from '../context/ModelToDomSettings';
 import type { ContentModelFormatter, FormatWithContentModelOptions } from '../parameter/FormatWithContentModelOptions';
-import type { EditorUndoState, PluginEventData, PluginEventFromType, PluginEventType } from 'roosterjs-editor-types';
+import type { PluginEventData, PluginEventFromType, PluginEventType } from 'roosterjs-editor-types';
 /**
  * An interface of standalone Content Model editor.
  * (This interface is still under development, and may still be changed in the future with some breaking changes)
@@ -42,7 +45,7 @@ export interface IStandaloneEditor {
      * This is the replacement of IEditor.select.
      * @param selection The selection to set
      */
-    setDOMSelection(selection: DOMSelection): void;
+    setDOMSelection(selection: DOMSelection | null): void;
     /**
      * The general API to do format change with Content Model
      * It will grab a Content Model for current editor content, and invoke a callback function
@@ -81,9 +84,9 @@ export interface IStandaloneEditor {
      */
     triggerPluginEvent<T extends PluginEventType | CompatiblePluginEventType>(eventType: T, data: PluginEventData<T>, broadcast?: boolean): PluginEventFromType<T>;
     /**
-     * Whether there is an available undo/redo snapshot
+     * Get undo snapshots manager
      */
-    getUndoState(): EditorUndoState;
+    getSnapshotsManager(): SnapshotsManager;
     /**
      * Check if the editor is in dark mode
      * @returns True if the editor is in dark mode, otherwise false
@@ -96,4 +99,23 @@ export interface IStandaloneEditor {
      * @returns current zoom scale number
      */
     getZoomScale(): number;
+    /**
+     * Add a single undo snapshot to undo stack
+     */
+    takeSnapshot(): void;
+    /**
+     * Restore an undo snapshot into editor
+     * @param snapshot The snapshot to restore
+     */
+    restoreSnapshot(snapshot: Snapshot): void;
+    /**
+     * Check if editor is in IME input sequence
+     * @returns True if editor is in IME input sequence, otherwise false
+     */
+    isInIME(): boolean;
+    /**
+     * Attach a DOM event to the editor content DIV
+     * @param eventMap A map from event name to its handler
+     */
+    attachDomEvent(eventMap: Record<string, DOMEventRecord>): () => void;
 }

package/lib/editor/IStandaloneEditor.js.map

@@ -1 +1 @@
-{"version":3,"file":"IStandaloneEditor.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/editor/IStandaloneEditor.ts"],"names":[],"mappings":"","sourcesContent":["import type { CompatiblePluginEventType } from 'roosterjs-editor-types/lib/compatibleTypes';\nimport type { ContentModelDocument } from '../group/ContentModelDocument';\nimport type { ContentModelSegmentFormat } from '../format/ContentModelSegmentFormat';\nimport type { DOMSelection } from '../selection/DOMSelection';\nimport type { DomToModelOption } from '../context/DomToModelOption';\nimport type { EditorEnvironment } from '../parameter/EditorEnvironment';\nimport type { ModelToDomOption } from '../context/ModelToDomOption';\nimport type { OnNodeCreated } from '../context/ModelToDomSettings';\nimport type {\n    ContentModelFormatter,\n    FormatWithContentModelOptions,\n} from '../parameter/FormatWithContentModelOptions';\nimport type {\n    EditorUndoState,\n    PluginEventData,\n    PluginEventFromType,\n    PluginEventType,\n} from 'roosterjs-editor-types';\n\n/**\n * An interface of standalone Content Model editor.\n * (This interface is still under development, and may still be changed in the future with some breaking changes)\n */\nexport interface IStandaloneEditor {\n    /**\n     * Create Content Model from DOM tree in this editor\n     * @param rootNode Optional start node. If provided, Content Model will be created from this node (including itself),\n     * otherwise it will create Content Model for the whole content in editor.\n     * @param option The options to customize the behavior of DOM to Content Model conversion\n     * @param selectionOverride When specified, use this selection to override existing selection inside editor\n     */\n    createContentModel(\n        option?: DomToModelOption,\n        selectionOverride?: DOMSelection\n    ): ContentModelDocument;\n\n    /**\n     * Set content with content model\n     * @param model The content model to set\n     * @param option Additional options to customize the behavior of Content Model to DOM conversion\n     * @param onNodeCreated An optional callback that will be called when a DOM node is created\n     */\n    setContentModel(\n        model: ContentModelDocument,\n        option?: ModelToDomOption,\n        onNodeCreated?: OnNodeCreated\n    ): DOMSelection | null;\n\n    /**\n     * Get current running environment, such as if editor is running on Mac\n     */\n    getEnvironment(): EditorEnvironment;\n\n    /**\n     * Get current DOM selection.\n     * This is the replacement of IEditor.getSelectionRangeEx.\n     */\n    getDOMSelection(): DOMSelection | null;\n\n    /**\n     * Set DOMSelection into editor content.\n     * This is the replacement of IEditor.select.\n     * @param selection The selection to set\n     */\n    setDOMSelection(selection: DOMSelection): void;\n\n    /**\n     * The general API to do format change with Content Model\n     * It will grab a Content Model for current editor content, and invoke a callback function\n     * to do format change. Then according to the return value, write back the modified content model into editor.\n     * If there is cached model, it will be used and updated.\n     * @param formatter Formatter function, see ContentModelFormatter\n     * @param options More options, see FormatWithContentModelOptions\n     */\n    formatContentModel(\n        formatter: ContentModelFormatter,\n        options?: FormatWithContentModelOptions\n    ): void;\n\n    /**\n     * Get pending format of editor if any, or return null\n     */\n    getPendingFormat(): ContentModelSegmentFormat | null;\n\n    //#region Editor API copied from legacy editor, will be ported to use Content Model instead\n\n    /**\n     * Get whether this editor is disposed\n     * @returns True if editor is disposed, otherwise false\n     */\n    isDisposed(): boolean;\n\n    /**\n     * Get document which contains this editor\n     * @returns The HTML document which contains this editor\n     */\n    getDocument(): Document;\n\n    /**\n     * Focus to this editor, the selection was restored to where it was before, no unexpected scroll.\n     */\n    focus(): void;\n\n    /**\n     * Trigger an event to be dispatched to all plugins\n     * @param eventType Type of the event\n     * @param data data of the event with given type, this is the rest part of PluginEvent with the given type\n     * @param broadcast indicates if the event needs to be dispatched to all plugins\n     * True means to all, false means to allow exclusive handling from one plugin unless no one wants that\n     * @returns the event object which is really passed into plugins. Some plugin may modify the event object so\n     * the result of this function provides a chance to read the modified result\n     */\n    triggerPluginEvent<T extends PluginEventType | CompatiblePluginEventType>(\n        eventType: T,\n        data: PluginEventData<T>,\n        broadcast?: boolean\n    ): PluginEventFromType<T>;\n\n    /**\n     * Whether there is an available undo/redo snapshot\n     */\n    getUndoState(): EditorUndoState;\n\n    /**\n     * Check if the editor is in dark mode\n     * @returns True if the editor is in dark mode, otherwise false\n     */\n    isDarkMode(): boolean;\n\n    /**\n     * Get current zoom scale, default value is 1\n     * When editor is put under a zoomed container, need to pass the zoom scale number using EditorOptions.zoomScale\n     * to let editor behave correctly especially for those mouse drag/drop behaviors\n     * @returns current zoom scale number\n     */\n    getZoomScale(): number;\n\n    //#endregion\n}\n"]}
+{"version":3,"file":"IStandaloneEditor.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/editor/IStandaloneEditor.ts"],"names":[],"mappings":"","sourcesContent":["import type { DOMEventRecord } from '../parameter/DOMEventRecord';\nimport type { SnapshotsManager } from '../parameter/SnapshotsManager';\nimport type { Snapshot } from '../parameter/Snapshot';\nimport type { CompatiblePluginEventType } from 'roosterjs-editor-types/lib/compatibleTypes';\nimport type { ContentModelDocument } from '../group/ContentModelDocument';\nimport type { ContentModelSegmentFormat } from '../format/ContentModelSegmentFormat';\nimport type { DOMSelection } from '../selection/DOMSelection';\nimport type { DomToModelOption } from '../context/DomToModelOption';\nimport type { EditorEnvironment } from '../parameter/EditorEnvironment';\nimport type { ModelToDomOption } from '../context/ModelToDomOption';\nimport type { OnNodeCreated } from '../context/ModelToDomSettings';\nimport type {\n    ContentModelFormatter,\n    FormatWithContentModelOptions,\n} from '../parameter/FormatWithContentModelOptions';\nimport type { PluginEventData, PluginEventFromType, PluginEventType } from 'roosterjs-editor-types';\n\n/**\n * An interface of standalone Content Model editor.\n * (This interface is still under development, and may still be changed in the future with some breaking changes)\n */\nexport interface IStandaloneEditor {\n    /**\n     * Create Content Model from DOM tree in this editor\n     * @param rootNode Optional start node. If provided, Content Model will be created from this node (including itself),\n     * otherwise it will create Content Model for the whole content in editor.\n     * @param option The options to customize the behavior of DOM to Content Model conversion\n     * @param selectionOverride When specified, use this selection to override existing selection inside editor\n     */\n    createContentModel(\n        option?: DomToModelOption,\n        selectionOverride?: DOMSelection\n    ): ContentModelDocument;\n\n    /**\n     * Set content with content model\n     * @param model The content model to set\n     * @param option Additional options to customize the behavior of Content Model to DOM conversion\n     * @param onNodeCreated An optional callback that will be called when a DOM node is created\n     */\n    setContentModel(\n        model: ContentModelDocument,\n        option?: ModelToDomOption,\n        onNodeCreated?: OnNodeCreated\n    ): DOMSelection | null;\n\n    /**\n     * Get current running environment, such as if editor is running on Mac\n     */\n    getEnvironment(): EditorEnvironment;\n\n    /**\n     * Get current DOM selection.\n     * This is the replacement of IEditor.getSelectionRangeEx.\n     */\n    getDOMSelection(): DOMSelection | null;\n\n    /**\n     * Set DOMSelection into editor content.\n     * This is the replacement of IEditor.select.\n     * @param selection The selection to set\n     */\n    setDOMSelection(selection: DOMSelection | null): void;\n\n    /**\n     * The general API to do format change with Content Model\n     * It will grab a Content Model for current editor content, and invoke a callback function\n     * to do format change. Then according to the return value, write back the modified content model into editor.\n     * If there is cached model, it will be used and updated.\n     * @param formatter Formatter function, see ContentModelFormatter\n     * @param options More options, see FormatWithContentModelOptions\n     */\n    formatContentModel(\n        formatter: ContentModelFormatter,\n        options?: FormatWithContentModelOptions\n    ): void;\n\n    /**\n     * Get pending format of editor if any, or return null\n     */\n    getPendingFormat(): ContentModelSegmentFormat | null;\n\n    //#region Editor API copied from legacy editor, will be ported to use Content Model instead\n\n    /**\n     * Get whether this editor is disposed\n     * @returns True if editor is disposed, otherwise false\n     */\n    isDisposed(): boolean;\n\n    /**\n     * Get document which contains this editor\n     * @returns The HTML document which contains this editor\n     */\n    getDocument(): Document;\n\n    /**\n     * Focus to this editor, the selection was restored to where it was before, no unexpected scroll.\n     */\n    focus(): void;\n\n    /**\n     * Trigger an event to be dispatched to all plugins\n     * @param eventType Type of the event\n     * @param data data of the event with given type, this is the rest part of PluginEvent with the given type\n     * @param broadcast indicates if the event needs to be dispatched to all plugins\n     * True means to all, false means to allow exclusive handling from one plugin unless no one wants that\n     * @returns the event object which is really passed into plugins. Some plugin may modify the event object so\n     * the result of this function provides a chance to read the modified result\n     */\n    triggerPluginEvent<T extends PluginEventType | CompatiblePluginEventType>(\n        eventType: T,\n        data: PluginEventData<T>,\n        broadcast?: boolean\n    ): PluginEventFromType<T>;\n\n    /**\n     * Get undo snapshots manager\n     */\n    getSnapshotsManager(): SnapshotsManager;\n\n    /**\n     * Check if the editor is in dark mode\n     * @returns True if the editor is in dark mode, otherwise false\n     */\n    isDarkMode(): boolean;\n\n    /**\n     * Get current zoom scale, default value is 1\n     * When editor is put under a zoomed container, need to pass the zoom scale number using EditorOptions.zoomScale\n     * to let editor behave correctly especially for those mouse drag/drop behaviors\n     * @returns current zoom scale number\n     */\n    getZoomScale(): number;\n\n    /**\n     * Add a single undo snapshot to undo stack\n     */\n    takeSnapshot(): void;\n\n    /**\n     * Restore an undo snapshot into editor\n     * @param snapshot The snapshot to restore\n     */\n    restoreSnapshot(snapshot: Snapshot): void;\n\n    /**\n     * Check if editor is in IME input sequence\n     * @returns True if editor is in IME input sequence, otherwise false\n     */\n    isInIME(): boolean;\n\n    /**\n     * Attach a DOM event to the editor content DIV\n     * @param eventMap A map from event name to its handler\n     */\n    attachDomEvent(eventMap: Record<string, DOMEventRecord>): () => void;\n\n    //#endregion\n}\n"]}

package/lib/editor/StandaloneEditorCore.d.ts

@@ -1,5 +1,8 @@
-import type { CompatibleColorTransformDirection, CompatibleGetContentMode } from 'roosterjs-editor-types/lib/compatibleTypes';
-import type { ColorTransformDirection, ContentChangedData, ContentMetadata, DOMEventHandler, DarkColorHandler, EditorPlugin, GetContentMode, ImageSelectionRange, InsertOption, NodePosition, PluginEvent, PositionType, Rect, SelectionPath, SelectionRangeEx, StyleBasedFormatState, TableSelection, TableSelectionRange, TrustedHTMLHandler } from 'roosterjs-editor-types';
+import type { DOMEventRecord } from '../parameter/DOMEventRecord';
+import type { Snapshot } from '../parameter/Snapshot';
+import type { EntityState } from '../parameter/FormatWithContentModelContext';
+import type { CompatibleGetContentMode } from 'roosterjs-editor-types/lib/compatibleTypes';
+import type { ContentMetadata, DarkColorHandler, EditorPlugin, GetContentMode, InsertOption, NodePosition, PluginEvent, Rect, StyleBasedFormatState, TrustedHTMLHandler } from 'roosterjs-editor-types';
 import type { ContentModelDocument } from '../group/ContentModelDocument';
 import type { StandaloneEditorCorePluginState, UnportedCorePluginState } from '../pluginState/StandaloneEditorPluginState';
 import type { DOMSelection } from '../selection/DOMSelection';
@@ -39,8 +42,9 @@ export declare type SetContentModel = (core: StandaloneEditorCore, model: Conten
  * Set current DOM selection from editor. This is the replacement of core API select
  * @param core The StandaloneEditorCore object
  * @param selection The selection to set
+ * @param skipSelectionChangedEvent @param Pass true to skip triggering a SelectionChangedEvent
  */
-export declare type SetDOMSelection = (core: StandaloneEditorCore, selection: DOMSelection) => void;
+export declare type SetDOMSelection = (core: StandaloneEditorCore, selection: DOMSelection | null, skipSelectionChangedEvent?: boolean) => void;
 /**
  * The general API to do format change with Content Model
  * It will grab a Content Model for current editor content, and invoke a callback function
@@ -57,17 +61,6 @@ export declare type FormatContentModel = (core: StandaloneEditorCore, formatter:
  * @param isOn True to switch On, False to switch Off
  */
 export declare type SwitchShadowEdit = (core: StandaloneEditorCore, isOn: boolean) => void;
-/**
- * TODO: Remove this Core API and use setDOMSelection instead
- * Select content according to the given information.
- * There are a bunch of allowed combination of parameters. See IEditor.select for more details
- * @param core The editor core object
- * @param arg1 A DOM Range, or SelectionRangeEx, or NodePosition, or Node, or Selection Path
- * @param arg2 (optional) A NodePosition, or an offset number, or a PositionType, or a TableSelection, or null
- * @param arg3 (optional) A Node
- * @param arg4 (optional) An offset number, or a PositionType
- */
-export declare type Select = (core: StandaloneEditorCore, arg1: Range | SelectionRangeEx | NodePosition | Node | SelectionPath | null, arg2?: NodePosition | number | PositionType | TableSelection | null, arg3?: Node, arg4?: number | PositionType) => boolean;
 /**
  * Trigger a plugin event
  * @param core The StandaloneEditorCore object
@@ -76,63 +69,19 @@ export declare type Select = (core: StandaloneEditorCore, arg1: Range | Selectio
  */
 export declare type TriggerEvent = (core: StandaloneEditorCore, pluginEvent: PluginEvent, broadcast: boolean) => void;
 /**
- * Get current selection range
- * @param core The StandaloneEditorCore object
- * @returns A Range object of the selection range
- */
-export declare type GetSelectionRangeEx = (core: StandaloneEditorCore) => SelectionRangeEx;
-/**
- * Edit and transform color of elements between light mode and dark mode
+ * Add an undo snapshot to current undo snapshot stack
  * @param core The StandaloneEditorCore object
- * @param rootNode The root HTML node to transform
- * @param includeSelf True to transform the root node as well, otherwise false
- * @param callback The callback function to invoke before do color transformation
- * @param direction To specify the transform direction, light to dark, or dark to light
- * @param forceTransform By default this function will only work when editor core is in dark mode.
- * Pass true to this value to force do color transformation even editor core is in light mode
- * @param fromDarkModel Whether the given content is already in dark mode
- */
-export declare type TransformColor = (core: StandaloneEditorCore, rootNode: Node | null, includeSelf: boolean, callback: (() => void) | null, direction: ColorTransformDirection | CompatibleColorTransformDirection, forceTransform?: boolean, fromDarkMode?: boolean) => void;
-/**
- * Call an editing callback with adding undo snapshots around, and trigger a ContentChanged event if change source is specified.
- * Undo snapshot will not be added if this call is nested inside another addUndoSnapshot() call.
- * @param core The StandaloneEditorCore object
- * @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.
+ * @param entityStates @optional Entity states related to this snapshot.
+ * Each entity state will cause an EntityOperation event with operation = EntityOperation.UpdateEntityState
+ * when undo/redo to this snapshot
  */
-export declare type AddUndoSnapshot = (core: StandaloneEditorCore, callback: ((start: NodePosition | null, end: NodePosition | null) => any) | null, changeSource: string | null, canUndoByBackspace: boolean, additionalData?: ContentChangedData) => void;
+export declare type AddUndoSnapshot = (core: StandaloneEditorCore, canUndoByBackspace: boolean, entityStates?: EntityState[]) => void;
 /**
  * Retrieves the rect of the visible viewport of the editor.
  * @param core The StandaloneEditorCore object
  */
 export declare type GetVisibleViewport = (core: StandaloneEditorCore) => Rect | null;
-/**
- * Change the editor selection to the given range
- * @param core The StandaloneEditorCore object
- * @param range The range to select
- * @param skipSameRange When set to true, do nothing if the given range is the same with current selection
- * in editor, otherwise it will always remove current selection range and set to the given one.
- * This parameter is always treated as true in Edge to avoid some weird runtime exception.
- */
-export declare type SelectRange = (core: StandaloneEditorCore, range: Range, skipSameRange?: boolean) => boolean;
-/**
- * Select a table and save data of the selected range
- * @param core The StandaloneEditorCore object
- * @param image image to select
- * @returns true if successful
- */
-export declare type SelectImage = (core: StandaloneEditorCore, image: HTMLImageElement | null) => ImageSelectionRange | null;
-/**
- * Select a table and save data of the selected range
- * @param core The StandaloneEditorCore object
- * @param table table to select
- * @param coordinates first and last cell of the selection, if this parameter is null, instead of
- * selecting, will unselect the table.
- * @returns true if successful
- */
-export declare type SelectTable = (core: StandaloneEditorCore, table: HTMLTableElement | null, coordinates?: TableSelection) => TableSelectionRange | null;
 /**
  * Set HTML content to this editor. All existing content will be replaced. A ContentChanged event will be triggered
  * if triggerContentChangedEvent is set to true
@@ -141,13 +90,6 @@ export declare type SelectTable = (core: StandaloneEditorCore, table: HTMLTableE
  * @param triggerContentChangedEvent True to trigger a ContentChanged event. Default value is true
  */
 export declare type SetContent = (core: StandaloneEditorCore, content: string, triggerContentChangedEvent: boolean, metadata?: ContentMetadata) => void;
-/**
- * Get current or cached selection range
- * @param core The StandaloneEditorCore object
- * @param tryGetFromCache Set to true to retrieve the selection range from cache if editor doesn't own the focus now
- * @returns A Range object of the selection range
- */
-export declare type GetSelectionRange = (core: StandaloneEditorCore, tryGetFromCache: boolean) => Range | null;
 /**
  * Check if the editor has focus now
  * @param core The StandaloneEditorCore object
@@ -170,7 +112,7 @@ export declare type InsertNode = (core: StandaloneEditorCore, node: Node, option
  * @param core The StandaloneEditorCore object
  * @param eventMap A map from event name to its handler
  */
-export declare type AttachDomEvent = (core: StandaloneEditorCore, eventMap: Record<string, DOMEventHandler>) => () => void;
+export declare type AttachDomEvent = (core: StandaloneEditorCore, eventMap: Record<string, DOMEventRecord>) => () => void;
 /**
  * Get current editor content as HTML string
  * @param core The StandaloneEditorCore object
@@ -189,7 +131,7 @@ export declare type GetStyleBasedFormatState = (core: StandaloneEditorCore, node
  * @param core The StandaloneEditorCore object
  * @param step Steps to move, can be 0, positive or negative
  */
-export declare type RestoreUndoSnapshot = (core: StandaloneEditorCore, step: number) => void;
+export declare type RestoreUndoSnapshot = (core: StandaloneEditorCore, snapshot: Snapshot) => void;
 /**
  * Ensure user will type into a container element rather than into the editor content DIV directly
  * @param core The StandaloneEditorCore object.
@@ -230,6 +172,7 @@ export interface PortedCoreApiMap {
      * Set current DOM selection from editor. This is the replacement of core API select
      * @param core The StandaloneEditorCore object
      * @param selection The selection to set
+     * @param skipSelectionChangedEvent @param Pass true to skip triggering a SelectionChangedEvent
      */
     setDOMSelection: SetDOMSelection;
     /**
@@ -253,84 +196,51 @@ export interface PortedCoreApiMap {
      * @param core The StandaloneEditorCore object
      */
     getVisibleViewport: GetVisibleViewport;
-}
-/**
- * Temp interface
- * TODO: Port these core API
- */
-export interface UnportedCoreApiMap {
     /**
-     * Select content according to the given information.
-     * There are a bunch of allowed combination of parameters. See IEditor.select for more details
-     * @param core The editor core object
-     * @param arg1 A DOM Range, or SelectionRangeEx, or NodePosition, or Node, or Selection Path
-     * @param arg2 (optional) A NodePosition, or an offset number, or a PositionType, or a TableSelection, or null
-     * @param arg3 (optional) A Node
-     * @param arg4 (optional) An offset number, or a PositionType
-     */
-    select: Select;
-    /**
-     * Trigger a plugin event
-     * @param core The StandaloneEditorCore object
-     * @param pluginEvent The event object to trigger
-     * @param broadcast Set to true to skip the shouldHandleEventExclusively check
-     */
-    triggerEvent: TriggerEvent;
-    /**
-     * Get current or cached selection range
+     * Check if the editor has focus now
      * @param core The StandaloneEditorCore object
-     * @param tryGetFromCache Set to true to retrieve the selection range from cache if editor doesn't own the focus now
-     * @returns A Range object of the selection range
+     * @returns True if the editor has focus, otherwise false
      */
-    getSelectionRangeEx: GetSelectionRangeEx;
+    hasFocus: HasFocus;
     /**
-     * Edit and transform color of elements between light mode and dark mode
+     * Focus to editor. If there is a cached selection range, use it as current selection
      * @param core The StandaloneEditorCore object
-     * @param rootNode The root HTML element to transform
-     * @param includeSelf True to transform the root node as well, otherwise false
-     * @param callback The callback function to invoke before do color transformation
-     * @param direction To specify the transform direction, light to dark, or dark to light
-     * @param forceTransform By default this function will only work when editor core is in dark mode.
-     * Pass true to this value to force do color transformation even editor core is in light mode
-     * @param fromDarkModel Whether the given content is already in dark mode
      */
-    transformColor: TransformColor;
+    focus: Focus;
     /**
-     * Call an editing callback with adding undo snapshots around, and trigger a ContentChanged event if change source is specified.
-     * Undo snapshot will not be added if this call is nested inside another addUndoSnapshot() call.
+     * Add an undo snapshot to current undo snapshot stack
      * @param core The StandaloneEditorCore object
-     * @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 presses Backspace key (aka Auto Complete).
+     * @param canUndoByBackspace True if this action can be undone when user press Backspace key (aka Auto Complete).
+     * @param entityStates @optional Entity states related to this snapshot.
+     * Each entity state will cause an EntityOperation event with operation = EntityOperation.UpdateEntityState
+     * when undo/redo to this snapshot
      */
     addUndoSnapshot: AddUndoSnapshot;
     /**
-     * Change the editor selection to the given range
-     * @param core The StandaloneEditorCore object
-     * @param range The range to select
-     * @param skipSameRange When set to true, do nothing if the given range is the same with current selection
-     * in editor, otherwise it will always remove current selection range and set to the given one.
-     * This parameter is always treated as true in Edge to avoid some weird runtime exception.
+     * Restore an undo snapshot into editor
+     * @param core The editor core object
+     * @param step Steps to move, can be 0, positive or negative
      */
-    selectRange: SelectRange;
+    restoreUndoSnapshot: RestoreUndoSnapshot;
     /**
-     * Select a image and save data of the selected range
+     * Attach a DOM event to the editor content DIV
      * @param core The StandaloneEditorCore object
-     * @param image image to select
-     * @param imageId the id of the image element
-     * @returns true if successful
+     * @param eventMap A map from event name to its handler
      */
-    selectImage: SelectImage;
+    attachDomEvent: AttachDomEvent;
     /**
-     * Select a table and save data of the selected range
+     * Trigger a plugin event
      * @param core The StandaloneEditorCore object
-     * @param table table to select
-     * @param coordinates first and last cell of the selection, if this parameter is null, instead of
-     * selecting, will unselect the table.
-     * @param shouldAddStyles Whether need to update the style elements
-     * @returns true if successful
+     * @param pluginEvent The event object to trigger
+     * @param broadcast Set to true to skip the shouldHandleEventExclusively check
      */
-    selectTable: SelectTable;
+    triggerEvent: TriggerEvent;
+}
+/**
+ * Temp interface
+ * TODO: Port these core API
+ */
+export interface UnportedCoreApiMap {
     /**
      * Set HTML content to this editor. All existing content will be replaced. A ContentChanged event will be triggered
      * if triggerContentChangedEvent is set to true
@@ -339,38 +249,12 @@ export interface UnportedCoreApiMap {
      * @param triggerContentChangedEvent True to trigger a ContentChanged event. Default value is true
      */
     setContent: SetContent;
-    /**
-     * Get current or cached selection range
-     * @param core The StandaloneEditorCore object
-     * @param tryGetFromCache Set to true to retrieve the selection range from cache if editor doesn't own the focus now
-     * @returns A Range object of the selection range
-     */
-    getSelectionRange: GetSelectionRange;
-    /**
-     * Check if the editor has focus now
-     * @param core The StandaloneEditorCore object
-     * @returns True if the editor has focus, otherwise false
-     */
-    hasFocus: HasFocus;
-    /**
-     * Focus to editor. If there is a cached selection range, use it as current selection
-     * @param core The StandaloneEditorCore object
-     */
-    focus: Focus;
     /**
      * Insert a DOM node into editor content
      * @param core The StandaloneEditorCore object. No op if null.
      * @param option An insert option object to specify how to insert the node
      */
     insertNode: InsertNode;
-    /**
-     * Attach a DOM event to the editor content DIV
-     * @param core The StandaloneEditorCore object
-     * @param eventName The DOM event name
-     * @param pluginEventType Optional event type. When specified, editor will trigger a plugin event with this name when the DOM event is triggered
-     * @param beforeDispatch Optional callback function to be invoked when the DOM event is triggered before trigger plugin event
-     */
-    attachDomEvent: AttachDomEvent;
     /**
      * Get current editor content as HTML string
      * @param core The StandaloneEditorCore object
@@ -384,12 +268,6 @@ export interface UnportedCoreApiMap {
      * @param node The node to get style from
      */
     getStyleBasedFormatState: GetStyleBasedFormatState;
-    /**
-     * Restore an undo snapshot into editor
-     * @param core The editor core object
-     * @param step Steps to move, can be 0, positive or negative
-     */
-    restoreUndoSnapshot: RestoreUndoSnapshot;
     /**
      * Ensure user will type into a container element rather than into the editor content DIV directly
      * @param core The EditorCore object.

package/lib/editor/StandaloneEditorCore.js.map

@@ -1 +1 @@
-{"version":3,"file":"StandaloneEditorCore.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/editor/StandaloneEditorCore.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n    CompatibleColorTransformDirection,\n    CompatibleGetContentMode,\n} from 'roosterjs-editor-types/lib/compatibleTypes';\nimport type {\n    ColorTransformDirection,\n    ContentChangedData,\n    ContentMetadata,\n    DOMEventHandler,\n    DarkColorHandler,\n    EditorPlugin,\n    GetContentMode,\n    ImageSelectionRange,\n    InsertOption,\n    NodePosition,\n    PluginEvent,\n    PositionType,\n    Rect,\n    SelectionPath,\n    SelectionRangeEx,\n    StyleBasedFormatState,\n    TableSelection,\n    TableSelectionRange,\n    TrustedHTMLHandler,\n} from 'roosterjs-editor-types';\nimport type { ContentModelDocument } from '../group/ContentModelDocument';\nimport type {\n    StandaloneEditorCorePluginState,\n    UnportedCorePluginState,\n} from '../pluginState/StandaloneEditorPluginState';\nimport type { DOMSelection } from '../selection/DOMSelection';\nimport type { DomToModelOption } from '../context/DomToModelOption';\nimport type { DomToModelSettings } from '../context/DomToModelSettings';\nimport type { EditorContext } from '../context/EditorContext';\nimport type { EditorEnvironment } from '../parameter/EditorEnvironment';\nimport type { ModelToDomOption } from '../context/ModelToDomOption';\nimport type { ModelToDomSettings, OnNodeCreated } from '../context/ModelToDomSettings';\nimport type {\n    ContentModelFormatter,\n    FormatWithContentModelOptions,\n} from '../parameter/FormatWithContentModelOptions';\n\n/**\n * Create a EditorContext object used by ContentModel API\n * @param core The StandaloneEditorCore object\n */\nexport type CreateEditorContext = (core: StandaloneEditorCore) => EditorContext;\n\n/**\n * Create Content Model from DOM tree in this editor\n * @param core The StandaloneEditorCore object\n * @param option The option to customize the behavior of DOM to Content Model conversion\n * @param selectionOverride When passed, use this selection range instead of current selection in editor\n */\nexport type CreateContentModel = (\n    core: StandaloneEditorCore,\n    option?: DomToModelOption,\n    selectionOverride?: DOMSelection\n) => ContentModelDocument;\n\n/**\n * Get current DOM selection from editor\n * @param core The StandaloneEditorCore object\n */\nexport type GetDOMSelection = (core: StandaloneEditorCore) => DOMSelection | null;\n\n/**\n * Set content with content model. This is the replacement of core API getSelectionRangeEx\n * @param core The StandaloneEditorCore object\n * @param model The content model to set\n * @param option Additional options to customize the behavior of Content Model to DOM conversion\n * @param onNodeCreated An optional callback that will be called when a DOM node is created\n */\nexport type SetContentModel = (\n    core: StandaloneEditorCore,\n    model: ContentModelDocument,\n    option?: ModelToDomOption,\n    onNodeCreated?: OnNodeCreated\n) => DOMSelection | null;\n\n/**\n * Set current DOM selection from editor. This is the replacement of core API select\n * @param core The StandaloneEditorCore object\n * @param selection The selection to set\n */\nexport type SetDOMSelection = (core: StandaloneEditorCore, selection: DOMSelection) => void;\n\n/**\n * The general API to do format change with Content Model\n * It will grab a Content Model for current editor content, and invoke a callback function\n * to do format change. Then according to the return value, write back the modified content model into editor.\n * If there is cached model, it will be used and updated.\n * @param core The StandaloneEditorCore object\n * @param formatter Formatter function, see ContentModelFormatter\n * @param options More options, see FormatWithContentModelOptions\n */\nexport type FormatContentModel = (\n    core: StandaloneEditorCore,\n    formatter: ContentModelFormatter,\n    options?: FormatWithContentModelOptions\n) => void;\n\n/**\n * Switch the Shadow Edit mode of editor On/Off\n * @param core The StandaloneEditorCore object\n * @param isOn True to switch On, False to switch Off\n */\nexport type SwitchShadowEdit = (core: StandaloneEditorCore, isOn: boolean) => void;\n\n/**\n * TODO: Remove this Core API and use setDOMSelection instead\n * Select content according to the given information.\n * There are a bunch of allowed combination of parameters. See IEditor.select for more details\n * @param core The editor core object\n * @param arg1 A DOM Range, or SelectionRangeEx, or NodePosition, or Node, or Selection Path\n * @param arg2 (optional) A NodePosition, or an offset number, or a PositionType, or a TableSelection, or null\n * @param arg3 (optional) A Node\n * @param arg4 (optional) An offset number, or a PositionType\n */\nexport type Select = (\n    core: StandaloneEditorCore,\n    arg1: Range | SelectionRangeEx | NodePosition | Node | SelectionPath | null,\n    arg2?: NodePosition | number | PositionType | TableSelection | null,\n    arg3?: Node,\n    arg4?: number | PositionType\n) => boolean;\n\n/**\n * Trigger a plugin event\n * @param core The StandaloneEditorCore object\n * @param pluginEvent The event object to trigger\n * @param broadcast Set to true to skip the shouldHandleEventExclusively check\n */\nexport type TriggerEvent = (\n    core: StandaloneEditorCore,\n    pluginEvent: PluginEvent,\n    broadcast: boolean\n) => void;\n\n/**\n * Get current selection range\n * @param core The StandaloneEditorCore object\n * @returns A Range object of the selection range\n */\nexport type GetSelectionRangeEx = (core: StandaloneEditorCore) => SelectionRangeEx;\n\n/**\n * Edit and transform color of elements between light mode and dark mode\n * @param core The StandaloneEditorCore object\n * @param rootNode The root HTML node to transform\n * @param includeSelf True to transform the root node as well, otherwise false\n * @param callback The callback function to invoke before do color transformation\n * @param direction To specify the transform direction, light to dark, or dark to light\n * @param forceTransform By default this function will only work when editor core is in dark mode.\n * Pass true to this value to force do color transformation even editor core is in light mode\n * @param fromDarkModel Whether the given content is already in dark mode\n */\nexport type TransformColor = (\n    core: StandaloneEditorCore,\n    rootNode: Node | null,\n    includeSelf: boolean,\n    callback: (() => void) | null,\n    direction: ColorTransformDirection | CompatibleColorTransformDirection,\n    forceTransform?: boolean,\n    fromDarkMode?: boolean\n) => void;\n\n/**\n * Call an editing callback with adding undo snapshots around, and trigger a ContentChanged event if change source is specified.\n * Undo snapshot will not be added if this call is nested inside another addUndoSnapshot() call.\n * @param core The StandaloneEditorCore object\n * @param callback The editing callback, accepting current selection start and end position, returns an optional object used as the data field of ContentChangedEvent.\n * @param changeSource The ChangeSource string of ContentChangedEvent. @default ChangeSource.Format. Set to null to avoid triggering ContentChangedEvent\n * @param canUndoByBackspace True if this action can be undone when user press Backspace key (aka Auto Complete).\n * @param additionalData Optional parameter to provide additional data related to the ContentChanged Event.\n */\nexport type AddUndoSnapshot = (\n    core: StandaloneEditorCore,\n    callback: ((start: NodePosition | null, end: NodePosition | null) => any) | null,\n    changeSource: string | null,\n    canUndoByBackspace: boolean,\n    additionalData?: ContentChangedData\n) => void;\n\n/**\n * Retrieves the rect of the visible viewport of the editor.\n * @param core The StandaloneEditorCore object\n */\nexport type GetVisibleViewport = (core: StandaloneEditorCore) => Rect | null;\n\n/**\n * Change the editor selection to the given range\n * @param core The StandaloneEditorCore object\n * @param range The range to select\n * @param skipSameRange When set to true, do nothing if the given range is the same with current selection\n * in editor, otherwise it will always remove current selection range and set to the given one.\n * This parameter is always treated as true in Edge to avoid some weird runtime exception.\n */\nexport type SelectRange = (\n    core: StandaloneEditorCore,\n    range: Range,\n    skipSameRange?: boolean\n) => boolean;\n\n/**\n * Select a table and save data of the selected range\n * @param core The StandaloneEditorCore object\n * @param image image to select\n * @returns true if successful\n */\nexport type SelectImage = (\n    core: StandaloneEditorCore,\n    image: HTMLImageElement | null\n) => ImageSelectionRange | null;\n\n/**\n * Select a table and save data of the selected range\n * @param core The StandaloneEditorCore object\n * @param table table to select\n * @param coordinates first and last cell of the selection, if this parameter is null, instead of\n * selecting, will unselect the table.\n * @returns true if successful\n */\nexport type SelectTable = (\n    core: StandaloneEditorCore,\n    table: HTMLTableElement | null,\n    coordinates?: TableSelection\n) => TableSelectionRange | null;\n\n/**\n * Set HTML content to this editor. All existing content will be replaced. A ContentChanged event will be triggered\n * if triggerContentChangedEvent is set to true\n * @param core The StandaloneEditorCore object\n * @param content HTML content to set in\n * @param triggerContentChangedEvent True to trigger a ContentChanged event. Default value is true\n */\nexport type SetContent = (\n    core: StandaloneEditorCore,\n    content: string,\n    triggerContentChangedEvent: boolean,\n    metadata?: ContentMetadata\n) => void;\n\n/**\n * Get current or cached selection range\n * @param core The StandaloneEditorCore object\n * @param tryGetFromCache Set to true to retrieve the selection range from cache if editor doesn't own the focus now\n * @returns A Range object of the selection range\n */\nexport type GetSelectionRange = (\n    core: StandaloneEditorCore,\n    tryGetFromCache: boolean\n) => Range | null;\n\n/**\n * Check if the editor has focus now\n * @param core The StandaloneEditorCore object\n * @returns True if the editor has focus, otherwise false\n */\nexport type HasFocus = (core: StandaloneEditorCore) => boolean;\n\n/**\n * Focus to editor. If there is a cached selection range, use it as current selection\n * @param core The StandaloneEditorCore object\n */\nexport type Focus = (core: StandaloneEditorCore) => void;\n\n/**\n * Insert a DOM node into editor content\n * @param core The StandaloneEditorCore object. No op if null.\n * @param option An insert option object to specify how to insert the node\n */\nexport type InsertNode = (\n    core: StandaloneEditorCore,\n    node: Node,\n    option: InsertOption | null\n) => boolean;\n\n/**\n * Attach a DOM event to the editor content DIV\n * @param core The StandaloneEditorCore object\n * @param eventMap A map from event name to its handler\n */\nexport type AttachDomEvent = (\n    core: StandaloneEditorCore,\n    eventMap: Record<string, DOMEventHandler>\n) => () => void;\n\n/**\n * Get current editor content as HTML string\n * @param core The StandaloneEditorCore object\n * @param mode specify what kind of HTML content to retrieve\n * @returns HTML string representing current editor content\n */\nexport type GetContent = (\n    core: StandaloneEditorCore,\n    mode: GetContentMode | CompatibleGetContentMode\n) => string;\n\n/**\n * Get style based format state from current selection, including font name/size and colors\n * @param core The StandaloneEditorCore objects\n * @param node The node to get style from\n */\nexport type GetStyleBasedFormatState = (\n    core: StandaloneEditorCore,\n    node: Node | null\n) => StyleBasedFormatState;\n\n/**\n * Restore an undo snapshot into editor\n * @param core The StandaloneEditorCore object\n * @param step Steps to move, can be 0, positive or negative\n */\nexport type RestoreUndoSnapshot = (core: StandaloneEditorCore, step: number) => void;\n\n/**\n * Ensure user will type into a container element rather than into the editor content DIV directly\n * @param core The StandaloneEditorCore object.\n * @param position The position that user is about to type to\n * @param keyboardEvent Optional keyboard event object\n * @param deprecated Deprecated parameter, not used\n */\nexport type EnsureTypeInContainer = (\n    core: StandaloneEditorCore,\n    position: NodePosition,\n    keyboardEvent?: KeyboardEvent,\n    deprecated?: boolean\n) => void;\n\n/**\n * Temp interface\n * TODO: Port other core API\n */\nexport interface PortedCoreApiMap {\n    /**\n     * Create a EditorContext object used by ContentModel API\n     * @param core The StandaloneEditorCore object\n     */\n    createEditorContext: CreateEditorContext;\n\n    /**\n     * Create Content Model from DOM tree in this editor\n     * @param core The StandaloneEditorCore object\n     * @param option The option to customize the behavior of DOM to Content Model conversion\n     */\n    createContentModel: CreateContentModel;\n\n    /**\n     * Get current DOM selection from editor\n     * @param core The StandaloneEditorCore object\n     */\n    getDOMSelection: GetDOMSelection;\n\n    /**\n     * Set content with content model\n     * @param core The StandaloneEditorCore object\n     * @param model The content model to set\n     * @param option Additional options to customize the behavior of Content Model to DOM conversion\n     */\n    setContentModel: SetContentModel;\n\n    /**\n     * Set current DOM selection from editor. This is the replacement of core API select\n     * @param core The StandaloneEditorCore object\n     * @param selection The selection to set\n     */\n    setDOMSelection: SetDOMSelection;\n\n    /**\n     * The general API to do format change with Content Model\n     * It will grab a Content Model for current editor content, and invoke a callback function\n     * to do format change. Then according to the return value, write back the modified content model into editor.\n     * If there is cached model, it will be used and updated.\n     * @param core The StandaloneEditorCore object\n     * @param formatter Formatter function, see ContentModelFormatter\n     * @param options More options, see FormatWithContentModelOptions\n     */\n    formatContentModel: FormatContentModel;\n\n    /**\n     * Switch the Shadow Edit mode of editor On/Off\n     * @param core The StandaloneEditorCore object\n     * @param isOn True to switch On, False to switch Off\n     */\n    switchShadowEdit: SwitchShadowEdit;\n\n    /**\n     * Retrieves the rect of the visible viewport of the editor.\n     * @param core The StandaloneEditorCore object\n     */\n    getVisibleViewport: GetVisibleViewport;\n}\n\n/**\n * Temp interface\n * TODO: Port these core API\n */\nexport interface UnportedCoreApiMap {\n    /**\n     * Select content according to the given information.\n     * There are a bunch of allowed combination of parameters. See IEditor.select for more details\n     * @param core The editor core object\n     * @param arg1 A DOM Range, or SelectionRangeEx, or NodePosition, or Node, or Selection Path\n     * @param arg2 (optional) A NodePosition, or an offset number, or a PositionType, or a TableSelection, or null\n     * @param arg3 (optional) A Node\n     * @param arg4 (optional) An offset number, or a PositionType\n     */\n    select: Select;\n\n    /**\n     * Trigger a plugin event\n     * @param core The StandaloneEditorCore object\n     * @param pluginEvent The event object to trigger\n     * @param broadcast Set to true to skip the shouldHandleEventExclusively check\n     */\n    triggerEvent: TriggerEvent;\n\n    /**\n     * Get current or cached selection range\n     * @param core The StandaloneEditorCore object\n     * @param tryGetFromCache Set to true to retrieve the selection range from cache if editor doesn't own the focus now\n     * @returns A Range object of the selection range\n     */\n    getSelectionRangeEx: GetSelectionRangeEx;\n\n    /**\n     * Edit and transform color of elements between light mode and dark mode\n     * @param core The StandaloneEditorCore object\n     * @param rootNode The root HTML element to transform\n     * @param includeSelf True to transform the root node as well, otherwise false\n     * @param callback The callback function to invoke before do color transformation\n     * @param direction To specify the transform direction, light to dark, or dark to light\n     * @param forceTransform By default this function will only work when editor core is in dark mode.\n     * Pass true to this value to force do color transformation even editor core is in light mode\n     * @param fromDarkModel Whether the given content is already in dark mode\n     */\n    transformColor: TransformColor;\n\n    /**\n     * Call an editing callback with adding undo snapshots around, and trigger a ContentChanged event if change source is specified.\n     * Undo snapshot will not be added if this call is nested inside another addUndoSnapshot() call.\n     * @param core The StandaloneEditorCore object\n     * @param callback The editing callback, accepting current selection start and end position, returns an optional object used as the data field of ContentChangedEvent.\n     * @param changeSource The ChangeSource string of ContentChangedEvent. @default ChangeSource.Format. Set to null to avoid triggering ContentChangedEvent\n     * @param canUndoByBackspace True if this action can be undone when user presses Backspace key (aka Auto Complete).\n     */\n    addUndoSnapshot: AddUndoSnapshot;\n\n    /**\n     * Change the editor selection to the given range\n     * @param core The StandaloneEditorCore object\n     * @param range The range to select\n     * @param skipSameRange When set to true, do nothing if the given range is the same with current selection\n     * in editor, otherwise it will always remove current selection range and set to the given one.\n     * This parameter is always treated as true in Edge to avoid some weird runtime exception.\n     */\n    selectRange: SelectRange;\n\n    /**\n     * Select a image and save data of the selected range\n     * @param core The StandaloneEditorCore object\n     * @param image image to select\n     * @param imageId the id of the image element\n     * @returns true if successful\n     */\n    selectImage: SelectImage;\n\n    /**\n     * Select a table and save data of the selected range\n     * @param core The StandaloneEditorCore object\n     * @param table table to select\n     * @param coordinates first and last cell of the selection, if this parameter is null, instead of\n     * selecting, will unselect the table.\n     * @param shouldAddStyles Whether need to update the style elements\n     * @returns true if successful\n     */\n    selectTable: SelectTable;\n\n    /**\n     * Set HTML content to this editor. All existing content will be replaced. A ContentChanged event will be triggered\n     * if triggerContentChangedEvent is set to true\n     * @param core The StandaloneEditorCore object\n     * @param content HTML content to set in\n     * @param triggerContentChangedEvent True to trigger a ContentChanged event. Default value is true\n     */\n    setContent: SetContent;\n\n    /**\n     * Get current or cached selection range\n     * @param core The StandaloneEditorCore object\n     * @param tryGetFromCache Set to true to retrieve the selection range from cache if editor doesn't own the focus now\n     * @returns A Range object of the selection range\n     */\n    getSelectionRange: GetSelectionRange;\n\n    /**\n     * Check if the editor has focus now\n     * @param core The StandaloneEditorCore object\n     * @returns True if the editor has focus, otherwise false\n     */\n    hasFocus: HasFocus;\n\n    /**\n     * Focus to editor. If there is a cached selection range, use it as current selection\n     * @param core The StandaloneEditorCore object\n     */\n    focus: Focus;\n\n    /**\n     * Insert a DOM node into editor content\n     * @param core The StandaloneEditorCore object. No op if null.\n     * @param option An insert option object to specify how to insert the node\n     */\n    insertNode: InsertNode;\n\n    /**\n     * Attach a DOM event to the editor content DIV\n     * @param core The StandaloneEditorCore object\n     * @param eventName The DOM event name\n     * @param pluginEventType Optional event type. When specified, editor will trigger a plugin event with this name when the DOM event is triggered\n     * @param beforeDispatch Optional callback function to be invoked when the DOM event is triggered before trigger plugin event\n     */\n    attachDomEvent: AttachDomEvent;\n\n    /**\n     * Get current editor content as HTML string\n     * @param core The StandaloneEditorCore object\n     * @param mode specify what kind of HTML content to retrieve\n     * @returns HTML string representing current editor content\n     */\n    getContent: GetContent;\n\n    /**\n     * Get style based format state from current selection, including font name/size and colors\n     * @param core The StandaloneEditorCore objects\n     * @param node The node to get style from\n     */\n    getStyleBasedFormatState: GetStyleBasedFormatState;\n\n    /**\n     * Restore an undo snapshot into editor\n     * @param core The editor core object\n     * @param step Steps to move, can be 0, positive or negative\n     */\n    restoreUndoSnapshot: RestoreUndoSnapshot;\n\n    /**\n     * Ensure user will type into a container element rather than into the editor content DIV directly\n     * @param core The EditorCore object.\n     * @param position The position that user is about to type to\n     * @param keyboardEvent Optional keyboard event object\n     * @param deprecated Deprecated parameter, not used\n     */\n    ensureTypeInContainer: EnsureTypeInContainer;\n}\n\n/**\n * The interface for the map of core API for Content Model editor.\n * Editor can call call API from this map under StandaloneEditorCore object\n */\nexport interface StandaloneCoreApiMap extends PortedCoreApiMap, UnportedCoreApiMap {}\n\n/**\n * Represents the core data structure of a Content Model editor\n */\nexport interface StandaloneEditorCore\n    extends StandaloneEditorCorePluginState,\n        UnportedCorePluginState,\n        StandaloneEditorDefaultSettings {\n    /**\n     * The content DIV element of this editor\n     */\n    readonly contentDiv: HTMLDivElement;\n\n    /**\n     * Core API map of this editor\n     */\n    readonly api: StandaloneCoreApiMap;\n\n    /**\n     * Original API map of this editor. Overridden core API can use API from this map to call the original version of core API.\n     */\n    readonly originalApi: StandaloneCoreApiMap;\n\n    /**\n     * An array of editor plugins.\n     */\n    readonly plugins: EditorPlugin[];\n\n    /**\n     * Editor running environment\n     */\n    readonly environment: EditorEnvironment;\n\n    /**\n     * Dark model handler for the editor, used for variable-based solution.\n     * If keep it null, editor will still use original dataset-based dark mode solution.\n     */\n    readonly darkColorHandler: DarkColorHandler;\n\n    /**\n     * A handler to convert HTML string to a trust HTML string.\n     * By default it will just return the original HTML string directly.\n     * To override, pass your own trusted HTML handler to EditorOptions.trustedHTMLHandler\n     */\n    readonly trustedHTMLHandler: TrustedHTMLHandler;\n}\n\n/**\n * Default DOM and Content Model conversion settings for an editor\n */\nexport interface StandaloneEditorDefaultSettings {\n    /**\n     * Default DOM to Content Model options\n     */\n    defaultDomToModelOptions: (DomToModelOption | undefined)[];\n\n    /**\n     * Default Content Model to DOM options\n     */\n    defaultModelToDomOptions: (ModelToDomOption | undefined)[];\n\n    /**\n     * Default DOM to Content Model config, calculated from defaultDomToModelOptions,\n     * will be used for creating content model if there is no other customized options\n     */\n    defaultDomToModelConfig: DomToModelSettings;\n\n    /**\n     * Default Content Model to DOM config, calculated from defaultModelToDomOptions,\n     * will be used for setting content model if there is no other customized options\n     */\n    defaultModelToDomConfig: ModelToDomSettings;\n}\n"]}
+{"version":3,"file":"StandaloneEditorCore.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/editor/StandaloneEditorCore.ts"],"names":[],"mappings":"","sourcesContent":["import type { DOMEventRecord } from '../parameter/DOMEventRecord';\nimport type { Snapshot } from '../parameter/Snapshot';\nimport type { EntityState } from '../parameter/FormatWithContentModelContext';\nimport type { CompatibleGetContentMode } from 'roosterjs-editor-types/lib/compatibleTypes';\nimport type {\n    ContentMetadata,\n    DarkColorHandler,\n    EditorPlugin,\n    GetContentMode,\n    InsertOption,\n    NodePosition,\n    PluginEvent,\n    Rect,\n    StyleBasedFormatState,\n    TrustedHTMLHandler,\n} from 'roosterjs-editor-types';\nimport type { ContentModelDocument } from '../group/ContentModelDocument';\nimport type {\n    StandaloneEditorCorePluginState,\n    UnportedCorePluginState,\n} from '../pluginState/StandaloneEditorPluginState';\nimport type { DOMSelection } from '../selection/DOMSelection';\nimport type { DomToModelOption } from '../context/DomToModelOption';\nimport type { DomToModelSettings } from '../context/DomToModelSettings';\nimport type { EditorContext } from '../context/EditorContext';\nimport type { EditorEnvironment } from '../parameter/EditorEnvironment';\nimport type { ModelToDomOption } from '../context/ModelToDomOption';\nimport type { ModelToDomSettings, OnNodeCreated } from '../context/ModelToDomSettings';\nimport type {\n    ContentModelFormatter,\n    FormatWithContentModelOptions,\n} from '../parameter/FormatWithContentModelOptions';\n\n/**\n * Create a EditorContext object used by ContentModel API\n * @param core The StandaloneEditorCore object\n */\nexport type CreateEditorContext = (core: StandaloneEditorCore) => EditorContext;\n\n/**\n * Create Content Model from DOM tree in this editor\n * @param core The StandaloneEditorCore object\n * @param option The option to customize the behavior of DOM to Content Model conversion\n * @param selectionOverride When passed, use this selection range instead of current selection in editor\n */\nexport type CreateContentModel = (\n    core: StandaloneEditorCore,\n    option?: DomToModelOption,\n    selectionOverride?: DOMSelection\n) => ContentModelDocument;\n\n/**\n * Get current DOM selection from editor\n * @param core The StandaloneEditorCore object\n */\nexport type GetDOMSelection = (core: StandaloneEditorCore) => DOMSelection | null;\n\n/**\n * Set content with content model. This is the replacement of core API getSelectionRangeEx\n * @param core The StandaloneEditorCore object\n * @param model The content model to set\n * @param option Additional options to customize the behavior of Content Model to DOM conversion\n * @param onNodeCreated An optional callback that will be called when a DOM node is created\n */\nexport type SetContentModel = (\n    core: StandaloneEditorCore,\n    model: ContentModelDocument,\n    option?: ModelToDomOption,\n    onNodeCreated?: OnNodeCreated\n) => DOMSelection | null;\n\n/**\n * Set current DOM selection from editor. This is the replacement of core API select\n * @param core The StandaloneEditorCore object\n * @param selection The selection to set\n * @param skipSelectionChangedEvent @param Pass true to skip triggering a SelectionChangedEvent\n */\nexport type SetDOMSelection = (\n    core: StandaloneEditorCore,\n    selection: DOMSelection | null,\n    skipSelectionChangedEvent?: boolean\n) => void;\n\n/**\n * The general API to do format change with Content Model\n * It will grab a Content Model for current editor content, and invoke a callback function\n * to do format change. Then according to the return value, write back the modified content model into editor.\n * If there is cached model, it will be used and updated.\n * @param core The StandaloneEditorCore object\n * @param formatter Formatter function, see ContentModelFormatter\n * @param options More options, see FormatWithContentModelOptions\n */\nexport type FormatContentModel = (\n    core: StandaloneEditorCore,\n    formatter: ContentModelFormatter,\n    options?: FormatWithContentModelOptions\n) => void;\n\n/**\n * Switch the Shadow Edit mode of editor On/Off\n * @param core The StandaloneEditorCore object\n * @param isOn True to switch On, False to switch Off\n */\nexport type SwitchShadowEdit = (core: StandaloneEditorCore, isOn: boolean) => void;\n\n/**\n * Trigger a plugin event\n * @param core The StandaloneEditorCore object\n * @param pluginEvent The event object to trigger\n * @param broadcast Set to true to skip the shouldHandleEventExclusively check\n */\nexport type TriggerEvent = (\n    core: StandaloneEditorCore,\n    pluginEvent: PluginEvent,\n    broadcast: boolean\n) => void;\n\n/**\n * Add an undo snapshot to current undo snapshot stack\n * @param core The StandaloneEditorCore object\n * @param canUndoByBackspace True if this action can be undone when user press Backspace key (aka Auto Complete).\n * @param entityStates @optional Entity states related to this snapshot.\n * Each entity state will cause an EntityOperation event with operation = EntityOperation.UpdateEntityState\n * when undo/redo to this snapshot\n */\nexport type AddUndoSnapshot = (\n    core: StandaloneEditorCore,\n    canUndoByBackspace: boolean,\n    entityStates?: EntityState[]\n) => void;\n\n/**\n * Retrieves the rect of the visible viewport of the editor.\n * @param core The StandaloneEditorCore object\n */\nexport type GetVisibleViewport = (core: StandaloneEditorCore) => Rect | null;\n\n/**\n * Set HTML content to this editor. All existing content will be replaced. A ContentChanged event will be triggered\n * if triggerContentChangedEvent is set to true\n * @param core The StandaloneEditorCore object\n * @param content HTML content to set in\n * @param triggerContentChangedEvent True to trigger a ContentChanged event. Default value is true\n */\nexport type SetContent = (\n    core: StandaloneEditorCore,\n    content: string,\n    triggerContentChangedEvent: boolean,\n    metadata?: ContentMetadata\n) => void;\n\n/**\n * Check if the editor has focus now\n * @param core The StandaloneEditorCore object\n * @returns True if the editor has focus, otherwise false\n */\nexport type HasFocus = (core: StandaloneEditorCore) => boolean;\n\n/**\n * Focus to editor. If there is a cached selection range, use it as current selection\n * @param core The StandaloneEditorCore object\n */\nexport type Focus = (core: StandaloneEditorCore) => void;\n\n/**\n * Insert a DOM node into editor content\n * @param core The StandaloneEditorCore object. No op if null.\n * @param option An insert option object to specify how to insert the node\n */\nexport type InsertNode = (\n    core: StandaloneEditorCore,\n    node: Node,\n    option: InsertOption | null\n) => boolean;\n\n/**\n * Attach a DOM event to the editor content DIV\n * @param core The StandaloneEditorCore object\n * @param eventMap A map from event name to its handler\n */\nexport type AttachDomEvent = (\n    core: StandaloneEditorCore,\n    eventMap: Record<string, DOMEventRecord>\n) => () => void;\n\n/**\n * Get current editor content as HTML string\n * @param core The StandaloneEditorCore object\n * @param mode specify what kind of HTML content to retrieve\n * @returns HTML string representing current editor content\n */\nexport type GetContent = (\n    core: StandaloneEditorCore,\n    mode: GetContentMode | CompatibleGetContentMode\n) => string;\n\n/**\n * Get style based format state from current selection, including font name/size and colors\n * @param core The StandaloneEditorCore objects\n * @param node The node to get style from\n */\nexport type GetStyleBasedFormatState = (\n    core: StandaloneEditorCore,\n    node: Node | null\n) => StyleBasedFormatState;\n\n/**\n * Restore an undo snapshot into editor\n * @param core The StandaloneEditorCore object\n * @param step Steps to move, can be 0, positive or negative\n */\nexport type RestoreUndoSnapshot = (core: StandaloneEditorCore, snapshot: Snapshot) => void;\n\n/**\n * Ensure user will type into a container element rather than into the editor content DIV directly\n * @param core The StandaloneEditorCore object.\n * @param position The position that user is about to type to\n * @param keyboardEvent Optional keyboard event object\n * @param deprecated Deprecated parameter, not used\n */\nexport type EnsureTypeInContainer = (\n    core: StandaloneEditorCore,\n    position: NodePosition,\n    keyboardEvent?: KeyboardEvent,\n    deprecated?: boolean\n) => void;\n\n/**\n * Temp interface\n * TODO: Port other core API\n */\nexport interface PortedCoreApiMap {\n    /**\n     * Create a EditorContext object used by ContentModel API\n     * @param core The StandaloneEditorCore object\n     */\n    createEditorContext: CreateEditorContext;\n\n    /**\n     * Create Content Model from DOM tree in this editor\n     * @param core The StandaloneEditorCore object\n     * @param option The option to customize the behavior of DOM to Content Model conversion\n     */\n    createContentModel: CreateContentModel;\n\n    /**\n     * Get current DOM selection from editor\n     * @param core The StandaloneEditorCore object\n     */\n    getDOMSelection: GetDOMSelection;\n\n    /**\n     * Set content with content model\n     * @param core The StandaloneEditorCore object\n     * @param model The content model to set\n     * @param option Additional options to customize the behavior of Content Model to DOM conversion\n     */\n    setContentModel: SetContentModel;\n\n    /**\n     * Set current DOM selection from editor. This is the replacement of core API select\n     * @param core The StandaloneEditorCore object\n     * @param selection The selection to set\n     * @param skipSelectionChangedEvent @param Pass true to skip triggering a SelectionChangedEvent\n     */\n    setDOMSelection: SetDOMSelection;\n\n    /**\n     * The general API to do format change with Content Model\n     * It will grab a Content Model for current editor content, and invoke a callback function\n     * to do format change. Then according to the return value, write back the modified content model into editor.\n     * If there is cached model, it will be used and updated.\n     * @param core The StandaloneEditorCore object\n     * @param formatter Formatter function, see ContentModelFormatter\n     * @param options More options, see FormatWithContentModelOptions\n     */\n    formatContentModel: FormatContentModel;\n\n    /**\n     * Switch the Shadow Edit mode of editor On/Off\n     * @param core The StandaloneEditorCore object\n     * @param isOn True to switch On, False to switch Off\n     */\n    switchShadowEdit: SwitchShadowEdit;\n\n    /**\n     * Retrieves the rect of the visible viewport of the editor.\n     * @param core The StandaloneEditorCore object\n     */\n    getVisibleViewport: GetVisibleViewport;\n\n    /**\n     * Check if the editor has focus now\n     * @param core The StandaloneEditorCore object\n     * @returns True if the editor has focus, otherwise false\n     */\n    hasFocus: HasFocus;\n\n    /**\n     * Focus to editor. If there is a cached selection range, use it as current selection\n     * @param core The StandaloneEditorCore object\n     */\n    focus: Focus;\n\n    /**\n     * Add an undo snapshot to current undo snapshot stack\n     * @param core The StandaloneEditorCore object\n     * @param canUndoByBackspace True if this action can be undone when user press Backspace key (aka Auto Complete).\n     * @param entityStates @optional Entity states related to this snapshot.\n     * Each entity state will cause an EntityOperation event with operation = EntityOperation.UpdateEntityState\n     * when undo/redo to this snapshot\n     */\n    addUndoSnapshot: AddUndoSnapshot;\n\n    /**\n     * Restore an undo snapshot into editor\n     * @param core The editor core object\n     * @param step Steps to move, can be 0, positive or negative\n     */\n    restoreUndoSnapshot: RestoreUndoSnapshot;\n\n    /**\n     * Attach a DOM event to the editor content DIV\n     * @param core The StandaloneEditorCore object\n     * @param eventMap A map from event name to its handler\n     */\n    attachDomEvent: AttachDomEvent;\n\n    /**\n     * Trigger a plugin event\n     * @param core The StandaloneEditorCore object\n     * @param pluginEvent The event object to trigger\n     * @param broadcast Set to true to skip the shouldHandleEventExclusively check\n     */\n    triggerEvent: TriggerEvent;\n}\n\n/**\n * Temp interface\n * TODO: Port these core API\n */\nexport interface UnportedCoreApiMap {\n    /**\n     * Set HTML content to this editor. All existing content will be replaced. A ContentChanged event will be triggered\n     * if triggerContentChangedEvent is set to true\n     * @param core The StandaloneEditorCore object\n     * @param content HTML content to set in\n     * @param triggerContentChangedEvent True to trigger a ContentChanged event. Default value is true\n     */\n    setContent: SetContent;\n\n    /**\n     * Insert a DOM node into editor content\n     * @param core The StandaloneEditorCore object. No op if null.\n     * @param option An insert option object to specify how to insert the node\n     */\n    insertNode: InsertNode;\n\n    /**\n     * Get current editor content as HTML string\n     * @param core The StandaloneEditorCore object\n     * @param mode specify what kind of HTML content to retrieve\n     * @returns HTML string representing current editor content\n     */\n    getContent: GetContent;\n\n    /**\n     * Get style based format state from current selection, including font name/size and colors\n     * @param core The StandaloneEditorCore objects\n     * @param node The node to get style from\n     */\n    getStyleBasedFormatState: GetStyleBasedFormatState;\n\n    /**\n     * Ensure user will type into a container element rather than into the editor content DIV directly\n     * @param core The EditorCore object.\n     * @param position The position that user is about to type to\n     * @param keyboardEvent Optional keyboard event object\n     * @param deprecated Deprecated parameter, not used\n     */\n    ensureTypeInContainer: EnsureTypeInContainer;\n}\n\n/**\n * The interface for the map of core API for Content Model editor.\n * Editor can call call API from this map under StandaloneEditorCore object\n */\nexport interface StandaloneCoreApiMap extends PortedCoreApiMap, UnportedCoreApiMap {}\n\n/**\n * Represents the core data structure of a Content Model editor\n */\nexport interface StandaloneEditorCore\n    extends StandaloneEditorCorePluginState,\n        UnportedCorePluginState,\n        StandaloneEditorDefaultSettings {\n    /**\n     * The content DIV element of this editor\n     */\n    readonly contentDiv: HTMLDivElement;\n\n    /**\n     * Core API map of this editor\n     */\n    readonly api: StandaloneCoreApiMap;\n\n    /**\n     * Original API map of this editor. Overridden core API can use API from this map to call the original version of core API.\n     */\n    readonly originalApi: StandaloneCoreApiMap;\n\n    /**\n     * An array of editor plugins.\n     */\n    readonly plugins: EditorPlugin[];\n\n    /**\n     * Editor running environment\n     */\n    readonly environment: EditorEnvironment;\n\n    /**\n     * Dark model handler for the editor, used for variable-based solution.\n     * If keep it null, editor will still use original dataset-based dark mode solution.\n     */\n    readonly darkColorHandler: DarkColorHandler;\n\n    /**\n     * A handler to convert HTML string to a trust HTML string.\n     * By default it will just return the original HTML string directly.\n     * To override, pass your own trusted HTML handler to EditorOptions.trustedHTMLHandler\n     */\n    readonly trustedHTMLHandler: TrustedHTMLHandler;\n}\n\n/**\n * Default DOM and Content Model conversion settings for an editor\n */\nexport interface StandaloneEditorDefaultSettings {\n    /**\n     * Default DOM to Content Model options\n     */\n    defaultDomToModelOptions: (DomToModelOption | undefined)[];\n\n    /**\n     * Default Content Model to DOM options\n     */\n    defaultModelToDomOptions: (ModelToDomOption | undefined)[];\n\n    /**\n     * Default DOM to Content Model config, calculated from defaultDomToModelOptions,\n     * will be used for creating content model if there is no other customized options\n     */\n    defaultDomToModelConfig: DomToModelSettings;\n\n    /**\n     * Default Content Model to DOM config, calculated from defaultModelToDomOptions,\n     * will be used for setting content model if there is no other customized options\n     */\n    defaultModelToDomConfig: ModelToDomSettings;\n}\n"]}

package/lib/editor/StandaloneEditorCorePlugins.d.ts

@@ -1,10 +1,12 @@
+import type { CopyPastePluginState } from '../pluginState/CopyPastePluginState';
+import type { UndoPluginState } from '../pluginState/UndoPluginState';
 import type { SelectionPluginState } from '../pluginState/SelectionPluginState';
 import type { EntityPluginState } from '../pluginState/EntityPluginState';
 import type { LifecyclePluginState } from '../pluginState/LifecyclePluginState';
 import type { DOMEventPluginState } from '../pluginState/DOMEventPluginState';
 import type { ContentModelCachePluginState } from '../pluginState/ContentModelCachePluginState';
 import type { ContentModelFormatPluginState } from '../pluginState/ContentModelFormatPluginState';
-import type { CopyPastePluginState, PluginWithState } from 'roosterjs-editor-types';
+import type { PluginWithState } from 'roosterjs-editor-types';
 /**
  * Core plugins for standalone editor
  */
@@ -33,6 +35,10 @@ export interface StandaloneEditorCorePlugins {
      * Entity Plugin handles all operations related to an entity and generate entity specified events
      */
     readonly entity: PluginWithState<EntityPluginState>;
+    /**
+     * Undo plugin provides the ability to undo/redo
+     */
+    readonly undo: PluginWithState<UndoPluginState>;
     /**
      * Lifecycle plugin handles editor initialization and disposing
      */

package/lib/editor/StandaloneEditorCorePlugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"StandaloneEditorCorePlugins.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/editor/StandaloneEditorCorePlugins.ts"],"names":[],"mappings":"","sourcesContent":["import type { SelectionPluginState } from '../pluginState/SelectionPluginState';\nimport type { EntityPluginState } from '../pluginState/EntityPluginState';\nimport type { LifecyclePluginState } from '../pluginState/LifecyclePluginState';\nimport type { DOMEventPluginState } from '../pluginState/DOMEventPluginState';\nimport type { ContentModelCachePluginState } from '../pluginState/ContentModelCachePluginState';\nimport type { ContentModelFormatPluginState } from '../pluginState/ContentModelFormatPluginState';\nimport type { CopyPastePluginState, PluginWithState } from 'roosterjs-editor-types';\n\n/**\n * Core plugins for standalone editor\n */\nexport interface StandaloneEditorCorePlugins {\n    /**\n     * ContentModel cache plugin manages cached Content Model, and refresh the cache when necessary\n     */\n    readonly cache: PluginWithState<ContentModelCachePluginState>;\n\n    /**\n     * ContentModelFormat plugins helps editor to do formatting on top of content model.\n     */\n    readonly format: PluginWithState<ContentModelFormatPluginState>;\n\n    /**\n     * Copy and paste plugin for handling onCopy and onPaste event\n     */\n    readonly copyPaste: PluginWithState<CopyPastePluginState>;\n\n    /**\n     * DomEvent plugin helps handle additional DOM events such as IME composition, cut, drop.\n     */\n    readonly domEvent: PluginWithState<DOMEventPluginState>;\n\n    /**\n     * Selection plugin handles selection, including range selection, table selection, and image selection\n     */\n    readonly selection: PluginWithState<SelectionPluginState>;\n\n    /**\n     * Entity Plugin handles all operations related to an entity and generate entity specified events\n     */\n    readonly entity: PluginWithState<EntityPluginState>;\n\n    /**\n     * Lifecycle plugin handles editor initialization and disposing\n     */\n    readonly lifecycle: PluginWithState<LifecyclePluginState>;\n}\n"]}
+{"version":3,"file":"StandaloneEditorCorePlugins.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/editor/StandaloneEditorCorePlugins.ts"],"names":[],"mappings":"","sourcesContent":["import type { CopyPastePluginState } from '../pluginState/CopyPastePluginState';\nimport type { UndoPluginState } from '../pluginState/UndoPluginState';\nimport type { SelectionPluginState } from '../pluginState/SelectionPluginState';\nimport type { EntityPluginState } from '../pluginState/EntityPluginState';\nimport type { LifecyclePluginState } from '../pluginState/LifecyclePluginState';\nimport type { DOMEventPluginState } from '../pluginState/DOMEventPluginState';\nimport type { ContentModelCachePluginState } from '../pluginState/ContentModelCachePluginState';\nimport type { ContentModelFormatPluginState } from '../pluginState/ContentModelFormatPluginState';\nimport type { PluginWithState } from 'roosterjs-editor-types';\n\n/**\n * Core plugins for standalone editor\n */\nexport interface StandaloneEditorCorePlugins {\n    /**\n     * ContentModel cache plugin manages cached Content Model, and refresh the cache when necessary\n     */\n    readonly cache: PluginWithState<ContentModelCachePluginState>;\n\n    /**\n     * ContentModelFormat plugins helps editor to do formatting on top of content model.\n     */\n    readonly format: PluginWithState<ContentModelFormatPluginState>;\n\n    /**\n     * Copy and paste plugin for handling onCopy and onPaste event\n     */\n    readonly copyPaste: PluginWithState<CopyPastePluginState>;\n\n    /**\n     * DomEvent plugin helps handle additional DOM events such as IME composition, cut, drop.\n     */\n    readonly domEvent: PluginWithState<DOMEventPluginState>;\n\n    /**\n     * Selection plugin handles selection, including range selection, table selection, and image selection\n     */\n    readonly selection: PluginWithState<SelectionPluginState>;\n\n    /**\n     * Entity Plugin handles all operations related to an entity and generate entity specified events\n     */\n    readonly entity: PluginWithState<EntityPluginState>;\n\n    /**\n     * Undo plugin provides the ability to undo/redo\n     */\n    readonly undo: PluginWithState<UndoPluginState>;\n\n    /**\n     * Lifecycle plugin handles editor initialization and disposing\n     */\n    readonly lifecycle: PluginWithState<LifecyclePluginState>;\n}\n"]}

package/lib/editor/StandaloneEditorOptions.d.ts

@@ -4,6 +4,7 @@ import type { EditorPlugin, TrustedHTMLHandler } from 'roosterjs-editor-types';
 import type { DomToModelOption } from '../context/DomToModelOption';
 import type { ModelToDomOption } from '../context/ModelToDomOption';
 import type { ContentModelDocument } from '../group/ContentModelDocument';
+import type { SnapshotsManager } from '../parameter/SnapshotsManager';
 /**
  * Options for Content Model editor
  */
@@ -75,4 +76,9 @@ export interface StandaloneEditorOptions {
      * If the editor is currently in dark mode
      */
     inDarkMode?: boolean;
+    /**
+     * Undo snapshot service based on content metadata. Use this parameter to customize the undo snapshot service.
+     * When this property is set, value of undoSnapshotService will be ignored.
+     */
+    snapshotsManager?: SnapshotsManager;
 }

package/lib/editor/StandaloneEditorOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"StandaloneEditorOptions.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/editor/StandaloneEditorOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { ContentModelSegmentFormat } from '../format/ContentModelSegmentFormat';\nimport type { StandaloneCoreApiMap } from './StandaloneEditorCore';\nimport type { EditorPlugin, TrustedHTMLHandler } from 'roosterjs-editor-types';\nimport type { DomToModelOption } from '../context/DomToModelOption';\nimport type { ModelToDomOption } from '../context/ModelToDomOption';\nimport type { ContentModelDocument } from '../group/ContentModelDocument';\n\n/**\n * Options for Content Model editor\n */\nexport interface StandaloneEditorOptions {\n    /**\n     * Default options used for DOM to Content Model conversion\n     */\n    defaultDomToModelOptions?: DomToModelOption;\n\n    /**\n     * Default options used for Content Model to DOM conversion\n     */\n    defaultModelToDomOptions?: ModelToDomOption;\n\n    /**\n     * Reuse existing DOM structure if possible, and update the model when content or selection is changed\n     */\n    cacheModel?: boolean;\n\n    /**\n     * List of plugins.\n     * The order of plugins here determines in what order each event will be dispatched.\n     * Plugins not appear in this list will not be added to editor, including built-in plugins.\n     * Default value is empty array.\n     */\n    plugins?: EditorPlugin[];\n\n    /**\n     * Default format of editor content. This will be applied to empty content.\n     * If there is already content inside editor, format of existing content will not be changed.\n     * Default value is the computed style of editor content DIV\n     */\n    defaultSegmentFormat?: ContentModelSegmentFormat;\n\n    /**\n     * Allowed custom content type when paste besides text/plain, text/html and images\n     * Only text types are supported, and do not add \"text/\" prefix to the type values\n     */\n    allowedCustomPasteType?: string[];\n\n    /**\n     * The scroll container to get scroll event from.\n     * By default, the scroll container will be the same with editor content DIV\n     */\n    scrollContainer?: HTMLElement;\n\n    /**\n     * A util function to transform light mode color to dark mode color\n     * Default value is to return the original light color\n     */\n    getDarkColor?: (lightColor: string) => string;\n\n    /**\n     * Customized trusted type handler used for sanitizing HTML string before assign to DOM tree\n     * This is required when trusted-type Content-Security-Policy (CSP) is enabled.\n     * See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/trusted-types\n     */\n    trustedHTMLHandler?: TrustedHTMLHandler;\n\n    /**\n     * A function map to override default core API implementation\n     * Default value is null\n     */\n    coreApiOverride?: Partial<StandaloneCoreApiMap>;\n\n    /**\n     * Color of the border of a selectedImage. Default color: '#DB626C'\n     */\n    imageSelectionBorderColor?: string;\n\n    /**\n     * Initial Content Model\n     */\n    initialModel?: ContentModelDocument;\n\n    /**\n     * Whether to skip the adjust editor process when for light/dark mode\n     */\n    doNotAdjustEditorColor?: boolean;\n\n    /**\n     * If the editor is currently in dark mode\n     */\n    inDarkMode?: boolean;\n}\n"]}
+{"version":3,"file":"StandaloneEditorOptions.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/editor/StandaloneEditorOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { ContentModelSegmentFormat } from '../format/ContentModelSegmentFormat';\nimport type { StandaloneCoreApiMap } from './StandaloneEditorCore';\nimport type { EditorPlugin, TrustedHTMLHandler } from 'roosterjs-editor-types';\nimport type { DomToModelOption } from '../context/DomToModelOption';\nimport type { ModelToDomOption } from '../context/ModelToDomOption';\nimport type { ContentModelDocument } from '../group/ContentModelDocument';\nimport type { SnapshotsManager } from '../parameter/SnapshotsManager';\n\n/**\n * Options for Content Model editor\n */\nexport interface StandaloneEditorOptions {\n    /**\n     * Default options used for DOM to Content Model conversion\n     */\n    defaultDomToModelOptions?: DomToModelOption;\n\n    /**\n     * Default options used for Content Model to DOM conversion\n     */\n    defaultModelToDomOptions?: ModelToDomOption;\n\n    /**\n     * Reuse existing DOM structure if possible, and update the model when content or selection is changed\n     */\n    cacheModel?: boolean;\n\n    /**\n     * List of plugins.\n     * The order of plugins here determines in what order each event will be dispatched.\n     * Plugins not appear in this list will not be added to editor, including built-in plugins.\n     * Default value is empty array.\n     */\n    plugins?: EditorPlugin[];\n\n    /**\n     * Default format of editor content. This will be applied to empty content.\n     * If there is already content inside editor, format of existing content will not be changed.\n     * Default value is the computed style of editor content DIV\n     */\n    defaultSegmentFormat?: ContentModelSegmentFormat;\n\n    /**\n     * Allowed custom content type when paste besides text/plain, text/html and images\n     * Only text types are supported, and do not add \"text/\" prefix to the type values\n     */\n    allowedCustomPasteType?: string[];\n\n    /**\n     * The scroll container to get scroll event from.\n     * By default, the scroll container will be the same with editor content DIV\n     */\n    scrollContainer?: HTMLElement;\n\n    /**\n     * A util function to transform light mode color to dark mode color\n     * Default value is to return the original light color\n     */\n    getDarkColor?: (lightColor: string) => string;\n\n    /**\n     * Customized trusted type handler used for sanitizing HTML string before assign to DOM tree\n     * This is required when trusted-type Content-Security-Policy (CSP) is enabled.\n     * See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/trusted-types\n     */\n    trustedHTMLHandler?: TrustedHTMLHandler;\n\n    /**\n     * A function map to override default core API implementation\n     * Default value is null\n     */\n    coreApiOverride?: Partial<StandaloneCoreApiMap>;\n\n    /**\n     * Color of the border of a selectedImage. Default color: '#DB626C'\n     */\n    imageSelectionBorderColor?: string;\n\n    /**\n     * Initial Content Model\n     */\n    initialModel?: ContentModelDocument;\n\n    /**\n     * Whether to skip the adjust editor process when for light/dark mode\n     */\n    doNotAdjustEditorColor?: boolean;\n\n    /**\n     * If the editor is currently in dark mode\n     */\n    inDarkMode?: boolean;\n\n    /**\n     * Undo snapshot service based on content metadata. Use this parameter to customize the undo snapshot service.\n     * When this property is set, value of undoSnapshotService will be ignored.\n     */\n    snapshotsManager?: SnapshotsManager;\n}\n"]}

package/lib/event/ContentModelContentChangedEvent.d.ts

@@ -1,3 +1,4 @@
+import type { EntityState } from '../parameter/FormatWithContentModelContext';
 import type { ContentModelEntity } from '../entity/ContentModelEntity';
 import type { EntityRemovalOperation } from '../enum/EntityOperation';
 import type { ContentModelDocument } from '../group/ContentModelDocument';
@@ -16,7 +17,7 @@ export interface ChangedEntity {
      */
     operation: EntityRemovalOperation | 'newEntity';
     /**
-     * @optional Raw DOM event that causes the chagne
+     * @optional Raw DOM event that causes the change
      */
     rawEvent?: Event;
 }
@@ -36,6 +37,10 @@ export interface ContentModelContentChangedEventData extends ContentChangedEvent
      * Entities got changed (added or removed) during the content change process
      */
     readonly changedEntities?: ChangedEntity[];
+    /**
+     * Entity states related to this event
+     */
+    readonly entityStates?: EntityState[];
 }
 /**
  * Represents a change to the editor made by another plugin with content model inside