@univerjs/core 0.5.3 → 0.5.4-nightly.202501131606

package/lib/types/facade/f-util.d.ts

@@ -1,25 +1,18 @@
-/**
- * Copyright 2023-present DreamNum Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
+import { Rectangle, Tools } from '../shared';
 export declare class FUtil {
-    static Range: {
-        new (): Range;
-        prototype: Range;
-        readonly START_TO_START: 0;
-        readonly START_TO_END: 1;
-        readonly END_TO_END: 2;
-        readonly END_TO_START: 3;
-    };
+    static _instance: FUtil | null;
+    static get(): FUtil;
+    static extend(source: any): void;
+    /**
+     * Rectangle utils, including range operations likes merge, subtract, split
+     */
+    get rectangle(): typeof Rectangle;
+    /**
+     * Number format utils, including parse and strigify about date, price, etc
+     */
+    get numfmt(): import('../shared/types/numfmt.type').INumfmt;
+    /**
+     * common tools
+     */
+    get tools(): typeof Tools;
 }

package/lib/types/index.d.ts

@@ -20,7 +20,8 @@ export { isBooleanString } from './common/boolean';
 export { createInternalEditorID, DEFAULT_EMPTY_DOCUMENT_VALUE, DOCS_FORMULA_BAR_EDITOR_UNIT_ID_KEY, DOCS_NORMAL_EDITOR_UNIT_ID_KEY, DOCS_ZEN_EDITOR_UNIT_ID_KEY, IS_ROW_STYLE_PRECEDE_COLUMN_STYLE, isInternalEditorID, } from './common/const';
 export * from './common/di';
 export { shallowEqual } from './common/equal';
-export { CustomCommandExecutionError } from './common/error';
+export { ParagraphStyleBuilder, ParagraphStyleValue, RichTextBuilder, RichTextValue, TextDecorationBuilder, TextStyleBuilder, TextStyleValue } from './docs/data-model/rich-text-builder';
+export { CanceledError, CustomCommandExecutionError } from './common/error';
 export { throttle } from './common/function';
 export type { IAsyncInterceptor, ICellInterceptor, IComposeInterceptors, IInterceptor, InterceptorHandler } from './common/interceptor';
 export { AsyncInterceptorManager, composeInterceptors, createAsyncInterceptorKey, createInterceptorKey, InterceptorEffectEnum, InterceptorManager } from './common/interceptor';
@@ -33,6 +34,7 @@ export { FHooks } from './facade/f-hooks';
 export { FBlob, type IFBlobSource } from './facade/f-blob';
 export { FEventName, type IEventBase, type IEventParamConfig } from './facade/f-event';
 export { FEnum } from './facade/f-enum';
+export { FUtil } from './facade/f-util';
 export { isNumeric, isSafeNumeric } from './common/number';
 export { Registry, RegistryAsMap } from './common/registry';
 export { requestImmediateMacroTask } from './common/request-immediate-macro-task';
@@ -51,8 +53,7 @@ export { updateAttributeByDelete } from './docs/data-model/text-x/apply-utils/de
 export { updateAttributeByInsert } from './docs/data-model/text-x/apply-utils/insert-apply';
 export { TextX } from './docs/data-model/text-x/text-x';
 export type { TPriority } from './docs/data-model/text-x/text-x';
-export { composeBody, getBodySlice, SliceBodyType } from './docs/data-model/text-x/utils';
-export { getCustomDecorationSlice, getCustomRangeSlice, normalizeBody } from './docs/data-model/text-x/utils';
+export { composeBody, getBodySlice, getCustomBlockSlice, getCustomDecorationSlice, getCustomRangeSlice, getParagraphsSlice, getSectionBreakSlice, getTableSlice, getTextRunSlice, normalizeBody, SliceBodyType, } from './docs/data-model/text-x/utils';
 export { EventState, EventSubject, fromEventSubject, type IEventObserver } from './observer/observable';
 export { AuthzIoLocalService } from './services/authz-io/authz-io-local.service';
 export { IAuthzIoService } from './services/authz-io/type';

package/lib/types/services/context/context.d.ts

@@ -23,6 +23,7 @@ export declare const EDITOR_ACTIVATED = "EDITOR_ACTIVATED";
 export declare const FOCUSING_EDITOR_INPUT_FORMULA = "FOCUSING_EDITOR_INPUT_FORMULA";
 /** The focusing state of the formula editor (Fx bar). */
 export declare const FOCUSING_FX_BAR_EDITOR = "FOCUSING_FX_BAR_EDITOR";
+/** The focusing state of the cell editor. */
 export declare const FOCUSING_UNIVER_EDITOR = "FOCUSING_UNIVER_EDITOR";
 export declare const FOCUSING_EDITOR_STANDALONE = "FOCUSING_EDITOR_INPUT_FORMULA";
 /** The focusing state of the editor in side panel, such as Chart Editor Panel. */

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;
-}