roosterjs 9.34.0 → 9.35.0

package/dist/rooster-amd.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 9.34.0)
+// Type definitions for roosterjs (Version 9.35.0)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -4283,13 +4283,13 @@ export interface CachePluginState {
      */
     paragraphMap?: ParagraphMap & ParagraphIndexer;
     /**
-     * @optional Indexer for CachePlugin, to help build backward relationship from DOM node to Content Model
+     * Indexer for CachePlugin, to help build backward relationship from DOM node to Content Model
      */
-    domIndexer?: DomIndexer;
+    domIndexer: DomIndexer;
     /**
-     * @optional A wrapper of MutationObserver to help detect text changes in editor
+     * A wrapper of MutationObserver to help detect text changes in editor
      */
-    textMutationObserver?: TextMutationObserver;
+    textMutationObserver: TextMutationObserver;
 }
 
 /**
@@ -6092,7 +6092,11 @@ export interface ContentChangedEvent extends BasePluginEvent<'contentChanged'> {
      */
     readonly formatApiName?: string;
     /**
-     * @deprecated Call editor.announce(announceData) directly insteaad
+     * When set to true, the change will not be added to the undo stack
+     */
+    readonly skipUndo?: boolean;
+    /**
+     * @deprecated Call editor.announce(announceData) directly instead
      */
     readonly announceData?: AnnounceData;
 }
@@ -7489,8 +7493,9 @@ export function getFirstSelectedTable(model: ReadonlyContentModelDocument): [Rea
  * @param blockGroupTypes The expected block group types
  * @param stopTypes Block group types that will stop searching when hit
  * @param deepFirst True means search in deep first, otherwise wide first
+ * @param isValidTarget @optional An additional callback to validate whether a matching block group is a valid target
  */
-export function getOperationalBlocks<T extends ContentModelBlockGroup>(group: ContentModelBlockGroup, blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes: ContentModelBlockGroupType[], deepFirst?: boolean): OperationalBlocks<T>[];
+export function getOperationalBlocks<T extends ContentModelBlockGroup>(group: ContentModelBlockGroup, blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes: ContentModelBlockGroupType[], deepFirst?: boolean, isValidTarget?: (block: ReadonlyContentModelBlockGroup) => boolean): OperationalBlocks<T>[];
 
 /**
  * Get an array of block group - block pair that is of the expected block group type from selection (Readonly)
@@ -7498,8 +7503,9 @@ export function getOperationalBlocks<T extends ContentModelBlockGroup>(group: Co
  * @param blockGroupTypes The expected block group types
  * @param stopTypes Block group types that will stop searching when hit
  * @param deepFirst True means search in deep first, otherwise wide first
+ * @param isValidTarget @optional An additional callback to validate whether a matching block group is a valid target
  */
-export function getOperationalBlocks<T extends ReadonlyContentModelBlockGroup>(group: ReadonlyContentModelBlockGroup, blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes: ContentModelBlockGroupType[], deepFirst?: boolean): ReadonlyOperationalBlocks<T>[];
+export function getOperationalBlocks<T extends ReadonlyContentModelBlockGroup>(group: ReadonlyContentModelBlockGroup, blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes: ContentModelBlockGroupType[], deepFirst?: boolean, isValidTarget?: (block: ReadonlyContentModelBlockGroup) => boolean): ReadonlyOperationalBlocks<T>[];
 
 /**
  * Get any array of selected paragraphs from a content model
@@ -7736,8 +7742,9 @@ export function getSegmentTextFormat(segment: ReadonlyContentModelSegment, inclu
  * @param path The block group path, from the closest one to root
  * @param blockGroupTypes The expected block group types
  * @param stopTypes @optional Block group types that will cause stop searching
+ * @param isValidTarget @optional An additional callback to validate whether a matching block group is a valid target
  */
-export function getClosestAncestorBlockGroupIndex<T extends ContentModelBlockGroup>(path: ReadonlyContentModelBlockGroup[], blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes?: ContentModelBlockGroupType[]): number;
+export function getClosestAncestorBlockGroupIndex<T extends ContentModelBlockGroup>(path: ReadonlyContentModelBlockGroup[], blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes?: ContentModelBlockGroupType[], isValidTarget?: (block: ReadonlyContentModelBlockGroup) => boolean): number;
 
 /**
  * Run editing steps on top of a given context object which includes current insert point and previous editing result
@@ -10057,13 +10064,20 @@ export function getDarkColor(color: string, baseLValue?: number): string;
 
 /**
  * Convert the whole content to ContentModel with the given plain text
- * @param editor The editor instance
  * @param text The markdown text
  * @param splitLinesPattern The pattern to split lines. Default is /\r\n|\r|\\n|\n/
  * @returns The ContentModelDocument
  */
 export function convertMarkdownToContentModel(text: string, splitLinesPattern?: string): ContentModelDocument;
 
+/**
+ * Convert the whole content to ContentModel with the given plain text
+ * @param text The markdown text
+ * @param options The markdown options
+ * @returns The ContentModelDocument
+ */
+export function convertMarkdownToContentModel(text: string, options?: MarkdownToModelOptions): ContentModelDocument;
+
 /**
  * Export content model document to markdown
  * @param selection The editor selection
@@ -10080,3 +10094,21 @@ export interface MarkdownLineBreaks {
     lineBreak: string;
 }
 
+/**
+ * Options for processing markdown text.
+ */
+export interface MarkdownToModelOptions {
+    /**
+     * The pattern to split lines in the markdown text.
+     */
+    splitLinesPattern?: string;
+    /**
+     * Specify how should we process empty lines in the markdown text.
+     * - 'preserve': Keep empty lines as they are.
+     * - 'remove': Remove empty lines.
+     * - 'merge': Merge empty lines with adjacent paragraphs.
+     * @default 'merge'
+     */
+    emptyLine?: 'preserve' | 'remove' | 'merge';
+}
+