roosterjs 9.26.0 → 9.29.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.29.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
  */
@@ -3160,6 +3174,11 @@ export interface DomIndexer {
      * Node1 will become "FooBar", Node2 will be removed from DOM tree
      */
     onMergeText: (targetText: Text, sourceText: Text) => void;
+    /**
+     * Clear index from the given container and all its descendants
+     * @param container The root container to clear index from
+     */
+    clearIndex: (container: Node) => void;
     /**
      * When document content or selection is changed by user, we need to use this function to update the content model
      * to reflect the latest document. This process can fail since the selected node may not have a related model data structure.
@@ -3589,9 +3608,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 +4879,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 +5334,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;
 }
 
 /**
@@ -6924,7 +6961,7 @@ export function isGeneralSegment(group: ReadonlyContentModelBlockGroup | Readonl
  * @param parent Parent block group of the unwrapping group
  * @param groupToUnwrap  The block group to unwrap
  */
-export function unwrapBlock(parent: ReadonlyContentModelBlockGroup | null, groupToUnwrap: ReadonlyContentModelBlockGroup & ReadonlyContentModelBlock): void;
+export function unwrapBlock(parent: ReadonlyContentModelBlockGroup | null, groupToUnwrap: ReadonlyContentModelBlockGroup & ReadonlyContentModelBlock, formatsToKeep?: (keyof ContentModelBlockFormat)[]): void;
 
 /**
  * Add a given segment into a paragraph from its parent group. If the last block of the given group is not paragraph, create a new paragraph.
@@ -6963,12 +7000,49 @@ 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
  */
 export function setParagraphNotImplicit(block: ReadonlyContentModelBlock): void;
 
+/**
+ * Copy formats from source to target with only specified keys
+ * @param targetFormat The format object to copy format to
+ * @param sourceFormat The format object to copy format from
+ * @param formatKeys The format keys to copy
+ * @param deleteOriginalFormat True to delete the original format from sourceFormat, false to keep it. @default false
+ */
+export function copyFormat<T extends ContentModelFormatBase>(targetFormat: T, sourceFormat: T, formatKeys: (keyof T)[], deleteOriginalFormat?: boolean): void;
+
+/**
+ * When copy format from one block to another, these are all the formats that we can copy
+ */
+export const ListFormats: (keyof ContentModelBlockFormat)[];
+
+/**
+ * When copy format between list and paragraph, these are the formats that we can copy and keep in the source
+ */
+export const ListFormatsToKeep: (keyof ContentModelBlockFormat)[];
+
+/**
+ * When copy format between list and paragraph, these are the formats that we can copy and remove from the source
+ */
+export const ListFormatsToMove: (keyof ContentModelBlockFormat)[];
+
+/**
+ * When copy format between paragraphs, these are the formats that we can copy
+ */
+export const ParagraphFormats: (keyof ContentModelBlockFormat)[];
+
 /**
  * Get the list number for a list item according to list style type and its index number
  * @param styleType The list style number, should be a value of NumberingListType type
@@ -7187,6 +7261,14 @@ export function readFile(file: File, callback: (dataUrl: string | null) => void)
  */
 export function transformColor(rootNode: Node, includeSelf: boolean, direction: 'lightToDark' | 'darkToLight', darkColorHandler?: DarkColorHandler): void;
 
+/**
+ * Normalize font family string to a standard format
+ * Add quotes around font family names that contain non-alphanumeric/dash characters
+ * @param fontFamily The font family string to normalize
+ * @returns The normalized font family string
+ */
+export function normalizeFontFamily(fontFamily: string): string;
+
 /**
  * Extract clipboard items to be a ClipboardData object for IE
  * @param items The clipboard items retrieve from a DataTransfer object
@@ -7214,6 +7296,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 +7784,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
      */
@@ -8496,6 +8600,14 @@ export function insertTableColumn(table: ShallowMutableContentModelTable, operat
  */
 export function clearSelectedCells(table: ReadonlyContentModelTable, sel: TableSelectionCoordinates): void;
 
+/**
+ * Create an EditorContext for an entity
+ * @param editor The editor object
+ * @param entity The entity to create the context for
+ * @returns The generated EditorContext for the entity
+ */
+export function createEditorContextForEntity(editor: IEditor, entity: ContentModelEntity): EditorContext;
+
 /**
  * Invoke a callback to format the selected table using Content Model
  * @param editor The editor object
@@ -8631,8 +8743,9 @@ export function getListAnnounceData(path: ReadonlyContentModelBlockGroup[]): Ann
  * @param type The type of block to query
  * @param filter Optional selector to filter the blocks
  * @param findFirstOnly True to return the first block only, false to return all blocks
+ * @param shouldExpandEntity Optional function to determine if an entity's children should be recursively queried, should return a EditorContext if the entity should be expanded, or null if not
  */
-export function queryContentModelBlocks<T extends ReadonlyContentModelBlock>(group: ReadonlyContentModelBlockGroup, type: T extends ReadonlyContentModelBlockBase<infer U> ? U : never, filter?: (element: T) => element is T, findFirstOnly?: boolean): T[];
+export function queryContentModelBlocks<T extends ReadonlyContentModelBlock>(group: ReadonlyContentModelBlockGroup, type: T extends ReadonlyContentModelBlockBase<infer U> ? U : never, filter?: (element: T) => element is T, findFirstOnly?: boolean, shouldExpandEntity?: (entity: ContentModelEntity) => EditorContext | null): T[];
 
 /**
  * TableEdit plugin, provides the ability to resize a table by drag-and-drop
@@ -8641,6 +8754,7 @@ export class TableEditPlugin implements EditorPlugin  {
     private anchorContainerSelector?;
     private onTableEditorCreated?;
     private disableFeatures?;
+    private tableSelector;
     private editor;
     private onMouseMoveDisposer;
     private tableRectMap;
@@ -8652,8 +8766,9 @@ export class TableEditPlugin implements EditorPlugin  {
      * If not specified, the plugin will be inserted in document.body
      * @param onTableEditorCreated An optional callback to customize the Table Editors elements when created.
      * @param disableFeatures An optional array of TableEditFeatures to disable
+     * @param tableSelector A function to select the tables to be edited. By default, it selects all contentEditable tables.
      */
-    constructor(anchorContainerSelector?: string | undefined, onTableEditorCreated?: OnTableEditorCreatedCallback | undefined, disableFeatures?: TableEditFeatureName[] | undefined);
+    constructor(anchorContainerSelector?: string | undefined, onTableEditorCreated?: OnTableEditorCreatedCallback | undefined, disableFeatures?: TableEditFeatureName[] | undefined, tableSelector?: (domHelper: DOMHelper) => TableWithRoot[]);
     /**
      * Get a friendly name of this plugin
      */
@@ -8676,10 +8791,10 @@ export class TableEditPlugin implements EditorPlugin  {
     private onMouseMove;
     /**
      * @internal Public only for unit test
-     * @param table Table to use when setting the Editors
+     * @param entry Table to use when setting the Editors
      * @param event (Optional) Mouse event
      */
-    setTableEditor(table: HTMLTableElement | null, event?: MouseEvent): void;
+    setTableEditor(entry: TableWithRoot | null, event?: MouseEvent): void;
     private invalidateTableRects;
     private disposeTableEditor;
     private ensureTableRects;
@@ -8695,6 +8810,22 @@ export type OnTableEditorCreatedCallback = (featureType: TableEditFeatureName, e
  */
 export type TableEditFeatureName = 'HorizontalTableInserter' | 'VerticalTableInserter' | 'TableMover' | 'TableResizer' | 'TableSelector' | 'CellResizer';
 
+/**
+ * Represents a table and its container (logical root)
+ */
+export interface TableWithRoot {
+    /**
+     * The table element
+     */
+    table: HTMLTableElement;
+    /**
+     * The logical root element of the table
+     * This is the element that contains the table and all its ancestors
+     * It is used to determine the logical root of the table
+     */
+    logicalRoot: HTMLDivElement | null;
+}
+
 /**
  * Paste plugin, handles BeforePaste event and reformat some special content, including:
  * 1. Content copied from Word
@@ -8763,6 +8894,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 +8946,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 +9001,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;
 }