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

package/dist/index.node.cjs

@@ -412,7 +412,7 @@ class Cache {
 }
 const cache = new Cache();
 
-var version = "7.0.1-beta10";
+var version = "7.0.1-beta11";
 
 // use this syntax so babel plugin see this import here
 const VERSION = version;
@@ -4859,7 +4859,7 @@ const TEXT_DECORATION_THICKNESS = 'textDecorationThickness';
 const fontProperties = ['fontSize', 'fontWeight', 'fontFamily', 'fontStyle'];
 const textDecorationProperties = ['underline', 'overline', 'linethrough'];
 const textLayoutProperties = [...fontProperties, 'lineHeight', 'text', 'charSpacing', 'textAlign', 'styles', 'path', 'pathStartOffset', 'pathSide', 'pathAlign', 'wrap', 'ellipsis', 'letterSpacing', 'enableAdvancedLayout', 'verticalAlign'];
-const additionalProps = [...textLayoutProperties, ...textDecorationProperties, 'textBackgroundColor', 'direction', TEXT_DECORATION_THICKNESS];
+const additionalProps = [...textLayoutProperties, ...textDecorationProperties, 'textBackgroundColor', 'direction', TEXT_DECORATION_THICKNESS, 'useOverlayEditing'];
 const styleProperties = [...fontProperties, ...textDecorationProperties, STROKE, 'strokeWidth', FILL, 'deltaY', 'textBackgroundColor', TEXT_DECORATION_THICKNESS];
 
 // @TODO: Many things here are configuration related and shouldn't be on the class nor prototype
@@ -19241,8 +19241,8 @@ _defineProperty(StyledText, "_styleProperties", styleProperties);
 // 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) {
@@ -19255,8 +19255,8 @@ function getMeasurementContext() {
   return measurementContext;
 }
 
-/**
- * Measure a single grapheme
+/**
+ * Measure a single grapheme
  */
 function measureGrapheme(grapheme, options, ctx) {
   // Check cache first
@@ -19289,8 +19289,8 @@ function measureGrapheme(grapheme, options, ctx) {
   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
@@ -19331,9 +19331,9 @@ function measureGraphemeWithKerning(grapheme, previousGrapheme, options, ctx) {
   };
 }
 
-/**
- * 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();
@@ -19422,8 +19422,8 @@ function getRepresentativeCharacter(fontFamily) {
   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;
@@ -19459,8 +19459,8 @@ function getFontMetrics(options) {
   return result;
 }
 
-/**
- * Apply font styling to canvas context
+/**
+ * Apply font styling to canvas context
  */
 function applyFontStyle(ctx, options) {
   const fontDeclaration = getFontDeclaration(options);
@@ -19477,8 +19477,8 @@ function applyFontStyle(ctx, options) {
   ctx.textBaseline = 'alphabetic';
 }
 
-/**
- * Generate font declaration string
+/**
+ * Generate font declaration string
  */
 function getFontDeclaration(options) {
   const {
@@ -19497,8 +19497,8 @@ function getFontDeclaration(options) {
   return `${fontStyle} ${fontWeight} ${fontSize}px ${normalizedFamily}`;
 }
 
-/**
- * LRU Cache implementation for measurements
+/**
+ * LRU Cache implementation for measurements
  */
 class LRUCache {
   constructor() {
@@ -19560,8 +19560,8 @@ class LRUCache {
   }
 }
 
-/**
- * Advanced measurement cache with font-aware keys
+/**
+ * Advanced measurement cache with font-aware keys
  */
 class MeasurementCache {
   constructor() {
@@ -19588,8 +19588,8 @@ class MeasurementCache {
   }
 }
 
-/**
- * Kerning cache for character pairs
+/**
+ * Kerning cache for character pairs
  */
 class KerningCache {
   constructor() {
@@ -19617,8 +19617,8 @@ class KerningCache {
   }
 }
 
-/**
- * Font metrics cache
+/**
+ * Font metrics cache
  */
 class FontMetricsCache {
   constructor() {
@@ -19653,8 +19653,8 @@ if (typeof document !== 'undefined' && 'fonts' in document) {
   });
 }
 
-/**
- * Clear all measurement caches
+/**
+ * Clear all measurement caches
  */
 function clearAllCaches() {
   measurementCache.clear();
@@ -19662,9 +19662,9 @@ function clearAllCaches() {
   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;
@@ -19708,8 +19708,8 @@ function fontLacksEnglishGlyphs(fontFamily) {
 // 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)) {
@@ -19720,17 +19720,17 @@ function fontLacksEnglishGlyphsCached(fontFamily) {
   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
@@ -19750,15 +19750,15 @@ function segmentGraphemes(text) {
   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 {
@@ -19828,8 +19828,8 @@ function applyEllipsis(text, options) {
   };
 }
 
-/**
- * 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);
@@ -19879,8 +19879,8 @@ function truncateByWidth(text, maxWidth, ellipsisChar, ellipsisWidth, measureFn)
   };
 }
 
-/**
- * Truncate text based on height constraint
+/**
+ * Truncate text based on height constraint
  */
 function truncateByHeight(text, maxHeight, ellipsisChar, measureFn) {
   var _measureFn;
@@ -19928,19 +19928,19 @@ function truncateByHeight(text, maxHeight, ellipsisChar, measureFn) {
   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;
@@ -20059,8 +20059,8 @@ function layoutText(options) {
   };
 }
 
-/**
- * Layout a single paragraph with wrapping
+/**
+ * Layout a single paragraph with wrapping
  */
 function layoutParagraph(text, options) {
   const {
@@ -20095,8 +20095,8 @@ function layoutParagraph(text, options) {
   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;
@@ -20166,8 +20166,8 @@ function layoutSingleLine(text, options) {
   };
 }
 
-/**
- * Word-based wrapping algorithm
+/**
+ * Word-based wrapping algorithm
  */
 function wrapByWords(text, maxWidth, options) {
   const lines = [];
@@ -20200,8 +20200,8 @@ function wrapByWords(text, maxWidth, options) {
   return lines.length > 0 ? lines : [''];
 }
 
-/**
- * Character-based wrapping algorithm  
+/**
+ * Character-based wrapping algorithm  
  */
 function wrapByCharacters(text, maxWidth, options) {
   const lines = [];
@@ -20223,8 +20223,8 @@ function wrapByCharacters(text, maxWidth, options) {
   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 => {
@@ -20258,8 +20258,8 @@ function applyAlignment(lines, align, containerWidth, options) {
   });
 }
 
-/**
- * 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;
@@ -20282,8 +20282,8 @@ function applyJustification(line, containerWidth, options) {
   return line;
 }
 
-/**
- * Calculate vertical alignment offset
+/**
+ * Calculate vertical alignment offset
  */
 function calculateVerticalOffset(contentHeight, containerHeight, align) {
   switch (align) {
@@ -20297,8 +20297,8 @@ function calculateVerticalOffset(contentHeight, containerHeight, align) {
   }
 }
 
-/**
- * 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
@@ -20327,8 +20327,8 @@ function handleHeightOverflow(existingLines, overflowLine, remainingHeight, opti
   };
 }
 
-/**
- * Create empty line for empty paragraphs
+/**
+ * Create empty line for empty paragraphs
  */
 function createEmptyLine(options) {
   const height = options.fontSize * options.lineHeight;
@@ -20344,8 +20344,8 @@ function createEmptyLine(options) {
   };
 }
 
-/**
- * Measure width of a line of text
+/**
+ * Measure width of a line of text
  */
 function measureLineWidth(text, options) {
   const graphemes = segmentGraphemes(text);
@@ -20362,8 +20362,8 @@ function measureLineWidth(text, options) {
   return width;
 }
 
-/**
- * Convert layout options to measurement options
+/**
+ * Convert layout options to measurement options
  */
 function createMeasurementOptions(options) {
   return {
@@ -20606,15 +20606,15 @@ class TextSVGExportMixin extends FabricObjectSVGExportMixin {
   }
 }
 
-/**
- * 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) {
@@ -20628,9 +20628,9 @@ function segmentIntoGraphemes(text) {
   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;
@@ -20725,16 +20725,16 @@ function extractLinesFromDOM(textarea) {
   }
 }
 
-/**
- * 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) {
@@ -20744,24 +20744,24 @@ function areBrowserLinesValid(target, storedHash) {
   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;
@@ -20774,9 +20774,9 @@ function getBrowserLines(target) {
 
 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) {
@@ -20789,17 +20789,17 @@ function getMeasuringContext() {
   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() {
@@ -20810,11 +20810,11 @@ class FabricText extends StyledText {
   }
   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);
@@ -20831,9 +20831,9 @@ class FabricText extends StyledText {
     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;
@@ -20842,10 +20842,10 @@ class FabricText extends StyledText {
     }
   }
 
-  /**
-   * @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
@@ -20861,9 +20861,9 @@ class FabricText extends StyledText {
     return newLines;
   }
 
-  /**
-   * Create TextLinesInfo from browser-extracted lines
-   * @private
+  /**
+   * Create TextLinesInfo from browser-extracted lines
+   * @private
    */
   _splitTextFromBrowserLines(browserLines) {
     const lines = [];
@@ -20897,10 +20897,10 @@ class FabricText extends StyledText {
     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
@@ -20946,8 +20946,8 @@ class FabricText extends StyledText {
     }
   }
 
-  /**
-   * Enlarge space boxes and shift the others
+  /**
+   * Enlarge space boxes and shift the others
    */
   enlargeSpaces() {
     let diffSpace, currentLineWidth, numberOfSpaces, accumulatedSpace, line, charBound, spaces;
@@ -21009,18 +21009,18 @@ class FabricText extends StyledText {
     }
   }
 
-  /**
-   * 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 {
@@ -21042,9 +21042,9 @@ class FabricText extends StyledText {
     };
   }
 
-  /**
-   * Map Fabric textAlign to Konva align format
-   * @private
+  /**
+   * Map Fabric textAlign to Konva align format
+   * @private
    */
   _mapTextAlignToAlign(textAlign) {
     switch (textAlign) {
@@ -21065,8 +21065,8 @@ class FabricText extends StyledText {
     }
   }
 
-  /**
-   * Enhanced initDimensions that uses advanced layout when enabled
+  /**
+   * Enhanced initDimensions that uses advanced layout when enabled
    */
   initDimensionsAdvanced() {
     if (!this.enableAdvancedLayout) {
@@ -21095,9 +21095,9 @@ class FabricText extends StyledText {
     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);
@@ -21119,30 +21119,30 @@ class FabricText extends StyledText {
     }
   }
 
-  /**
-   * 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;
@@ -21162,24 +21162,24 @@ class FabricText extends StyledText {
     };
   }
 
-  /**
-   * 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();
@@ -21189,9 +21189,9 @@ class FabricText extends StyledText {
     return dims;
   }
 
-  /**
-   * @private
-   * @param {CanvasRenderingContext2D} ctx Context to render on
+  /**
+   * @private
+   * @param {CanvasRenderingContext2D} ctx Context to render on
    */
   _render(ctx) {
     const path = this.path;
@@ -21204,9 +21204,9 @@ class FabricText extends StyledText {
     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
@@ -21222,15 +21222,15 @@ class FabricText extends StyledText {
     }
   }
 
-  /**
-   * 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';
@@ -21250,11 +21250,11 @@ class FabricText extends StyledText {
     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);
@@ -21267,23 +21267,23 @@ class FabricText extends StyledText {
     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')) {
@@ -21346,15 +21346,15 @@ class FabricText extends StyledText {
     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),
@@ -21399,19 +21399,19 @@ class FabricText extends StyledText {
     };
   }
 
-  /**
-   * 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);
@@ -21424,11 +21424,11 @@ class FabricText extends StyledText {
     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,
@@ -21491,13 +21491,13 @@ class FabricText extends StyledText {
     };
   }
 
-  /**
-   * 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,
@@ -21510,13 +21510,13 @@ class FabricText extends StyledText {
     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),
@@ -21544,10 +21544,10 @@ class FabricText extends StyledText {
     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]) {
@@ -21563,8 +21563,8 @@ class FabricText extends StyledText {
     return this.__lineHeights[lineIndex] = maxHeight * this.lineHeight * this._fontSizeMult;
   }
 
-  /**
-   * Calculate text box height
+  /**
+   * Calculate text box height
    */
   calcTextHeight() {
     let lineHeight,
@@ -21576,26 +21576,26 @@ class FabricText extends StyledText {
     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();
@@ -21612,9 +21612,9 @@ class FabricText extends StyledText {
     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)) {
@@ -21623,9 +21623,9 @@ class FabricText extends StyledText {
     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()) {
@@ -21642,14 +21642,14 @@ class FabricText extends StyledText {
     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),
@@ -21731,16 +21731,16 @@ class FabricText extends StyledText {
     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
@@ -21796,12 +21796,12 @@ class FabricText extends StyledText {
     };
   }
 
-  /**
-   * 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 {
@@ -21816,12 +21816,12 @@ class FabricText extends StyledText {
     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 {
@@ -21830,16 +21830,16 @@ class FabricText extends StyledText {
     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),
@@ -21868,30 +21868,30 @@ class FabricText extends StyledText {
     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),
@@ -21904,10 +21904,10 @@ class FabricText extends StyledText {
     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),
@@ -21957,8 +21957,8 @@ class FabricText extends StyledText {
     return leftOffset;
   }
 
-  /**
-   * @private
+  /**
+   * @private
    */
   _clearCache() {
     this._forceClearCache = false;
@@ -21967,12 +21967,12 @@ class FabricText extends StyledText {
     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) {
@@ -21991,12 +21991,12 @@ class FabricText extends StyledText {
     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;
@@ -22004,9 +22004,9 @@ class FabricText extends StyledText {
     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)) {
@@ -22090,10 +22090,10 @@ class FabricText extends StyledText {
     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 {
@@ -22119,9 +22119,9 @@ class FabricText extends StyledText {
     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) {
@@ -22136,22 +22136,22 @@ class FabricText extends StyledText {
     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),
@@ -22177,18 +22177,18 @@ class FabricText extends StyledText {
     };
   }
 
-  /**
-   * 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] : [];
@@ -22231,23 +22231,23 @@ class FabricText extends StyledText {
     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);
@@ -22286,10 +22286,10 @@ class FabricText extends StyledText {
       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;
@@ -22307,9 +22307,9 @@ class FabricText extends StyledText {
 
   /* _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)) {
@@ -22322,9 +22322,9 @@ class FabricText extends StyledText {
     }
   }
 
-  /**
-   * Schedule re-initialization after font loads
-   * @private
+  /**
+   * Schedule re-initialization after font loads
+   * @private
    */
   _scheduleInitAfterFontLoad() {
     if (typeof document === 'undefined' || !('fonts' in document)) {
@@ -22360,8 +22360,8 @@ class FabricText extends StyledText {
     });
   }
 
-  /**
-   * 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');
@@ -22389,10 +22389,10 @@ class FabricText extends StyledText {
     }
   }
 
-  /**
-   * 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({
@@ -22437,6 +22437,10 @@ class FabricText extends StyledText {
             textObject._usingBrowserWrapping = true;
             console.log(`🔤 STV font: Forcing browser wrapping flag during JSON load`);
 
+            // Enable overlay editing for STV fonts to use native browser text handling
+            textObject.useOverlayEditing = true;
+            console.log(`🔤 STV font: Enabling overlay editing during JSON load`);
+
             // Multiple initialization attempts for STV fonts
             const reinitWithDelay = attempt => {
               if (textObject.forceTextReinitialization) {
@@ -22490,10 +22494,10 @@ class FabricText extends StyledText {
     });
   }
 }
-/**
- * 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]);
@@ -22501,9 +22505,9 @@ _defineProperty(FabricText, "ownDefaults", textDefaultValues);
 _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]);
@@ -22890,8 +22894,8 @@ class OverlayEditor {
     // 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;
@@ -22905,8 +22909,8 @@ class OverlayEditor {
     return container;
   }
 
-  /**
-   * Create the overlay DOM structure
+  /**
+   * Create the overlay DOM structure
    */
   createOverlayDOM() {
     // Host div for positioning and overflow control
@@ -22961,8 +22965,8 @@ class OverlayEditor {
     document.body.appendChild(this.hostDiv);
   }
 
-  /**
-   * Attach all event listeners
+  /**
+   * Attach all event listeners
    */
   attachEventListeners() {
     // Textarea events
@@ -22982,8 +22986,8 @@ class OverlayEditor {
     this.setupViewportChangeDetection();
   }
 
-  /**
-   * Remove all event listeners
+  /**
+   * Remove all event listeners
    */
   removeEventListeners() {
     this.textarea.removeEventListener('input', this.boundHandlers.onInput);
@@ -23000,16 +23004,16 @@ class OverlayEditor {
     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;
@@ -23043,15 +23047,15 @@ class OverlayEditor {
     }
   }
 
-  /**
-   * 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
@@ -23288,8 +23292,8 @@ class OverlayEditor {
     // 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;
@@ -23359,8 +23363,8 @@ class OverlayEditor {
     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;
@@ -23445,8 +23449,8 @@ class OverlayEditor {
     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"
@@ -23486,8 +23490,8 @@ class OverlayEditor {
     this.canvas.requestRenderAll();
   }
 
-  /**
-   * Refresh overlay positioning and styling
+  /**
+   * Refresh overlay positioning and styling
    */
   refresh() {
     if (this.isDestroyed) return;
@@ -23495,8 +23499,8 @@ class OverlayEditor {
     // 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;
@@ -23664,8 +23668,8 @@ class OverlayEditor {
     }
   }
 
-  /**
-   * Setup detection for viewport changes (zoom/pan)
+  /**
+   * Setup detection for viewport changes (zoom/pan)
    */
   setupViewportChangeDetection() {
     // Store original methods
@@ -23694,8 +23698,8 @@ class OverlayEditor {
     };
   }
 
-  /**
-   * Restore original viewport methods
+  /**
+   * Restore original viewport methods
    */
   restoreViewportChangeDetection() {
     if (this.canvas.__originalSetZoom) {
@@ -23710,8 +23714,8 @@ class OverlayEditor {
   }
 }
 
-/**
- * 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
@@ -23735,35 +23739,35 @@ function enterTextOverlayEdit(canvas, target, options) {
   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);
@@ -23776,8 +23780,8 @@ class ITextBehavior extends FabricText {
     return super.onDeselect(options);
   }
 
-  /**
-   * @private
+  /**
+   * @private
    */
   _animateCursor(_ref) {
     let {
@@ -23802,8 +23806,8 @@ class ITextBehavior extends FabricText {
     });
   }
 
-  /**
-   * changes the cursor from visible to invisible
+  /**
+   * changes the cursor from visible to invisible
    */
   _tick(delay) {
     this._currentTickState = this._animateCursor({
@@ -23814,8 +23818,8 @@ class ITextBehavior extends FabricText {
     });
   }
 
-  /**
-   * Changes the cursor from invisible to visible
+  /**
+   * Changes the cursor from invisible to visible
    */
   _onTickComplete() {
     var _this$_currentTickCom;
@@ -23827,16 +23831,16 @@ class ITextBehavior extends FabricText {
     });
   }
 
-  /**
-   * 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;
@@ -23854,9 +23858,9 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * 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())) {
@@ -23864,8 +23868,8 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * Selects entire text
+  /**
+   * Selects entire text
    */
   selectAll() {
     this.selectionStart = 0;
@@ -23875,26 +23879,26 @@ class ITextBehavior extends FabricText {
     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,
@@ -23914,10 +23918,10 @@ class ITextBehavior extends FabricText {
     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,
@@ -23937,10 +23941,10 @@ class ITextBehavior extends FabricText {
     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,
@@ -23952,10 +23956,10 @@ class ITextBehavior extends FabricText {
     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,
@@ -23967,11 +23971,11 @@ class ITextBehavior extends FabricText {
     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;
@@ -23989,9 +23993,9 @@ class ITextBehavior extends FabricText {
     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;
@@ -24007,9 +24011,9 @@ class ITextBehavior extends FabricText {
     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;
@@ -24021,8 +24025,8 @@ class ITextBehavior extends FabricText {
     this._updateTextarea();
   }
 
-  /**
-   * Enters editing state
+  /**
+   * Enters editing state
    */
   enterEditing(e) {
     if (this.isEditing || !this.editable) {
@@ -24042,8 +24046,8 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * 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) {
@@ -24067,8 +24071,8 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * Enter overlay editing mode using DOM textarea overlay
+  /**
+   * Enter overlay editing mode using DOM textarea overlay
    */
   enterOverlayEditing() {
     this._saveEditingProps();
@@ -24089,8 +24093,8 @@ class ITextBehavior extends FabricText {
     });
   }
 
-  /**
-   * Commit overlay editing changes
+  /**
+   * Commit overlay editing changes
    */
   commitOverlayEdit(text) {
     const overlayEditor = this.__overlayEditor;
@@ -24114,8 +24118,8 @@ class ITextBehavior extends FabricText {
     this.canvas && this.canvas.requestRenderAll();
   }
 
-  /**
-   * Cancel overlay editing without changes
+  /**
+   * Cancel overlay editing without changes
    */
   cancelOverlayEdit() {
     // Restore original text
@@ -24123,8 +24127,8 @@ class ITextBehavior extends FabricText {
     this.exitEditing();
   }
 
-  /**
-   * called by {@link Canvas#textEditingManager}
+  /**
+   * called by {@link Canvas#textEditingManager}
    */
   updateSelectionOnMouseMove(e) {
     if (this.getActiveControl()) {
@@ -24152,8 +24156,8 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * @private
+  /**
+   * @private
    */
   _setEditingProps() {
     this.hoverCursor = 'text';
@@ -24165,8 +24169,8 @@ class ITextBehavior extends FabricText {
     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),
@@ -24185,8 +24189,8 @@ class ITextBehavior extends FabricText {
     };
   }
 
-  /**
-   * convert from fabric to textarea values
+  /**
+   * convert from fabric to textarea values
    */
   fromGraphemeToStringSelection(start, end, graphemes) {
     const smallerTextStart = graphemes.slice(0, start),
@@ -24205,8 +24209,8 @@ class ITextBehavior extends FabricText {
     };
   }
 
-  /**
-   * @private
+  /**
+   * @private
    */
   _updateTextarea() {
     console.log('🔤 _updateTextarea called with fabric text:', this.text);
@@ -24231,8 +24235,8 @@ class ITextBehavior extends FabricText {
     this.updateTextareaPosition();
   }
 
-  /**
-   * @private
+  /**
+   * @private
    */
   updateFromTextArea() {
     if (!this.hiddenTextarea) {
@@ -24252,8 +24256,8 @@ class ITextBehavior extends FabricText {
     this.updateTextareaPosition();
   }
 
-  /**
-   * @private
+  /**
+   * @private
    */
   updateTextareaPosition() {
     if (this.selectionStart === this.selectionEnd) {
@@ -24263,9 +24267,9 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * @private
-   * @return {Object} style contains style for hiddenTextarea
+  /**
+   * @private
+   * @return {Object} style contains style for hiddenTextarea
    */
   _calcTextareaPosition() {
     if (!this.canvas) {
@@ -24312,8 +24316,8 @@ class ITextBehavior extends FabricText {
     };
   }
 
-  /**
-   * @private
+  /**
+   * @private
    */
   _saveEditingProps() {
     this._savedProps = {
@@ -24330,8 +24334,8 @@ class ITextBehavior extends FabricText {
     };
   }
 
-  /**
-   * @private
+  /**
+   * @private
    */
   _restoreEditingProps() {
     if (!this._savedProps) {
@@ -24351,9 +24355,9 @@ class ITextBehavior extends FabricText {
     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;
@@ -24374,8 +24378,8 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * Exits from editing state and fires relevant events
+  /**
+   * Exits from editing state and fires relevant events
    */
   exitEditing() {
     const isTextChanged = this._textBeforeEdit !== this.text;
@@ -24394,8 +24398,8 @@ class ITextBehavior extends FabricText {
     return this;
   }
 
-  /**
-   * @private
+  /**
+   * @private
    */
   _removeExtraneousStyles() {
     for (const prop in this.styles) {
@@ -24405,10 +24409,10 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * 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 {
@@ -24461,10 +24465,10 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * 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);
@@ -24479,15 +24483,15 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * 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 = {};
@@ -24547,12 +24551,12 @@ class ITextBehavior extends FabricText {
     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) {
@@ -24601,11 +24605,11 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * 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),
@@ -24646,12 +24650,12 @@ class ITextBehavior extends FabricText {
     }
   }
 
-  /**
-   * 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;
@@ -24664,17 +24668,17 @@ class ITextBehavior extends FabricText {
     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;
@@ -24691,9 +24695,9 @@ class ITextBehavior extends FabricText {
     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) {
@@ -24724,36 +24728,36 @@ class ITextBehavior extends FabricText {
 }
 
 class ITextKeyBehavior extends ITextBehavior {
-  /**
-   * For functionalities on keyDown
-   * Map a special key to a function of the instance/prototype
-   * If you need different behavior for ESC or TAB or arrows, you have to change
-   * this map setting the name of a function that you build on the IText or
-   * your prototype.
-   * the map change will affect all Instances unless you need for only some text Instances
-   * in that case you have to clone this object and assign your Instance.
-   * this.keysMap = Object.assign({}, this.keysMap);
-   * The function must be in IText.prototype.myFunction And will receive event as args[0]
+  /**
+   * For functionalities on keyDown
+   * Map a special key to a function of the instance/prototype
+   * If you need different behavior for ESC or TAB or arrows, you have to change
+   * this map setting the name of a function that you build on the IText or
+   * your prototype.
+   * the map change will affect all Instances unless you need for only some text Instances
+   * in that case you have to clone this object and assign your Instance.
+   * this.keysMap = Object.assign({}, this.keysMap);
+   * The function must be in IText.prototype.myFunction And will receive event as args[0]
    */
 
-  /**
-   * For functionalities on keyUp + ctrl || cmd
+  /**
+   * For functionalities on keyUp + ctrl || cmd
    */
 
-  /**
-   * For functionalities on keyDown + ctrl || cmd
+  /**
+   * For functionalities on keyDown + ctrl || cmd
    */
 
-  /**
-   * DOM container to append the hiddenTextarea.
-   * An alternative to attaching to the document.body.
-   * Useful to reduce laggish redraw of the full document.body tree and
-   * also with modals event capturing that won't let the textarea take focus.
-   * @type HTMLElement
+  /**
+   * DOM container to append the hiddenTextarea.
+   * An alternative to attaching to the document.body.
+   * Useful to reduce laggish redraw of the full document.body tree and
+   * also with modals event capturing that won't let the textarea take focus.
+   * @type HTMLElement
    */
 
-  /**
-   * Initializes hidden textarea (needed to bring up keyboard in iOS)
+  /**
+   * Initializes hidden textarea (needed to bring up keyboard in iOS)
    */
   initHiddenTextarea() {
     const doc = this.canvas && getDocumentFromElement(this.canvas.getElement()) || getFabricDocument();
@@ -24796,17 +24800,17 @@ class ITextKeyBehavior extends ITextBehavior {
     this.hiddenTextarea = textarea;
   }
 
-  /**
-   * Override this method to customize cursor behavior on textbox blur
+  /**
+   * Override this method to customize cursor behavior on textbox blur
    */
   blur() {
     this.abortCursorAnimation();
   }
 
-  /**
-   * Handles keydown event
-   * only used for arrows and combination of modifier keys.
-   * @param {KeyboardEvent} e Event object
+  /**
+   * Handles keydown event
+   * only used for arrows and combination of modifier keys.
+   * @param {KeyboardEvent} e Event object
    */
   onKeyDown(e) {
     if (!this.isEditing) {
@@ -24832,11 +24836,11 @@ class ITextKeyBehavior extends ITextBehavior {
     }
   }
 
-  /**
-   * Handles keyup event
-   * We handle KeyUp because ie11 and edge have difficulties copy/pasting
-   * if a copy/cut event fired, keyup is dismissed
-   * @param {KeyboardEvent} e Event object
+  /**
+   * Handles keyup event
+   * We handle KeyUp because ie11 and edge have difficulties copy/pasting
+   * if a copy/cut event fired, keyup is dismissed
+   * @param {KeyboardEvent} e Event object
    */
   onKeyUp(e) {
     if (!this.isEditing || this._copyDone || this.inCompositionMode) {
@@ -24853,9 +24857,9 @@ class ITextKeyBehavior extends ITextBehavior {
     this.canvas && this.canvas.requestRenderAll();
   }
 
-  /**
-   * Handles onInput event
-   * @param {Event} e Event object
+  /**
+   * Handles onInput event
+   * @param {Event} e Event object
    */
   onInput(e) {
     const fromPaste = this.fromPaste;
@@ -24992,15 +24996,15 @@ class ITextKeyBehavior extends ITextBehavior {
     updateAndFire();
   }
 
-  /**
-   * Composition start
+  /**
+   * Composition start
    */
   onCompositionStart() {
     this.inCompositionMode = true;
   }
 
-  /**
-   * Composition end
+  /**
+   * Composition end
    */
   onCompositionEnd() {
     this.inCompositionMode = false;
@@ -25018,8 +25022,8 @@ class ITextKeyBehavior extends ITextBehavior {
     this.updateTextareaPosition();
   }
 
-  /**
-   * Copies selected text
+  /**
+   * Copies selected text
    */
   copy() {
     if (this.selectionStart === this.selectionEnd) {
@@ -25038,19 +25042,19 @@ class ITextKeyBehavior extends ITextBehavior {
     this._copyDone = true;
   }
 
-  /**
-   * Pastes text
+  /**
+   * Pastes text
    */
   paste() {
     this.fromPaste = true;
   }
 
-  /**
-   * Finds the width in pixels before the cursor on the same line
-   * @private
-   * @param {Number} lineIndex
-   * @param {Number} charIndex
-   * @return {Number} widthBeforeCursor width before cursor
+  /**
+   * Finds the width in pixels before the cursor on the same line
+   * @private
+   * @param {Number} lineIndex
+   * @param {Number} charIndex
+   * @return {Number} widthBeforeCursor width before cursor
    */
   _getWidthBeforeCursor(lineIndex, charIndex) {
     let widthBeforeCursor = this._getLineLeftOffset(lineIndex),
@@ -25062,11 +25066,11 @@ class ITextKeyBehavior extends ITextBehavior {
     return widthBeforeCursor;
   }
 
-  /**
-   * Gets start offset of a selection
-   * @param {KeyboardEvent} e Event object
-   * @param {Boolean} isRight
-   * @return {Number}
+  /**
+   * Gets start offset of a selection
+   * @param {KeyboardEvent} e Event object
+   * @param {Boolean} isRight
+   * @return {Number}
    */
   getDownCursorOffset(e, isRight) {
     const selectionProp = this._getSelectionForOffset(e, isRight),
@@ -25084,12 +25088,12 @@ class ITextKeyBehavior extends ITextBehavior {
     return textAfterCursor.length + indexOnOtherLine + 1 + this.missingNewlineOffset(lineIndex);
   }
 
-  /**
-   * private
-   * Helps finding if the offset should be counted from Start or End
-   * @param {KeyboardEvent} e Event object
-   * @param {Boolean} isRight
-   * @return {Number}
+  /**
+   * private
+   * Helps finding if the offset should be counted from Start or End
+   * @param {KeyboardEvent} e Event object
+   * @param {Boolean} isRight
+   * @return {Number}
    */
   _getSelectionForOffset(e, isRight) {
     if (e.shiftKey && this.selectionStart !== this.selectionEnd && isRight) {
@@ -25099,10 +25103,10 @@ class ITextKeyBehavior extends ITextBehavior {
     }
   }
 
-  /**
-   * @param {KeyboardEvent} e Event object
-   * @param {Boolean} isRight
-   * @return {Number}
+  /**
+   * @param {KeyboardEvent} e Event object
+   * @param {Boolean} isRight
+   * @return {Number}
    */
   getUpCursorOffset(e, isRight) {
     const selectionProp = this._getSelectionForOffset(e, isRight),
@@ -25121,9 +25125,9 @@ class ITextKeyBehavior extends ITextBehavior {
     return -this._textLines[lineIndex - 1].length + indexOnOtherLine - textBeforeCursor.length + (1 - missingNewlineOffset);
   }
 
-  /**
-   * for a given width it founds the matching character.
-   * @private
+  /**
+   * for a given width it founds the matching character.
+   * @private
    */
   _getIndexOnLine(lineIndex, width) {
     const line = this._textLines[lineIndex],
@@ -25153,9 +25157,9 @@ class ITextKeyBehavior extends ITextBehavior {
     return indexOnLine;
   }
 
-  /**
-   * Moves cursor down
-   * @param {KeyboardEvent} e Event object
+  /**
+   * Moves cursor down
+   * @param {KeyboardEvent} e Event object
    */
   moveCursorDown(e) {
     if (this.selectionStart >= this._text.length && this.selectionEnd >= this._text.length) {
@@ -25164,9 +25168,9 @@ class ITextKeyBehavior extends ITextBehavior {
     this._moveCursorUpOrDown('Down', e);
   }
 
-  /**
-   * Moves cursor up
-   * @param {KeyboardEvent} e Event object
+  /**
+   * Moves cursor up
+   * @param {KeyboardEvent} e Event object
    */
   moveCursorUp(e) {
     if (this.selectionStart === 0 && this.selectionEnd === 0) {
@@ -25175,10 +25179,10 @@ class ITextKeyBehavior extends ITextBehavior {
     this._moveCursorUpOrDown('Up', e);
   }
 
-  /**
-   * Moves cursor up or down, fires the events
-   * @param {String} direction 'Up' or 'Down'
-   * @param {KeyboardEvent} e Event object
+  /**
+   * Moves cursor up or down, fires the events
+   * @param {String} direction 'Up' or 'Down'
+   * @param {KeyboardEvent} e Event object
    */
   _moveCursorUpOrDown(direction, e) {
     const offset = this[`get${direction}CursorOffset`](e, this._selectionDirection === RIGHT);
@@ -25200,9 +25204,9 @@ class ITextKeyBehavior extends ITextBehavior {
     }
   }
 
-  /**
-   * Moves cursor with shift
-   * @param {Number} offset
+  /**
+   * Moves cursor with shift
+   * @param {Number} offset
    */
   moveCursorWithShift(offset) {
     const newSelection = this._selectionDirection === LEFT ? this.selectionStart + offset : this.selectionEnd + offset;
@@ -25210,9 +25214,9 @@ class ITextKeyBehavior extends ITextBehavior {
     return offset !== 0;
   }
 
-  /**
-   * Moves cursor up without shift
-   * @param {Number} offset
+  /**
+   * Moves cursor up without shift
+   * @param {Number} offset
    */
   moveCursorWithoutShift(offset) {
     if (offset < 0) {
@@ -25225,9 +25229,9 @@ class ITextKeyBehavior extends ITextBehavior {
     return offset !== 0;
   }
 
-  /**
-   * Moves cursor left
-   * @param {KeyboardEvent} e Event object
+  /**
+   * Moves cursor left
+   * @param {KeyboardEvent} e Event object
    */
   moveCursorLeft(e) {
     if (this.selectionStart === 0 && this.selectionEnd === 0) {
@@ -25236,11 +25240,11 @@ class ITextKeyBehavior extends ITextBehavior {
     this._moveCursorLeftOrRight('Left', e);
   }
 
-  /**
-   * @private
-   * @return {Boolean} true if a change happened
-   *
-   * @todo refactor not to use method name composition
+  /**
+   * @private
+   * @return {Boolean} true if a change happened
+   *
+   * @todo refactor not to use method name composition
    */
   _move(e, prop, direction) {
     let newValue;
@@ -25259,23 +25263,23 @@ class ITextKeyBehavior extends ITextBehavior {
     return false;
   }
 
-  /**
-   * @private
+  /**
+   * @private
    */
   _moveLeft(e, prop) {
     return this._move(e, prop, 'Left');
   }
 
-  /**
-   * @private
+  /**
+   * @private
    */
   _moveRight(e, prop) {
     return this._move(e, prop, 'Right');
   }
 
-  /**
-   * Moves cursor left without keeping selection
-   * @param {KeyboardEvent} e
+  /**
+   * Moves cursor left without keeping selection
+   * @param {KeyboardEvent} e
    */
   moveCursorLeftWithoutShift(e) {
     let change = true;
@@ -25290,9 +25294,9 @@ class ITextKeyBehavior extends ITextBehavior {
     return change;
   }
 
-  /**
-   * Moves cursor left while keeping selection
-   * @param {KeyboardEvent} e
+  /**
+   * Moves cursor left while keeping selection
+   * @param {KeyboardEvent} e
    */
   moveCursorLeftWithShift(e) {
     if (this._selectionDirection === RIGHT && this.selectionStart !== this.selectionEnd) {
@@ -25303,9 +25307,9 @@ class ITextKeyBehavior extends ITextBehavior {
     }
   }
 
-  /**
-   * Moves cursor right
-   * @param {KeyboardEvent} e Event object
+  /**
+   * Moves cursor right
+   * @param {KeyboardEvent} e Event object
    */
   moveCursorRight(e) {
     if (this.selectionStart >= this._text.length && this.selectionEnd >= this._text.length) {
@@ -25314,10 +25318,10 @@ class ITextKeyBehavior extends ITextBehavior {
     this._moveCursorLeftOrRight('Right', e);
   }
 
-  /**
-   * Moves cursor right or Left, fires event
-   * @param {String} direction 'Left', 'Right'
-   * @param {KeyboardEvent} e Event object
+  /**
+   * Moves cursor right or Left, fires event
+   * @param {String} direction 'Left', 'Right'
+   * @param {KeyboardEvent} e Event object
    */
   _moveCursorLeftOrRight(direction, e) {
     const actionName = `moveCursor${direction}${e.shiftKey ? 'WithShift' : 'WithoutShift'}`;
@@ -25332,9 +25336,9 @@ class ITextKeyBehavior extends ITextBehavior {
     }
   }
 
-  /**
-   * Moves cursor right while keeping selection
-   * @param {KeyboardEvent} e
+  /**
+   * Moves cursor right while keeping selection
+   * @param {KeyboardEvent} e
    */
   moveCursorRightWithShift(e) {
     if (this._selectionDirection === LEFT && this.selectionStart !== this.selectionEnd) {
@@ -25345,9 +25349,9 @@ class ITextKeyBehavior extends ITextBehavior {
     }
   }
 
-  /**
-   * Moves cursor right without keeping selection
-   * @param {KeyboardEvent} e Event object
+  /**
+   * Moves cursor right without keeping selection
+   * @param {KeyboardEvent} e Event object
    */
   moveCursorRightWithoutShift(e) {
     let changed = true;
@@ -25362,8 +25366,8 @@ class ITextKeyBehavior extends ITextBehavior {
   }
 }
 
-/**
- * `LEFT_CLICK === 0`
+/**
+ * `LEFT_CLICK === 0`
  */
 const notALeftClick = e => !!e.button;
 class ITextClickBehavior extends ITextKeyBehavior {
@@ -25381,36 +25385,36 @@ class ITextClickBehavior extends ITextKeyBehavior {
     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
@@ -25427,8 +25431,8 @@ class ITextClickBehavior extends ITextKeyBehavior {
     this.renderCursorOrSelection();
   }
 
-  /**
-   * Default handler for triple click, select a line
+  /**
+   * Default handler for triple click, select a line
    */
   tripleClickHandler(options) {
     if (!this.isEditing) {
@@ -25438,13 +25442,13 @@ class ITextClickBehavior extends ITextKeyBehavior {
     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 {
@@ -25472,9 +25476,9 @@ class ITextClickBehavior extends ITextKeyBehavior {
     this.selected || (this.selected = alreadySelected || this.isEditing);
   }
 
-  /**
-   * standard handler for mouse up, overridable
-   * @private
+  /**
+   * standard handler for mouse up, overridable
+   * @private
    */
   mouseUpHandler(_ref2) {
     let {
@@ -25505,9 +25509,9 @@ class ITextClickBehavior extends ITextKeyBehavior {
     }
   }
 
-  /**
-   * 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),
@@ -25525,10 +25529,10 @@ class ITextClickBehavior extends ITextKeyBehavior {
     }
   }
 
-  /**
-   * 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()));
@@ -25574,15 +25578,15 @@ class ITextClickBehavior extends ITextKeyBehavior {
   }
 }
 
-/**
- * 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) {
@@ -25626,8 +25630,8 @@ function hitTest(x, y, layout, options) {
   };
 }
 
-/**
- * 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) {
@@ -25674,8 +25678,8 @@ function getCursorRect(insertionIndex, layout, options) {
 
 // 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;
@@ -25698,8 +25702,8 @@ function findLineAtY(y, lines) {
   };
 }
 
-/**
- * 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) {
@@ -25805,8 +25809,8 @@ function findCharAtX(x, line, options) {
   };
 }
 
-/**
- * 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;
@@ -25825,8 +25829,8 @@ function calculateInsertionIndex(lineIndex, graphemeIndex, layout) {
   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;
@@ -25868,8 +25872,8 @@ function findPositionFromIndex(insertionIndex, layout) {
   };
 }
 
-/**
- * Calculate Y position of a line
+/**
+ * Calculate Y position of a line
  */
 function calculateLineY(lineIndex, layout, options) {
   let y = 0;
@@ -25972,48 +25976,48 @@ const iTextDefaultValues = {
 
 // @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() {
@@ -26028,10 +26032,10 @@ class IText extends ITextClickBehavior {
     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, {
@@ -26041,11 +26045,11 @@ class IText extends ITextClickBehavior {
     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) {
@@ -26060,28 +26064,28 @@ class IText extends ITextClickBehavior {
     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) {
@@ -26091,9 +26095,9 @@ class IText extends ITextClickBehavior {
     this._updateTextarea();
   }
 
-  /**
-   * Fires the even of selection changed
-   * @private
+  /**
+   * Fires the even of selection changed
+   * @private
    */
   _fireSelectionChanged() {
     this.fire('selection:changed');
@@ -26102,25 +26106,25 @@ class IText extends ITextClickBehavior {
     });
   }
 
-  /**
-   * 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;
@@ -26129,11 +26133,11 @@ class IText extends ITextClickBehavior {
     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;
@@ -26141,10 +26145,10 @@ class IText extends ITextClickBehavior {
     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;
@@ -26152,9 +26156,9 @@ class IText extends ITextClickBehavior {
     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);
@@ -26164,9 +26168,9 @@ class IText extends ITextClickBehavior {
     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;
@@ -26176,9 +26180,9 @@ class IText extends ITextClickBehavior {
     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) {
@@ -26234,12 +26238,12 @@ class IText extends ITextClickBehavior {
     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 = [];
@@ -26254,13 +26258,13 @@ class IText extends ITextClickBehavior {
     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;
@@ -26274,11 +26278,11 @@ class IText extends ITextClickBehavior {
     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) {
@@ -26290,9 +26294,9 @@ class IText extends ITextClickBehavior {
     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) {
@@ -26308,9 +26312,9 @@ class IText extends ITextClickBehavior {
     };
   }
 
-  /**
-   * 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) {
@@ -26324,9 +26328,9 @@ class IText extends ITextClickBehavior {
     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(),
@@ -26340,10 +26344,10 @@ class IText extends ITextClickBehavior {
     };
   }
 
-  /**
-   * 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,
@@ -26377,29 +26381,29 @@ class IText extends ITextClickBehavior {
     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;
@@ -26422,9 +26426,9 @@ class IText extends ITextClickBehavior {
     };
   }
 
-  /**
-   * 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 {
@@ -26440,10 +26444,10 @@ class IText extends ITextClickBehavior {
     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 = {
@@ -26453,8 +26457,8 @@ class IText extends ITextClickBehavior {
     this._renderSelection(ctx, selection, boundaries);
   }
 
-  /**
-   * Renders drag start text selection
+  /**
+   * Renders drag start text selection
    */
   renderDragSourceEffect() {
     const dragStartSelection = this.draggableTextDelegate.getDragStartSelection();
@@ -26465,12 +26469,12 @@ class IText extends ITextClickBehavior {
     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,
@@ -26532,34 +26536,34 @@ class IText extends ITextClickBehavior {
     }
   }
 
-  /**
-   * 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),
@@ -26575,52 +26579,52 @@ class IText extends ITextClickBehavior {
     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');
@@ -26642,11 +26646,11 @@ const textboxDefaultValues = {
 
 // @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() {
@@ -26656,10 +26660,10 @@ class Textbox extends IText {
     };
   }
 
-  /**
-   * 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, {
@@ -26669,10 +26673,10 @@ class Textbox extends IText {
     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 {
@@ -26680,11 +26684,11 @@ class Textbox extends IText {
     };
   }
 
-  /**
-   * 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) {
@@ -26828,9 +26832,9 @@ class Textbox extends IText {
     }
   }
 
-  /**
-   * 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)) {
@@ -26857,9 +26861,9 @@ class Textbox extends IText {
     });
   }
 
-  /**
-   * Advanced dimensions calculation using new layout engine
-   * @private
+  /**
+   * Advanced dimensions calculation using new layout engine
+   * @private
    */
   initDimensionsAdvanced() {
     if (!this.initialized) {
@@ -26914,9 +26918,9 @@ class Textbox extends IText {
     this.dirty = true;
   }
 
-  /**
-   * Generate style map from new layout format
-   * @private
+  /**
+   * Generate style map from new layout format
+   * @private
    */
   _generateStyleMapFromLayout(layout) {
     const map = {};
@@ -26938,12 +26942,12 @@ class Textbox extends IText {
     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,
@@ -26970,10 +26974,10 @@ class Textbox extends IText {
     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) {
@@ -26985,10 +26989,10 @@ class Textbox extends IText {
     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) {
@@ -27025,11 +27029,11 @@ class Textbox extends IText {
     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) {
@@ -27043,59 +27047,59 @@ class Textbox extends IText {
     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;
@@ -27109,12 +27113,12 @@ class Textbox extends IText {
     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,
@@ -27147,17 +27151,17 @@ class Textbox extends IText {
     };
   }
 
-  /**
-   * 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;
@@ -27172,26 +27176,26 @@ class Textbox extends IText {
     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 {
@@ -27273,11 +27277,11 @@ class Textbox extends IText {
     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]) {
@@ -27291,12 +27295,12 @@ class Textbox extends IText {
     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) {
@@ -27305,12 +27309,12 @@ class Textbox extends IText {
     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
@@ -27357,9 +27361,9 @@ class Textbox extends IText {
     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') {
@@ -27485,9 +27489,9 @@ class Textbox extends IText {
     };
   }
 
-  /**
-   * 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`);
@@ -27523,9 +27527,9 @@ class Textbox extends IText {
     return spaceWidths;
   }
 
-  /**
-   * Apply browser-calculated justify space measurements
-   * @private
+  /**
+   * Apply browser-calculated justify space measurements
+   * @private
    */
   _applyBrowserJustifySpaces() {
     if (!this._textLines || !this.__charBounds) {
@@ -27562,9 +27566,9 @@ class Textbox extends IText {
     });
   }
 
-  /**
-   * Fallback to default Fabric wrapping
-   * @private
+  /**
+   * Fallback to default Fabric wrapping
+   * @private
    */
   _splitTextIntoLinesDefault(text) {
     const newText = super._splitTextIntoLines(text),
@@ -27596,9 +27600,9 @@ class Textbox extends IText {
     }
   }
 
-  /**
-   * Initialize event listeners for safety snap functionality
-   * @private
+  /**
+   * Initialize event listeners for safety snap functionality
+   * @private
    */
   initializeEventListeners() {
     var _this$canvas4;
@@ -27641,12 +27645,12 @@ class Textbox extends IText {
     });
   }
 
-  /**
-   * 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
@@ -27713,9 +27717,9 @@ class Textbox extends IText {
     }
   }
 
-  /**
-   * 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) {
@@ -27735,9 +27739,9 @@ class Textbox extends IText {
     }
   }
 
-  /**
-   * 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');
@@ -27794,31 +27798,31 @@ class Textbox extends IText {
     }
   }
 
-  /**
-   * 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']);