@univerjs/engine-render 1.0.0-insiders.20260813-7c9aa50 → 1.0.0

package/lib/types/components/sheets/sheet.render-skeleton.d.ts

@@ -39,8 +39,10 @@ export declare const DEFAULT_PADDING_DATA: {
     r: number;
 };
 export declare const RENDER_RAW_FORMULA_KEY = "RENDER_RAW_FORMULA";
+export declare const FULL_WIDTH_HORIZONTAL_ALIGNMENTS: Set<HorizontalAlign>;
 export declare function getShrinkToFitScale(contentWidth: number, availableWidth: number, fontSize: number): number;
 export declare function getGeneralNumberDisplayText(value: number, displayText: string, fontString: string, availableWidth: number): string;
+export declare function getCustomNumberDisplayText(displayText: string, fontString: string, availableWidth: number): string;
 export declare function scaleDocumentDataForShrinkToFit(documentData: IDocumentData, scale: number, fallbackFontSize: number): IDocumentData;
 export interface ICacheItem {
     bg: boolean;
@@ -82,6 +84,7 @@ export declare class SpreadsheetSkeleton extends SheetSkeleton {
     private _handleBorderMatrix;
     private _showGridlines;
     private _gridlinesColor;
+    private _defaultGridlinesColor;
     private _scene;
     constructor(worksheet: Worksheet, _styles: Styles, _localeService: LocaleService, _contextService: IContextService, _configService: IConfigService, _injector: Injector);
     registerGetCellHeight(): void;
@@ -102,6 +105,7 @@ export declare class SpreadsheetSkeleton extends SheetSkeleton {
     get incrementalFontRenderRanges(): IRange[];
     get showGridlines(): BooleanNumber;
     get gridlinesColor(): string | undefined;
+    get defaultGridlinesColor(): string;
     dispose(): void;
     setOverflowCache(value: ObjectMatrix<IRange>): void;
     getFont(rowIndex: number, columnIndex: number): Nullable<IFontCacheItem>;
@@ -183,7 +187,7 @@ export declare class SpreadsheetSkeleton extends SheetSkeleton {
     _setBorderStylesCache(row: number, col: number, style: Nullable<IStyleData>, options: ISetStylesCacheForOneCellOptions | undefined): void;
     _setBgStylesCache(row: number, col: number, style: Nullable<IStyleData>, options: ISetStylesCacheForOneCellOptions | undefined): void;
     private _applyShrinkToFit;
-    private _applyGeneralNumberDisplay;
+    private _applyNumberDisplay;
     _setFontStylesCache(row: number, col: number, cellData: Nullable<ICellDataForSheetInterceptor>, style: IStyleData, hasMergeData?: boolean): void;
     /**
      * Set border background and font to this._stylesCache cell by cell.

package/lib/types/components/sheets/spreadsheet.d.ts

@@ -15,7 +15,6 @@
  */
 import type { IPosition, IRange } from '@univerjs/core';
 import type { IBoundRectNoAngle, IViewportInfo, Vector2 } from '../../basics/vector2';
-import type { Canvas } from '../../canvas';
 import type { UniverRenderingContext2D } from '../../context';
 import type { Scene } from '../../scene';
 import type { Background } from './extensions/background';
@@ -23,10 +22,12 @@ import type { Border } from './extensions/border';
 import type { Font } from './extensions/font';
 import type { IPaintForRefresh, IPaintForScrolling } from './interfaces';
 import type { SpreadsheetSkeleton } from './sheet.render-skeleton';
+import { Canvas } from '../../canvas';
 import { Documents } from '../docs/document';
 import { SheetComponent } from './sheet-component';
 export declare class Spreadsheet extends SheetComponent {
     private _allowCache;
+    private _scrollBufferCanvases;
     private _backgroundExtension;
     private _borderExtension;
     private _fontExtension;
@@ -79,7 +80,9 @@ export declare class Spreadsheet extends SheetComponent {
     renderByViewports(mainCtx: UniverRenderingContext2D, viewportInfo: IViewportInfo, spreadsheetSkeleton: SpreadsheetSkeleton): void;
     private _getMergeRepairBounds;
     private _getRepaintBounds;
-    paintNewAreaForScrolling(viewportInfo: IViewportInfo, param: IPaintForScrolling, mergeRepairBounds?: IBoundRectNoAngle[]): void;
+    paintNewAreaForScrolling(viewportInfo: IViewportInfo, param: IPaintForScrolling, mergeRepairBounds?: IBoundRectNoAngle[]): Canvas;
+    private _copyCacheForScrolling;
+    private _getScrollBufferCanvas;
     /**
      * Redraw the entire viewport.
      */

package/lib/types/components/sheets/watermark/watermark-layer.d.ts

@@ -15,13 +15,14 @@
  */
 import type { IUser } from '@univerjs/core';
 import type { UniverRenderingContext } from '../../../context';
+import type { ILayerRenderOptions } from '../../../layer';
 import type { IWatermarkConfigWithType } from './type';
 import { Layer } from '../../../layer';
 export declare class WatermarkLayer extends Layer {
     private _config;
     private _image;
     private _user;
-    render(ctx?: UniverRenderingContext, isMaxLayer?: boolean): this;
+    render(ctx?: UniverRenderingContext, isMaxLayer?: boolean, options?: ILayerRenderOptions): this;
     updateConfig(config?: IWatermarkConfigWithType, user?: IUser): void;
     private _renderWatermark;
 }

package/lib/types/context.d.ts

@@ -21,6 +21,8 @@ export interface IUniverRenderingContextOptions {
 export declare class UniverRenderingContext2D implements CanvasRenderingContext2D {
     __mode: string;
     private _transformCache;
+    private _bitmapMutationId;
+    private _bitmapMutationTrackingDepth;
     readonly canvas: HTMLCanvasElement;
     _context: CanvasRenderingContext2D;
     private _systemType;
@@ -31,6 +33,8 @@ export declare class UniverRenderingContext2D implements CanvasRenderingContext2
     private _id;
     getId(): string;
     setId(id: string): void;
+    detectBitmapMutation(callback: () => void): boolean;
+    private _markBitmapMutation;
     isContextLost(): boolean;
     get globalAlpha(): number;
     set globalAlpha(val: number);

package/lib/types/engine.d.ts

@@ -171,6 +171,7 @@ export declare class Engine extends Disposable {
      * @returns a number representing the delta time in ms
      */
     getDeltaTime(): number;
+    getEstimatedFrameInterval(): number;
     /**
      * Exec all function in _renderFrameTasks
      */

package/lib/types/index.d.ts

@@ -24,22 +24,29 @@ export * from './canvas';
 export * from './components';
 export type { DocsCustomBlockRenderViewportProvider, IDocsCustomBlockRenderViewport, IDocsCustomBlockRenderViewportInput } from './components/docs/custom-block-render-viewport';
 export { getDocsCustomBlockRenderViewport, setDocsCustomBlockRenderViewportProvider } from './components/docs/custom-block-render-viewport';
+export { getDocCustomGlyphRenderer, registerDocCustomGlyphRenderer, } from './components/docs/custom-glyph-renderer';
+export type { DocCustomGlyphRenderer, IDocCustomGlyphRendererRegistration, IDocCustomGlyphRenderInput, } from './components/docs/custom-glyph-renderer';
 export { DocBackground } from './components/docs/doc-background';
 export { DOCS_EXTENSION_TYPE } from './components/docs/doc-extension';
 export { Documents } from './components/docs/document';
-export type { IPageRenderConfig } from './components/docs/document';
-export type { IDocumentOffsetConfig } from './components/docs/document';
+export type { IDocumentGlyphPaint, IDocumentOffsetConfig, IPageRenderConfig } from './components/docs/document';
+export { getDocumentLayoutPresentation, registerDocumentLayoutPresentation } from './components/docs/document-layout-presentation';
+export type { IDocumentLayoutBody, IDocumentLayoutParagraph, IDocumentLayoutParagraphStyle, IDocumentLayoutPresentation, IDocumentLayoutSnapshot, IDocumentLayoutTextRun, IDocumentLayoutTextStyle, } from './components/docs/document-layout-presentation';
 export { getTableIdAndSliceIndex } from './components/docs/layout/block/table';
 export { measureDocumentNoWrapTextRangeWidth, measureDocumentNoWrapTextWidth, measureDocumentUnbreakableTextWidth, measureDocumentWrappedTextWidth, } from './components/docs/layout/doc-no-wrap-measure';
 export * from './components/docs/layout/doc-simple-skeleton';
 export { DocumentSkeleton } from './components/docs/layout/doc-skeleton';
 export type { IFindNodeRestrictions } from './components/docs/layout/doc-skeleton';
+export type { IDocumentLayoutPagePublication } from './components/docs/layout/document-layout-publication';
+export type { DocumentLayoutMode, DocumentLayoutReason, IDocumentLayoutApplyResult, IDocumentLayoutInvalidation, IDocumentLayoutPageRange, IDocumentLayoutProgress, IDocumentLayoutProtectedContinuousRange, IDocumentLayoutProtectedPageRange, IDocumentLayoutProtectedRange, } from './components/docs/layout/document-layout-types';
+export { invalidateDocumentFontMetrics } from './components/docs/layout/shaping-engine/font-cache';
 export { compareDocumentSkeletonNestedPagePathOrder, documentSkeletonLineIterator, documentSkeletonTableIterator, getCharSpaceApply, getDocumentSkeletonColumnPagePathInfo, getDocumentSkeletonNestedPageOffset, getLastLine, getNumberUnitValue, getPageFromPath, glyphIterator, lineIterator, } from './components/docs/layout/tools';
 export type { IDocumentSkeletonColumnPagePathInfo, IDocumentSkeletonLineContext, IDocumentSkeletonLineIteratorOptions, IDocumentSkeletonTableCellGeometry, IDocumentSkeletonTableContext, IDocumentSkeletonTableIteratorOptions } from './components/docs/layout/tools';
 export { getLastColumn } from './components/docs/layout/tools';
 export { Liquid } from './components/docs/liquid';
+export { getTopmostDocsTableHit } from './components/docs/table-hit-test';
 export type { DocsTableRenderViewportProvider, IDocsTableRenderViewport, } from './components/docs/table-render-viewport';
-export { getDocsTableRenderViewport, getDocsTableViewportLeft, setDocsTableRenderViewportProvider, } from './components/docs/table-render-viewport';
+export { getDocsTableLayoutViewportWidth, getDocsTableRenderViewport, getDocsTableViewportLeft, setDocsTableRenderViewportProvider, } from './components/docs/table-render-viewport';
 export { DataStreamTreeNode } from './components/docs/view-model/data-stream-tree-node';
 export { DocumentViewModel } from './components/docs/view-model/document-view-model';
 export { DocumentEditArea } from './components/docs/view-model/document-view-model';
@@ -65,3 +72,5 @@ export * from './scroll-timer';
 export { CanvasColorService, DumbCanvasColorService, ICanvasColorService } from './services/canvas-color.service';
 export * from './shape';
 export * from './viewport';
+export { DocumentLayoutSession } from './worker-layout';
+export type { IDocumentLayoutSessionStartOptions, IDocumentLayoutStepResult } from './worker-layout';

package/lib/types/layer.d.ts

@@ -13,16 +13,29 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import type { IBoundRectNoAngle, IViewportInfo } from './basics/vector2';
 import type { UniverRenderingContext } from './context';
 import type { Scene } from './scene';
 import { Disposable } from '@univerjs/core';
 import { BaseObject } from './base-object';
+export interface IScrollRenderInfo {
+    bounds: IBoundRectNoAngle;
+    offsetX: number;
+    offsetY: number;
+}
+export interface ILayerRenderOptions {
+    dirtyBounds?: IBoundRectNoAngle[];
+    preserveCache?: boolean;
+    viewportInfos?: Map<string, IViewportInfo>;
+}
+export declare function scrollAndClearCanvas(ctx: UniverRenderingContext, pixelRatio: number, scrollRenderInfos: IScrollRenderInfo[], dirtyBounds: IBoundRectNoAngle[]): void;
 export declare class Layer extends Disposable {
     private _scene;
     private _zIndex;
     private _allowCache;
     private _objects;
     private _cacheCanvas;
+    private _cacheValid;
     protected _dirty: boolean;
     private _debounceDirtyFunc;
     constructor(_scene: Scene, objects?: BaseObject[], _zIndex?: number, _allowCache?: boolean);
@@ -59,7 +72,7 @@ export declare class Layer extends Disposable {
     makeDirty(state?: boolean): this;
     makeDirtyWithDebounce(state?: boolean): void;
     isDirty(): boolean;
-    render(parentCtx?: UniverRenderingContext, isMaxLayer?: boolean): this;
+    render(parentCtx?: UniverRenderingContext, isMaxLayer?: boolean, options?: ILayerRenderOptions): this;
     private _layerBehavior;
     private _initialCacheCanvas;
     private _draw;

package/lib/types/render-manager/render-manager.service.d.ts

@@ -50,6 +50,7 @@ export interface IRenderManagerService extends IDisposable {
      * @param dep
      */
     registerRenderModule<T extends UnitModel>(type: UniverInstanceType, dep: Dependency<T>): IDisposable;
+    registerRenderModule(type: UniverInstanceType, dep: Dependency): IDisposable;
 }
 export declare class RenderManagerService extends Disposable implements IRenderManagerService {
     protected readonly _injector: Injector;
@@ -71,6 +72,7 @@ export declare class RenderManagerService extends Disposable implements IRenderM
      * @param type
      * @param depCtor
      */
+    registerRenderModule<T extends UnitModel>(type: UniverInstanceType, depCtor: Dependency<T>): IDisposable;
     registerRenderModule(type: UniverInstanceType, depCtor: Dependency): IDisposable;
     /**
      * get render dependencies from _renderDependencies
@@ -78,7 +80,7 @@ export declare class RenderManagerService extends Disposable implements IRenderM
      * @returns Dependency[]
      */
     private _getRenderDepsByType;
-    private _initDarkModeListener;
+    private _initThemeListener;
     /**
      * create renderUnit & init deps from renderDependencies
      * @param unitId

package/lib/types/scene-viewer.d.ts

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 import type { Nullable } from '@univerjs/core';
+import type { DeviceType } from './basics/i-events';
 import type { IObjectFullState } from './basics/interfaces';
 import type { IViewportInfo, Vector2 } from './basics/vector2';
 import type { UniverRenderingContext } from './context';
@@ -36,7 +37,7 @@ export declare class SceneViewer extends BaseObject {
     enableSelectedClipElement(): void;
     disableSelectedClipElement(): void;
     allowSelectedClipElement(): boolean;
-    pick(coord: Vector2): Nullable<BaseObject | Scene>;
+    pick(coord: Vector2, deviceType?: DeviceType): Nullable<BaseObject | Scene>;
     dispose(): void;
     private _initialProps;
 }

package/lib/types/scene.d.ts

@@ -26,6 +26,7 @@ import type { SceneViewer } from './scene-viewer';
 import type { Viewport } from './viewport';
 import { Disposable, EventSubject } from '@univerjs/core';
 import { CURSOR_TYPE, RENDER_CLASS_TYPE } from './basics/const';
+import { DeviceType } from './basics/i-events';
 import { Transform } from './basics/transform';
 import { Layer } from './layer';
 import { Transformer } from './scene.transformer';
@@ -55,6 +56,14 @@ export declare class Scene extends Disposable {
     private _evented;
     private _layers;
     private _viewports;
+    private _preserveEngineOnRender;
+    private _hasPostRenderCanvasMutation;
+    private _scrollbarDragViewport;
+    private _isScrollbarSeeking;
+    private _isScrollbarPreviewDirty;
+    private _lastScrollbarSeekInputAt;
+    private _estimatedFullRenderDuration;
+    private _renderedViewportScrollPositions;
     private _cursor;
     private _defaultCursor;
     private _addObject$;
@@ -121,6 +130,11 @@ export declare class Scene extends Disposable {
     attachControl(options?: ISceneInputControlOptions): this | undefined;
     detachControl(): this;
     makeDirty(state?: boolean): this;
+    makeDirtyForScrolling(): this;
+    beginScrollbarDrag(viewport: Viewport): void;
+    updateScrollbarDrag(viewport: Viewport): void;
+    endScrollbarDrag(viewport: Viewport): void;
+    isScrollRenderPending(): boolean;
     makeDirtyNoParent(state?: boolean): this;
     enableLayerCache(...layerIndexes: number[]): void;
     disableLayerCache(...layerIndexes: number[]): void;
@@ -218,6 +232,12 @@ export declare class Scene extends Disposable {
     getViewports(): Viewport[];
     getMainViewport(): Viewport;
     getViewport(key: string): Viewport | undefined;
+    private _createScrollRenderState;
+    private _renderScrollbarSeekPreview;
+    private _shouldDeferScrollbarSeekRender;
+    private _recordRenderedViewportScrollPositions;
+    private _recordFullRenderDuration;
+    private _notifyAfterRender;
     render(parentCtx?: UniverRenderingContext): void;
     requestRender(parentCtx?: UniverRenderingContext): Promise<unknown>;
     /**
@@ -274,7 +294,7 @@ export declare class Scene extends Disposable {
      * @param {Vector2} coord
      * @return {Nullable<BaseObject | Scene>} object under the pointer
      */
-    pick(coord: Vector2): Nullable<BaseObject | Scene>;
+    pick(coord: Vector2, deviceType?: DeviceType): Nullable<BaseObject | Scene>;
     triggerPointerUp(evt: IPointerEvent | IMouseEvent): boolean;
     triggerMouseWheel(evt: IWheelEvent): boolean;
     triggerSingleClick(evt: IPointerEvent | IMouseEvent): boolean;

package/lib/types/scene.input-manager.d.ts

@@ -24,6 +24,8 @@ export declare class InputManager extends Disposable {
     static LongPressDelay: number;
     /** Time in milliseconds with two consecutive clicks will be considered as a double or triple click */
     static DoubleClickDelay: number;
+    /** The allowed distance between two consecutive touch taps. */
+    static TouchDoubleClickMovementThreshold: number;
     static TripleClickDelay: number;
     /** If you need to check double click without raising a single click at first click, enable this flag */
     static ExclusiveDoubleClickMode: boolean;
@@ -33,10 +35,13 @@ export declare class InputManager extends Disposable {
     private _onInput$;
     private _currentMouseEnterPicked;
     private _startingPosition;
+    private _pointerDownPosition;
+    private _pointerDragged;
     private _delayedTimeout;
     private _delayedTripeTimeout;
     private _doubleClickOccurred;
     private _tripleClickState;
+    private _lastClickTime;
     private _currentObject;
     constructor(scene: Scene);
     /**
@@ -70,6 +75,7 @@ export declare class InputManager extends Disposable {
      * @param offsetY
      */
     private _getObjectAtPos;
+    private _getObjectAtEvent;
     /**
      *
      * If currentObject is null, return true
@@ -86,5 +92,6 @@ export declare class InputManager extends Disposable {
     private _isPointerSwiping;
     private _prePointerDoubleOrTripleClick;
     private _resetDoubleClickParam;
+    private _resetClickSequence;
     get capturedObject(): BaseObject | null;
 }

package/lib/types/scene.transformer.d.ts

@@ -42,10 +42,13 @@ export interface IChangeObserverConfig {
  */
 export declare class Transformer extends Disposable implements ITransformerConfig {
     private _scene;
+    private static readonly _selectionTapMovementThreshold;
     isCropper: boolean;
     hoverEnabled: boolean;
     hoverEnterFunc: Nullable<(e: IPointerEvent | IMouseEvent) => void>;
     hoverLeaveFunc: Nullable<(e: IPointerEvent | IMouseEvent) => void>;
+    moveEnabled: boolean;
+    moveOnlyWhenSelected: boolean;
     resizeEnabled: boolean;
     rotateEnabled: boolean;
     rotationSnaps: number[];
@@ -117,8 +120,7 @@ export declare class Transformer extends Disposable implements ITransformerConfi
     private _startStateMap;
     private _viewportScrollX;
     private _viewportScrollY;
-    private _topScenePointerMoveSub;
-    private _topScenePointerUpSub;
+    private _finishGesture;
     private _cancelFocusSubscription;
     private _transformerControlMap;
     private _selectedObjectMap;
@@ -131,6 +133,9 @@ export declare class Transformer extends Disposable implements ITransformerConfi
     updateZeroPoint(left: number, top: number): void;
     changeNotification(): this;
     getSelectedObjectMap(): Map<string, BaseObject>;
+    /** Complete the current object transform before another gesture takes ownership of the scene. */
+    finishTransform(): void;
+    private _bindGestureEnd;
     resetProps(config?: ITransformerConfig): void;
     getScene(): Scene;
     clearControls(changeSelf?: boolean): void;
@@ -183,6 +188,7 @@ export declare class Transformer extends Disposable implements ITransformerConfi
     private _getSouthWestPoints;
     private _checkTransformerType;
     private _updateControlIterator;
+    private _getControlState;
     private _updateControl;
     private _hideControl;
     private _attachHover;

package/lib/types/services/canvas-color.service.d.ts

@@ -32,13 +32,11 @@ export declare class DumbCanvasColorService implements ICanvasColorService {
 export declare class CanvasColorService extends Disposable implements ICanvasColorService {
     private readonly _themeService;
     private readonly _darkModeCache;
-    private readonly _resolvedColorCache;
+    private readonly _resolvedThemeColors;
     private _invertAlgo;
     constructor(_themeService: ThemeService);
     getRenderColor(inputColor: string): string;
-    private _resolveColor;
-    private _resolveThemeColor;
+    private _cacheThemeColors;
 }
-export declare function getDarkRenderColorOverride(color: string): string | null;
 export declare function hexToRgb(_hex: string): RGBColorType;
 export declare function rgbToHex(rgbColor: RGBColorType): string;

package/lib/types/shape/control.d.ts

@@ -13,5 +13,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare class Control {
+import { Vector2 } from '../basics/vector2';
+import { Rect } from './rect';
+/** A precise mouse handle with a zoom-independent touch target. */
+export declare class Control extends Rect {
+    getTouchHitDistance(coord: Vector2): number;
 }

package/lib/types/shape/scroll-bar.d.ts

@@ -75,7 +75,6 @@ export declare class ScrollBar extends Disposable {
     private _pendingBarDeltaX;
     private _pendingBarDeltaY;
     private _pendingBarScrollFrameId;
-    private _pendingBarScrollThrottleId;
     private _horizonPointerMoveSub;
     private _horizonPointerUpSub;
     private _verticalPointerMoveSub;
@@ -85,6 +84,8 @@ export declare class ScrollBar extends Disposable {
     private _thumbActiveBackgroundColor;
     private _trackBackgroundColor;
     private _trackBorderColor;
+    private _trackBackgroundOpacity;
+    private _trackBorderOpacity;
     /**
      * The thickness of a scrolling track
      * ThumbSize = trackSize - thumbMargin * 2
@@ -143,7 +144,6 @@ export declare class ScrollBar extends Disposable {
     static attachTo(view: Viewport, props?: IScrollBarProps): ScrollBar;
     dispose(): void;
     private _scheduleBarScrollDelta;
-    private _requestPendingBarScrollFrame;
     private _flushPendingBarScroll;
     private _applyPendingBarScroll;
     render(ctx: UniverRenderingContext, left?: number, top?: number): void;

package/lib/types/shape/shape.d.ts

@@ -33,8 +33,10 @@ export interface IShapeProps extends IObjectFullState, ISize, IOffset, IScale {
     visible?: boolean;
     paintFirst?: PaintFirst;
     stroke?: Nullable<string | CanvasGradient>;
+    strokeOpacity?: number;
     strokeScaleEnabled?: boolean;
     fill?: Nullable<string | CanvasGradient>;
+    fillOpacity?: number;
     fillAfterStrokeEnabled?: boolean;
     hitStrokeWidth?: number | string;
     strokeLineJoin?: LineJoin;
@@ -58,14 +60,17 @@ export declare abstract class Shape<T extends IShapeProps> extends BaseObject {
     private _renderCacheCanvas;
     private _renderCacheBounds;
     private _renderCachePixelRatio;
+    private _renderCacheTransformSize;
     private _hoverCursor;
     private _moveCursor;
     private _fillRule;
     private _globalCompositeOperation;
     private _paintFirst;
     private _stroke;
+    private _strokeOpacity?;
     private _strokeScaleEnabled;
     private _fill;
+    private _fillOpacity?;
     private _fillAfterStrokeEnabled;
     private _hitStrokeWidth;
     private _strokeLineJoin;
@@ -90,8 +95,10 @@ export declare abstract class Shape<T extends IShapeProps> extends BaseObject {
     get globalCompositeOperation(): string;
     get paintFirst(): PaintFirst;
     get stroke(): Nullable<string | CanvasGradient>;
+    get strokeOpacity(): number | undefined;
     get strokeScaleEnabled(): boolean;
     get fill(): Nullable<string | CanvasGradient>;
+    get fillOpacity(): number | undefined;
     get fillAfterStrokeEnabled(): boolean;
     get hitStrokeWidth(): string | number;
     get strokeLineJoin(): LineJoin;
@@ -132,6 +139,8 @@ export declare abstract class Shape<T extends IShapeProps> extends BaseObject {
     toJson(): {
         [x: string]: any;
     };
+    transformByState(option: IObjectFullState): this | undefined;
+    translate(x?: number | string, y?: number | string): this;
     protected _renderWithCache(ctx: UniverRenderingContext, bounds: IBoundRectNoAngle, draw: (cacheContext: UniverRenderingContext) => void, fixedPixelRatio?: number): void;
     protected _releaseRenderCache(): void;
     protected _draw(ctx: UniverRenderingContext, bounds?: IViewportInfo): void;

package/lib/types/viewport.d.ts

@@ -253,6 +253,7 @@ export declare class Viewport {
     get _deltaViewportScrollX(): number;
     get _deltaViewportScrollY(): number;
     get canvas(): UniverCanvas | null;
+    swapCacheCanvas(cacheCanvas: UniverCanvas): UniverCanvas | null;
     enable(): void;
     disable(): void;
     /**
@@ -343,7 +344,7 @@ export declare class Viewport {
      * @param objects
      * @param isMaxLayer
      */
-    render(parentCtx?: UniverRenderingContext, objects?: BaseObject[], isMaxLayer?: boolean): void;
+    render(parentCtx?: UniverRenderingContext, objects?: BaseObject[], isMaxLayer?: boolean, viewportInfo?: IViewportInfo): void;
     private _makeDefaultViewport;
     calcViewportInfo(): IViewportInfo;
     /**
@@ -431,6 +432,7 @@ export declare class Viewport {
     private _diffViewBound;
     private _calcDiffCacheBound;
     private _drawScrollbar;
+    renderScrollbarOnly(ctx: UniverRenderingContext, pixelRatio: number): void;
     setViewportSize(props?: IViewProps): void;
 }
 export {};

package/lib/types/worker-layout.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * 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 type { DocumentDataModel, LocaleService, Nullable } from '@univerjs/core';
+import type { IDocumentSkeletonPage } from './basics/i-document-skeleton-cached';
+import type { IDocumentLayoutGeometryPublication, IDocumentLayoutPagePublication } from './components/docs/layout/document-layout-publication';
+import type { DocumentLayoutReason, IDocumentLayoutInvalidation, IDocumentLayoutProgress } from './components/docs/layout/document-layout-types';
+import { Disposable } from '@univerjs/core';
+export interface IDocumentLayoutSessionStartOptions {
+    reason?: DocumentLayoutReason;
+    anchor?: number;
+    priorityAnchor?: number;
+    invalidation?: IDocumentLayoutInvalidation;
+    waitForHyphenationPatterns?: boolean;
+    modernPageWidth?: number;
+    modernHorizontalMargin?: number;
+}
+export interface IDocumentLayoutStepResult {
+    progress: IDocumentLayoutProgress;
+    publication: IDocumentLayoutGeometryPublication | null;
+}
+export interface IDocumentLayoutPageResolution {
+    pageIndex: number;
+    pageNumber: number;
+    startOffset: number;
+    endOffset: number;
+}
+/**
+ * Worker-safe owner of the document view model and incremental layout state.
+ * Scheduling, transport, presentation and model revision ordering belong to callers.
+ */
+export declare class DocumentLayoutSession extends Disposable {
+    private readonly _viewModel;
+    private readonly _skeleton;
+    private _lastPublishedPageCount;
+    private _layoutReason;
+    private _didPublishEditAnchor;
+    private _continuousPageSnapshot;
+    private _continuousReplacementOffset;
+    private readonly _publishedHeaderPages;
+    private readonly _publishedFooterPages;
+    private _resetPublishedResources;
+    private _pendingPaginatedCompletion;
+    constructor(dataModel: DocumentDataModel, localeService: LocaleService);
+    start(options?: IDocumentLayoutSessionStartOptions): number;
+    step(generation: number, budgetMs?: number, maxWorkUnits?: number): IDocumentLayoutStepResult;
+    publishBacklog(generation: number): IDocumentLayoutStepResult;
+    getPage(pageIndex: number): IDocumentLayoutPagePublication | null;
+    resolvePageByOffset(offset: number): IDocumentLayoutPageResolution | null;
+    cancel(generation?: number): void;
+    resetDataModel(dataModel: DocumentDataModel): void;
+    getProgress(): Nullable<IDocumentLayoutProgress>;
+    static hydratePage(publication: IDocumentLayoutPagePublication, snapshot?: ReturnType<DocumentDataModel['getSnapshot']>): IDocumentSkeletonPage;
+    dispose(): void;
+    private _collectPublications;
+    private _publishPaginatedCompletionBacklog;
+    private _collectPublication;
+    private _collectResourcePublication;
+}