roosterjs 9.44.0 → 9.45.1

package/dist/rooster-amd.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 9.44.0)
+// Type definitions for roosterjs (Version 9.45.1)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -40,7 +40,7 @@ export interface ReadonlyContentModelWithFormat<T extends ContentModelFormatBase
 /**
  * Format of Table
  */
-export type ContentModelTableFormat = ContentModelBlockFormat & IdFormat & AriaFormat & BorderFormat & BorderBoxFormat & DirectionFormat & SpacingFormat & MarginFormat & DisplayFormat & TableLayoutFormat & SizeFormat & RoleFormat;
+export type ContentModelTableFormat = ContentModelBlockFormat & IdFormat & AriaFormat & BorderFormat & BorderBoxFormat & DirectionFormat & SpacingFormat & MarginFormat & DisplayFormat & TableLayoutFormat & SizeFormat & RoleFormat & LegacyTableBorderFormat;
 
 /**
  * Represents base format of an element that supports dataset and/or metadata
@@ -266,6 +266,10 @@ export interface FormatHandlerTypeMap {
      * Format for BorderBoxFormat
      */
     borderBox: BorderBoxFormat;
+    /**
+     * Format for the Border Colors
+     */
+    borderColor: BorderFormat;
     /**
      * Format for BoxShadowFormat
      */
@@ -314,6 +318,10 @@ export interface FormatHandlerTypeMap {
      * Format for ItalicFormat
      */
     italic: ItalicFormat;
+    /**
+     * Format for LegacyTableBorderFormat
+     */
+    legacyTableBorder: LegacyTableBorderFormat;
     /**
      * Format for LetterSpacingFormat
      */
@@ -326,6 +334,10 @@ export interface FormatHandlerTypeMap {
      * Format for LinkFormat
      */
     link: LinkFormat;
+    /**
+     * Format for TextAlignFormat under list item
+     */
+    listItemAlign: TextAlignFormat;
     /**
      * Format for ListThreadFormat (used by list item)
      */
@@ -918,6 +930,31 @@ export type RoleFormat = {
     role?: string;
 };
 
+/**
+ * Format for legacy table border.
+ * This is used for supporting legacy table border rendering in some scenarios.
+ */
+export type LegacyTableBorderFormat = {
+    /**
+     * The value of border attribute on table element.
+     * Although this attribute is deprecated in HTML5, some email clients still rely on it.
+     * https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableElement/border
+     */
+    legacyTableBorder?: string;
+    /**
+     * The value of cellspacing attribute on table element.
+     * This attribute is deprecated in HTML5, but still used in some legacy scenarios.
+     * https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableElement/cellSpacing
+     */
+    cellSpacing?: string;
+    /**
+     * The value of cellpadding attribute on table element.
+     * This attribute is deprecated in HTML5, but still used in some legacy scenarios.
+     * https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableElement/cellPadding
+     */
+    cellPadding?: string;
+};
+
 /**
  * Represents dataset format of Content Model
  */
@@ -3713,7 +3750,11 @@ export type ExperimentalFeature = GraduatedExperimentalFeature
 /**
  * Allow caching list item elements.
  */
- | 'CacheList';
+ | 'CacheList'
+/**
+ * Transform the table border colors when switching from light to dark mode
+ */
+ | 'TransformTableBorderColors';
 
 /**
  * Predefined experiment features (Graduated, only keep them for backward compatibility)
@@ -4674,6 +4715,10 @@ export interface AutoLinkOptions {
  * Current running environment
  */
 export interface EditorEnvironment {
+    /**
+     * Document object of the editor
+     */
+    readonly document: Document;
     /**
      * Whether editor is running on Mac
      */
@@ -6062,6 +6107,11 @@ export interface PromotedLink {
     href: string;
 }
 
+/**
+ * The keyfor BorderFormat
+ */
+export type BorderKey = 'borderTop' | 'borderRight' | 'borderBottom' | 'borderLeft';
+
 /**
  * Editor plugin event interface
  */
@@ -6801,6 +6851,16 @@ export const entityProcessor: ElementProcessor<HTMLElement>;
  */
 export const tableProcessor: ElementProcessor<HTMLTableElement>;
 
+/**
+ * Content Model Element Processor for format container elements (e.g., blockquote, div)
+ * Processes elements that create FormatContainer blocks in the content model.
+ * This processor can be used in processorOverride to customize how specific elements are processed.
+ * @param group The parent block group
+ * @param element The DOM element to process
+ * @param context DOM to Content Model context
+ */
+export const formatContainerProcessor: ElementProcessor<HTMLElement>;
+
 /**
  * Get offset numbers of a regular (range based) selection.
  * If the selection start/end position is not in the given node, it will return -1 for the related value
@@ -7408,7 +7468,7 @@ export function parseValueWithUnit(value?: string, currentSizePxOrElement?: numb
 /**
  * Keys of border items
  */
-export const BorderKeys: (keyof BorderFormat & keyof CSSStyleDeclaration)[];
+export const BorderKeys: (BorderKey & keyof BorderFormat & keyof CSSStyleDeclaration)[];
 
 /**
  * List of deprecated colors
@@ -7593,12 +7653,22 @@ export function retrieveDocumentMetadata(doc: Document): Record<string, string>;
 
 /**
  * Edit and transform color of elements between light mode and dark mode
+ * By default, text and background colors are transformed for all elements.
  * @param rootNode The root DOM node to transform
  * @param includeSelf True to transform the root node as well, otherwise false
  * @param direction To specify the transform direction, light to dark, or dark to light
  * @param darkColorHandler The dark color handler object to help do color transformation
+ * @param transformColorOptions Configuration options for controlling which elements and styles undergo color transformation.
  */
-export function transformColor(rootNode: Node, includeSelf: boolean, direction: 'lightToDark' | 'darkToLight', darkColorHandler?: DarkColorHandler): void;
+export function transformColor(rootNode: Node, includeSelf: boolean, direction: 'lightToDark' | 'darkToLight', darkColorHandler?: DarkColorHandler, transformColorOptions?: TransformColorOptions): void;
+
+/**
+ * Configuration options for controlling which elements and styles undergo color transformation.
+ * By default, text and background colors are transformed for all elements.
+ */
+export interface TransformColorOptions {
+    tableBorders: boolean;
+}
 
 /**
  * Normalize font family string to a standard format
@@ -7903,7 +7973,7 @@ export function setFirstColumnFormatBorders(rows: ShallowMutableContentModelTabl
  * Normalize a Content Model table, make sure:
  * 1. Fist cells are not spanned
  * 2. Only first column and row can have headers
- * 3. All cells have content and width
+ * 3. All cells have content
  * 4. Table and table row have correct width/height
  * 5. Spanned cell has no child blocks
  * 6. default format is correctly applied
@@ -8620,8 +8690,9 @@ export function getContentForCopy(editor: IEditor, isCut: boolean, event: Clipbo
  * @param rows Number of rows in table
  * @param tableMetadataFormat (Optional) The table format that are stored as metadata. If not passed, the default format will be applied: background color: #FFF; border color: #ABABAB
  * @param format (Optional) The table format used for style attributes
+ * @param cellFormat (Optional) custom format for table cells, except for borders styles, for borders use tableMetadataFormat
  */
-export function insertTable(editor: IEditor, columns: number, rows: number, tableMetadataFormat?: Partial<TableMetadataFormat>, format?: ContentModelTableFormat): void;
+export function insertTable(editor: IEditor, columns: number, rows: number, tableMetadataFormat?: Partial<TableMetadataFormat>, format?: ContentModelTableFormat, customCellFormat?: ContentModelTableCellFormat): void;
 
 /**
  * Format current focused table with the given format
@@ -9202,7 +9273,7 @@ export type OnTableEditorCreatedCallback = (featureType: TableEditFeatureName, e
 /**
  * Names of table edit features
  */
-export type TableEditFeatureName = 'HorizontalTableInserter' | 'VerticalTableInserter' | 'TableMover' | 'TableResizer' | 'TableSelector' | 'CellResizer';
+export type TableEditFeatureName = 'HorizontalTableInserter' | 'VerticalTableInserter' | 'TableMover' | 'TableResizer' | 'TableSelector' | 'CellResizer' | 'TableRowSelector' | 'TableColumnSelector';
 
 /**
  * Represents a table and its container (logical root)