@univerjs/engine-render 1.0.0-alpha.2 → 1.0.0-alpha.3

package/lib/types/basics/cjk-regexp.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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.
+ */
+type CharsetDataUnit = [number, number];
+/**
+ * Returns the CJK letter charset generated from `cjk-regex@3.4.0`.
+ */
+declare function letters(): import("@univerjs/core/common/regexp/charset.js").Charset;
+/**
+ * Returns the CJK punctuation charset generated from `cjk-regex@3.4.0`.
+ */
+declare function punctuations(): import("@univerjs/core/common/regexp/charset.js").Charset;
+/**
+ * Returns the combined CJK letter and punctuation charset generated from `cjk-regex@3.4.0`.
+ */
+declare function all(): import("@univerjs/core/common/regexp/charset.js").Charset;
+/**
+ * Returns true when text contains CJK letters, excluding punctuation and symbols.
+ */
+declare function hasCJKText(text: string): boolean;
+/**
+ * Returns true when text contains CJK letters or CJK punctuation.
+ */
+declare function hasCJK(text: string): boolean;
+/**
+ * Returns true when text contains CJK punctuation, excluding CJK letters.
+ */
+declare function hasCJKPunctuation(text: string): boolean;
+/**
+ * Namespace-style CJK regex API used by document rendering and layout.
+ */
+export declare const cjk: {
+    CJK_LETTER_SOURCE: string;
+    CJK_PUNCTUATION_SOURCE: string;
+    CJK_ALL_SOURCE: string;
+    CJK_LETTER_REG: RegExp;
+    CJK_PUNCTUATION_REG: RegExp;
+    CJK_ALL_REG: RegExp;
+    CJK_LETTER_DATA: CharsetDataUnit[];
+    CJK_PUNCTUATION_DATA: CharsetDataUnit[];
+    CJK_ALL_DATA: CharsetDataUnit[];
+    letters: typeof letters;
+    punctuations: typeof punctuations;
+    all: typeof all;
+    hasCJKText: typeof hasCJKText;
+    hasCJK: typeof hasCJK;
+    hasCJKPunctuation: typeof hasCJKPunctuation;
+};
+export {};

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

@@ -17,7 +17,7 @@ import type { IPosition } from '@univerjs/core';
 import type { UniverRenderingContext } from '../context';
 import type { IDocumentSkeletonLine } from './i-document-skeleton-cached';
 import { BorderStyleTypes } from '@univerjs/core';
-import { BORDER_TYPE as BORDER_LTRB, ORIENTATION_TYPE } from './const';
+import { BORDER_TYPE, ORIENTATION_TYPE } from './const';
 import { Vector2 } from './vector2';
 export interface IContext2D extends CanvasRenderingContext2D {
     webkitBackingStorePixelRatio: number;
@@ -34,9 +34,9 @@ export declare function getDevicePixelRatio(): number;
  * @param lineWidthBuffer Solving the problem of mitered corners in the drawing of borders thicker than 2 pixels, caused by the line segments being centered.
  * @param position border draw position
  */
-export declare function drawLineByBorderType(ctx: UniverRenderingContext, type: BORDER_LTRB, lineWidthBuffer: number, position: IPosition): void;
-export declare function drawDiagonalLineByBorderType(ctx: UniverRenderingContext, style: BorderStyleTypes, type: BORDER_LTRB, position: IPosition): void;
-export declare function clearLineByBorderType(ctx: UniverRenderingContext, type: BORDER_LTRB, position: IPosition): void;
+export declare function drawLineByBorderType(ctx: UniverRenderingContext, type: BORDER_TYPE, lineWidthBuffer: number, position: IPosition): void;
+export declare function drawDiagonalLineByBorderType(ctx: UniverRenderingContext, style: BorderStyleTypes, type: BORDER_TYPE, position: IPosition): void;
+export declare function clearLineByBorderType(ctx: UniverRenderingContext, type: BORDER_TYPE, position: IPosition): void;
 export declare function setLineType(ctx: UniverRenderingContext, style: BorderStyleTypes): void;
 export declare function getLineOffset(): number;
 export declare function getLineWith(width: number): number;

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

@@ -45,6 +45,8 @@ export declare enum DocumentSkeletonPageType {
     CELL = 3
 }
 export interface IDocumentSkeletonPage {
+    /** Stable id of the document section that owns this body page. */
+    sectionId?: string;
     sections: IDocumentSkeletonSection[];
     headerId: string;
     footerId: string;
@@ -233,6 +235,14 @@ export interface IDocumentSkeletonDrawing {
     lineTop: number;
     lineHeight: number;
     blockAnchorTop: number;
+    customBlockRenderViewport?: {
+        bleedLeft?: number;
+        bleedWidth?: number;
+        contentHeight?: number;
+        contentWidth?: number;
+        height?: number;
+        viewportHeight?: number;
+    };
 }
 export interface IDocumentSkeletonFontStyle {
     fontString: string;

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

@@ -15,6 +15,7 @@
  */
 export * from '../components/docs/layout/shaping-engine/font-cache';
 export * from './cell-data';
+export { cjk } from './cjk-regexp';
 export * from './const';
 export * from './document-node-tools';
 export * from './draw';
@@ -29,5 +30,6 @@ export * from './scroll-xy';
 export * from './text-rotation';
 export * from './tools';
 export * from './transform';
+export type { ITransformerConfig } from './transformer-config';
 export * from './vector2';
 export * from './zoom';

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

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 import type { BooleanNumber, GridType, IDocStyleBase, IDocumentLayout, IOffset, IParagraphStyle, IReferenceSource, IScale, ISectionBreakBase, ISize, ITextStyle, ITransformState, LocaleService } from '@univerjs/core';
-import type { DataStreamTreeNode } from '../components/docs/view-model/data-stream-tree-node';
 import type { IDocumentCompatibilityPolicy } from '../components/docs/document-compatibility';
+import type { DataStreamTreeNode } from '../components/docs/view-model/data-stream-tree-node';
 import type { DocumentViewModel } from '../components/docs/view-model/document-view-model';
 import type { DocumentSkeletonPageType, IDocumentSkeletonBullet, IDocumentSkeletonDrawing, IDocumentSkeletonDrawingAnchor, IDocumentSkeletonFontStyle, IDocumentSkeletonGlyph, IDocumentSkeletonHeaderFooter, IDocumentSkeletonTable } from './i-document-skeleton-cached';
 import type { ITransformerConfig } from './transformer-config';
@@ -77,6 +77,7 @@ export interface IFooterIds {
     firstPageFooterId?: string;
 }
 export interface ISectionBreakConfig extends IDocStyleBase, ISectionBreakBase, IDocsConfig {
+    sectionId: string;
     headerIds?: IHeaderIds;
     footerIds?: IFooterIds;
     useFirstPageHeaderFooter?: BooleanNumber;
@@ -96,6 +97,7 @@ export interface IParagraphConfig {
     docxFallbackAnchorLeft?: IParagraphStyle['indentStart'];
     paragraphNonInlineSkeDrawings?: Map<string, IDocumentSkeletonDrawing>;
     paragraphInlineSkeDrawings?: Map<string, IDocumentSkeletonDrawing>;
+    topBottomCustomBlockFlowBottom?: number;
     skeTablesInParagraph?: IParagraphTableCache[];
     bulletSkeleton?: IDocumentSkeletonBullet;
     paragraphStyle?: IParagraphStyle;

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

@@ -58,9 +58,6 @@ export declare function precisionTo(num: number, accurate: number): number;
  */
 export declare function fixLineWidthByScale(num: number, scale: number): number;
 export declare function getFontStyleString(textStyle?: Nullable<IStyleBase>): IDocumentSkeletonFontStyle;
-export declare function hasCJKText(text: string): boolean;
-export declare function hasCJK(text: string): boolean;
-export declare function hasCJKPunctuation(text: string): boolean;
 export declare function hasAllLatin(text: string): boolean;
 export declare function hasBasicLatin(text: string): boolean;
 export declare function hasLatinOneSupplement(text: string): boolean;

package/lib/types/components/docs/custom-block-render-viewport.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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 IDocsCustomBlockRenderViewportInput {
+    blockLeft?: number;
+    fallbackHeight: number;
+    fallbackWidth: number;
+    pageMarginLeft?: number;
+    pageMarginRight?: number;
+    pageWidth?: number;
+}
+export interface IDocsCustomBlockRenderViewport {
+    bleedLeft?: number;
+    bleedWidth?: number;
+    contentHeight?: number;
+    contentWidth?: number;
+    height: number;
+    layoutWidth?: number;
+    offsetLeft?: number;
+    viewportHeight?: number;
+    width: number;
+}
+export type DocsCustomBlockRenderViewportProvider = (unitId: string, blockId: string, input: IDocsCustomBlockRenderViewportInput) => IDocsCustomBlockRenderViewport | null | undefined;
+export declare function setDocsCustomBlockRenderViewportProvider(provider: DocsCustomBlockRenderViewportProvider | null): () => void;
+export declare function getDocsCustomBlockRenderViewport(unitId: string, blockId: string, input: IDocsCustomBlockRenderViewportInput): IDocsCustomBlockRenderViewport | null;

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

@@ -18,12 +18,14 @@ import type { IParagraphConfig, ISectionBreakConfig } from '../../../../../basic
 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 __avoidFlowAffectingDrawingsForTable(table: IDocumentSkeletonTable, page: IDocumentSkeletonPage, column: IDocumentSkeletonColumn): void;
 declare function _reLayoutCheck(ctx: ILayoutContext, floatObjects: IFloatObject[], column: IDocumentSkeletonColumn, paragraphIndex: number): void;
 export declare const __testing: {
     reLayoutCheck: typeof _reLayoutCheck;
     avoidFlowAffectingDrawingsForTable: typeof __avoidFlowAffectingDrawingsForTable;
+    isGlyphGroupBeyondDivideWidth: typeof isGlyphGroupBeyondDivideWidth;
 };
 export declare function getLineHeightMetrics(glyphLineHeight: number, paragraphLineGapDefault: number, linePitch: number, gridType: GridType, lineSpacing: number, spacingRule: SpacingRule, snapToGrid: BooleanNumber, useWordStyleLineHeight?: boolean, scaleAutoLineSpacingByGlyphHeight?: boolean): {
     paddingTop: number;
@@ -31,5 +33,5 @@ export declare function getLineHeightMetrics(glyphLineHeight: number, paragraphL
     contentHeight: number;
     lineSpacingApply: number;
 };
-export declare function updateInlineDrawingPosition(line: IDocumentSkeletonLine, paragraphInlineSkeDrawings?: Map<string, IDocumentSkeletonDrawing>, blockAnchorTop?: number, paragraphNonInlineSkeDrawings?: Map<string, IDocumentSkeletonDrawing>): void;
+export declare function updateInlineDrawingPosition(line: IDocumentSkeletonLine, paragraphInlineSkeDrawings?: Map<string, IDocumentSkeletonDrawing>, unitId?: string, blockAnchorTop?: number, paragraphNonInlineSkeDrawings?: Map<string, IDocumentSkeletonDrawing>): void;
 export {};

package/lib/types/components/docs/layout/doc-no-wrap-measure.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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 { IDocumentData } from '@univerjs/core';
+export declare function measureDocumentNoWrapTextRangeWidth(documentData: IDocumentData, start: number, end: number): number;
+/**
+ * Measures the widest no-wrap line using the same text-width policy that docs
+ * layout relies on for lightweight shape/text-box autofit flows.
+ *
+ * This is intentionally not a full document layout replacement: callers that
+ * need line breaking, pagination, floating objects, or final line metrics should
+ * use `DocumentSkeleton`. This helper exists for consumers that must size a
+ * no-wrap host before committing a full layout pass. Keep docs-specific glyph
+ * width adjustments here so feature packages do not duplicate paragraph shaping
+ * details such as CJK-Latin spacing.
+ */
+export declare function measureDocumentNoWrapTextWidth(documentData: IDocumentData | null | undefined): 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
+ * clipping an individual word, CJK glyph, or punctuation segment.
+ */
+export declare function measureDocumentUnbreakableTextWidth(documentData: IDocumentData | null | undefined): number;

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

@@ -170,6 +170,7 @@ export declare function getFontConfigFromLastGlyph(glyph: IDocumentSkeletonGlyph
     pageWidth: number;
 };
 export declare function getFontCreateConfig(index: number, viewModel: DocumentViewModel, paragraphNode: DataStreamTreeNode, sectionBreakConfig: ISectionBreakConfig, paragraph: IParagraph): IFontCreateConfig;
+export declare function getCustomRangeGlyphWidth(index: number, viewModel: DocumentViewModel, paragraphNode: DataStreamTreeNode, config: IFontCreateConfig): number | undefined;
 export declare function getNullSkeleton(): IDocumentSkeletonCached;
 export declare function setPageParent(pages: IDocumentSkeletonPage[], parent: IDocumentSkeletonCached): void;
 export declare enum FloatObjectType {

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

@@ -30,6 +30,8 @@ export interface IDrawInfo {
     viewRanges: IRange[];
     viewportKey: string;
     checkOutOfViewBound?: boolean;
+    fontRenderRanges?: IRange[];
+    hasMergeData?: boolean;
     viewBound?: IBoundRectNoAngle;
 }
 export declare class ComponentExtension<T, U, V> {

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

@@ -29,13 +29,14 @@ interface IRenderBGContext {
     viewRanges: IRange[];
     diffRanges: IRange[];
     cellInfo: ICellWithCoord;
+    skipRenderRangeCheck?: boolean;
 }
 export declare class Background extends SheetExtension {
     uKey: string;
     Z_INDEX: number;
     PRINTING_Z_INDEX: number;
     get zIndex(): number;
-    draw(ctx: UniverRenderingContext, _parentScale: IScale, spreadsheetSkeleton: SpreadsheetSkeleton, diffRanges: IRange[], { viewRanges, checkOutOfViewBound }: IDrawInfo): void;
+    draw(ctx: UniverRenderingContext, _parentScale: IScale, spreadsheetSkeleton: SpreadsheetSkeleton, diffRanges: IRange[], { viewRanges, checkOutOfViewBound, hasMergeData }: IDrawInfo): void;
     renderBGByCell(bgContext: IRenderBGContext, row: number, col: number): true | undefined;
 }
 export {};

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

@@ -63,7 +63,8 @@ export declare class Font extends SheetExtension {
      */
     private _drawFallbackImage;
     draw(ctx: UniverRenderingContext, parentScale: IScale, spreadsheetSkeleton: SpreadsheetSkeleton, diffRanges: IRange[], moreBoundsInfo: IDrawInfo): void;
-    _renderFontEachCell(renderFontCtx: IRenderFontContext, row: number, col: number, fontMatrix: ObjectMatrix<IFontCacheItem>): boolean;
+    _renderFontEachCell(renderFontCtx: IRenderFontContext, row: number, col: number, fontMatrix: ObjectMatrix<IFontCacheItem>, cacheValue?: IFontCacheItem): boolean;
+    private _renderPlainTextWithoutClip;
     private _renderImages;
     /**
      * Change font render bounds, for overflow and filter icon & custom render.

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

@@ -25,6 +25,11 @@ export declare enum SHEET_EXTENSION_TYPE {
 export declare const SHEET_EXTENSION_PREFIX = "sheet-ext-";
 export declare class SheetExtension extends ComponentExtension<SpreadsheetSkeleton, SHEET_EXTENSION_TYPE, IRange[]> {
     type: SHEET_EXTENSION_TYPE;
+    /**
+     * Return an isolated instance when this extension is safe to render in a print scene.
+     * Editor-only extensions remain excluded by default.
+     */
+    copyForPrinting(): SheetExtension | null;
     isRenderDiffRangesByCell(rangeP: IRange, diffRanges?: IRange[]): boolean;
     isRenderDiffRangesByColumn(curStartColumn: number, curEndColumn: number, diffRanges?: IRange[]): boolean;
     isRenderDiffRangesByRow(curStartRow: number, curEndRow: number, diffRanges?: IRange[]): boolean;

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

@@ -37,6 +37,9 @@ export interface IFontCacheItem {
     cellData: Nullable<ICellDataForSheetInterceptor>;
     fontString: string;
     style?: Nullable<IStyleData>;
+    displayText?: string;
+    resolvedHorizontalAlign?: HorizontalAlign;
+    textFitsCurrentCell?: boolean;
 }
 type colorString = string;
 export interface IStylesCache {

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

@@ -43,6 +43,13 @@ export interface ICacheItem {
     bg: boolean;
     border: boolean;
 }
+interface ISetStylesCacheForOneCellOptions {
+    mergeRange?: IRange;
+    cacheItem?: ICacheItem;
+    reuseExisting?: boolean;
+    hasMergeData?: boolean;
+    rowVisible?: boolean;
+}
 export interface IGetPosByRowColOptions {
     closeFirst?: boolean;
     /**
@@ -60,6 +67,7 @@ export declare class SpreadsheetSkeleton extends SheetSkeleton {
     private _cacheRangeMap;
     private _visibleRangeMap;
     private _overflowCache;
+    private _incrementalFontRenderRanges;
     private _stylesCache;
     private _clearTaskId;
     /** A matrix to store if a (row, column) position has render cache. */
@@ -84,6 +92,7 @@ export declare class SpreadsheetSkeleton extends SheetSkeleton {
     visibleRangeByViewportKey(viewportKey: SHEET_VIEWPORT_KEY): Nullable<IRowColumnRange>;
     get stylesCache(): IStylesCache;
     get overflowCache(): ObjectMatrix<IRange>;
+    get incrementalFontRenderRanges(): IRange[];
     get showGridlines(): BooleanNumber;
     get gridlinesColor(): string | undefined;
     dispose(): void;
@@ -144,6 +153,8 @@ export declare class SpreadsheetSkeleton extends SheetSkeleton {
     getRangeByViewBound(bound?: IBoundRectNoAngle): IRange;
     appendToOverflowCache(row: number, column: number, startColumn: number, endColumn: number): void;
     getOverflowPosition(contentSize: Required<ISize>, horizontalAlign: HorizontalAlign, row: number, column: number, columnCount: number): IColumnRange;
+    private _isOverflowBlockedByAdjacentCell;
+    private _isOverflowSideBlocked;
     /**
      * Get cell by pos(offsetX, offsetY).
      * @deprecated Please use `getCellWithCoordByOffset` instead.
@@ -240,15 +251,9 @@ export declare class SpreadsheetSkeleton extends SheetSkeleton {
      */
     _resetCache(): void;
     resetRangeCache(ranges: IRange[]): void;
-    _setBorderStylesCache(row: number, col: number, style: Nullable<IStyleData>, options: {
-        mergeRange?: IRange;
-        cacheItem?: ICacheItem;
-    } | undefined): void;
-    _setBgStylesCache(row: number, col: number, style: Nullable<IStyleData>, options: {
-        mergeRange?: IRange;
-        cacheItem?: ICacheItem;
-    } | undefined): void;
-    _setFontStylesCache(row: number, col: number, cellData: Nullable<ICellDataForSheetInterceptor>, style: IStyleData): void;
+    _setBorderStylesCache(row: number, col: number, style: Nullable<IStyleData>, options: ISetStylesCacheForOneCellOptions | undefined): void;
+    _setBgStylesCache(row: number, col: number, style: Nullable<IStyleData>, options: ISetStylesCacheForOneCellOptions | undefined): void;
+    _setFontStylesCache(row: number, col: number, cellData: Nullable<ICellDataForSheetInterceptor>, style: IStyleData, hasMergeData?: boolean): void;
     /**
      * Set border background and font to this._stylesCache cell by cell.
      * @param row {number}

package/lib/types/index.d.ts

@@ -18,11 +18,14 @@ export * from './basics';
 export { getOffsetRectForDom } from './basics/position';
 export * from './canvas';
 export * from './components';
+export type { DocsCustomBlockRenderViewportProvider, IDocsCustomBlockRenderViewport, IDocsCustomBlockRenderViewportInput } from './components/docs/custom-block-render-viewport';
+export { getDocsCustomBlockRenderViewport, setDocsCustomBlockRenderViewportProvider } from './components/docs/custom-block-render-viewport';
 export { DocBackground } from './components/docs/doc-background';
 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 * 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/render-manager/render-manager.service.d.ts

@@ -113,7 +113,7 @@ export declare class RenderManagerService extends Disposable implements IRenderM
      * @param isMainScene
      * @returns renderUnit:IRender
      */
-    protected _createRender(unitId: string, engine: Engine, isMainScene?: boolean, createUnitOptions?: ICreateUnitOptions): IRender;
+    protected _createRender(unitId: string, engine: Engine, isMainScene?: boolean, createUnitOptions?: ICreateUnitOptions, parentInjector?: Injector): IRender;
     addRender(unitId: string, renderUnit: IRender): void;
     private _addRenderUnit;
     removeRender(unitId: string): void;

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

@@ -39,6 +39,7 @@ export interface IRender {
      */
     activated$: Observable<boolean>;
     with<T>(dependency: DependencyIdentifier<T>): T;
+    getInjector?(): Injector;
     getRenderContext?(): IRenderContext;
     /**
      * Deactivate the render unit, means the render unit would be freezed and not updated,
@@ -77,6 +78,7 @@ export declare class RenderUnit extends Disposable implements IRender {
     get type(): UniverInstanceType;
     private readonly _injector;
     private _renderContext;
+    private readonly _dependencyService;
     set isMainScene(is: boolean);
     get isMainScene(): boolean;
     set engine(engine: Engine);
@@ -95,6 +97,7 @@ export declare class RenderUnit extends Disposable implements IRender {
      * Get a dependency from the RenderUnit's injector.
      */
     with<T>(dependency: DependencyIdentifier<T>): T;
+    getInjector(): Injector;
     /**
      * Add render dependencies to the RenderUnit's injector. Note that the dependencies would be initialized immediately
      * after being added.

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

@@ -68,6 +68,10 @@ export declare class ScrollBar extends Disposable {
     private _lastY;
     private _isHorizonMove;
     private _isVerticalMove;
+    private _pendingBarDeltaX;
+    private _pendingBarDeltaY;
+    private _pendingBarScrollFrameId;
+    private _pendingBarScrollThrottleId;
     private _horizonPointerMoveSub;
     private _horizonPointerUpSub;
     private _verticalPointerMoveSub;
@@ -132,6 +136,10 @@ export declare class ScrollBar extends Disposable {
     get totalSize(): number;
     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;
     private _resizeHorizontal;
     private _resizeVertical;

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

@@ -35,6 +35,8 @@ export interface ITextProps extends IShapeProps {
 }
 export declare const TEXT_OBJECT_ARRAY: string[];
 export declare class Text extends Shape<ITextProps> {
+    private static readonly _MAX_LAYOUT_CACHE_SIZE;
+    private static readonly _layoutCache;
     text: string;
     fontStyle: string;
     warp: boolean;
@@ -43,6 +45,8 @@ export declare class Text extends Shape<ITextProps> {
     skeleton: DocSimpleSkeleton;
     constructor(key: string, props: ITextProps);
     static drawWith(ctx: UniverRenderingContext, props: ITextProps, _skeleton?: DocSimpleSkeleton): number;
+    static drawPlainWith(ctx: UniverRenderingContext, props: ITextProps): number;
+    private static _getCachedLayout;
     /**
      * Draw text decoration lines (underline, strikethrough, etc.)
      */

package/lib/types/viewport.d.ts

@@ -72,6 +72,12 @@ export interface IScrollObserverParam {
     limitX?: number;
     limitY?: number;
     isTrigger?: boolean;
+    isBarDragging?: boolean;
+    isBarDragEnd?: boolean;
+}
+interface IScrollByBarOptions {
+    isBarDragging?: boolean;
+    isBarDragEnd?: boolean;
 }
 interface IScrollBarPosition {
     x: number;
@@ -284,7 +290,7 @@ export declare class Viewport {
      * @param delta
      * @returns isLimited
      */
-    scrollByBarDeltaValue(delta: Partial<IScrollBarPosition>, isTrigger?: boolean): {
+    scrollByBarDeltaValue(delta: Partial<IScrollBarPosition>, isTrigger?: boolean, options?: IScrollByBarOptions): {
         scrollX: number;
         scrollY: number;
         isLimitedX: boolean;