@nasser-sw/fabric 7.0.0-beta1

package/dist/src/text/measure.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.min.mjs","sources":["../../../src/text/measure.ts"],"sourcesContent":["/**\r\n * Advanced Text Measurement System\r\n * \r\n * Provides precise text measurement with caching, font metrics,\r\n * and DPI awareness for optimal performance and accuracy.\r\n */\r\n\r\nimport { createCanvasElementFor } from '../util/misc/dom';\r\n\r\nexport interface MeasurementOptions {\r\n  fontFamily: string;\r\n  fontSize: number;\r\n  fontStyle: string;\r\n  fontWeight: string | number;\r\n  letterSpacing?: number;\r\n  direction?: 'ltr' | 'rtl';\r\n}\r\n\r\nexport interface GraphemeMeasurement {\r\n  width: number;\r\n  height: number;\r\n  ascent: number;\r\n  descent: number;\r\n  baseline: number;\r\n}\r\n\r\nexport interface KerningMeasurement extends GraphemeMeasurement {\r\n  kernedWidth: number; // width accounting for kerning with previous char\r\n}\r\n\r\nexport interface FontMetrics {\r\n  ascent: number;\r\n  descent: number;\r\n  lineHeight: number;\r\n  baseline: string;\r\n  fontBoundingBoxAscent?: number;\r\n  fontBoundingBoxDescent?: number;\r\n  actualBoundingBoxAscent?: number;\r\n  actualBoundingBoxDescent?: number;\r\n}\r\n\r\n// Global measurement context - reused for performance\r\nlet measurementContext: CanvasRenderingContext2D | null = null;\r\n\r\n/**\r\n * Get or create the shared measurement context\r\n */\r\nfunction getMeasurementContext(): CanvasRenderingContext2D {\r\n  if (!measurementContext) {\r\n    const canvas = createCanvasElementFor({\r\n      width: 0,\r\n      height: 0,\r\n    });\r\n    measurementContext = canvas.getContext('2d')!;\r\n  }\r\n  return measurementContext;\r\n}\r\n\r\n/**\r\n * Measure a single grapheme\r\n */\r\nexport function measureGrapheme(\r\n  grapheme: string,\r\n  options: MeasurementOptions,\r\n  ctx?: CanvasRenderingContext2D\r\n): GraphemeMeasurement {\r\n  // Check cache first\r\n  const cached = measurementCache.get(grapheme, options);\r\n  if (cached) {\r\n    return cached;\r\n  }\r\n\r\n  // Use provided context or get global one\r\n  const context = ctx || getMeasurementContext();\r\n  \r\n  // Set font properties\r\n  applyFontStyle(context, options);\r\n  \r\n  // Measure the grapheme\r\n  const metrics = context.measureText(grapheme);\r\n  const fontMetrics = getFontMetrics(options);\r\n  \r\n  // Calculate comprehensive measurements\r\n  const measurement: GraphemeMeasurement = {\r\n    width: metrics.width,\r\n    height: fontMetrics.lineHeight,\r\n    ascent: fontMetrics.ascent,\r\n    descent: fontMetrics.descent,\r\n    baseline: fontMetrics.ascent,\r\n  };\r\n  \r\n  // Cache the result\r\n  measurementCache.set(grapheme, options, measurement);\r\n  \r\n  return measurement;\r\n}\r\n\r\n/**\r\n * Measure a grapheme with kerning relative to previous character\r\n */\r\nexport function measureGraphemeWithKerning(\r\n  grapheme: string,\r\n  previousGrapheme: string | undefined,\r\n  options: MeasurementOptions,\r\n  ctx?: CanvasRenderingContext2D\r\n): KerningMeasurement {\r\n  // Get individual measurement\r\n  const individual = measureGrapheme(grapheme, options, ctx);\r\n  \r\n  // If no previous character, kerning width equals regular width\r\n  if (!previousGrapheme) {\r\n    return {\r\n      ...individual,\r\n      kernedWidth: individual.width,\r\n    };\r\n  }\r\n  \r\n  // Check kerning cache\r\n  const kerningPair = `${previousGrapheme}${grapheme}`;\r\n  const cachedKerning = kerningCache.get(kerningPair, options);\r\n  if (cachedKerning) {\r\n    return {\r\n      ...individual,\r\n      kernedWidth: cachedKerning,\r\n    };\r\n  }\r\n  \r\n  // Use provided context or get global one\r\n  const context = ctx || getMeasurementContext();\r\n  applyFontStyle(context, options);\r\n  \r\n  // Measure the pair\r\n  const pairWidth = context.measureText(previousGrapheme + grapheme).width;\r\n  const previousWidth = measureGrapheme(previousGrapheme, options, context).width;\r\n  const kernedWidth = pairWidth - previousWidth;\r\n  \r\n  // Cache kerning result\r\n  kerningCache.set(kerningPair, options, kernedWidth);\r\n  \r\n  return {\r\n    ...individual,\r\n    kernedWidth,\r\n  };\r\n}\r\n\r\n/**\r\n * Get font metrics for layout calculations\r\n */\r\nexport function getFontMetrics(options: MeasurementOptions): FontMetrics {\r\n  const cacheKey = getFontDeclaration(options);\r\n  const cached = fontMetricsCache.get(cacheKey);\r\n  if (cached) {\r\n    return cached;\r\n  }\r\n  \r\n  const context = getMeasurementContext();\r\n  applyFontStyle(context, options);\r\n  \r\n  // Use 'M' as sample character for metrics\r\n  const metrics = context.measureText('M');\r\n  const fontSize = options.fontSize;\r\n  \r\n  // Calculate metrics with fallbacks\r\n  const fontBoundingBoxAscent = metrics.fontBoundingBoxAscent ?? fontSize * 0.91;\r\n  const fontBoundingBoxDescent = metrics.fontBoundingBoxDescent ?? fontSize * 0.21;\r\n  const actualBoundingBoxAscent = metrics.actualBoundingBoxAscent ?? fontSize * 0.716;\r\n  const actualBoundingBoxDescent = metrics.actualBoundingBoxDescent ?? 0;\r\n  \r\n  const result: FontMetrics = {\r\n    ascent: fontBoundingBoxAscent,\r\n    descent: fontBoundingBoxDescent,\r\n    lineHeight: fontSize,\r\n    baseline: 'alphabetic',\r\n    fontBoundingBoxAscent,\r\n    fontBoundingBoxDescent,\r\n    actualBoundingBoxAscent,\r\n    actualBoundingBoxDescent,\r\n  };\r\n  \r\n  fontMetricsCache.set(cacheKey, result);\r\n  return result;\r\n}\r\n\r\n/**\r\n * Apply font styling to canvas context\r\n */\r\nfunction applyFontStyle(ctx: CanvasRenderingContext2D, options: MeasurementOptions): void {\r\n  const fontDeclaration = getFontDeclaration(options);\r\n  ctx.font = fontDeclaration;\r\n  \r\n  if (options.letterSpacing) {\r\n    // Modern browsers support letterSpacing\r\n    if ('letterSpacing' in ctx) {\r\n      (ctx as any).letterSpacing = `${options.letterSpacing}px`;\r\n    }\r\n  }\r\n  \r\n  if (options.direction) {\r\n    ctx.direction = options.direction;\r\n  }\r\n  \r\n  ctx.textBaseline = 'alphabetic';\r\n}\r\n\r\n/**\r\n * Generate font declaration string\r\n */\r\nfunction getFontDeclaration(options: MeasurementOptions): string {\r\n  const { fontStyle, fontWeight, fontSize, fontFamily } = options;\r\n  \r\n  // Normalize font family (add quotes if needed)\r\n  const normalizedFamily = fontFamily.includes(' ') && \r\n    !fontFamily.includes('\"') && \r\n    !fontFamily.includes(\"'\")\r\n    ? `\"${fontFamily}\"`\r\n    : fontFamily;\r\n  \r\n  return `${fontStyle} ${fontWeight} ${fontSize}px ${normalizedFamily}`;\r\n}\r\n\r\n/**\r\n * LRU Cache implementation for measurements\r\n */\r\nclass LRUCache<T> {\r\n  private cache = new Map<string, { value: T; timestamp: number }>();\r\n  private maxSize: number;\r\n  private hits = 0;\r\n  private misses = 0;\r\n\r\n  constructor(maxSize = 1000) {\r\n    this.maxSize = maxSize;\r\n  }\r\n\r\n  get(key: string): T | undefined {\r\n    const entry = this.cache.get(key);\r\n    if (entry) {\r\n      // Update timestamp for LRU\r\n      entry.timestamp = Date.now();\r\n      this.hits++;\r\n      return entry.value;\r\n    }\r\n    this.misses++;\r\n    return undefined;\r\n  }\r\n\r\n  set(key: string, value: T): void {\r\n    // Remove oldest entries if at capacity\r\n    if (this.cache.size >= this.maxSize) {\r\n      const oldestKey = this.findOldestKey();\r\n      if (oldestKey) {\r\n        this.cache.delete(oldestKey);\r\n      }\r\n    }\r\n\r\n    this.cache.set(key, {\r\n      value,\r\n      timestamp: Date.now(),\r\n    });\r\n  }\r\n\r\n  private findOldestKey(): string | undefined {\r\n    let oldestKey: string | undefined;\r\n    let oldestTime = Infinity;\r\n\r\n    for (const [key, entry] of this.cache.entries()) {\r\n      if (entry.timestamp < oldestTime) {\r\n        oldestTime = entry.timestamp;\r\n        oldestKey = key;\r\n      }\r\n    }\r\n\r\n    return oldestKey;\r\n  }\r\n\r\n  clear(): void {\r\n    this.cache.clear();\r\n    this.hits = 0;\r\n    this.misses = 0;\r\n  }\r\n\r\n  getStats(): { size: number; hitRate: number; hits: number; misses: number } {\r\n    const total = this.hits + this.misses;\r\n    return {\r\n      size: this.cache.size,\r\n      hitRate: total > 0 ? this.hits / total : 0,\r\n      hits: this.hits,\r\n      misses: this.misses,\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Advanced measurement cache with font-aware keys\r\n */\r\nexport class MeasurementCache {\r\n  private cache = new LRUCache<GraphemeMeasurement>(1000);\r\n\r\n  getCacheKey(grapheme: string, options: MeasurementOptions): string {\r\n    const fontDecl = getFontDeclaration(options);\r\n    const letterSpacing = options.letterSpacing || 0;\r\n    return `${fontDecl}|${grapheme}|${letterSpacing}`;\r\n  }\r\n\r\n  get(grapheme: string, options: MeasurementOptions): GraphemeMeasurement | undefined {\r\n    const key = this.getCacheKey(grapheme, options);\r\n    return this.cache.get(key);\r\n  }\r\n\r\n  set(grapheme: string, options: MeasurementOptions, measurement: GraphemeMeasurement): void {\r\n    const key = this.getCacheKey(grapheme, options);\r\n    this.cache.set(key, measurement);\r\n  }\r\n\r\n  clear(): void {\r\n    this.cache.clear();\r\n  }\r\n\r\n  getStats() {\r\n    return this.cache.getStats();\r\n  }\r\n}\r\n\r\n/**\r\n * Kerning cache for character pairs\r\n */\r\nclass KerningCache {\r\n  private cache = new LRUCache<number>(5000); // More entries for pairs\r\n\r\n  getCacheKey(pair: string, options: MeasurementOptions): string {\r\n    const fontDecl = getFontDeclaration(options);\r\n    return `${fontDecl}|${pair}`;\r\n  }\r\n\r\n  get(pair: string, options: MeasurementOptions): number | undefined {\r\n    const key = this.getCacheKey(pair, options);\r\n    return this.cache.get(key);\r\n  }\r\n\r\n  set(pair: string, options: MeasurementOptions, kerning: number): void {\r\n    const key = this.getCacheKey(pair, options);\r\n    this.cache.set(key, kerning);\r\n  }\r\n\r\n  clear(): void {\r\n    this.cache.clear();\r\n  }\r\n\r\n  getStats() {\r\n    return this.cache.getStats();\r\n  }\r\n}\r\n\r\n/**\r\n * Font metrics cache\r\n */\r\nclass FontMetricsCache {\r\n  private cache = new Map<string, FontMetrics>();\r\n\r\n  get(fontDeclaration: string): FontMetrics | undefined {\r\n    return this.cache.get(fontDeclaration);\r\n  }\r\n\r\n  set(fontDeclaration: string, metrics: FontMetrics): void {\r\n    this.cache.set(fontDeclaration, metrics);\r\n  }\r\n\r\n  clear(): void {\r\n    this.cache.clear();\r\n  }\r\n\r\n  getStats() {\r\n    return {\r\n      size: this.cache.size,\r\n    };\r\n  }\r\n}\r\n\r\n// Global cache instances\r\nexport const measurementCache = new MeasurementCache();\r\nexport const kerningCache = new KerningCache();\r\nexport const fontMetricsCache = new FontMetricsCache();\r\n\r\n/**\r\n * Clear all measurement caches\r\n */\r\nexport function clearAllCaches(): void {\r\n  measurementCache.clear();\r\n  kerningCache.clear();\r\n  fontMetricsCache.clear();\r\n}\r\n\r\n/**\r\n * Get combined cache statistics\r\n */\r\nexport function getCacheStats() {\r\n  return {\r\n    measurement: measurementCache.getStats(),\r\n    kerning: kerningCache.getStats(),\r\n    fontMetrics: fontMetricsCache.getStats(),\r\n  };\r\n}\r\n\r\n/**\r\n * Batch measure multiple graphemes efficiently\r\n */\r\nexport function batchMeasureGraphemes(\r\n  graphemes: string[],\r\n  options: MeasurementOptions,\r\n  ctx?: CanvasRenderingContext2D\r\n): GraphemeMeasurement[] {\r\n  const context = ctx || getMeasurementContext();\r\n  applyFontStyle(context, options);\r\n  \r\n  // Separate cached and uncached measurements\r\n  const results: GraphemeMeasurement[] = new Array(graphemes.length);\r\n  const uncachedIndices: number[] = [];\r\n  \r\n  // Check cache for all graphemes\r\n  graphemes.forEach((grapheme, index) => {\r\n    const cached = measurementCache.get(grapheme, options);\r\n    if (cached) {\r\n      results[index] = cached;\r\n    } else {\r\n      uncachedIndices.push(index);\r\n    }\r\n  });\r\n  \r\n  // Measure uncached graphemes\r\n  const fontMetrics = getFontMetrics(options);\r\n  uncachedIndices.forEach(index => {\r\n    const grapheme = graphemes[index];\r\n    const metrics = context.measureText(grapheme);\r\n    \r\n    const measurement: GraphemeMeasurement = {\r\n      width: metrics.width,\r\n      height: fontMetrics.lineHeight,\r\n      ascent: fontMetrics.ascent,\r\n      descent: fontMetrics.descent,\r\n      baseline: fontMetrics.ascent,\r\n    };\r\n    \r\n    measurementCache.set(grapheme, options, measurement);\r\n    results[index] = measurement;\r\n  });\r\n  \r\n  return results;\r\n}\r\n\r\n/**\r\n * Estimate text width without full layout (for performance)\r\n */\r\nexport function estimateTextWidth(\r\n  text: string,\r\n  options: MeasurementOptions\r\n): number {\r\n  // Use average character width for estimation\r\n  const avgChar = 'n'; // Representative character\r\n  const avgMeasurement = measureGrapheme(avgChar, options);\r\n  const letterSpacing = options.letterSpacing || 0;\r\n  \r\n  return text.length * (avgMeasurement.width + letterSpacing);\r\n}\r\n\r\n/**\r\n * Check if font is loaded and ready for measurement\r\n */\r\nexport function isFontReady(fontFamily: string): boolean {\r\n  if (typeof document === 'undefined') return true;\r\n  \r\n  if ('fonts' in document) {\r\n    return document.fonts.check(`16px ${fontFamily}`);\r\n  }\r\n  \r\n  // Fallback - assume font is ready\r\n  return true;\r\n}"],"names":["measurementContext","getMeasurementContext","canvas","createCanvasElementFor","width","height","getContext","measureGrapheme","grapheme","options","ctx","cached","measurementCache","get","context","applyFontStyle","metrics","measureText","fontMetrics","getFontMetrics","measurement","lineHeight","ascent","descent","baseline","set","measureGraphemeWithKerning","previousGrapheme","individual","kernedWidth","kerningPair","cachedKerning","kerningCache","_metrics$fontBounding","_metrics$fontBounding2","_metrics$actualBoundi","_metrics$actualBoundi2","cacheKey","getFontDeclaration","fontMetricsCache","fontSize","fontBoundingBoxAscent","fontBoundingBoxDescent","result","actualBoundingBoxAscent","actualBoundingBoxDescent","fontDeclaration","font","letterSpacing","direction","textBaseline","fontStyle","fontWeight","fontFamily","includes","LRUCache","constructor","maxSize","arguments","length","undefined","_defineProperty","this","Map","key","entry","cache","timestamp","Date","now","hits","value","misses","size","oldestKey","findOldestKey","delete","oldestTime","Infinity","entries","clear","getStats","total","hitRate","MeasurementCache","getCacheKey","pair","kerning"],"mappings":"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"}

package/dist/src/text/measure.mjs

@@ -0,0 +1,316 @@
+import { defineProperty as _defineProperty } from '../../_virtual/_rollupPluginBabelHelpers.mjs';
+import { createCanvasElementFor } from '../util/misc/dom.mjs';
+
+// Global measurement context - reused for performance
+let measurementContext = null;
+
+/**
+ * Get or create the shared measurement context
+ */
+function getMeasurementContext() {
+  if (!measurementContext) {
+    const canvas = createCanvasElementFor({
+      width: 0,
+      height: 0
+    });
+    measurementContext = canvas.getContext('2d');
+  }
+  return measurementContext;
+}
+
+/**
+ * Measure a single grapheme
+ */
+function measureGrapheme(grapheme, options, ctx) {
+  // Check cache first
+  const cached = measurementCache.get(grapheme, options);
+  if (cached) {
+    return cached;
+  }
+
+  // Use provided context or get global one
+  const context = ctx || getMeasurementContext();
+
+  // Set font properties
+  applyFontStyle(context, options);
+
+  // Measure the grapheme
+  const metrics = context.measureText(grapheme);
+  const fontMetrics = getFontMetrics(options);
+
+  // Calculate comprehensive measurements
+  const measurement = {
+    width: metrics.width,
+    height: fontMetrics.lineHeight,
+    ascent: fontMetrics.ascent,
+    descent: fontMetrics.descent,
+    baseline: fontMetrics.ascent
+  };
+
+  // Cache the result
+  measurementCache.set(grapheme, options, measurement);
+  return measurement;
+}
+
+/**
+ * Measure a grapheme with kerning relative to previous character
+ */
+function measureGraphemeWithKerning(grapheme, previousGrapheme, options, ctx) {
+  // Get individual measurement
+  const individual = measureGrapheme(grapheme, options, ctx);
+
+  // If no previous character, kerning width equals regular width
+  if (!previousGrapheme) {
+    return {
+      ...individual,
+      kernedWidth: individual.width
+    };
+  }
+
+  // Check kerning cache
+  const kerningPair = `${previousGrapheme}${grapheme}`;
+  const cachedKerning = kerningCache.get(kerningPair, options);
+  if (cachedKerning) {
+    return {
+      ...individual,
+      kernedWidth: cachedKerning
+    };
+  }
+
+  // Use provided context or get global one
+  const context = getMeasurementContext();
+  applyFontStyle(context, options);
+
+  // Measure the pair
+  const pairWidth = context.measureText(previousGrapheme + grapheme).width;
+  const previousWidth = measureGrapheme(previousGrapheme, options, context).width;
+  const kernedWidth = pairWidth - previousWidth;
+
+  // Cache kerning result
+  kerningCache.set(kerningPair, options, kernedWidth);
+  return {
+    ...individual,
+    kernedWidth
+  };
+}
+
+/**
+ * Get font metrics for layout calculations
+ */
+function getFontMetrics(options) {
+  var _metrics$fontBounding, _metrics$fontBounding2, _metrics$actualBoundi, _metrics$actualBoundi2;
+  const cacheKey = getFontDeclaration(options);
+  const cached = fontMetricsCache.get(cacheKey);
+  if (cached) {
+    return cached;
+  }
+  const context = getMeasurementContext();
+  applyFontStyle(context, options);
+
+  // Use 'M' as sample character for metrics
+  const metrics = context.measureText('M');
+  const fontSize = options.fontSize;
+
+  // Calculate metrics with fallbacks
+  const fontBoundingBoxAscent = (_metrics$fontBounding = metrics.fontBoundingBoxAscent) !== null && _metrics$fontBounding !== void 0 ? _metrics$fontBounding : fontSize * 0.91;
+  const fontBoundingBoxDescent = (_metrics$fontBounding2 = metrics.fontBoundingBoxDescent) !== null && _metrics$fontBounding2 !== void 0 ? _metrics$fontBounding2 : fontSize * 0.21;
+  const actualBoundingBoxAscent = (_metrics$actualBoundi = metrics.actualBoundingBoxAscent) !== null && _metrics$actualBoundi !== void 0 ? _metrics$actualBoundi : fontSize * 0.716;
+  const actualBoundingBoxDescent = (_metrics$actualBoundi2 = metrics.actualBoundingBoxDescent) !== null && _metrics$actualBoundi2 !== void 0 ? _metrics$actualBoundi2 : 0;
+  const result = {
+    ascent: fontBoundingBoxAscent,
+    descent: fontBoundingBoxDescent,
+    lineHeight: fontSize,
+    baseline: 'alphabetic',
+    fontBoundingBoxAscent,
+    fontBoundingBoxDescent,
+    actualBoundingBoxAscent,
+    actualBoundingBoxDescent
+  };
+  fontMetricsCache.set(cacheKey, result);
+  return result;
+}
+
+/**
+ * Apply font styling to canvas context
+ */
+function applyFontStyle(ctx, options) {
+  const fontDeclaration = getFontDeclaration(options);
+  ctx.font = fontDeclaration;
+  if (options.letterSpacing) {
+    // Modern browsers support letterSpacing
+    if ('letterSpacing' in ctx) {
+      ctx.letterSpacing = `${options.letterSpacing}px`;
+    }
+  }
+  if (options.direction) {
+    ctx.direction = options.direction;
+  }
+  ctx.textBaseline = 'alphabetic';
+}
+
+/**
+ * Generate font declaration string
+ */
+function getFontDeclaration(options) {
+  const {
+    fontStyle,
+    fontWeight,
+    fontSize,
+    fontFamily
+  } = options;
+
+  // Normalize font family (add quotes if needed)
+  const normalizedFamily = fontFamily.includes(' ') && !fontFamily.includes('"') && !fontFamily.includes("'") ? `"${fontFamily}"` : fontFamily;
+  return `${fontStyle} ${fontWeight} ${fontSize}px ${normalizedFamily}`;
+}
+
+/**
+ * LRU Cache implementation for measurements
+ */
+class LRUCache {
+  constructor() {
+    let maxSize = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1000;
+    _defineProperty(this, "cache", new Map());
+    _defineProperty(this, "maxSize", void 0);
+    _defineProperty(this, "hits", 0);
+    _defineProperty(this, "misses", 0);
+    this.maxSize = maxSize;
+  }
+  get(key) {
+    const entry = this.cache.get(key);
+    if (entry) {
+      // Update timestamp for LRU
+      entry.timestamp = Date.now();
+      this.hits++;
+      return entry.value;
+    }
+    this.misses++;
+    return undefined;
+  }
+  set(key, value) {
+    // Remove oldest entries if at capacity
+    if (this.cache.size >= this.maxSize) {
+      const oldestKey = this.findOldestKey();
+      if (oldestKey) {
+        this.cache.delete(oldestKey);
+      }
+    }
+    this.cache.set(key, {
+      value,
+      timestamp: Date.now()
+    });
+  }
+  findOldestKey() {
+    let oldestKey;
+    let oldestTime = Infinity;
+    for (const [key, entry] of this.cache.entries()) {
+      if (entry.timestamp < oldestTime) {
+        oldestTime = entry.timestamp;
+        oldestKey = key;
+      }
+    }
+    return oldestKey;
+  }
+  clear() {
+    this.cache.clear();
+    this.hits = 0;
+    this.misses = 0;
+  }
+  getStats() {
+    const total = this.hits + this.misses;
+    return {
+      size: this.cache.size,
+      hitRate: total > 0 ? this.hits / total : 0,
+      hits: this.hits,
+      misses: this.misses
+    };
+  }
+}
+
+/**
+ * Advanced measurement cache with font-aware keys
+ */
+class MeasurementCache {
+  constructor() {
+    _defineProperty(this, "cache", new LRUCache(1000));
+  }
+  getCacheKey(grapheme, options) {
+    const fontDecl = getFontDeclaration(options);
+    const letterSpacing = options.letterSpacing || 0;
+    return `${fontDecl}|${grapheme}|${letterSpacing}`;
+  }
+  get(grapheme, options) {
+    const key = this.getCacheKey(grapheme, options);
+    return this.cache.get(key);
+  }
+  set(grapheme, options, measurement) {
+    const key = this.getCacheKey(grapheme, options);
+    this.cache.set(key, measurement);
+  }
+  clear() {
+    this.cache.clear();
+  }
+  getStats() {
+    return this.cache.getStats();
+  }
+}
+
+/**
+ * Kerning cache for character pairs
+ */
+class KerningCache {
+  constructor() {
+    _defineProperty(this, "cache", new LRUCache(5000));
+  }
+  // More entries for pairs
+
+  getCacheKey(pair, options) {
+    const fontDecl = getFontDeclaration(options);
+    return `${fontDecl}|${pair}`;
+  }
+  get(pair, options) {
+    const key = this.getCacheKey(pair, options);
+    return this.cache.get(key);
+  }
+  set(pair, options, kerning) {
+    const key = this.getCacheKey(pair, options);
+    this.cache.set(key, kerning);
+  }
+  clear() {
+    this.cache.clear();
+  }
+  getStats() {
+    return this.cache.getStats();
+  }
+}
+
+/**
+ * Font metrics cache
+ */
+class FontMetricsCache {
+  constructor() {
+    _defineProperty(this, "cache", new Map());
+  }
+  get(fontDeclaration) {
+    return this.cache.get(fontDeclaration);
+  }
+  set(fontDeclaration, metrics) {
+    this.cache.set(fontDeclaration, metrics);
+  }
+  clear() {
+    this.cache.clear();
+  }
+  getStats() {
+    return {
+      size: this.cache.size
+    };
+  }
+}
+
+// Global cache instances
+const measurementCache = new MeasurementCache();
+const kerningCache = new KerningCache();
+const fontMetricsCache = new FontMetricsCache();
+
+export { MeasurementCache, fontMetricsCache, getFontMetrics, kerningCache, measureGrapheme, measureGraphemeWithKerning, measurementCache };
+//# sourceMappingURL=measure.mjs.map

package/dist/src/text/measure.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.mjs","sources":["../../../src/text/measure.ts"],"sourcesContent":["/**\r\n * Advanced Text Measurement System\r\n * \r\n * Provides precise text measurement with caching, font metrics,\r\n * and DPI awareness for optimal performance and accuracy.\r\n */\r\n\r\nimport { createCanvasElementFor } from '../util/misc/dom';\r\n\r\nexport interface MeasurementOptions {\r\n  fontFamily: string;\r\n  fontSize: number;\r\n  fontStyle: string;\r\n  fontWeight: string | number;\r\n  letterSpacing?: number;\r\n  direction?: 'ltr' | 'rtl';\r\n}\r\n\r\nexport interface GraphemeMeasurement {\r\n  width: number;\r\n  height: number;\r\n  ascent: number;\r\n  descent: number;\r\n  baseline: number;\r\n}\r\n\r\nexport interface KerningMeasurement extends GraphemeMeasurement {\r\n  kernedWidth: number; // width accounting for kerning with previous char\r\n}\r\n\r\nexport interface FontMetrics {\r\n  ascent: number;\r\n  descent: number;\r\n  lineHeight: number;\r\n  baseline: string;\r\n  fontBoundingBoxAscent?: number;\r\n  fontBoundingBoxDescent?: number;\r\n  actualBoundingBoxAscent?: number;\r\n  actualBoundingBoxDescent?: number;\r\n}\r\n\r\n// Global measurement context - reused for performance\r\nlet measurementContext: CanvasRenderingContext2D | null = null;\r\n\r\n/**\r\n * Get or create the shared measurement context\r\n */\r\nfunction getMeasurementContext(): CanvasRenderingContext2D {\r\n  if (!measurementContext) {\r\n    const canvas = createCanvasElementFor({\r\n      width: 0,\r\n      height: 0,\r\n    });\r\n    measurementContext = canvas.getContext('2d')!;\r\n  }\r\n  return measurementContext;\r\n}\r\n\r\n/**\r\n * Measure a single grapheme\r\n */\r\nexport function measureGrapheme(\r\n  grapheme: string,\r\n  options: MeasurementOptions,\r\n  ctx?: CanvasRenderingContext2D\r\n): GraphemeMeasurement {\r\n  // Check cache first\r\n  const cached = measurementCache.get(grapheme, options);\r\n  if (cached) {\r\n    return cached;\r\n  }\r\n\r\n  // Use provided context or get global one\r\n  const context = ctx || getMeasurementContext();\r\n  \r\n  // Set font properties\r\n  applyFontStyle(context, options);\r\n  \r\n  // Measure the grapheme\r\n  const metrics = context.measureText(grapheme);\r\n  const fontMetrics = getFontMetrics(options);\r\n  \r\n  // Calculate comprehensive measurements\r\n  const measurement: GraphemeMeasurement = {\r\n    width: metrics.width,\r\n    height: fontMetrics.lineHeight,\r\n    ascent: fontMetrics.ascent,\r\n    descent: fontMetrics.descent,\r\n    baseline: fontMetrics.ascent,\r\n  };\r\n  \r\n  // Cache the result\r\n  measurementCache.set(grapheme, options, measurement);\r\n  \r\n  return measurement;\r\n}\r\n\r\n/**\r\n * Measure a grapheme with kerning relative to previous character\r\n */\r\nexport function measureGraphemeWithKerning(\r\n  grapheme: string,\r\n  previousGrapheme: string | undefined,\r\n  options: MeasurementOptions,\r\n  ctx?: CanvasRenderingContext2D\r\n): KerningMeasurement {\r\n  // Get individual measurement\r\n  const individual = measureGrapheme(grapheme, options, ctx);\r\n  \r\n  // If no previous character, kerning width equals regular width\r\n  if (!previousGrapheme) {\r\n    return {\r\n      ...individual,\r\n      kernedWidth: individual.width,\r\n    };\r\n  }\r\n  \r\n  // Check kerning cache\r\n  const kerningPair = `${previousGrapheme}${grapheme}`;\r\n  const cachedKerning = kerningCache.get(kerningPair, options);\r\n  if (cachedKerning) {\r\n    return {\r\n      ...individual,\r\n      kernedWidth: cachedKerning,\r\n    };\r\n  }\r\n  \r\n  // Use provided context or get global one\r\n  const context = ctx || getMeasurementContext();\r\n  applyFontStyle(context, options);\r\n  \r\n  // Measure the pair\r\n  const pairWidth = context.measureText(previousGrapheme + grapheme).width;\r\n  const previousWidth = measureGrapheme(previousGrapheme, options, context).width;\r\n  const kernedWidth = pairWidth - previousWidth;\r\n  \r\n  // Cache kerning result\r\n  kerningCache.set(kerningPair, options, kernedWidth);\r\n  \r\n  return {\r\n    ...individual,\r\n    kernedWidth,\r\n  };\r\n}\r\n\r\n/**\r\n * Get font metrics for layout calculations\r\n */\r\nexport function getFontMetrics(options: MeasurementOptions): FontMetrics {\r\n  const cacheKey = getFontDeclaration(options);\r\n  const cached = fontMetricsCache.get(cacheKey);\r\n  if (cached) {\r\n    return cached;\r\n  }\r\n  \r\n  const context = getMeasurementContext();\r\n  applyFontStyle(context, options);\r\n  \r\n  // Use 'M' as sample character for metrics\r\n  const metrics = context.measureText('M');\r\n  const fontSize = options.fontSize;\r\n  \r\n  // Calculate metrics with fallbacks\r\n  const fontBoundingBoxAscent = metrics.fontBoundingBoxAscent ?? fontSize * 0.91;\r\n  const fontBoundingBoxDescent = metrics.fontBoundingBoxDescent ?? fontSize * 0.21;\r\n  const actualBoundingBoxAscent = metrics.actualBoundingBoxAscent ?? fontSize * 0.716;\r\n  const actualBoundingBoxDescent = metrics.actualBoundingBoxDescent ?? 0;\r\n  \r\n  const result: FontMetrics = {\r\n    ascent: fontBoundingBoxAscent,\r\n    descent: fontBoundingBoxDescent,\r\n    lineHeight: fontSize,\r\n    baseline: 'alphabetic',\r\n    fontBoundingBoxAscent,\r\n    fontBoundingBoxDescent,\r\n    actualBoundingBoxAscent,\r\n    actualBoundingBoxDescent,\r\n  };\r\n  \r\n  fontMetricsCache.set(cacheKey, result);\r\n  return result;\r\n}\r\n\r\n/**\r\n * Apply font styling to canvas context\r\n */\r\nfunction applyFontStyle(ctx: CanvasRenderingContext2D, options: MeasurementOptions): void {\r\n  const fontDeclaration = getFontDeclaration(options);\r\n  ctx.font = fontDeclaration;\r\n  \r\n  if (options.letterSpacing) {\r\n    // Modern browsers support letterSpacing\r\n    if ('letterSpacing' in ctx) {\r\n      (ctx as any).letterSpacing = `${options.letterSpacing}px`;\r\n    }\r\n  }\r\n  \r\n  if (options.direction) {\r\n    ctx.direction = options.direction;\r\n  }\r\n  \r\n  ctx.textBaseline = 'alphabetic';\r\n}\r\n\r\n/**\r\n * Generate font declaration string\r\n */\r\nfunction getFontDeclaration(options: MeasurementOptions): string {\r\n  const { fontStyle, fontWeight, fontSize, fontFamily } = options;\r\n  \r\n  // Normalize font family (add quotes if needed)\r\n  const normalizedFamily = fontFamily.includes(' ') && \r\n    !fontFamily.includes('\"') && \r\n    !fontFamily.includes(\"'\")\r\n    ? `\"${fontFamily}\"`\r\n    : fontFamily;\r\n  \r\n  return `${fontStyle} ${fontWeight} ${fontSize}px ${normalizedFamily}`;\r\n}\r\n\r\n/**\r\n * LRU Cache implementation for measurements\r\n */\r\nclass LRUCache<T> {\r\n  private cache = new Map<string, { value: T; timestamp: number }>();\r\n  private maxSize: number;\r\n  private hits = 0;\r\n  private misses = 0;\r\n\r\n  constructor(maxSize = 1000) {\r\n    this.maxSize = maxSize;\r\n  }\r\n\r\n  get(key: string): T | undefined {\r\n    const entry = this.cache.get(key);\r\n    if (entry) {\r\n      // Update timestamp for LRU\r\n      entry.timestamp = Date.now();\r\n      this.hits++;\r\n      return entry.value;\r\n    }\r\n    this.misses++;\r\n    return undefined;\r\n  }\r\n\r\n  set(key: string, value: T): void {\r\n    // Remove oldest entries if at capacity\r\n    if (this.cache.size >= this.maxSize) {\r\n      const oldestKey = this.findOldestKey();\r\n      if (oldestKey) {\r\n        this.cache.delete(oldestKey);\r\n      }\r\n    }\r\n\r\n    this.cache.set(key, {\r\n      value,\r\n      timestamp: Date.now(),\r\n    });\r\n  }\r\n\r\n  private findOldestKey(): string | undefined {\r\n    let oldestKey: string | undefined;\r\n    let oldestTime = Infinity;\r\n\r\n    for (const [key, entry] of this.cache.entries()) {\r\n      if (entry.timestamp < oldestTime) {\r\n        oldestTime = entry.timestamp;\r\n        oldestKey = key;\r\n      }\r\n    }\r\n\r\n    return oldestKey;\r\n  }\r\n\r\n  clear(): void {\r\n    this.cache.clear();\r\n    this.hits = 0;\r\n    this.misses = 0;\r\n  }\r\n\r\n  getStats(): { size: number; hitRate: number; hits: number; misses: number } {\r\n    const total = this.hits + this.misses;\r\n    return {\r\n      size: this.cache.size,\r\n      hitRate: total > 0 ? this.hits / total : 0,\r\n      hits: this.hits,\r\n      misses: this.misses,\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Advanced measurement cache with font-aware keys\r\n */\r\nexport class MeasurementCache {\r\n  private cache = new LRUCache<GraphemeMeasurement>(1000);\r\n\r\n  getCacheKey(grapheme: string, options: MeasurementOptions): string {\r\n    const fontDecl = getFontDeclaration(options);\r\n    const letterSpacing = options.letterSpacing || 0;\r\n    return `${fontDecl}|${grapheme}|${letterSpacing}`;\r\n  }\r\n\r\n  get(grapheme: string, options: MeasurementOptions): GraphemeMeasurement | undefined {\r\n    const key = this.getCacheKey(grapheme, options);\r\n    return this.cache.get(key);\r\n  }\r\n\r\n  set(grapheme: string, options: MeasurementOptions, measurement: GraphemeMeasurement): void {\r\n    const key = this.getCacheKey(grapheme, options);\r\n    this.cache.set(key, measurement);\r\n  }\r\n\r\n  clear(): void {\r\n    this.cache.clear();\r\n  }\r\n\r\n  getStats() {\r\n    return this.cache.getStats();\r\n  }\r\n}\r\n\r\n/**\r\n * Kerning cache for character pairs\r\n */\r\nclass KerningCache {\r\n  private cache = new LRUCache<number>(5000); // More entries for pairs\r\n\r\n  getCacheKey(pair: string, options: MeasurementOptions): string {\r\n    const fontDecl = getFontDeclaration(options);\r\n    return `${fontDecl}|${pair}`;\r\n  }\r\n\r\n  get(pair: string, options: MeasurementOptions): number | undefined {\r\n    const key = this.getCacheKey(pair, options);\r\n    return this.cache.get(key);\r\n  }\r\n\r\n  set(pair: string, options: MeasurementOptions, kerning: number): void {\r\n    const key = this.getCacheKey(pair, options);\r\n    this.cache.set(key, kerning);\r\n  }\r\n\r\n  clear(): void {\r\n    this.cache.clear();\r\n  }\r\n\r\n  getStats() {\r\n    return this.cache.getStats();\r\n  }\r\n}\r\n\r\n/**\r\n * Font metrics cache\r\n */\r\nclass FontMetricsCache {\r\n  private cache = new Map<string, FontMetrics>();\r\n\r\n  get(fontDeclaration: string): FontMetrics | undefined {\r\n    return this.cache.get(fontDeclaration);\r\n  }\r\n\r\n  set(fontDeclaration: string, metrics: FontMetrics): void {\r\n    this.cache.set(fontDeclaration, metrics);\r\n  }\r\n\r\n  clear(): void {\r\n    this.cache.clear();\r\n  }\r\n\r\n  getStats() {\r\n    return {\r\n      size: this.cache.size,\r\n    };\r\n  }\r\n}\r\n\r\n// Global cache instances\r\nexport const measurementCache = new MeasurementCache();\r\nexport const kerningCache = new KerningCache();\r\nexport const fontMetricsCache = new FontMetricsCache();\r\n\r\n/**\r\n * Clear all measurement caches\r\n */\r\nexport function clearAllCaches(): void {\r\n  measurementCache.clear();\r\n  kerningCache.clear();\r\n  fontMetricsCache.clear();\r\n}\r\n\r\n/**\r\n * Get combined cache statistics\r\n */\r\nexport function getCacheStats() {\r\n  return {\r\n    measurement: measurementCache.getStats(),\r\n    kerning: kerningCache.getStats(),\r\n    fontMetrics: fontMetricsCache.getStats(),\r\n  };\r\n}\r\n\r\n/**\r\n * Batch measure multiple graphemes efficiently\r\n */\r\nexport function batchMeasureGraphemes(\r\n  graphemes: string[],\r\n  options: MeasurementOptions,\r\n  ctx?: CanvasRenderingContext2D\r\n): GraphemeMeasurement[] {\r\n  const context = ctx || getMeasurementContext();\r\n  applyFontStyle(context, options);\r\n  \r\n  // Separate cached and uncached measurements\r\n  const results: GraphemeMeasurement[] = new Array(graphemes.length);\r\n  const uncachedIndices: number[] = [];\r\n  \r\n  // Check cache for all graphemes\r\n  graphemes.forEach((grapheme, index) => {\r\n    const cached = measurementCache.get(grapheme, options);\r\n    if (cached) {\r\n      results[index] = cached;\r\n    } else {\r\n      uncachedIndices.push(index);\r\n    }\r\n  });\r\n  \r\n  // Measure uncached graphemes\r\n  const fontMetrics = getFontMetrics(options);\r\n  uncachedIndices.forEach(index => {\r\n    const grapheme = graphemes[index];\r\n    const metrics = context.measureText(grapheme);\r\n    \r\n    const measurement: GraphemeMeasurement = {\r\n      width: metrics.width,\r\n      height: fontMetrics.lineHeight,\r\n      ascent: fontMetrics.ascent,\r\n      descent: fontMetrics.descent,\r\n      baseline: fontMetrics.ascent,\r\n    };\r\n    \r\n    measurementCache.set(grapheme, options, measurement);\r\n    results[index] = measurement;\r\n  });\r\n  \r\n  return results;\r\n}\r\n\r\n/**\r\n * Estimate text width without full layout (for performance)\r\n */\r\nexport function estimateTextWidth(\r\n  text: string,\r\n  options: MeasurementOptions\r\n): number {\r\n  // Use average character width for estimation\r\n  const avgChar = 'n'; // Representative character\r\n  const avgMeasurement = measureGrapheme(avgChar, options);\r\n  const letterSpacing = options.letterSpacing || 0;\r\n  \r\n  return text.length * (avgMeasurement.width + letterSpacing);\r\n}\r\n\r\n/**\r\n * Check if font is loaded and ready for measurement\r\n */\r\nexport function isFontReady(fontFamily: string): boolean {\r\n  if (typeof document === 'undefined') return true;\r\n  \r\n  if ('fonts' in document) {\r\n    return document.fonts.check(`16px ${fontFamily}`);\r\n  }\r\n  \r\n  // Fallback - assume font is ready\r\n  return true;\r\n}"],"names":["measurementContext","getMeasurementContext","canvas","createCanvasElementFor","width","height","getContext","measureGrapheme","grapheme","options","ctx","cached","measurementCache","get","context","applyFontStyle","metrics","measureText","fontMetrics","getFontMetrics","measurement","lineHeight","ascent","descent","baseline","set","measureGraphemeWithKerning","previousGrapheme","individual","kernedWidth","kerningPair","cachedKerning","kerningCache","pairWidth","previousWidth","_metrics$fontBounding","_metrics$fontBounding2","_metrics$actualBoundi","_metrics$actualBoundi2","cacheKey","getFontDeclaration","fontMetricsCache","fontSize","fontBoundingBoxAscent","fontBoundingBoxDescent","actualBoundingBoxAscent","actualBoundingBoxDescent","result","fontDeclaration","font","letterSpacing","direction","textBaseline","fontStyle","fontWeight","fontFamily","normalizedFamily","includes","LRUCache","constructor","maxSize","arguments","length","undefined","_defineProperty","Map","key","entry","cache","timestamp","Date","now","hits","value","misses","size","oldestKey","findOldestKey","delete","oldestTime","Infinity","entries","clear","getStats","total","hitRate","MeasurementCache","getCacheKey","fontDecl","KerningCache","pair","kerning","FontMetricsCache"],"mappings":"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"}

package/dist/src/text/overlayEditor.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Canva/Polotno-style Overlay Text Editor
+ *
+ * Provides seamless inline text editing using an HTML textarea overlay
+ * that matches canvas text positioning, styling, and transformations.
+ */
+import type { Canvas } from '../canvas/Canvas';
+import type { FabricText } from '../shapes/Text/Text';
+import type { IText } from '../shapes/IText/IText';
+import type { Textbox } from '../shapes/Textbox';
+export interface OverlayEditorOptions {
+    canvas: Canvas;
+    target: FabricText | IText | Textbox;
+    onCommit?: (text: string) => void;
+    onCancel?: () => void;
+}
+export interface ScreenTransform {
+    translateX: number;
+    translateY: number;
+    scaleX: number;
+    scaleY: number;
+    angle: number;
+}
+export declare class OverlayEditor {
+    private canvas;
+    private target;
+    private container;
+    private textarea;
+    private hostDiv;
+    private isDestroyed;
+    private isComposing;
+    private lastText;
+    private onCommit?;
+    private onCancel?;
+    private boundHandlers;
+    constructor(options: OverlayEditorOptions);
+    /**
+     * Get the container element for the overlay (parent of upperCanvasEl)
+     */
+    private getCanvasContainer;
+    /**
+     * Create the overlay DOM structure
+     */
+    private createOverlayDOM;
+    /**
+     * Attach all event listeners
+     */
+    private attachEventListeners;
+    /**
+     * Remove all event listeners
+     */
+    private removeEventListeners;
+    /**
+     * Simple method to refresh positioning when canvas changes
+     */
+    private updatePosition;
+    /**
+     * Update the Fabric object bounds to match current textarea size
+     * This ensures Fabric.js selection controls follow the growing textbox
+     */
+    private updateObjectBounds;
+    /**
+     * Convert Fabric charSpacing (1/1000 em) to CSS letter-spacing (px)
+     */
+    private letterSpacingPx;
+    /**
+     * Detect text direction using first strong directional character
+     */
+    private firstStrongDir;
+    private applyOverlayStyle;
+    /**
+     * Focus the textarea and position cursor at end
+     */
+    private focusTextarea;
+    /**
+     * Refresh overlay positioning and styling
+     */
+    refresh(): void;
+    /**
+     * Destroy the overlay editor
+     */
+    destroy(commit?: boolean): void;
+    private handleInput;
+    private autoResizeTextarea;
+    private handleKeyDown;
+    private handleFocus;
+    private handleBlur;
+    private handleCompositionStart;
+    private handleCompositionEnd;
+    private handleAfterRender;
+    private handleMouseWheel;
+    private handleMouseDown;
+    /**
+     * Setup detection for viewport changes (zoom/pan)
+     */
+    private setupViewportChangeDetection;
+    /**
+     * Restore original viewport methods
+     */
+    private restoreViewportChangeDetection;
+}
+/**
+ * Enter overlay text editing mode for a text object
+ */
+export declare function enterTextOverlayEdit(canvas: Canvas, target: FabricText | IText | Textbox, options?: {
+    onCommit?: (text: string) => void;
+    onCancel?: () => void;
+}): OverlayEditor;
+/**
+ * Check if a text object is currently being edited with overlay editor
+ */
+export declare function isInOverlayEdit(target: FabricText | IText | Textbox): boolean;
+//# sourceMappingURL=overlayEditor.d.ts.map

package/dist/src/text/overlayEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayEditor.d.ts","sourceRoot":"","sources":["../../../src/text/overlayEditor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAKjD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAyB;IAC1C,OAAO,CAAC,QAAQ,CAAC,CAAa;IAG9B,OAAO,CAAC,aAAa,CAUnB;gBAEU,OAAO,EAAE,oBAAoB;IAoBzC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmDxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwB5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;IAoHzB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0CrB;;OAEG;IACI,OAAO,IAAI,IAAI;IAMtB;;OAEG;IACI,OAAO,CAAC,MAAM,GAAE,OAAc,GAAG,IAAI;IAgD5C,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA2BpC;;OAEG;IACH,OAAO,CAAC,8BAA8B;CAavC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,OAAO,EACpC,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,GACA,aAAa,CAsBf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAE7E"}

package/dist/src/text/overlayEditor.min.mjs

@@ -0,0 +1,2 @@
+import{defineProperty as t}from"../../_virtual/_rollupPluginBabelHelpers.min.mjs";import{transformPoint as e}from"../util/misc/matrix.min.mjs";class s{constructor(e){t(this,"canvas",void 0),t(this,"target",void 0),t(this,"container",void 0),t(this,"textarea",void 0),t(this,"hostDiv",void 0),t(this,"isDestroyed",!1),t(this,"isComposing",!1),t(this,"lastText",void 0),t(this,"onCommit",void 0),t(this,"onCancel",void 0),t(this,"boundHandlers",{onInput:this.handleInput.bind(this),onKeyDown:this.handleKeyDown.bind(this),onBlur:this.handleBlur.bind(this),onCompositionStart:this.handleCompositionStart.bind(this),onCompositionEnd:this.handleCompositionEnd.bind(this),onAfterRender:this.handleAfterRender.bind(this),onMouseWheel:this.handleMouseWheel.bind(this),onFocus:this.handleFocus.bind(this),onMouseDown:this.handleMouseDown.bind(this)}),this.canvas=e.canvas,this.target=e.target,this.onCommit=e.onCommit,this.onCancel=e.onCancel,this.lastText=this.target.text||"",this.container=this.getCanvasContainer(),this.createOverlayDOM(),this.attachEventListeners(),this.refresh(),this.focusTextarea()}getCanvasContainer(){const t=this.canvas.upperCanvasEl.parentElement;if(!t)throw new Error("Canvas must be mounted in DOM to use overlay editing");return t.style.position="relative",t}createOverlayDOM(){this.hostDiv=document.createElement("div"),this.hostDiv.style.position="absolute",this.hostDiv.style.pointerEvents="none",this.hostDiv.style.zIndex="1000",this.hostDiv.style.transformOrigin="left top",this.textarea=document.createElement("textarea"),this.textarea.style.position="absolute",this.textarea.style.left="0",this.textarea.style.top="0",this.textarea.style.margin="0",this.textarea.style.resize="none",this.textarea.style.pointerEvents="auto";const t=/[\u0600-\u06FF\u0750-\u077F\uFB50-\uFDFF\uFE70-\uFEFF]/.test(this.target.text||""),e="ltr"===this.target.direction;this.textarea.style.unicodeBidi=t&&e?"embed":"plaintext",this.textarea.style.caretColor="auto",this.textarea.style.border="none",this.textarea.style.padding="0",this.textarea.style.background="transparent",this.textarea.style.outline="none",this.textarea.style.overflow="hidden",this.textarea.style.whiteSpace="pre-wrap",this.textarea.style.wordBreak="normal",this.textarea.style.overflowWrap="break-word",this.textarea.style.userSelect="text",this.textarea.style.textTransform="none",this.textarea.style.opacity="1",this.textarea.value=this.target.text||"",this.hostDiv.appendChild(this.textarea),document.body.appendChild(this.hostDiv)}attachEventListeners(){this.textarea.addEventListener("input",this.boundHandlers.onInput),this.textarea.addEventListener("keydown",this.boundHandlers.onKeyDown),this.textarea.addEventListener("blur",this.boundHandlers.onBlur),this.textarea.addEventListener("compositionstart",this.boundHandlers.onCompositionStart),this.textarea.addEventListener("compositionend",this.boundHandlers.onCompositionEnd),this.textarea.addEventListener("focus",this.boundHandlers.onFocus),this.canvas.on("after:render",this.boundHandlers.onAfterRender),this.canvas.on("mouse:wheel",this.boundHandlers.onMouseWheel),this.canvas.on("mouse:down",this.boundHandlers.onMouseDown),this.setupViewportChangeDetection()}removeEventListeners(){this.textarea.removeEventListener("input",this.boundHandlers.onInput),this.textarea.removeEventListener("keydown",this.boundHandlers.onKeyDown),this.textarea.removeEventListener("blur",this.boundHandlers.onBlur),this.textarea.removeEventListener("compositionstart",this.boundHandlers.onCompositionStart),this.textarea.removeEventListener("compositionend",this.boundHandlers.onCompositionEnd),this.textarea.removeEventListener("focus",this.boundHandlers.onFocus),this.canvas.off("after:render",this.boundHandlers.onAfterRender),this.canvas.off("mouse:wheel",this.boundHandlers.onMouseWheel),this.canvas.off("mouse:down",this.boundHandlers.onMouseDown),this.restoreViewportChangeDetection()}updatePosition(){this.applyOverlayStyle()}updateObjectBounds(){if(this.isDestroyed)return;const t=this.target,e=this.canvas.getZoom();parseFloat(this.hostDiv.style.width);const s=parseFloat(this.hostDiv.style.height)/e;Math.abs(s-t.height)>1&&(t.height=s,t.setCoords(),this.canvas.requestRenderAll())}letterSpacingPx(t,e){return t/1e3*e}firstStrongDir(t){return/[\u0590-\u05FF\u0600-\u06FF\u0750-\u077F\uFB50-\uFDFF\uFE70-\uFEFF]/.test(t)?"rtl":"ltr"}applyOverlayStyle(){var t,s;const i=this.target,a=this.canvas;i.setCoords();const o=i.aCoords;console.log("BEFORE EDIT:"),console.log("  target.width =",i.width),console.log("  target.height =",i.height),console.log("  target.getScaledWidth() =",i.getScaledWidth()),console.log("  target.getScaledHeight() =",i.getScaledHeight()),console.log("  target.padding =",i.padding);const n=a.upperCanvasEl.getBoundingClientRect(),r=window.scrollX||window.pageXOffset,h=window.scrollY||window.pageYOffset,l=a.getZoom(),d=a.viewportTransform,c=i.padding||0,v=c*(i.scaleX||1)*l,g=c*(i.scaleY||1)*l,u=e({x:o.tl.x,y:o.tl.y},d),p=n.left+r+u.x,y=n.top+h+u.y,x=i.width*(i.scaleX||1)*l,m=i.height*(i.scaleY||1)*l;console.log("WIDTH CALCULATION:"),console.log("  target.width =",i.width),console.log("  scaledWidth =",i.getScaledWidth()),console.log("  zoom =",l),console.log("  final width =",x),this.hostDiv.style.position="absolute",this.hostDiv.style.left=`${p}px`,this.hostDiv.style.top=`${y}px`,this.hostDiv.style.width=`${x}px`,this.hostDiv.style.height=`${m}px`,this.hostDiv.style.overflow="hidden",i.angle?(this.hostDiv.style.transform=`rotate(${i.angle}deg)`,this.hostDiv.style.transformOrigin="top left"):(this.hostDiv.style.transform="",this.hostDiv.style.transformOrigin="");const f=null!==(t=i.fontSize)&&void 0!==t?t:16,w=i.scaleX||1,b=f*w*l,C=i.lineHeight||1.16,D=v>0?`calc(100% - ${2*v}px)`:"100%",E=g>0?`calc(100% - ${2*g}px)`:"100%";this.textarea.style.width=D,this.textarea.style.height=E,this.textarea.style.padding=`${g}px ${v}px`,this.textarea.style.fontSize=`${b}px`,this.textarea.style.lineHeight=String(C),this.textarea.style.fontFamily=i.fontFamily||"Arial",this.textarea.style.fontWeight=String(i.fontWeight||"normal"),this.textarea.style.fontStyle=i.fontStyle||"normal",this.textarea.style.textAlign=i.textAlign||"left",this.textarea.style.color=(null===(s=i.fill)||void 0===s?void 0:s.toString())||"#000",this.textarea.style.letterSpacing=(i.charSpacing||0)/1e3+"em",this.textarea.style.direction=i.direction||this.firstStrongDir(this.textarea.value||""),this.textarea.style.fontVariant="normal",this.textarea.style.fontStretch="normal",this.textarea.style.textRendering="auto",this.textarea.style.fontKerning="auto",this.textarea.style.boxSizing="content-box",this.textarea.style.margin="0",this.textarea.style.border="none",this.textarea.style.outline="none",this.textarea.style.background="transparent",this.textarea.style.wordWrap="break-word",this.textarea.style.whiteSpace="pre-wrap",console.log("TEXTAREA AFTER SETUP:"),console.log("  textarea width =",this.textarea.style.width),console.log("  textarea height =",this.textarea.style.height),console.log("  textarea padding =",this.textarea.style.padding),console.log("  paddingX =",v,"paddingY =",g),console.log("  baseFontSize =",f),console.log("  scaleX =",w),console.log("  zoom =",l),console.log("  finalFontSize =",b),console.log("  fabricLineHeight =",C)}focusTextarea(){this.target.opacity=.01,this.target.selected=!0,this.target.isEditing=!1,this.target.set({hasControls:!0,hasBorders:!0,selectable:!0,lockMovementX:!1,lockMovementY:!1}),this.canvas.setActiveObject(this.target),this.canvas.requestRenderAll(),this.target.setCoords(),this.applyOverlayStyle(),this.textarea.focus(),this.textarea.setSelectionRange(this.textarea.value.length,this.textarea.value.length),this.canvas.setActiveObject(this.target),this.canvas.requestRenderAll()}refresh(){this.isDestroyed||this.updatePosition()}destroy(){let t=!(arguments.length>0&&void 0!==arguments[0])||arguments[0];if(!this.isDestroyed){if(this.isDestroyed=!0,this.removeEventListeners(),this.target.__overlayEditor===this&&(this.target.__overlayEditor=void 0,void 0!==this.target.__overlayOriginalOpacity&&(this.target.opacity=this.target.__overlayOriginalOpacity,delete this.target.__overlayOriginalOpacity)),this.hostDiv.parentNode&&this.hostDiv.parentNode.removeChild(this.hostDiv),t&&!this.isComposing){const t=this.textarea.value;this.onCommit&&this.onCommit(t)}else!t&&this.onCancel&&this.onCancel();setTimeout(()=>{this.canvas.upperCanvasEl.style.cursor="",this.canvas.setCursor(this.canvas.defaultCursor)},0),this.canvas.requestRenderAll()}}handleInput(){this.isComposing||this.target.text===this.textarea.value||(this.target.text=this.textarea.value,this.autoResizeTextarea(),this.target.selected=!0,this.target.isEditing=!1,this.canvas.setActiveObject(this.target),this.canvas.requestRenderAll())}autoResizeTextarea(){const t=parseFloat(window.getComputedStyle(this.textarea).height);this.textarea.style.height="auto";const e=this.textarea.scrollHeight,s=Math.max(e+8,25),i=Math.abs(s-t)>2;this.textarea.style.height=`${s}px`,this.hostDiv.style.height=`${s}px`,i&&this.updateObjectBounds()}handleKeyDown(t){"Escape"===t.key?(t.preventDefault(),this.destroy(!1)):(t.ctrlKey||t.metaKey)&&"Enter"===t.key&&(t.preventDefault(),this.destroy(!0))}handleFocus(){}handleBlur(){this.isComposing||this.destroy(!0)}handleCompositionStart(){this.isComposing=!0}handleCompositionEnd(){this.isComposing=!1,this.handleInput()}handleAfterRender(){this.refresh()}handleMouseWheel(){this.refresh()}handleMouseDown(t){t.target!==this.target&&this.destroy(!0)}setupViewportChangeDetection(){this.canvas.__originalSetZoom=this.canvas.setZoom,this.canvas.__originalSetViewportTransform=this.canvas.setViewportTransform,this.canvas.__overlayEditor=this;const t=this.canvas.setZoom.bind(this.canvas);this.canvas.setZoom=e=>{const s=t(e);return this.canvas.__overlayEditor&&!this.isDestroyed&&this.refresh(),s};const e=this.canvas.setViewportTransform.bind(this.canvas);this.canvas.setViewportTransform=t=>{const s=e(t);return this.canvas.__overlayEditor&&!this.isDestroyed&&this.refresh(),s}}restoreViewportChangeDetection(){this.canvas.__originalSetZoom&&(this.canvas.setZoom=this.canvas.__originalSetZoom,delete this.canvas.__originalSetZoom),this.canvas.__originalSetViewportTransform&&(this.canvas.setViewportTransform=this.canvas.__originalSetViewportTransform,delete this.canvas.__originalSetViewportTransform),delete this.canvas.__overlayEditor}}function i(t,e,i){e.__overlayEditor&&e.__overlayEditor.destroy(!1),e.__overlayOriginalOpacity=e.opacity;const a=new s({canvas:t,target:e,onCommit:null==i?void 0:i.onCommit,onCancel:null==i?void 0:i.onCancel});return e.__overlayEditor=a,a}export{s as OverlayEditor,i as enterTextOverlayEdit};
+//# sourceMappingURL=overlayEditor.min.mjs.map