roosterjs 9.26.0 → 9.27.0

package/dist/rooster-amd.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 9.26.0)
+// Type definitions for roosterjs (Version 9.27.0)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -75,7 +75,7 @@ export type ShallowMutableContentModelWithDataset<T> = ShallowMutableMark & {
 /**
  * The format object for a paragraph in Content Model
  */
-export type ContentModelBlockFormat = BackgroundColorFormat & DirectionFormat & TextAlignFormat & HtmlAlignFormat & MarginFormat & PaddingFormat & LineHeightFormat & WhiteSpaceFormat & BorderFormat & TextIndentFormat;
+export type ContentModelBlockFormat = BackgroundColorFormat & DirectionFormat & TextAlignFormat & HtmlAlignFormat & MarginFormat & PaddingFormat & LineHeightFormat & WhiteSpaceFormat & BorderFormat & TextIndentFormat & IdFormat;
 
 /**
  * Format of table cell
@@ -235,7 +235,7 @@ export interface ContentModelFormatMap {
 /**
  * The format object for an image in Content Model
  */
-export type ContentModelImageFormat = ContentModelSegmentFormat & IdFormat & SizeFormat & MarginFormat & PaddingFormat & BorderFormat & BoxShadowFormat & DisplayFormat & FloatFormat & VerticalAlignFormat;
+export type ContentModelImageFormat = ContentModelSegmentFormat & IdFormat & SizeFormat & MarginFormat & PaddingFormat & BorderFormat & BoxShadowFormat & DisplayFormat & FloatFormat & VerticalAlignFormat & ImageStateFormat;
 
 /**
  * The format object for an entity in Content Model
@@ -306,6 +306,10 @@ export interface FormatHandlerTypeMap {
      * Format for IdFormat
      */
     id: IdFormat;
+    /**
+     * Format of ImageStateFormat
+     */
+    imageState: ImageStateFormat;
     /**
      * Format for ItalicFormat
      */
@@ -890,6 +894,16 @@ export type UndeletableFormat = {
     undeletable?: boolean;
 };
 
+/**
+ * The hidden property of an image
+ */
+export type ImageStateFormat = {
+    /**
+     * A hidden marker for the image state
+     */
+    imageState?: string;
+};
+
 /**
  * Represents dataset format of Content Model
  */
@@ -3589,9 +3603,15 @@ export type ExperimentalFeature = /**
  */
  | 'LegacyImageSelection'
 /**
+ * @deprecated Please use the shouldHandleEnterKey option of the EditPlugin Options
  * Use Content Model handle ENTER key
  */
- | 'HandleEnterKey';
+ | 'HandleEnterKey'
+/**
+ *  Prevent default browser behavior for copy/cut event,
+ *  and set the clipboard data with custom implementation.
+ */
+ | 'CustomCopyCut';
 
 /**
  * Options for editor
@@ -4854,9 +4874,13 @@ export interface ContentModelFormatState {
      */
     fontWeight?: string;
     /**
-     * Format of image, if there is table at cursor position
+     * Format of image, if there is image at cursor position
      */
     imageFormat?: ImageFormatState;
+    /**
+     * Editing metadata of image, if there is image at cursor position
+     */
+    imageEditingMetadata?: ImageMetadataFormat | null;
     /**
      * Letter spacing
      */
@@ -5305,7 +5329,15 @@ export type TrustedHTMLHandler = DOMCreator | LegacyTrustedHTMLHandler;
  * A handler type to convert HTML string to a DOM object
  */
 export interface DOMCreator {
+    /**
+     * Callback to convert HTML string to a DOM object
+     */
     htmlToDOM: (html: string) => Document;
+    /**
+     * Flag to indicate if this handler is bypassed or not.
+     * If this is true, it means that when converting HTML string to DOM object, we don't need to do any conversion.
+     */
+    isBypassed?: boolean;
 }
 
 /**
@@ -6963,6 +6995,14 @@ export function normalizeSingleSegment(paragraph: ReadonlyContentModelParagraph,
  */
 export function mergeTextSegments(block: ShallowMutableContentModelParagraph): void;
 
+/**
+ * Some format values can be changed when apply to DOM, such as font family.
+ * This function will normalize the format and return the same string after DOM modification.
+ * @param format The format to be normalized
+ * @return Normalized format
+ */
+export function normalizeSegmentFormat(format: ContentModelSegmentFormat, environment: EditorEnvironment): ContentModelSegmentFormat;
+
 /**
  * For a given block, if it is a paragraph, set it to be not-implicit
  * @param block The block to check
@@ -7214,6 +7254,16 @@ export function setParagraphMarker(element: HTMLElement, marker: string): void;
  */
 export function getParagraphMarker(element: HTMLElement): string | undefined;
 
+/**
+ * Set image state to element. This is used to store a image state.
+ */
+export function setImageState(element: HTMLElement, marker: string): void;
+
+/**
+ * Get image state from element. This is used to store a image state.
+ */
+export function getImageState(element: HTMLElement): string | undefined;
+
 /**
  * Check if the given content model block or block group is of the expected block group type
  * @param input The object to check
@@ -7692,6 +7742,18 @@ export const BulletListType: {
      * Bullet type circle
      */
     Circle: number;
+    /**
+     * Box Shadow bullet type
+     */
+    BoxShadow: number;
+    /**
+     * Rhombus with a cross inside
+     */
+    Xrhombus: number;
+    /**
+     * Check mark bullet type
+     */
+    CheckMark: number;
     /**
      * Maximum value of the enum
      */
@@ -8763,6 +8825,8 @@ export class EditPlugin implements EditorPlugin  {
      * handleTabKey: A boolean that enables or disables Tab key handling. Defaults to true.
      */
     constructor(options?: EditOptions);
+    private createNormalEnterChecker;
+    private getHandleNormalEnter;
     /**
      * Get name of this plugin
      */
@@ -8813,6 +8877,13 @@ export type EditOptions = {
      * @default true
      */
     handleExpandedSelectionOnDelete?: boolean;
+    /**
+     * Callback function to determine whether the Rooster should handle the Enter key press.
+     * If the function returns true, the Rooster will handle the Enter key press instead of the browser.
+     * @param editor - The editor instance.
+     * @returns A boolean
+     */
+    shouldHandleEnterKey?: ((editor: IEditor) => boolean) | boolean;
 };
 
 /**
@@ -8861,10 +8932,13 @@ export class AutoFormatPlugin implements EditorPlugin  {
      * @param event The event to handle:
      */
     onPluginEvent(event: PluginEvent): void;
+    private autoLink;
+    private tabFeatures;
     private features;
+    private enterFeatures;
+    private handleKeyboardEvents;
     private handleEditorInputEvent;
     private handleKeyDownEvent;
-    private handleEnterKey;
     private handleContentChangedEvent;
 }