roosterjs 8.35.2 → 8.37.0

package/dist/rooster-amd.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 8.35.2)
+// Type definitions for roosterjs (Version 8.37.0)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -1236,8 +1236,9 @@ export class VListChain {
  * If the child inline elements have different styles, it will not modify the styles of the list item
  * @param element the LI Element to set the styles
  * @param styles The styles that should be applied to the element.
+ * @param isCssStyle True means the given styles are CSS style names, false means they are HTML attributes @default true
  */
-export function setListItemStyle(element: HTMLLIElement, styles: string[]): void;
+export function setListItemStyle(element: HTMLLIElement, styles: string[], isCssStyle?: boolean): void;
 
 /**
  * Get the format info of a table
@@ -1656,6 +1657,35 @@ export function getEntityFromElement(element: HTMLElement): Entity | null;
  */
 export function getEntitySelector(type?: string, id?: string): string;
 
+/**
+ * Create a placeholder comment node for entity
+ * @param entity The entity to create placeholder from
+ * @returns A placeholder comment node as
+ */
+export function createEntityPlaceholder(entity: Entity): HTMLElement;
+
+/**
+ * Move content from a container into a new Document fragment, and try keep entities to be reusable by creating placeholder
+ * for them in the document fragment.
+ * If an entity is directly under root container, the whole entity can be reused and no need to move it at all.
+ * If an entity is not directly under root container, it is still reusable, but it may need some movement.
+ * In any case, entities will be replaced with a placeholder in the target document fragment.
+ * We will use an entity map (the "entities" parameter) to save the map from entity id to its wrapper element.
+ * @param root The root element
+ * @param entities A map from entity id to entity wrapper element
+ * @returns A new document fragment contains all the content and entity placeholders
+ */
+export function moveContentWithEntityPlaceholders(root: HTMLDivElement, entities: Record<string, HTMLElement>): DocumentFragment;
+
+/**
+ * Restore HTML content from a document fragment that may contain entity placeholders.
+ * @param source Source document fragment that contains HTML content and entity placeholders
+ * @param target Target container, usually to be editor root container
+ * @param entities A map from entity id to entity wrapper, used for reusing existing DOM structure for entity
+ * @param insertClonedNode When pass true, merge with a cloned copy of the nodes from source fragment rather than the nodes themselves @default false
+ */
+export function restoreContentWithEntityPlaceholder(source: DocumentFragment, target: HTMLElement, entities: Record<string, HTMLElement> | null, insertClonedNode?: boolean): void;
+
 /**
  * Gets the cached event data by cache key from event object if there is already one.
  * Otherwise, call getter function to create one, and cache it.
@@ -1714,6 +1744,22 @@ export function setStyles(element: HTMLElement, styles: Record<string, string>):
  */
 export function removeImportantStyleRule(element: HTMLElement, styleProperties: string[]): void;
 
+/**
+ * Add global css styles
+ * @param doc The document object
+ * @param cssRule The css rule that must added to the selection
+ * @param editorId Te id of the editor
+ * @param styleId the ID of the style tag
+ */
+export function setGlobalCssStyles(doc: Document, cssRule: string, styleId: string): void;
+
+/**
+ * Remove a css rule style from a style sheet
+ * @param doc The document object
+ * @param styleId the ID of the style tag
+ */
+export function removeGlobalCssStyle(doc: Document, styleId: string): void;
+
 /**
  *
  * @param root the contentDiv of the ditor
@@ -2668,8 +2714,9 @@ export const experimentCommitListChains: typeof commitListChains;
 /**
  * Get dark mode color for a given color
  * @param color The color to calculate from
+ * @param baseLValue The Light value for base dark color in LAB format. @default the Light value for #333333
  */
-export function getDarkColor(color: string): string;
+export function getDarkColor(color: string, baseLValue?: number): string;
 
 /**
  * Information of current OS and web browser
@@ -2851,6 +2898,10 @@ export interface LifecyclePluginState {
      * Cached document fragment for original content
      */
     shadowEditFragment: DocumentFragment | null;
+    /**
+     * Cached entity pairs for original content
+     */
+    shadowEditEntities: Record<string, HTMLElement> | null;
     /**
      * Cached selection path for original content
      */
@@ -3578,6 +3629,7 @@ export const enum ExperimentalFeatures {
      */
     ConvertSingleImageBody = "ConvertSingleImageBody",
     /**
+     * @deprecated This feature is always enabled
      * Align table elements to left, center and right using setAlignment API
      */
     TableAlignment = "TableAlignment",
@@ -3586,6 +3638,7 @@ export const enum ExperimentalFeatures {
      */
     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",
@@ -3614,6 +3667,7 @@ export const enum ExperimentalFeatures {
      */
     NormalizeList = "NormalizeList",
     /**
+     * @deprecated this feature is always enabled
      * When a html image is selected, the selected image data will be stored by editor core.
      */
     ImageSelection = "ImageSelection",
@@ -3623,7 +3677,12 @@ export const enum ExperimentalFeatures {
      * listTypes array for that item. The only list that we will ensure is correct
      * is the one closest to the item.
      */
-    ReuseAllAncestorListElements = "ReuseAllAncestorListElements"
+    ReuseAllAncestorListElements = "ReuseAllAncestorListElements",
+    /**
+     * When apply default format when initialize or user type, apply the format on a SPAN element rather than
+     * the block element (In most case, the DIV element) so keep the block element clean.
+     */
+    DefaultFormatInSpan = "DefaultFormatInSpan"
 }
 
 /**
@@ -6657,6 +6716,10 @@ export interface CorePlugins {
      * Entity Plugin handles all operations related to an entity and generate entity specified events
      */
     readonly entity: PluginWithState<EntityPluginState>;
+    /**
+     * Image selection Plugin detects image selection and help highlight the image
+     */
+    readonly imageSelection: EditorPlugin;
     /**
      * NormalizeTable plugin makes sure each table in editor has TBODY/THEAD/TFOOT tag around TR tags
      */
@@ -6797,6 +6860,8 @@ export interface CoreApiMap {
      * @param core The EditorCore object.
      * @param position The position that user is about to type to
      * @param keyboardEvent Optional keyboard event object
+     * @param applyFormatToSpan Optional When set to true, default format (if any) will be applied to
+     * a SPAN element inside the block element instead of the block element itself.
      */
     ensureTypeInContainer: EnsureTypeInContainer;
     /**
@@ -6933,8 +6998,10 @@ export type CreatePasteFragment = (core: EditorCore, clipboardData: ClipboardDat
  * @param core The EditorCore object.
  * @param position The position that user is about to type to
  * @param keyboardEvent Optional keyboard event object
+ * @param applyFormatToSpan Optional When set to true, default format (if any) will be applied to
+ * a SPAN element inside the block element instead of the block element itself.
  */
-export type EnsureTypeInContainer = (core: EditorCore, position: NodePosition, keyboardEvent?: KeyboardEvent) => void;
+export type EnsureTypeInContainer = (core: EditorCore, position: NodePosition, keyboardEvent?: KeyboardEvent, applyFormatToSpan?: boolean) => void;
 
 /**
  * Focus to editor. If there is a cached selection range, use it as current selection
@@ -7295,6 +7362,11 @@ export interface ListFeatureSettings {
      * @default true
      */
     autoNumberingList: boolean;
+    /**
+     * MergeListOnBackspaceAfterList edit feature, provides the ability to merge list on backspace on block after a list.
+     * @default true
+     */
+    mergeListOnBackspaceAfterList: boolean;
 }
 
 /**
@@ -7998,6 +8070,7 @@ export enum CompatibleExperimentalFeatures {
      */
     ConvertSingleImageBody = "ConvertSingleImageBody",
     /**
+     * @deprecated This feature is always enabled
      * Align table elements to left, center and right using setAlignment API
      */
     TableAlignment = "TableAlignment",
@@ -8006,6 +8079,7 @@ export enum CompatibleExperimentalFeatures {
      */
     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",
@@ -8034,6 +8108,7 @@ export enum CompatibleExperimentalFeatures {
      */
     NormalizeList = "NormalizeList",
     /**
+     * @deprecated this feature is always enabled
      * When a html image is selected, the selected image data will be stored by editor core.
      */
     ImageSelection = "ImageSelection",
@@ -8043,7 +8118,12 @@ export enum CompatibleExperimentalFeatures {
      * listTypes array for that item. The only list that we will ensure is correct
      * is the one closest to the item.
      */
-    ReuseAllAncestorListElements = "ReuseAllAncestorListElements"
+    ReuseAllAncestorListElements = "ReuseAllAncestorListElements",
+    /**
+     * When apply default format when initialize or user type, apply the format on a SPAN element rather than
+     * the block element (In most case, the DIV element) so keep the block element clean.
+     */
+    DefaultFormatInSpan = "DefaultFormatInSpan"
 }
 
 /**
@@ -9639,6 +9719,8 @@ export class ImageEdit implements EditorPlugin  {
     private disposer;
     private allowedOperations;
     private image;
+    private clonedImage;
+    private wrapper;
     private editInfo;
     private lastSrc;
     private dndHelpers;
@@ -9646,6 +9728,10 @@ export class ImageEdit implements EditorPlugin  {
      * Identify if the image was resized by the user.
      */
     private wasResized;
+    /**
+     * Editor zoom scale
+     */
+    private zoomWrapper;
     /**
      * Create a new instance of ImageEdit
      * @param options Image editing options
@@ -9669,11 +9755,11 @@ export class ImageEdit implements EditorPlugin  {
     dispose(): void;
     /**
      * Handle events triggered from editor
-     * @param event PluginEvent object
+     * @param e PluginEvent object
      */
     onPluginEvent(e: PluginEvent): void;
     /**
-     * Check if the given image edit operation is allowed by this pluign
+     * Check if the given image edit operation is allowed by this plugin
      * @param operation The image edit operation to check
      * @returns True means it is allowed, otherwise false
      */
@@ -9700,14 +9786,13 @@ export class ImageEdit implements EditorPlugin  {
      * Create editing wrapper for the image
      */
     private createWrapper;
-    /**
-     * Get image wrapper from image
-     * @param image The image to get wrapper from
-     */
-    private getImageWrapper;
+    private toggleImageVisibility;
+    private createZoomWrapper;
+    private copyImageSize;
+    private insertImageWrapper;
+    private getStylePropertyValue;
     /**
      * Remove the temp wrapper of the image
-     * @param wrapper The wrapper object to remove. If not specified, remove all existing wrappers.
      */
     private removeWrapper;
     /**
@@ -10076,26 +10161,3 @@ export class AutoFormat implements EditorPlugin  {
     onPluginEvent(event: PluginEvent): void;
 }
 
-/**
- * Requires @see ExperimentalFeatures.ImageSelection to be enabled.
- * Detect image selection and help highlight the image
- */
-export class ImageSelection implements EditorPlugin  {
-    private editor;
-    constructor();
-    /**
-     * Get a friendly name of  this plugin
-     */
-    getName(): string;
-    /**
-     * Initialize this plugin. This should only be called from Editor
-     * @param editor Editor instance
-     */
-    initialize(editor: IEditor): void;
-    /**
-     * Dispose this plugin
-     */
-    dispose(): void;
-    onPluginEvent(event: PluginEvent): void;
-}
-