roosterjs 9.52.0 → 9.54.0

package/dist/rooster-amd.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 9.52.0)
+// Type definitions for roosterjs (Version 9.54.0)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -1511,7 +1511,11 @@ export type PasteType = /**
 /**
  * If there is a image uri in the clipboard, paste the content as image element
  */
- | 'asImage';
+ | 'asImage'
+/**
+ * If the editor includes a markdown plugin @see MarkdownPastePlugin, and there is markdown content in the clipboard, paste it as markdown
+ */
+ | 'asMarkdown';
 
 /**
  * All Border operations
@@ -2883,6 +2887,13 @@ export interface DomToModelSettings {
      * If true elements that has display:none style will be processed
      */
     processNonVisibleElements?: boolean;
+    /**
+     * When set to true, if a container element could be represented by a FormatContainer, always keep the
+     * FormatContainer and never fall back to a paragraph, even when it only has a single child.
+     * Set this when the intermediate FormatContainer is persisted during DOM to Content Model conversion
+     * and is later used during formatting.
+     */
+    skipFormatContainerFallbackCheck?: boolean;
 }
 
 /**
@@ -3303,6 +3314,13 @@ export interface DomToModelOptionForCreateModel extends DomToModelOption  {
      * When this option is passed, "tryGetFromCache" will be ignored.
      */
     recalculateTableSize?: boolean | 'all' | 'selected' | 'none';
+    /**
+     * When set to true, if a container element could be represented by a FormatContainer, always keep the
+     * FormatContainer and never fall back to a paragraph, even when it only has a single child.
+     * Set this when the intermediate FormatContainer is persisted during DOM to Content Model conversion
+     * and is later used during formatting.
+     */
+    skipFormatContainerFallbackCheck?: boolean;
 }
 
 /**
@@ -3412,6 +3430,14 @@ export interface DomIndexer {
      * @returns True if successfully updated, otherwise false
      */
     reconcileElementId: (element: HTMLElement) => boolean;
+    /**
+     * When src or a data-* attribute is changed on an indexed IMG element, update the related
+     * ContentModelImage (src property or dataset) so the cached model stays valid.
+     * @param element The element that has an attribute changed
+     * @param attributeName The name of the changed attribute
+     * @returns True if successfully updated, otherwise false
+     */
+    reconcileImageAttribute: (element: HTMLElement, attributeName: string) => boolean;
     /**
      * When child list of editor content is changed, we can use this method to do sync the change from editor into content model.
      * This is mostly used when user start to type in an empty line. In that case browser will remove the existing BR node in the empty line if any,
@@ -3827,7 +3853,19 @@ export type ExperimentalFeature = GraduatedExperimentalFeature
 /**
  * Transform the table border colors when switching from light to dark mode
  */
- | 'TransformTableBorderColors';
+ | 'TransformTableBorderColors'
+/**
+ * When the editor content div is inside a Shadow DOM, enable shadow root detection
+ * in DOMHelper so that selection, focus, and element appending work correctly within
+ * the shadow boundary.
+ */
+ | 'ShadowDom'
+/**
+ * Strip invisible unicode characters (U+E0000 to U+EFFFF) from text segments during DOM to Model conversion.
+ * These characters can be used to hide text in HTML and may cause unexpected behavior.
+ * @see https://embracethered.com/blog/posts/2024/hiding-and-finding-text-with-unicode-tags/
+ */
+ | 'FilterInvisibleUnicode';
 
 /**
  * Predefined experiment features (Graduated, only keep them for backward compatibility)
@@ -5804,6 +5842,22 @@ export interface DOMHelper {
      * @returns An array of Ranges that match the search criteria
      */
     getRangesByText(text: string, matchCase: boolean, wholeWord: boolean): Range[];
+    /**
+     * Get the current selection range, handling shadow DOM StaticRange conversion.
+     * Returns a live Range in all browsers.
+     */
+    getSelectionRange(): Range | null;
+    /**
+     * Set the selection to the given range, handling browser differences for shadow DOM.
+     * @param range The range to set
+     * @param isReverted Whether the selection is reverted (focus before anchor)
+     */
+    setSelectionRange(range: Range, isReverted?: boolean): void;
+    /**
+     * Append an element to the correct root container (shadow root or document.body)
+     * @param element The element to append
+     */
+    appendToRoot(element: HTMLElement): void;
 }
 
 /**
@@ -6307,7 +6361,7 @@ export interface BeforePasteEvent extends BasePluginEvent<'beforePaste'> {
      */
     readonly htmlAttributes: Record<string, string>;
     /**
-     * Paste type option (as plain text, merge format, normal, as image)
+     * Paste type option (as plain text, merge format, normal, as image, asMarkdown (@see MarkdownPastePlugin ))
      */
     readonly pasteType: PasteType;
     /**
@@ -7639,7 +7693,7 @@ export function createDomToModelContext(editorContext?: EditorContext, ...option
  * @param config A full config object to define how to convert DOM tree to Content Model
  * @param editorContext Context of editor
  */
-export function createDomToModelContextWithConfig(config: DomToModelSettings, editorContext?: EditorContext): any;
+export function createDomToModelContextWithConfig(config: DomToModelSettings, editorContext?: EditorContext): DomToModelContext;
 
 /**
  * Create Dom to Content Model Config object
@@ -10890,6 +10944,23 @@ export function convertMarkdownToContentModel(text: string, options?: MarkdownTo
  */
 export function convertContentModelToMarkdown(model: ContentModelDocument, newLine?: MarkdownLineBreaks): string;
 
+/**
+ * Detect whether the given plain text contains any markdown markup.
+ * Recognizes block-level patterns (headings, blockquotes, lists, horizontal rules, tables)
+ * and inline patterns (bold, italic, strikethrough, links, images).
+ * @param text The plain text to check.
+ * @returns True if the text contains any markdown markup, false otherwise.
+ */
+export function isContentMarkdown(text: string): boolean;
+
+/**
+ * Detect whether the given clipboard content can be interpreted as markdown.
+ * @param editor The editor instance.
+ * @param clipboardData The clipboard data to check.
+ * @returns True if the content can be interpreted as markdown, false otherwise.
+ */
+export function isPastedContentMarkdown(editor: IEditor, clipboardData: ClipboardData): boolean;
+
 /**
  * The characters to add line breaks and new lines
  */
@@ -10921,3 +10992,55 @@ export interface MarkdownToModelOptions {
     direction?: 'ltr' | 'rtl' | undefined;
 }
 
+/**
+ * Markdown paste plugin. Handles the BeforePaste event and, when the pasted content
+ * can be interpreted as markdown, converts the plain text into a Content Model and
+ * pastes it as rich markdown content instead of the original clipboard HTML.
+ */
+export class MarkdownPastePlugin implements EditorPlugin  {
+    private editor;
+    private options;
+    /**
+     * Construct a new instance of MarkdownPastePlugin
+     * @param options Options to control the markdown paste behavior
+     */
+    constructor(options?: MarkdownPasteOptions);
+    /**
+     * Get name of this plugin
+     */
+    getName(): string;
+    /**
+     * The first method that editor will call to a plugin when editor is initializing.
+     * It will pass in the editor instance, plugin should take this chance to save the
+     * editor reference so that it can call to any editor method or format API later.
+     * @param editor The editor object
+     */
+    initialize(editor: IEditor): void;
+    /**
+     * The last method that editor will call to a plugin before it is disposed.
+     * Plugin can take this chance to clear the reference to editor. After this method is
+     * called, plugin should not call to any editor method since it will result in error.
+     */
+    dispose(): void;
+    /**
+     * Core method for a plugin. Once an event happens in editor, editor will call this
+     * method of each plugin to handle the event as long as the event is not handled
+     * exclusively by another plugin.
+     * @param event The event to handle:
+     */
+    onPluginEvent(event: PluginEvent): void;
+}
+
+/**
+ * Options for MarkdownPastePlugin
+ */
+export interface MarkdownPasteOptions {
+    /**
+     * When true, content that can be interpreted as markdown is automatically converted
+     * into rich content on every paste, without requiring an explicit "Paste as Markdown"
+     * command.
+     * @default false
+     */
+    autoConversion: boolean;
+}
+