roosterjs 8.43.0 → 8.44.0

package/dist/rooster-amd.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 8.43.0)
+// Type definitions for roosterjs (Version 8.44.0)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -188,17 +188,29 @@ export class PositionContentSearcher implements IPositionContentSearcher  {
 }
 
 /**
- * Adds delimiters to the element provided.
- * @param element element to be between delimiters
+ * Adds delimiters to the element provided. If the delimiters already exists, will not be added
+ * @param node the node to add the delimiters
  */
-export function addDelimiters(element: HTMLElement): void;
+export function addDelimiters(node: Element): Element[];
+
+/**
+ * Adds delimiter after the element provided.
+ * @param element element to use
+ */
+export function addDelimiterAfter(element: Element): Element;
+
+/**
+ * Adds delimiter before the element provided.
+ * @param element element to use
+ */
+export function addDelimiterBefore(element: Element): Element;
 
 /**
  * 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;
+export function getDelimiterFromElement(element: Node | null | undefined): Element | null;
 
 /**
  * Get the inline element at a node
@@ -3664,23 +3676,11 @@ export const enum ExperimentalFeatures {
      * Align table elements to left, center and right using setAlignment API
      */
     TableAlignment = "TableAlignment",
-    /**
-     * Provide additional Tab Key Features. Requires Text Features Content Editable Features
-     */
-    TabKeyTextFeatures = "TabKeyTextFeatures",
     /**
      * @deprecated this feature is always enabled
      * Provide a circular resize handles that adaptive the number od handles to the size of the image
      */
     AdaptiveHandlesResizer = "AdaptiveHandlesResizer",
-    /**
-     * Align list elements elements to left, center and right using setAlignment API
-     */
-    ListItemAlignment = "ListItemAlignment",
-    /**
-     * Trigger formatting by a especial characters. Ex: (A), 1. i).
-     */
-    AutoFormatList = "AutoFormatList",
     /**
      * @deprecated this feature is always disabled
      * Automatically transform -- into hyphen, if typed between two words.
@@ -3704,6 +3704,18 @@ export const enum ExperimentalFeatures {
      * When a html image is selected, the selected image data will be stored by editor core.
      */
     ImageSelection = "ImageSelection",
+    /**
+     * Provide additional Tab Key Features. Requires Text Features Content Editable Features
+     */
+    TabKeyTextFeatures = "TabKeyTextFeatures",
+    /**
+     * Align list elements elements to left, center and right using setAlignment API
+     */
+    ListItemAlignment = "ListItemAlignment",
+    /**
+     * Trigger formatting by a especial characters. Ex: (A), 1. i).
+     */
+    AutoFormatList = "AutoFormatList",
     /**
      * With this feature enabled, when writing back a list item we will re-use all
      * ancestor list elements, even if they don't match the types currently in the
@@ -3722,6 +3734,10 @@ export const enum ExperimentalFeatures {
      * if you need them work for dark mode
      */
     VariableBasedDarkColor = "VariableBasedDarkColor",
+    /**
+     * Reuse existing DOM structure if possible when convert Content Model back to DOM tree
+     */
+    ReusableContentModel = "ReusableContentModel",
     /**
      * Delete table with Backspace key with the whole was selected with table selector
      */
@@ -5329,6 +5345,10 @@ export interface ElementBasedFormatState {
      * Whether the text is in block quote
      */
     isBlockQuote?: boolean;
+    /**
+     * Whether the text is in Code element
+     */
+    isCodeInline?: boolean;
     /**
      * Whether the text is in Code block
      */
@@ -6687,8 +6707,10 @@ export interface DarkColorHandler {
      * Parse an existing color value, if it is in variable-based color format, extract color key,
      * light color and query related dark color if any
      * @param color The color string to parse
+     * @param isInDarkMode Whether current content is in dark mode. When set to true, if the color value is not in dark var format,
+     * we will treat is as a dark mode color and try to find a matched dark mode color.
      */
-    parseColorValue(color: string | null | undefined): ColorKeyAndValue;
+    parseColorValue(color: string | null | undefined, isInDarkMode?: boolean): ColorKeyAndValue;
     /**
      * Get a copy of known colors
      */
@@ -7096,6 +7118,7 @@ export interface CoreApiMap {
      * @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;
     /**
@@ -7246,8 +7269,9 @@ export type SwitchShadowEdit = (core: EditorCore, isOn: boolean) => void;
  * @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 type TransformColor = (core: EditorCore, rootNode: Node | null, includeSelf: boolean, callback: (() => void) | null, direction: ColorTransformDirection | CompatibleColorTransformDirection, forceTransform?: boolean) => void;
+export type TransformColor = (core: EditorCore, rootNode: Node | null, includeSelf: boolean, callback: (() => void) | null, direction: ColorTransformDirection | CompatibleColorTransformDirection, forceTransform?: boolean, fromDarkMode?: boolean) => void;
 
 /**
  * Trigger a plugin event
@@ -7451,6 +7475,14 @@ export interface EntityFeatureSettings {
      * press DELETE right after an entity
      */
     deleteBeforeEntity: boolean;
+    /**
+     * Content edit feature to move the cursor from Delimiters around Entities when using Right or Left Arrow Keys
+     */
+    moveBetweenDelimitersFeature: boolean;
+    /**
+     * Content edit Feature to trigger a Delete Entity Operation when one of the Delimiter is about to be removed with DELETE or Backspace
+     */
+    removeEntityBetweenDelimiters: boolean;
 }
 
 /**
@@ -8228,23 +8260,11 @@ export enum CompatibleExperimentalFeatures {
      * Align table elements to left, center and right using setAlignment API
      */
     TableAlignment = "TableAlignment",
-    /**
-     * Provide additional Tab Key Features. Requires Text Features Content Editable Features
-     */
-    TabKeyTextFeatures = "TabKeyTextFeatures",
     /**
      * @deprecated this feature is always enabled
      * Provide a circular resize handles that adaptive the number od handles to the size of the image
      */
     AdaptiveHandlesResizer = "AdaptiveHandlesResizer",
-    /**
-     * Align list elements elements to left, center and right using setAlignment API
-     */
-    ListItemAlignment = "ListItemAlignment",
-    /**
-     * Trigger formatting by a especial characters. Ex: (A), 1. i).
-     */
-    AutoFormatList = "AutoFormatList",
     /**
      * @deprecated this feature is always disabled
      * Automatically transform -- into hyphen, if typed between two words.
@@ -8268,6 +8288,18 @@ export enum CompatibleExperimentalFeatures {
      * When a html image is selected, the selected image data will be stored by editor core.
      */
     ImageSelection = "ImageSelection",
+    /**
+     * Provide additional Tab Key Features. Requires Text Features Content Editable Features
+     */
+    TabKeyTextFeatures = "TabKeyTextFeatures",
+    /**
+     * Align list elements elements to left, center and right using setAlignment API
+     */
+    ListItemAlignment = "ListItemAlignment",
+    /**
+     * Trigger formatting by a especial characters. Ex: (A), 1. i).
+     */
+    AutoFormatList = "AutoFormatList",
     /**
      * With this feature enabled, when writing back a list item we will re-use all
      * ancestor list elements, even if they don't match the types currently in the
@@ -8286,6 +8318,10 @@ export enum CompatibleExperimentalFeatures {
      * if you need them work for dark mode
      */
     VariableBasedDarkColor = "VariableBasedDarkColor",
+    /**
+     * Reuse existing DOM structure if possible when convert Content Model back to DOM tree
+     */
+    ReusableContentModel = "ReusableContentModel",
     /**
      * Delete table with Backspace key with the whole was selected with table selector
      */