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

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

@@ -31,5 +31,6 @@ export * from './text-rotation';
 export * from './tools';
 export * from './transform';
 export type { ITransformerConfig } from './transformer-config';
+export { DEFAULT_TRANSFORMER_CONFIG } from './transformer-config';
 export * from './vector2';
 export * from './zoom';

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,7 +62,36 @@ 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;
 }
+export declare const DEFAULT_TRANSFORMER_CONFIG: {
+    resizeEnabled: true;
+    rotateEnabled: true;
+    rotateAnchorOffset: number;
+    rotateAnchorPosition: "bottom";
+    rotateLineEnabled: false;
+    rotateSize: number;
+    rotateCornerRadius: number;
+    rotateFill: string;
+    rotateStroke: string;
+    rotateStrokeWidth: number;
+    rotateIconEnabled: true;
+    rotateIconStroke: string;
+    rotateIconStrokeWidth: number;
+    borderEnabled: true;
+    borderStroke: string;
+    borderStrokeWidth: number;
+    borderSpacing: number;
+    anchorFill: string;
+    anchorStroke: string;
+    anchorStrokeWidth: number;
+    anchorSize: number;
+    anchorCornerRadius: number;
+    anchorStyle: "canva";
+    keepRatio: true;
+    moveBoundaryEnabled: true;
+};

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

@@ -13,11 +13,25 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { Nullable } from '@univerjs/core';
+import type { IColumnGroup, Nullable } from '@univerjs/core';
 import type { IDocumentSkeletonColumnGroup, IDocumentSkeletonPage } from '../../../../basics/i-document-skeleton-cached';
 import type { ISectionBreakConfig } from '../../../../basics/interfaces';
 import type { DataStreamTreeNode } from '../../view-model/data-stream-tree-node';
 import type { DocumentViewModel } from '../../view-model/document-view-model';
 import type { ILayoutContext } from '../tools';
+interface IColumnGroupLayoutColumn {
+    columnId: string;
+    left: number;
+    top: number;
+    width: number;
+}
+interface IColumnGroupLayout {
+    mode: 'horizontal' | 'stack';
+    width: number;
+    height: number;
+    columns: IColumnGroupLayoutColumn[];
+}
 export declare function createColumnGroupSkeleton(ctx: ILayoutContext, curPage: IDocumentSkeletonPage, viewModel: DocumentViewModel, columnGroupNode: DataStreamTreeNode, sectionBreakConfig: ISectionBreakConfig): Nullable<IDocumentSkeletonColumnGroup>;
 export declare function appendColumnGroupBlockLine(page: IDocumentSkeletonPage, columnGroup: IDocumentSkeletonColumnGroup): boolean;
+export declare function calculateColumnGroupLayout(source: IColumnGroup, availableWidth: number, columnHeights: number[]): IColumnGroupLayout;
+export {};

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

@@ -0,0 +1,17 @@
+/**
+ * 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 { IColorStyle, Nullable } from '@univerjs/core';
+export declare function getColorStyleForCanvas(color: Nullable<IColorStyle>): Nullable<string>;

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;
@@ -78,6 +82,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;
@@ -98,6 +103,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>;
@@ -116,8 +122,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/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

@@ -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/render-manager/render-manager.service.d.ts

@@ -78,7 +78,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.d.ts

@@ -55,6 +55,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 +129,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 +231,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>;
     /**

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,11 +31,12 @@ 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 _resolvedThemeColors;
     private _invertAlgo;
     constructor(_themeService: ThemeService);
-    getRenderColor(color: string): string;
+    getRenderColor(inputColor: string): string;
+    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/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;
@@ -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;