@nasser-sw/fabric 7.0.1-beta10 → 7.0.1-beta11

package/dist/index.js

@@ -360,7 +360,7 @@
   }
   const cache = new Cache();
 
-  var version = "7.0.1-beta9";
+  var version = "7.0.1-beta10";
 
   // use this syntax so babel plugin see this import here
   const VERSION = version;
@@ -19189,8 +19189,8 @@
   // Global measurement context - reused for performance
   let measurementContext = null;
 
-  /**
-   * Get or create the shared measurement context
+  /**
+   * Get or create the shared measurement context
    */
   function getMeasurementContext() {
     if (!measurementContext) {
@@ -19203,8 +19203,8 @@
     return measurementContext;
   }
 
-  /**
-   * Measure a single grapheme
+  /**
+   * Measure a single grapheme
    */
   function measureGrapheme(grapheme, options, ctx) {
     // Check cache first
@@ -19237,8 +19237,8 @@
     return measurement;
   }
 
-  /**
-   * Measure a grapheme with kerning relative to previous character
+  /**
+   * Measure a grapheme with kerning relative to previous character
    */
   function measureGraphemeWithKerning(grapheme, previousGrapheme, options, ctx) {
     // Get individual measurement
@@ -19279,9 +19279,9 @@
     };
   }
 
-  /**
-   * Get a representative character for font metrics measurement
-   * Uses canvas to test which scripts the font actually supports
+  /**
+   * Get a representative character for font metrics measurement
+   * Uses canvas to test which scripts the font actually supports
    */
   function getRepresentativeCharacter(fontFamily) {
     const context = getMeasurementContext();
@@ -19370,8 +19370,8 @@
     return 'M';
   }
 
-  /**
-   * Get font metrics for layout calculations
+  /**
+   * Get font metrics for layout calculations
    */
   function getFontMetrics(options) {
     var _metrics$fontBounding, _metrics$fontBounding2, _metrics$actualBoundi, _metrics$actualBoundi2;
@@ -19407,8 +19407,8 @@
     return result;
   }
 
-  /**
-   * Apply font styling to canvas context
+  /**
+   * Apply font styling to canvas context
    */
   function applyFontStyle(ctx, options) {
     const fontDeclaration = getFontDeclaration(options);
@@ -19425,8 +19425,8 @@
     ctx.textBaseline = 'alphabetic';
   }
 
-  /**
-   * Generate font declaration string
+  /**
+   * Generate font declaration string
    */
   function getFontDeclaration(options) {
     const {
@@ -19445,8 +19445,8 @@
     return `${fontStyle} ${fontWeight} ${fontSize}px ${normalizedFamily}`;
   }
 
-  /**
-   * LRU Cache implementation for measurements
+  /**
+   * LRU Cache implementation for measurements
    */
   class LRUCache {
     constructor() {
@@ -19508,8 +19508,8 @@
     }
   }
 
-  /**
-   * Advanced measurement cache with font-aware keys
+  /**
+   * Advanced measurement cache with font-aware keys
    */
   class MeasurementCache {
     constructor() {
@@ -19536,8 +19536,8 @@
     }
   }
 
-  /**
-   * Kerning cache for character pairs
+  /**
+   * Kerning cache for character pairs
    */
   class KerningCache {
     constructor() {
@@ -19565,8 +19565,8 @@
     }
   }
 
-  /**
-   * Font metrics cache
+  /**
+   * Font metrics cache
    */
   class FontMetricsCache {
     constructor() {
@@ -19601,8 +19601,8 @@
     });
   }
 
-  /**
-   * Clear all measurement caches
+  /**
+   * Clear all measurement caches
    */
   function clearAllCaches() {
     measurementCache.clear();
@@ -19610,9 +19610,9 @@
     fontMetricsCache.clear();
   }
 
-  /**
-   * Detect if a font lacks English glyph support
-   * These fonts should use browser-native measurement instead of Fabric's character-by-character measurement
+  /**
+   * Detect if a font lacks English glyph support
+   * These fonts should use browser-native measurement instead of Fabric's character-by-character measurement
    */
   function fontLacksEnglishGlyphs(fontFamily) {
     if (typeof document === 'undefined') return false;
@@ -19656,8 +19656,8 @@
   // Cache for font glyph detection results
   const fontGlyphCache = new Map();
 
-  /**
-   * Cached version of font glyph detection
+  /**
+   * Cached version of font glyph detection
    */
   function fontLacksEnglishGlyphsCached(fontFamily) {
     if (fontGlyphCache.has(fontFamily)) {
@@ -19668,17 +19668,17 @@
     return result;
   }
 
-  /**
-   * Unicode and Internationalization Support
-   * 
-   * Enhanced Unicode handling for complex scripts, RTL/LTR text,
-   * and grapheme cluster boundary detection.
+  /**
+   * Unicode and Internationalization Support
+   * 
+   * Enhanced Unicode handling for complex scripts, RTL/LTR text,
+   * and grapheme cluster boundary detection.
    */
 
 
-  /**
-   * Enhanced grapheme segmentation using Intl.Segmenter when available
-   * with fallback to existing graphemeSplit implementation
+  /**
+   * Enhanced grapheme segmentation using Intl.Segmenter when available
+   * with fallback to existing graphemeSplit implementation
    */
   function segmentGraphemes(text) {
     // Use native Intl.Segmenter if available
@@ -19698,15 +19698,15 @@
     return graphemeSplit(text);
   }
 
-  /**
-   * Ellipsis Text Truncation System
-   * 
-   * Implements text truncation with ellipsis when content exceeds bounds,
-   * using binary search for optimal truncation points.
+  /**
+   * Ellipsis Text Truncation System
+   * 
+   * Implements text truncation with ellipsis when content exceeds bounds,
+   * using binary search for optimal truncation points.
    */
 
-  /**
-   * Apply ellipsis truncation to text based on width/height constraints
+  /**
+   * Apply ellipsis truncation to text based on width/height constraints
    */
   function applyEllipsis(text, options) {
     const {
@@ -19776,8 +19776,8 @@
     };
   }
 
-  /**
-   * Truncate text based on width constraint using binary search
+  /**
+   * Truncate text based on width constraint using binary search
    */
   function truncateByWidth(text, maxWidth, ellipsisChar, ellipsisWidth, measureFn) {
     const graphemes = segmentGraphemes(text);
@@ -19827,8 +19827,8 @@
     };
   }
 
-  /**
-   * Truncate text based on height constraint
+  /**
+   * Truncate text based on height constraint
    */
   function truncateByHeight(text, maxHeight, ellipsisChar, measureFn) {
     var _measureFn;
@@ -19876,19 +19876,19 @@
     return truncateByWidth(lines[0], firstLineWidth, ellipsisChar, 0, measureFn);
   }
 
-  /**
-   * Core Text Layout Engine
-   * 
-   * Implements Konva-compatible text layout with support for:
-   * - Multiple wrap modes (word/char/none)
-   * - Ellipsis truncation
-   * - Justify alignment with proper space distribution
-   * - RTL/LTR text direction
-   * - Advanced grapheme handling
+  /**
+   * Core Text Layout Engine
+   * 
+   * Implements Konva-compatible text layout with support for:
+   * - Multiple wrap modes (word/char/none)
+   * - Ellipsis truncation
+   * - Justify alignment with proper space distribution
+   * - RTL/LTR text direction
+   * - Advanced grapheme handling
    */
 
-  /**
-   * Main text layout function - converts text and options into positioned layout
+  /**
+   * Main text layout function - converts text and options into positioned layout
    */
   function layoutText(options) {
     var _ellipsisResult;
@@ -20007,8 +20007,8 @@
     };
   }
 
-  /**
-   * Layout a single paragraph with wrapping
+  /**
+   * Layout a single paragraph with wrapping
    */
   function layoutParagraph(text, options) {
     const {
@@ -20043,8 +20043,8 @@
     return layoutLines;
   }
 
-  /**
-   * Layout a single line of text (no wrapping)
+  /**
+   * Layout a single line of text (no wrapping)
    */
   function layoutSingleLine(text, options) {
     let textOffset = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
@@ -20114,8 +20114,8 @@
     };
   }
 
-  /**
-   * Word-based wrapping algorithm
+  /**
+   * Word-based wrapping algorithm
    */
   function wrapByWords(text, maxWidth, options) {
     const lines = [];
@@ -20148,8 +20148,8 @@
     return lines.length > 0 ? lines : [''];
   }
 
-  /**
-   * Character-based wrapping algorithm  
+  /**
+   * Character-based wrapping algorithm  
    */
   function wrapByCharacters(text, maxWidth, options) {
     const lines = [];
@@ -20171,8 +20171,8 @@
     return lines.length > 0 ? lines : [''];
   }
 
-  /**
-   * Apply text alignment to lines
+  /**
+   * Apply text alignment to lines
    */
   function applyAlignment(lines, align, containerWidth, options) {
     return lines.map(line => {
@@ -20206,8 +20206,8 @@
     });
   }
 
-  /**
-   * Apply justify alignment by expanding spaces
+  /**
+   * Apply justify alignment by expanding spaces
    */
   function applyJustification(line, containerWidth, options) {
     const spaces = line.graphemes.filter(g => /\s/.test(g)).length;
@@ -20230,8 +20230,8 @@
     return line;
   }
 
-  /**
-   * Calculate vertical alignment offset
+  /**
+   * Calculate vertical alignment offset
    */
   function calculateVerticalOffset(contentHeight, containerHeight, align) {
     switch (align) {
@@ -20245,8 +20245,8 @@
     }
   }
 
-  /**
-   * Handle height overflow with ellipsis
+  /**
+   * Handle height overflow with ellipsis
    */
   function handleHeightOverflow(existingLines, overflowLine, remainingHeight, options) {
     // If ellipsis is enabled, try to fit part of the overflow line
@@ -20275,8 +20275,8 @@
     };
   }
 
-  /**
-   * Create empty line for empty paragraphs
+  /**
+   * Create empty line for empty paragraphs
    */
   function createEmptyLine(options) {
     const height = options.fontSize * options.lineHeight;
@@ -20292,8 +20292,8 @@
     };
   }
 
-  /**
-   * Measure width of a line of text
+  /**
+   * Measure width of a line of text
    */
   function measureLineWidth(text, options) {
     const graphemes = segmentGraphemes(text);
@@ -20310,8 +20310,8 @@
     return width;
   }
 
-  /**
-   * Convert layout options to measurement options
+  /**
+   * Convert layout options to measurement options
    */
   function createMeasurementOptions(options) {
     return {
@@ -20554,15 +20554,15 @@
     }
   }
 
-  /**
-   * Browser Line Break Extraction
-   * 
-   * Captures exact line breaks as rendered by the browser to ensure
-   * pixel-perfect consistency between DOM editing and canvas rendering.
+  /**
+   * Browser Line Break Extraction
+   * 
+   * Captures exact line breaks as rendered by the browser to ensure
+   * pixel-perfect consistency between DOM editing and canvas rendering.
    */
 
-  /**
-   * Segment text into graphemes safely using Intl.Segmenter or fallback
+  /**
+   * Segment text into graphemes safely using Intl.Segmenter or fallback
    */
   function segmentIntoGraphemes(text) {
     if (typeof Intl !== 'undefined' && Intl.Segmenter) {
@@ -20576,9 +20576,9 @@
     return Array.from(text);
   }
 
-  /**
-   * Extract line break information from a textarea by creating a mirror element
-   * with identical computed styles and measuring grapheme positions.
+  /**
+   * Extract line break information from a textarea by creating a mirror element
+   * with identical computed styles and measuring grapheme positions.
    */
   function extractLinesFromDOM(textarea) {
     const text = textarea.value;
@@ -20673,16 +20673,16 @@
     }
   }
 
-  /**
-   * Create a hash of layout-affecting properties to detect when browser lines are still valid
+  /**
+   * Create a hash of layout-affecting properties to detect when browser lines are still valid
    */
   function createLayoutHash(target) {
     const properties = [target.text, target.width, target.height, target.fontFamily, target.fontSize, target.fontWeight, target.fontStyle, target.lineHeight, target.charSpacing, target.textAlign, target.direction];
     return properties.map(p => String(p)).join('|');
   }
 
-  /**
-   * Check if stored browser lines are still valid for the current target state
+  /**
+   * Check if stored browser lines are still valid for the current target state
    */
   function areBrowserLinesValid(target, storedHash) {
     if (!storedHash || !target.__lastBrowserLines) {
@@ -20692,24 +20692,24 @@
     return currentHash === storedHash;
   }
 
-  /**
-   * Store browser lines on a target object with validity hash
+  /**
+   * Store browser lines on a target object with validity hash
    */
   function storeBrowserLines(target, lines, layoutHash) {
     target.__lastBrowserLines = lines;
     target.__lastBrowserLinesHash = createLayoutHash(target);
   }
 
-  /**
-   * Clear stored browser lines from a target object
+  /**
+   * Clear stored browser lines from a target object
    */
   function clearBrowserLines(target) {
     delete target.__lastBrowserLines;
     delete target.__lastBrowserLinesHash;
   }
 
-  /**
-   * Get stored browser lines if they're still valid
+  /**
+   * Get stored browser lines if they're still valid
    */
   function getBrowserLines(target) {
     const lines = target.__lastBrowserLines;
@@ -20722,9 +20722,9 @@
 
   let measuringContext;
 
-  /**
-   * Return a context for measurement of text string.
-   * if created it gets stored for reuse
+  /**
+   * Return a context for measurement of text string.
+   * if created it gets stored for reuse
    */
   function getMeasuringContext() {
     if (!measuringContext) {
@@ -20737,17 +20737,17 @@
     return measuringContext;
   }
 
-  /**
-   * Measure and return the info of a single grapheme.
-   * needs the the info of previous graphemes already filled
-   * Override to customize measuring
+  /**
+   * Measure and return the info of a single grapheme.
+   * needs the the info of previous graphemes already filled
+   * Override to customize measuring
    */
 
   // @TODO this is not complete
 
-  /**
-   * Text class
-   * @see {@link http://fabricjs.com/fabric-intro-part-2#text}
+  /**
+   * Text class
+   * @see {@link http://fabricjs.com/fabric-intro-part-2#text}
    */
   class FabricText extends StyledText {
     static getDefaults() {
@@ -20758,11 +20758,11 @@
     }
     constructor(text, options) {
       super();
-      /**
-       * contains characters bounding boxes
-       * This variable is considered to be protected.
-       * But for how mixins are implemented right now, we can't leave it private
-       * @protected
+      /**
+       * contains characters bounding boxes
+       * This variable is considered to be protected.
+       * But for how mixins are implemented right now, we can't leave it private
+       * @protected
        */
       _defineProperty(this, "__charBounds", []);
       Object.assign(this, FabricText.ownDefaults);
@@ -20779,9 +20779,9 @@
       this.setCoords();
     }
 
-    /**
-     * If text has a path, it will add the extra information needed
-     * for path and text calculations
+    /**
+     * If text has a path, it will add the extra information needed
+     * for path and text calculations
      */
     setPathInfo() {
       const path = this.path;
@@ -20790,10 +20790,10 @@
       }
     }
 
-    /**
-     * @private
-     * Divides text into lines of text and lines of graphemes.
-     * Uses browser lines when available for pixel-perfect consistency.
+    /**
+     * @private
+     * Divides text into lines of text and lines of graphemes.
+     * Uses browser lines when available for pixel-perfect consistency.
      */
     _splitText() {
       // Check if we have valid browser lines and should use them
@@ -20809,9 +20809,9 @@
       return newLines;
     }
 
-    /**
-     * Create TextLinesInfo from browser-extracted lines
-     * @private
+    /**
+     * Create TextLinesInfo from browser-extracted lines
+     * @private
      */
     _splitTextFromBrowserLines(browserLines) {
       const lines = [];
@@ -20845,10 +20845,10 @@
       return result;
     }
 
-    /**
-     * Initialize or update text dimensions.
-     * Updates this.width and this.height with the proper values.
-     * Does not return dimensions.
+    /**
+     * Initialize or update text dimensions.
+     * Updates this.width and this.height with the proper values.
+     * Does not return dimensions.
      */
     initDimensions() {
       // Check if font is ready for accurate measurements
@@ -20894,8 +20894,8 @@
       }
     }
 
-    /**
-     * Enlarge space boxes and shift the others
+    /**
+     * Enlarge space boxes and shift the others
      */
     enlargeSpaces() {
       let diffSpace, currentLineWidth, numberOfSpaces, accumulatedSpace, line, charBound, spaces;
@@ -20957,18 +20957,18 @@
       }
     }
 
-    /**
-     * Advanced layout using new text engine (Konva-compatible)
-     * @private
+    /**
+     * Advanced layout using new text engine (Konva-compatible)
+     * @private
      */
     _layoutTextAdvanced() {
       const options = this._getAdvancedLayoutOptions();
       return layoutText(options);
     }
 
-    /**
-     * Get advanced layout options from current text properties
-     * @private
+    /**
+     * Get advanced layout options from current text properties
+     * @private
      */
     _getAdvancedLayoutOptions() {
       return {
@@ -20990,9 +20990,9 @@
       };
     }
 
-    /**
-     * Map Fabric textAlign to Konva align format
-     * @private
+    /**
+     * Map Fabric textAlign to Konva align format
+     * @private
      */
     _mapTextAlignToAlign(textAlign) {
       switch (textAlign) {
@@ -21013,8 +21013,8 @@
       }
     }
 
-    /**
-     * Enhanced initDimensions that uses advanced layout when enabled
+    /**
+     * Enhanced initDimensions that uses advanced layout when enabled
      */
     initDimensionsAdvanced() {
       if (!this.enableAdvancedLayout) {
@@ -21043,9 +21043,9 @@
       this.dirty = true;
     }
 
-    /**
-     * Convert new layout format to legacy _textLines and __charBounds format
-     * @private
+    /**
+     * Convert new layout format to legacy _textLines and __charBounds format
+     * @private
      */
     _convertLayoutToLegacyFormat(layout) {
       this._textLines = layout.lines.map(line => line.graphemes);
@@ -21067,30 +21067,30 @@
       }
     }
 
-    /**
-     * Detect if the text line is ended with an hard break
-     * text and itext do not have wrapping, return false
-     * @return {Boolean}
+    /**
+     * Detect if the text line is ended with an hard break
+     * text and itext do not have wrapping, return false
+     * @return {Boolean}
      */
     isEndOfWrapping(lineIndex) {
       return lineIndex === this._textLines.length - 1;
     }
 
-    /**
-     * Detect if a line has a linebreak and so we need to account for it when moving
-     * and counting style.
-     * It return always 1 for text and Itext. Textbox has its own implementation
-     * @return Number
+    /**
+     * Detect if a line has a linebreak and so we need to account for it when moving
+     * and counting style.
+     * It return always 1 for text and Itext. Textbox has its own implementation
+     * @return Number
      */
 
     missingNewlineOffset(_lineIndex) {
       return 1;
     }
 
-    /**
-     * Returns 2d representation (lineIndex and charIndex) of cursor
-     * @param {Number} selectionStart
-     * @param {Boolean} [skipWrapping] consider the location for unwrapped lines. useful to manage styles.
+    /**
+     * Returns 2d representation (lineIndex and charIndex) of cursor
+     * @param {Number} selectionStart
+     * @param {Boolean} [skipWrapping] consider the location for unwrapped lines. useful to manage styles.
      */
     get2DCursorLocation(selectionStart, skipWrapping) {
       const lines = skipWrapping ? this._unwrappedTextLines : this._textLines;
@@ -21110,24 +21110,24 @@
       };
     }
 
-    /**
-     * Returns string representation of an instance
-     * @return {String} String representation of text object
+    /**
+     * Returns string representation of an instance
+     * @return {String} String representation of text object
      */
     toString() {
       return `#<Text (${this.complexity()}): { "text": "${this.text}", "fontFamily": "${this.fontFamily}" }>`;
     }
 
-    /**
-     * Return the dimension and the zoom level needed to create a cache canvas
-     * big enough to host the object to be cached.
-     * @private
-     * @param {Object} dim.x width of object to be cached
-     * @param {Object} dim.y height of object to be cached
-     * @return {Object}.width width of canvas
-     * @return {Object}.height height of canvas
-     * @return {Object}.zoomX zoomX zoom value to unscale the canvas before drawing cache
-     * @return {Object}.zoomY zoomY zoom value to unscale the canvas before drawing cache
+    /**
+     * Return the dimension and the zoom level needed to create a cache canvas
+     * big enough to host the object to be cached.
+     * @private
+     * @param {Object} dim.x width of object to be cached
+     * @param {Object} dim.y height of object to be cached
+     * @return {Object}.width width of canvas
+     * @return {Object}.height height of canvas
+     * @return {Object}.zoomX zoomX zoom value to unscale the canvas before drawing cache
+     * @return {Object}.zoomY zoomY zoom value to unscale the canvas before drawing cache
      */
     _getCacheCanvasDimensions() {
       const dims = super._getCacheCanvasDimensions();
@@ -21137,9 +21137,9 @@
       return dims;
     }
 
-    /**
-     * @private
-     * @param {CanvasRenderingContext2D} ctx Context to render on
+    /**
+     * @private
+     * @param {CanvasRenderingContext2D} ctx Context to render on
      */
     _render(ctx) {
       const path = this.path;
@@ -21152,9 +21152,9 @@
       this._renderTextDecoration(ctx, 'linethrough');
     }
 
-    /**
-     * @private
-     * @param {CanvasRenderingContext2D} ctx Context to render on
+    /**
+     * @private
+     * @param {CanvasRenderingContext2D} ctx Context to render on
      */
     _renderText(ctx) {
       // Skip text rendering if in overlay editing mode
@@ -21170,15 +21170,15 @@
       }
     }
 
-    /**
-     * Set the font parameter of the context with the object properties or with charStyle
-     * @private
-     * @param {CanvasRenderingContext2D} ctx Context to render on
-     * @param {Object} [charStyle] object with font style properties
-     * @param {String} [charStyle.fontFamily] Font Family
-     * @param {Number} [charStyle.fontSize] Font size in pixels. ( without px suffix )
-     * @param {String} [charStyle.fontWeight] Font weight
-     * @param {String} [charStyle.fontStyle] Font style (italic|normal)
+    /**
+     * Set the font parameter of the context with the object properties or with charStyle
+     * @private
+     * @param {CanvasRenderingContext2D} ctx Context to render on
+     * @param {Object} [charStyle] object with font style properties
+     * @param {String} [charStyle.fontFamily] Font Family
+     * @param {Number} [charStyle.fontSize] Font size in pixels. ( without px suffix )
+     * @param {String} [charStyle.fontWeight] Font weight
+     * @param {String} [charStyle.fontStyle] Font style (italic|normal)
      */
     _setTextStyles(ctx, charStyle, forMeasuring) {
       ctx.textBaseline = 'alphabetic';
@@ -21198,11 +21198,11 @@
       ctx.font = this._getFontDeclaration(charStyle, forMeasuring);
     }
 
-    /**
-     * calculate and return the text Width measuring each line.
-     * @private
-     * @param {CanvasRenderingContext2D} ctx Context to render on
-     * @return {Number} Maximum width of Text object
+    /**
+     * calculate and return the text Width measuring each line.
+     * @private
+     * @param {CanvasRenderingContext2D} ctx Context to render on
+     * @return {Number} Maximum width of Text object
      */
     calcTextWidth() {
       let maxWidth = this.getLineWidth(0);
@@ -21215,23 +21215,23 @@
       return maxWidth;
     }
 
-    /**
-     * @private
-     * @param {String} method Method name ("fillText" or "strokeText")
-     * @param {CanvasRenderingContext2D} ctx Context to render on
-     * @param {String} line Text to render
-     * @param {Number} left Left position of text
-     * @param {Number} top Top position of text
-     * @param {Number} lineIndex Index of a line in a text
+    /**
+     * @private
+     * @param {String} method Method name ("fillText" or "strokeText")
+     * @param {CanvasRenderingContext2D} ctx Context to render on
+     * @param {String} line Text to render
+     * @param {Number} left Left position of text
+     * @param {Number} top Top position of text
+     * @param {Number} lineIndex Index of a line in a text
      */
     _renderTextLine(method, ctx, line, left, top, lineIndex) {
       this._renderChars(method, ctx, line, left, top, lineIndex);
     }
 
-    /**
-     * Renders the text background for lines, taking care of style
-     * @private
-     * @param {CanvasRenderingContext2D} ctx Context to render on
+    /**
+     * Renders the text background for lines, taking care of style
+     * @private
+     * @param {CanvasRenderingContext2D} ctx Context to render on
      */
     _renderTextLinesBackground(ctx) {
       if (!this.textBackgroundColor && !this.styleHas('textBackgroundColor')) {
@@ -21294,15 +21294,15 @@
       this._removeShadow(ctx);
     }
 
-    /**
-     * measure and return the width of a single character.
-     * possibly overridden to accommodate different measure logic or
-     * to hook some external lib for character measurement
-     * @private
-     * @param {String} _char, char to be measured
-     * @param {Object} charStyle style of char to be measured
-     * @param {String} [previousChar] previous char
-     * @param {Object} [prevCharStyle] style of previous char
+    /**
+     * measure and return the width of a single character.
+     * possibly overridden to accommodate different measure logic or
+     * to hook some external lib for character measurement
+     * @private
+     * @param {String} _char, char to be measured
+     * @param {Object} charStyle style of char to be measured
+     * @param {String} [previousChar] previous char
+     * @param {Object} [prevCharStyle] style of previous char
      */
     _measureChar(_char, charStyle, previousChar, prevCharStyle) {
       const fontCache = cache.getFontCache(charStyle),
@@ -21347,19 +21347,19 @@
       };
     }
 
-    /**
-     * Computes height of character at given position
-     * @param {Number} line the line index number
-     * @param {Number} _char the character index number
-     * @return {Number} fontSize of the character
+    /**
+     * Computes height of character at given position
+     * @param {Number} line the line index number
+     * @param {Number} _char the character index number
+     * @return {Number} fontSize of the character
      */
     getHeightOfChar(line, _char) {
       return this.getValueOfPropertyAt(line, _char, 'fontSize');
     }
 
-    /**
-     * measure a text line measuring all characters.
-     * @param {Number} lineIndex line number
+    /**
+     * measure a text line measuring all characters.
+     * @param {Number} lineIndex line number
      */
     measureLine(lineIndex) {
       const lineInfo = this._measureLine(lineIndex);
@@ -21372,11 +21372,11 @@
       return lineInfo;
     }
 
-    /**
-     * measure every grapheme of a line, populating __charBounds
-     * @param {Number} lineIndex
-     * @return {Object} object.width total width of characters
-     * @return {Object} object.numOfSpaces length of chars that match this._reSpacesAndTabs
+    /**
+     * measure every grapheme of a line, populating __charBounds
+     * @param {Number} lineIndex
+     * @return {Object} object.width total width of characters
+     * @return {Object} object.numOfSpaces length of chars that match this._reSpacesAndTabs
      */
     _measureLine(lineIndex) {
       let width = 0,
@@ -21439,13 +21439,13 @@
       };
     }
 
-    /**
-     * Calculate the angle  and the left,top position of the char that follow a path.
-     * It appends it to graphemeInfo to be reused later at rendering
-     * @private
-     * @param {Number} positionInPath to be measured
-     * @param {GraphemeBBox} graphemeInfo current grapheme box information
-     * @param {Object} startingPoint position of the point
+    /**
+     * Calculate the angle  and the left,top position of the char that follow a path.
+     * It appends it to graphemeInfo to be reused later at rendering
+     * @private
+     * @param {Number} positionInPath to be measured
+     * @param {GraphemeBBox} graphemeInfo current grapheme box information
+     * @param {Object} startingPoint position of the point
      */
     _setGraphemeOnPath(positionInPath, graphemeInfo) {
       const centerPosition = positionInPath + graphemeInfo.kernedWidth / 2,
@@ -21458,13 +21458,13 @@
       graphemeInfo.angle = info.angle + (this.pathSide === RIGHT ? Math.PI : 0);
     }
 
-    /**
-     *
-     * @param {String} grapheme to be measured
-     * @param {Number} lineIndex index of the line where the char is
-     * @param {Number} charIndex position in the line
-     * @param {String} [prevGrapheme] character preceding the one to be measured
-     * @returns {GraphemeBBox} grapheme bbox
+    /**
+     *
+     * @param {String} grapheme to be measured
+     * @param {Number} lineIndex index of the line where the char is
+     * @param {Number} charIndex position in the line
+     * @param {String} [prevGrapheme] character preceding the one to be measured
+     * @returns {GraphemeBBox} grapheme bbox
      */
     _getGraphemeBox(grapheme, lineIndex, charIndex, prevGrapheme, skipLeft) {
       const style = this.getCompleteStyleDeclaration(lineIndex, charIndex),
@@ -21492,10 +21492,10 @@
       return box;
     }
 
-    /**
-     * Calculate height of line at 'lineIndex'
-     * @param {Number} lineIndex index of line to calculate
-     * @return {Number}
+    /**
+     * Calculate height of line at 'lineIndex'
+     * @param {Number} lineIndex index of line to calculate
+     * @return {Number}
      */
     getHeightOfLine(lineIndex) {
       if (this.__lineHeights[lineIndex]) {
@@ -21511,8 +21511,8 @@
       return this.__lineHeights[lineIndex] = maxHeight * this.lineHeight * this._fontSizeMult;
     }
 
-    /**
-     * Calculate text box height
+    /**
+     * Calculate text box height
      */
     calcTextHeight() {
       let lineHeight,
@@ -21524,26 +21524,26 @@
       return height;
     }
 
-    /**
-     * @private
-     * @return {Number} Left offset
+    /**
+     * @private
+     * @return {Number} Left offset
      */
     _getLeftOffset() {
       return this.direction === 'ltr' ? -this.width / 2 : this.width / 2;
     }
 
-    /**
-     * @private
-     * @return {Number} Top offset
+    /**
+     * @private
+     * @return {Number} Top offset
      */
     _getTopOffset() {
       return -this.height / 2;
     }
 
-    /**
-     * @private
-     * @param {CanvasRenderingContext2D} ctx Context to render on
-     * @param {String} method Method name ("fillText" or "strokeText")
+    /**
+     * @private
+     * @param {CanvasRenderingContext2D} ctx Context to render on
+     * @param {String} method Method name ("fillText" or "strokeText")
      */
     _renderTextCommon(ctx, method) {
       ctx.save();
@@ -21560,9 +21560,9 @@
       ctx.restore();
     }
 
-    /**
-     * @private
-     * @param {CanvasRenderingContext2D} ctx Context to render on
+    /**
+     * @private
+     * @param {CanvasRenderingContext2D} ctx Context to render on
      */
     _renderTextFill(ctx) {
       if (!this.fill && !this.styleHas(FILL)) {
@@ -21571,9 +21571,9 @@
       this._renderTextCommon(ctx, 'fillText');
     }
 
-    /**
-     * @private
-     * @param {CanvasRenderingContext2D} ctx Context to render on
+    /**
+     * @private
+     * @param {CanvasRenderingContext2D} ctx Context to render on
      */
     _renderTextStroke(ctx) {
       if ((!this.stroke || this.strokeWidth === 0) && this.isEmptyStyles()) {
@@ -21590,14 +21590,14 @@
       ctx.restore();
     }
 
-    /**
-     * @private
-     * @param {String} method fillText or strokeText.
-     * @param {CanvasRenderingContext2D} ctx Context to render on
-     * @param {Array} line Content of the line, splitted in an array by grapheme
-     * @param {Number} left
-     * @param {Number} top
-     * @param {Number} lineIndex
+    /**
+     * @private
+     * @param {String} method fillText or strokeText.
+     * @param {CanvasRenderingContext2D} ctx Context to render on
+     * @param {Array} line Content of the line, splitted in an array by grapheme
+     * @param {Number} left
+     * @param {Number} top
+     * @param {Number} lineIndex
      */
     _renderChars(method, ctx, line, left, top, lineIndex) {
       const lineHeight = this.getHeightOfLine(lineIndex),
@@ -21679,16 +21679,16 @@
       ctx.restore();
     }
 
-    /**
-     * This function try to patch the missing gradientTransform on canvas gradients.
-     * transforming a context to transform the gradient, is going to transform the stroke too.
-     * we want to transform the gradient but not the stroke operation, so we create
-     * a transformed gradient on a pattern and then we use the pattern instead of the gradient.
-     * this method has drawbacks: is slow, is in low resolution, needs a patch for when the size
-     * is limited.
-     * @private
-     * @param {TFiller} filler a fabric gradient instance
-     * @return {CanvasPattern} a pattern to use as fill/stroke style
+    /**
+     * This function try to patch the missing gradientTransform on canvas gradients.
+     * transforming a context to transform the gradient, is going to transform the stroke too.
+     * we want to transform the gradient but not the stroke operation, so we create
+     * a transformed gradient on a pattern and then we use the pattern instead of the gradient.
+     * this method has drawbacks: is slow, is in low resolution, needs a patch for when the size
+     * is limited.
+     * @private
+     * @param {TFiller} filler a fabric gradient instance
+     * @return {CanvasPattern} a pattern to use as fill/stroke style
      */
     _applyPatternGradientTransformText(filler) {
       // TODO: verify compatibility with strokeUniform
@@ -21744,12 +21744,12 @@
       };
     }
 
-    /**
-     * This function prepare the canvas for a stroke style, and stroke and strokeWidth
-     * need to be sent in as defined
-     * @param {CanvasRenderingContext2D} ctx
-     * @param {CompleteTextStyleDeclaration} style with stroke and strokeWidth defined
-     * @returns
+    /**
+     * This function prepare the canvas for a stroke style, and stroke and strokeWidth
+     * need to be sent in as defined
+     * @param {CanvasRenderingContext2D} ctx
+     * @param {CompleteTextStyleDeclaration} style with stroke and strokeWidth defined
+     * @returns
      */
     _setStrokeStyles(ctx, _ref) {
       let {
@@ -21764,12 +21764,12 @@
       return this.handleFiller(ctx, 'strokeStyle', stroke);
     }
 
-    /**
-     * This function prepare the canvas for a ill style, and fill
-     * need to be sent in as defined
-     * @param {CanvasRenderingContext2D} ctx
-     * @param {CompleteTextStyleDeclaration} style with ill defined
-     * @returns
+    /**
+     * This function prepare the canvas for a ill style, and fill
+     * need to be sent in as defined
+     * @param {CanvasRenderingContext2D} ctx
+     * @param {CompleteTextStyleDeclaration} style with ill defined
+     * @returns
      */
     _setFillStyles(ctx, _ref2) {
       let {
@@ -21778,16 +21778,16 @@
       return this.handleFiller(ctx, 'fillStyle', fill);
     }
 
-    /**
-     * @private
-     * @param {String} method
-     * @param {CanvasRenderingContext2D} ctx Context to render on
-     * @param {Number} lineIndex
-     * @param {Number} charIndex
-     * @param {String} _char
-     * @param {Number} left Left coordinate
-     * @param {Number} top Top coordinate
-     * @param {Number} lineHeight Height of the line
+    /**
+     * @private
+     * @param {String} method
+     * @param {CanvasRenderingContext2D} ctx Context to render on
+     * @param {Number} lineIndex
+     * @param {Number} charIndex
+     * @param {String} _char
+     * @param {Number} left Left coordinate
+     * @param {Number} top Top coordinate
+     * @param {Number} lineHeight Height of the line
      */
     _renderChar(method, ctx, lineIndex, charIndex, _char, left, top) {
       const decl = this._getStyleDeclaration(lineIndex, charIndex),
@@ -21816,30 +21816,30 @@
       ctx.restore();
     }
 
-    /**
-     * Turns the character into a 'superior figure' (i.e. 'superscript')
-     * @param {Number} start selection start
-     * @param {Number} end selection end
+    /**
+     * Turns the character into a 'superior figure' (i.e. 'superscript')
+     * @param {Number} start selection start
+     * @param {Number} end selection end
      */
     setSuperscript(start, end) {
       this._setScript(start, end, this.superscript);
     }
 
-    /**
-     * Turns the character into an 'inferior figure' (i.e. 'subscript')
-     * @param {Number} start selection start
-     * @param {Number} end selection end
+    /**
+     * Turns the character into an 'inferior figure' (i.e. 'subscript')
+     * @param {Number} start selection start
+     * @param {Number} end selection end
      */
     setSubscript(start, end) {
       this._setScript(start, end, this.subscript);
     }
 
-    /**
-     * Applies 'schema' at given position
-     * @private
-     * @param {Number} start selection start
-     * @param {Number} end selection end
-     * @param {Number} schema
+    /**
+     * Applies 'schema' at given position
+     * @private
+     * @param {Number} start selection start
+     * @param {Number} end selection end
+     * @param {Number} schema
      */
     _setScript(start, end, schema) {
       const loc = this.get2DCursorLocation(start, true),
@@ -21852,10 +21852,10 @@
       this.setSelectionStyles(style, start, end);
     }
 
-    /**
-     * @private
-     * @param {Number} lineIndex index text line
-     * @return {Number} Line left offset
+    /**
+     * @private
+     * @param {Number} lineIndex index text line
+     * @return {Number} Line left offset
      */
     _getLineLeftOffset(lineIndex) {
       const lineWidth = this.getLineWidth(lineIndex),
@@ -21905,8 +21905,8 @@
       return leftOffset;
     }
 
-    /**
-     * @private
+    /**
+     * @private
      */
     _clearCache() {
       this._forceClearCache = false;
@@ -21915,12 +21915,12 @@
       this.__charBounds = [];
     }
 
-    /**
-     * Measure a single line given its index. Used to calculate the initial
-     * text bounding box. The values are calculated and stored in __lineWidths cache.
-     * @private
-     * @param {Number} lineIndex line number
-     * @return {Number} Line width
+    /**
+     * Measure a single line given its index. Used to calculate the initial
+     * text bounding box. The values are calculated and stored in __lineWidths cache.
+     * @private
+     * @param {Number} lineIndex line number
+     * @return {Number} Line width
      */
     getLineWidth(lineIndex) {
       if (this.__lineWidths[lineIndex] !== undefined) {
@@ -21939,12 +21939,12 @@
       return 0;
     }
 
-    /**
-     * Retrieves the value of property at given character position
-     * @param {Number} lineIndex the line number
-     * @param {Number} charIndex the character number
-     * @param {String} property the property name
-     * @returns the value of 'property'
+    /**
+     * Retrieves the value of property at given character position
+     * @param {Number} lineIndex the line number
+     * @param {Number} charIndex the character number
+     * @param {String} property the property name
+     * @returns the value of 'property'
      */
     getValueOfPropertyAt(lineIndex, charIndex, property) {
       var _charStyle$property;
@@ -21952,9 +21952,9 @@
       return (_charStyle$property = charStyle[property]) !== null && _charStyle$property !== void 0 ? _charStyle$property : this[property];
     }
 
-    /**
-     * @private
-     * @param {CanvasRenderingContext2D} ctx Context to render on
+    /**
+     * @private
+     * @param {CanvasRenderingContext2D} ctx Context to render on
      */
     _renderTextDecoration(ctx, type) {
       if (!this[type] && !this.styleHas(type)) {
@@ -22038,10 +22038,10 @@
       this._removeShadow(ctx);
     }
 
-    /**
-     * return font declaration string for canvas context
-     * @param {Object} [styleObject] object
-     * @returns {String} font declaration formatted for canvas context.
+    /**
+     * return font declaration string for canvas context
+     * @param {Object} [styleObject] object
+     * @returns {String} font declaration formatted for canvas context.
      */
     _getFontDeclaration() {
       let {
@@ -22067,9 +22067,9 @@
       return [fontStyle, fontWeight, `${forMeasuring ? this.CACHE_FONT_SIZE : fontSize}px`, parsedFontFamily].join(' ');
     }
 
-    /**
-     * Renders text instance on a specified context
-     * @param {CanvasRenderingContext2D} ctx Context to render on
+    /**
+     * Renders text instance on a specified context
+     * @param {CanvasRenderingContext2D} ctx Context to render on
      */
     render(ctx) {
       if (!this.visible) {
@@ -22084,22 +22084,22 @@
       super.render(ctx);
     }
 
-    /**
-     * Override this method to customize grapheme splitting
-     * @todo the util `graphemeSplit` needs to be injectable in some way.
-     * is more comfortable to inject the correct util rather than having to override text
-     * in the middle of the prototype chain
-     * @param {string} value
-     * @returns {string[]} array of graphemes
+    /**
+     * Override this method to customize grapheme splitting
+     * @todo the util `graphemeSplit` needs to be injectable in some way.
+     * is more comfortable to inject the correct util rather than having to override text
+     * in the middle of the prototype chain
+     * @param {string} value
+     * @returns {string[]} array of graphemes
      */
     graphemeSplit(value) {
       return graphemeSplit(value);
     }
 
-    /**
-     * Returns the text as an array of lines.
-     * @param {String} text text to split
-     * @returns  Lines in the text
+    /**
+     * Returns the text as an array of lines.
+     * @param {String} text text to split
+     * @returns  Lines in the text
      */
     _splitTextIntoLines(text) {
       const lines = text.split(this._reNewline),
@@ -22125,18 +22125,18 @@
       };
     }
 
-    /**
-     * Check if text contains Arabic characters
-     * @private
+    /**
+     * Check if text contains Arabic characters
+     * @private
      */
     _containsArabicText(text) {
       return /[\u0600-\u06FF\u0750-\u077F\uFB50-\uFDFF\uFE70-\uFEFF]/.test(text);
     }
 
-    /**
-     * Returns object representation of an instance
-     * @param {Array} [propertiesToInclude] Any properties that you might want to additionally include in the output
-     * @return {Object} Object representation of an instance
+    /**
+     * Returns object representation of an instance
+     * @param {Array} [propertiesToInclude] Any properties that you might want to additionally include in the output
+     * @return {Object} Object representation of an instance
      */
     toObject() {
       let propertiesToInclude = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
@@ -22179,23 +22179,23 @@
       return this;
     }
 
-    /**
-     * Returns complexity of an instance
-     * @return {Number} complexity
+    /**
+     * Returns complexity of an instance
+     * @return {Number} complexity
      */
     complexity() {
       return 1;
     }
 
-    /**
-     * List of generic font families
-     * @see https://developer.mozilla.org/en-US/docs/Web/CSS/font-family#generic-name
+    /**
+     * List of generic font families
+     * @see https://developer.mozilla.org/en-US/docs/Web/CSS/font-family#generic-name
      */
 
-    /**
-     * Returns FabricText instance from an SVG element (<b>not yet implemented</b>)
-     * @param {HTMLElement} element Element to parse
-     * @param {Object} [options] Options object
+    /**
+     * Returns FabricText instance from an SVG element (<b>not yet implemented</b>)
+     * @param {HTMLElement} element Element to parse
+     * @param {Object} [options] Options object
      */
     static async fromElement(element, options, cssRules) {
       const parsedAttributes = parseAttributes(element, FabricText.ATTRIBUTE_NAMES, cssRules);
@@ -22234,10 +22234,10 @@
         scaledDiff = lineHeightDiff * textHeightScaleFactor,
         textHeight = text.getScaledHeight() + scaledDiff;
       let offX = 0;
-      /*
-        Adjust positioning:
-          x/y attributes in SVG correspond to the bottom-left corner of text bounding box
-          fabric output by default at top, left.
+      /*
+        Adjust positioning:
+          x/y attributes in SVG correspond to the bottom-left corner of text bounding box
+          fabric output by default at top, left.
       */
       if (textAnchor === CENTER) {
         offX = text.getScaledWidth() / 2;
@@ -22255,9 +22255,9 @@
 
     /* _FROM_SVG_END_ */
 
-    /**
-     * Check if the font is ready for accurate measurements
-     * @private
+    /**
+     * Check if the font is ready for accurate measurements
+     * @private
      */
     _isFontReady() {
       if (typeof document === 'undefined' || !('fonts' in document)) {
@@ -22270,9 +22270,9 @@
       }
     }
 
-    /**
-     * Schedule re-initialization after font loads
-     * @private
+    /**
+     * Schedule re-initialization after font loads
+     * @private
      */
     _scheduleInitAfterFontLoad() {
       if (typeof document === 'undefined' || !('fonts' in document)) {
@@ -22308,8 +22308,8 @@
       });
     }
 
-    /**
-     * Force complete text re-initialization (useful after JSON loading)
+    /**
+     * Force complete text re-initialization (useful after JSON loading)
      */
     forceTextReinitialization() {
       console.log('🔄 Force reinitializing text object');
@@ -22337,10 +22337,10 @@
       }
     }
 
-    /**
-     * Returns FabricText instance from an object representation
-     * @param {Object} object plain js Object to create an instance from
-     * @returns {Promise<FabricText>}
+    /**
+     * Returns FabricText instance from an object representation
+     * @param {Object} object plain js Object to create an instance from
+     * @returns {Promise<FabricText>}
      */
     static fromObject(object) {
       return this._fromObject({
@@ -22438,10 +22438,10 @@
       });
     }
   }
-  /**
-   * Properties that requires a text layout recalculation when changed
-   * @type string[]
-   * @protected
+  /**
+   * Properties that requires a text layout recalculation when changed
+   * @type string[]
+   * @protected
    */
   _defineProperty(FabricText, "textLayoutProperties", textLayoutProperties);
   _defineProperty(FabricText, "cacheProperties", [...cacheProperties, ...additionalProps]);
@@ -22449,9 +22449,9 @@
   _defineProperty(FabricText, "type", 'Text');
   _defineProperty(FabricText, "genericFonts", ['serif', 'sans-serif', 'monospace', 'cursive', 'fantasy', 'system-ui', 'ui-serif', 'ui-sans-serif', 'ui-monospace', 'ui-rounded', 'math', 'emoji', 'fangsong']);
   /* _FROM_SVG_START_ */
-  /**
-   * List of attribute names to account for when parsing SVG element (used by {@link FabricText.fromElement})
-   * @see: http://www.w3.org/TR/SVG/text.html#TextElement
+  /**
+   * List of attribute names to account for when parsing SVG element (used by {@link FabricText.fromElement})
+   * @see: http://www.w3.org/TR/SVG/text.html#TextElement
    */
   _defineProperty(FabricText, "ATTRIBUTE_NAMES", SHARED_ATTRIBUTES.concat('x', 'y', 'dx', 'dy', 'font-family', 'font-style', 'font-weight', 'font-size', 'letter-spacing', 'text-decoration', 'text-anchor'));
   applyMixins(FabricText, [TextSVGExportMixin]);
@@ -22838,8 +22838,8 @@
       // We don't need to save/restore them here as it would conflict with IText's restoration
     }
 
-    /**
-     * Get the container element for the overlay (parent of upperCanvasEl)
+    /**
+     * Get the container element for the overlay (parent of upperCanvasEl)
      */
     getCanvasContainer() {
       const upperCanvas = this.canvas.upperCanvasEl;
@@ -22853,8 +22853,8 @@
       return container;
     }
 
-    /**
-     * Create the overlay DOM structure
+    /**
+     * Create the overlay DOM structure
      */
     createOverlayDOM() {
       // Host div for positioning and overflow control
@@ -22909,8 +22909,8 @@
       document.body.appendChild(this.hostDiv);
     }
 
-    /**
-     * Attach all event listeners
+    /**
+     * Attach all event listeners
      */
     attachEventListeners() {
       // Textarea events
@@ -22930,8 +22930,8 @@
       this.setupViewportChangeDetection();
     }
 
-    /**
-     * Remove all event listeners
+    /**
+     * Remove all event listeners
      */
     removeEventListeners() {
       this.textarea.removeEventListener('input', this.boundHandlers.onInput);
@@ -22948,16 +22948,16 @@
       this.restoreViewportChangeDetection();
     }
 
-    /**
-     * Simple method to refresh positioning when canvas changes
+    /**
+     * Simple method to refresh positioning when canvas changes
      */
     updatePosition() {
       this.applyOverlayStyle();
     }
 
-    /**
-     * Update the Fabric object bounds to match current textarea size
-     * This ensures Fabric.js selection controls follow the growing textbox
+    /**
+     * Update the Fabric object bounds to match current textarea size
+     * This ensures Fabric.js selection controls follow the growing textbox
      */
     updateObjectBounds() {
       if (this.isDestroyed) return;
@@ -22991,15 +22991,15 @@
       }
     }
 
-    /**
-     * Convert Fabric charSpacing (1/1000 em) to CSS letter-spacing (px)
+    /**
+     * Convert Fabric charSpacing (1/1000 em) to CSS letter-spacing (px)
      */
     letterSpacingPx(charSpacing, fontSize) {
       return charSpacing / 1000 * fontSize;
     }
 
-    /**
-     * Detect text direction using first strong directional character
+    /**
+     * Detect text direction using first strong directional character
      */
     firstStrongDir(text) {
       // Hebrew: \u0590-\u05FF, Arabic: \u0600-\u06FF, \u0750-\u077F, \uFB50-\uFDFF, \uFE70-\uFEFF
@@ -23236,8 +23236,8 @@
       // Initial bounds are set correctly by Fabric.js - don't force update here
     }
 
-    /**
-     * Debug method to compare textarea and canvas object bounding boxes
+    /**
+     * Debug method to compare textarea and canvas object bounding boxes
      */
     debugBoundingBoxComparison() {
       const target = this.target;
@@ -23307,8 +23307,8 @@
       console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
     }
 
-    /**
-     * Debug method to compare text wrapping between textarea and Fabric text object
+    /**
+     * Debug method to compare text wrapping between textarea and Fabric text object
      */
     debugTextWrapping() {
       const target = this.target;
@@ -23393,8 +23393,8 @@
       console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
     }
 
-    /**
-     * Focus the textarea and position cursor at end
+    /**
+     * Focus the textarea and position cursor at end
      */
     focusTextarea() {
       // For overlay editing, we want to keep the object in "selection mode" not "editing mode"
@@ -23434,8 +23434,8 @@
       this.canvas.requestRenderAll();
     }
 
-    /**
-     * Refresh overlay positioning and styling
+    /**
+     * Refresh overlay positioning and styling
      */
     refresh() {
       if (this.isDestroyed) return;
@@ -23443,8 +23443,8 @@
       // Don't update object bounds on every refresh - only when textarea actually resizes
     }
 
-    /**
-     * Destroy the overlay editor
+    /**
+     * Destroy the overlay editor
      */
     destroy() {
       let commit = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
@@ -23612,8 +23612,8 @@
       }
     }
 
-    /**
-     * Setup detection for viewport changes (zoom/pan)
+    /**
+     * Setup detection for viewport changes (zoom/pan)
      */
     setupViewportChangeDetection() {
       // Store original methods
@@ -23642,8 +23642,8 @@
       };
     }
 
-    /**
-     * Restore original viewport methods
+    /**
+     * Restore original viewport methods
      */
     restoreViewportChangeDetection() {
       if (this.canvas.__originalSetZoom) {
@@ -23658,8 +23658,8 @@
     }
   }
 
-  /**
-   * Enter overlay text editing mode for a text object
+  /**
+   * Enter overlay text editing mode for a text object
    */
   function enterTextOverlayEdit(canvas, target, options) {
     // If already in overlay editing, destroy existing editor first
@@ -23683,35 +23683,35 @@
     return editor;
   }
 
-  /**
-   *  extend this regex to support non english languages
-   *
-   *  - ` `      Matches a SPACE character (char code 32).
-   *  - `\n`     Matches a LINE FEED character (char code 10).
-   *  - `.`     Matches a "." character (char code 46).
-   *  - `,`      Matches a "," character (char code 44).
-   *  - `;`      Matches a ";" character (char code 59).
-   *  - `!`      Matches a "!" character (char code 33).
-   *  - `\?`     Matches a "?" character (char code 63).
-   *  - `\-`     Matches a "-" character (char code 45).
+  /**
+   *  extend this regex to support non english languages
+   *
+   *  - ` `      Matches a SPACE character (char code 32).
+   *  - `\n`     Matches a LINE FEED character (char code 10).
+   *  - `.`     Matches a "." character (char code 46).
+   *  - `,`      Matches a "," character (char code 44).
+   *  - `;`      Matches a ";" character (char code 59).
+   *  - `!`      Matches a "!" character (char code 33).
+   *  - `\?`     Matches a "?" character (char code 63).
+   *  - `\-`     Matches a "-" character (char code 45).
    */
   // eslint-disable-next-line no-useless-escape
   const reNonWord = /[ \n\.,;!\?\-]/;
   class ITextBehavior extends FabricText {
     constructor() {
       super(...arguments);
-      /**
-       * Helps determining when the text is in composition, so that the cursor
-       * rendering is altered.
+      /**
+       * Helps determining when the text is in composition, so that the cursor
+       * rendering is altered.
        */
       _defineProperty(this, "_currentCursorOpacity", 1);
     }
-    /**
-     * Keeps track if the IText object was selected before the actual click.
-     * This because we want to delay enter editing by a click.
+    /**
+     * Keeps track if the IText object was selected before the actual click.
+     * This because we want to delay enter editing by a click.
      */
-    /**
-     * Initializes all the interactive behavior of IText
+    /**
+     * Initializes all the interactive behavior of IText
      */
     initBehavior() {
       this._tick = this._tick.bind(this);
@@ -23724,8 +23724,8 @@
       return super.onDeselect(options);
     }
 
-    /**
-     * @private
+    /**
+     * @private
      */
     _animateCursor(_ref) {
       let {
@@ -23750,8 +23750,8 @@
       });
     }
 
-    /**
-     * changes the cursor from visible to invisible
+    /**
+     * changes the cursor from visible to invisible
      */
     _tick(delay) {
       this._currentTickState = this._animateCursor({
@@ -23762,8 +23762,8 @@
       });
     }
 
-    /**
-     * Changes the cursor from invisible to visible
+    /**
+     * Changes the cursor from invisible to visible
      */
     _onTickComplete() {
       var _this$_currentTickCom;
@@ -23775,16 +23775,16 @@
       });
     }
 
-    /**
-     * Initializes delayed cursor
+    /**
+     * Initializes delayed cursor
      */
     initDelayedCursor(restart) {
       this.abortCursorAnimation();
       this._tick(restart ? 0 : this.cursorDelay);
     }
 
-    /**
-     * Aborts cursor animation, clears all timeouts and clear textarea context if necessary
+    /**
+     * Aborts cursor animation, clears all timeouts and clear textarea context if necessary
      */
     abortCursorAnimation() {
       let shouldClear = false;
@@ -23802,9 +23802,9 @@
       }
     }
 
-    /**
-     * Restart tue cursor animation if either is in complete state ( between animations )
-     * or if it never started before
+    /**
+     * Restart tue cursor animation if either is in complete state ( between animations )
+     * or if it never started before
      */
     restartCursorIfNeeded() {
       if ([this._currentTickState, this._currentTickCompleteState].some(cursorAnimation => !cursorAnimation || cursorAnimation.isDone())) {
@@ -23812,8 +23812,8 @@
       }
     }
 
-    /**
-     * Selects entire text
+    /**
+     * Selects entire text
      */
     selectAll() {
       this.selectionStart = 0;
@@ -23823,26 +23823,26 @@
       return this;
     }
 
-    /**
-     * Selects entire text and updates the visual state
+    /**
+     * Selects entire text and updates the visual state
      */
     cmdAll() {
       this.selectAll();
       this.renderCursorOrSelection();
     }
 
-    /**
-     * Returns selected text
-     * @return {String}
+    /**
+     * Returns selected text
+     * @return {String}
      */
     getSelectedText() {
       return this._text.slice(this.selectionStart, this.selectionEnd).join('');
     }
 
-    /**
-     * Find new selection index representing start of current word according to current selection index
-     * @param {Number} startFrom Current selection index
-     * @return {Number} New selection index
+    /**
+     * Find new selection index representing start of current word according to current selection index
+     * @param {Number} startFrom Current selection index
+     * @return {Number} New selection index
      */
     findWordBoundaryLeft(startFrom) {
       let offset = 0,
@@ -23862,10 +23862,10 @@
       return startFrom - offset;
     }
 
-    /**
-     * Find new selection index representing end of current word according to current selection index
-     * @param {Number} startFrom Current selection index
-     * @return {Number} New selection index
+    /**
+     * Find new selection index representing end of current word according to current selection index
+     * @param {Number} startFrom Current selection index
+     * @return {Number} New selection index
      */
     findWordBoundaryRight(startFrom) {
       let offset = 0,
@@ -23885,10 +23885,10 @@
       return startFrom + offset;
     }
 
-    /**
-     * Find new selection index representing start of current line according to current selection index
-     * @param {Number} startFrom Current selection index
-     * @return {Number} New selection index
+    /**
+     * Find new selection index representing start of current line according to current selection index
+     * @param {Number} startFrom Current selection index
+     * @return {Number} New selection index
      */
     findLineBoundaryLeft(startFrom) {
       let offset = 0,
@@ -23900,10 +23900,10 @@
       return startFrom - offset;
     }
 
-    /**
-     * Find new selection index representing end of current line according to current selection index
-     * @param {Number} startFrom Current selection index
-     * @return {Number} New selection index
+    /**
+     * Find new selection index representing end of current line according to current selection index
+     * @param {Number} startFrom Current selection index
+     * @return {Number} New selection index
      */
     findLineBoundaryRight(startFrom) {
       let offset = 0,
@@ -23915,11 +23915,11 @@
       return startFrom + offset;
     }
 
-    /**
-     * Finds index corresponding to beginning or end of a word
-     * @param {Number} selectionStart Index of a character
-     * @param {Number} direction 1 or -1
-     * @return {Number} Index of the beginning or end of a word
+    /**
+     * Finds index corresponding to beginning or end of a word
+     * @param {Number} selectionStart Index of a character
+     * @param {Number} direction 1 or -1
+     * @return {Number} Index of the beginning or end of a word
      */
     searchWordBoundary(selectionStart, direction) {
       const text = this._text;
@@ -23937,9 +23937,9 @@
       return index;
     }
 
-    /**
-     * Selects the word that contains the char at index selectionStart
-     * @param {Number} selectionStart Index of a character
+    /**
+     * Selects the word that contains the char at index selectionStart
+     * @param {Number} selectionStart Index of a character
      */
     selectWord(selectionStart) {
       selectionStart = selectionStart !== null && selectionStart !== void 0 ? selectionStart : this.selectionStart;
@@ -23955,9 +23955,9 @@
       this.renderCursorOrSelection();
     }
 
-    /**
-     * Selects the line that contains selectionStart
-     * @param {Number} selectionStart Index of a character
+    /**
+     * Selects the line that contains selectionStart
+     * @param {Number} selectionStart Index of a character
      */
     selectLine(selectionStart) {
       selectionStart = selectionStart !== null && selectionStart !== void 0 ? selectionStart : this.selectionStart;
@@ -23969,8 +23969,8 @@
       this._updateTextarea();
     }
 
-    /**
-     * Enters editing state
+    /**
+     * Enters editing state
      */
     enterEditing(e) {
       if (this.isEditing || !this.editable) {
@@ -23990,8 +23990,8 @@
       }
     }
 
-    /**
-     * runs the actual logic that enter from editing state, see {@link enterEditing}
+    /**
+     * runs the actual logic that enter from editing state, see {@link enterEditing}
      */
     enterEditingImpl() {
       if (this.canvas) {
@@ -24015,8 +24015,8 @@
       }
     }
 
-    /**
-     * Enter overlay editing mode using DOM textarea overlay
+    /**
+     * Enter overlay editing mode using DOM textarea overlay
      */
     enterOverlayEditing() {
       this._saveEditingProps();
@@ -24037,8 +24037,8 @@
       });
     }
 
-    /**
-     * Commit overlay editing changes
+    /**
+     * Commit overlay editing changes
      */
     commitOverlayEdit(text) {
       const overlayEditor = this.__overlayEditor;
@@ -24062,8 +24062,8 @@
       this.canvas && this.canvas.requestRenderAll();
     }
 
-    /**
-     * Cancel overlay editing without changes
+    /**
+     * Cancel overlay editing without changes
      */
     cancelOverlayEdit() {
       // Restore original text
@@ -24071,8 +24071,8 @@
       this.exitEditing();
     }
 
-    /**
-     * called by {@link Canvas#textEditingManager}
+    /**
+     * called by {@link Canvas#textEditingManager}
      */
     updateSelectionOnMouseMove(e) {
       if (this.getActiveControl()) {
@@ -24100,8 +24100,8 @@
       }
     }
 
-    /**
-     * @private
+    /**
+     * @private
      */
     _setEditingProps() {
       this.hoverCursor = 'text';
@@ -24113,8 +24113,8 @@
       this.lockMovementX = this.lockMovementY = true;
     }
 
-    /**
-     * convert from textarea to grapheme indexes
+    /**
+     * convert from textarea to grapheme indexes
      */
     fromStringToGraphemeSelection(start, end, text) {
       const smallerTextStart = text.slice(0, start),
@@ -24133,8 +24133,8 @@
       };
     }
 
-    /**
-     * convert from fabric to textarea values
+    /**
+     * convert from fabric to textarea values
      */
     fromGraphemeToStringSelection(start, end, graphemes) {
       const smallerTextStart = graphemes.slice(0, start),
@@ -24153,14 +24153,24 @@
       };
     }
 
-    /**
-     * @private
+    /**
+     * @private
      */
     _updateTextarea() {
+      console.log('🔤 _updateTextarea called with fabric text:', this.text);
       this.cursorOffsetCache = {};
       if (!this.hiddenTextarea) {
         return;
       }
+
+      // Sync textarea content with fabric text to prevent double-keypress issues
+      const currentFabricText = this.text;
+      if (this.hiddenTextarea.value !== currentFabricText) {
+        console.log('🔤 _updateTextarea: syncing textarea to fabric text');
+        console.log('🔤 _updateTextarea: textarea was:', this.hiddenTextarea.value);
+        console.log('🔤 _updateTextarea: fabric is:', currentFabricText);
+        this.hiddenTextarea.value = currentFabricText;
+      }
       if (!this.inCompositionMode) {
         const newSelection = this.fromGraphemeToStringSelection(this.selectionStart, this.selectionEnd, this._text);
         this.hiddenTextarea.selectionStart = newSelection.selectionStart;
@@ -24169,8 +24179,8 @@
       this.updateTextareaPosition();
     }
 
-    /**
-     * @private
+    /**
+     * @private
      */
     updateFromTextArea() {
       if (!this.hiddenTextarea) {
@@ -24190,8 +24200,8 @@
       this.updateTextareaPosition();
     }
 
-    /**
-     * @private
+    /**
+     * @private
      */
     updateTextareaPosition() {
       if (this.selectionStart === this.selectionEnd) {
@@ -24201,9 +24211,9 @@
       }
     }
 
-    /**
-     * @private
-     * @return {Object} style contains style for hiddenTextarea
+    /**
+     * @private
+     * @return {Object} style contains style for hiddenTextarea
      */
     _calcTextareaPosition() {
       if (!this.canvas) {
@@ -24250,8 +24260,8 @@
       };
     }
 
-    /**
-     * @private
+    /**
+     * @private
      */
     _saveEditingProps() {
       this._savedProps = {
@@ -24268,8 +24278,8 @@
       };
     }
 
-    /**
-     * @private
+    /**
+     * @private
      */
     _restoreEditingProps() {
       if (!this._savedProps) {
@@ -24289,9 +24299,9 @@
       delete this._savedProps;
     }
 
-    /**
-     * runs the actual logic that exits from editing state, see {@link exitEditing}
-     * But it does not fire events
+    /**
+     * runs the actual logic that exits from editing state, see {@link exitEditing}
+     * But it does not fire events
      */
     exitEditingImpl() {
       const hiddenTextarea = this.hiddenTextarea;
@@ -24312,8 +24322,8 @@
       }
     }
 
-    /**
-     * Exits from editing state and fires relevant events
+    /**
+     * Exits from editing state and fires relevant events
      */
     exitEditing() {
       const isTextChanged = this._textBeforeEdit !== this.text;
@@ -24332,8 +24342,8 @@
       return this;
     }
 
-    /**
-     * @private
+    /**
+     * @private
      */
     _removeExtraneousStyles() {
       for (const prop in this.styles) {
@@ -24343,10 +24353,10 @@
       }
     }
 
-    /**
-     * remove and reflow a style block from start to end.
-     * @param {Number} start linear start position for removal (included in removal)
-     * @param {Number} end linear end position for removal ( excluded from removal )
+    /**
+     * remove and reflow a style block from start to end.
+     * @param {Number} start linear start position for removal (included in removal)
+     * @param {Number} end linear end position for removal ( excluded from removal )
      */
     removeStyleFromTo(start, end) {
       const {
@@ -24399,10 +24409,10 @@
       }
     }
 
-    /**
-     * Shifts line styles up or down
-     * @param {Number} lineIndex Index of a line
-     * @param {Number} offset Can any number?
+    /**
+     * Shifts line styles up or down
+     * @param {Number} lineIndex Index of a line
+     * @param {Number} offset Can any number?
      */
     shiftLineStyles(lineIndex, offset) {
       const clonedStyles = Object.assign({}, this.styles);
@@ -24417,15 +24427,15 @@
       }
     }
 
-    /**
-     * Handle insertion of more consecutive style lines for when one or more
-     * newlines gets added to the text. Since current style needs to be shifted
-     * first we shift the current style of the number lines needed, then we add
-     * new lines from the last to the first.
-     * @param {Number} lineIndex Index of a line
-     * @param {Number} charIndex Index of a char
-     * @param {Number} qty number of lines to add
-     * @param {Array} copiedStyle Array of objects styles
+    /**
+     * Handle insertion of more consecutive style lines for when one or more
+     * newlines gets added to the text. Since current style needs to be shifted
+     * first we shift the current style of the number lines needed, then we add
+     * new lines from the last to the first.
+     * @param {Number} lineIndex Index of a line
+     * @param {Number} charIndex Index of a char
+     * @param {Number} qty number of lines to add
+     * @param {Array} copiedStyle Array of objects styles
      */
     insertNewlineStyleObject(lineIndex, charIndex, qty, copiedStyle) {
       const newLineStyles = {};
@@ -24485,12 +24495,12 @@
       this._forceClearCache = true;
     }
 
-    /**
-     * Inserts style object for a given line/char index
-     * @param {Number} lineIndex Index of a line
-     * @param {Number} charIndex Index of a char
-     * @param {Number} quantity number Style object to insert, if given
-     * @param {Array} copiedStyle array of style objects
+    /**
+     * Inserts style object for a given line/char index
+     * @param {Number} lineIndex Index of a line
+     * @param {Number} charIndex Index of a char
+     * @param {Number} quantity number Style object to insert, if given
+     * @param {Array} copiedStyle array of style objects
      */
     insertCharStyleObject(lineIndex, charIndex, quantity, copiedStyle) {
       if (!this.styles) {
@@ -24539,11 +24549,11 @@
       }
     }
 
-    /**
-     * Inserts style object(s)
-     * @param {Array} insertedText Characters at the location where style is inserted
-     * @param {Number} start cursor index for inserting style
-     * @param {Array} [copiedStyle] array of style objects to insert.
+    /**
+     * Inserts style object(s)
+     * @param {Array} insertedText Characters at the location where style is inserted
+     * @param {Number} start cursor index for inserting style
+     * @param {Array} [copiedStyle] array of style objects to insert.
      */
     insertNewStyleBlock(insertedText, start, copiedStyle) {
       const cursorLoc = this.get2DCursorLocation(start, true),
@@ -24584,12 +24594,12 @@
       }
     }
 
-    /**
-     * Removes characters from start/end
-     * start/end ar per grapheme position in _text array.
-     *
-     * @param {Number} start
-     * @param {Number} end default to start + 1
+    /**
+     * Removes characters from start/end
+     * start/end ar per grapheme position in _text array.
+     *
+     * @param {Number} start
+     * @param {Number} end default to start + 1
      */
     removeChars(start) {
       let end = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : start + 1;
@@ -24602,17 +24612,17 @@
       this._removeExtraneousStyles();
     }
 
-    /**
-     * insert characters at start position, before start position.
-     * start  equal 1 it means the text get inserted between actual grapheme 0 and 1
-     * if style array is provided, it must be as the same length of text in graphemes
-     * if end is provided and is bigger than start, old text is replaced.
-     * start/end ar per grapheme position in _text array.
-     *
-     * @param {String} text text to insert
-     * @param {Array} style array of style objects
-     * @param {Number} start
-     * @param {Number} end default to start + 1
+    /**
+     * insert characters at start position, before start position.
+     * start  equal 1 it means the text get inserted between actual grapheme 0 and 1
+     * if style array is provided, it must be as the same length of text in graphemes
+     * if end is provided and is bigger than start, old text is replaced.
+     * start/end ar per grapheme position in _text array.
+     *
+     * @param {String} text text to insert
+     * @param {Array} style array of style objects
+     * @param {Number} start
+     * @param {Number} end default to start + 1
      */
     insertChars(text, style, start) {
       let end = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : start;
@@ -24629,9 +24639,9 @@
       this._removeExtraneousStyles();
     }
 
-    /**
-     * Set the selectionStart and selectionEnd according to the new position of cursor
-     * mimic the key - mouse navigation when shift is pressed.
+    /**
+     * Set the selectionStart and selectionEnd according to the new position of cursor
+     * mimic the key - mouse navigation when shift is pressed.
      */
     setSelectionStartEndWithShift(start, end, newSelection) {
       if (newSelection <= start) {
@@ -24807,6 +24817,52 @@
       if (!this.isEditing) {
         return;
       }
+
+      // Debug log to track the double keypress issue
+      console.log('🔤 onInput debug:', {
+        fabricText: this.text,
+        textareaValue: value,
+        fabricSelection: {
+          start: this.selectionStart,
+          end: this.selectionEnd
+        },
+        textareaSelection: {
+          start: selectionStart,
+          end: selectionEnd
+        },
+        fromPaste,
+        inComposition: this.inCompositionMode
+      });
+
+      // Immediate sync for simple character replacement - fix for double keypress issue
+      if (this.text !== value && !this.inCompositionMode) {
+        console.log('🔤 Immediate sync: fabric text differs from textarea, syncing immediately');
+        console.log('🔤 Before sync - fabric text:', this.text);
+        console.log('🔤 Before sync - textarea value:', value);
+        console.log('🔤 fromPaste:', fromPaste);
+
+        // Clear all relevant caches that might prevent visual updates
+        this.cursorOffsetCache = {};
+        this._browserWrapCache = null;
+        this._lastDimensionState = null;
+        this._forceClearCache = true;
+        console.log('🔤 Cleared all caches');
+
+        // Use the same logic as updateAndFire but immediately
+        this.updateFromTextArea();
+        this.fire(CHANGED);
+        if (this.canvas) {
+          this.canvas.fire('text:changed', {
+            target: this
+          });
+          // ONLY use synchronous rendering to avoid race conditions
+          // Remove requestRenderAll() which queues for next animation frame
+          this.canvas.renderAll();
+        }
+        console.log('🔤 After updateFromTextArea - fabric text:', this.text);
+        console.log('🔤 Sync complete, caches cleared, synchronous render only');
+        return;
+      }
       const updateAndFire = () => {
         this.updateFromTextArea();
         this.fire(CHANGED);
@@ -25254,8 +25310,8 @@
     }
   }
 
-  /**
-   * `LEFT_CLICK === 0`
+  /**
+   * `LEFT_CLICK === 0`
    */
   const notALeftClick = e => !!e.button;
   class ITextClickBehavior extends ITextKeyBehavior {
@@ -25273,36 +25329,36 @@
       super.initBehavior();
     }
 
-    /**
-     * If this method returns true a mouse move operation over a text selection
-     * will not prevent the native mouse event allowing the browser to start a drag operation.
-     * shouldStartDragging can be read 'do not prevent default for mouse move event'
-     * To prevent drag and drop between objects both shouldStartDragging and onDragStart should return false
-     * @returns
+    /**
+     * If this method returns true a mouse move operation over a text selection
+     * will not prevent the native mouse event allowing the browser to start a drag operation.
+     * shouldStartDragging can be read 'do not prevent default for mouse move event'
+     * To prevent drag and drop between objects both shouldStartDragging and onDragStart should return false
+     * @returns
      */
     shouldStartDragging() {
       return this.draggableTextDelegate.isActive();
     }
 
-    /**
-     * @public override this method to control whether instance should/shouldn't become a drag source,
-     * @see also {@link DraggableTextDelegate#isActive}
-     * To prevent drag and drop between objects both shouldStartDragging and onDragStart should return false
-     * @returns {boolean} should handle event
+    /**
+     * @public override this method to control whether instance should/shouldn't become a drag source,
+     * @see also {@link DraggableTextDelegate#isActive}
+     * To prevent drag and drop between objects both shouldStartDragging and onDragStart should return false
+     * @returns {boolean} should handle event
      */
     onDragStart(e) {
       return this.draggableTextDelegate.onDragStart(e);
     }
 
-    /**
-     * @public override this method to control whether instance should/shouldn't become a drop target
+    /**
+     * @public override this method to control whether instance should/shouldn't become a drop target
      */
     canDrop(e) {
       return this.draggableTextDelegate.canDrop(e);
     }
 
-    /**
-     * Default handler for double click, select a word or enter overlay editing
+    /**
+     * Default handler for double click, select a word or enter overlay editing
      */
     doubleClickHandler(options) {
       // Check if we should enter overlay editing mode
@@ -25319,8 +25375,8 @@
       this.renderCursorOrSelection();
     }
 
-    /**
-     * Default handler for triple click, select a line
+    /**
+     * Default handler for triple click, select a line
      */
     tripleClickHandler(options) {
       if (!this.isEditing) {
@@ -25330,13 +25386,13 @@
       this.renderCursorOrSelection();
     }
 
-    /**
-     * Default event handler for the basic functionalities needed on _mouseDown
-     * can be overridden to do something different.
-     * Scope of this implementation is: find the click position, set selectionStart
-     * find selectionEnd, initialize the drawing of either cursor or selection area
-     * initializing a mousedDown on a text area will cancel fabricjs knowledge of
-     * current compositionMode. It will be set to false.
+    /**
+     * Default event handler for the basic functionalities needed on _mouseDown
+     * can be overridden to do something different.
+     * Scope of this implementation is: find the click position, set selectionStart
+     * find selectionEnd, initialize the drawing of either cursor or selection area
+     * initializing a mousedDown on a text area will cancel fabricjs knowledge of
+     * current compositionMode. It will be set to false.
      */
     _mouseDownHandler(_ref) {
       let {
@@ -25364,9 +25420,9 @@
       this.selected || (this.selected = alreadySelected || this.isEditing);
     }
 
-    /**
-     * standard handler for mouse up, overridable
-     * @private
+    /**
+     * standard handler for mouse up, overridable
+     * @private
      */
     mouseUpHandler(_ref2) {
       let {
@@ -25397,9 +25453,9 @@
       }
     }
 
-    /**
-     * Changes cursor location in a text depending on passed pointer (x/y) object
-     * @param {TPointerEvent} e Event object
+    /**
+     * Changes cursor location in a text depending on passed pointer (x/y) object
+     * @param {TPointerEvent} e Event object
      */
     setCursorByClick(e) {
       const newSelection = this.getSelectionStartFromPointer(e),
@@ -25417,10 +25473,10 @@
       }
     }
 
-    /**
-     * Returns index of a character corresponding to where an object was clicked
-     * @param {TPointerEvent} e Event object
-     * @return {Number} Index of a character
+    /**
+     * Returns index of a character corresponding to where an object was clicked
+     * @param {TPointerEvent} e Event object
+     * @return {Number} Index of a character
      */
     getSelectionStartFromPointer(e) {
       const mouseOffset = this.canvas.getScenePoint(e).transform(invertTransform(this.calcTransformMatrix())).add(new Point(-this._getLeftOffset(), -this._getTopOffset()));
@@ -25466,15 +25522,15 @@
     }
   }
 
-  /**
-   * Hit Testing and Cursor Positioning System
-   * 
-   * Maps pointer coordinates to text positions and provides cursor rectangles
-   * for interactive text editing with grapheme-aware boundaries.
+  /**
+   * Hit Testing and Cursor Positioning System
+   * 
+   * Maps pointer coordinates to text positions and provides cursor rectangles
+   * for interactive text editing with grapheme-aware boundaries.
    */
 
-  /**
-   * Hit test a point against laid out text to find insertion position
+  /**
+   * Hit test a point against laid out text to find insertion position
    */
   function hitTest(x, y, layout, options) {
     if (layout.lines.length === 0) {
@@ -25518,8 +25574,8 @@
     };
   }
 
-  /**
-   * Get cursor rectangle for a given insertion index
+  /**
+   * Get cursor rectangle for a given insertion index
    */
   function getCursorRect(insertionIndex, layout, options) {
     if (layout.lines.length === 0) {
@@ -25566,8 +25622,8 @@
 
   // Private helper functions
 
-  /**
-   * Find which line contains the given Y coordinate
+  /**
+   * Find which line contains the given Y coordinate
    */
   function findLineAtY(y, lines) {
     var _lines;
@@ -25590,8 +25646,8 @@
     };
   }
 
-  /**
-   * Find character position within a line at given X coordinate
+  /**
+   * Find character position within a line at given X coordinate
    */
   function findCharAtX(x, line, options) {
     if (line.bounds.length === 0) {
@@ -25697,8 +25753,8 @@
     };
   }
 
-  /**
-   * Calculate total insertion index from line and character indices
+  /**
+   * Calculate total insertion index from line and character indices
    */
   function calculateInsertionIndex(lineIndex, graphemeIndex, layout) {
     let insertionIndex = 0;
@@ -25717,8 +25773,8 @@
     return insertionIndex;
   }
 
-  /**
-   * Find line and grapheme position from insertion index
+  /**
+   * Find line and grapheme position from insertion index
    */
   function findPositionFromIndex(insertionIndex, layout) {
     let currentIndex = 0;
@@ -25760,8 +25816,8 @@
     };
   }
 
-  /**
-   * Calculate Y position of a line
+  /**
+   * Calculate Y position of a line
    */
   function calculateLineY(lineIndex, layout, options) {
     let y = 0;
@@ -25864,48 +25920,48 @@
 
   // @TODO this is not complete
 
-  /**
-   * @fires changed
-   * @fires selection:changed
-   * @fires editing:entered
-   * @fires editing:exited
-   * @fires dragstart
-   * @fires drag drag event firing on the drag source
-   * @fires dragend
-   * @fires copy
-   * @fires cut
-   * @fires paste
-   *
-   * #### Supported key combinations
-   * ```
-   *   Move cursor:                    left, right, up, down
-   *   Select character:               shift + left, shift + right
-   *   Select text vertically:         shift + up, shift + down
-   *   Move cursor by word:            alt + left, alt + right
-   *   Select words:                   shift + alt + left, shift + alt + right
-   *   Move cursor to line start/end:  cmd + left, cmd + right or home, end
-   *   Select till start/end of line:  cmd + shift + left, cmd + shift + right or shift + home, shift + end
-   *   Jump to start/end of text:      cmd + up, cmd + down
-   *   Select till start/end of text:  cmd + shift + up, cmd + shift + down or shift + pgUp, shift + pgDown
-   *   Delete character:               backspace
-   *   Delete word:                    alt + backspace
-   *   Delete line:                    cmd + backspace
-   *   Forward delete:                 delete
-   *   Copy text:                      ctrl/cmd + c
-   *   Paste text:                     ctrl/cmd + v
-   *   Cut text:                       ctrl/cmd + x
-   *   Select entire text:             ctrl/cmd + a
-   *   Quit editing                    tab or esc
-   * ```
-   *
-   * #### Supported mouse/touch combination
-   * ```
-   *   Position cursor:                click/touch
-   *   Create selection:               click/touch & drag
-   *   Create selection:               click & shift + click
-   *   Select word:                    double click
-   *   Select line:                    triple click
-   * ```
+  /**
+   * @fires changed
+   * @fires selection:changed
+   * @fires editing:entered
+   * @fires editing:exited
+   * @fires dragstart
+   * @fires drag drag event firing on the drag source
+   * @fires dragend
+   * @fires copy
+   * @fires cut
+   * @fires paste
+   *
+   * #### Supported key combinations
+   * ```
+   *   Move cursor:                    left, right, up, down
+   *   Select character:               shift + left, shift + right
+   *   Select text vertically:         shift + up, shift + down
+   *   Move cursor by word:            alt + left, alt + right
+   *   Select words:                   shift + alt + left, shift + alt + right
+   *   Move cursor to line start/end:  cmd + left, cmd + right or home, end
+   *   Select till start/end of line:  cmd + shift + left, cmd + shift + right or shift + home, shift + end
+   *   Jump to start/end of text:      cmd + up, cmd + down
+   *   Select till start/end of text:  cmd + shift + up, cmd + shift + down or shift + pgUp, shift + pgDown
+   *   Delete character:               backspace
+   *   Delete word:                    alt + backspace
+   *   Delete line:                    cmd + backspace
+   *   Forward delete:                 delete
+   *   Copy text:                      ctrl/cmd + c
+   *   Paste text:                     ctrl/cmd + v
+   *   Cut text:                       ctrl/cmd + x
+   *   Select entire text:             ctrl/cmd + a
+   *   Quit editing                    tab or esc
+   * ```
+   *
+   * #### Supported mouse/touch combination
+   * ```
+   *   Position cursor:                click/touch
+   *   Create selection:               click/touch & drag
+   *   Create selection:               click & shift + click
+   *   Select word:                    double click
+   *   Select line:                    triple click
+   * ```
    */
   class IText extends ITextClickBehavior {
     static getDefaults() {
@@ -25920,10 +25976,10 @@
       return type === 'itext' ? 'i-text' : type;
     }
 
-    /**
-     * Constructor
-     * @param {String} text Text string
-     * @param {Object} [options] Options object
+    /**
+     * Constructor
+     * @param {String} text Text string
+     * @param {Object} [options] Options object
      */
     constructor(text, options) {
       super(text, {
@@ -25933,11 +25989,11 @@
       this.initBehavior();
     }
 
-    /**
-     * While editing handle differently
-     * @private
-     * @param {string} key
-     * @param {*} value
+    /**
+     * While editing handle differently
+     * @private
+     * @param {string} key
+     * @param {*} value
      */
     _set(key, value) {
       if (this.isEditing && this._savedProps && key in this._savedProps) {
@@ -25952,28 +26008,28 @@
       return super._set(key, value);
     }
 
-    /**
-     * Sets selection start (left boundary of a selection)
-     * @param {Number} index Index to set selection start to
+    /**
+     * Sets selection start (left boundary of a selection)
+     * @param {Number} index Index to set selection start to
      */
     setSelectionStart(index) {
       index = Math.max(index, 0);
       this._updateAndFire('selectionStart', index);
     }
 
-    /**
-     * Sets selection end (right boundary of a selection)
-     * @param {Number} index Index to set selection end to
+    /**
+     * Sets selection end (right boundary of a selection)
+     * @param {Number} index Index to set selection end to
      */
     setSelectionEnd(index) {
       index = Math.min(index, this.text.length);
       this._updateAndFire('selectionEnd', index);
     }
 
-    /**
-     * @private
-     * @param {String} property 'selectionStart' or 'selectionEnd'
-     * @param {Number} index new position of property
+    /**
+     * @private
+     * @param {String} property 'selectionStart' or 'selectionEnd'
+     * @param {Number} index new position of property
      */
     _updateAndFire(property, index) {
       if (this[property] !== index) {
@@ -25983,9 +26039,9 @@
       this._updateTextarea();
     }
 
-    /**
-     * Fires the even of selection changed
-     * @private
+    /**
+     * Fires the even of selection changed
+     * @private
      */
     _fireSelectionChanged() {
       this.fire('selection:changed');
@@ -25994,25 +26050,25 @@
       });
     }
 
-    /**
-     * Initialize text dimensions. Render all text on given context
-     * or on a offscreen canvas to get the text width with measureText.
-     * Updates this.width and this.height with the proper values.
-     * Does not return dimensions.
-     * @private
+    /**
+     * Initialize text dimensions. Render all text on given context
+     * or on a offscreen canvas to get the text width with measureText.
+     * Updates this.width and this.height with the proper values.
+     * Does not return dimensions.
+     * @private
      */
     initDimensions() {
       this.isEditing && this.initDelayedCursor();
       super.initDimensions();
     }
 
-    /**
-     * Gets style of a current selection/cursor (at the start position)
-     * if startIndex or endIndex are not provided, selectionStart or selectionEnd will be used.
-     * @param {Number} startIndex Start index to get styles at
-     * @param {Number} endIndex End index to get styles at, if not specified selectionEnd or startIndex + 1
-     * @param {Boolean} [complete] get full style or not
-     * @return {Array} styles an array with one, zero or more Style objects
+    /**
+     * Gets style of a current selection/cursor (at the start position)
+     * if startIndex or endIndex are not provided, selectionStart or selectionEnd will be used.
+     * @param {Number} startIndex Start index to get styles at
+     * @param {Number} endIndex End index to get styles at, if not specified selectionEnd or startIndex + 1
+     * @param {Boolean} [complete] get full style or not
+     * @return {Array} styles an array with one, zero or more Style objects
      */
     getSelectionStyles() {
       let startIndex = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.selectionStart || 0;
@@ -26021,11 +26077,11 @@
       return super.getSelectionStyles(startIndex, endIndex, complete);
     }
 
-    /**
-     * Sets style of a current selection, if no selection exist, do not set anything.
-     * @param {Object} [styles] Styles object
-     * @param {Number} [startIndex] Start index to get styles at
-     * @param {Number} [endIndex] End index to get styles at, if not specified selectionEnd or startIndex + 1
+    /**
+     * Sets style of a current selection, if no selection exist, do not set anything.
+     * @param {Object} [styles] Styles object
+     * @param {Number} [startIndex] Start index to get styles at
+     * @param {Number} [endIndex] End index to get styles at, if not specified selectionEnd or startIndex + 1
      */
     setSelectionStyles(styles) {
       let startIndex = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.selectionStart || 0;
@@ -26033,10 +26089,10 @@
       return super.setSelectionStyles(styles, startIndex, endIndex);
     }
 
-    /**
-     * Returns 2d representation (lineIndex and charIndex) of cursor (or selection start)
-     * @param {Number} [selectionStart] Optional index. When not given, current selectionStart is used.
-     * @param {Boolean} [skipWrapping] consider the location for unwrapped lines. useful to manage styles.
+    /**
+     * Returns 2d representation (lineIndex and charIndex) of cursor (or selection start)
+     * @param {Number} [selectionStart] Optional index. When not given, current selectionStart is used.
+     * @param {Boolean} [skipWrapping] consider the location for unwrapped lines. useful to manage styles.
      */
     get2DCursorLocation() {
       let selectionStart = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.selectionStart;
@@ -26044,9 +26100,9 @@
       return super.get2DCursorLocation(selectionStart, skipWrapping);
     }
 
-    /**
-     * @private
-     * @param {CanvasRenderingContext2D} ctx Context to render on
+    /**
+     * @private
+     * @param {CanvasRenderingContext2D} ctx Context to render on
      */
     render(ctx) {
       super.render(ctx);
@@ -26056,9 +26112,9 @@
       this.renderCursorOrSelection();
     }
 
-    /**
-     * @override block cursor/selection logic while rendering the exported canvas
-     * @todo this workaround should be replaced with a more robust solution
+    /**
+     * @override block cursor/selection logic while rendering the exported canvas
+     * @todo this workaround should be replaced with a more robust solution
      */
     toCanvasElement(options) {
       const isEditing = this.isEditing;
@@ -26068,9 +26124,9 @@
       return canvas;
     }
 
-    /**
-     * Renders cursor or selection (depending on what exists)
-     * it does on the contextTop. If contextTop is not available, do nothing.
+    /**
+     * Renders cursor or selection (depending on what exists)
+     * it does on the contextTop. If contextTop is not available, do nothing.
      */
     renderCursorOrSelection() {
       if (!this.isEditing || !this.canvas) {
@@ -26126,12 +26182,12 @@
       ctx.restore();
     }
 
-    /**
-     * Finds and returns an array of clip paths that are applied to the parent
-     * group(s) of the current FabricObject instance. The object's hierarchy is
-     * traversed upwards (from the current object towards the root of the canvas),
-     * checking each parent object for the presence of a `clipPath` that is not
-     * absolutely positioned.
+    /**
+     * Finds and returns an array of clip paths that are applied to the parent
+     * group(s) of the current FabricObject instance. The object's hierarchy is
+     * traversed upwards (from the current object towards the root of the canvas),
+     * checking each parent object for the presence of a `clipPath` that is not
+     * absolutely positioned.
      */
     findAncestorsWithClipPath() {
       const clipPathAncestors = [];
@@ -26146,13 +26202,13 @@
       return clipPathAncestors;
     }
 
-    /**
-     * Returns cursor boundaries (left, top, leftOffset, topOffset)
-     * left/top are left/top of entire text box
-     * leftOffset/topOffset are offset from that left/top point of a text box
-     * @private
-     * @param {number} [index] index from start
-     * @param {boolean} [skipCaching]
+    /**
+     * Returns cursor boundaries (left, top, leftOffset, topOffset)
+     * left/top are left/top of entire text box
+     * leftOffset/topOffset are offset from that left/top point of a text box
+     * @private
+     * @param {number} [index] index from start
+     * @param {boolean} [skipCaching]
      */
     _getCursorBoundaries() {
       let index = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.selectionStart;
@@ -26166,11 +26222,11 @@
       return this._getCursorBoundariesOriginal(index, skipCaching);
     }
 
-    /**
-     * Caches and returns cursor left/top offset relative to instance's center point
-     * @private
-     * @param {number} index index from start
-     * @param {boolean} [skipCaching]
+    /**
+     * Caches and returns cursor left/top offset relative to instance's center point
+     * @private
+     * @param {number} index index from start
+     * @param {boolean} [skipCaching]
      */
     _getCursorBoundariesOffsets(index, skipCaching) {
       if (skipCaching) {
@@ -26182,9 +26238,9 @@
       return this.cursorOffsetCache = this.__getCursorBoundariesOffsets(index);
     }
 
-    /**
-     * Enhanced cursor boundaries using advanced hit testing when available
-     * @private
+    /**
+     * Enhanced cursor boundaries using advanced hit testing when available
+     * @private
      */
     _getCursorBoundariesAdvanced(index) {
       if (!this.enableAdvancedLayout || !this._layoutTextAdvanced) {
@@ -26200,9 +26256,9 @@
       };
     }
 
-    /**
-     * Enhanced selection start from pointer using BiDi-aware hit testing
-     * @override
+    /**
+     * Enhanced selection start from pointer using BiDi-aware hit testing
+     * @override
      */
     getSelectionStartFromPointer(e) {
       if (!this.enableAdvancedLayout || !this._layoutTextAdvanced) {
@@ -26216,9 +26272,9 @@
       return Math.min(hitResult.charIndex, this._text.length);
     }
 
-    /**
-     * Original cursor boundaries implementation
-     * @private
+    /**
+     * Original cursor boundaries implementation
+     * @private
      */
     _getCursorBoundariesOriginal(index, skipCaching) {
       const left = this._getLeftOffset(),
@@ -26232,10 +26288,10 @@
       };
     }
 
-    /**
-     * Calculates cursor left/top offset relative to instance's center point
-     * @private
-     * @param {number} index index from start
+    /**
+     * Calculates cursor left/top offset relative to instance's center point
+     * @private
+     * @param {number} index index from start
      */
     __getCursorBoundariesOffsets(index) {
       let topOffset = 0,
@@ -26269,29 +26325,29 @@
       return boundaries;
     }
 
-    /**
-     * Renders cursor on context Top, outside the animation cycle, on request
-     * Used for the drag/drop effect.
-     * If contextTop is not available, do nothing.
+    /**
+     * Renders cursor on context Top, outside the animation cycle, on request
+     * Used for the drag/drop effect.
+     * If contextTop is not available, do nothing.
      */
     renderCursorAt(selectionStart) {
       this._renderCursor(this.canvas.contextTop, this._getCursorBoundaries(selectionStart, true), selectionStart);
     }
 
-    /**
-     * Renders cursor
-     * @param {Object} boundaries
-     * @param {CanvasRenderingContext2D} ctx transformed context to draw on
+    /**
+     * Renders cursor
+     * @param {Object} boundaries
+     * @param {CanvasRenderingContext2D} ctx transformed context to draw on
      */
     renderCursor(ctx, boundaries) {
       this._renderCursor(ctx, boundaries, this.selectionStart);
     }
 
-    /**
-     * Return the data needed to render the cursor for given selection start
-     * The left,top are relative to the object, while width and height are prescaled
-     * to look think with canvas zoom and object scaling,
-     * so they depend on canvas and object scaling
+    /**
+     * Return the data needed to render the cursor for given selection start
+     * The left,top are relative to the object, while width and height are prescaled
+     * to look think with canvas zoom and object scaling,
+     * so they depend on canvas and object scaling
      */
     getCursorRenderingData() {
       let selectionStart = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.selectionStart;
@@ -26314,9 +26370,9 @@
       };
     }
 
-    /**
-     * Render the cursor at the given selectionStart.
-     * @param {CanvasRenderingContext2D} ctx transformed context to draw on
+    /**
+     * Render the cursor at the given selectionStart.
+     * @param {CanvasRenderingContext2D} ctx transformed context to draw on
      */
     _renderCursor(ctx, boundaries, selectionStart) {
       const {
@@ -26332,10 +26388,10 @@
       ctx.fillRect(left, top, width, height);
     }
 
-    /**
-     * Renders text selection
-     * @param {Object} boundaries Object with left/top/leftOffset/topOffset
-     * @param {CanvasRenderingContext2D} ctx transformed context to draw on
+    /**
+     * Renders text selection
+     * @param {Object} boundaries Object with left/top/leftOffset/topOffset
+     * @param {CanvasRenderingContext2D} ctx transformed context to draw on
      */
     renderSelection(ctx, boundaries) {
       const selection = {
@@ -26345,8 +26401,8 @@
       this._renderSelection(ctx, selection, boundaries);
     }
 
-    /**
-     * Renders drag start text selection
+    /**
+     * Renders drag start text selection
      */
     renderDragSourceEffect() {
       const dragStartSelection = this.draggableTextDelegate.getDragStartSelection();
@@ -26357,12 +26413,12 @@
       this.renderCursorAt(dragSelection);
     }
 
-    /**
-     * Renders text selection
-     * @private
-     * @param {{ selectionStart: number, selectionEnd: number }} selection
-     * @param {Object} boundaries Object with left/top/leftOffset/topOffset
-     * @param {CanvasRenderingContext2D} ctx transformed context to draw on
+    /**
+     * Renders text selection
+     * @private
+     * @param {{ selectionStart: number, selectionEnd: number }} selection
+     * @param {Object} boundaries Object with left/top/leftOffset/topOffset
+     * @param {CanvasRenderingContext2D} ctx transformed context to draw on
      */
     _renderSelection(ctx, selection, boundaries) {
       const selectionStart = selection.selectionStart,
@@ -26424,34 +26480,34 @@
       }
     }
 
-    /**
-     * High level function to know the height of the cursor.
-     * the currentChar is the one that precedes the cursor
-     * Returns fontSize of char at the current cursor
-     * Unused from the library, is for the end user
-     * @return {Number} Character font size
+    /**
+     * High level function to know the height of the cursor.
+     * the currentChar is the one that precedes the cursor
+     * Returns fontSize of char at the current cursor
+     * Unused from the library, is for the end user
+     * @return {Number} Character font size
      */
     getCurrentCharFontSize() {
       const cp = this._getCurrentCharIndex();
       return this.getValueOfPropertyAt(cp.l, cp.c, 'fontSize');
     }
 
-    /**
-     * High level function to know the color of the cursor.
-     * the currentChar is the one that precedes the cursor
-     * Returns color (fill) of char at the current cursor
-     * if the text object has a pattern or gradient for filler, it will return that.
-     * Unused by the library, is for the end user
-     * @return {String | TFiller} Character color (fill)
+    /**
+     * High level function to know the color of the cursor.
+     * the currentChar is the one that precedes the cursor
+     * Returns color (fill) of char at the current cursor
+     * if the text object has a pattern or gradient for filler, it will return that.
+     * Unused by the library, is for the end user
+     * @return {String | TFiller} Character color (fill)
      */
     getCurrentCharColor() {
       const cp = this._getCurrentCharIndex();
       return this.getValueOfPropertyAt(cp.l, cp.c, FILL);
     }
 
-    /**
-     * Returns the cursor position for the getCurrent.. functions
-     * @private
+    /**
+     * Returns the cursor position for the getCurrent.. functions
+     * @private
      */
     _getCurrentCharIndex() {
       const cursorPosition = this.get2DCursorLocation(this.selectionStart, true),
@@ -26467,52 +26523,52 @@
       super.dispose();
     }
   }
-  /**
-   * Index where text selection starts (or where cursor is when there is no selection)
-   * @type Number
+  /**
+   * Index where text selection starts (or where cursor is when there is no selection)
+   * @type Number
    */
-  /**
-   * Index where text selection ends
-   * @type Number
+  /**
+   * Index where text selection ends
+   * @type Number
    */
-  /**
-   * Color of text selection
-   * @type String
+  /**
+   * Color of text selection
+   * @type String
    */
-  /**
-   * Indicates whether text is in editing mode
-   * @type Boolean
+  /**
+   * Indicates whether text is in editing mode
+   * @type Boolean
    */
-  /**
-   * Indicates whether a text can be edited
-   * @type Boolean
+  /**
+   * Indicates whether a text can be edited
+   * @type Boolean
    */
-  /**
-   * Border color of text object while it's in editing mode
-   * @type String
+  /**
+   * Border color of text object while it's in editing mode
+   * @type String
    */
-  /**
-   * Width of cursor (in px)
-   * @type Number
+  /**
+   * Width of cursor (in px)
+   * @type Number
    */
-  /**
-   * Color of text cursor color in editing mode.
-   * if not set (default) will take color from the text.
-   * if set to a color value that fabric can understand, it will
-   * be used instead of the color of the text at the current position.
-   * @type String
+  /**
+   * Color of text cursor color in editing mode.
+   * if not set (default) will take color from the text.
+   * if set to a color value that fabric can understand, it will
+   * be used instead of the color of the text at the current position.
+   * @type String
    */
-  /**
-   * Delay between cursor blink (in ms)
-   * @type Number
+  /**
+   * Delay between cursor blink (in ms)
+   * @type Number
    */
-  /**
-   * Duration of cursor fade in (in ms)
-   * @type Number
+  /**
+   * Duration of cursor fade in (in ms)
+   * @type Number
    */
-  /**
-   * Indicates whether internal text char widths can be cached
-   * @type Boolean
+  /**
+   * Indicates whether internal text char widths can be cached
+   * @type Boolean
    */
   _defineProperty(IText, "ownDefaults", iTextDefaultValues);
   _defineProperty(IText, "type", 'IText');
@@ -26534,11 +26590,11 @@
 
   // @TODO this is not complete
 
-  /**
-   * Textbox class, based on IText, allows the user to resize the text rectangle
-   * and wraps lines automatically. Textboxes have their Y scaling locked, the
-   * user can only change width. Height is adjusted automatically based on the
-   * wrapping of lines.
+  /**
+   * Textbox class, based on IText, allows the user to resize the text rectangle
+   * and wraps lines automatically. Textboxes have their Y scaling locked, the
+   * user can only change width. Height is adjusted automatically based on the
+   * wrapping of lines.
    */
   class Textbox extends IText {
     static getDefaults() {
@@ -26548,10 +26604,10 @@
       };
     }
 
-    /**
-     * Constructor
-     * @param {String} text Text string
-     * @param {Object} [options] Options object
+    /**
+     * Constructor
+     * @param {String} text Text string
+     * @param {Object} [options] Options object
      */
     constructor(text, options) {
       super(text, {
@@ -26561,10 +26617,10 @@
       this.initializeEventListeners();
     }
 
-    /**
-     * Creates the default control object.
-     * If you prefer to have on instance of controls shared among all objects
-     * make this function return an empty object and add controls to the ownDefaults object
+    /**
+     * Creates the default control object.
+     * If you prefer to have on instance of controls shared among all objects
+     * make this function return an empty object and add controls to the ownDefaults object
      */
     static createControls() {
       return {
@@ -26572,11 +26628,11 @@
       };
     }
 
-    /**
-     * Unlike superclass's version of this function, Textbox does not update
-     * its width.
-     * @private
-     * @override
+    /**
+     * Unlike superclass's version of this function, Textbox does not update
+     * its width.
+     * @private
+     * @override
      */
     initDimensions() {
       if (!this.initialized) {
@@ -26720,9 +26776,9 @@
       }
     }
 
-    /**
-     * Schedule justify calculation after font loads (Textbox-specific)
-     * @private
+    /**
+     * Schedule justify calculation after font loads (Textbox-specific)
+     * @private
      */
     _scheduleJustifyAfterFontLoad() {
       if (typeof document === 'undefined' || !('fonts' in document)) {
@@ -26749,9 +26805,9 @@
       });
     }
 
-    /**
-     * Advanced dimensions calculation using new layout engine
-     * @private
+    /**
+     * Advanced dimensions calculation using new layout engine
+     * @private
      */
     initDimensionsAdvanced() {
       if (!this.initialized) {
@@ -26806,9 +26862,9 @@
       this.dirty = true;
     }
 
-    /**
-     * Generate style map from new layout format
-     * @private
+    /**
+     * Generate style map from new layout format
+     * @private
      */
     _generateStyleMapFromLayout(layout) {
       const map = {};
@@ -26830,12 +26886,12 @@
       return map;
     }
 
-    /**
-     * Generate an object that translates the style object so that it is
-     * broken up by visual lines (new lines and automatic wrapping).
-     * The original text styles object is broken up by actual lines (new lines only),
-     * which is only sufficient for Text / IText
-     * @private
+    /**
+     * Generate an object that translates the style object so that it is
+     * broken up by visual lines (new lines and automatic wrapping).
+     * The original text styles object is broken up by actual lines (new lines only),
+     * which is only sufficient for Text / IText
+     * @private
      */
     _generateStyleMap(textInfo) {
       let realLineCount = 0,
@@ -26862,10 +26918,10 @@
       return map;
     }
 
-    /**
-     * Returns true if object has a style property or has it on a specified line
-     * @param {Number} lineIndex
-     * @return {Boolean}
+    /**
+     * Returns true if object has a style property or has it on a specified line
+     * @param {Number} lineIndex
+     * @return {Boolean}
      */
     styleHas(property, lineIndex) {
       if (this._styleMap && !this.isWrapping) {
@@ -26877,10 +26933,10 @@
       return super.styleHas(property, lineIndex);
     }
 
-    /**
-     * Returns true if object has no styling or no styling in a line
-     * @param {Number} lineIndex , lineIndex is on wrapped lines.
-     * @return {Boolean}
+    /**
+     * Returns true if object has no styling or no styling in a line
+     * @param {Number} lineIndex , lineIndex is on wrapped lines.
+     * @return {Boolean}
      */
     isEmptyStyles(lineIndex) {
       if (!this.styles) {
@@ -26917,11 +26973,11 @@
       return true;
     }
 
-    /**
-     * @protected
-     * @param {Number} lineIndex
-     * @param {Number} charIndex
-     * @return {TextStyleDeclaration} a style object reference to the existing one or a new empty object when undefined
+    /**
+     * @protected
+     * @param {Number} lineIndex
+     * @param {Number} charIndex
+     * @return {TextStyleDeclaration} a style object reference to the existing one or a new empty object when undefined
      */
     _getStyleDeclaration(lineIndex, charIndex) {
       if (this._styleMap && !this.isWrapping) {
@@ -26935,59 +26991,59 @@
       return super._getStyleDeclaration(lineIndex, charIndex);
     }
 
-    /**
-     * @param {Number} lineIndex
-     * @param {Number} charIndex
-     * @param {Object} style
-     * @private
+    /**
+     * @param {Number} lineIndex
+     * @param {Number} charIndex
+     * @param {Object} style
+     * @private
      */
     _setStyleDeclaration(lineIndex, charIndex, style) {
       const map = this._styleMap[lineIndex];
       super._setStyleDeclaration(map.line, map.offset + charIndex, style);
     }
 
-    /**
-     * @param {Number} lineIndex
-     * @param {Number} charIndex
-     * @private
+    /**
+     * @param {Number} lineIndex
+     * @param {Number} charIndex
+     * @private
      */
     _deleteStyleDeclaration(lineIndex, charIndex) {
       const map = this._styleMap[lineIndex];
       super._deleteStyleDeclaration(map.line, map.offset + charIndex);
     }
 
-    /**
-     * probably broken need a fix
-     * Returns the real style line that correspond to the wrapped lineIndex line
-     * Used just to verify if the line does exist or not.
-     * @param {Number} lineIndex
-     * @returns {Boolean} if the line exists or not
-     * @private
+    /**
+     * probably broken need a fix
+     * Returns the real style line that correspond to the wrapped lineIndex line
+     * Used just to verify if the line does exist or not.
+     * @param {Number} lineIndex
+     * @returns {Boolean} if the line exists or not
+     * @private
      */
     _getLineStyle(lineIndex) {
       const map = this._styleMap[lineIndex];
       return !!this.styles[map.line];
     }
 
-    /**
-     * Set the line style to an empty object so that is initialized
-     * @param {Number} lineIndex
-     * @param {Object} style
-     * @private
+    /**
+     * Set the line style to an empty object so that is initialized
+     * @param {Number} lineIndex
+     * @param {Object} style
+     * @private
      */
     _setLineStyle(lineIndex) {
       const map = this._styleMap[lineIndex];
       super._setLineStyle(map.line);
     }
 
-    /**
-     * Wraps text using the 'width' property of Textbox. First this function
-     * splits text on newlines, so we preserve newlines entered by the user.
-     * Then it wraps each line using the width of the Textbox by calling
-     * _wrapLine().
-     * @param {Array} lines The string array of text that is split into lines
-     * @param {Number} desiredWidth width you want to wrap to
-     * @returns {Array} Array of lines
+    /**
+     * Wraps text using the 'width' property of Textbox. First this function
+     * splits text on newlines, so we preserve newlines entered by the user.
+     * Then it wraps each line using the width of the Textbox by calling
+     * _wrapLine().
+     * @param {Array} lines The string array of text that is split into lines
+     * @param {Number} desiredWidth width you want to wrap to
+     * @returns {Array} Array of lines
      */
     _wrapText(lines, desiredWidth) {
       this.isWrapping = true;
@@ -27001,12 +27057,12 @@
       return wrapped;
     }
 
-    /**
-     * For each line of text terminated by an hard line stop,
-     * measure each word width and extract the largest word from all.
-     * The returned words here are the one that at the end will be rendered.
-     * @param {string[]} lines the lines we need to measure
-     *
+    /**
+     * For each line of text terminated by an hard line stop,
+     * measure each word width and extract the largest word from all.
+     * The returned words here are the one that at the end will be rendered.
+     * @param {string[]} lines the lines we need to measure
+     *
      */
     getGraphemeDataForRender(lines) {
       const splitByGrapheme = this.splitByGrapheme,
@@ -27039,17 +27095,17 @@
       };
     }
 
-    /**
-     * Helper function to measure a string of text, given its lineIndex and charIndex offset
-     * It gets called when charBounds are not available yet.
-     * Override if necessary
-     * Use with {@link Textbox#wordSplit}
-     *
-     * @param {CanvasRenderingContext2D} ctx
-     * @param {String} text
-     * @param {number} lineIndex
-     * @param {number} charOffset
-     * @returns {number}
+    /**
+     * Helper function to measure a string of text, given its lineIndex and charIndex offset
+     * It gets called when charBounds are not available yet.
+     * Override if necessary
+     * Use with {@link Textbox#wordSplit}
+     *
+     * @param {CanvasRenderingContext2D} ctx
+     * @param {String} text
+     * @param {number} lineIndex
+     * @param {number} charOffset
+     * @returns {number}
      */
     _measureWord(word, lineIndex) {
       let charOffset = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
@@ -27064,26 +27120,26 @@
       return width;
     }
 
-    /**
-     * Override this method to customize word splitting
-     * Use with {@link Textbox#_measureWord}
-     * @param {string} value
-     * @returns {string[]} array of words
+    /**
+     * Override this method to customize word splitting
+     * Use with {@link Textbox#_measureWord}
+     * @param {string} value
+     * @returns {string[]} array of words
      */
     wordSplit(value) {
       return value.split(this._wordJoiners);
     }
 
-    /**
-     * Wraps a line of text using the width of the Textbox as desiredWidth
-     * and leveraging the known width o words from GraphemeData
-     * @private
-     * @param {Number} lineIndex
-     * @param {Number} desiredWidth width you want to wrap the line to
-     * @param {GraphemeData} graphemeData an object containing all the lines' words width.
-     * @param {Number} reservedSpace space to remove from wrapping for custom functionalities
-     * @returns {Array} Array of line(s) into which the given text is wrapped
-     * to.
+    /**
+     * Wraps a line of text using the width of the Textbox as desiredWidth
+     * and leveraging the known width o words from GraphemeData
+     * @private
+     * @param {Number} lineIndex
+     * @param {Number} desiredWidth width you want to wrap the line to
+     * @param {GraphemeData} graphemeData an object containing all the lines' words width.
+     * @param {Number} reservedSpace space to remove from wrapping for custom functionalities
+     * @returns {Array} Array of line(s) into which the given text is wrapped
+     * to.
      */
     _wrapLine(lineIndex, desiredWidth, _ref) {
       let {
@@ -27165,11 +27221,11 @@
       return graphemeLines;
     }
 
-    /**
-     * Detect if the text line is ended with an hard break
-     * text and itext do not have wrapping, return false
-     * @param {Number} lineIndex text to split
-     * @return {Boolean}
+    /**
+     * Detect if the text line is ended with an hard break
+     * text and itext do not have wrapping, return false
+     * @param {Number} lineIndex text to split
+     * @return {Boolean}
      */
     isEndOfWrapping(lineIndex) {
       if (!this._styleMap[lineIndex + 1]) {
@@ -27183,12 +27239,12 @@
       return false;
     }
 
-    /**
-     * Detect if a line has a linebreak and so we need to account for it when moving
-     * and counting style.
-     * This is important only for splitByGrapheme at the end of wrapping.
-     * If we are not wrapping the offset is always 1
-     * @return Number
+    /**
+     * Detect if a line has a linebreak and so we need to account for it when moving
+     * and counting style.
+     * This is important only for splitByGrapheme at the end of wrapping.
+     * If we are not wrapping the offset is always 1
+     * @return Number
      */
     missingNewlineOffset(lineIndex, skipWrapping) {
       if (this.splitByGrapheme && !skipWrapping) {
@@ -27197,12 +27253,12 @@
       return 1;
     }
 
-    /**
-     * Gets lines of text to render in the Textbox. This function calculates
-     * text wrapping on the fly every time it is called.
-     * @param {String} text text to split
-     * @returns {Array} Array of lines in the Textbox.
-     * @override
+    /**
+     * Gets lines of text to render in the Textbox. This function calculates
+     * text wrapping on the fly every time it is called.
+     * @param {String} text text to split
+     * @returns {Array} Array of lines in the Textbox.
+     * @override
      */
     _splitTextIntoLines(text) {
       // Check if we need browser wrapping using smart font detection
@@ -27249,9 +27305,9 @@
       return newText;
     }
 
-    /**
-     * Use browser's native text wrapping for accurate handling of fonts without English glyphs
-     * @private
+    /**
+     * Use browser's native text wrapping for accurate handling of fonts without English glyphs
+     * @private
      */
     _splitTextIntoLinesWithBrowser(text) {
       if (typeof document === 'undefined') {
@@ -27377,9 +27433,9 @@
       };
     }
 
-    /**
-     * Extract justify space measurements from browser
-     * @private
+    /**
+     * Extract justify space measurements from browser
+     * @private
      */
     _extractJustifySpaceMeasurements(element, lines) {
       console.log(`🔤 Extracting browser justify space measurements for ${lines.length} lines`);
@@ -27415,9 +27471,9 @@
       return spaceWidths;
     }
 
-    /**
-     * Apply browser-calculated justify space measurements
-     * @private
+    /**
+     * Apply browser-calculated justify space measurements
+     * @private
      */
     _applyBrowserJustifySpaces() {
       if (!this._textLines || !this.__charBounds) {
@@ -27454,9 +27510,9 @@
       });
     }
 
-    /**
-     * Fallback to default Fabric wrapping
-     * @private
+    /**
+     * Fallback to default Fabric wrapping
+     * @private
      */
     _splitTextIntoLinesDefault(text) {
       const newText = super._splitTextIntoLines(text),
@@ -27488,9 +27544,9 @@
       }
     }
 
-    /**
-     * Initialize event listeners for safety snap functionality
-     * @private
+    /**
+     * Initialize event listeners for safety snap functionality
+     * @private
      */
     initializeEventListeners() {
       var _this$canvas4;
@@ -27533,12 +27589,12 @@
       });
     }
 
-    /**
-     * Safety snap to prevent glyph clipping after manual resize.
-     * Similar to Polotno - checks if any glyphs are too close to edges
-     * and automatically expands width if needed.
-     * @private
-     * @param resizeOrigin - Which side was used for resizing ('left' or 'right')
+    /**
+     * Safety snap to prevent glyph clipping after manual resize.
+     * Similar to Polotno - checks if any glyphs are too close to edges
+     * and automatically expands width if needed.
+     * @private
+     * @param resizeOrigin - Which side was used for resizing ('left' or 'right')
      */
     safetySnapWidth(resizeOrigin) {
       // For Textbox objects, we always want to check for clipping regardless of isWrapping flag
@@ -27605,9 +27661,9 @@
       }
     }
 
-    /**
-     * Fix character selection mismatch after JSON loading for browser-wrapped fonts
-     * @private
+    /**
+     * Fix character selection mismatch after JSON loading for browser-wrapped fonts
+     * @private
      */
     _fixCharacterMappingAfterJsonLoad() {
       if (this._usingBrowserWrapping) {
@@ -27627,9 +27683,9 @@
       }
     }
 
-    /**
-     * Force complete textbox re-initialization (useful after JSON loading)
-     * Overrides Text version with Textbox-specific logic
+    /**
+     * Force complete textbox re-initialization (useful after JSON loading)
+     * Overrides Text version with Textbox-specific logic
      */
     forceTextReinitialization() {
       console.log('🔄 Force reinitializing Textbox object');
@@ -27686,31 +27742,31 @@
       }
     }
 
-    /**
-     * Returns object representation of an instance
-     * @param {Array} [propertiesToInclude] Any properties that you might want to additionally include in the output
-     * @return {Object} object representation of an instance
+    /**
+     * Returns object representation of an instance
+     * @param {Array} [propertiesToInclude] Any properties that you might want to additionally include in the output
+     * @return {Object} object representation of an instance
      */
     toObject() {
       let propertiesToInclude = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
       return super.toObject(['minWidth', 'splitByGrapheme', ...propertiesToInclude]);
     }
   }
-  /**
-   * Minimum width of textbox, in pixels.
-   * @type Number
-   */
-  /**
-   * Minimum calculated width of a textbox, in pixels.
-   * fixed to 2 so that an empty textbox cannot go to 0
-   * and is still selectable without text.
-   * @type Number
-   */
-  /**
-   * Use this boolean property in order to split strings that have no white space concept.
-   * this is a cheap way to help with chinese/japanese
-   * @type Boolean
-   * @since 2.6.0
+  /**
+   * Minimum width of textbox, in pixels.
+   * @type Number
+   */
+  /**
+   * Minimum calculated width of a textbox, in pixels.
+   * fixed to 2 so that an empty textbox cannot go to 0
+   * and is still selectable without text.
+   * @type Number
+   */
+  /**
+   * Use this boolean property in order to split strings that have no white space concept.
+   * this is a cheap way to help with chinese/japanese
+   * @type Boolean
+   * @since 2.6.0
    */
   _defineProperty(Textbox, "type", 'Textbox');
   _defineProperty(Textbox, "textLayoutProperties", [...IText.textLayoutProperties, 'width']);