roosterjs 9.3.1 → 9.4.1

package/dist/rooster.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 9.3.1)
+// Type definitions for roosterjs (Version 9.4.1)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -28,6 +28,16 @@ interface ContentModelWithFormat<T extends ContentModelFormatBase> {
     format: T;
 }
 
+    /**
+ * Represent a content model with format (Readonly)
+ */
+interface ReadonlyContentModelWithFormat<T extends ContentModelFormatBase> {
+    /**
+     * Format of this model
+     */
+    readonly format: Readonly<T>;
+}
+
     /**
  * Format of Table
  */
@@ -36,12 +46,32 @@ type ContentModelTableFormat = ContentModelBlockFormat & IdFormat & BorderFormat
     /**
  * Represents base format of an element that supports dataset and/or metadata
  */
-interface ContentModelWithDataset<T> {
+type ContentModelWithDataset<T> = MutableMark & {
     /**
      * dataset of this element
      */
     dataset: DatasetFormat;
-}
+};
+
+    /**
+ * Represents base format of an element that supports dataset and/or metadata (Readonly)
+ */
+type ReadonlyContentModelWithDataset<T> = ReadonlyMark & {
+    /**
+     * dataset of this element
+     */
+    readonly dataset: ReadonlyDatasetFormat;
+};
+
+    /**
+ * Represents base format of an element that supports dataset and/or metadata (Readonly)
+ */
+type ShallowMutableContentModelWithDataset<T> = ShallowMutableMark & {
+    /**
+     * dataset of this element
+     */
+    dataset: DatasetFormat;
+};
 
     /**
  * The format object for a paragraph in Content Model
@@ -833,6 +863,11 @@ type EntityInfoFormat = {
  */
 type DatasetFormat = Record<string, string>;
 
+    /**
+ * Represents dataset format of Content Model (Readonly)
+ */
+type ReadonlyDatasetFormat = Readonly<Record<string, string>>;
+
     /**
  * Format of table that stored as metadata
  */
@@ -1377,10 +1412,20 @@ type ExportContentMode = /**
  */
 type ContentModelBlock = ContentModelFormatContainer | ContentModelListItem | ContentModelGeneralBlock | ContentModelTable | ContentModelParagraph | ContentModelEntity | ContentModelDivider;
 
+    /**
+ * A union type of Content Model Block (Readonly)
+ */
+type ReadonlyContentModelBlock = ReadonlyContentModelFormatContainer | ReadonlyContentModelListItem | ReadonlyContentModelGeneralBlock | ReadonlyContentModelTable | ReadonlyContentModelParagraph | ContentModelEntity | ReadonlyContentModelDivider;
+
+    /**
+ * A union type of Content Model Block (Shallow mutable)
+ */
+type ShallowMutableContentModelBlock = ShallowMutableContentModelFormatContainer | ShallowMutableContentModelListItem | ShallowMutableContentModelGeneralBlock | ShallowMutableContentModelTable | ShallowMutableContentModelParagraph | ContentModelEntity | ContentModelDivider;
+
     /**
  * Content Model of Paragraph
  */
-interface ContentModelParagraph extends ContentModelBlockWithCache, ContentModelBlockBase<'Paragraph'> {
+interface ContentModelParagraph extends ContentModelParagraphCommon, ContentModelBlockBase<'Paragraph'> {
     /**
      * Segments within this paragraph
      */
@@ -1393,6 +1438,12 @@ interface ContentModelParagraph extends ContentModelBlockWithCache, ContentModel
      * Decorator info for this paragraph, used by heading and P tags
      */
     decorator?: ContentModelParagraphDecorator;
+}
+
+    /**
+ * Common part of Content Model of Paragraph
+ */
+interface ContentModelParagraphCommon {
     /**
      * Whether this block was created from a block HTML element or just some simple segment between other block elements.
      * True means it doesn't have a related block element, false means it was from a block element
@@ -1400,10 +1451,46 @@ interface ContentModelParagraph extends ContentModelBlockWithCache, ContentModel
     isImplicit?: boolean;
 }
 
+    /**
+ * Content Model of Paragraph (Readonly)
+ */
+interface ReadonlyContentModelParagraph extends ReadonlyContentModelBlockBase<'Paragraph'>, Readonly<ContentModelParagraphCommon> {
+    /**
+     * Segments within this paragraph
+     */
+    readonly segments: ReadonlyArray<ReadonlyContentModelSegment>;
+    /**
+     * Segment format on this paragraph. This is mostly used for default format
+     */
+    readonly segmentFormat?: Readonly<ContentModelSegmentFormat>;
+    /**
+     * Decorator info for this paragraph, used by heading and P tags
+     */
+    readonly decorator?: ReadonlyContentModelParagraphDecorator;
+}
+
+    /**
+ * Content Model of Paragraph (Shallow mutable)
+ */
+interface ShallowMutableContentModelParagraph extends ContentModelParagraphCommon, ContentModelBlockBase<'Paragraph'> {
+    /**
+     * Segments within this paragraph
+     */
+    segments: ShallowMutableContentModelSegment[];
+    /**
+     * Segment format on this paragraph. This is mostly used for default format
+     */
+    segmentFormat?: ContentModelSegmentFormat;
+    /**
+     * Decorator info for this paragraph, used by heading and P tags
+     */
+    decorator?: ContentModelParagraphDecorator;
+}
+
     /**
  * Content Model of Table
  */
-interface ContentModelTable extends ContentModelBlockBase<'Table', ContentModelTableFormat>, ContentModelWithDataset<TableMetadataFormat>, ContentModelBlockWithCache<HTMLTableElement> {
+interface ContentModelTable extends ContentModelBlockBase<'Table', ContentModelTableFormat, HTMLTableElement>, ContentModelWithDataset<TableMetadataFormat> {
     /**
      * Widths of each column
      */
@@ -1414,10 +1501,44 @@ interface ContentModelTable extends ContentModelBlockBase<'Table', ContentModelT
     rows: ContentModelTableRow[];
 }
 
+    /**
+ * Content Model of Table (Readonly)
+ */
+interface ReadonlyContentModelTable extends ReadonlyContentModelBlockBase<'Table', ContentModelTableFormat, HTMLTableElement>, ReadonlyContentModelWithDataset<TableMetadataFormat> {
+    /**
+     * Widths of each column
+     */
+    readonly widths: ReadonlyArray<number>;
+    /**
+     * Cells of this table
+     */
+    readonly rows: ReadonlyArray<ReadonlyContentModelTableRow>;
+}
+
+    /**
+ * Content Model of Table (Shallow mutable)
+ */
+interface ShallowMutableContentModelTable extends ShallowMutableContentModelBlockBase<'Table', ContentModelTableFormat, HTMLTableElement>, ShallowMutableContentModelWithDataset<TableMetadataFormat> {
+    /**
+     * Widths of each column
+     */
+    widths: number[];
+    /**
+     * Cells of this table
+     */
+    rows: ShallowMutableContentModelTableRow[];
+}
+
     /**
  * Content Model of horizontal divider
  */
-interface ContentModelDivider extends Selectable, ContentModelBlockWithCache, ContentModelBlockBase<'Divider', ContentModelDividerFormat> {
+interface ContentModelDivider extends Selectable, ContentModelDividerCommon, ContentModelBlockBase<'Divider', ContentModelDividerFormat> {
+}
+
+    /**
+ * Common part of Content Model of horizontal divider
+ */
+interface ContentModelDividerCommon {
     /**
      * Tag name of this element, either HR or DIV
      */
@@ -1428,14 +1549,38 @@ interface ContentModelDivider extends Selectable, ContentModelBlockWithCache, Co
     size?: string;
 }
 
+    /**
+ * Content Model of horizontal divider (Readonly)
+ */
+interface ReadonlyContentModelDivider extends ReadonlySelectable, ReadonlyContentModelBlockBase<'Divider', ContentModelDividerFormat>, Readonly<ContentModelDividerCommon> {
+}
+
     /**
  * Base type of a block
  */
-interface ContentModelBlockBase<T extends ContentModelBlockType, TFormat extends ContentModelBlockFormat = ContentModelBlockFormat> extends ContentModelWithFormat<TFormat> {
+interface ContentModelBlockBase<T extends ContentModelBlockType, TFormat extends ContentModelBlockFormat = ContentModelBlockFormat, TCacheElement extends HTMLElement = HTMLElement> extends MutableMark, ContentModelBlockBaseCommon<T>, ContentModelWithFormat<TFormat>, ContentModelBlockWithCache<TCacheElement> {
+}
+
+    /**
+ * Common part of base type of a block
+ */
+interface ContentModelBlockBaseCommon<T extends ContentModelBlockType> {
     /**
      * Type of this block
      */
-    blockType: T;
+    readonly blockType: T;
+}
+
+    /**
+ * Base type of a block (Readonly)
+ */
+interface ReadonlyContentModelBlockBase<T extends ContentModelBlockType, TFormat extends ContentModelBlockFormat = ContentModelBlockFormat, TCacheElement extends HTMLElement = HTMLElement> extends ReadonlyMark, ContentModelBlockBaseCommon<T>, ReadonlyContentModelWithFormat<TFormat>, ContentModelBlockWithCache<TCacheElement> {
+}
+
+    /**
+ * Base type of a block (Shallow mutable)
+ */
+interface ShallowMutableContentModelBlockBase<T extends ContentModelBlockType, TFormat extends ContentModelBlockFormat = ContentModelBlockFormat, TCacheElement extends HTMLElement = HTMLElement> extends ShallowMutableMark, ContentModelBlockBaseCommon<T>, ContentModelWithFormat<TFormat>, ContentModelBlockWithCache<TCacheElement> {
 }
 
     /**
@@ -1451,15 +1596,41 @@ interface ContentModelBlockWithCache<TElement extends HTMLElement = HTMLElement>
     /**
  * Content Model of Table
  */
-interface ContentModelTableRow extends ContentModelBlockWithCache<HTMLTableRowElement>, ContentModelWithFormat<ContentModelBlockFormat> {
+interface ContentModelTableRow extends MutableMark, ContentModelTableRowCommon, ContentModelBlockWithCache<HTMLTableRowElement>, ContentModelWithFormat<ContentModelBlockFormat> {
+    /**
+     * Cells of this table
+     */
+    cells: ContentModelTableCell[];
+}
+
+    /**
+ * Common part of Content Model of Table
+ */
+interface ContentModelTableRowCommon {
     /**
      * Heights of each row
      */
     height: number;
+}
+
+    /**
+ * Content Model of Table (Readonly)
+ */
+interface ReadonlyContentModelTableRow extends ReadonlyMark, Readonly<ContentModelTableRowCommon>, ContentModelBlockWithCache<HTMLTableRowElement>, ReadonlyContentModelWithFormat<ContentModelBlockFormat> {
     /**
      * Cells of this table
      */
-    cells: ContentModelTableCell[];
+    readonly cells: ReadonlyArray<ReadonlyContentModelTableCell>;
+}
+
+    /**
+ * Content Model of Table (Readonly)
+ */
+interface ShallowMutableContentModelTableRow extends ShallowMutableMark, ContentModelTableRowCommon, ContentModelBlockWithCache<HTMLTableRowElement>, ContentModelWithFormat<ContentModelBlockFormat> {
+    /**
+     * Cells of this table
+     */
+    cells: ReadonlyContentModelTableCell[];
 }
 
     /**
@@ -1479,31 +1650,81 @@ interface ContentModelEntity extends ContentModelBlockBase<'Entity', ContentMode
     /**
  * Content Model document entry point
  */
-interface ContentModelDocument extends ContentModelBlockGroupBase<'Document'>, Partial<ContentModelWithFormat<ContentModelSegmentFormat>> {
+interface ContentModelDocument extends ContentModelDocumentCommon, ContentModelBlockGroupBase<'Document'>, Partial<ContentModelWithFormat<ContentModelSegmentFormat>> {
+}
+
+    /**
+ * Common part of Content Model document entry point
+ */
+interface ContentModelDocumentCommon {
     /**
      * Whether the selection in model (if any) is a revert selection (end is before start)
      */
     hasRevertedRangeSelection?: boolean;
 }
 
+    /**
+ * Content Model document entry point (Readonly)
+ */
+interface ReadonlyContentModelDocument extends Readonly<ContentModelDocumentCommon>, ReadonlyContentModelBlockGroupBase<'Document'>, Partial<ReadonlyContentModelWithFormat<ContentModelSegmentFormat>> {
+}
+
+    /**
+ * Content Model document entry point (Shallow mutable)
+ */
+interface ShallowMutableContentModelDocument extends ContentModelDocumentCommon, ShallowMutableContentModelBlockGroupBase<'Document'>, Partial<ContentModelWithFormat<ContentModelSegmentFormat>> {
+}
+
     /**
  * Base type of Content Model Block Group
  */
-interface ContentModelBlockGroupBase<T extends ContentModelBlockGroupType> {
+interface ContentModelBlockGroupBase<T extends ContentModelBlockGroupType, TElement extends HTMLElement = HTMLElement> extends MutableMark, ContentModelBlockGroupBaseCommon<T, TElement> {
+    /**
+     * Blocks under this group
+     */
+    blocks: ContentModelBlock[];
+}
+
+    /**
+ * Common part of base type of Content Model Block Group
+ */
+interface ContentModelBlockGroupBaseCommon<T extends ContentModelBlockGroupType, TElement extends HTMLElement = HTMLElement> extends ContentModelBlockWithCache<TElement> {
     /**
      * Type of this block group
      */
-    blockGroupType: T;
+    readonly blockGroupType: T;
+}
+
+    /**
+ * Base type of Content Model Block Group (Readonly)
+ */
+interface ReadonlyContentModelBlockGroupBase<T extends ContentModelBlockGroupType, TElement extends HTMLElement = HTMLElement> extends ReadonlyMark, ContentModelBlockGroupBaseCommon<T, TElement> {
+    /**
+     * Blocks under this group
+     */
+    readonly blocks: ReadonlyArray<ReadonlyContentModelBlock>;
+}
+
+    /**
+ * Base type of Content Model Block Group (Shallow mutable)
+ */
+interface ShallowMutableContentModelBlockGroupBase<T extends ContentModelBlockGroupType, TElement extends HTMLElement = HTMLElement> extends ShallowMutableMark, ContentModelBlockGroupBaseCommon<T, TElement> {
     /**
      * Blocks under this group
      */
-    blocks: ContentModelBlock[];
+    blocks: ReadonlyContentModelBlock[];
 }
 
     /**
  * Content Model of Format Container
  */
-interface ContentModelFormatContainer extends ContentModelBlockWithCache, ContentModelBlockGroupBase<'FormatContainer'>, ContentModelBlockBase<'BlockGroup', ContentModelFormatContainerFormat> {
+interface ContentModelFormatContainer extends ContentModelFormatContainerCommon, ContentModelBlockGroupBase<'FormatContainer'>, ContentModelBlockBase<'BlockGroup', ContentModelFormatContainerFormat, HTMLElement> {
+}
+
+    /**
+ * Common part of Content Model of Format Container
+ */
+interface ContentModelFormatContainerCommon {
     /**
      * Tag name of this container
      */
@@ -1515,20 +1736,78 @@ interface ContentModelFormatContainer extends ContentModelBlockWithCache, Conten
     zeroFontSize?: boolean;
 }
 
+    /**
+ * Content Model of Format Container (Readonly)
+ */
+interface ReadonlyContentModelFormatContainer extends Readonly<ContentModelFormatContainerCommon>, ReadonlyContentModelBlockGroupBase<'FormatContainer'>, ReadonlyContentModelBlockBase<'BlockGroup', ContentModelFormatContainerFormat, HTMLElement> {
+}
+
+    /**
+ * Content Model of Format Container (Shallow mutable)
+ */
+interface ShallowMutableContentModelFormatContainer extends ContentModelFormatContainerCommon, ShallowMutableContentModelBlockGroupBase<'FormatContainer'>, ShallowMutableContentModelBlockBase<'BlockGroup', ContentModelFormatContainerFormat, HTMLElement> {
+}
+
     /**
  * Content Model for general Block element
  */
-interface ContentModelGeneralBlock extends Selectable, ContentModelBlockGroupBase<'General'>, ContentModelBlockBase<'BlockGroup', ContentModelBlockFormat & ContentModelSegmentFormat> {
+interface ContentModelGeneralBlock extends Selectable, ContentModelGeneralBlockCommon, ContentModelBlockGroupBase<'General'>, ContentModelBlockBase<'BlockGroup', ContentModelBlockFormat & ContentModelSegmentFormat> {
+}
+
+    /**
+ * Common part of Content Model for general Block element
+ */
+interface ContentModelGeneralBlockCommon {
     /**
      * A reference to original HTML node that this model was created from
      */
     element: HTMLElement;
 }
 
+    /**
+ * Content Model for general Block element (Readonly)
+ */
+interface ReadonlyContentModelGeneralBlock extends ReadonlySelectable, Readonly<ContentModelGeneralBlockCommon>, ReadonlyContentModelBlockGroupBase<'General'>, ReadonlyContentModelBlockBase<'BlockGroup', ContentModelBlockFormat & ContentModelSegmentFormat> {
+}
+
+    /**
+ * Content Model for general Block element (Shallow mutable)
+ */
+interface ShallowMutableContentModelGeneralBlock extends ShallowMutableSelectable, ContentModelGeneralBlockCommon, ShallowMutableContentModelBlockGroupBase<'General'>, ShallowMutableContentModelBlockBase<'BlockGroup', ContentModelBlockFormat & ContentModelSegmentFormat> {
+}
+
     /**
  * Content Model of List Item
  */
-interface ContentModelListItem extends ContentModelBlockGroupBase<'ListItem'>, ContentModelBlockBase<'BlockGroup', ContentModelListItemFormat> {
+interface ContentModelListItem extends ContentModelBlockGroupBase<'ListItem', HTMLLIElement>, ContentModelBlockBase<'BlockGroup', ContentModelListItemFormat, HTMLLIElement> {
+    /**
+     * Type of this list, either ordered or unordered
+     */
+    levels: ContentModelListLevel[];
+    /**
+     * A dummy segment to hold format of this list item
+     */
+    formatHolder: ContentModelSelectionMarker;
+}
+
+    /**
+ * Content Model of List Item (Readonly)
+ */
+interface ReadonlyContentModelListItem extends ReadonlyContentModelBlockGroupBase<'ListItem', HTMLLIElement>, ReadonlyContentModelBlockBase<'BlockGroup', ContentModelListItemFormat, HTMLLIElement> {
+    /**
+     * Type of this list, either ordered or unordered
+     */
+    readonly levels: ReadonlyArray<ReadonlyContentModelListLevel>;
+    /**
+     * A dummy segment to hold format of this list item
+     */
+    readonly formatHolder: ReadonlyContentModelSelectionMarker;
+}
+
+    /**
+ * Content Model of List Item (Shallow mutable)
+ */
+interface ShallowMutableContentModelListItem extends ShallowMutableContentModelBlockGroupBase<'ListItem', HTMLLIElement>, ShallowMutableContentModelBlockBase<'BlockGroup', ContentModelListItemFormat, HTMLLIElement> {
     /**
      * Type of this list, either ordered or unordered
      */
@@ -1542,7 +1821,13 @@ interface ContentModelListItem extends ContentModelBlockGroupBase<'ListItem'>, C
     /**
  * Content Model of Table Cell
  */
-interface ContentModelTableCell extends Selectable, ContentModelBlockGroupBase<'TableCell'>, ContentModelWithFormat<ContentModelTableCellFormat>, ContentModelWithDataset<TableCellMetadataFormat>, ContentModelBlockWithCache<HTMLTableCellElement> {
+interface ContentModelTableCell extends Selectable, ContentModelTableCellCommon, ContentModelBlockGroupBase<'TableCell', HTMLTableCellElement>, ContentModelWithFormat<ContentModelTableCellFormat>, ContentModelWithDataset<TableCellMetadataFormat> {
+}
+
+    /**
+ * Common part of Content Model of Table Cell
+ */
+interface ContentModelTableCellCommon {
     /**
      * Whether this cell is spanned from left cell
      */
@@ -1557,27 +1842,73 @@ interface ContentModelTableCell extends Selectable, ContentModelBlockGroupBase<'
     isHeader?: boolean;
 }
 
+    /**
+ * Content Model of Table Cell (Readonly)
+ */
+interface ReadonlyContentModelTableCell extends ReadonlySelectable, Readonly<ContentModelTableCellCommon>, ReadonlyContentModelBlockGroupBase<'TableCell', HTMLTableCellElement>, ReadonlyContentModelWithFormat<ContentModelTableCellFormat>, ReadonlyContentModelWithDataset<TableCellMetadataFormat> {
+}
+
+    /**
+ * Content Model of Table Cell (Shallow mutable)
+ */
+interface ShallowMutableContentModelTableCell extends ShallowMutableSelectable, ContentModelTableCellCommon, ShallowMutableContentModelBlockGroupBase<'TableCell', HTMLTableCellElement>, ContentModelWithFormat<ContentModelTableCellFormat>, ShallowMutableContentModelWithDataset<TableCellMetadataFormat> {
+}
+
     /**
  * The union type of Content Model Block Group
  */
 type ContentModelBlockGroup = ContentModelDocument | ContentModelFormatContainer | ContentModelListItem | ContentModelTableCell | ContentModelGeneralBlock;
 
+    /**
+ * The union type of Content Model Block Group (Readonly)
+ */
+type ReadonlyContentModelBlockGroup = ReadonlyContentModelDocument | ReadonlyContentModelFormatContainer | ReadonlyContentModelListItem | ReadonlyContentModelTableCell | ReadonlyContentModelGeneralBlock;
+
+    /**
+ * The union type of Content Model Block Group (Shallow mutable)
+ */
+type ShallowMutableContentModelBlockGroup = ShallowMutableContentModelDocument | ShallowMutableContentModelFormatContainer | ShallowMutableContentModelListItem | ShallowMutableContentModelTableCell | ShallowMutableContentModelGeneralBlock;
+
     /**
  * Content Model of BR
  */
 interface ContentModelBr extends ContentModelSegmentBase<'Br'> {
+}
+
+    /**
+ * Content Model of BR (Readonly)
+ */
+interface ReadonlyContentModelBr extends ReadonlyContentModelSegmentBase<'Br'> {
 }
 
     /**
  * Content Model of general Segment
  */
 interface ContentModelGeneralSegment extends ContentModelGeneralBlock, ContentModelSegmentBase<'General', ContentModelBlockFormat & ContentModelSegmentFormat> {
+}
+
+    /**
+ * Content Model of general Segment (Readonly)
+ */
+interface ReadonlyContentModelGeneralSegment extends ReadonlyContentModelGeneralBlock, ReadonlyContentModelSegmentBase<'General', ContentModelBlockFormat & ContentModelSegmentFormat> {
+}
+
+    /**
+ * Content Model of general Segment (Shallow mutable)
+ */
+interface ShallowMutableContentModelGeneralSegment extends ShallowMutableContentModelGeneralBlock, ShallowMutableContentModelSegmentBase<'General', ContentModelBlockFormat & ContentModelSegmentFormat> {
 }
 
     /**
  * Content Model of IMG
  */
-interface ContentModelImage extends ContentModelSegmentBase<'Image', ContentModelImageFormat>, ContentModelWithDataset<ImageMetadataFormat> {
+interface ContentModelImage extends ContentModelImageCommon, ContentModelSegmentBase<'Image', ContentModelImageFormat>, ContentModelWithDataset<ImageMetadataFormat> {
+}
+
+    /**
+ * Common part of Content Model of IMG
+ */
+interface ContentModelImageCommon {
     /**
      * Image source of this IMG element
      */
@@ -1596,30 +1927,88 @@ interface ContentModelImage extends ContentModelSegmentBase<'Image', ContentMode
     isSelectedAsImageSelection?: boolean;
 }
 
+    /**
+ * Content Model of IMG (Readonly)
+ */
+interface ReadonlyContentModelImage extends ReadonlyContentModelSegmentBase<'Image', ContentModelImageFormat>, ReadonlyContentModelWithDataset<ImageMetadataFormat>, Readonly<ContentModelImageCommon> {
+}
+
     /**
  * Content Model for Text
  */
-interface ContentModelText extends ContentModelSegmentBase<'Text'> {
+interface ContentModelText extends ContentModelTextCommon, ContentModelSegmentBase<'Text'> {
+}
+
+    /**
+ * Common port of Content Model for Text
+ */
+interface ContentModelTextCommon {
+    /**
+     * Text content of this segment
+     */
+    text: string;
+}
+
+    /**
+ * Content Model for Text (Readonly)
+ */
+interface ReadonlyContentModelText extends ReadonlyContentModelSegmentBase<'Text'>, Readonly<ContentModelTextCommon> {
+}
+
+    /**
+ * Content Model of Selection Marker
+ */
+interface ContentModelSelectionMarker extends ContentModelSegmentBase<'SelectionMarker'> {
+}
+
+    /**
+ * Content Model of Selection Marker (Readonly)
+ */
+interface ReadonlyContentModelSelectionMarker extends ReadonlyContentModelSegmentBase<'SelectionMarker'> {
+}
+
+    /**
+ * Base type of Content Model Segment
+ */
+interface ContentModelSegmentBase<T extends ContentModelSegmentType, TFormat extends ContentModelSegmentFormat = ContentModelSegmentFormat> extends MutableMark, Selectable, ContentModelWithFormat<TFormat>, ContentModelSegmentBaseCommon<T> {
+    /**
+     * Hyperlink info
+     */
+    link?: ContentModelLink;
+    /**
+     * Code info
+     */
+    code?: ContentModelCode;
+}
+
+    /**
+ * Common part of base type of Content Model Segment
+ */
+interface ContentModelSegmentBaseCommon<T extends ContentModelSegmentType> {
     /**
-     * Text content of this segment
+     * Type of this segment
      */
-    text: string;
+    readonly segmentType: T;
 }
 
     /**
- * Content Model of Selection Marker
+ * Base type of Content Model Segment (Readonly)
  */
-interface ContentModelSelectionMarker extends ContentModelSegmentBase<'SelectionMarker'> {
+interface ReadonlyContentModelSegmentBase<T extends ContentModelSegmentType, TFormat extends ContentModelSegmentFormat = ContentModelSegmentFormat> extends ReadonlyMark, ReadonlySelectable, ReadonlyContentModelWithFormat<TFormat>, Readonly<ContentModelSegmentBaseCommon<T>> {
+    /**
+     * Hyperlink info
+     */
+    readonly link?: ReadonlyContentModelLink;
+    /**
+     * Code info
+     */
+    readonly code?: ReadonlyContentModelCode;
 }
 
     /**
- * Base type of Content Model Segment
+ * Base type of Content Model Segment (Shallow mutable)
  */
-interface ContentModelSegmentBase<T extends ContentModelSegmentType, TFormat extends ContentModelSegmentFormat = ContentModelSegmentFormat> extends Selectable, ContentModelWithFormat<TFormat> {
-    /**
-     * Type of this segment
-     */
-    segmentType: T;
+interface ShallowMutableContentModelSegmentBase<T extends ContentModelSegmentType, TFormat extends ContentModelSegmentFormat = ContentModelSegmentFormat> extends ShallowMutableMark, ShallowMutableSelectable, ContentModelWithFormat<TFormat>, ContentModelSegmentBaseCommon<T> {
     /**
      * Hyperlink info
      */
@@ -1635,12 +2024,30 @@ interface ContentModelSegmentBase<T extends ContentModelSegmentType, TFormat ext
  */
 type ContentModelSegment = ContentModelSelectionMarker | ContentModelText | ContentModelBr | ContentModelGeneralSegment | ContentModelEntity | ContentModelImage;
 
+    /**
+ * Union type of Content Model Segment (Readonly)
+ */
+type ReadonlyContentModelSegment = ReadonlyContentModelSelectionMarker | ReadonlyContentModelText | ReadonlyContentModelBr | ReadonlyContentModelGeneralSegment | ContentModelEntity | ReadonlyContentModelImage;
+
+    /**
+ * Union type of Content Model Segment (Shallow mutable)
+ */
+type ShallowMutableContentModelSegment = ContentModelSelectionMarker | ContentModelText | ContentModelBr | ShallowMutableContentModelGeneralSegment | ContentModelEntity | ContentModelImage;
+
     /**
  * Represent code info of Content Model.
  * ContentModelCode is a decorator but not a standalone model type, instead it need to be put inside a ContentModelSegment
  * since code is also a kind of segment, with some extra information
  */
-interface ContentModelCode extends ContentModelWithFormat<ContentModelCodeFormat> {
+interface ContentModelCode extends MutableMark, ContentModelWithFormat<ContentModelCodeFormat> {
+}
+
+    /**
+ * Represent code info of Content Model. (Readonly)
+ * ContentModelCode is a decorator but not a standalone model type, instead it need to be put inside a ContentModelSegment
+ * since code is also a kind of segment, with some extra information
+ */
+interface ReadonlyContentModelCode extends ReadonlyMark, ReadonlyContentModelWithFormat<ContentModelCodeFormat> {
 }
 
     /**
@@ -1648,7 +2055,15 @@ interface ContentModelCode extends ContentModelWithFormat<ContentModelCodeFormat
  * ContentModelLink is not a standalone model type, instead it need to be put inside a ContentModelSegment
  * since link is also a kind of segment, with some extra information
  */
-interface ContentModelLink extends ContentModelWithFormat<ContentModelHyperLinkFormat>, ContentModelWithDataset<null> {
+interface ContentModelLink extends MutableMark, ContentModelWithFormat<ContentModelHyperLinkFormat>, ContentModelWithDataset<null> {
+}
+
+    /**
+ * Represent link info of Content Model (Readonly).
+ * ContentModelLink is not a standalone model type, instead it need to be put inside a ContentModelSegment
+ * since link is also a kind of segment, with some extra information
+ */
+interface ReadonlyContentModelLink extends ReadonlyMark, ReadonlyContentModelWithFormat<ContentModelHyperLinkFormat>, ReadonlyContentModelWithDataset<null> {
 }
 
     /**
@@ -1656,38 +2071,144 @@ interface ContentModelLink extends ContentModelWithFormat<ContentModelHyperLinkF
  * A decorator of paragraph can represent a heading, or a P tag that act likes a paragraph but with some extra format info
  * since heading is also a kind of paragraph, with some extra information
  */
-interface ContentModelParagraphDecorator extends ContentModelWithFormat<ContentModelSegmentFormat> {
+interface ContentModelParagraphDecorator extends MutableMark, ContentModelParagraphDecoratorCommon, ContentModelWithFormat<ContentModelSegmentFormat> {
+}
+
+    /**
+ * Common part of decorator for a paragraph in Content Model
+ */
+interface ContentModelParagraphDecoratorCommon {
     /**
      * Tag name of this paragraph
      */
     tagName: string;
 }
 
+    /**
+ * Represent decorator for a paragraph in Content Model (Readonly)
+ * A decorator of paragraph can represent a heading, or a P tag that act likes a paragraph but with some extra format info
+ * since heading is also a kind of paragraph, with some extra information
+ */
+interface ReadonlyContentModelParagraphDecorator extends ReadonlyMark, ReadonlyContentModelWithFormat<ContentModelSegmentFormat>, Readonly<ContentModelParagraphDecoratorCommon> {
+}
+
     /**
  * Union type for segment decorators
  */
 type ContentModelDecorator = ContentModelLink | ContentModelCode | ContentModelListLevel;
 
+    /**
+ * Union type for segment decorators (Readonly)
+ */
+type ReadonlyContentModelDecorator = ReadonlyContentModelLink | ReadonlyContentModelCode | ReadonlyContentModelListLevel;
+
     /**
  * Content Model of List Level
  */
-interface ContentModelListLevel extends ContentModelWithFormat<ContentModelListItemLevelFormat>, ContentModelWithDataset<ListMetadataFormat> {
+interface ContentModelListLevel extends MutableMark, ContentModelBlockWithCache<HTMLOListElement | HTMLUListElement>, ContentModelListLevelCommon, ContentModelWithFormat<ContentModelListItemLevelFormat>, ContentModelWithDataset<ListMetadataFormat> {
+}
+
+    /**
+ * Common part of Content Model of List Level
+ */
+interface ContentModelListLevelCommon {
     /**
      * Type of a list, order (OL) or unordered (UL)
      */
     listType: 'OL' | 'UL';
 }
 
+    /**
+ * Content Model of List Level (Readonly)
+ */
+interface ReadonlyContentModelListLevel extends ReadonlyMark, ContentModelBlockWithCache<HTMLOListElement | HTMLUListElement>, ReadonlyContentModelWithFormat<ContentModelListItemLevelFormat>, ReadonlyContentModelWithDataset<ListMetadataFormat>, Readonly<ContentModelListLevelCommon> {
+}
+
     /**
  * Represents a selectable Content Model object
  */
-interface Selectable {
+interface Selectable extends MutableMark  {
+    /**
+     * Whether this model object is selected
+     */
+    isSelected?: boolean;
+}
+
+    /**
+ * Represents a selectable Content Model object (Readonly)
+ */
+interface ReadonlySelectable extends ReadonlyMark  {
+    /**
+     * Whether this model object is selected
+     */
+    readonly isSelected?: boolean;
+}
+
+    /**
+ * Represents a selectable Content Model object (Shallow mutable)
+ */
+interface ShallowMutableSelectable extends ShallowMutableMark  {
     /**
      * Whether this model object is selected
      */
     isSelected?: boolean;
 }
 
+    /**
+ * Mark an object as mutable
+ */
+type MutableMark = {
+    /**
+     * The mutable marker to mark an object as mutable. When assign readonly object to a mutable type, compile will fail to build
+     * due to this member does not exist from source type.
+     */
+    readonly dummy1?: never[];
+    /**
+     * The mutable marker to mark an object as mutable. When assign readonly object to a mutable type, compile will fail to build
+     * due to this member does not exist from source type.
+     */
+    readonly dummy2?: never[];
+};
+
+    /**
+ * Mark an object as single level mutable (child models are still readonly)
+ */
+type ShallowMutableMark = {
+    /**
+     * The mutable marker to mark an object as mutable. When assign readonly object to a mutable type, compile will fail to build
+     * due to this member does not exist from source type.
+     */
+    readonly dummy1?: never[];
+    /**
+     * The mutable marker to mark an object as mutable. When assign readonly object to a mutable type, compile will fail to build
+     * due to this member does not exist from source type.
+     * This is used for preventing assigning ShallowMutableMark to MutableMark
+     */
+    readonly dummy2?: ReadonlyArray<never>;
+};
+
+    /**
+ * Mark an object as readonly
+ */
+type ReadonlyMark = {
+    /**
+     * The mutable marker to mark an object as mutable. When assign readonly object to a mutable type, compile will fail to build
+     * due to this member does not exist from source type.
+     * This is used for preventing assigning ReadonlyMark to ShallowMutableMark or MutableMark
+     */
+    readonly dummy1?: ReadonlyArray<never>;
+    /**
+     * The mutable marker to mark an object as mutable. When assign readonly object to a mutable type, compile will fail to build
+     * due to this member does not exist from source type.
+     */
+    readonly dummy2?: ReadonlyArray<never>;
+};
+
+    /**
+ * Get mutable type from its related readonly type
+ */
+type MutableType<T> = T extends ReadonlyContentModelGeneralSegment ? ShallowMutableContentModelGeneralSegment : T extends ReadonlyContentModelSelectionMarker ? ContentModelSelectionMarker : T extends ReadonlyContentModelImage ? ContentModelImage : T extends ContentModelEntity ? ContentModelEntity : T extends ReadonlyContentModelText ? ContentModelText : T extends ReadonlyContentModelBr ? ContentModelBr : T extends ReadonlyContentModelParagraph ? ShallowMutableContentModelParagraph : T extends ReadonlyContentModelTable ? ShallowMutableContentModelTable : T extends ReadonlyContentModelTableRow ? ContentModelTableRow : T extends ReadonlyContentModelTableCell ? ShallowMutableContentModelTableCell : T extends ReadonlyContentModelFormatContainer ? ShallowMutableContentModelFormatContainer : T extends ReadonlyContentModelListItem ? ShallowMutableContentModelListItem : T extends ReadonlyContentModelListLevel ? ContentModelListLevel : T extends ReadonlyContentModelDivider ? ContentModelDivider : T extends ReadonlyContentModelDocument ? ShallowMutableContentModelDocument : T extends ReadonlyContentModelGeneralBlock ? ShallowMutableContentModelGeneralBlock : T extends ReadonlyContentModelParagraphDecorator ? ContentModelParagraphDecorator : T extends ReadonlyContentModelLink ? ContentModelLink : T extends ReadonlyContentModelCode ? ContentModelCode : never;
+
     /**
  * The union type of 3 selection types
  */
@@ -1775,15 +2296,15 @@ interface InsertPoint {
     /**
      * The paragraph that contains this insert point
      */
-    paragraph: ContentModelParagraph;
+    paragraph: ShallowMutableContentModelParagraph;
     /**
      * Block group path of this insert point, from direct parent group to the root group
      */
-    path: ContentModelBlockGroup[];
+    path: ReadonlyContentModelBlockGroup[];
     /**
      * Table context of this insert point
      */
-    tableContext?: TableSelectionContext;
+    tableContext?: ReadonlyTableSelectionContext;
 }
 
     /**
@@ -1808,6 +2329,28 @@ interface TableSelectionContext {
     isWholeTableSelected: boolean;
 }
 
+    /**
+ * Context object for table in a selection (Readonly)
+ */
+interface ReadonlyTableSelectionContext {
+    /**
+     * The table that contains the selection
+     */
+    table: ReadonlyContentModelTable;
+    /**
+     * Row Index of the selected table cell
+     */
+    rowIndex: number;
+    /**
+     * Column Index of the selected table cell
+     */
+    colIndex: number;
+    /**
+     * Whether the whole table is selected
+     */
+    isWholeTableSelected: boolean;
+}
+
     /**
  * Coordinates of table selection
  */
@@ -2941,6 +3484,10 @@ interface EditorOptions {
      * Color of the border of a selectedImage. Default color: '#DB626C'
      */
     imageSelectionBorderColor?: string;
+    /**
+     * Background color of a selected table cell. Default color: '#C6C6C6'
+     */
+    tableCellSelectionBackgroundColor?: string;
     /**
      * Initial Content Model
      */
@@ -3574,6 +4121,18 @@ interface SelectionPluginState {
      * Color of the border of a selectedImage. Default color: '#DB626C'
      */
     imageSelectionBorderColor?: string;
+    /**
+     * Color of the border of a selectedImage in dark mode. Default color: '#DB626C'
+     */
+    imageSelectionBorderColorDark?: string;
+    /**
+     * Background color of a selected table cell. Default color: '#C6C6C6'
+     */
+    tableCellSelectionBackgroundColor?: string;
+    /**
+     * Background color of a selected table cell in dark mode. Default color: '#C6C6C6'
+     */
+    tableCellSelectionBackgroundColorDark?: string;
 }
 
     /**
@@ -4089,11 +4648,11 @@ interface DeleteSelectionContext extends DeleteSelectionResult  {
     /**
      * Last paragraph after previous step
      */
-    lastParagraph?: ContentModelParagraph;
+    lastParagraph?: ShallowMutableContentModelParagraph;
     /**
      * Last table context after previous step
      */
-    lastTableContext?: TableSelectionContext;
+    lastTableContext?: ReadonlyTableSelectionContext;
     /**
      * Format context provided by formatContentModel API
      */
@@ -4692,6 +5251,16 @@ interface IterateSelectionsOption {
     includeListFormatHolder?: 'anySegment' | 'allSegments' | 'never';
 }
 
+    /**
+ * The callback function type for iterateSelections (Readonly)
+ * @param path The block group path of current selection
+ * @param tableContext Table context of current selection
+ * @param block Block of current selection
+ * @param segments Segments of current selection
+ * @returns True to stop iterating, otherwise keep going
+ */
+type ReadonlyIterateSelectionsCallback = (path: ReadonlyContentModelBlockGroup[], tableContext?: ReadonlyTableSelectionContext, block?: ReadonlyContentModelBlock, segments?: ReadonlyContentModelSegment[]) => void | boolean;
+
     /**
  * A type map from node type number to its type declaration. This is used by utility function isNodeOfType()
  */
@@ -4733,7 +5302,7 @@ interface NodeTypeMap {
     /**
  * Retrieve block group type string from a given block group
  */
-type TypeOfBlockGroup<T extends ContentModelBlockGroup> = T extends ContentModelBlockGroupBase<infer U> ? U : never;
+type TypeOfBlockGroup<T extends ContentModelBlockGroup | ReadonlyContentModelBlockGroup> = T extends ContentModelBlockGroupBase<infer U> | ReadonlyContentModelBlockGroupBase<infer U> ? U : never;
 
     /**
  * Represent a pair of parent block group and child block
@@ -4753,6 +5322,24 @@ type OperationalBlocks<T extends ContentModelBlockGroup> = {
     path: ContentModelBlockGroup[];
 };
 
+    /**
+ * Represent a pair of parent block group and child block (Readonly)
+ */
+type ReadonlyOperationalBlocks<T extends ReadonlyContentModelBlockGroup> = {
+    /**
+     * The parent block group
+     */
+    parent: ReadonlyContentModelBlockGroup;
+    /**
+     * The child block
+     */
+    block: ReadonlyContentModelBlock | T;
+    /**
+     * Selection path of this block
+     */
+    path: ReadonlyContentModelBlockGroup[];
+};
+
     /**
  * Represents a parsed table with its table cells
  */
@@ -5472,13 +6059,21 @@ function buildSelectionMarker(group: ContentModelBlockGroup, context: DomToModel
  * @param definition @optional Metadata definition used for verify the metadata object
  * @returns The metadata object if any, or null
  */
-function updateMetadata<T>(model: ContentModelWithDataset<T>, callback?: (metadata: T | null) => T | null, definition?: Definition<T>): T | null;
+function updateMetadata<T>(model: ShallowMutableContentModelWithDataset<T>, callback?: (metadata: T | null) => T | null, definition?: Definition<T>): T | null;
+
+    /**
+ * Retrieve metadata from the given model.
+ * @param model The Content Model to retrieve metadata from
+ * @param definition Definition of this metadata type, used for validate the metadata object
+ * @returns Metadata of the model, or null if it does not contain a valid metadata
+ */
+function getMetadata<T>(model: ReadonlyContentModelWithDataset<T>, definition?: Definition<T>): T | null;
 
     /**
  * Check if the given model has metadata
  * @param model The content model to check
  */
-function hasMetadata<T>(model: ContentModelWithDataset<T> | HTMLElement): boolean;
+function hasMetadata<T>(model: ReadonlyContentModelWithDataset<T> | HTMLElement): boolean;
 
     /**
  * Type checker for Node. Return true if it of the specified node type
@@ -5652,21 +6247,21 @@ function normalizeRect(clientRect: DOMRect): Rect | null;
  * Create a ContentModelBr model
  * @param format @optional The format of this model
  */
-function createBr(format?: ContentModelSegmentFormat): ContentModelBr;
+function createBr(format?: Readonly<ContentModelSegmentFormat>): ContentModelBr;
 
     /**
  * Create a ContentModelListItem model
  * @param levels Existing list levels
  * @param format @optional The format of this model
  */
-function createListItem(levels: ContentModelListLevel[], format?: ContentModelSegmentFormat): ContentModelListItem;
+function createListItem(levels: ReadonlyArray<ReadonlyContentModelListLevel>, format?: Readonly<ContentModelSegmentFormat>): ContentModelListItem;
 
     /**
  * Create a ContentModelFormatContainer model
  * @param tag Tag name of this format container, in lower case
  * @param format @optional The format of this model
  */
-function createFormatContainer(tag: Lowercase<string>, format?: ContentModelFormatContainerFormat): ContentModelFormatContainer;
+function createFormatContainer(tag: Lowercase<string>, format?: Readonly<ContentModelFormatContainerFormat>): ContentModelFormatContainer;
 
     /**
  * Create a ContentModelParagraph model
@@ -5675,20 +6270,20 @@ function createFormatContainer(tag: Lowercase<string>, format?: ContentModelForm
  * @param segmentFormat @optional Segment format applied to this block
  * @param decorator @optional Decorator of this paragraph
  */
-function createParagraph(isImplicit?: boolean, blockFormat?: ContentModelBlockFormat, segmentFormat?: ContentModelSegmentFormat, decorator?: ContentModelParagraphDecorator): ContentModelParagraph;
+function createParagraph(isImplicit?: boolean, blockFormat?: Readonly<ContentModelBlockFormat>, segmentFormat?: Readonly<ContentModelSegmentFormat>, decorator?: ReadonlyContentModelParagraphDecorator): ContentModelParagraph;
 
     /**
  * Create a ContentModelSelectionMarker model
  * @param format @optional The format of this model
  */
-function createSelectionMarker(format?: ContentModelSegmentFormat): ContentModelSelectionMarker;
+function createSelectionMarker(format?: Readonly<ContentModelSegmentFormat>): ContentModelSelectionMarker;
 
     /**
  * Create a ContentModelTable model
  * @param rowCount Count of rows of this table
  * @param format @optional The format of this model
  */
-function createTable(rowCount: number, format?: ContentModelTableFormat): ContentModelTable;
+function createTable(rowCount: number, format?: Readonly<ContentModelTableFormat>): ContentModelTable;
 
     /**
  * Create a ContentModelTableCell model
@@ -5697,7 +6292,7 @@ function createTable(rowCount: number, format?: ContentModelTableFormat): Conten
  * @param isHeader @optional Whether this is a header cell @default false
  * @param format @optional The format of this model
  */
-function createTableCell(spanLeftOrColSpan?: boolean | number, spanAboveOrRowSpan?: boolean | number, isHeader?: boolean, format?: ContentModelTableCellFormat, dataset?: DatasetFormat): ContentModelTableCell;
+function createTableCell(spanLeftOrColSpan?: boolean | number, spanAboveOrRowSpan?: boolean | number, isHeader?: boolean, format?: Readonly<ContentModelTableCellFormat>, dataset?: ReadonlyDatasetFormat): ContentModelTableCell;
 
     /**
  * Create a ContentModelText model
@@ -5706,34 +6301,34 @@ function createTableCell(spanLeftOrColSpan?: boolean | number, spanAboveOrRowSpa
  * @param link @optional The link decorator
  * @param code @option The code decorator
  */
-function createText(text: string, format?: ContentModelSegmentFormat, link?: ContentModelLink, code?: ContentModelCode): ContentModelText;
+function createText(text: string, format?: Readonly<ContentModelSegmentFormat>, link?: ReadonlyContentModelLink, code?: ReadonlyContentModelCode): ContentModelText;
 
     /**
  * Create a ContentModelImage model
  * @param src Image source
  * @param format @optional The format of this model
  */
-function createImage(src: string, format?: ContentModelImageFormat): ContentModelImage;
+function createImage(src: string, format?: Readonly<ContentModelImageFormat>): ContentModelImage;
 
     /**
  * Create a ContentModelDocument model
  * @param defaultFormat @optional Default format of this model
  */
-function createContentModelDocument(defaultFormat?: ContentModelSegmentFormat): ContentModelDocument;
+function createContentModelDocument(defaultFormat?: Readonly<ContentModelSegmentFormat>): ContentModelDocument;
 
     /**
  * Create a ContentModelParagraphDecorator model
  * @param tagName Tag name of this decorator
  * @param format @optional The format of this model
  */
-function createParagraphDecorator(tagName: string, format?: ContentModelSegmentFormat): ContentModelParagraphDecorator;
+function createParagraphDecorator(tagName: string, format?: Readonly<ContentModelSegmentFormat>): ContentModelParagraphDecorator;
 
     /**
  * Create a ContentModelGeneralSegment model
  * @param element The original DOM element
  * @param format @optional The format of this model
  */
-function createGeneralSegment(element: HTMLElement, format?: ContentModelSegmentFormat): ContentModelGeneralSegment;
+function createGeneralSegment(element: HTMLElement, format?: Readonly<ContentModelSegmentFormat>): ContentModelGeneralSegment;
 
     /**
  * Create a ContentModelGeneralBlock model
@@ -5749,14 +6344,14 @@ function createGeneralBlock(element: HTMLElement): ContentModelGeneralBlock;
  * @param type @optional Type of this entity
  * @param id @optional Id of this entity
  */
-function createEntity(wrapper: HTMLElement, isReadonly?: boolean, segmentFormat?: ContentModelSegmentFormat, type?: string, id?: string): ContentModelEntity;
+function createEntity(wrapper: HTMLElement, isReadonly?: boolean, segmentFormat?: Readonly<ContentModelSegmentFormat>, type?: string, id?: string): ContentModelEntity;
 
     /**
  * Create a ContentModelDivider model
  * @param tagName Tag name of this divider. Currently only hr and div are supported
  * @param format @optional The format of this model
  */
-function createDivider(tagName: 'hr' | 'div', format?: ContentModelBlockFormat): ContentModelDivider;
+function createDivider(tagName: 'hr' | 'div', format?: Readonly<ContentModelBlockFormat>): ContentModelDivider;
 
     /**
  * Create a ContentModelListLevel model
@@ -5764,27 +6359,56 @@ function createDivider(tagName: 'hr' | 'div', format?: ContentModelBlockFormat):
  * @param format @optional The format of this model
  * @param dataset @optional The dataset of this model
  */
-function createListLevel(listType: 'OL' | 'UL', format?: ContentModelListItemLevelFormat, dataset?: DatasetFormat): ContentModelListLevel;
+function createListLevel(listType: 'OL' | 'UL', format?: Readonly<ContentModelListItemLevelFormat>, dataset?: ReadonlyDatasetFormat): ContentModelListLevel;
 
     /**
  * Create an empty Content Model Document with initial empty line and insert point with default format
  * @param format @optional The default format to be applied to this Content Model
  */
-function createEmptyModel(format?: ContentModelSegmentFormat): ContentModelDocument;
+function createEmptyModel(format?: Readonly<ContentModelSegmentFormat>): ContentModelDocument;
+
+    /**
+ * Create a ContentModelTableRow model
+ * @param format @optional The format of this model
+ */
+function createTableRow(format?: Readonly<ContentModelBlockFormat>, height?: number): ContentModelTableRow;
+
+    /**
+ * Convert a readonly block to mutable block, clear cached element if exist
+ * @param block The block to convert from
+ * @returns The same block object of its related mutable type
+ */
+function mutateBlock<T extends ReadonlyContentModelBlockGroup | ReadonlyContentModelBlock>(block: T): MutableType<T>;
+
+    /**
+ * Convert segments of a readonly paragraph to be mutable.
+ * Segments that are not belong to the given paragraph will be skipped
+ * @param paragraph The readonly paragraph to convert from
+ * @param segments The segments to convert from
+ */
+function mutateSegments(paragraph: ReadonlyContentModelParagraph, segments: ReadonlyContentModelSegment[]): [ShallowMutableContentModelParagraph, ShallowMutableContentModelSegment[], number[]];
+
+    /**
+ * Convert a readonly segment to be mutable, together with its owner paragraph
+ * If the segment does not belong to the given paragraph, return null for the segment
+ * @param paragraph The readonly paragraph to convert from
+ * @param segment The segment to convert from
+ */
+function mutateSegment<T extends ReadonlyContentModelSegment>(paragraph: ReadonlyContentModelParagraph, segment: T, callback?: (segment: MutableType<T>, paragraph: ShallowMutableContentModelParagraph, index: number) => void): [ShallowMutableContentModelParagraph, MutableType<T> | null, number];
 
     /**
  * Add a given block to block group
  * @param group The block group to add block into
  * @param block The block to add
  */
-function addBlock(group: ContentModelBlockGroup, block: ContentModelBlock): void;
+function addBlock(group: ShallowMutableContentModelBlockGroup, block: ShallowMutableContentModelBlock): void;
 
     /**
  * Add a code decorator into segment if any
  * @param segment The segment to add decorator to
  * @param code The code decorator to add
  */
-function addCode(segment: ContentModelSegment, code: ContentModelCode): void;
+function addCode(segment: ShallowMutableContentModelSegment, code: ReadonlyContentModelCode): void;
 
     /**
  * Add a new text segment to current paragraph
@@ -5799,7 +6423,7 @@ function addTextSegment(group: ContentModelBlockGroup, text: string, context: Do
  * @param paragraph The paragraph to normalize
  * Normalize a paragraph. If it is empty, add a BR segment to make sure it can insert content
  */
-function normalizeParagraph(paragraph: ContentModelParagraph): void;
+function normalizeParagraph(paragraph: ReadonlyContentModelParagraph): void;
 
     /**
  * For a given content model, normalize it to make the model be consistent.
@@ -5810,7 +6434,7 @@ function normalizeParagraph(paragraph: ContentModelParagraph): void;
  * - For an empty block, remove it
  * @param group The root level block group of content model to normalize
  */
-function normalizeContentModel(group: ContentModelBlockGroup): void;
+function normalizeContentModel(group: ReadonlyContentModelBlockGroup): void;
 
     /**
  * Check if the given block group is a general segment
@@ -5818,12 +6442,24 @@ function normalizeContentModel(group: ContentModelBlockGroup): void;
  */
 function isGeneralSegment(group: ContentModelBlockGroup | ContentModelGeneralSegment): group is ContentModelGeneralSegment;
 
+    /**
+ * Check if the given block group is a general segment (Shallow mutable)
+ * @param group The group to check
+ */
+function isGeneralSegment(group: ShallowMutableContentModelBlockGroup | ShallowMutableContentModelGeneralSegment): group is ShallowMutableContentModelGeneralSegment;
+
+    /**
+ * Check if the given block group is a general segment (Readonly)
+ * @param group The group to check
+ */
+function isGeneralSegment(group: ReadonlyContentModelBlockGroup | ReadonlyContentModelGeneralSegment): group is ReadonlyContentModelGeneralSegment;
+
     /**
  * Unwrap a given block group, move its child blocks to be under its parent group
  * @param parent Parent block group of the unwrapping group
  * @param groupToUnwrap  The block group to unwrap
  */
-function unwrapBlock(parent: ContentModelBlockGroup | null, groupToUnwrap: ContentModelBlockGroup & ContentModelBlock): void;
+function unwrapBlock(parent: ReadonlyContentModelBlockGroup | null, groupToUnwrap: ReadonlyContentModelBlockGroup & ReadonlyContentModelBlock): 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.
@@ -5834,24 +6470,33 @@ function unwrapBlock(parent: ContentModelBlockGroup | null, groupToUnwrap: Conte
  */
 function addSegment(group: ContentModelBlockGroup, newSegment: ContentModelSegment, blockFormat?: ContentModelBlockFormat, segmentFormat?: ContentModelSegmentFormat): ContentModelParagraph;
 
+    /**
+ * 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. (Shallow mutable)
+ * @param group The parent block group of the paragraph to add segment into
+ * @param newSegment The segment to add
+ * @param blockFormat The block format used for creating a new paragraph when need
+ * @returns The parent paragraph where the segment is added to
+ */
+function addSegment(group: ShallowMutableContentModelBlockGroup, newSegment: ContentModelSegment, blockFormat?: ContentModelBlockFormat, segmentFormat?: ContentModelSegmentFormat): ShallowMutableContentModelParagraph;
+
     /**
  * Get whether the model is empty.
  * @returns true if the model is empty.
  */
-function isEmpty(model: ContentModelBlock | ContentModelBlockGroup | ContentModelSegment): boolean;
+function isEmpty(model: ReadonlyContentModelBlock | ReadonlyContentModelBlockGroup | ReadonlyContentModelSegment): boolean;
 
     /**
  * Normalize a given segment, make sure its spaces are correctly represented by space and non-break space
  * @param segment The segment to normalize
  * @param ignoreTrailingSpaces Whether we should ignore the trailing space of the text segment @default false
  */
-function normalizeSingleSegment(segment: ContentModelSegment, ignoreTrailingSpaces?: boolean): void;
+function normalizeSingleSegment(paragraph: ReadonlyContentModelParagraph, segment: ReadonlyContentModelSegment, ignoreTrailingSpaces?: boolean): void;
 
     /**
  * For a given block, if it is a paragraph, set it to be not-implicit
  * @param block The block to check
  */
-function setParagraphNotImplicit(block: ContentModelBlock): void;
+function setParagraphNotImplicit(block: ReadonlyContentModelBlock): void;
 
     /**
  * Get the list number for a list item according to list style type and its index number
@@ -6081,13 +6726,20 @@ function cacheGetEventData<T, E extends PluginEvent>(event: E, key: string, gett
  */
 function isBlockGroupOfType<T extends ContentModelBlockGroup>(input: ContentModelBlock | ContentModelBlockGroup | null | undefined, type: TypeOfBlockGroup<T>): input is T;
 
+    /**
+ * Check if the given content model block or block group is of the expected block group type (Readonly)
+ * @param input The object to check
+ * @param type The expected type
+ */
+function isBlockGroupOfType<T extends ReadonlyContentModelBlockGroup>(input: ReadonlyContentModelBlock | ReadonlyContentModelBlockGroup | null | undefined, type: TypeOfBlockGroup<T>): input is T;
+
     /**
  * Get index of closest ancestor block group of the expected block group type. If not found, return -1
  * @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
  */
-function getClosestAncestorBlockGroupIndex<T extends ContentModelBlockGroup>(path: ContentModelBlockGroup[], blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes?: ContentModelBlockGroupType[]): number;
+function getClosestAncestorBlockGroupIndex<T extends ContentModelBlockGroup>(path: ReadonlyContentModelBlockGroup[], blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes?: ContentModelBlockGroupType[]): number;
 
     /**
  * Iterate all selected elements in a given model
@@ -6097,18 +6749,38 @@ function getClosestAncestorBlockGroupIndex<T extends ContentModelBlockGroup>(pat
  */
 function iterateSelections(group: ContentModelBlockGroup, callback: IterateSelectionsCallback, option?: IterateSelectionsOption): void;
 
+    /**
+ * Iterate all selected elements in a given model (Readonly)
+ * @param group The given Content Model to iterate selection from
+ * @param callback The callback function to access the selected element
+ * @param option Option to determine how to iterate
+ */
+function iterateSelections(group: ReadonlyContentModelBlockGroup, callback: ReadonlyIterateSelectionsCallback, option?: IterateSelectionsOption): void;
+
     /**
  * Get the first selected list item from content model
  * @param model The Content Model to get selection from
  */
 function getFirstSelectedListItem(model: ContentModelDocument): ContentModelListItem | undefined;
 
+    /**
+ * Get the first selected list item from content model (Readonly)
+ * @param model The Content Model to get selection from
+ */
+function getFirstSelectedListItem(model: ReadonlyContentModelDocument): ReadonlyContentModelListItem | undefined;
+
     /**
  * Get the first selected table from content model
  * @param model The Content Model to get selection from
  */
 function getFirstSelectedTable(model: ContentModelDocument): [ContentModelTable | undefined, ContentModelBlockGroup[]];
 
+    /**
+ * Get the first selected table from content model (Readonly)
+ * @param model The Content Model to get selection from
+ */
+function getFirstSelectedTable(model: ReadonlyContentModelDocument): [ReadonlyContentModelTable | undefined, ReadonlyContentModelBlockGroup[]];
+
     /**
  * Get an array of block group - block pair that is of the expected block group type from selection
  * @param group The root block group to search
@@ -6118,12 +6790,34 @@ function getFirstSelectedTable(model: ContentModelDocument): [ContentModelTable
  */
 function getOperationalBlocks<T extends ContentModelBlockGroup>(group: ContentModelBlockGroup, blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes: ContentModelBlockGroupType[], deepFirst?: boolean): OperationalBlocks<T>[];
 
+    /**
+ * Get an array of block group - block pair that is of the expected block group type from selection (Readonly)
+ * @param group The root block group to search
+ * @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
+ */
+function getOperationalBlocks<T extends ReadonlyContentModelBlockGroup>(group: ReadonlyContentModelBlockGroup, blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes: ContentModelBlockGroupType[], deepFirst?: boolean): ReadonlyOperationalBlocks<T>[];
+
     /**
  * Get any array of selected paragraphs from a content model
  * @param model The Content Model to get selection from
  */
 function getSelectedParagraphs(model: ContentModelDocument): ContentModelParagraph[];
 
+    /**
+ * Get any array of selected paragraphs from a content model, return mutable paragraphs
+ * @param model The Content Model to get selection from
+ * @param mutate Set to true to indicate we will mutate the selected paragraphs
+ */
+function getSelectedParagraphs(model: ReadonlyContentModelDocument, mutate: true): ShallowMutableContentModelParagraph[];
+
+    /**
+ * Get any array of selected paragraphs from a content model (Readonly)
+ * @param model The Content Model to get selection from
+ */
+function getSelectedParagraphs(model: ReadonlyContentModelDocument): ReadonlyContentModelParagraph[];
+
     /**
  * Get an array of selected segments from a content model
  * @param model The Content Model to get selection from
@@ -6131,36 +6825,77 @@ function getSelectedParagraphs(model: ContentModelDocument): ContentModelParagra
  */
 function getSelectedSegments(model: ContentModelDocument, includingFormatHolder: boolean): ContentModelSegment[];
 
+    /**
+ * Get an array of selected segments from a content model, return mutable segments
+ * @param model The Content Model to get selection from
+ * @param includingFormatHolder True means also include format holder as segment from list item
+ * @param mutate Set to true to indicate we will mutate the selected paragraphs
+ */
+function getSelectedSegments(model: ReadonlyContentModelDocument, includingFormatHolder: boolean, mutate: true): ShallowMutableContentModelSegment[];
+
+    /**
+ * Get an array of selected segments from a content model (Readonly)
+ * @param model The Content Model to get selection from
+ * @param includingFormatHolder True means also include format holder as segment from list item
+ */
+function getSelectedSegments(model: ReadonlyContentModelDocument, includingFormatHolder: boolean): ReadonlyContentModelSegment[];
+
     /**
  * Get an array of selected parent paragraph and child segment pair
  * @param model The Content Model to get selection from
  * @param includingFormatHolder True means also include format holder as segment from list item, in that case paragraph will be null
+ * @param includingEntity True to include entity in result as well
  */
 function getSelectedSegmentsAndParagraphs(model: ContentModelDocument, includingFormatHolder: boolean, includingEntity?: boolean): [ContentModelSegment, ContentModelParagraph | null, ContentModelBlockGroup[]][];
 
+    /**
+ * Get an array of selected parent paragraph and child segment pair, return mutable paragraph and segments
+ * @param model The Content Model to get selection from
+ * @param includingFormatHolder True means also include format holder as segment from list item, in that case paragraph will be null
+ * @param includingEntity True to include entity in result as well
+ * @param mutate Set to true to indicate we will mutate the selected paragraphs
+ */
+function getSelectedSegmentsAndParagraphs(model: ReadonlyContentModelDocument, includingFormatHolder: boolean, includingEntity: boolean, mutate: true): [
+    ShallowMutableContentModelSegment,
+    ContentModelParagraph | null,
+    ReadonlyContentModelBlockGroup[]
+][];
+
+    /**
+ * Get an array of selected parent paragraph and child segment pair (Readonly)
+ * @param model The Content Model to get selection from
+ * @param includingFormatHolder True means also include format holder as segment from list item, in that case paragraph will be null
+ * @param includingEntity True to include entity in result as well
+ */
+function getSelectedSegmentsAndParagraphs(model: ReadonlyContentModelDocument, includingFormatHolder: boolean, includingEntity?: boolean): [
+    ReadonlyContentModelSegment,
+    ReadonlyContentModelParagraph | null,
+    ReadonlyContentModelBlockGroup[]
+][];
+
     /**
  * Get selection coordinates of a table. If there is no selection, return null
  * @param table The table model to get selection from
  */
-function getSelectedCells(table: ContentModelTable): TableSelectionCoordinates | null;
+function getSelectedCells(table: ReadonlyContentModelTable): TableSelectionCoordinates | null;
 
     /**
  * Check if there is selection within the given block
  * @param block The block to check
  */
-function hasSelectionInBlock(block: ContentModelBlock): boolean;
+function hasSelectionInBlock(block: ReadonlyContentModelBlock): boolean;
 
     /**
  * Check if there is selection within the given segment
  * @param segment The segment to check
  */
-function hasSelectionInSegment(segment: ContentModelSegment): boolean;
+function hasSelectionInSegment(segment: ReadonlyContentModelSegment): boolean;
 
     /**
  * Check if there is selection within the given block
  * @param block The block to check
  */
-function hasSelectionInBlockGroup(group: ContentModelBlockGroup): boolean;
+function hasSelectionInBlockGroup(group: ReadonlyContentModelBlockGroup): boolean;
 
     /**
  * Set selection into Content Model. If the Content Model already has selection, existing selection will be overwritten by the new one.
@@ -6168,14 +6903,14 @@ function hasSelectionInBlockGroup(group: ContentModelBlockGroup): boolean;
  * @param start The start selected element. If not passed, existing selection of content model will be cleared
  * @param end The end selected element. If not passed, only the start element will be selected. If passed, all elements between start and end elements will be selected
  */
-function setSelection(group: ContentModelBlockGroup, start?: Selectable, end?: Selectable): void;
+function setSelection(group: ReadonlyContentModelBlockGroup, start?: ReadonlySelectable, end?: ReadonlySelectable): void;
 
     /**
  * Clone a content model
  * @param model The content model to clone
  * @param options @optional Options to specify customize the clone behavior
  */
-function cloneModel(model: ContentModelDocument, options?: CloneModelOptions): ContentModelDocument;
+function cloneModel(model: ReadonlyContentModelDocument, options?: CloneModelOptions): ContentModelDocument;
 
     /**
  * Merge source model into target mode
@@ -6185,7 +6920,7 @@ function cloneModel(model: ContentModelDocument, options?: CloneModelOptions): C
  * @param options More options, see MergeModelOption
  * @returns Insert point after merge, or null if there is no insert point
  */
-function mergeModel(target: ContentModelDocument, source: ContentModelDocument, context?: FormatContentModelContext, options?: MergeModelOption): InsertPoint | null;
+function mergeModel(target: ReadonlyContentModelDocument, source: ContentModelDocument, context?: FormatContentModelContext, options?: MergeModelOption): InsertPoint | null;
 
     /**
  * Delete selected content from Content Model
@@ -6194,17 +6929,17 @@ function mergeModel(target: ContentModelDocument, source: ContentModelDocument,
  * @param formatContext @optional A context object provided by formatContentModel API
  * @returns A DeleteSelectionResult object to specify the deletion result
  */
-function deleteSelection(model: ContentModelDocument, additionalSteps?: (DeleteSelectionStep | null)[], formatContext?: FormatContentModelContext): DeleteSelectionResult;
+function deleteSelection(model: ReadonlyContentModelDocument, additionalSteps?: (DeleteSelectionStep | null)[], formatContext?: FormatContentModelContext): DeleteSelectionResult;
 
     /**
  * Delete a content model segment from current selection
- * @param paragraph Parent paragraph of the segment to delete
- * @param segmentToDelete The segment to delete
+ * @param readonlyParagraph Parent paragraph of the segment to delete
+ * @param readonlySegmentToDelete The segment to delete
  * @param context @optional Context object provided by formatContentModel API
  * @param direction @optional Whether this is deleting forward or backward. This is only used for deleting entity.
  * If not specified, only selected entity will be deleted
  */
-function deleteSegment(paragraph: ContentModelParagraph, segmentToDelete: ContentModelSegment, context?: FormatContentModelContext, direction?: 'forward' | 'backward'): boolean;
+function deleteSegment(readonlyParagraph: ReadonlyContentModelParagraph, readonlySegmentToDelete: ReadonlyContentModelSegment, context?: FormatContentModelContext, direction?: 'forward' | 'backward'): boolean;
 
     /**
  * Delete a content model block from current selection
@@ -6215,7 +6950,7 @@ function deleteSegment(paragraph: ContentModelParagraph, segmentToDelete: Conten
  * @param direction @optional Whether this is deleting forward or backward. This is only used for deleting entity.
  * If not specified, only selected entity will be deleted
  */
-function deleteBlock(blocks: ContentModelBlock[], blockToDelete: ContentModelBlock, replacement?: ContentModelBlock, context?: FormatContentModelContext, direction?: 'forward' | 'backward'): boolean;
+function deleteBlock(blocks: ReadonlyContentModelBlock[], blockToDelete: ReadonlyContentModelBlock, replacement?: ReadonlyContentModelBlock, context?: FormatContentModelContext, direction?: 'forward' | 'backward'): boolean;
 
     /**
  * Apply table format from table metadata and the passed in new format
@@ -6223,20 +6958,27 @@ function deleteBlock(blocks: ContentModelBlock[], blockToDelete: ContentModelBlo
  * @param newFormat @optional New format to apply. When passed, this value will be merged into existing metadata format and default format
  * @param keepCellShade @optional When pass true, table cells with customized shade color will not be overwritten. @default false
  */
-function applyTableFormat(table: ContentModelTable, newFormat?: TableMetadataFormat, keepCellShade?: boolean): void;
+function applyTableFormat(table: ReadonlyContentModelTable, newFormat?: TableMetadataFormat, keepCellShade?: boolean): void;
+
+    /**
+ * Set the first column format borders for the table as well as header property
+ * @param rows The rows of the table
+ * @param format The table metadata format
+ */
+function setFirstColumnFormatBorders(rows: ShallowMutableContentModelTableRow[], format: Partial<TableMetadataFormat>): void;
 
     /**
  * Normalize a Content Model table, make sure:
  * 1. Fist cells are not spanned
- * 2. Inner cells are not header
+ * 2. Only first column and row can have headers
  * 3. All cells have content and width
  * 4. Table and table row have correct width/height
  * 5. Spanned cell has no child blocks
  * 6. default format is correctly applied
- * @param table The table to normalize
+ * @param readonlyTable The table to normalize
  * @param defaultSegmentFormat @optional Default segment format to apply to cell
  */
-function normalizeTable(table: ContentModelTable, defaultSegmentFormat?: ContentModelSegmentFormat): void;
+function normalizeTable(readonlyTable: ReadonlyContentModelTable, defaultSegmentFormat?: ContentModelSegmentFormat): void;
 
     /**
  * Minimum width for a table cell
@@ -6250,7 +6992,7 @@ const MIN_ALLOWED_TABLE_CELL_WIDTH: number;
  * @param isColorOverride @optional When pass true, it means this shade color is not part of table format, so it can be preserved when apply table format
  * @param applyToSegments @optional When pass true, we will also apply text color from table cell to its child blocks and segments
  */
-function setTableCellBackgroundColor(cell: ContentModelTableCell, color: string | null | undefined, isColorOverride?: boolean, applyToSegments?: boolean): void;
+function setTableCellBackgroundColor(cell: ShallowMutableContentModelTableCell, color: string | null | undefined, isColorOverride?: boolean, applyToSegments?: boolean): void;
 
     /**
  * Retrieve format state from the given Content Model
@@ -6258,7 +7000,7 @@ function setTableCellBackgroundColor(cell: ContentModelTableCell, color: string
  * @param pendingFormat Existing pending format, if any
  * @param formatState Existing format state object, used for receiving the result
  */
-function retrieveModelFormatState(model: ContentModelDocument, pendingFormat: ContentModelSegmentFormat | null, formatState: ContentModelFormatState): void;
+function retrieveModelFormatState(model: ReadonlyContentModelDocument, pendingFormat: ContentModelSegmentFormat | null, formatState: ContentModelFormatState): void;
 
     /**
  * Gets the list style type that the bullet is part of, using the Constant record
@@ -6273,7 +7015,7 @@ function getListStyleTypeFromString(listType: 'OL' | 'UL', bullet: string): numb
  * @param segment The segment to get format from
  * @returns
  */
-function getSegmentTextFormat(segment: ContentModelSegment): ContentModelSegmentFormat;
+function getSegmentTextFormat(segment: ReadonlyContentModelSegment): ContentModelSegmentFormat;
 
     /**
  * Update image metadata with a callback
@@ -6282,26 +7024,50 @@ function getSegmentTextFormat(segment: ContentModelSegment): ContentModelSegment
  */
 function updateImageMetadata(image: ContentModelImage, callback?: (format: ImageMetadataFormat | null) => ImageMetadataFormat | null): ImageMetadataFormat | null;
 
+    /**
+ * Get image metadata
+ * @param image The image Content Model
+ */
+function getImageMetadata(image: ReadonlyContentModelImage): ImageMetadataFormat | null;
+
     /**
  * Update table cell metadata with a callback
  * @param cell The table cell Content Model
  * @param callback The callback function used for updating metadata
  */
-function updateTableCellMetadata(cell: ContentModelTableCell, callback?: (format: TableCellMetadataFormat | null) => TableCellMetadataFormat | null): TableCellMetadataFormat | null;
+function updateTableCellMetadata(cell: ShallowMutableContentModelTableCell, callback?: (format: TableCellMetadataFormat | null) => TableCellMetadataFormat | null): TableCellMetadataFormat | null;
+
+    /**
+ * Get table cell metadata
+ * @param cell The table cell Content Model
+ */
+function getTableCellMetadata(cell: ReadonlyContentModelTableCell): TableCellMetadataFormat | null;
 
     /**
  * Update table metadata with a callback
  * @param table The table Content Model
  * @param callback The callback function used for updating metadata
  */
-function updateTableMetadata(table: ContentModelTable, callback?: (format: TableMetadataFormat | null) => TableMetadataFormat | null): TableMetadataFormat | null;
+function updateTableMetadata(table: ShallowMutableContentModelTable, callback?: (format: TableMetadataFormat | null) => TableMetadataFormat | null): TableMetadataFormat | null;
+
+    /**
+ * Get table metadata
+ * @param table The table Content Model
+ */
+function getTableMetadata(table: ReadonlyContentModelTable): TableMetadataFormat | null;
 
     /**
  * Update list metadata with a callback
  * @param list The list Content Model (metadata holder)
  * @param callback The callback function used for updating metadata
  */
-function updateListMetadata(list: ContentModelWithDataset<ListMetadataFormat>, callback?: (format: ListMetadataFormat | null) => ListMetadataFormat | null): ListMetadataFormat | null;
+function updateListMetadata(list: ShallowMutableContentModelWithDataset<ListMetadataFormat>, callback?: (format: ListMetadataFormat | null) => ListMetadataFormat | null): ListMetadataFormat | null;
+
+    /**
+ * Get list metadata
+ * @param list The list Content Model (metadata holder)
+ */
+function getListMetadata(list: ReadonlyContentModelWithDataset<ListMetadataFormat>): ListMetadataFormat | null;
 
     /**
  * Metadata definition for List
@@ -7267,19 +8033,26 @@ function setModelListStyle(model: ContentModelDocument, style: ListMetadataForma
 function setModelListStartNumber(model: ContentModelDocument, value: number): boolean;
 
     /**
+ * Search for all list items in the same thread as the current list item
  * @param model The content model
  * @param currentItem The current list item
- * Search for all list items in the same thread as the current list item
  */
 function findListItemsInSameThread(group: ContentModelBlockGroup, currentItem: ContentModelListItem): ContentModelListItem[];
 
+    /**
+ * Search for all list items in the same thread as the current list item (Readonly)
+ * @param model The content model
+ * @param currentItem The current list item
+ */
+function findListItemsInSameThread(group: ReadonlyContentModelBlockGroup, currentItem: ReadonlyContentModelListItem): ReadonlyContentModelListItem[];
+
     /**
  * @param model The content model to set indentation
  * @param indentation The indentation type, 'indent' to indent, 'outdent' to outdent
  * @param length The length of indentation in pixel, default value is 40
  * Set indentation for selected list items or paragraphs
  */
-function setModelIndentation(model: ContentModelDocument, indentation: 'indent' | 'outdent', length?: number, context?: FormatContentModelContext): boolean;
+function setModelIndentation(model: ReadonlyContentModelDocument, indentation: 'indent' | 'outdent', length?: number, context?: FormatContentModelContext): boolean;
 
     /**
  * Try to match a given string with link match rules, return matched link
@@ -7298,7 +8071,7 @@ function matchLink(url: string): LinkData | null;
  * @param path Content model path that include the list item
  * @returns Announce data of current list item if any, or null
  */
-function getListAnnounceData(path: ContentModelBlockGroup[]): AnnounceData | null;
+function getListAnnounceData(path: ReadonlyContentModelBlockGroup[]): AnnounceData | null;
 
     /**
  * TableEdit plugin, provides the ability to resize a table by drag-and-drop
@@ -7414,6 +8187,7 @@ class EditPlugin implements EditorPlugin  {
     private editor;
     private disposer;
     private shouldHandleNextInputEvent;
+    private selectionAfterDelete;
     /**
      * Get name of this plugin
      */