roosterjs 8.41.0 → 8.43.0

package/dist/rooster-amd.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 8.41.0)
+// Type definitions for roosterjs (Version 8.43.0)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -187,6 +187,19 @@ export class PositionContentSearcher implements IPositionContentSearcher  {
     private traverse;
 }
 
+/**
+ * Adds delimiters to the element provided.
+ * @param element element to be between delimiters
+ */
+export function addDelimiters(element: HTMLElement): void;
+
+/**
+ * Retrieves Delimiter information from a provided element.
+ * @param element element to try to retrieve a delimiter
+ * @returns delimiter info if it is a Delimiter, else null
+ */
+export function getDelimiterFromElement(element: HTMLElement | Element | null | undefined): Element | null;
+
 /**
  * Get the inline element at a node
  * @param rootNode The root node of current scope
@@ -752,6 +765,12 @@ export function getIntersectedRect(elements: HTMLElement[], additionalRects?: Re
  */
 export function isNodeAfter(node1: Node, node2: Node): boolean;
 
+/**
+ * Parse color string to r/g/b value.
+ * If the given color is not in a recognized format, return null
+ */
+export function parseColor(color: string): [number, number, number] | null;
+
 /**
  * A virtual table class, represent an HTML table, by expand all merged cells to each separated cells
  */
@@ -2297,7 +2316,7 @@ export class Editor implements IEditor  {
      * @returns the current EditorCore object
      * @throws a standard Error if there's no core object
      */
-    private getCore;
+    protected getCore(): EditorCore;
 }
 
 /**
@@ -2383,19 +2402,10 @@ export function insertEntity(editor: IEditor, type: string, contentNode: Node, i
 /**
  * Insert an image to editor at current selection
  * @param editor The editor instance
- * @param imageFile The image file. There are at least 3 ways to obtain the file object:
- * From local file, from clipboard data, from drag-and-drop
- * @param attributes Optional image element attributes
- */
-export function insertImage(editor: IEditor, imageFile: File, attributes?: Record<string, string>): void;
-
-/**
- * Insert an image to editor at current selection
- * @param editor The editor instance
- * @param url The image link
+ * @param imageFileOrSrc Either the image file blob or source string of the image.
  * @param attributes Optional image element attributes
  */
-export function insertImage(editor: IEditor, url: string, attributes?: Record<string, string>): void;
+export function insertImage(editor: IEditor, imageFileOrSrc: File | string, attributes?: Record<string, string>): void;
 
 /**
  * Insert table into editor at current selection
@@ -3486,6 +3496,20 @@ export const enum DarkModeDatasetNames {
     OriginalAttributeBackgroundColor = "ogab"
 }
 
+/**
+ * Class names for Delimiter
+ */
+export const enum DelimiterClasses {
+    /**
+     * Class name to specify this delimiter is before an entity
+     */
+    DELIMITER_BEFORE = "entityDelimiterBefore",
+    /**
+     *  Class name to specify this delimiter is after an entity
+     */
+    DELIMITER_AFTER = "entityDelimiterAfter"
+}
+
 /**
  * enum for setting block direction, used by setDirection API
  */
@@ -3697,7 +3721,15 @@ export const enum ExperimentalFeatures {
      * When enable this feature, need to pass in a DarkModelHandler object to each call of setColor and applyFormat
      * if you need them work for dark mode
      */
-    VariableBasedDarkColor = "VariableBasedDarkColor"
+    VariableBasedDarkColor = "VariableBasedDarkColor",
+    /**
+     * Delete table with Backspace key with the whole was selected with table selector
+     */
+    DeleteTableWithBackspace = "DeleteTableWithBackspace",
+    /**
+     * Add entities around a Read Only  Inline entity to prevent cursor to be hidden when cursor is next of it.
+     */
+    InlineEntityReadOnlyDelimiters = "InlineEntityReadOnlyDelimiters"
 }
 
 /**
@@ -5363,6 +5395,26 @@ export interface StyleBasedFormatState {
      * Mode independent background color for dark mode
      */
     textColors?: ModeIndependentColor;
+    /**
+     * Line height
+     */
+    lineHeight?: string;
+    /**
+     * Margin Top
+     */
+    marginTop?: string;
+    /**
+     * Margin Bottom
+     */
+    marginBottom?: string;
+    /**
+     * Text Align
+     */
+    textAlign?: string;
+    /**
+     * Direction of the element ('ltr' or 'rtl')
+     */
+    direction?: string;
 }
 
 /**
@@ -5843,6 +5895,10 @@ export interface Snapshot {
      * Metadata of the editor content state
      */
     metadata: ContentMetadata | null;
+    /**
+     * Known colors for dark mode
+     */
+    knownColors: Readonly<ModeIndependentColor>[];
 }
 
 /**
@@ -6633,6 +6689,15 @@ export interface DarkColorHandler {
      * @param color The color string to parse
      */
     parseColorValue(color: string | null | undefined): ColorKeyAndValue;
+    /**
+     * Get a copy of known colors
+     */
+    getKnownColorsCopy(): Readonly<ModeIndependentColor>[];
+    /**
+     * Find related light mode color from dark mode color.
+     * @param darkColor The existing dark color
+     */
+    findLightColorFromDarkColor(darkColor: string): string | null;
 }
 
 /**
@@ -7530,6 +7595,11 @@ export interface TableFeatureSettings {
      * IndentTableOnTab edit feature, provides the ability to indent the table if it is all cells are selected.
      */
     indentTableOnTab: boolean;
+    /**
+     * Requires @see ExperimentalFeatures.DeleteTableWithBackspace
+     * Delete a table selected with the table selector pressing  Backspace key
+     */
+    deleteTableWithBackspace: boolean;
 }
 
 /**
@@ -8215,7 +8285,15 @@ export enum CompatibleExperimentalFeatures {
      * When enable this feature, need to pass in a DarkModelHandler object to each call of setColor and applyFormat
      * if you need them work for dark mode
      */
-    VariableBasedDarkColor = "VariableBasedDarkColor"
+    VariableBasedDarkColor = "VariableBasedDarkColor",
+    /**
+     * Delete table with Backspace key with the whole was selected with table selector
+     */
+    DeleteTableWithBackspace = "DeleteTableWithBackspace",
+    /**
+     * Add entities around a Read Only  Inline entity to prevent cursor to be hidden when cursor is next of it.
+     */
+    InlineEntityReadOnlyDelimiters = "InlineEntityReadOnlyDelimiters"
 }
 
 /**
@@ -8867,6 +8945,20 @@ export enum CompatibleDarkModeDatasetNames {
     OriginalAttributeBackgroundColor = "ogab"
 }
 
+/**
+ * Class names for Delimiter
+ */
+export enum CompatibleDelimiterClasses {
+    /**
+     * Class name to specify this delimiter is before an entity
+     */
+    DELIMITER_BEFORE = "entityDelimiterBefore",
+    /**
+     *  Class name to specify this delimiter is after an entity
+     */
+    DELIMITER_AFTER = "entityDelimiterAfter"
+}
+
 /**
  * enum for setting block direction, used by setDirection API
  */
@@ -9810,7 +9902,7 @@ export class HyperLink implements EditorPlugin  {
  */
 export class ImageEdit implements EditorPlugin  {
     private onShowResizeHandle?;
-    protected editor: IEditor;
+    protected editor: IEditor | null;
     protected options: ImageEditOptions;
     private disposer;
     private allowedOperations;
@@ -9839,7 +9931,7 @@ export class ImageEdit implements EditorPlugin  {
      * To customize the resize handle element, add this callback and change the attributes of elementData then it
      * will be picked up by ImageEdit code
      */
-    constructor(options?: ImageEditOptions, onShowResizeHandle?: OnShowResizeHandle);
+    constructor(options?: ImageEditOptions, onShowResizeHandle?: OnShowResizeHandle | undefined);
     /**
      * Get a friendly name of this plugin
      */