roosterjs 9.6.0 → 9.8.0

package/dist/rooster.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 9.6.0)
+// Type definitions for roosterjs (Version 9.8.0)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -3093,9 +3093,11 @@ 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(newModel?: ContentModelDocument): void;
+    flushMutations(ignoreMutations?: boolean): void;
 }
 
     /**
@@ -7889,6 +7891,16 @@ function applySegmentFormat(editor: IEditor, newFormat: Readonly<ContentModelSeg
  */
 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.
+ */
+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
@@ -8317,6 +8329,11 @@ class PastePlugin implements EditorPlugin  {
     private setEventSanitizers;
 }
 
+    /**
+ * Default style sanitizers for PastePlugin.
+ */
+const DefaultSanitizers: Record<string, ValueSanitizer>;
+
     /**
  * Edit plugins helps editor to do editing operation on top of content model.
  * This includes:
@@ -8325,11 +8342,17 @@ class PastePlugin implements EditorPlugin  {
  * 3. Tab Key
  */
 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
      */
@@ -8367,6 +8390,16 @@ class EditPlugin implements EditorPlugin  {
     private handleBeforeInputEvent;
 }
 
+    /**
+ * Options to customize the keyboard handling behavior of Edit plugin
+ */
+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.
@@ -8716,6 +8749,7 @@ class WatermarkPlugin implements EditorPlugin  {
     private editor;
     private format;
     private isShowing;
+    private darkTextColor;
     /**
      * Create an instance of Watermark plugin
      * @param watermark The watermark string
@@ -8741,6 +8775,7 @@ class WatermarkPlugin implements EditorPlugin  {
     onPluginEvent(event: PluginEvent): void;
     private showHide;
     protected show(editor: IEditor): void;
+    private applyWatermarkStyle;
     protected hide(editor: IEditor): void;
 }
 
@@ -9129,7 +9164,7 @@ 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;
@@ -9142,6 +9177,7 @@ class ImageEditPlugin implements ImageEditor, EditorPlugin  {
     private croppers;
     private zoomScale;
     private disposer;
+    protected isEditing: boolean;
     constructor(options?: ImageEditOptions);
     /**
      * Get name of this plugin
@@ -9166,20 +9202,25 @@ 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;
 }
 
     /**
@@ -9234,7 +9275,7 @@ interface ImageEditOptions {
      * Which operations will be executed when image is selected
      * @default resizeAndRotate
      */
-    onSelectState?: ImageEditOperation;
+    onSelectState?: ImageEditOperation[];
 }
 
     /**