@univerjs/engine-render 0.1.12 → 0.1.13

package/lib/types/base-object.d.ts

@@ -1,11 +1,12 @@
-import { EventState, IKeyValue, Nullable, Observer, Disposable, Observable } from '@univerjs/core';
+import { EventState, IKeyValue, ITransformState, Nullable, Observer, Disposable, Observable } from '@univerjs/core';
 import { EVENT_TYPE, CURSOR_TYPE, RENDER_CLASS_TYPE } from './basics/const';
 import { IDragEvent, IMouseEvent, IPointerEvent, IWheelEvent } from './basics/i-events';
 import { IObjectFullState, ITransformChangeState } from './basics/interfaces';
 import { Transform } from './basics/transform';
-import { IViewportBound, Vector2 } from './basics/vector2';
+import { IViewportInfo, Vector2 } from './basics/vector2';
 import { UniverRenderingContext } from './context';
 import { Layer } from './layer';
+import { ITransformerConfig } from './basics/transformer-config';
 
 export declare const BASE_OBJECT_ARRAY: string[];
 export declare abstract class BaseObject extends Disposable {
@@ -30,6 +31,7 @@ export declare abstract class BaseObject extends Disposable {
     onDisposeObserver: Observable<BaseObject>;
     protected _oKey: string;
     protected _dirty: boolean;
+    protected _forceDirty: boolean;
     private _top;
     private _topOrigin;
     private _left;
@@ -53,11 +55,12 @@ export declare abstract class BaseObject extends Disposable {
     private _debounceParentDirty;
     private _transform;
     private _cursor;
-    private _isTransformer;
+    private _transformerConfig;
     private _forceRender;
     private _layer;
     constructor(key?: string);
     get transform(): Transform;
+    transformForAngle(transform: Transform): Transform;
     get topOrigin(): string | number;
     get leftOrigin(): string | number;
     get widthOrigin(): string | number;
@@ -73,6 +76,10 @@ export declare abstract class BaseObject extends Disposable {
     get scaleY(): number;
     get ancestorScaleX(): number;
     get ancestorScaleY(): number;
+    get ancestorLeft(): any;
+    get ancestorTop(): any;
+    get ancestorTransform(): any;
+    get ancestorGroup(): Nullable<BaseObject>;
     get skewX(): number;
     get skewY(): number;
     get flipX(): boolean;
@@ -83,7 +90,6 @@ export declare abstract class BaseObject extends Disposable {
     get evented(): boolean;
     get visible(): boolean;
     get debounceParentDirty(): boolean;
-    get isTransformer(): boolean;
     get cursor(): CURSOR_TYPE;
     get layer(): Nullable<Layer>;
     set transform(trans: Transform);
@@ -91,7 +97,6 @@ export declare abstract class BaseObject extends Disposable {
     set parent(o: any);
     set evented(state: boolean);
     set debounceParentDirty(state: boolean);
-    set isTransformer(state: boolean);
     set cursor(val: CURSOR_TYPE);
     set layer(layer: Layer);
     protected set top(num: number | string);
@@ -106,7 +111,11 @@ export declare abstract class BaseObject extends Disposable {
     protected set flipY(flipY: boolean);
     protected set flipX(flipX: boolean);
     protected set skewY(skewY: number);
+    get transformerConfig(): ITransformerConfig;
+    set transformerConfig(config: ITransformerConfig);
+    get maxZIndex(): number;
     makeDirty(state?: boolean): this | undefined;
+    makeForceDirty(state?: boolean): void;
     makeDirtyNoDebounce(state?: boolean): this;
     isDirty(): boolean;
     translate(x?: number | string, y?: number | string): this;
@@ -115,24 +124,12 @@ export declare abstract class BaseObject extends Disposable {
     skew(skewX?: number, skewY?: number): this;
     flip(flipX?: boolean, flipY?: boolean): this;
     transformByState(option: IObjectFullState): this | undefined;
-    isRender(bounds?: IViewportBound): boolean | undefined;
+    isRender(bounds?: IViewportInfo): boolean | undefined;
     getParent(): any;
-    getState(): {
-        left: number;
-        top: number;
-        width: number;
-        height: number;
-        scaleX: number;
-        scaleY: number;
-        angle: number;
-        skewX: number;
-        skewY: number;
-        flipX: boolean;
-        flipY: boolean;
-    };
+    getState(): ITransformState;
     hide(): void;
     show(): void;
-    render(ctx: UniverRenderingContext, bounds?: IViewportBound): void;
+    render(ctx: UniverRenderingContext, bounds?: IViewportInfo): void;
     isHit(coord: Vector2): boolean;
     on(eventType: EVENT_TYPE, func: (evt: unknown, state: EventState) => void): Nullable<Observer<unknown>>;
     off(eventType: EVENT_TYPE, observer: Nullable<Observer<unknown>>): void;
@@ -158,7 +155,10 @@ export declare abstract class BaseObject extends Disposable {
     setCursor(val: CURSOR_TYPE): void;
     getEngine(): any;
     getObjects(): BaseObject[];
-    protected _getInverseCoord(coord: Vector2): Vector2;
+    getLayerIndex(): number;
+    applyTransform(): void;
+    removeTransform(): void;
+    getInverseCoord(coord: Vector2): Vector2;
     protected _setTransForm(): void;
     private _makeDirtyMix;
 }

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

@@ -123,8 +123,13 @@ export declare enum RENDER_CLASS_TYPE {
     CANVAS = "Canvas",
     VIEWPORT = "Viewport",
     LAYER = "Layer",
-    GROUP = "Group"
+    GROUP = "Group",
+    IMAGE = "Image",
+    SHAPE = "Shape",
+    TEXT = "Text"
 }
-export declare const DEFAULT_SELECTION_LAYER_INDEX = 1000;
 export declare const MAXIMUM_ROW_HEIGHT = 2000;
 export declare const FIX_ONE_PIXEL_BLUR_OFFSET = 0.5;
+export declare const DRAWING_OBJECT_LOWER_LAYER_INDEX = 3;
+export declare const DRAWING_OBJECT_LAYER_INDEX = 4;
+export declare const DRAWING_OBJECT_UPPER_LAYER_INDEX = 5;

package/lib/types/basics/group-transform.d.ts

@@ -0,0 +1,16 @@
+import { ITransformState } from '@univerjs/core';
+
+export declare function getGroupState(parentLeft: number, parentTop: number, objectStates: ITransformState[]): {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    angle: number;
+    scaleX: number;
+    scaleY: number;
+};
+export declare function transformObjectOutOfGroup(child: ITransformState, parent: ITransformState, groupOriginWidth: number, groupOriginHeight: number): {
+    left: number;
+    top: number;
+    angle: number;
+};

package/lib/types/basics/i-document-skeleton-cached.d.ts

@@ -1,4 +1,4 @@
-import { BulletAlignment, ColumnSeparatorType, DataStreamTreeTokenType, IDocumentRenderConfig, IDrawing, IIndentStart, INestingLevel, ITextStyle, PageOrientType } from '@univerjs/core';
+import { BulletAlignment, ColumnSeparatorType, DataStreamTreeTokenType, IDocDrawingBase, IDocumentRenderConfig, IIndentStart, INestingLevel, ITextStyle, PageOrientType } from '@univerjs/core';
 import { BreakPointType } from '../components/docs/layout/line-breaker/break';
 
 export interface IDocumentSkeletonCached extends ISkeletonResourceReference {
@@ -88,6 +88,7 @@ export interface IDocumentSkeletonLine {
     contentHeight: number;
     top: number;
     asc: number;
+    dsc: number;
     paddingTop: number;
     paddingBottom: number;
     marginTop: number;
@@ -133,7 +134,7 @@ export interface IDocumentSkeletonGlyph {
     parent?: IDocumentSkeletonDivide;
     url?: string;
     featureId?: string;
-    objectId?: string;
+    drawingId?: string;
 }
 export interface IDocumentSkeletonBullet extends IIndentStart {
     listId: string;
@@ -147,14 +148,14 @@ export interface IDocumentSkeletonBullet extends IIndentStart {
     bulletType?: boolean;
 }
 export interface IDocumentSkeletonDrawing {
-    objectId: string;
+    drawingId: string;
     aLeft: number;
     aTop: number;
     width: number;
     height: number;
     angle: number;
     initialState: boolean;
-    drawingOrigin: IDrawing;
+    drawingOrigin: IDocDrawingBase;
 }
 export interface IDocumentSkeletonFontStyle {
     fontString: string;

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

@@ -29,3 +29,4 @@ export * from './tools';
 export * from './transform';
 export * from './vector2';
 export * from './text-rotation';
+export * from './group-transform';

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

@@ -2,13 +2,14 @@ import { BooleanNumber, GridType, IDocStyleBase, IDocumentLayout, IOffset, IPara
 import { DocumentViewModel } from '../components/docs/view-model/document-view-model';
 import { IDocumentSkeletonBullet, IDocumentSkeletonDrawing, IDocumentSkeletonDrawingAnchor, IDocumentSkeletonFontStyle, IDocumentSkeletonFooter, IDocumentSkeletonGlyph, IDocumentSkeletonHeader } from './i-document-skeleton-cached';
 import { Vector2 } from './vector2';
+import { ITransformerConfig } from './transformer-config';
 
 export interface IObjectFullState extends ITransformState {
     strokeWidth?: number;
     zIndex?: number;
-    isTransformer?: boolean;
     forceRender?: boolean;
     debounceParentDirty?: boolean;
+    transformerConfig?: ITransformerConfig;
 }
 export interface IRect extends ISize, IOffset {
     points: Vector2[];
@@ -25,14 +26,8 @@ export declare enum TRANSFORM_CHANGE_OBSERVABLE_TYPE {
 }
 export interface ITransformChangeState {
     type: TRANSFORM_CHANGE_OBSERVABLE_TYPE;
-    value: number | string | boolean | {
-        x: number | string | boolean;
-        y: number | string | boolean;
-    } | IObjectFullState | ISceneTransformState;
-    preValue: number | string | boolean | {
-        x: number | string | boolean;
-        y: number | string | boolean;
-    } | IObjectFullState | ISceneTransformState;
+    value: IObjectFullState | ISceneTransformState;
+    preValue: IObjectFullState | ISceneTransformState;
 }
 export interface IFontLocale {
     fontList: string[];

package/lib/types/basics/offset-rotation-axis.d.ts

@@ -0,0 +1,3 @@
+import { Vector2 } from './vector2';
+
+export declare function offsetRotationAxis(referenceCoords: Vector2, angleDegree: number, vertexCoords: Vector2, centerCoords: Vector2): Vector2;

package/lib/types/basics/tools.d.ts

@@ -108,3 +108,37 @@ export declare function getSizeForDom(dom: HTMLElement): {
 };
 export declare function ptToPixel(pt: number): number;
 export declare function pixelToPt(px: number): number;
+/**
+ * 当前单元格在任意一个 viewRanges 中
+ * @param ranges
+ * @param rowIndex
+ * @param colIndex
+ * @returns
+ */
+export declare function inViewRanges(ranges: IRange[], rowIndex: number, colIndex: number): boolean;
+/**
+ * 在非下方区域中
+ * @param ranges
+ * @param rowIndex
+ * @returns
+ */
+export declare function inCurrentAndAboveViewRanges(ranges: IRange[], rowIndex: number): boolean;
+/**
+ * row 在任意一个 Range 中
+ * @param ranges
+ * @param rowIndex
+ * @returns
+ */
+export declare function inRowViewRanges(ranges: IRange[], rowIndex: number): boolean;
+/**
+ * 如果 range 有相交, 那么扩展到第一组 range 中.
+ * @param ranges
+ */
+export declare function mergeRangeIfIntersects(mainRanges: IRange[], ranges: IRange[]): IRange[];
+export declare function clampRanges(range: IRange): {
+    startRow: number;
+    startColumn: number;
+    endRow: number;
+    endColumn: number;
+};
+export declare function getSystemHighlightColor(): import('@univerjs/core').IRgbColor;

package/lib/types/basics/transform.d.ts

@@ -140,4 +140,12 @@ export declare class Transform {
      * @return {number[]} transform matrix
      */
     private _calcDimensionsMatrix;
+    convert2DOMMatrix2D(): {
+        a: number;
+        b: number;
+        c: number;
+        d: number;
+        e: number;
+        f: number;
+    };
 }

package/lib/types/basics/transformer-config.d.ts

@@ -0,0 +1,37 @@
+import { Nullable } from '@univerjs/core';
+import { BaseObject } from '../base-object';
+import { IMouseEvent, IPointerEvent } from './i-events';
+
+export interface ITransformerConfig {
+    isCropper?: boolean;
+    hoverEnabled?: boolean;
+    hoverEnterFunc?: Nullable<(e: IPointerEvent | IMouseEvent) => void>;
+    hoverLeaveFunc?: Nullable<(e: IPointerEvent | IMouseEvent) => void>;
+    rotateEnabled?: boolean;
+    rotationSnaps?: number[];
+    rotationSnapTolerance?: number;
+    rotateAnchorOffset?: number;
+    rotateSize?: number;
+    rotateCornerRadius?: number;
+    borderEnabled?: boolean;
+    borderStroke?: string;
+    borderStrokeWidth?: number;
+    borderDash?: number[];
+    borderSpacing?: number;
+    resizeEnabled?: boolean;
+    enabledAnchors?: number[];
+    anchorFill?: string;
+    anchorStroke?: string;
+    anchorStrokeWidth?: number;
+    anchorSize?: number;
+    anchorCornerRadius?: number;
+    keepRatio?: boolean;
+    centeredScaling?: boolean;
+    flipEnabled?: boolean;
+    ignoreStroke?: boolean;
+    boundBoxFunc?: Nullable<(oldBox: BaseObject, newBox: BaseObject) => BaseObject>;
+    useSingleNodeRotation?: boolean;
+    shouldOverdrawWholeArea?: boolean;
+    zeroLeft?: number;
+    zeroTop?: number;
+}

package/lib/types/basics/vector2.d.ts

@@ -1,4 +1,7 @@
+import { Canvas } from '../canvas';
+import { SHEET_VIEWPORT_KEY } from '../components/sheets/interfaces';
 import { DeepImmutable, FloatArray } from './i-events';
+import { Transform } from './transform';
 
 export interface IPoint {
     x: number;
@@ -431,16 +434,55 @@ export interface IBoundRect {
     dy: number;
 }
 export interface IBoundRectNoAngle {
+    /**
+     * 冻结区域相对 MainCanvas 的物理位置,
+     * left = n * colWidth + rowHeaderWidth
+     */
     left: number;
     top: number;
     right: number;
     bottom: number;
 }
-export interface IViewportBound {
+export interface IViewportInfo {
     viewBound: IBoundRectNoAngle;
     diffBounds: IBoundRectNoAngle[];
+    /**
+     * scroll right further diffX < 0
+     * previewBound.x - viewbound.x
+     */
     diffX: number;
     diffY: number;
+    /**
+     * The physical position of the frozen rows and columns on the canvas, used for drawImage.
+     * For example, if the freezing starts from the fourth column, the left position would be 4 * column + rowHeaderWidth.
+     * The physical position means the top and left values have already considered the scaling factor.
+     */
     viewPortPosition: IBoundRectNoAngle;
-    viewPortKey?: string;
+    viewportKey: string | SHEET_VIEWPORT_KEY;
+    /**
+     * In the future, a number will be used to indicate the reason for the "dirty" status
+     * Here, a binary value is used to facilitate computation.
+     */
+    isDirty?: number;
+    isForceDirty?: boolean;
+    allowCache?: boolean;
+    cacheBound: IBoundRectNoAngle;
+    diffCacheBounds: IBoundRectNoAngle[];
+    cacheViewPortPosition: IBoundRectNoAngle;
+    shouldCacheUpdate: number;
+    sceneTrans: Transform;
+    cacheCanvas?: Canvas;
+    leftOrigin: number;
+    topOrigin: number;
+    bufferEdgeX: number;
+    bufferEdgeY: number;
+    updatePrevCacheBounds?: (viewbound: IBoundRectNoAngle) => void;
+}
+export interface IViewportInfos {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+    width: number;
+    height: number;
 }

package/lib/types/components/component.d.ts

@@ -1,6 +1,6 @@
 import { IDisposable } from '@wendellhu/redi';
 import { BaseObject } from '../base-object';
-import { IViewportBound } from '../basics/vector2';
+import { IViewportInfo } from '../basics/vector2';
 import { UniverRenderingContext } from '../context';
 import { ComponentExtension } from './extension';
 
@@ -10,6 +10,6 @@ export declare class RenderComponent<T, U, V> extends BaseObject {
     register(...extensions: Array<ComponentExtension<T, U, V>>): IDisposable;
     getExtensionsByOrder(): ComponentExtension<T, U, V>[];
     getExtensionByKey(uKey: string): ComponentExtension<T, U, V> | undefined;
-    draw(ctx: UniverRenderingContext, bounds?: IViewportBound): void;
+    draw(ctx: UniverRenderingContext, bounds?: IViewportInfo): void;
     dispose(): void;
 }

package/lib/types/components/docs/doc-background.d.ts

@@ -1,4 +1,4 @@
-import { IViewportBound } from '../../basics/vector2';
+import { IViewportInfo } from '../../basics/vector2';
 import { UniverRenderingContext } from '../../context';
 import { IDocumentsConfig, DocComponent } from './doc-component';
 import { DocumentSkeleton } from './layout/doc-skeleton';
@@ -7,7 +7,7 @@ export declare class DocBackground extends DocComponent {
     private _drawLiquid;
     constructor(oKey: string, documentSkeleton?: DocumentSkeleton, config?: IDocumentsConfig);
     static create(oKey: string, documentSkeleton?: DocumentSkeleton, config?: IDocumentsConfig): DocBackground;
-    draw(ctx: UniverRenderingContext, bounds?: IViewportBound): void;
+    draw(ctx: UniverRenderingContext, bounds?: IViewportInfo): void;
     changeSkeleton(newSkeleton: DocumentSkeleton): this;
-    protected _draw(ctx: UniverRenderingContext, bounds?: IViewportBound): void;
+    protected _draw(ctx: UniverRenderingContext, bounds?: IViewportInfo): void;
 }

package/lib/types/components/docs/doc-component.d.ts

@@ -1,5 +1,5 @@
 import { IDocumentSkeletonGlyph, IDocumentSkeletonLine, IDocumentSkeletonPage, PageLayoutType } from '../../basics/i-document-skeleton-cached';
-import { IBoundRectNoAngle, IViewportBound } from '../../basics/vector2';
+import { IBoundRectNoAngle, IViewportInfo } from '../../basics/vector2';
 import { UniverRenderingContext } from '../../context';
 import { RenderComponent } from '../component';
 import { DOCS_EXTENSION_TYPE } from './doc-extension';
@@ -22,11 +22,11 @@ export declare abstract class DocComponent extends RenderComponent<IDocumentSkel
     getSkeleton(): DocumentSkeleton | undefined;
     setSkeleton(skeleton: DocumentSkeleton): void;
     private _setConfig;
-    render(mainCtx: UniverRenderingContext, bounds?: IViewportBound): this | undefined;
+    render(mainCtx: UniverRenderingContext, bounds?: IViewportInfo): this | undefined;
     getParentScale(): {
         scaleX: any;
         scaleY: any;
     };
-    isSkipByDiffBounds(page: IDocumentSkeletonPage, pageTop: number, pageLeft: number, bounds?: IViewportBound): boolean;
-    protected abstract _draw(ctx: UniverRenderingContext, bounds?: IViewportBound): void;
+    isSkipByDiffBounds(page: IDocumentSkeletonPage, pageTop: number, pageLeft: number, bounds?: IViewportInfo): boolean;
+    protected abstract _draw(ctx: UniverRenderingContext, bounds?: IViewportInfo): void;
 }

package/lib/types/components/docs/document.d.ts

@@ -1,7 +1,7 @@
 import { Nullable, Observable } from '@univerjs/core';
 import { IDocumentSkeletonPage } from '../../basics/i-document-skeleton-cached';
 import { Transform } from '../../basics/transform';
-import { IViewportBound } from '../../basics/vector2';
+import { IViewportInfo } from '../../basics/vector2';
 import { UniverRenderingContext } from '../../context';
 import { Scene } from '../../scene';
 import { IDocumentsConfig, IPageMarginLayout, DocComponent } from './doc-component';
@@ -23,16 +23,15 @@ export declare class Documents extends DocComponent {
     docsLeft: number;
     docsTop: number;
     private _drawLiquid;
-    private _findLiquid;
     private _skeletonObserver;
     constructor(oKey: string, documentSkeleton?: DocumentSkeleton, config?: IDocumentsConfig);
     static create(oKey: string, documentSkeleton?: DocumentSkeleton, config?: IDocumentsConfig): Documents;
     dispose(): void;
     getOffsetConfig(): IDocumentOffsetConfig;
     getEngine(): Nullable<import('../..').ThinEngine<Scene>>;
-    draw(ctx: UniverRenderingContext, bounds?: IViewportBound): void;
+    draw(ctx: UniverRenderingContext, bounds?: IViewportInfo): void;
     changeSkeleton(newSkeleton: DocumentSkeleton): this;
-    protected _draw(ctx: UniverRenderingContext, bounds?: IViewportBound): void;
+    protected _draw(ctx: UniverRenderingContext, bounds?: IViewportInfo): void;
     private _horizontalHandler;
     private _verticalHandler;
     private _startRotation;

package/lib/types/components/docs/extensions/line.d.ts

@@ -7,7 +7,7 @@ export declare class Line extends docExtension {
     uKey: string;
     Z_INDEX: number;
     private _preBackgroundColor;
-    draw(ctx: UniverRenderingContext, parentScale: IScale, span: IDocumentSkeletonGlyph): void;
+    draw(ctx: UniverRenderingContext, parentScale: IScale, glyph: IDocumentSkeletonGlyph): void;
     clearCache(): void;
     private _drawLine;
     private _setLineType;

package/lib/types/components/docs/layout/doc-skeleton.d.ts

@@ -1,7 +1,7 @@
 import { LocaleService, Nullable } from '@univerjs/core';
 import { IDocumentSkeletonCached, IDocumentSkeletonGlyph, PageLayoutType } from '../../../basics/i-document-skeleton-cached';
 import { INodeInfo, INodePosition, INodeSearch } from '../../../basics/interfaces';
-import { IViewportBound, Vector2 } from '../../../basics/vector2';
+import { IViewportInfo, Vector2 } from '../../../basics/vector2';
 import { Skeleton } from '../../skeleton';
 import { DocumentViewModel } from '../view-model/document-view-model';
 
@@ -22,7 +22,7 @@ export declare class DocumentSkeleton extends Skeleton {
     static create(docViewModel: DocumentViewModel, localeService: LocaleService): DocumentSkeleton;
     dispose(): void;
     getViewModel(): DocumentViewModel;
-    calculate(bounds?: IViewportBound): void;
+    calculate(bounds?: IViewportInfo): void;
     getSkeletonData(): Nullable<IDocumentSkeletonCached>;
     getActualSize(): {
         actualWidth: number;

package/lib/types/components/docs/layout/model/glyph.d.ts

@@ -9,7 +9,7 @@ export declare function createSkeletonWordGlyph(content: string, config: IFontCr
 export declare function createSkeletonLetterGlyph(content: string, config: IFontCreateConfig, glyphWidth?: number, glyphInfo?: IOpenTypeGlyphInfo): IDocumentSkeletonGlyph;
 export declare function createSkeletonTabGlyph(config: IFontCreateConfig, glyphWidth?: number): IDocumentSkeletonGlyph;
 export declare function createHyphenDashGlyph(config: IFontCreateConfig): IDocumentSkeletonGlyph;
-export declare function createSkeletonCustomBlockGlyph(config: IFontCreateConfig, glyphWidth?: number, glyphHeight?: number, objectId?: string): IDocumentSkeletonGlyph;
+export declare function createSkeletonCustomBlockGlyph(config: IFontCreateConfig, glyphWidth?: number, glyphHeight?: number, drawingId?: string): IDocumentSkeletonGlyph;
 export declare function _createSkeletonWordOrLetter(glyphType: GlyphType, content: string, config: IFontCreateConfig, glyphWidth?: number, glyphInfo?: IOpenTypeGlyphInfo): IDocumentSkeletonGlyph;
 export declare function createSkeletonBulletGlyph(glyph: IDocumentSkeletonGlyph, bulletSkeleton: IDocumentSkeletonBullet, charSpaceApply: number): IDocumentSkeletonGlyph;
 export declare function setGlyphGroupLeft(glyphGroup: IDocumentSkeletonGlyph[], left?: number): void;

package/lib/types/components/docs/text-selection/text-range.d.ts

@@ -36,6 +36,12 @@ export declare class TextRange {
     get startNodePosition(): INodePosition | null;
     get endNodePosition(): Nullable<INodePosition>;
     get direction(): RANGE_DIRECTION;
+    getAbsolutePosition(): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | undefined;
     getAnchor(): Nullable<Rect<import('../../../shape/rect').IRectProps>>;
     activeStatic(): void;
     deactivateStatic(): void;

package/lib/types/components/docs/text-selection/text-selection-render-manager.d.ts

@@ -133,6 +133,7 @@ export declare class TextSelectionRenderManager extends RxDisposable implements
     setCursorManually(evtOffsetX: number, evtOffsetY: number): void;
     eventTrigger(evt: IPointerEvent | IMouseEvent): void;
     removeAllTextRanges(): void;
+    private _setSystemHighlightColorToStyle;
     private _getAllTextRanges;
     private _getActiveRange;
     private _add;

package/lib/types/components/extension.d.ts

@@ -1,4 +1,4 @@
-import { IDocumentRenderConfig, IScale, Nullable, Registry } from '@univerjs/core';
+import { IDocumentRenderConfig, IRange, IScale, Nullable, Registry } from '@univerjs/core';
 import { BaseObject } from '../base-object';
 import { Vector2 } from '../basics/vector2';
 import { UniverRenderingContext } from '../context';
@@ -11,6 +11,11 @@ export interface IExtensionConfig {
     alignOffset?: Vector2;
     renderConfig?: IDocumentRenderConfig;
 }
+export interface IDrawInfo {
+    viewRanges: IRange[];
+    viewportKey: string;
+    checkOutOfViewBound?: boolean;
+}
 export declare class ComponentExtension<T, U, V> {
     uKey: string;
     type: U;
@@ -20,7 +25,7 @@ export declare class ComponentExtension<T, U, V> {
     translateY: number;
     extensionOffset: IExtensionConfig;
     get zIndex(): number;
-    draw(ctx: UniverRenderingContext, parentScale: IScale, skeleton: T, diffBounds?: V): void;
+    draw(ctx: UniverRenderingContext, parentScale: IScale, skeleton: T, diffBounds?: V, more?: IDrawInfo): void;
     clearCache(): void;
     protected _getScale(parentScale: IScale): number;
     dispose(): void;

package/lib/types/components/sheets/column-header.d.ts

@@ -1,5 +1,5 @@
 import { Nullable } from '@univerjs/core';
-import { IViewportBound, Vector2 } from '../../basics/vector2';
+import { IViewportInfo, Vector2 } from '../../basics/vector2';
 import { UniverRenderingContext } from '../../context';
 import { ColumnHeaderLayout } from './extensions/column-header-layout';
 import { SpreadsheetHeader } from './sheet-component';
@@ -22,7 +22,7 @@ export declare class SpreadsheetColumnHeader extends SpreadsheetHeader {
     private _columnHeaderLayoutExtension;
     constructor(oKey: string, spreadsheetSkeleton?: SpreadsheetSkeleton);
     get columnHeaderLayoutExtension(): ColumnHeaderLayout;
-    draw(ctx: UniverRenderingContext, bounds?: IViewportBound): void;
+    draw(ctx: UniverRenderingContext, bounds?: IViewportInfo): void;
     isHit(coord: Vector2): boolean;
     private _initialDefaultExtension;
 }

package/lib/types/components/sheets/extensions/background.d.ts

@@ -1,5 +1,6 @@
 import { IRange, IScale } from '@univerjs/core';
 import { UniverRenderingContext } from '../../../context';
+import { IDrawInfo } from '../../extension';
 import { SpreadsheetSkeleton } from '../sheet-skeleton';
 import { SheetExtension } from './sheet-extension';
 
@@ -8,5 +9,5 @@ export declare class Background extends SheetExtension {
     Z_INDEX: number;
     PRINTING_Z_INDEX: number;
     get zIndex(): number;
-    draw(ctx: UniverRenderingContext, parentScale: IScale, spreadsheetSkeleton: SpreadsheetSkeleton, diffRanges?: IRange[]): void;
+    draw(ctx: UniverRenderingContext, parentScale: IScale, spreadsheetSkeleton: SpreadsheetSkeleton, diffRanges: IRange[], { viewRanges, checkOutOfViewBound }: IDrawInfo): void;
 }

package/lib/types/components/sheets/extensions/font.d.ts

@@ -1,5 +1,6 @@
 import { IRange, IScale } from '@univerjs/core';
 import { UniverRenderingContext } from '../../../context';
+import { IDrawInfo } from '../../extension';
 import { SpreadsheetSkeleton } from '../sheet-skeleton';
 import { SheetExtension } from './sheet-extension';
 
@@ -16,7 +17,7 @@ export declare class Font extends SheetExtension {
     uKey: string;
     Z_INDEX: number;
     getDocuments(): any;
-    draw(ctx: UniverRenderingContext, parentScale: IScale, spreadsheetSkeleton: SpreadsheetSkeleton, diffRanges?: IRange[]): void;
+    draw(ctx: UniverRenderingContext, parentScale: IScale, spreadsheetSkeleton: SpreadsheetSkeleton, diffRanges: IRange[], moreBoundsInfo: IDrawInfo): void;
     private _renderDocuments;
-    private _clipRectangle;
+    private _clipRectangleForOverflow;
 }

package/lib/types/components/sheets/extensions/marker.d.ts

@@ -6,5 +6,5 @@ import { SheetExtension } from './sheet-extension';
 export declare class Marker extends SheetExtension {
     protected Z_INDEX: number;
     uKey: string;
-    draw(ctx: UniverRenderingContext, parentScale: IScale, skeleton: SpreadsheetSkeleton, diffRanges?: IRange[] | undefined): void;
+    draw(ctx: UniverRenderingContext, parentScale: IScale, skeleton: SpreadsheetSkeleton, diffRanges: IRange[]): void;
 }

package/lib/types/components/sheets/extensions/sheet-extension.d.ts

@@ -8,7 +8,14 @@ export declare enum SHEET_EXTENSION_TYPE {
 export declare class SheetExtension extends ComponentExtension<SpreadsheetSkeleton, SHEET_EXTENSION_TYPE, IRange[]> {
     type: SHEET_EXTENSION_TYPE;
     getCellIndex(rowIndex: number, columnIndex: number, rowHeightAccumulation: number[], columnWidthAccumulation: number[], dataMergeCache: IRange[]): import('@univerjs/core').ISelectionCellWithCoord;
-    isRenderDiffRangesByCell(range: IRange, diffRanges?: IRange[]): boolean;
+    isRenderDiffRangesByCell(rangeP: IRange, diffRanges?: IRange[]): boolean;
     isRenderDiffRangesByColumn(curStartColumn: number, curEndColumn: number, diffRanges?: IRange[]): boolean;
     isRenderDiffRangesByRow(curStartRow: number, curEndRow: number, diffRanges?: IRange[]): boolean;
+    /**
+     * 传入的 row 范围和 diffRanges 有相交, 返回 true
+     * @param curStartRow
+     * @param curEndRow
+     * @param viewranges
+     */
+    isRowInRanges(curStartRow: number, curEndRow: number, viewranges?: IRange[]): boolean;
 }