@univerjs/core 0.5.3 → 0.5.4

package/lib/types/services/image-io/image-io.service.d.ts

@@ -1,8 +1,20 @@
 import { Observable } from 'rxjs';
 import { Nullable } from '../../shared/types';
+/**
+ * The type of image data source
+ */
 export declare enum ImageSourceType {
+    /**
+     * The image source is a URL, for example: https://avatars.githubusercontent.com/u/61444807?s=48&v=4
+     */
     URL = "URL",
+    /**
+     * The image source is a UUID, this ID is generated by the Univer image hosting service. For specific generation rules, please refer to the Univer image hosting service API documentation.
+     */
     UUID = "UUID",
+    /**
+     * The image source is BASE64, for example: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAALCAYAAAB7ZJ...
+     */
     BASE64 = "BASE64"
 }
 export declare enum ImageUploadStatusType {

package/lib/types/shared/check-if-move.d.ts

@@ -1,4 +1,4 @@
-import { ITransformState } from '../types/interfaces/i-document-data';
+import { ITransformState } from '../types/interfaces/i-drawing';
 import { Nullable } from './types';
 export declare const MOVE_BUFFER_VALUE = 2;
 export declare const ROTATE_BUFFER_VALUE = 1;

package/lib/types/shared/rectangle.d.ts

@@ -1,50 +1,305 @@
 import { Nullable } from './types';
 import { IRange, IRectLTRB } from '../sheets/typedef';
 /**
- * This class provides a set of methods to calculate `IRange`.
+ * This class provides a set of methods to calculate and manipulate rectangular ranges (IRange).
+ * A range represents a rectangular area in a grid, defined by start/end rows and columns.
+ * @example
+ * ```typescript
+ * // Example range representing cells from A1 to C3
+ * const range: IRange = {
+ *   startRow: 0,
+ *   startColumn: 0,
+ *   endRow: 2,
+ *   endColumn: 2,
+ *   rangeType: RANGE_TYPE.NORMAL
+ * };
+ * ```
  */
 export declare class Rectangle {
+    /**
+     * Creates a deep copy of an IRange object
+     * @param src
+     * @example
+     * ```typescript
+     * const original = { startRow: 0, startColumn: 0, endRow: 1, endColumn: 1 };
+     * const copy = Rectangle.clone(original);
+     * // copy = { startRow: 0, startColumn: 0, endRow: 1, endColumn: 1 }
+     * ```
+     */
     static clone(src: IRange): IRange;
+    /**
+     * Checks if two ranges are equal by comparing their properties
+     * @param src
+     * @param target
+     * @example
+     * ```typescript
+     * const range1 = { startRow: 0, startColumn: 0, endRow: 1, endColumn: 1 };
+     * const range2 = { startRow: 0, startColumn: 0, endRow: 1, endColumn: 1 };
+     * const areEqual = Rectangle.equals(range1, range2); // true
+     * ```
+     */
     static equals(src: IRange, target: IRange): boolean;
     /**
-     * Check intersects of normal range(RANGE_TYPE.NORMAL)
-     * For other types of ranges, please consider using the intersects method.
+     * Quickly checks if two normal ranges intersect. For specialized range types,
+     * use the intersects() method instead.
      * @param rangeA
      * @param rangeB
-     * @returns boolean
+     * @example
+     * ```typescript
+     * const range1 = { startRow: 0, startColumn: 0, endRow: 2, endColumn: 2 };
+     * const range2 = { startRow: 1, startColumn: 1, endRow: 3, endColumn: 3 };
+     * const doIntersect = Rectangle.simpleRangesIntersect(range1, range2); // true
+     * ```
      */
     static simpleRangesIntersect(rangeA: IRange, rangeB: IRange): boolean;
+    /**
+     * Checks if two ranges intersect, handling special range types (ROW, COLUMN)
+     * @param src
+     * @param target
+     * @example
+     * ```typescript
+     * const rowRange = {
+     *   startRow: 0, endRow: 2,
+     *   startColumn: NaN, endColumn: NaN,
+     *   rangeType: RANGE_TYPE.ROW
+     * };
+     * const colRange = {
+     *   startRow: NaN, endRow: NaN,
+     *   startColumn: 0, endColumn: 2,
+     *   rangeType: RANGE_TYPE.COLUMN
+     * };
+     * const doIntersect = Rectangle.intersects(rowRange, colRange); // true
+     * ```
+     */
     static intersects(src: IRange, target: IRange): boolean;
     /**
-     *
-     * @deprecated use `getIntersectRange` instead. This method does not handle NaN and does not return the correct rangeType
+     * Gets the intersection range between two ranges
+     * @param src
+     * @param target
+     * @deprecated use `getIntersectRange` instead
+     * @example
+     * ```typescript
+     * const range1 = { startRow: 0, startColumn: 0, endRow: 2, endColumn: 2 };
+     * const range2 = { startRow: 1, startColumn: 1, endRow: 3, endColumn: 3 };
+     * const intersection = Rectangle.getIntersects(range1, range2);
+     * // intersection = { startRow: 1, startColumn: 1, endRow: 2, endColumn: 2 }
+     * ```
      */
     static getIntersects(src: IRange, target: IRange): Nullable<IRange>;
+    /**
+     * Checks if one range completely contains another range
+     * @param src
+     * @param target
+     * @example
+     * ```typescript
+     * const outer = { startRow: 0, startColumn: 0, endRow: 3, endColumn: 3 };
+     * const inner = { startRow: 1, startColumn: 1, endRow: 2, endColumn: 2 };
+     * const contains = Rectangle.contains(outer, inner); // true
+     * ```
+     */
     static contains(src: IRange, target: IRange): boolean;
+    /**
+     * Checks if one range strictly contains another range (not equal)
+     * @param src
+     * @param target
+     * @example
+     * ```typescript
+     * const outer = { startRow: 0, startColumn: 0, endRow: 3, endColumn: 3 };
+     * const same = { startRow: 0, startColumn: 0, endRow: 3, endColumn: 3 };
+     * const realContains = Rectangle.realContain(outer, same); // false
+     * ```
+     */
     static realContain(src: IRange, target: IRange): boolean;
+    /**
+     * Creates a union range that encompasses all input ranges
+     * @param {...any} ranges
+     * @example
+     * ```typescript
+     * const range1 = { startRow: 0, startColumn: 0, endRow: 1, endColumn: 1 };
+     * const range2 = { startRow: 2, startColumn: 2, endRow: 3, endColumn: 3 };
+     * const union = Rectangle.union(range1, range2);
+     * // union = { startRow: 0, startColumn: 0, endRow: 3, endColumn: 3 }
+     * ```
+     */
     static union(...ranges: IRange[]): IRange;
+    /**
+     * Creates a union range considering special range types (ROW, COLUMN)
+     * @param {...any} ranges
+     * @example
+     * ```typescript
+     * const rowRange = {
+     *   startRow: 0, endRow: 2,
+     *   rangeType: RANGE_TYPE.ROW
+     * };
+     * const normalRange = {
+     *   startRow: 1, startColumn: 1,
+     *   endRow: 3, endColumn: 3
+     * };
+     * const union = Rectangle.realUnion(rowRange, normalRange);
+     * // Result will have NaN for columns due to ROW type
+     * ```
+     */
     static realUnion(...ranges: IRange[]): IRange;
+    /**
+     * Converts an absolute range to a relative range based on an origin range
+     * @param range
+     * @param originRange
+     * @example
+     * ```typescript
+     * const range = { startRow: 5, startColumn: 5, endRow: 7, endColumn: 7 };
+     * const origin = { startRow: 3, startColumn: 3, endRow: 8, endColumn: 8 };
+     * const relative = Rectangle.getRelativeRange(range, origin);
+     * // relative = { startRow: 2, startColumn: 2, endRow: 2, endColumn: 2 }
+     * ```
+     */
     static getRelativeRange: (range: IRange, originRange: IRange) => IRange;
+    /**
+     * Converts a relative range back to an absolute range based on origin
+     * @param relativeRange
+     * @param originRange
+     * @param absoluteRange
+     * @example
+     * ```typescript
+     * const relative = { startRow: 2, startColumn: 2, endRow: 2, endColumn: 2 };
+     * const origin = { startRow: 3, startColumn: 3, endRow: 8, endColumn: 8 };
+     * const absolute = Rectangle.getPositionRange(relative, origin);
+     * // absolute = { startRow: 5, startColumn: 5, endRow: 7, endColumn: 7 }
+     * ```
+     */
     static getPositionRange: (relativeRange: IRange, originRange: IRange, absoluteRange?: IRange) => IRange;
+    /**
+     * Moves a range horizontally by a specified step and optionally extends it
+     * @param range
+     * @param step
+     * @param length
+     * @example
+     * ```typescript
+     * const range = { startRow: 0, startColumn: 0, endRow: 1, endColumn: 1 };
+     * const moved = Rectangle.moveHorizontal(range, 2, 1);
+     * // moved = { startRow: 0, startColumn: 2, endRow: 1, endColumn: 4 }
+     * ```
+     */
     static moveHorizontal: (range: IRange, step?: number, length?: number) => IRange;
+    /**
+     * Moves a range vertically by a specified step and optionally extends it
+     * @param range
+     * @param step
+     * @param length
+     * @example
+     * ```typescript
+     * const range = { startRow: 0, startColumn: 0, endRow: 1, endColumn: 1 };
+     * const moved = Rectangle.moveVertical(range, 2, 1);
+     * // moved = { startRow: 2, startColumn: 0, endRow: 4, endColumn: 1 }
+     * ```
+     */
     static moveVertical: (range: IRange, step?: number, length?: number) => IRange;
+    /**
+     * Moves a range by specified offsets in both directions
+     * @param range
+     * @param offsetX
+     * @param offsetY
+     * @example
+     * ```typescript
+     * const range = { startRow: 0, startColumn: 0, endRow: 1, endColumn: 1 };
+     * const moved = Rectangle.moveOffset(range, 2, 3);
+     * // moved = { startRow: 3, startColumn: 2, endRow: 4, endColumn: 3 }
+     * ```
+     */
     static moveOffset: (range: IRange, offsetX: number, offsetY: number) => IRange;
     /**
-     * Subtract range2 from range1, the result is is horizontal first then vertical
-     * @param {IRange} range1 The source range
-     * @param {IRange} range2 The range to be subtracted
-     * @returns {IRange[]} Returns the array of ranges, which are the result not intersected with range1
+     * Subtracts one range from another, returning the remaining areas as separate ranges
+     * @param range1
+     * @param range2
+     * @example
+     * ```typescript
+     * const range1 = { startRow: 0, startColumn: 0, endRow: 3, endColumn: 3 };
+     * const range2 = { startRow: 1, startColumn: 1, endRow: 2, endColumn: 2 };
+     * const result = Rectangle.subtract(range1, range2);
+     * // Results in up to 4 ranges representing the non-overlapping areas
+     * ```
      */
     static subtract(range1: IRange, range2: IRange): IRange[];
     /**
-     * Combine smaller rectangles into larger ones
+     * Merges overlapping or adjacent ranges into larger ranges
      * @param ranges
-     * @returns
+     * @example
+     * ```typescript
+     * const ranges = [
+     *   { startRow: 0, startColumn: 0, endRow: 1, endColumn: 1 },
+     *   { startRow: 1, startColumn: 1, endRow: 2, endColumn: 2 }
+     * ];
+     * const merged = Rectangle.mergeRanges(ranges);
+     * // Combines overlapping ranges into larger ones
+     * ```
      */
     static mergeRanges(ranges: IRange[]): IRange[];
+    /**
+     * Splits overlapping ranges into a grid of non-overlapping ranges
+     * @param ranges
+     * @example
+     * ```typescript
+     * const ranges = [
+     *   { startRow: 0, startColumn: 0, endRow: 2, endColumn: 2 },
+     *   { startRow: 1, startColumn: 1, endRow: 3, endColumn: 3 }
+     * ];
+     * const grid = Rectangle.splitIntoGrid(ranges);
+     * // Splits into non-overlapping grid sections
+     * ```
+     */
     static splitIntoGrid(ranges: IRange[]): IRange[];
+    /**
+     * Subtracts multiple ranges from multiple ranges
+     * @param ranges1
+     * @param ranges2
+     * @example
+     * ```typescript
+     * const ranges1 = [{ startRow: 0, startColumn: 0, endRow: 3, endColumn: 3 }];
+     * const ranges2 = [
+     *   { startRow: 1, startColumn: 1, endRow: 2, endColumn: 2 },
+     *   { startRow: 2, startColumn: 2, endRow: 3, endColumn: 3 }
+     * ];
+     * const result = Rectangle.subtractMulti(ranges1, ranges2);
+     * // Returns remaining non-overlapping areas
+     * ```
+     */
     static subtractMulti(ranges1: IRange[], ranges2: IRange[]): IRange[];
+    /**
+     * Checks if two rectangles defined by left, top, right, bottom coordinates intersect
+     * @param rect1
+     * @param rect2
+     * @example
+     * ```typescript
+     * const rect1 = { left: 0, top: 0, right: 10, bottom: 10 };
+     * const rect2 = { left: 5, top: 5, right: 15, bottom: 15 };
+     * const intersects = Rectangle.hasIntersectionBetweenTwoRect(rect1, rect2); // true
+     * ```
+     */
     static hasIntersectionBetweenTwoRect(rect1: IRectLTRB, rect2: IRectLTRB): boolean;
+    /**
+     * Gets the intersection area between two rectangles defined by LTRB coordinates
+     * @param rect1
+     * @param rect2
+     * @example
+     * ```typescript
+     * const rect1 = { left: 0, top: 0, right: 10, bottom: 10 };
+     * const rect2 = { left: 5, top: 5, right: 15, bottom: 15 };
+     * const intersection = Rectangle.getIntersectionBetweenTwoRect(rect1, rect2);
+     * // Returns { left: 5, top: 5, right: 10, bottom: 10, width: 5, height: 5 }
+     * ```
+     */
     static getIntersectionBetweenTwoRect(rect1: IRectLTRB, rect2: IRectLTRB): Required<IRectLTRB> | null;
+    /**
+     * Sorts an array of ranges by startRow, then by startColumn
+     * @param ranges
+     * @example
+     * ```typescript
+     * const ranges = [
+     *   { startRow: 1, startColumn: 0, endRow: 2, endColumn: 1 },
+     *   { startRow: 0, startColumn: 0, endRow: 1, endColumn: 1 }
+     * ];
+     * const sorted = Rectangle.sort(ranges);
+     * // Ranges will be sorted by startRow first, then startColumn
+     * ```
+     */
     static sort(ranges: IRange[]): IRange[];
 }

package/lib/types/sheets/column-manager.d.ts

@@ -1,7 +1,7 @@
 import { IObjectArrayPrimitiveType } from '../shared/object-matrix';
 import { Nullable } from '../shared/types';
 import { IStyleData } from '../types/interfaces';
-import { IColumnData, IRange, IWorksheetData } from './typedef';
+import { CustomData, IColumnData, IRange, IWorksheetData } from './typedef';
 /**
  * Manage configuration information of all columns, get column width, column length, set column width, etc.
  */
@@ -69,4 +69,6 @@ export declare class ColumnManager {
      * @returns {Partial<IColumnData>} columnData
      */
     getColumnOrCreate(columnPos: number): Partial<IColumnData>;
+    setCustomMetadata(index: number, custom: CustomData | undefined): void;
+    getCustomMetadata(index: number): CustomData | undefined;
 }

package/lib/types/sheets/row-manager.d.ts

@@ -1,8 +1,8 @@
 import { Nullable } from '../shared/types';
 import { IStyleData } from '../types/interfaces';
+import { CustomData, IRange, IRowData, IWorksheetData } from './typedef';
 import { SheetViewModel } from './view-model';
 import { IObjectArrayPrimitiveType } from '../shared/object-matrix';
-import { IRange, IRowData, IWorksheetData } from './typedef';
 /**
  * Manage configuration information of all rows, get row height, row length, set row height, etc.
  */
@@ -68,4 +68,6 @@ export declare class RowManager {
      * @returns {number} row count
      */
     getSize(): number;
+    setCustomMetadata(index: number, custom: CustomData | undefined): void;
+    getCustomMetadata(index: number): CustomData | undefined;
 }

package/lib/types/sheets/typedef.d.ts

@@ -50,6 +50,10 @@ export interface IWorkbookData {
      * Resources of the Univer Sheet. It is used to store the data of other plugins.
      */
     resources?: IResources;
+    /**
+     * User stored custom fields
+     */
+    custom?: CustomData;
 }
 /**
  * Snapshot of a worksheet.
@@ -106,6 +110,10 @@ export interface IWorksheetData {
      */
     gridlinesColor?: string;
     rightToLeft: BooleanNumber;
+    /**
+     * User stored custom fields
+     */
+    custom?: CustomData;
 }
 export type CustomData = Nullable<Record<string, any>>;
 /**

package/lib/types/sheets/workbook.d.ts

@@ -1,6 +1,6 @@
 import { Observable } from 'rxjs';
 import { Nullable } from '../shared';
-import { IRangeType, IWorkbookData, IWorksheetData } from './typedef';
+import { CustomData, IRangeType, IWorkbookData, IWorksheetData } from './typedef';
 import { UnitModel, UniverInstanceType } from '../common/unit';
 import { ILogService } from '../services/log/log.service';
 import { Styles } from './styles';
@@ -123,4 +123,14 @@ export declare class Workbook extends UnitModel<IWorkbookData, UniverInstanceTyp
      * Get Default Sheet
      */
     private _parseWorksheetSnapshots;
+    /**
+     * Get custom metadata of workbook
+     * @returns {CustomData | undefined} custom metadata
+     */
+    getCustomMetadata(): CustomData | undefined;
+    /**
+     * Set custom metadata of workbook
+     * @param {CustomData | undefined} custom custom metadata
+     */
+    setCustomMetadata(custom: CustomData | undefined): void;
 }

package/lib/types/sheets/worksheet.d.ts

@@ -2,7 +2,7 @@ import { IInterceptor } from '../common/interceptor';
 import { Nullable, ObjectMatrix } from '../shared';
 import { IPaddingData, IStyleData, ITextRotation } from '../types/interfaces';
 import { Styles } from './styles';
-import { ICellData, ICellDataForSheetInterceptor, ICellDataWithSpanAndDisplay, IFreeze, IRange, ISelectionCell, IWorksheetData, CellModeEnum } from './typedef';
+import { CustomData, ICellData, ICellDataForSheetInterceptor, ICellDataWithSpanAndDisplay, IFreeze, IRange, ISelectionCell, IWorksheetData, CellModeEnum } from './typedef';
 import { DocumentDataModel } from '../docs';
 import { BooleanNumber, CellValueType, HorizontalAlign, TextDirection, VerticalAlign, WrapStrategy } from '../types/enum';
 import { ColumnManager } from './column-manager';
@@ -391,6 +391,16 @@ export declare class Worksheet {
      */
     getBlankCellDocumentModel(cell: Nullable<ICellData>): IDocumentLayoutObject;
     getCellDocumentModelWithFormula(cell: ICellData): Nullable<IDocumentLayoutObject>;
+    /**
+     * Get custom metadata of worksheet
+     * @returns {CustomData | undefined} custom metadata
+     */
+    getCustomMetadata(): CustomData | undefined;
+    /**
+     * Set custom metadata of workbook
+     * @param {CustomData | undefined} custom custom metadata
+     */
+    setCustomMetadata(custom: CustomData | undefined): void;
 }
 /**
  * A cell info including its span (if it is the top-left cell of a merged cell).

package/lib/types/types/const/const.d.ts

@@ -127,6 +127,15 @@ export declare const DEFAULT_STYLES: {
         l: number;
     };
     n: null;
+    /**
+     * border
+     */
+    bd: {
+        b: null;
+        l: null;
+        r: null;
+        t: null;
+    };
 };
 export declare const DEFAULT_SLIDE: {
     id: string;

package/lib/types/types/interfaces/i-document-data.d.ts

@@ -1,6 +1,6 @@
-import { IAbsoluteTransform, ISize } from '../../shared/shape';
-import { Nullable } from '../../shared/types';
+import { ISize } from '../../shared/shape';
 import { BooleanNumber, CellValueType, HorizontalAlign, LocaleType, TextDirection, VerticalAlign, WrapStrategy } from '../enum';
+import { IDrawingParam } from './i-drawing';
 import { IMention } from './i-mention';
 import { IColorStyle, IStyleBase } from './i-style-data';
 /**
@@ -842,53 +842,3 @@ export declare enum PageOrientType {
     PORTRAIT = 0,
     LANDSCAPE = 1
 }
-/** @deprecated */
-export declare enum ArrangeTypeEnum {
-    forward = 0,
-    backward = 1,
-    front = 2,
-    back = 3
-}
-/** @deprecated */
-export declare enum DrawingTypeEnum {
-    UNRECOGNIZED = -1,
-    DRAWING_IMAGE = 0,
-    DRAWING_SHAPE = 1,
-    DRAWING_CHART = 2,
-    DRAWING_TABLE = 3,
-    DRAWING_SMART_ART = 4,
-    DRAWING_VIDEO = 5,
-    DRAWING_GROUP = 6,
-    DRAWING_UNIT = 7,
-    DRAWING_DOM = 8
-}
-/** @deprecated */
-export type DrawingType = DrawingTypeEnum | number;
-/** @deprecated */
-export interface IDrawingSpace {
-    unitId: string;
-    subUnitId: string;
-}
-/** @deprecated */
-export interface IDrawingSearch extends IDrawingSpace {
-    drawingId: string;
-}
-/** @deprecated */
-export interface IRotationSkewFlipTransform {
-    angle?: number;
-    skewX?: number;
-    skewY?: number;
-    flipX?: boolean;
-    flipY?: boolean;
-}
-/** @deprecated */
-export interface ITransformState extends IAbsoluteTransform, IRotationSkewFlipTransform {
-}
-/** @deprecated */
-export interface IDrawingParam extends IDrawingSearch {
-    drawingType: DrawingType;
-    transform?: Nullable<ITransformState>;
-    transforms?: Nullable<ITransformState[]>;
-    isMultiTransform?: BooleanNumber;
-    groupId?: string;
-}

package/lib/types/types/interfaces/i-drawing.d.ts

@@ -0,0 +1,93 @@
+import { IAbsoluteTransform } from '../../shared/shape';
+import { Nullable } from '../../shared/types';
+import { BooleanNumber } from '../enum/text-style';
+/**
+ * The layer type of Drawing, used to distinguish between forward, backward, front, and back
+ */
+export declare enum ArrangeTypeEnum {
+    /**
+     * Move the current object one layer up, possibly covering other objects
+     */
+    forward = 0,
+    /**
+     * Move the current object one layer down, possibly being covered by other objects
+     */
+    backward = 1,
+    /**
+     * Move the current object to the top layer
+     */
+    front = 2,
+    /**
+     * Move the current object to the bottom layer
+     */
+    back = 3
+}
+/**
+ * Types of drawings, used to distinguish between images, shapes, charts, tables, SmartArt, videos, DrawingGroup, Unit, Dom, etc.
+ */
+export declare enum DrawingTypeEnum {
+    /**
+     * Unrecognized drawing type, requires user to determine
+     */
+    UNRECOGNIZED = -1,
+    /**
+     * Image
+     */
+    DRAWING_IMAGE = 0,
+    /**
+     * Shape, similar to shapes in Office, including circles, rectangles, lines, etc.
+     */
+    DRAWING_SHAPE = 1,
+    /**
+     * Chart
+     */
+    DRAWING_CHART = 2,
+    /**
+     * Table
+     */
+    DRAWING_TABLE = 3,
+    /**
+     * SmartArt, similar to SmartArt in Office
+     */
+    DRAWING_SMART_ART = 4,
+    /**
+     * Video
+     */
+    DRAWING_VIDEO = 5,
+    /**
+     * Drawing group
+     */
+    DRAWING_GROUP = 6,
+    /**
+     * Univer object, allows inserting images, tables, documents, slides as floating objects into the document
+     */
+    DRAWING_UNIT = 7,
+    /**
+     * Dom element, allows inserting HTML elements as floating objects into the document
+     */
+    DRAWING_DOM = 8
+}
+export type DrawingType = DrawingTypeEnum | number;
+export interface IDrawingSpace {
+    unitId: string;
+    subUnitId: string;
+}
+export interface IDrawingSearch extends IDrawingSpace {
+    drawingId: string;
+}
+export interface IRotationSkewFlipTransform {
+    angle?: number;
+    skewX?: number;
+    skewY?: number;
+    flipX?: boolean;
+    flipY?: boolean;
+}
+export interface ITransformState extends IAbsoluteTransform, IRotationSkewFlipTransform {
+}
+export interface IDrawingParam extends IDrawingSearch {
+    drawingType: DrawingType;
+    transform?: Nullable<ITransformState>;
+    transforms?: Nullable<ITransformState[]>;
+    isMultiTransform?: BooleanNumber;
+    groupId?: string;
+}

package/lib/types/types/interfaces/i-slide-data.d.ts

@@ -3,7 +3,8 @@ import { IKeyType, Nullable } from '../../shared/types';
 import { IWorksheetData } from '../../sheets/typedef';
 import { LocaleType, ThemeColorType } from '../enum';
 import { ShapeType } from '../enum/prst-geom-type';
-import { ICustomBlock, IDocumentData, ILists, ITransformState } from './i-document-data';
+import { ICustomBlock, IDocumentData, ILists } from './i-document-data';
+import { ITransformState } from './i-drawing';
 import { IImageProperties } from './i-image-properties';
 import { IPlaceholder } from './i-placeholder';
 import { IShapeProperties } from './i-shape-properties';

package/lib/types/types/interfaces/i-style-data.d.ts

@@ -6,9 +6,21 @@ import { ThemeColorType } from '../enum/theme-color-type';
  * Properties of text decoration
  */
 export interface ITextDecoration {
+    /**
+     * show
+     */
     s: BooleanNumber;
+    /**
+     * color is follow the font color. the default value is TRUE, it's also TRUE if it is undefined. the cl has no effect when `c` is TRUE.
+     */
     c?: BooleanNumber;
+    /**
+     * color
+     */
     cl?: IColorStyle;
+    /**
+     * lineType
+     */
     t?: TextDecoration;
 }
 /**

package/lib/types/types/interfaces/index.d.ts

@@ -15,6 +15,7 @@
  */
 export * from './i-document-data';
 export * from './i-document-data-interceptor';
+export * from './i-drawing';
 export * from './i-image-properties';
 export * from './i-mention';
 export * from './i-need-check-disposable';