roosterjs 9.54.0 → 9.56.0

package/dist/rooster-amd.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 9.54.0)
+// Type definitions for roosterjs (Version 9.56.0)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -102,6 +102,11 @@ export type ContentModelHyperLinkFormat = LinkFormat & TextColorFormat & Backgro
  */
 export type ContentModelCodeFormat = FontFamilyFormat & DisplayFormat;
 
+/**
+ * The format object for a data element (<data>) in Content Model
+ */
+export type ContentModelDataFormat = DataValueFormat;
+
 /**
  * Type for FormatContainer
  */
@@ -216,6 +221,10 @@ export interface ContentModelFormatMap {
      * Format type for code
      */
     code: FontFamilyFormat;
+    /**
+     * Format type for data, used by HTML <data> element
+     */
+    data: ContentModelDataFormat;
     /**
      * Format type for dataset
      */
@@ -284,6 +293,10 @@ export interface FormatHandlerTypeMap {
      * Format for DatasetFormat
      */
     dataset: DatasetFormat;
+    /**
+     * Format for DataValueFormat, used by HTML <data> element
+     */
+    dataValue: DataValueFormat;
     /**
      * Format for DirectionFormat
      */
@@ -505,6 +518,16 @@ export type LetterSpacingFormat = {
     letterSpacing?: string;
 };
 
+/**
+ * Format of the value of a HTML "data" element
+ */
+export type DataValueFormat = {
+    /**
+     * The machine-readable value, represented by the "value" attribute of a HTML "data" element
+     */
+    dataValue?: string;
+};
+
 /**
  * Format of line height
  */
@@ -2170,6 +2193,10 @@ export interface ContentModelSegmentBase<T extends ContentModelSegmentType, TFor
      * Code info
      */
     code?: ContentModelCode;
+    /**
+     * Data info, used by HTML &lt;data&gt; element
+     */
+    data?: ContentModelData;
 }
 
 /**
@@ -2194,6 +2221,10 @@ export interface ReadonlyContentModelSegmentBase<T extends ContentModelSegmentTy
      * Code info
      */
     readonly code?: ReadonlyContentModelCode;
+    /**
+     * Data info, used by HTML &lt;data&gt; element
+     */
+    readonly data?: ReadonlyContentModelData;
 }
 
 /**
@@ -2208,6 +2239,10 @@ export interface ShallowMutableContentModelSegmentBase<T extends ContentModelSeg
      * Code info
      */
     code?: ContentModelCode;
+    /**
+     * Data info, used by HTML &lt;data&gt; element
+     */
+    data?: ContentModelData;
 }
 
 /**
@@ -2241,6 +2276,22 @@ export interface ContentModelCode extends MutableMark, ContentModelWithFormat<Co
 export interface ReadonlyContentModelCode extends ReadonlyMark, ReadonlyContentModelWithFormat<ContentModelCodeFormat> {
 }
 
+/**
+ * Represent data info of Content Model, used by HTML &lt;data&gt; element.
+ * ContentModelData is a decorator but not a standalone model type, instead it need to be put inside a ContentModelSegment
+ * since the &lt;data&gt; element is also a kind of segment, with some extra information
+ */
+export interface ContentModelData extends MutableMark, ContentModelWithFormat<ContentModelDataFormat> {
+}
+
+/**
+ * Represent data info of Content Model, used by HTML &lt;data&gt; element. (Readonly)
+ * ContentModelData is a decorator but not a standalone model type, instead it need to be put inside a ContentModelSegment
+ * since the &lt;data&gt; element is also a kind of segment, with some extra information
+ */
+export interface ReadonlyContentModelData extends ReadonlyMark, ReadonlyContentModelWithFormat<ContentModelDataFormat> {
+}
+
 /**
  * Represent link info of Content Model.
  * ContentModelLink is not a standalone model type, instead it need to be put inside a ContentModelSegment
@@ -2286,12 +2337,12 @@ export interface ReadonlyContentModelParagraphDecorator extends ReadonlyMark, Re
 /**
  * Union type for segment decorators
  */
-export type ContentModelDecorator = ContentModelLink | ContentModelCode | ContentModelListLevel;
+export type ContentModelDecorator = ContentModelLink | ContentModelCode | ContentModelData | ContentModelListLevel;
 
 /**
  * Union type for segment decorators (Readonly)
  */
-export type ReadonlyContentModelDecorator = ReadonlyContentModelLink | ReadonlyContentModelCode | ReadonlyContentModelListLevel;
+export type ReadonlyContentModelDecorator = ReadonlyContentModelLink | ReadonlyContentModelCode | ReadonlyContentModelData | ReadonlyContentModelListLevel;
 
 /**
  * Content Model of List Level
@@ -3047,6 +3098,10 @@ export interface DomToModelDecoratorContext {
      * Context of code info
      */
     code: ContentModelCode;
+    /**
+     * Context of data info, used by HTML &lt;data&gt; element
+     */
+    data: ContentModelData;
     /**
      * Context for paragraph decorator
      */
@@ -7362,9 +7417,10 @@ export function createTableCell(spanLeftOrColSpan?: boolean | number, spanAboveO
  * @param text Text of this model
  * @param format @optional The format of this model
  * @param link @optional The link decorator
- * @param code @option The code decorator
+ * @param code @optional The code decorator
+ * @param data @optional The data decorator
  */
-export function createText(text: string, format?: Readonly<ContentModelSegmentFormat>, link?: ReadonlyContentModelLink, code?: ReadonlyContentModelCode): ContentModelText;
+export function createText(text: string, format?: Readonly<ContentModelSegmentFormat>, link?: ReadonlyContentModelLink, code?: ReadonlyContentModelCode, data?: ReadonlyContentModelData): ContentModelText;
 
 /**
  * Create a ContentModelImage model
@@ -7871,7 +7927,7 @@ export function normalizeFontFamily(fontFamily: string): string;
  * @param allowedCustomPasteType Allowed custom content type when paste besides text/plain, text/html and images
     Only text types are supported, and do not add "text/" prefix to the type values
  */
-export function extractClipboardItems(items: DataTransferItem[], allowedCustomPasteType?: string[]): Promise<ClipboardData>;
+export function extractClipboardItems(items: DataTransferItem[], allowedCustomPasteType?: string[], isPasteNative?: boolean): Promise<ClipboardData>;
 
 /**
  * Gets the cached event data by cache key from event object if there is already one.
@@ -8108,6 +8164,13 @@ export function setSelection(group: ReadonlyContentModelBlockGroup, start?: Read
  */
 export function cloneModel(model: ReadonlyContentModelDocument, options?: CloneModelOptions): ContentModelDocument;
 
+/**
+ * Clone a content model for paste operations, ensuring that cached elements are handled appropriately.
+ * @param model The content model to clone
+ * @returns A cloned content model suitable for paste operations
+ */
+export function cloneModelForPaste(model: ReadonlyContentModelDocument): ContentModelDocument;
+
 /**
  * Merge source model into target mode
  * @param target Target Content Model that will merge content into
@@ -11042,5 +11105,10 @@ export interface MarkdownPasteOptions {
      * @default false
      */
     autoConversion: boolean;
+    /**
+     * When true, the plugin will undo the markdown conversion when the user undoes the action.
+     * @default false
+     */
+    undoConversion: boolean;
 }