roosterjs 9.5.1 → 9.7.0

package/dist/rooster-amd.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 9.5.1)
+// Type definitions for roosterjs (Version 9.7.0)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -3067,6 +3067,16 @@ export interface DomIndexer {
      * @returns True if reconcile successfully, otherwise false
      */
     reconcileSelection: (model: ContentModelDocument, newSelection: DOMSelection, oldSelection?: CacheSelection) => boolean;
+    /**
+     * When child list of editor content is changed, we can use this method to do sync the change from editor into content model.
+     * This is mostly used when user start to type in an empty line. In that case browser will remove the existing BR node in the empty line if any,
+     * and create a new TEXT node for the typed text. Here we use these information to remove original Br segment and create a new Text segment
+     * in content model. But if we find anything that cannot be handled, return false so caller will invalidate the cached model
+     * @param addedNodes Nodes added by browser during mutation
+     * @param removedNodes Nodes removed by browser during mutation
+     * @returns True if the changed nodes are successfully reconciled, otherwise false
+     */
+    reconcileChildList: (addedNodes: ArrayLike<Node>, removedNodes: ArrayLike<Node>) => boolean;
 }
 
 /**
@@ -3082,9 +3092,11 @@ export interface TextMutationObserver {
      */
     stopObserving(): void;
     /**
-     * Flush all pending mutations that have not be handled in order to ignore them
+     * Flush all pending mutations and update cached model if need
+     * @param ignoreMutations When pass true, all mutations will be ignored and do not update content model.
+     * This should only be used when we already have a up-to-date content model and will set it as latest cache
      */
-    flushMutations(): void;
+    flushMutations(ignoreMutations?: boolean): void;
 }
 
 /**
@@ -7492,6 +7504,11 @@ export const OrderedListStyleMap: Record<number, string>;
  */
 export const UnorderedListStyleMap: Record<number, string>;
 
+/**
+ * Provide a default empty instance of segment format with all its properties
+ */
+export const EmptySegmentFormat: Readonly<Required<ContentModelSegmentFormat>>;
+
 /**
  * The main editor class based on Content Model
  */
@@ -7873,6 +7890,16 @@ export function applySegmentFormat(editor: IEditor, newFormat: Readonly<ContentM
  */
 export function changeCapitalization(editor: IEditor, capitalization: 'sentence' | 'lowerCase' | 'upperCase' | 'capitalize', language?: string): void;
 
+/**
+ * Split given text segments from the given range
+ * @param textSegment segment to split
+ * @param parent parent paragraph the text segment exist in
+ * @param start starting point of the split
+ * @param end ending point of the split
+ * @returns text segment from the indicated split.
+ */
+export function splitTextSegment(textSegment: ContentModelText, parent: ShallowMutableContentModelParagraph, start: number, end: number): ContentModelText;
+
 /**
  * Insert an image into current selected position
  * @param editor The editor to operate on
@@ -8309,11 +8336,17 @@ export class PastePlugin implements EditorPlugin  {
  * 3. Tab Key
  */
 export class EditPlugin implements EditorPlugin  {
+    private options;
     private editor;
     private disposer;
     private shouldHandleNextInputEvent;
     private selectionAfterDelete;
     private handleNormalEnter;
+    /**
+     * @param options An optional parameter that takes in an object of type EditOptions, which includes the following properties:
+     * handleTabKey: A boolean that enables or disables Tab key handling. Defaults to true.
+     */
+    constructor(options?: EditOptions);
     /**
      * Get name of this plugin
      */
@@ -8351,6 +8384,16 @@ export class EditPlugin implements EditorPlugin  {
     private handleBeforeInputEvent;
 }
 
+/**
+ * Options to customize the keyboard handling behavior of Edit plugin
+ */
+export type EditOptions = {
+    /**
+     * Whether to handle Tab key in keyboard. @default true
+     */
+    handleTabKey?: boolean;
+};
+
 /**
  * Auto Format plugin handles auto formatting, such as transforming * characters into a bullet list.
  * It can be customized with options to enable or disable auto list features.
@@ -8700,6 +8743,7 @@ export class WatermarkPlugin implements EditorPlugin  {
     private editor;
     private format;
     private isShowing;
+    private darkTextColor;
     /**
      * Create an instance of Watermark plugin
      * @param watermark The watermark string
@@ -8725,6 +8769,7 @@ export class WatermarkPlugin implements EditorPlugin  {
     onPluginEvent(event: PluginEvent): void;
     private showHide;
     protected show(editor: IEditor): void;
+    private applyWatermarkStyle;
     protected hide(editor: IEditor): void;
 }
 
@@ -9113,7 +9158,7 @@ export class ImageEditPlugin implements ImageEditor, EditorPlugin  {
     protected editor: IEditor | null;
     private shadowSpan;
     private selectedImage;
-    wrapper: HTMLSpanElement | null;
+    protected wrapper: HTMLSpanElement | null;
     private imageEditInfo;
     private imageHTMLOptions;
     private dndHelpers;
@@ -9126,6 +9171,7 @@ export class ImageEditPlugin implements ImageEditor, EditorPlugin  {
     private croppers;
     private zoomScale;
     private disposer;
+    protected isEditing: boolean;
     constructor(options?: ImageEditOptions);
     /**
      * Get name of this plugin
@@ -9150,20 +9196,25 @@ export class ImageEditPlugin implements ImageEditor, EditorPlugin  {
      * exclusively by another plugin.
      * @param event The event to handle:
      */
-    onPluginEvent(_event: PluginEvent): void;
+    onPluginEvent(event: PluginEvent): void;
+    private isImageSelection;
+    private mouseUpHandler;
+    private selectBeforeEditingImage;
+    private keyDownHandler;
+    private applyFormatWithContentModel;
     private startEditing;
-    startRotateAndResize(editor: IEditor, image: HTMLImageElement, apiOperation?: 'resize' | 'rotate'): void;
+    startRotateAndResize(editor: IEditor, image: HTMLImageElement): void;
     private updateRotateHandleState;
     isOperationAllowed(operation: ImageEditOperation): boolean;
     canRegenerateImage(image: HTMLImageElement): boolean;
+    private startCropMode;
     cropImage(): void;
     private editImage;
     private cleanInfo;
-    private formatImageWithContentModel;
     private removeImageWrapper;
     flipImage(direction: 'horizontal' | 'vertical'): void;
     rotateImage(angleRad: number): void;
-    getWrapper(): HTMLSpanElement | null;
+    get isEditingImage(): boolean;
 }
 
 /**
@@ -9218,7 +9269,7 @@ export interface ImageEditOptions {
      * Which operations will be executed when image is selected
      * @default resizeAndRotate
      */
-    onSelectState?: ImageEditOperation;
+    onSelectState?: ImageEditOperation[];
 }
 
 /**