@univerjs/engine-render 1.0.0-alpha.8 → 1.0.0-beta.1

package/lib/types/alignment-snap.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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.
+ */
+export interface IAlignmentRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export type AlignmentSnapAxis = 'x' | 'y';
+export interface IAlignmentSnapGuide {
+    id: string;
+    axis: AlignmentSnapAxis;
+    position: number;
+}
+export interface IAlignmentSnapSessionConfig {
+    enterThreshold?: number;
+    exitThreshold?: number;
+    breakawayThreshold?: number;
+    softThreshold?: number;
+    hardThreshold?: number;
+    softMaxStrength?: number;
+    cooldownMs?: number;
+}
+export interface IAlignmentSnapAxisOptions {
+    axis: AlignmentSnapAxis;
+    value: number;
+    guide: IAlignmentSnapGuide | null;
+    now?: number;
+}
+export interface IAlignmentSnapAxisResult {
+    snapped: boolean;
+    value: number;
+    guide: IAlignmentSnapGuide | null;
+}
+export declare function normalizeAlignmentRect(rect: IAlignmentRect): IAlignmentRect;
+export declare function getAlignmentRectXAnchors(rect: IAlignmentRect): [number, number, number];
+export declare function getAlignmentRectYAnchors(rect: IAlignmentRect): [number, number, number];
+export declare function getClosestAlignmentOffset(activeAnchors: readonly number[], targetAnchors: readonly number[], threshold: number): number;
+export declare class AlignmentSnapSession {
+    private readonly _enterThreshold;
+    private readonly _exitThreshold;
+    private readonly _breakawayThreshold;
+    private readonly _softThreshold;
+    private readonly _hardThreshold;
+    private readonly _softMaxStrength;
+    private readonly _cooldownMs;
+    private _activeGuideId;
+    private _activeGuideStartValue;
+    private _releasedUntil;
+    constructor(config?: IAlignmentSnapSessionConfig);
+    reset(): void;
+    resolveAxisSnap(options: IAlignmentSnapAxisOptions): IAlignmentSnapAxisResult;
+    private _resolveSnappedValue;
+}

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

@@ -164,6 +164,14 @@ export declare abstract class BaseObject extends Disposable {
     isRender(bounds?: IViewportInfo): boolean | undefined;
     getParent(): any;
     getState(): ITransformState;
+    /**
+     * Returns the flip state after composing this object with every ancestor
+     * drawing group whose transform participates in rendering.
+     */
+    getEffectiveFlipState(): {
+        flipX: boolean;
+        flipY: boolean;
+    };
     getRealBound(): IGroupBaseBound;
     hide(): void;
     show(): void;

package/lib/types/basics/drawing-effect.d.ts

@@ -13,8 +13,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import type { IGlowEffect, IShadowEffect } from '@univerjs/core';
 import type { IBoundRectNoAngle } from './vector2';
-import { type IGlowEffect, type IShadowEffect } from '@univerjs/core';
 export interface IResolvedDrawingShadow {
     color: string;
     blurRadius: number;

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 {
@@ -209,6 +216,8 @@ export interface IDocumentSkeletonGlyph {
     url?: string;
     featureId?: string;
     drawingId?: string;
+    fauxBoldStrokeWidth?: number;
+    tabLeader?: TabStopLeader;
 }
 export interface IDocumentSkeletonBullet {
     listId: string;
@@ -216,9 +225,13 @@ export interface IDocumentSkeletonBullet {
     ts: ITextStyle;
     fontStyle?: IDocumentSkeletonFontStyle;
     startIndexItem: number;
+    startNumber?: number;
     nestingLevel?: INestingLevel;
     bulletAlign?: BulletAlignment;
     bulletType?: boolean;
+    compactSpacing?: boolean;
+    preserveTextLineHeight?: boolean;
+    imageSource?: string;
     paragraphProperties?: IParagraphProperties;
 }
 export interface IDocumentSkeletonDrawing {
@@ -241,6 +254,8 @@ export interface IDocumentSkeletonDrawing {
         contentHeight?: number;
         contentWidth?: number;
         height?: number;
+        pageContentWidth?: number;
+        viewScale?: number;
         viewportHeight?: number;
     };
 }
@@ -255,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,8 +92,18 @@ export interface IParagraphTableCache {
 }
 export interface IParagraphConfig {
     paragraphIndex: number;
+    isInsideTable?: boolean;
     documentCompatibilityPolicy?: IDocumentCompatibilityPolicy;
     useWordStyleLineHeight?: boolean;
+    usePptxFontSizeLineHeight?: boolean;
+    usePptxNominalFontLineHeight?: boolean;
+    usePptxCompatibleLineSpacing?: boolean;
+    usePptxPercentageLineSpacing?: boolean;
+    pptxPercentageFontSize?: number;
+    usePptxNormAutofitLineHeight?: boolean;
+    pptxEmptyParagraphFontSize?: number;
+    pptxHasExplicitEndParaFontSize?: boolean;
+    sumPptxParagraphSpacing?: boolean;
     docxFallbackAnchorLeft?: IParagraphStyle['indentStart'];
     paragraphNonInlineSkeDrawings?: Map<string, IDocumentSkeletonDrawing>;
     paragraphInlineSkeDrawings?: Map<string, IDocumentSkeletonDrawing>;

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

@@ -16,6 +16,7 @@
 import type { IPosition, IRange, IRangeWithCoord, IScale, IStyleBase, Nullable } from '@univerjs/core';
 import type { IDocumentSkeletonFontStyle } from './i-document-skeleton-cached';
 import type { IBoundRectNoAngle } from './vector2';
+export declare function hasScrollableOverflow(contentSize: number, viewportSize: number): boolean;
 export declare const getColor: (RgbArray: number[], opacity?: number) => string;
 export declare const toPx: (num: number | string, ReferenceValue: Nullable<number>) => number;
 /**

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/custom-block-render-viewport.d.ts

@@ -29,6 +29,8 @@ export interface IDocsCustomBlockRenderViewport {
     height: number;
     layoutWidth?: number;
     offsetLeft?: number;
+    pageContentWidth?: number;
+    viewScale?: number;
     viewportHeight?: number;
     width: number;
 }

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

@@ -15,17 +15,21 @@
  */
 import type { IScale } from '@univerjs/core';
 import type { IDocumentSkeletonGlyph } from '../../../basics/i-document-skeleton-cached';
+import type { IBoundRectNoAngle } from '../../../basics/vector2';
 import type { UniverRenderingContext } from '../../../context';
+import type { IDrawInfo } from '../../extension';
 import { docExtension } from '../doc-extension';
 export declare class Line extends docExtension {
     uKey: string;
     Z_INDEX: number;
     private _preBackgroundColor;
-    draw(ctx: UniverRenderingContext, parentScale: IScale, glyph: IDocumentSkeletonGlyph): void;
+    draw(ctx: UniverRenderingContext, parentScale: IScale, glyph: IDocumentSkeletonGlyph, _diff?: IBoundRectNoAngle, more?: IDrawInfo): void;
     clearCache(): void;
     private _drawLine;
     private _drawLineTo;
     private _setLineType;
     private _isWave;
     private _isDouble;
+    private _isAccounting;
+    private _isFirstAccountingGlyph;
 }

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

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { IBullet, ILists, LocaleService, Nullable } from '@univerjs/core';
+import type { IBullet, ILists, ITextStyle, LocaleService, Nullable } from '@univerjs/core';
 import type { IDocumentSkeletonBullet } from '../../../../../basics/i-document-skeleton-cached';
-export declare function dealWithBullet(bullet?: IBullet, lists?: ILists, listLevelAncestors?: Array<Nullable<IDocumentSkeletonBullet>>, localeService?: LocaleService): IDocumentSkeletonBullet | undefined;
+export declare function dealWithBullet(bullet?: IBullet, lists?: ILists, listLevelAncestors?: Array<Nullable<IDocumentSkeletonBullet>>, localeService?: LocaleService, compactSpacing?: boolean, paragraphTextStyle?: ITextStyle): IDocumentSkeletonBullet | undefined;
 export declare function getDefaultBulletSke(listId: string, startIndex?: number): IDocumentSkeletonBullet;

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): boolean;
-export declare function layoutParagraph(ctx: ILayoutContext, glyphGroup: IDocumentSkeletonGlyph[], pages: IDocumentSkeletonPage[], sectionBreakConfig: ISectionBreakConfig, paragraphConfig: IParagraphConfig, isParagraphFirstShapedText: boolean, breakPointType?: BreakPointType): IDocumentSkeletonPage[];
+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, 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/doc-no-wrap-measure.d.ts

@@ -27,6 +27,11 @@ export declare function measureDocumentNoWrapTextRangeWidth(documentData: IDocum
  * details such as CJK-Latin spacing.
  */
 export declare function measureDocumentNoWrapTextWidth(documentData: IDocumentData | null | undefined): number;
+/**
+ * Measures the widest line after applying the docs Unicode break policy
+ * within a fixed-width host.
+ */
+export declare function measureDocumentWrappedTextWidth(documentData: IDocumentData | null | undefined, maxLineWidth: number): number;
 /**
  * Measures the widest segment that docs line breaking keeps together. This is
  * useful when a host may wrap normally but still needs enough width to avoid

package/lib/types/{basics/unit-convert.d.ts → components/docs/layout/line-breaker/extensions/east-asian-quote-linebreak-extension.d.ts}

@@ -13,5 +13,5 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-declare const whiteListKeyForPt: Set<string>;
-declare function isNotEmpty(value: unknown): boolean;
+import type { LineBreaker } from '../line-breaker';
+export declare function eastAsianQuoteLineBreakExtension(breaker: LineBreaker): void;

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

@@ -21,4 +21,6 @@ export * from './row-header';
 export * from './sheet-component';
 export * from './sheet.render-skeleton';
 export * from './spreadsheet';
+export { calculateCellImageRect } from './util';
+export type { ICellImageRectConfig } from './util';
 export * from './watermark';

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

@@ -40,6 +40,7 @@ export declare const DEFAULT_PADDING_DATA: {
 };
 export declare const RENDER_RAW_FORMULA_KEY = "RENDER_RAW_FORMULA";
 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 scaleDocumentDataForShrinkToFit(documentData: IDocumentData, scale: number, fallbackFontSize: number): IDocumentData;
 export interface ICacheItem {
     bg: boolean;
@@ -51,6 +52,10 @@ interface ISetStylesCacheForOneCellOptions {
     reuseExisting?: boolean;
     hasMergeData?: boolean;
     rowVisible?: boolean;
+    skipFontCache?: boolean;
+}
+export interface ISetStylesCacheOptions {
+    scaleY?: number;
 }
 export interface IGetPosByRowColOptions {
     closeFirst?: boolean;
@@ -115,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
@@ -177,6 +183,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;
     _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;
@@ -48,7 +49,7 @@ export declare class Spreadsheet extends SheetComponent {
      * @param ctx
      * @param viewportInfo
      */
-    draw(ctx: UniverRenderingContext2D, viewportInfo: IViewportInfo): void;
+    draw(ctx: UniverRenderingContext2D, viewportInfo: IViewportInfo, isMergeRepair?: boolean): void;
     addRenderFrameTimeMetricToScene(timeKey: string, val: number, scene: Scene): void;
     addRenderTagToScene(renderKey: string, val: any, scene?: Scene): void;
     /**
@@ -77,7 +78,11 @@ export declare class Spreadsheet extends SheetComponent {
     makeDirty(state?: boolean): this;
     setDirtyArea(dirtyBounds: IBoundRectNoAngle[]): void;
     renderByViewports(mainCtx: UniverRenderingContext2D, viewportInfo: IViewportInfo, spreadsheetSkeleton: SpreadsheetSkeleton): void;
-    paintNewAreaForScrolling(viewportInfo: IViewportInfo, param: IPaintForScrolling): void;
+    private _getMergeRepairBounds;
+    private _getRepaintBounds;
+    paintNewAreaForScrolling(viewportInfo: IViewportInfo, param: IPaintForScrolling, mergeRepairBounds?: IBoundRectNoAngle[]): Canvas;
+    private _copyCacheForScrolling;
+    private _getScrollBufferCanvas;
     /**
      * Redraw the entire viewport.
      */

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

@@ -14,7 +14,17 @@
  * limitations under the License.
  */
 import type { CellValueType, IPaddingData, IStyleBase, IStyleData, ITextRotation, ITextStyle, Nullable, TextDirection } from '@univerjs/core';
+import type { IBoundRectNoAngle } from '../../basics';
 import { DocumentDataModel, HorizontalAlign, VerticalAlign, WrapStrategy } from '@univerjs/core';
+export interface ICellImageRectConfig {
+    cellRect: IBoundRectNoAngle;
+    imageWidth: number;
+    imageHeight: number;
+    horizontalAlign: HorizontalAlign;
+    verticalAlign: VerticalAlign;
+    padding?: Nullable<IPaddingData>;
+}
+export declare function calculateCellImageRect(config: ICellImageRectConfig): IBoundRectNoAngle;
 export interface ICellStyle {
     textRotation?: ITextRotation;
     textDirection?: Nullable<TextDirection>;

package/lib/types/drawing-group.d.ts

@@ -34,7 +34,7 @@ export declare class DrawingGroupObject extends Group {
      * When rendering, positions are mapped from baseBound space to the group's current transform.
      */
     private _baseBound;
-    private _outerShadow?;
+    protected _outerShadow?: IDrawingGroupShadow;
     private _glow?;
     setOuterShadow(shadow?: IDrawingGroupShadow): void;
     setGlow(glow?: IGlowEffect): void;

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

@@ -13,6 +13,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+export { AlignmentSnapSession, getAlignmentRectXAnchors, getAlignmentRectYAnchors, getClosestAlignmentOffset, normalizeAlignmentRect, } from './alignment-snap';
+export type { AlignmentSnapAxis, IAlignmentRect, IAlignmentSnapAxisOptions, IAlignmentSnapAxisResult, IAlignmentSnapGuide, IAlignmentSnapSessionConfig, } from './alignment-snap';
 export * from './base-object';
 export * from './basics';
 export { combineDrawingEffectFilter, createDrawingEffectFilter, expandDrawingEffectBounds, resolveDrawingEffectMasks, resolveGlowEffect, resolveOuterShadowEffect, } from './basics/drawing-effect';
@@ -23,11 +25,12 @@ 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';
 export { getTableIdAndSliceIndex } from './components/docs/layout/block/table';
-export { measureDocumentNoWrapTextRangeWidth, measureDocumentNoWrapTextWidth, measureDocumentUnbreakableTextWidth, } from './components/docs/layout/doc-no-wrap-measure';
+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';

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;