@univerjs/engine-render 1.0.0-beta.0 → 1.0.0-beta.1

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

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { BulletAlignment, ColumnSeparatorType, DataStreamTreeTokenType, IColorStyle, IColumnGroup, IDocDrawingBase, IDocumentRenderConfig, INestingLevel, IParagraph, IParagraphBorder, IParagraphProperties, ITable, ITableRow, ITextStyle, PageOrientType } from '@univerjs/core';
+import type { BulletAlignment, ColumnSeparatorType, DataStreamTreeTokenType, IColorStyle, IColumnGroup, IDocDrawingBase, IDocumentRenderConfig, INestingLevel, IParagraph, IParagraphBorder, IParagraphProperties, ITable, ITableRow, ITextStyle, PageOrientType, TabStopLeader } from '@univerjs/core';
 import type { BreakPointType } from '../components/docs/layout/line-breaker/break';
 export interface IDocumentSkeletonCached extends ISkeletonResourceReference {
     pages: IDocumentSkeletonPage[];
@@ -67,8 +67,14 @@ export interface IDocumentSkeletonPage {
     width: number;
     height: number;
     breakType: BreakType;
+    /** Internal layout provenance used to distinguish a forced boundary from natural overflow. */
+    isExplicitPageBreak?: boolean;
+    /** Internal layout provenance for a page opened because content exhausted the previous page. */
+    isNaturalPageOverflow?: boolean;
     st: number;
     ed: number;
+    /** Whether this cell page is only a layout placeholder covered by a merged cell. */
+    isMergedCellCovered?: boolean;
     skeDrawings: Map<string, IDocumentSkeletonDrawing>;
     skeTables: Map<string, IDocumentSkeletonTable>;
     skeColumnGroups: Map<string, IDocumentSkeletonColumnGroup>;
@@ -98,6 +104,7 @@ export interface IDocumentSkeletonTable {
     ed: number;
     tableId: string;
     tableSource: ITable;
+    hasPageBreak?: boolean;
     parent?: IDocumentSkeletonPage;
 }
 export interface IDocumentSkeletonRow {
@@ -210,6 +217,7 @@ export interface IDocumentSkeletonGlyph {
     featureId?: string;
     drawingId?: string;
     fauxBoldStrokeWidth?: number;
+    tabLeader?: TabStopLeader;
 }
 export interface IDocumentSkeletonBullet {
     listId: string;
@@ -262,6 +270,7 @@ export interface IDocumentSkeletonBoundingBox {
     width: number;
     ba: number;
     bd: number;
+    normalLineHeight?: number;
     aba: number;
     abd: number;
     sp: number;

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

@@ -92,6 +92,7 @@ export interface IParagraphTableCache {
 }
 export interface IParagraphConfig {
     paragraphIndex: number;
+    isInsideTable?: boolean;
     documentCompatibilityPolicy?: IDocumentCompatibilityPolicy;
     useWordStyleLineHeight?: boolean;
     usePptxFontSizeLineHeight?: boolean;

package/lib/types/basics/performance-monitor.d.ts

@@ -71,6 +71,10 @@ export declare class PerformanceMonitor extends Disposable {
      * Returns the frame time of the last recent frame.
      */
     get instantaneousFrameTime(): number;
+    /**
+     * Estimates the browser animation-frame cadence while ignoring isolated long frames.
+     */
+    get estimatedFrameInterval(): number;
     /**
      * Returns the average framerate in frames per second over the sliding window (or the subset of frames sampled so far)
      */
@@ -151,6 +155,7 @@ export declare class RollingAverage {
      * @return Value previously recorded with add() or null if outside of range
      */
     history(i: number): number;
+    percentile(percentile: number): number;
     /**
      * Returns true if enough samples have been taken to completely fill the sliding window
      * @return true if sample-set saturated

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

@@ -62,6 +62,8 @@ export interface ITransformerConfig {
     boundBoxFunc?: Nullable<(oldBox: BaseObject, newBox: BaseObject) => BaseObject>;
     useSingleNodeRotation?: boolean;
     shouldOverdrawWholeArea?: boolean;
+    /** Render transformer controls on a layer independent from the selected object. */
+    controlLayerIndex?: number;
     zeroLeft?: number;
     zeroTop?: number;
     moveBoundaryEnabled?: boolean;

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

@@ -18,7 +18,9 @@ import type { IBoundRectNoAngle } from '../../basics/vector2';
 import { ComponentExtension } from '../extension';
 export declare enum DOCS_EXTENSION_TYPE {
     SPAN = 0,
-    LINE = 1
+    LINE = 1,
+    /** Draws range or block backgrounds before inline backgrounds and text. */
+    BACKGROUND = 2
 }
 export declare class docExtension extends ComponentExtension<IDocumentSkeletonGlyph | IDocumentSkeletonLine, DOCS_EXTENSION_TYPE, IBoundRectNoAngle> {
     type: DOCS_EXTENSION_TYPE;

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

@@ -38,6 +38,6 @@ export interface IDocumentCompatibilityPolicy {
 }
 export declare function getDocumentCompatibilityPolicy(documentFlavor?: DocumentFlavor): IDocumentCompatibilityPolicy;
 export declare function applyFontMetricCompatibility(content: string, fontStyle: IDocumentSkeletonFontStyle, bBox: IDocumentSkeletonBoundingBox, policy: IDocumentCompatibilityPolicy): IDocumentSkeletonBoundingBox;
-export declare function isTraditionalDocumentCompatibility(policy: IDocumentCompatibilityPolicy): boolean;
+export declare function isTraditionalDocumentCompatibility(policy?: IDocumentCompatibilityPolicy): boolean;
 export declare function shouldAllowImportedTableMarginOverflow(policy: IDocumentCompatibilityPolicy, tableSource: ITable | unknown): boolean;
 export {};

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

@@ -13,8 +13,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { Nullable } from '@univerjs/core';
-import type { IDocumentSkeletonPage, IDocumentSkeletonSection } from '../../basics/i-document-skeleton-cached';
+import type { ICustomRange, Nullable } from '@univerjs/core';
+import type { IDocumentSkeletonGlyph, IDocumentSkeletonPage, IDocumentSkeletonSection } from '../../basics/i-document-skeleton-cached';
 import type { Transform } from '../../basics/transform';
 import type { IViewportInfo } from '../../basics/vector2';
 import type { UniverRenderingContext } from '../../context';
@@ -23,6 +23,7 @@ import type { DocumentSkeleton } from './layout/doc-skeleton';
 import { Vector2 } from '../../basics/vector2';
 import { DocComponent } from './doc-component';
 import './extensions';
+export declare function resolveHeaderFooterFieldGlyph(glyph: IDocumentSkeletonGlyph, startIndex: number, endIndex: number, customRanges: ICustomRange[], pageNumber: number, pageCount: number): IDocumentSkeletonGlyph;
 export interface IPageRenderConfig {
     page: IDocumentSkeletonPage;
     pageLeft: number;

package/lib/types/components/docs/extensions/font-and-base-line.d.ts

@@ -46,5 +46,6 @@ export declare class FontAndBaseLine extends docExtension {
     private _colorWithOpacity;
     private _clamp;
     private _fillText;
+    private _getTabLeaderCharacter;
     clearCache(): void;
 }

package/lib/types/components/docs/layout/block/paragraph/layout-ruler.d.ts

@@ -13,13 +13,14 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { IDocumentSkeletonColumn, IDocumentSkeletonDrawing, IDocumentSkeletonGlyph, IDocumentSkeletonLine, IDocumentSkeletonPage, IDocumentSkeletonSection, IDocumentSkeletonTable } from '../../../../../basics/i-document-skeleton-cached';
+import type { IDocumentSkeletonColumn, IDocumentSkeletonDivide, IDocumentSkeletonDrawing, IDocumentSkeletonGlyph, IDocumentSkeletonLine, IDocumentSkeletonPage, IDocumentSkeletonSection, IDocumentSkeletonTable } from '../../../../../basics/i-document-skeleton-cached';
 import type { IParagraphConfig, IParagraphTableCache, ISectionBreakConfig } from '../../../../../basics/interfaces';
 import type { IFloatObject, ILayoutContext } from '../../tools';
 import { BooleanNumber, GridType, SpacingRule } from '@univerjs/core';
 import { BreakPointType } from '../../line-breaker/break';
 declare function isGlyphGroupBeyondDivideWidth(glyphGroup: IDocumentSkeletonGlyph[], offsetLeft: number, divideWidth: number, hangingPunctuation?: boolean): boolean;
-export declare function layoutParagraph(ctx: ILayoutContext, glyphGroup: IDocumentSkeletonGlyph[], pages: IDocumentSkeletonPage[], sectionBreakConfig: ISectionBreakConfig, paragraphConfig: IParagraphConfig, isParagraphFirstShapedText: boolean, breakPointType?: BreakPointType): IDocumentSkeletonPage[];
+export declare function layoutParagraph(ctx: ILayoutContext, glyphGroup: IDocumentSkeletonGlyph[], pages: IDocumentSkeletonPage[], sectionBreakConfig: ISectionBreakConfig, paragraphConfig: IParagraphConfig, isParagraphFirstShapedText: boolean, breakPointType?: BreakPointType, renderBullet?: boolean): IDocumentSkeletonPage[];
+declare function _adjustExplicitTabStop(divide: IDocumentSkeletonDivide, followingGlyphs: IDocumentSkeletonGlyph[], paragraphConfig: IParagraphConfig): void;
 declare function __avoidFlowAffectingDrawingsForTable(table: IDocumentSkeletonTable, page: IDocumentSkeletonPage, column: IDocumentSkeletonColumn): void;
 declare function _updateAndPositionTable(ctx: ILayoutContext, lineTop: number, lineHeight: number, page: IDocumentSkeletonPage, column: IDocumentSkeletonColumn, section: IDocumentSkeletonSection, skeTablesInParagraph: IParagraphTableCache[], paragraphIndex: number, sectionBreakConfig: ISectionBreakConfig, drawingAnchorTop?: number): boolean;
 declare function _reLayoutCheck(ctx: ILayoutContext, floatObjects: IFloatObject[], column: IDocumentSkeletonColumn, paragraphIndex: number): void;
@@ -29,8 +30,9 @@ export declare const __testing: {
     isGlyphGroupBeyondDivideWidth: typeof isGlyphGroupBeyondDivideWidth;
     checkPageBreak: typeof __checkPageBreak;
     updateAndPositionTable: typeof _updateAndPositionTable;
+    adjustExplicitTabStop: typeof _adjustExplicitTabStop;
 };
-export declare function getLineHeightMetrics(glyphLineHeight: number, paragraphLineGapDefault: number, linePitch: number, gridType: GridType, lineSpacing: number, spacingRule: SpacingRule, snapToGrid: BooleanNumber, useWordStyleLineHeight?: boolean, scaleAutoLineSpacingByGlyphHeight?: boolean): {
+export declare function getLineHeightMetrics(glyphLineHeight: number, paragraphLineGapDefault: number, linePitch: number, gridType: GridType, lineSpacing: number, spacingRule: SpacingRule, snapToGrid: BooleanNumber, useWordStyleLineHeight?: boolean, scaleAutoLineSpacingByGlyphHeight?: boolean, normalLineHeight?: number, snapAutoLineSpacingToWholeGridLines?: boolean): {
     paddingTop: number;
     paddingBottom: number;
     contentHeight: number;

package/lib/types/components/docs/layout/block/paragraph/linebreaking.d.ts

@@ -20,4 +20,4 @@ import type { DataStreamTreeNode } from '../../../view-model/data-stream-tree-no
 import type { DocumentViewModel } from '../../../view-model/document-view-model';
 import type { ILayoutContext } from '../../tools';
 import type { IShapedText } from './shaping';
-export declare function lineBreaking(ctx: ILayoutContext, viewModel: DocumentViewModel, shapedTextList: IShapedText[], curPage: IDocumentSkeletonPage, paragraphNode: DataStreamTreeNode, sectionBreakConfig: ISectionBreakConfig, tableSkeleton: Nullable<IDocumentSkeletonTable>): IDocumentSkeletonPage[];
+export declare function lineBreaking(ctx: ILayoutContext, viewModel: DocumentViewModel, shapedTextList: IShapedText[], curPage: IDocumentSkeletonPage, paragraphNode: DataStreamTreeNode, sectionBreakConfig: ISectionBreakConfig, tableSkeleton: Nullable<IDocumentSkeletonTable>, tablePageBreakBefore?: boolean): IDocumentSkeletonPage[];

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

@@ -21,10 +21,11 @@ import type { DocumentViewModel } from '../../view-model/document-view-model';
 import type { ILayoutContext } from '../tools';
 import { BreakType } from '../../../../basics/i-document-skeleton-cached';
 export declare function createSkeletonPage(ctx: ILayoutContext, sectionBreakConfig: ISectionBreakConfig, skeletonResourceReference: ISkeletonResourceReference, pageNumber?: number, breakType?: BreakType): IDocumentSkeletonPage;
-export declare function createNullCellPage(ctx: ILayoutContext, sectionBreakConfig: ISectionBreakConfig, tableConfig: ITable, row: number, col: number, availableHeight?: number, maxCellPageHeight?: number): {
+export declare function createNullCellPage(ctx: ILayoutContext, sectionBreakConfig: ISectionBreakConfig, tableConfig: ITable, row: number, col: number, availableHeight?: number, maxCellPageHeight?: number, inheritDocumentLinePitch?: boolean, enableDocumentTableLineGrid?: boolean): {
     page: IDocumentSkeletonPage;
     sectionBreakConfig: ISectionBreakConfig;
 };
 export declare function createSkeletonCellPages(ctx: ILayoutContext, viewModel: DocumentViewModel, cellNode: DataStreamTreeNode, sectionBreakConfig: ISectionBreakConfig, tableConfig: ITable, row: number, col: number, availableHeight?: number, maxCellPageHeight?: number): IDocumentSkeletonPage[];
 export declare function expandCellPageHeightForInlineDrawings(pages: IDocumentSkeletonPage[]): void;
+export declare function expandCellPageHeightForFlowTables(pages: IDocumentSkeletonPage[]): void;
 export declare function applyTrailingBlockRangeSpaceBelow(pages: IDocumentSkeletonPage[], body: Nullable<IDocumentBody>, containerEndIndex: number): void;

package/lib/types/components/docs/layout/tools.d.ts

@@ -50,6 +50,7 @@ export declare function isBlankColumn(column: IDocumentSkeletonColumn): boolean;
 export declare function getNumberUnitValue(unitValue: Nullable<INumberUnit>, benchMark: number): number;
 export declare function getCharSpaceApply(charSpace: number | undefined, defaultTabStop: number, gridType?: GridType, snapToGrid?: BooleanNumber): number;
 export declare function validationGrid(gridType?: GridType, snapToGrid?: BooleanNumber): boolean;
+export declare function reachesNextDocumentGridLine(lineSpacing: number, spaceBelow: number, linePitch: number): boolean;
 export declare function getLineHeightConfig(sectionBreakConfig: ISectionBreakConfig, paragraphConfig: IParagraphConfig): {
     paragraphLineGapDefault: number;
     linePitch: number;

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

@@ -19,6 +19,8 @@ export declare const FONT_EXTENSION_Z_INDEX = 45;
 export declare const BG_Z_INDEX = 21;
 export declare const PRINTING_BG_Z_INDEX = 21;
 export declare const EXPAND_SIZE_FOR_RENDER_OVERFLOW = 20;
+export declare const MIN_TEXT_RENDER_HEIGHT_IN_SCREEN_PX = 4;
+export declare function shouldRenderRowText(rowHeight: number, scaleY?: number): boolean;
 export declare const sheetContentViewportKeys: SHEET_VIEWPORT_KEY[];
 export declare const sheetHeaderViewportKeys: SHEET_VIEWPORT_KEY[];
 export declare const MEASURE_EXTENT = 10000;

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

@@ -35,7 +35,7 @@ export declare class ColumnHeaderLayout extends SheetExtension {
     constructor(cfg?: IColumnsHeaderCfgParam);
     configHeaderColumn(cfg: IColumnsHeaderCfgParam, sheetId?: string): void;
     getColumnsCfg(sheetId: string): Record<number, IAColumnCfg>;
-    getHeaderStyle(sheetId: string): IHeaderStyleCfg;
+    getHeaderStyle(sheetId: string, isPrinting?: boolean): IHeaderStyleCfg;
     getCfgOfCurrentColumn(columnsCfg: Record<number, IAColumnCfg>, headerStyle: IHeaderStyleCfg, colIndex: number): [IAColumnCfgObj, boolean];
     setStyleToCtx(ctx: UniverRenderingContext, columnStyle: Partial<IHeaderStyleCfg>): void;
     draw(ctx: UniverRenderingContext, parentScale: IScale, spreadsheetSkeleton: SpreadsheetSkeleton): void;

package/lib/types/components/sheets/extensions/row-header-layout.d.ts

@@ -32,7 +32,7 @@ export declare class RowHeaderLayout extends SheetExtension {
     constructor(cfg?: IRowsHeaderCfgParam);
     configHeaderRow(cfg: IRowsHeaderCfgParam, sheetId?: string): void;
     getRowsCfg(sheetId: string): Record<number, IARowCfg>;
-    getHeaderStyle(sheetId: string): IRowStyleCfg;
+    getHeaderStyle(sheetId: string, isPrinting?: boolean): IRowStyleCfg;
     getCfgOfCurrentRow(rowsCfg: Record<number, IARowCfg>, headerStyle: IHeaderStyleCfg, rowIndex: number): [IARowCfgObj, boolean];
     setStyleToCtx(ctx: UniverRenderingContext, rowStyle: Partial<IHeaderStyleCfg>): void;
     draw(ctx: UniverRenderingContext, parentScale: IScale, spreadsheetSkeleton: SpreadsheetSkeleton): void;

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

@@ -52,6 +52,10 @@ interface ISetStylesCacheForOneCellOptions {
     reuseExisting?: boolean;
     hasMergeData?: boolean;
     rowVisible?: boolean;
+    skipFontCache?: boolean;
+}
+export interface ISetStylesCacheOptions {
+    scaleY?: number;
 }
 export interface IGetPosByRowColOptions {
     closeFirst?: boolean;
@@ -116,8 +120,9 @@ export declare class SpreadsheetSkeleton extends SheetSkeleton {
     /**
      * Set border background and font to this._stylesCache by visible range, which derives from bounds)
      * @param vpInfo viewBounds
+     * @param options screen scale
      */
-    setStylesCache(vpInfo?: IViewportInfo): Nullable<SpreadsheetSkeleton>;
+    setStylesCache(vpInfo?: IViewportInfo, options?: ISetStylesCacheOptions): Nullable<SpreadsheetSkeleton>;
     /**
      * Calc all auto height by getDocsSkeletonPageSize in ranges
      * @param ranges

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/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

@@ -25,6 +25,7 @@ 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 { 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';

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/scene.d.ts

@@ -55,6 +55,13 @@ export declare class Scene extends Disposable {
     private _evented;
     private _layers;
     private _viewports;
+    private _preserveEngineOnRender;
+    private _scrollbarDragViewport;
+    private _isScrollbarSeeking;
+    private _isScrollbarPreviewDirty;
+    private _lastScrollbarSeekInputAt;
+    private _estimatedFullRenderDuration;
+    private _renderedViewportScrollPositions;
     private _cursor;
     private _defaultCursor;
     private _addObject$;
@@ -121,6 +128,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 +230,11 @@ 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;
     render(parentCtx?: UniverRenderingContext): void;
     requestRender(parentCtx?: UniverRenderingContext): Promise<unknown>;
     /**

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

@@ -95,6 +95,7 @@ export declare class Transformer extends Disposable implements ITransformerConfi
     boundBoxFunc: Nullable<(oldBox: BaseObject, newBox: BaseObject) => BaseObject>;
     useSingleNodeRotation: boolean;
     shouldOverdrawWholeArea: boolean;
+    controlLayerIndex: number | undefined;
     private readonly _changeStart$;
     /**
      * actually pointer down on a object,

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

@@ -31,10 +31,13 @@ export declare class DumbCanvasColorService implements ICanvasColorService {
  */
 export declare class CanvasColorService extends Disposable implements ICanvasColorService {
     private readonly _themeService;
-    private readonly _cache;
+    private readonly _darkModeCache;
+    private readonly _resolvedColorCache;
     private _invertAlgo;
     constructor(_themeService: ThemeService);
-    getRenderColor(color: string): string;
+    getRenderColor(inputColor: string): string;
+    private _resolveColor;
+    private _resolveThemeColor;
 }
 export declare function getDarkRenderColorOverride(color: string): string | null;
 export declare function hexToRgb(_hex: string): RGBColorType;

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

@@ -20,6 +20,8 @@ export interface ICheckboxShapeProps extends IShapeProps {
     checked?: boolean;
 }
 export declare const CHECK_OBJECT_ARRAY: string[];
+export declare function isCheckboxGlyph(content: string): boolean;
+export declare function getCheckboxShapeSize(fontSize?: number): number;
 export declare class CheckboxShape extends Shape<ICheckboxShapeProps> {
     _checked: boolean;
     constructor(key: string, props: ICheckboxShapeProps);

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

@@ -63,6 +63,8 @@ export declare class Image extends Shape<IImageProps> {
     private _renderByCropper;
     private _transformCalculateSrcRect;
     private _clipService;
+    private _rasterCacheSource;
+    private _autoRasterCache;
     objectType: ObjectType;
     isDrawingObject: boolean;
     constructor(id: string, config: IImageProps);
@@ -70,6 +72,7 @@ export declare class Image extends Shape<IImageProps> {
     get prstGeom(): Nullable<string>;
     get opacity(): number;
     get clipBounds(): Nullable<IShapeClipBounds>;
+    private _shouldRasterCache;
     setOpacity(opacity: number): void;
     setClipBounds(clipBounds?: Nullable<IShapeClipBounds>): void;
     setClipService(clipService: Nullable<IImageShapeClipService>): void;
@@ -100,6 +103,7 @@ export declare class Image extends Shape<IImageProps> {
     private _transformBySrcRect;
     render(mainCtx: UniverRenderingContext, bounds?: IViewportInfo): this;
     protected _draw(ctx: UniverRenderingContext, _bounds?: IViewportInfo, renderWidth?: number, renderHeight?: number): void;
+    private _drawNative;
     private _init;
     private _updateSrcRectByTransform;
     set transform(trans: Transform);

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;
@@ -143,7 +142,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

@@ -58,6 +58,7 @@ export declare abstract class Shape<T extends IShapeProps> extends BaseObject {
     private _renderCacheCanvas;
     private _renderCacheBounds;
     private _renderCachePixelRatio;
+    private _renderCacheTransformSize;
     private _hoverCursor;
     private _moveCursor;
     private _fillRule;
@@ -132,7 +133,9 @@ export declare abstract class Shape<T extends IShapeProps> extends BaseObject {
     toJson(): {
         [x: string]: any;
     };
-    protected _renderWithCache(ctx: UniverRenderingContext, bounds: IBoundRectNoAngle, draw: (cacheContext: UniverRenderingContext) => void): void;
+    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;
     private _initialProps;

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