zrender-nightly 6.0.0-dev.20250718 → 6.0.0-dev.20250720

package/lib/graphic/TSpan.js

@@ -1,9 +1,9 @@
 import { __extends } from "tslib";
 import Displayable from './Displayable.js';
-import { getBoundingRect } from '../contain/text.js';
 import { DEFAULT_PATH_STYLE } from './Path.js';
 import { createObject, defaults } from '../core/util.js';
 import { DEFAULT_FONT } from '../core/platform.js';
+import { tSpanCreateBoundingRect, tSpanHasStroke } from './helper/parseText.js';
 export var DEFAULT_TSPAN_STYLE = defaults({
     strokeFirst: true,
     font: DEFAULT_FONT,
@@ -19,9 +19,7 @@ var TSpan = (function (_super) {
         return _super !== null && _super.apply(this, arguments) || this;
     }
     TSpan.prototype.hasStroke = function () {
-        var style = this.style;
-        var stroke = style.stroke;
-        return stroke != null && stroke !== 'none' && style.lineWidth > 0;
+        return tSpanHasStroke(this.style);
     };
     TSpan.prototype.hasFill = function () {
         var style = this.style;
@@ -35,21 +33,8 @@ var TSpan = (function (_super) {
         this._rect = rect;
     };
     TSpan.prototype.getBoundingRect = function () {
-        var style = this.style;
         if (!this._rect) {
-            var text = style.text;
-            text != null ? (text += '') : (text = '');
-            var rect = getBoundingRect(text, style.font, style.textAlign, style.textBaseline);
-            rect.x += style.x || 0;
-            rect.y += style.y || 0;
-            if (this.hasStroke()) {
-                var w = style.lineWidth;
-                rect.x -= w / 2;
-                rect.y -= w / 2;
-                rect.width += w;
-                rect.height += w;
-            }
-            this._rect = rect;
+            this._rect = tSpanCreateBoundingRect(this.style);
         }
         return this._rect;
     };

package/lib/graphic/Text.js

@@ -1,5 +1,5 @@
 import { __extends } from "tslib";
-import { parseRichText, parsePlainText, calcInnerTextOverflowArea } from './helper/parseText.js';
+import { parseRichText, parsePlainText, calcInnerTextOverflowArea, tSpanCreateBoundingRect2, } from './helper/parseText.js';
 import TSpan from './TSpan.js';
 import { retrieve2, each, normalizeCssArray, trim, retrieve3, extend, keys, defaults } from '../core/util.js';
 import { adjustTextX, adjustTextY } from '../contain/text.js';
@@ -200,7 +200,6 @@ var ZRText = (function (_super) {
         var bgColorDrawn = !!(style.backgroundColor);
         var outerHeight = contentBlock.outerHeight;
         var outerWidth = contentBlock.outerWidth;
-        var contentWidth = contentBlock.contentWidth;
         var textLines = contentBlock.lines;
         var lineHeight = contentBlock.lineHeight;
         this.isTruncated = !!contentBlock.isTruncated;
@@ -222,6 +221,7 @@ var ZRText = (function (_super) {
             }
         }
         var defaultLineWidth = 0;
+        var usingDefaultStroke = false;
         var useDefaultFill = false;
         var textFill = getFill('fill' in style
             ? style.fill
@@ -230,12 +230,9 @@ var ZRText = (function (_super) {
             ? style.stroke
             : (!bgColorDrawn
                 && (!defaultStyle.autoStroke || useDefaultFill))
-                ? (defaultLineWidth = DEFAULT_STROKE_LINE_WIDTH, defaultStyle.stroke)
+                ? (defaultLineWidth = DEFAULT_STROKE_LINE_WIDTH, usingDefaultStroke = true, defaultStyle.stroke)
                 : null);
         var hasShadow = style.textShadowBlur > 0;
-        var fixedBoundingRect = style.width != null
-            && (style.overflow === 'truncate' || style.overflow === 'break' || style.overflow === 'breakAll');
-        var calculatedLineHeight = contentBlock.calculatedLineHeight;
         for (var i = 0; i < textLines.length; i++) {
             var el = this._getOrCreateChild(TSpan);
             var subElStyle = el.createStyle();
@@ -265,9 +262,7 @@ var ZRText = (function (_super) {
             subElStyle.font = textFont;
             setSeparateFont(subElStyle, style);
             textY += lineHeight;
-            if (fixedBoundingRect) {
-                el.setBoundingRect(new BoundingRect(adjustTextX(subElStyle.x, contentWidth, subElStyle.textAlign), adjustTextY(subElStyle.y, calculatedLineHeight, subElStyle.textBaseline), contentWidth, calculatedLineHeight));
-            }
+            el.setBoundingRect(tSpanCreateBoundingRect2(subElStyle, contentBlock.contentWidth, contentBlock.calculatedLineHeight, usingDefaultStroke ? 0 : null));
         }
     };
     ZRText.prototype._updateRichTexts = function () {
@@ -364,6 +359,7 @@ var ZRText = (function (_super) {
         var defaultStyle = this._defaultStyle;
         var useDefaultFill = false;
         var defaultLineWidth = 0;
+        var usingDefaultStroke = false;
         var textFill = getFill('fill' in tokenStyle ? tokenStyle.fill
             : 'fill' in style ? style.fill
                 : (useDefaultFill = true, defaultStyle.fill));
@@ -371,7 +367,7 @@ var ZRText = (function (_super) {
             : 'stroke' in style ? style.stroke
                 : (!bgColorDrawn
                     && !parentBgColorDrawn
-                    && (!defaultStyle.autoStroke || useDefaultFill)) ? (defaultLineWidth = DEFAULT_STROKE_LINE_WIDTH, defaultStyle.stroke)
+                    && (!defaultStyle.autoStroke || useDefaultFill)) ? (defaultLineWidth = DEFAULT_STROKE_LINE_WIDTH, usingDefaultStroke = true, defaultStyle.stroke)
                     : null);
         var hasShadow = tokenStyle.textShadowBlur > 0
             || style.textShadowBlur > 0;
@@ -398,9 +394,7 @@ var ZRText = (function (_super) {
         if (textFill) {
             subElStyle.fill = textFill;
         }
-        var textWidth = token.contentWidth;
-        var textHeight = token.contentHeight;
-        el.setBoundingRect(new BoundingRect(adjustTextX(subElStyle.x, textWidth, subElStyle.textAlign), adjustTextY(subElStyle.y, textHeight, subElStyle.textBaseline), textWidth, textHeight));
+        el.setBoundingRect(tSpanCreateBoundingRect2(subElStyle, token.contentWidth, token.contentHeight, usingDefaultStroke ? 0 : null));
     };
     ZRText.prototype._renderBackground = function (style, topStyle, x, y, width, height) {
         var textBackgroundColor = style.backgroundColor;

package/lib/graphic/helper/parseText.d.ts

@@ -1,5 +1,7 @@
 import { TextAlign, TextVerticalAlign, NullUndefined } from '../../core/types';
-import { DefaultTextStyle, TextStyleProps } from '../Text';
+import type { DefaultTextStyle, TextStyleProps } from '../Text';
+import type { TSpanStyleProps } from '../TSpan';
+import BoundingRect from '../../core/BoundingRect';
 interface InnerTruncateOption {
     maxIteration?: number;
     minChar?: number;
@@ -19,7 +21,7 @@ export interface PlainTextContentBlock {
     lines: string[];
     isTruncated: boolean;
 }
-export declare function parsePlainText(text: string, style: Omit<TextStyleProps, 'align' | 'verticalAlign'>, defaultOuterWidth: number | NullUndefined, defaultOuterHeight: number | NullUndefined): PlainTextContentBlock;
+export declare function parsePlainText(rawText: unknown, style: Omit<TextStyleProps, 'align' | 'verticalAlign'>, defaultOuterWidth: number | NullUndefined, defaultOuterHeight: number | NullUndefined): PlainTextContentBlock;
 declare class RichTextToken {
     styleName: string;
     text: string;
@@ -52,7 +54,7 @@ export declare class RichTextContentBlock {
     lines: RichTextLine[];
     isTruncated: boolean;
 }
-export declare function parseRichText(text: string, style: Omit<TextStyleProps, 'align' | 'verticalAlign'>, defaultOuterWidth: number | NullUndefined, defaultOuterHeight: number | NullUndefined, topTextAlign: TextAlign): RichTextContentBlock;
+export declare function parseRichText(rawText: unknown, style: Omit<TextStyleProps, 'align' | 'verticalAlign'>, defaultOuterWidth: number | NullUndefined, defaultOuterHeight: number | NullUndefined, topTextAlign: TextAlign): RichTextContentBlock;
 export declare function calcInnerTextOverflowArea(out: CalcInnerTextOverflowAreaOut, overflowRect: DefaultTextStyle['overflowRect'], baseX: number, baseY: number, textAlign: TextAlign, textVerticalAlign: TextVerticalAlign): void;
 export declare type CalcInnerTextOverflowAreaOut = {
     baseX: number;
@@ -60,4 +62,7 @@ export declare type CalcInnerTextOverflowAreaOut = {
     outerWidth: number | NullUndefined;
     outerHeight: number | NullUndefined;
 };
+export declare function tSpanCreateBoundingRect(style: Pick<TSpanStyleProps, 'text' | 'font' | 'x' | 'y' | 'textAlign' | 'textBaseline' | 'lineWidth'>): BoundingRect;
+export declare function tSpanCreateBoundingRect2(style: Pick<TSpanStyleProps, 'x' | 'y' | 'textAlign' | 'textBaseline' | 'lineWidth'>, contentWidth: number, contentHeight: number, forceLineWidth: number | NullUndefined): BoundingRect;
+export declare function tSpanHasStroke(style: TSpanStyleProps): boolean;
 export {};

package/lib/graphic/helper/parseText.js

@@ -93,8 +93,8 @@ function estimateLength(text, contentWidth, fontMeasureInfo) {
     }
     return i;
 }
-export function parsePlainText(text, style, defaultOuterWidth, defaultOuterHeight) {
-    text != null && (text += '');
+export function parsePlainText(rawText, style, defaultOuterWidth, defaultOuterHeight) {
+    var text = formatText(rawText);
     var overflow = style.overflow;
     var padding = style.padding;
     var paddingH = padding ? padding[1] + padding[3] : 0;
@@ -195,9 +195,9 @@ var RichTextContentBlock = (function () {
     return RichTextContentBlock;
 }());
 export { RichTextContentBlock };
-export function parseRichText(text, style, defaultOuterWidth, defaultOuterHeight, topTextAlign) {
+export function parseRichText(rawText, style, defaultOuterWidth, defaultOuterHeight, topTextAlign) {
     var contentBlock = new RichTextContentBlock();
-    text != null && (text += '');
+    var text = formatText(rawText);
     if (!text) {
         return contentBlock;
     }
@@ -523,3 +523,30 @@ export function calcInnerTextOverflowArea(out, overflowRect, baseX, baseY, textA
 }
 var tmpCITCTextRect = new BoundingRect(0, 0, 0, 0);
 var tmpCITCIntersectRectOpt = { outIntersectRect: {}, clamp: true };
+function formatText(text) {
+    return text != null ? (text += '') : (text = '');
+}
+export function tSpanCreateBoundingRect(style) {
+    var text = formatText(style.text);
+    var font = style.font;
+    var contentWidth = measureWidth(ensureFontMeasureInfo(font), text);
+    var contentHeight = getLineHeight(font);
+    return tSpanCreateBoundingRect2(style, contentWidth, contentHeight, null);
+}
+export function tSpanCreateBoundingRect2(style, contentWidth, contentHeight, forceLineWidth) {
+    var rect = new BoundingRect(adjustTextX(style.x || 0, contentWidth, style.textAlign), adjustTextY(style.y || 0, contentHeight, style.textBaseline), contentWidth, contentHeight);
+    var lineWidth = forceLineWidth != null
+        ? forceLineWidth
+        : (tSpanHasStroke(style) ? style.lineWidth : 0);
+    if (lineWidth > 0) {
+        rect.x -= lineWidth / 2;
+        rect.y -= lineWidth / 2;
+        rect.width += lineWidth;
+        rect.height += lineWidth;
+    }
+    return rect;
+}
+export function tSpanHasStroke(style) {
+    var stroke = style.stroke;
+    return stroke != null && stroke !== 'none' && style.lineWidth > 0;
+}

package/lib/zrender.d.ts

@@ -90,7 +90,7 @@ export declare type ElementSSRData = zrUtil.HashMap<unknown>;
 export declare type ElementSSRDataGetter<T> = (el: Element) => zrUtil.HashMap<T>;
 export declare function getElementSSRData(el: Element): ElementSSRData;
 export declare function registerSSRDataGetter<T>(getter: ElementSSRDataGetter<T>): void;
-export declare const version = "6.0.0-dev.20250718";
+export declare const version = "6.0.0-dev.20250720";
 export interface ZRenderType extends ZRender {
 }
 export {};

package/lib/zrender.js

@@ -324,5 +324,5 @@ export function getElementSSRData(el) {
 export function registerSSRDataGetter(getter) {
     ssrDataGetter = getter;
 }
-export var version = '6.0.0-dev.20250718';
+export var version = '6.0.0-dev.20250720';
 ;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zrender-nightly",
-  "version": "6.0.0-dev.20250718",
+  "version": "6.0.0-dev.20250720",
   "description": "A lightweight graphic library providing 2d draw for Apache ECharts",
   "keywords": [
     "canvas",

package/src/contain/text.ts

@@ -106,7 +106,7 @@ export function measureWidth(fontMeasureInfo: FontMeasureInfo, text: string): nu
 
 
 /**
- *
+ * @deprecated See `getBoundingRect`.
  * Get bounding rect for inner usage(TSpan)
  * Which not include text newline.
  */
@@ -128,6 +128,9 @@ export function innerGetBoundingRect(
 }
 
 /**
+ * @deprecated Use `(new Text(...)).getBoundingRect()` or `(new TSpan(...)).getBoundingRect()` instead.
+ *  This method behaves differently from `Text#getBoundingRect()` - e.g., it does not support the overflow
+ *  strategy, and only has single line height even if multiple lines.
  *
  * Get bounding rect for outer usage. Compatitable with old implementation
  * Which includes text newline.

package/src/graphic/TSpan.ts

@@ -1,10 +1,10 @@
 import Displayable, { DisplayableProps, DisplayableStatePropNames } from './Displayable';
-import { getBoundingRect } from '../contain/text';
 import BoundingRect from '../core/BoundingRect';
 import { PathStyleProps, DEFAULT_PATH_STYLE } from './Path';
 import { createObject, defaults } from '../core/util';
-import { FontStyle, FontWeight, TextAlign, TextVerticalAlign } from '../core/types';
+import { FontStyle, FontWeight } from '../core/types';
 import { DEFAULT_FONT } from '../core/platform';
+import { tSpanCreateBoundingRect, tSpanHasStroke } from './helper/parseText';
 
 export interface TSpanStyleProps extends PathStyleProps {
 
@@ -53,9 +53,7 @@ class TSpan extends Displayable<TSpanProps> {
     style: TSpanStyleProps
 
     hasStroke() {
-        const style = this.style;
-        const stroke = style.stroke;
-        return stroke != null && stroke !== 'none' && style.lineWidth > 0;
+        return tSpanHasStroke(this.style);
     }
 
     hasFill() {
@@ -81,31 +79,8 @@ class TSpan extends Displayable<TSpanProps> {
     }
 
     getBoundingRect(): BoundingRect {
-        const style = this.style;
-
         if (!this._rect) {
-            let text = style.text;
-            text != null ? (text += '') : (text = '');
-
-            const rect = getBoundingRect(
-                text,
-                style.font,
-                style.textAlign as TextAlign,
-                style.textBaseline as TextVerticalAlign
-            );
-
-            rect.x += style.x || 0;
-            rect.y += style.y || 0;
-
-            if (this.hasStroke()) {
-                const w = style.lineWidth;
-                rect.x -= w / 2;
-                rect.y -= w / 2;
-                rect.width += w;
-                rect.height += w;
-            }
-
-            this._rect = rect;
+            this._rect = tSpanCreateBoundingRect(this.style);
         }
 
         return this._rect;

package/src/graphic/Text.ts

@@ -6,7 +6,8 @@ import {
     TextAlign, TextVerticalAlign, ImageLike, Dictionary, MapToType, FontWeight, FontStyle, NullUndefined
 } from '../core/types';
 import {
-    parseRichText, parsePlainText, CalcInnerTextOverflowAreaOut, calcInnerTextOverflowArea
+    parseRichText, parsePlainText, CalcInnerTextOverflowAreaOut, calcInnerTextOverflowArea,
+    tSpanCreateBoundingRect2,
 } from './helper/parseText';
 import TSpan, { TSpanStyleProps } from './TSpan';
 import { retrieve2, each, normalizeCssArray, trim, retrieve3, extend, keys, defaults } from '../core/util';
@@ -332,7 +333,7 @@ class ZRText extends Displayable<TextProps> implements GroupLike {
         }
     }
 
-     updateTransform() {
+    updateTransform() {
         const innerTransformable = this.innerTransformable;
         if (innerTransformable) {
             innerTransformable.updateTransform();
@@ -528,7 +529,6 @@ class ZRText extends Displayable<TextProps> implements GroupLike {
 
         const outerHeight = contentBlock.outerHeight;
         const outerWidth = contentBlock.outerWidth;
-        const contentWidth = contentBlock.contentWidth;
 
         const textLines = contentBlock.lines;
         const lineHeight = contentBlock.lineHeight;
@@ -544,6 +544,13 @@ class ZRText extends Displayable<TextProps> implements GroupLike {
             const boxY = adjustTextY(baseY, outerHeight, verticalAlign);
             needDrawBg && this._renderBackground(style, style, boxX, boxY, outerWidth, outerHeight);
         }
+        // PENDING:
+        //  Should text bounding rect contains style.padding, style.width, style.height when NO background
+        //  and border displayed? It depends on how to define "boundingRect". HTML `getBoundingClientRect`
+        //  contains padding in that case. But currently ZRText does not.
+        //  If implement that, an extra invisible Rect may need to be added as the placeholder for the bounding
+        //  rect computation, considering animation of padding. But will it degrade performance for the most
+        //  used plain texts cases?
 
         // `textBaseline` is set as 'middle'.
         textY += lineHeight / 2;
@@ -559,6 +566,7 @@ class ZRText extends Displayable<TextProps> implements GroupLike {
         }
 
         let defaultLineWidth = 0;
+        let usingDefaultStroke = false;
         let useDefaultFill = false;
         const textFill = getFill(
             'fill' in style
@@ -580,16 +588,12 @@ class ZRText extends Displayable<TextProps> implements GroupLike {
                     // we give the auto lineWidth to display the given stoke color.
                     && (!defaultStyle.autoStroke || useDefaultFill)
                 )
-                ? (defaultLineWidth = DEFAULT_STROKE_LINE_WIDTH, defaultStyle.stroke)
+                ? (defaultLineWidth = DEFAULT_STROKE_LINE_WIDTH, usingDefaultStroke = true, defaultStyle.stroke)
                 : null
         );
 
         const hasShadow = style.textShadowBlur > 0;
 
-        const fixedBoundingRect = style.width != null
-            && (style.overflow === 'truncate' || style.overflow === 'break' || style.overflow === 'breakAll');
-        const calculatedLineHeight = contentBlock.calculatedLineHeight;
-
         for (let i = 0; i < textLines.length; i++) {
             const el = this._getOrCreateChild(TSpan);
             // Always create new style.
@@ -633,19 +637,27 @@ class ZRText extends Displayable<TextProps> implements GroupLike {
 
             textY += lineHeight;
 
-            if (fixedBoundingRect) {
-                el.setBoundingRect(new BoundingRect(
-                    adjustTextX(subElStyle.x, contentWidth, subElStyle.textAlign as TextAlign),
-                    adjustTextY(subElStyle.y, calculatedLineHeight, subElStyle.textBaseline as TextVerticalAlign),
-                    /**
-                     * Text boundary should be the real text width.
-                     * Otherwise, there will be extra space in the
-                     * bounding rect calculated.
-                     */
-                    contentWidth,
-                    calculatedLineHeight
-                ));
-            }
+            // Always set tspan bounding rect to guarantee the consistency if users lays out based
+            // on these bounding rects.
+            el.setBoundingRect(tSpanCreateBoundingRect2(
+                subElStyle,
+                contentBlock.contentWidth,
+                contentBlock.calculatedLineHeight,
+                // Should text bounding rect includes text stroke width?
+                // Pros:
+                //   - Intuitively, and by convention, bounding rect of `Path` always includes stroke width.
+                // Cons:
+                //   - It's unpredictable for users whether "auto stroke" is applied. If stroke width is included
+                //     and multiple texts are laid out based on its bounding rect, the position of texts may vary
+                //     and is unpredictable - especially in limited space (e.g., see echarts pie label cases).
+                //   - "auto stroke" attempts to use the same color as the background to make the border to be
+                //     invisible in most cases, thus it might be more reasonable to be excluded from bounding rect.
+                // Conclusion:
+                //   - If users specifies style.stroke, it will be included into the bounding rect as normal.
+                //     Otherwise, keep the stroke width as `0` in this case to guarantee consistency of bounding
+                //     rect based layout, regardless of whether "auto stroke" is applied.
+                usingDefaultStroke ? 0 : null
+            ));
         }
     }
 
@@ -801,6 +813,7 @@ class ZRText extends Displayable<TextProps> implements GroupLike {
         const defaultStyle = this._defaultStyle;
         let useDefaultFill = false;
         let defaultLineWidth = 0;
+        let usingDefaultStroke = false;
         const textFill = getFill(
             'fill' in tokenStyle ? tokenStyle.fill
                 : 'fill' in style ? style.fill
@@ -812,9 +825,9 @@ class ZRText extends Displayable<TextProps> implements GroupLike {
                 : (
                     !bgColorDrawn
                     && !parentBgColorDrawn
-                    // See the strategy explained above.
+                    // See the strategy explained `_updatePlainTexts`.
                     && (!defaultStyle.autoStroke || useDefaultFill)
-                ) ? (defaultLineWidth = DEFAULT_STROKE_LINE_WIDTH, defaultStyle.stroke)
+                ) ? (defaultLineWidth = DEFAULT_STROKE_LINE_WIDTH, usingDefaultStroke = true, defaultStyle.stroke)
                 : null
         );
 
@@ -852,14 +865,13 @@ class ZRText extends Displayable<TextProps> implements GroupLike {
             subElStyle.fill = textFill;
         }
 
-        const textWidth = token.contentWidth;
-        const textHeight = token.contentHeight;
         // NOTE: Should not call dirtyStyle after setBoundingRect. Or it will be cleared.
-        el.setBoundingRect(new BoundingRect(
-            adjustTextX(subElStyle.x, textWidth, subElStyle.textAlign as TextAlign),
-            adjustTextY(subElStyle.y, textHeight, subElStyle.textBaseline as TextVerticalAlign),
-            textWidth,
-            textHeight
+        el.setBoundingRect(tSpanCreateBoundingRect2(
+            subElStyle,
+            token.contentWidth,
+            token.contentHeight,
+            // See the strategy explained `_updatePlainTexts`.
+            usingDefaultStroke ? 0 : null
         ));
     }
 

package/src/graphic/helper/parseText.ts

@@ -6,7 +6,8 @@ import {
     reduce,
 } from '../../core/util';
 import { TextAlign, TextVerticalAlign, ImageLike, Dictionary, NullUndefined } from '../../core/types';
-import { DefaultTextStyle, TextStyleProps } from '../Text';
+import type { DefaultTextStyle, TextStyleProps } from '../Text';
+import type { TSpanStyleProps } from '../TSpan';
 import {
     adjustTextX,
     adjustTextY,
@@ -210,12 +211,12 @@ export interface PlainTextContentBlock {
 }
 
 export function parsePlainText(
-    text: string,
+    rawText: unknown,
     style: Omit<TextStyleProps, 'align' | 'verticalAlign'>, // Exclude props in DefaultTextStyle
     defaultOuterWidth: number | NullUndefined,
     defaultOuterHeight: number | NullUndefined
 ): PlainTextContentBlock {
-    text != null && (text += '');
+    const text = formatText(rawText);
 
     // textPadding has been normalized
     const overflow = style.overflow;
@@ -382,7 +383,7 @@ type WrapInfo = {
  * If styleName is undefined, it is plain text.
  */
 export function parseRichText(
-    text: string,
+    rawText: unknown,
     style: Omit<TextStyleProps, 'align' | 'verticalAlign'>, // Exclude props in DefaultTextStyle
     defaultOuterWidth: number | NullUndefined,
     defaultOuterHeight: number | NullUndefined,
@@ -390,7 +391,7 @@ export function parseRichText(
 ): RichTextContentBlock {
     const contentBlock = new RichTextContentBlock();
 
-    text != null && (text += '');
+    const text = formatText(rawText);
     if (!text) {
         return contentBlock;
     }
@@ -890,3 +891,61 @@ export type CalcInnerTextOverflowAreaOut = {
     outerHeight: number | NullUndefined
 };
 
+// For backward compatibility, and possibly loose type.
+function formatText(text: unknown): string {
+    return text != null ? (text += '') : (text = '');
+}
+
+export function tSpanCreateBoundingRect(
+    style: Pick<TSpanStyleProps, 'text' | 'font' | 'x' | 'y' | 'textAlign' | 'textBaseline' | 'lineWidth'>,
+): BoundingRect {
+    // Should follow the same way as `parsePlainText` to guarantee the consistency of the result.
+    const text = formatText(style.text);
+    const font = style.font;
+    const contentWidth = measureWidth(ensureFontMeasureInfo(font), text);
+    const contentHeight = getLineHeight(font);
+
+    return tSpanCreateBoundingRect2(
+        style,
+        contentWidth,
+        contentHeight,
+        null
+    );
+}
+
+export function tSpanCreateBoundingRect2(
+    style: Pick<TSpanStyleProps, 'x' | 'y' | 'textAlign' | 'textBaseline' | 'lineWidth'>,
+    contentWidth: number,
+    contentHeight: number,
+    forceLineWidth: number | NullUndefined,
+): BoundingRect {
+    const rect = new BoundingRect(
+        adjustTextX(style.x || 0, contentWidth, style.textAlign as TextAlign),
+        adjustTextY(style.y || 0, contentHeight, style.textBaseline as TextVerticalAlign),
+        /**
+         * Text boundary should be the real text width.
+         * Otherwise, there will be extra space in the
+         * bounding rect calculated.
+         */
+        contentWidth,
+        contentHeight
+    );
+
+    const lineWidth = forceLineWidth != null
+        ? forceLineWidth
+        : (tSpanHasStroke(style) ? style.lineWidth : 0);
+    if (lineWidth > 0) {
+        rect.x -= lineWidth / 2;
+        rect.y -= lineWidth / 2;
+        rect.width += lineWidth;
+        rect.height += lineWidth;
+    }
+
+    return rect;
+}
+
+export function tSpanHasStroke(style: TSpanStyleProps): boolean {
+    const stroke = style.stroke;
+    return stroke != null && stroke !== 'none' && style.lineWidth > 0;
+}
+

package/src/zrender.ts

@@ -556,7 +556,7 @@ export function registerSSRDataGetter<T>(getter: ElementSSRDataGetter<T>) {
 /**
  * @type {string}
  */
-export const version = '6.0.0-dev.20250718';
+export const version = '6.0.0-dev.20250720';
 
 
 export interface ZRenderType extends ZRender {};