three-text 0.2.18 → 0.2.19

package/README.md

@@ -4,7 +4,7 @@
 [![TypeScript](https://img.shields.io/badge/built%20with-TypeScript-007acc.svg)](https://www.typescriptlang.org/)
 [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3_or_later-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
 
-A high fidelity 3D font renderer and text layout engine for the web
+High fidelity 3D mesh font geometry and text layout engine for the web
 
 ![Screenshot of three-text example file](https://countertype.com/assets/three-text/3D.png)
 
@@ -15,11 +15,7 @@ A high fidelity 3D font renderer and text layout engine for the web
 > [!CAUTION]
 > three-text is an alpha release and the API may break rapidly. This warning will last at least through the end of 2025. If API stability is important to you, consider pinning your version. Community feedback is encouraged; please open an issue if you have any suggestions or feedback, thank you
 
-
-          text: `three-text is a 3D font geometry and text layout library for the web. Its supports TTF, OTF, and WOFF font files. For layout, it uses Tex-based parameters for breaking text into paragraphs across multiple lines and supports CJK and RTL scripts. three-text caches the geometries it generates for low CPU overhead in languages with lots of repeating glyphs. Variable fonts are supported as static instances at a given axis coordinate, and can be animated by re-drawing each frame with new coordinates. The library has a framework-agnostic core that returns raw vertex data, with lightweight adapters for Three.js, React Three Fiber, p5.js, WebGL and WebGPU. Under the hood, three-text relies on HarfBuzz for text shaping, Knuth-Plass line breaking, Liang hyphenation, libtess by Eric Veach for tessellation, curve polygonization from Maxim Shemanarev's Anti-Grain Geometry, and Visvalingam-Whyatt line simplification`,
-
-
-**three-text** is a 3D font geometry and text layout library for the web. It supports TTF, OTF, and WOFF font files. For layout, it uses [TeX](https://en.wikipedia.org/wiki/TeX)-based parameters for breaking text into paragraphs across multiple lines and supports CJK and RTL scripts. three-text caches the geometries it generates for low CPU overhead in languages with lots of repeating glyphs. Variable fonts are supported as static instances at a given axis coordinate, and can be animated by re-drawing each frame with new coordinates
+**three-text** is a 3D mesh font geometry and text layout library for the web. It supports TTF, OTF, and WOFF font files. For layout, it uses [TeX](https://en.wikipedia.org/wiki/TeX)-based parameters for breaking text into paragraphs across multiple lines and supports CJK and RTL scripts. three-text caches the geometries it generates for low CPU overhead in languages with lots of repeating glyphs. Variable fonts are supported as static instances at a given axis coordinate, and can be animated by re-drawing each frame with new coordinates
 
 The library has a framework-agnostic core that returns raw vertex data, with lightweight adapters for [Three.js](https://threejs.org), [React Three Fiber](https://docs.pmnd.rs/react-three-fiber), [p5.js](https://p5js.org), [WebGL](https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API), and [WebGPU](https://developer.mozilla.org/en-US/docs/Web/API/WebGPU_API)
 
@@ -556,7 +552,7 @@ const text = await Text.create({
 
 Values can be boolean (`true`/`false`) to enable or disable, or numeric for features accepting variant indices. Explicitly disabling a feature overrides the font's defaults
 
-Common tags include [`liga`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_ko#liga) (ligatures), [`kern`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_ko#kern) (kerning), [`calt`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_ae#calt) (contextual alternates), and [`smcp`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_pt#smcp) (small capitals). Number styling uses [`lnum`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_ko#lnum)/[`onum`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_ko#onum)/[`tnum`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_pt#tnum). Stylistic alternates are [`ss01`-`ss20`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_pt#ss01--ss20) and [`cv01`-`cv99`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_ae#cv01--cv99). Feature availability depends on the font
+Common tags include [`liga`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_ko#liga) (ligatures),  [`calt`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_ae#calt) (contextual alternates), [`tnum`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_pt#tnum) (tabular numbers), sylistic alternates [`ss01`-`ss20`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_pt#ss01--ss20) and character variants [`cv01`-`cv99`](https://learn.microsoft.com/en-us/typography/opentype/spec/features_ae#cv01--cv99). Feature availability depends on the font
 
 ### Per-glyph attributes
 
@@ -736,6 +732,10 @@ Initializes HarfBuzz WebAssembly. Called automatically by `create()`, but can be
 
 Preloads hyphenation patterns for specified languages. Useful for avoiding async pattern loading during text rendering
 
+##### `Text.setMaxFontCacheMemoryMB(limitMB: number): void`
+
+Sets an upper bound for the font cache, measured by the raw font buffer size, eviction is FIFO by insertion order
+
 #### Instance Methods
 
 The following methods are available on instances created by `Text.create()`:
@@ -753,7 +753,7 @@ Below are the most important configuration interfaces. For a complete list of al
 ```typescript
 interface TextOptions {
   text: string; // Text content to render
-  font?: string | ArrayBuffer; // Font file path or buffer (TTF, OTF, or WOFF)
+  font: string | ArrayBuffer; // Font file path or buffer (TTF, OTF, or WOFF)
   size?: number; // Font size in scene units (default: 72)
   depth?: number; // Extrusion depth (default: 0)
   lineHeight?: number; // Line height multiplier (default: 1.0)

package/dist/index.cjs

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.18
+ * three-text v0.2.19
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -81,7 +81,9 @@ class PerformanceLogger {
         // Find the metric in reverse order (most recent first)
         for (let i = this.metrics.length - 1; i >= 0; i--) {
             const metric = this.metrics[i];
-            if (metric.name === name && metric.startTime === startTime && !metric.endTime) {
+            if (metric.name === name &&
+                metric.startTime === startTime &&
+                !metric.endTime) {
                 metric.endTime = endTime;
                 metric.duration = duration;
                 break;
@@ -469,7 +471,9 @@ class LineBreak {
             const char = chars[i];
             const nextChar = i < chars.length - 1 ? chars[i + 1] : null;
             if (/\s/.test(char)) {
-                const width = widths ? (widths[i] ?? measureText(char)) : measureText(char);
+                const width = widths
+                    ? (widths[i] ?? measureText(char))
+                    : measureText(char);
                 items.push({
                     type: ItemType.GLUE,
                     width,
@@ -842,7 +846,9 @@ class LineBreak {
             if (breaks.length === 0) {
                 // For first emergency attempt, use initialEmergencyStretch
                 // For subsequent iterations (short line detection), progressively increase
-                currentEmergencyStretch = initialEmergencyStretch + (iteration * width * SHORT_LINE_EMERGENCY_STRETCH_INCREMENT);
+                currentEmergencyStretch =
+                    initialEmergencyStretch +
+                        iteration * width * SHORT_LINE_EMERGENCY_STRETCH_INCREMENT;
                 breaks = LineBreak.findBreakpoints(currentItems, width, tolerance, looseness, true, currentEmergencyStretch, context);
             }
             // Last resort: allow higher badness (but not infinite)
@@ -1723,12 +1729,12 @@ class FontMetadataExtractor {
         try {
             if (gsubTableOffset) {
                 const gsubData = this.extractFeatureDataFromTable(view, gsubTableOffset, nameTableOffset);
-                gsubData.features.forEach(f => features.add(f));
+                gsubData.features.forEach((f) => features.add(f));
                 Object.assign(featureNames, gsubData.names);
             }
             if (gposTableOffset) {
                 const gposData = this.extractFeatureDataFromTable(view, gposTableOffset, nameTableOffset);
-                gposData.features.forEach(f => features.add(f));
+                gposData.features.forEach((f) => features.add(f));
                 Object.assign(featureNames, gposData.names);
             }
         }
@@ -2729,7 +2735,7 @@ class Tessellator {
         let extrusionContours = needsExtrusionContours
             ? needsWindingReversal
                 ? tessContours
-                : originalContours ?? this.pathsToContours(paths)
+                : (originalContours ?? this.pathsToContours(paths))
             : [];
         if (removeOverlaps) {
             logger.log('Two-pass: boundary extraction then triangulation');
@@ -2762,7 +2768,10 @@ class Tessellator {
                 ? 'libtess returned empty result from triangulation pass'
                 : 'libtess returned empty result from single-pass triangulation';
             logger.warn(warning);
-            return { triangles: { vertices: [], indices: [] }, contours: extrusionContours };
+            return {
+                triangles: { vertices: [], indices: [] },
+                contours: extrusionContours
+            };
         }
         return {
             triangles: {
@@ -3419,9 +3428,7 @@ class PathOptimizer {
             const v1LenSq = v1x * v1x + v1y * v1y;
             const v2LenSq = v2x * v2x + v2y * v2y;
             const minLenSq = this.config.minSegmentLength * this.config.minSegmentLength;
-            if (angle > threshold ||
-                v1LenSq < minLenSq ||
-                v2LenSq < minLenSq) {
+            if (angle > threshold || v1LenSq < minLenSq || v2LenSq < minLenSq) {
                 result.push(current);
             }
             else {
@@ -4183,7 +4190,7 @@ class GlyphGeometryBuilder {
                         const relativePositions = cluster.glyphs.map((g) => new Vec3(g.x ?? 0, g.y ?? 0, 0));
                         boundaryGroups = this.clusterer.cluster(clusterGlyphContours, relativePositions);
                         this.clusteringCache.set(cacheKey, {
-                            glyphIds: cluster.glyphs.map(g => g.g),
+                            glyphIds: cluster.glyphs.map((g) => g.g),
                             groups: boundaryGroups
                         });
                     }
@@ -4573,7 +4580,8 @@ class TextShaper {
                     if (LineBreak.isCJOpeningPunctuation(currentChar)) {
                         shouldApply = false;
                     }
-                    if (LineBreak.isCJPunctuation(currentChar) && LineBreak.isCJPunctuation(nextChar)) {
+                    if (LineBreak.isCJPunctuation(currentChar) &&
+                        LineBreak.isCJPunctuation(nextChar)) {
                         shouldApply = false;
                     }
                     if (shouldApply) {
@@ -5377,7 +5385,7 @@ class Text {
     // Stringify with sorted keys for cache stability
     static stableStringify(obj) {
         const keys = Object.keys(obj).sort();
-        const pairs = keys.map(k => `${k}:${obj[k]}`);
+        const pairs = keys.map((k) => `${k}:${obj[k]}`);
         return pairs.join(',');
     }
     constructor() {
@@ -5615,7 +5623,9 @@ class Text {
             // to selectively use glyph-level caching (separate vertices) only for clusters containing
             // colored text, while non-colored clusters can still use fast cluster-level merging
             let coloredTextIndices;
-            if (options.color && typeof options.color === 'object' && !Array.isArray(options.color)) {
+            if (options.color &&
+                typeof options.color === 'object' &&
+                !Array.isArray(options.color)) {
                 if (options.color.byText || options.color.byCharRange) {
                     // Build the set manually since glyphs don't exist yet
                     coloredTextIndices = new Set();
@@ -5720,7 +5730,9 @@ class Text {
         const depthScale = this.loadedFont.upem / size;
         const rawDepthInFontUnits = depth * depthScale;
         const minExtrudeDepth = this.loadedFont.upem * 0.000025;
-        const depthInFontUnits = rawDepthInFontUnits <= 0 ? 0 : Math.max(rawDepthInFontUnits, minExtrudeDepth);
+        const depthInFontUnits = rawDepthInFontUnits <= 0
+            ? 0
+            : Math.max(rawDepthInFontUnits, minExtrudeDepth);
         if (!this.textLayout) {
             this.textLayout = new TextLayout(this.loadedFont);
         }
@@ -5892,10 +5904,12 @@ class Text {
         planeBounds.max.z *= finalScale;
         for (let i = 0; i < glyphInfoArray.length; i++) {
             const glyphInfo = glyphInfoArray[i];
-            glyphInfo.bounds.min.x = glyphInfo.bounds.min.x * finalScale + offsetScaled;
+            glyphInfo.bounds.min.x =
+                glyphInfo.bounds.min.x * finalScale + offsetScaled;
             glyphInfo.bounds.min.y *= finalScale;
             glyphInfo.bounds.min.z *= finalScale;
-            glyphInfo.bounds.max.x = glyphInfo.bounds.max.x * finalScale + offsetScaled;
+            glyphInfo.bounds.max.x =
+                glyphInfo.bounds.max.x * finalScale + offsetScaled;
             glyphInfo.bounds.max.y *= finalScale;
             glyphInfo.bounds.max.z *= finalScale;
         }
@@ -5958,13 +5972,11 @@ class Text {
     static registerPattern(language, pattern) {
         Text.patternCache.set(language, pattern);
     }
-    static clearFontCache() {
-        Text.fontCache.clear();
-        Text.fontCacheMemoryBytes = 0;
-    }
     static setMaxFontCacheMemoryMB(limitMB) {
         Text.maxFontCacheMemoryBytes =
-            limitMB === Infinity ? Infinity : Math.max(1, Math.floor(limitMB)) * 1024 * 1024;
+            limitMB === Infinity
+                ? Infinity
+                : Math.max(1, Math.floor(limitMB)) * 1024 * 1024;
         Text.enforceFontCacheMemoryLimit();
     }
     getLoadedFont() {

package/dist/index.d.ts

@@ -5,6 +5,45 @@ interface HyphenationTrieNode {
     };
 }
 
+interface LRUCacheOptions<K, V> {
+    maxEntries?: number;
+    maxMemoryBytes?: number;
+    calculateSize?: (value: V) => number;
+    onEvict?: (key: K, value: V) => void;
+}
+interface CacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    size: number;
+    memoryUsage: number;
+}
+declare class LRUCache<K, V> {
+    private cache;
+    private head;
+    private tail;
+    private stats;
+    private options;
+    constructor(options?: LRUCacheOptions<K, V>);
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    set(key: K, value: V): void;
+    delete(key: K): boolean;
+    clear(): void;
+    getStats(): CacheStats & {
+        hitRate: number;
+        memoryUsageMB: number;
+    };
+    keys(): K[];
+    get size(): number;
+    private evictIfNeeded;
+    private evictTail;
+    private addToHead;
+    private removeNode;
+    private removeTail;
+    private moveToHead;
+}
+
 interface BoundingBox {
     min: {
         x: number;
@@ -221,13 +260,19 @@ interface TextGeometryInfo {
         pointsRemovedByVisvalingam: number;
         pointsRemovedByColinear: number;
         originalPointCount: number;
-    };
+    } & Partial<CacheStats & {
+        hitRate: number;
+        memoryUsageMB: number;
+    }>;
     query(options: TextQueryOptions): TextRange[];
     coloredRanges?: ColoredRange[];
 }
 interface TextHandle extends TextGeometryInfo {
     getLoadedFont(): LoadedFont | undefined;
-    getCacheStatistics(): any;
+    getCacheStatistics(): (CacheStats & {
+        hitRate: number;
+        memoryUsageMB: number;
+    }) | null;
     clearCache(): void;
     measureTextWidth(text: string, letterSpacing?: number): number;
     update(options: Partial<TextOptions>): Promise<TextHandle>;
@@ -266,7 +311,7 @@ interface ColoredRange {
 }
 interface TextOptions {
     text: string;
-    font?: string | ArrayBuffer;
+    font: string | ArrayBuffer;
     size?: number;
     depth?: number;
     lineHeight?: number;
@@ -367,7 +412,6 @@ declare class Text {
     getFontMetrics(): FontMetrics;
     static preloadPatterns(languages: string[], patternsPath?: string): Promise<void>;
     static registerPattern(language: string, pattern: HyphenationTrieNode): void;
-    static clearFontCache(): void;
     static setMaxFontCacheMemoryMB(limitMB: number): void;
     getLoadedFont(): LoadedFont | undefined;
     measureTextWidth(text: string, letterSpacing?: number): number;
@@ -436,45 +480,6 @@ declare class FontMetadataExtractor {
     static getFontMetrics(metrics: ExtractedMetrics): FontMetrics;
 }
 
-interface LRUCacheOptions<K, V> {
-    maxEntries?: number;
-    maxMemoryBytes?: number;
-    calculateSize?: (value: V) => number;
-    onEvict?: (key: K, value: V) => void;
-}
-interface CacheStats {
-    hits: number;
-    misses: number;
-    evictions: number;
-    size: number;
-    memoryUsage: number;
-}
-declare class LRUCache<K, V> {
-    private cache;
-    private head;
-    private tail;
-    private stats;
-    private options;
-    constructor(options?: LRUCacheOptions<K, V>);
-    get(key: K): V | undefined;
-    has(key: K): boolean;
-    set(key: K, value: V): void;
-    delete(key: K): boolean;
-    clear(): void;
-    getStats(): CacheStats & {
-        hitRate: number;
-        memoryUsageMB: number;
-    };
-    keys(): K[];
-    get size(): number;
-    private evictIfNeeded;
-    private evictTail;
-    private addToHead;
-    private removeNode;
-    private removeTail;
-    private moveToHead;
-}
-
 declare const globalGlyphCache: LRUCache<string, GlyphData>;
 declare function createGlyphCache(maxCacheSizeMB?: number): LRUCache<string, GlyphData>;
 

package/dist/index.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.18
+ * three-text v0.2.19
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -78,7 +78,9 @@ class PerformanceLogger {
         // Find the metric in reverse order (most recent first)
         for (let i = this.metrics.length - 1; i >= 0; i--) {
             const metric = this.metrics[i];
-            if (metric.name === name && metric.startTime === startTime && !metric.endTime) {
+            if (metric.name === name &&
+                metric.startTime === startTime &&
+                !metric.endTime) {
                 metric.endTime = endTime;
                 metric.duration = duration;
                 break;
@@ -466,7 +468,9 @@ class LineBreak {
             const char = chars[i];
             const nextChar = i < chars.length - 1 ? chars[i + 1] : null;
             if (/\s/.test(char)) {
-                const width = widths ? (widths[i] ?? measureText(char)) : measureText(char);
+                const width = widths
+                    ? (widths[i] ?? measureText(char))
+                    : measureText(char);
                 items.push({
                     type: ItemType.GLUE,
                     width,
@@ -839,7 +843,9 @@ class LineBreak {
             if (breaks.length === 0) {
                 // For first emergency attempt, use initialEmergencyStretch
                 // For subsequent iterations (short line detection), progressively increase
-                currentEmergencyStretch = initialEmergencyStretch + (iteration * width * SHORT_LINE_EMERGENCY_STRETCH_INCREMENT);
+                currentEmergencyStretch =
+                    initialEmergencyStretch +
+                        iteration * width * SHORT_LINE_EMERGENCY_STRETCH_INCREMENT;
                 breaks = LineBreak.findBreakpoints(currentItems, width, tolerance, looseness, true, currentEmergencyStretch, context);
             }
             // Last resort: allow higher badness (but not infinite)
@@ -1720,12 +1726,12 @@ class FontMetadataExtractor {
         try {
             if (gsubTableOffset) {
                 const gsubData = this.extractFeatureDataFromTable(view, gsubTableOffset, nameTableOffset);
-                gsubData.features.forEach(f => features.add(f));
+                gsubData.features.forEach((f) => features.add(f));
                 Object.assign(featureNames, gsubData.names);
             }
             if (gposTableOffset) {
                 const gposData = this.extractFeatureDataFromTable(view, gposTableOffset, nameTableOffset);
-                gposData.features.forEach(f => features.add(f));
+                gposData.features.forEach((f) => features.add(f));
                 Object.assign(featureNames, gposData.names);
             }
         }
@@ -2726,7 +2732,7 @@ class Tessellator {
         let extrusionContours = needsExtrusionContours
             ? needsWindingReversal
                 ? tessContours
-                : originalContours ?? this.pathsToContours(paths)
+                : (originalContours ?? this.pathsToContours(paths))
             : [];
         if (removeOverlaps) {
             logger.log('Two-pass: boundary extraction then triangulation');
@@ -2759,7 +2765,10 @@ class Tessellator {
                 ? 'libtess returned empty result from triangulation pass'
                 : 'libtess returned empty result from single-pass triangulation';
             logger.warn(warning);
-            return { triangles: { vertices: [], indices: [] }, contours: extrusionContours };
+            return {
+                triangles: { vertices: [], indices: [] },
+                contours: extrusionContours
+            };
         }
         return {
             triangles: {
@@ -3416,9 +3425,7 @@ class PathOptimizer {
             const v1LenSq = v1x * v1x + v1y * v1y;
             const v2LenSq = v2x * v2x + v2y * v2y;
             const minLenSq = this.config.minSegmentLength * this.config.minSegmentLength;
-            if (angle > threshold ||
-                v1LenSq < minLenSq ||
-                v2LenSq < minLenSq) {
+            if (angle > threshold || v1LenSq < minLenSq || v2LenSq < minLenSq) {
                 result.push(current);
             }
             else {
@@ -4180,7 +4187,7 @@ class GlyphGeometryBuilder {
                         const relativePositions = cluster.glyphs.map((g) => new Vec3(g.x ?? 0, g.y ?? 0, 0));
                         boundaryGroups = this.clusterer.cluster(clusterGlyphContours, relativePositions);
                         this.clusteringCache.set(cacheKey, {
-                            glyphIds: cluster.glyphs.map(g => g.g),
+                            glyphIds: cluster.glyphs.map((g) => g.g),
                             groups: boundaryGroups
                         });
                     }
@@ -4570,7 +4577,8 @@ class TextShaper {
                     if (LineBreak.isCJOpeningPunctuation(currentChar)) {
                         shouldApply = false;
                     }
-                    if (LineBreak.isCJPunctuation(currentChar) && LineBreak.isCJPunctuation(nextChar)) {
+                    if (LineBreak.isCJPunctuation(currentChar) &&
+                        LineBreak.isCJPunctuation(nextChar)) {
                         shouldApply = false;
                     }
                     if (shouldApply) {
@@ -5374,7 +5382,7 @@ class Text {
     // Stringify with sorted keys for cache stability
     static stableStringify(obj) {
         const keys = Object.keys(obj).sort();
-        const pairs = keys.map(k => `${k}:${obj[k]}`);
+        const pairs = keys.map((k) => `${k}:${obj[k]}`);
         return pairs.join(',');
     }
     constructor() {
@@ -5612,7 +5620,9 @@ class Text {
             // to selectively use glyph-level caching (separate vertices) only for clusters containing
             // colored text, while non-colored clusters can still use fast cluster-level merging
             let coloredTextIndices;
-            if (options.color && typeof options.color === 'object' && !Array.isArray(options.color)) {
+            if (options.color &&
+                typeof options.color === 'object' &&
+                !Array.isArray(options.color)) {
                 if (options.color.byText || options.color.byCharRange) {
                     // Build the set manually since glyphs don't exist yet
                     coloredTextIndices = new Set();
@@ -5717,7 +5727,9 @@ class Text {
         const depthScale = this.loadedFont.upem / size;
         const rawDepthInFontUnits = depth * depthScale;
         const minExtrudeDepth = this.loadedFont.upem * 0.000025;
-        const depthInFontUnits = rawDepthInFontUnits <= 0 ? 0 : Math.max(rawDepthInFontUnits, minExtrudeDepth);
+        const depthInFontUnits = rawDepthInFontUnits <= 0
+            ? 0
+            : Math.max(rawDepthInFontUnits, minExtrudeDepth);
         if (!this.textLayout) {
             this.textLayout = new TextLayout(this.loadedFont);
         }
@@ -5889,10 +5901,12 @@ class Text {
         planeBounds.max.z *= finalScale;
         for (let i = 0; i < glyphInfoArray.length; i++) {
             const glyphInfo = glyphInfoArray[i];
-            glyphInfo.bounds.min.x = glyphInfo.bounds.min.x * finalScale + offsetScaled;
+            glyphInfo.bounds.min.x =
+                glyphInfo.bounds.min.x * finalScale + offsetScaled;
             glyphInfo.bounds.min.y *= finalScale;
             glyphInfo.bounds.min.z *= finalScale;
-            glyphInfo.bounds.max.x = glyphInfo.bounds.max.x * finalScale + offsetScaled;
+            glyphInfo.bounds.max.x =
+                glyphInfo.bounds.max.x * finalScale + offsetScaled;
             glyphInfo.bounds.max.y *= finalScale;
             glyphInfo.bounds.max.z *= finalScale;
         }
@@ -5955,13 +5969,11 @@ class Text {
     static registerPattern(language, pattern) {
         Text.patternCache.set(language, pattern);
     }
-    static clearFontCache() {
-        Text.fontCache.clear();
-        Text.fontCacheMemoryBytes = 0;
-    }
     static setMaxFontCacheMemoryMB(limitMB) {
         Text.maxFontCacheMemoryBytes =
-            limitMB === Infinity ? Infinity : Math.max(1, Math.floor(limitMB)) * 1024 * 1024;
+            limitMB === Infinity
+                ? Infinity
+                : Math.max(1, Math.floor(limitMB)) * 1024 * 1024;
         Text.enforceFontCacheMemoryLimit();
     }
     getLoadedFont() {

package/dist/index.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.18
+ * three-text v0.2.19
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -886,10 +886,10 @@ w=e.colors,m=e.fc}const v=this.Ar.bn()
 return{vertices:t,normals:e,indices:i,colors:w,glyphs:s,planeBounds:n,stats:{dc:i.length/3,yc:t.length/3,Ls:v.Ls,Ms:v.Ms,Is:v.Is,...o||{}},query(t){if(!h)throw Error("Original text not available for querying")
 return new gt(h,s).xa(t)},fc:m,glyphAttributes:void 0}}Ce(){if(!this.le)throw Error("Font not loaded. Call loadFont() first")
 return B.Ce(this.le.p)}static async wc(t,e){await Promise.all(t.map(async t=>{if(!xt.Ma.has(t))try{const s=await i(t,e)
-xt.Ma.set(t,s)}catch(e){l.warn(`Failed to pre-load patterns for ${t}: ${e}`)}}))}static mc(t,e){xt.Ma.set(t,e)}static vc(){xt.Ga.clear(),xt.Oa=0}static gc(t){xt.Fa=t===1/0?1/0:1048576*Math.max(1,Math.floor(t)),xt.Va()}getLoadedFont(){return this.le}measureTextWidth(t,e=0){if(!this.le)throw Error("Font not loaded. Call loadFont() first")
+xt.Ma.set(t,s)}catch(e){l.warn(`Failed to pre-load patterns for ${t}: ${e}`)}}))}static mc(t,e){xt.Ma.set(t,e)}static vc(t){xt.Fa=t===1/0?1/0:1048576*Math.max(1,Math.floor(t)),xt.Va()}getLoadedFont(){return this.le}measureTextWidth(t,e=0){if(!this.le)throw Error("Font not loaded. Call loadFont() first")
 return G.measureTextWidth(this.le,t,e)}getCacheStatistics(){return this.Ar?this.Ar.Er():null}clearCache(){this.Ar&&this.Ar.clearCache()}hc(t,e){const i=new Float32Array(3*t),s=new Float32Array(t),n=new Float32Array(t)
 return e.forEach((e,r)=>{const o=(e.bounds.min.x+e.bounds.max.x)/2,h=(e.bounds.min.y+e.bounds.max.y)/2,a=(e.bounds.min.z+e.bounds.max.z)/2
 for(let c=0;e.gr>c;c++){const l=e.nr+c
-t>l&&(i[3*l]=o,i[3*l+1]=h,i[3*l+2]=a,s[l]=r,n[l]=e.vr)}}),{xc:i,dn:s,Sc:n}}ja(){this.Ar=void 0,this.tc=void 0,this.lc=void 0}destroy(){if(!this.le)return
+t>l&&(i[3*l]=o,i[3*l+1]=h,i[3*l+2]=a,s[l]=r,n[l]=e.vr)}}),{gc:i,dn:s,xc:n}}ja(){this.Ar=void 0,this.tc=void 0,this.lc=void 0}destroy(){if(!this.le)return
 const t=this.le
 try{$.Ze(t)}catch(t){l.warn("Error destroying HarfBuzz objects:",t)}finally{this.le=void 0,this.lc=void 0,this.tc=void 0}}}exports.DEFAULT_CURVE_FIDELITY=it,exports.FontMetadataExtractor=B,exports.Text=xt,exports.createGlyphCache=r,exports.globalGlyphCache=z

package/dist/index.min.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.18
+ * three-text v0.2.19
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -885,10 +885,10 @@ w=e.colors,v=e.fc}const m=this.Ar.bn()
 return{vertices:t,normals:e,indices:i,colors:w,glyphs:s,planeBounds:n,stats:{dc:i.length/3,yc:t.length/3,Ls:m.Ls,Ms:m.Ms,Is:m.Is,...o||{}},query(t){if(!h)throw Error("Original text not available for querying")
 return new mt(h,s).xa(t)},fc:v,glyphAttributes:void 0}}Ce(){if(!this.le)throw Error("Font not loaded. Call loadFont() first")
 return C.Ce(this.le.p)}static async wc(t,e){await Promise.all(t.map(async t=>{if(!gt.Ma.has(t))try{const s=await i(t,e)
-gt.Ma.set(t,s)}catch(e){c.warn(`Failed to pre-load patterns for ${t}: ${e}`)}}))}static vc(t,e){gt.Ma.set(t,e)}static mc(){gt.Ga.clear(),gt.Oa=0}static gc(t){gt.Fa=t===1/0?1/0:1048576*Math.max(1,Math.floor(t)),gt.Va()}getLoadedFont(){return this.le}measureTextWidth(t,e=0){if(!this.le)throw Error("Font not loaded. Call loadFont() first")
+gt.Ma.set(t,s)}catch(e){c.warn(`Failed to pre-load patterns for ${t}: ${e}`)}}))}static vc(t,e){gt.Ma.set(t,e)}static mc(t){gt.Fa=t===1/0?1/0:1048576*Math.max(1,Math.floor(t)),gt.Va()}getLoadedFont(){return this.le}measureTextWidth(t,e=0){if(!this.le)throw Error("Font not loaded. Call loadFont() first")
 return I.measureTextWidth(this.le,t,e)}getCacheStatistics(){return this.Ar?this.Ar._r():null}clearCache(){this.Ar&&this.Ar.clearCache()}hc(t,e){const i=new Float32Array(3*t),s=new Float32Array(t),n=new Float32Array(t)
 return e.forEach((e,r)=>{const o=(e.bounds.min.x+e.bounds.max.x)/2,h=(e.bounds.min.y+e.bounds.max.y)/2,a=(e.bounds.min.z+e.bounds.max.z)/2
 for(let c=0;e.gr>c;c++){const l=e.nr+c
-t>l&&(i[3*l]=o,i[3*l+1]=h,i[3*l+2]=a,s[l]=r,n[l]=e.mr)}}),{xc:i,dn:s,Sc:n}}za(){this.Ar=void 0,this.tc=void 0,this.lc=void 0}destroy(){if(!this.le)return
+t>l&&(i[3*l]=o,i[3*l+1]=h,i[3*l+2]=a,s[l]=r,n[l]=e.mr)}}),{gc:i,dn:s,xc:n}}za(){this.Ar=void 0,this.tc=void 0,this.lc=void 0}destroy(){if(!this.le)return
 const t=this.le
 try{$.Ze(t)}catch(t){c.warn("Error destroying HarfBuzz objects:",t)}finally{this.le=void 0,this.lc=void 0,this.tc=void 0}}}export{et as DEFAULT_CURVE_FIDELITY,C as FontMetadataExtractor,gt as Text,r as createGlyphCache,z as globalGlyphCache}

package/dist/index.umd.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.18
+ * three-text v0.2.19
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -83,7 +83,9 @@
             // Find the metric in reverse order (most recent first)
             for (let i = this.metrics.length - 1; i >= 0; i--) {
                 const metric = this.metrics[i];
-                if (metric.name === name && metric.startTime === startTime && !metric.endTime) {
+                if (metric.name === name &&
+                    metric.startTime === startTime &&
+                    !metric.endTime) {
                     metric.endTime = endTime;
                     metric.duration = duration;
                     break;
@@ -471,7 +473,9 @@
                 const char = chars[i];
                 const nextChar = i < chars.length - 1 ? chars[i + 1] : null;
                 if (/\s/.test(char)) {
-                    const width = widths ? (widths[i] ?? measureText(char)) : measureText(char);
+                    const width = widths
+                        ? (widths[i] ?? measureText(char))
+                        : measureText(char);
                     items.push({
                         type: ItemType.GLUE,
                         width,
@@ -844,7 +848,9 @@
                 if (breaks.length === 0) {
                     // For first emergency attempt, use initialEmergencyStretch
                     // For subsequent iterations (short line detection), progressively increase
-                    currentEmergencyStretch = initialEmergencyStretch + (iteration * width * SHORT_LINE_EMERGENCY_STRETCH_INCREMENT);
+                    currentEmergencyStretch =
+                        initialEmergencyStretch +
+                            iteration * width * SHORT_LINE_EMERGENCY_STRETCH_INCREMENT;
                     breaks = LineBreak.findBreakpoints(currentItems, width, tolerance, looseness, true, currentEmergencyStretch, context);
                 }
                 // Last resort: allow higher badness (but not infinite)
@@ -1725,12 +1731,12 @@
             try {
                 if (gsubTableOffset) {
                     const gsubData = this.extractFeatureDataFromTable(view, gsubTableOffset, nameTableOffset);
-                    gsubData.features.forEach(f => features.add(f));
+                    gsubData.features.forEach((f) => features.add(f));
                     Object.assign(featureNames, gsubData.names);
                 }
                 if (gposTableOffset) {
                     const gposData = this.extractFeatureDataFromTable(view, gposTableOffset, nameTableOffset);
-                    gposData.features.forEach(f => features.add(f));
+                    gposData.features.forEach((f) => features.add(f));
                     Object.assign(featureNames, gposData.names);
                 }
             }
@@ -2733,7 +2739,7 @@
             let extrusionContours = needsExtrusionContours
                 ? needsWindingReversal
                     ? tessContours
-                    : originalContours ?? this.pathsToContours(paths)
+                    : (originalContours ?? this.pathsToContours(paths))
                 : [];
             if (removeOverlaps) {
                 logger.log('Two-pass: boundary extraction then triangulation');
@@ -2766,7 +2772,10 @@
                     ? 'libtess returned empty result from triangulation pass'
                     : 'libtess returned empty result from single-pass triangulation';
                 logger.warn(warning);
-                return { triangles: { vertices: [], indices: [] }, contours: extrusionContours };
+                return {
+                    triangles: { vertices: [], indices: [] },
+                    contours: extrusionContours
+                };
             }
             return {
                 triangles: {
@@ -3423,9 +3432,7 @@
                 const v1LenSq = v1x * v1x + v1y * v1y;
                 const v2LenSq = v2x * v2x + v2y * v2y;
                 const minLenSq = this.config.minSegmentLength * this.config.minSegmentLength;
-                if (angle > threshold ||
-                    v1LenSq < minLenSq ||
-                    v2LenSq < minLenSq) {
+                if (angle > threshold || v1LenSq < minLenSq || v2LenSq < minLenSq) {
                     result.push(current);
                 }
                 else {
@@ -4187,7 +4194,7 @@
                             const relativePositions = cluster.glyphs.map((g) => new Vec3(g.x ?? 0, g.y ?? 0, 0));
                             boundaryGroups = this.clusterer.cluster(clusterGlyphContours, relativePositions);
                             this.clusteringCache.set(cacheKey, {
-                                glyphIds: cluster.glyphs.map(g => g.g),
+                                glyphIds: cluster.glyphs.map((g) => g.g),
                                 groups: boundaryGroups
                             });
                         }
@@ -4577,7 +4584,8 @@
                         if (LineBreak.isCJOpeningPunctuation(currentChar)) {
                             shouldApply = false;
                         }
-                        if (LineBreak.isCJPunctuation(currentChar) && LineBreak.isCJPunctuation(nextChar)) {
+                        if (LineBreak.isCJPunctuation(currentChar) &&
+                            LineBreak.isCJPunctuation(nextChar)) {
                             shouldApply = false;
                         }
                         if (shouldApply) {
@@ -5381,7 +5389,7 @@
         // Stringify with sorted keys for cache stability
         static stableStringify(obj) {
             const keys = Object.keys(obj).sort();
-            const pairs = keys.map(k => `${k}:${obj[k]}`);
+            const pairs = keys.map((k) => `${k}:${obj[k]}`);
             return pairs.join(',');
         }
         constructor() {
@@ -5619,7 +5627,9 @@
                 // to selectively use glyph-level caching (separate vertices) only for clusters containing
                 // colored text, while non-colored clusters can still use fast cluster-level merging
                 let coloredTextIndices;
-                if (options.color && typeof options.color === 'object' && !Array.isArray(options.color)) {
+                if (options.color &&
+                    typeof options.color === 'object' &&
+                    !Array.isArray(options.color)) {
                     if (options.color.byText || options.color.byCharRange) {
                         // Build the set manually since glyphs don't exist yet
                         coloredTextIndices = new Set();
@@ -5724,7 +5734,9 @@
             const depthScale = this.loadedFont.upem / size;
             const rawDepthInFontUnits = depth * depthScale;
             const minExtrudeDepth = this.loadedFont.upem * 0.000025;
-            const depthInFontUnits = rawDepthInFontUnits <= 0 ? 0 : Math.max(rawDepthInFontUnits, minExtrudeDepth);
+            const depthInFontUnits = rawDepthInFontUnits <= 0
+                ? 0
+                : Math.max(rawDepthInFontUnits, minExtrudeDepth);
             if (!this.textLayout) {
                 this.textLayout = new TextLayout(this.loadedFont);
             }
@@ -5896,10 +5908,12 @@
             planeBounds.max.z *= finalScale;
             for (let i = 0; i < glyphInfoArray.length; i++) {
                 const glyphInfo = glyphInfoArray[i];
-                glyphInfo.bounds.min.x = glyphInfo.bounds.min.x * finalScale + offsetScaled;
+                glyphInfo.bounds.min.x =
+                    glyphInfo.bounds.min.x * finalScale + offsetScaled;
                 glyphInfo.bounds.min.y *= finalScale;
                 glyphInfo.bounds.min.z *= finalScale;
-                glyphInfo.bounds.max.x = glyphInfo.bounds.max.x * finalScale + offsetScaled;
+                glyphInfo.bounds.max.x =
+                    glyphInfo.bounds.max.x * finalScale + offsetScaled;
                 glyphInfo.bounds.max.y *= finalScale;
                 glyphInfo.bounds.max.z *= finalScale;
             }
@@ -5962,13 +5976,11 @@
         static registerPattern(language, pattern) {
             Text.patternCache.set(language, pattern);
         }
-        static clearFontCache() {
-            Text.fontCache.clear();
-            Text.fontCacheMemoryBytes = 0;
-        }
         static setMaxFontCacheMemoryMB(limitMB) {
             Text.maxFontCacheMemoryBytes =
-                limitMB === Infinity ? Infinity : Math.max(1, Math.floor(limitMB)) * 1024 * 1024;
+                limitMB === Infinity
+                    ? Infinity
+                    : Math.max(1, Math.floor(limitMB)) * 1024 * 1024;
             Text.enforceFontCacheMemoryLimit();
         }
         getLoadedFont() {

package/dist/index.umd.min.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.18
+ * three-text v0.2.19
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -887,10 +887,10 @@ w=e.colors,v=e.fc}const g=this.Ar.Sn()
 return{vertices:t,normals:e,indices:i,colors:w,glyphs:s,planeBounds:n,stats:{dc:i.length/3,yc:t.length/3,Ms:g.Ms,Ls:g.Ls,Is:g.Is,...o||{}},query(t){if(!h)throw Error("Original text not available for querying")
 return new mt(h,s).xa(t)},fc:v,glyphAttributes:void 0}}Ce(){if(!this.le)throw Error("Font not loaded. Call loadFont() first")
 return B.Ce(this.le.p)}static async wc(t,e){await Promise.all(t.map(async t=>{if(!xt.La.has(t))try{const i=await s(t,e)
-xt.La.set(t,i)}catch(e){l.warn(`Failed to pre-load patterns for ${t}: ${e}`)}}))}static vc(t,e){xt.La.set(t,e)}static gc(){xt.Ga.clear(),xt.Oa=0}static mc(t){xt.Fa=t===1/0?1/0:1048576*Math.max(1,Math.floor(t)),xt.Va()}getLoadedFont(){return this.le}measureTextWidth(t,e=0){if(!this.le)throw Error("Font not loaded. Call loadFont() first")
+xt.La.set(t,i)}catch(e){l.warn(`Failed to pre-load patterns for ${t}: ${e}`)}}))}static vc(t,e){xt.La.set(t,e)}static gc(t){xt.Fa=t===1/0?1/0:1048576*Math.max(1,Math.floor(t)),xt.Va()}getLoadedFont(){return this.le}measureTextWidth(t,e=0){if(!this.le)throw Error("Font not loaded. Call loadFont() first")
 return G.measureTextWidth(this.le,t,e)}getCacheStatistics(){return this.Ar?this.Ar.Er():null}clearCache(){this.Ar&&this.Ar.clearCache()}hc(t,e){const i=new Float32Array(3*t),s=new Float32Array(t),n=new Float32Array(t)
 return e.forEach((e,r)=>{const o=(e.bounds.min.x+e.bounds.max.x)/2,h=(e.bounds.min.y+e.bounds.max.y)/2,a=(e.bounds.min.z+e.bounds.max.z)/2
 for(let c=0;e.mr>c;c++){const l=e.nr+c
-t>l&&(i[3*l]=o,i[3*l+1]=h,i[3*l+2]=a,s[l]=r,n[l]=e.gr)}}),{xc:i,dn:s,bc:n}}za(){this.Ar=void 0,this.tc=void 0,this.lc=void 0}destroy(){if(!this.le)return
+t>l&&(i[3*l]=o,i[3*l+1]=h,i[3*l+2]=a,s[l]=r,n[l]=e.gr)}}),{mc:i,dn:s,xc:n}}za(){this.Ar=void 0,this.tc=void 0,this.lc=void 0}destroy(){if(!this.le)return
 const t=this.le
-try{$.Ze(t)}catch(t){l.warn("Error destroying HarfBuzz objects:",t)}finally{this.le=void 0,this.lc=void 0,this.tc=void 0}}}t.DEFAULT_CURVE_FIDELITY=it,t.FontMetadataExtractor=B,t.Text=xt,t.Sc=o,t._c=W})
+try{$.Ze(t)}catch(t){l.warn("Error destroying HarfBuzz objects:",t)}finally{this.le=void 0,this.lc=void 0,this.tc=void 0}}}t.DEFAULT_CURVE_FIDELITY=it,t.FontMetadataExtractor=B,t.Text=xt,t.bc=o,t.Sc=W})

package/dist/three/index.cjs

@@ -47,6 +47,7 @@ class Text {
     static { this.init = Text$1.Text.init; }
     static { this.registerPattern = Text$1.Text.registerPattern; }
     static { this.preloadPatterns = Text$1.Text.preloadPatterns; }
+    static { this.setMaxFontCacheMemoryMB = Text$1.Text.setMaxFontCacheMemoryMB; }
     // Main API - wraps core result in BufferGeometry
     static async create(options) {
         const coreResult = await Text$1.Text.create(options);

package/dist/three/index.d.ts

@@ -10,10 +10,21 @@ interface HyphenationTrieNode {
     };
 }
 
+interface CacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    size: number;
+    memoryUsage: number;
+}
+
 interface ThreeTextGeometryInfo extends Omit<TextGeometryInfo, 'vertices' | 'normals' | 'indices' | 'colors' | 'glyphAttributes'> {
     geometry: BufferGeometry;
     getLoadedFont(): LoadedFont | undefined;
-    getCacheStatistics(): any;
+    getCacheStatistics(): (CacheStats & {
+        hitRate: number;
+        memoryUsageMB: number;
+    }) | null;
     clearCache(): void;
     measureTextWidth(text: string, letterSpacing?: number): number;
     update(options: Partial<TextOptions>): Promise<ThreeTextGeometryInfo>;
@@ -24,6 +35,7 @@ declare class Text {
     static init: typeof Text$1.init;
     static registerPattern: typeof Text$1.registerPattern;
     static preloadPatterns: typeof Text$1.preloadPatterns;
+    static setMaxFontCacheMemoryMB: typeof Text$1.setMaxFontCacheMemoryMB;
     static create(options: TextOptions): Promise<ThreeTextGeometryInfo>;
 }
 

package/dist/three/index.js

@@ -45,6 +45,7 @@ class Text {
     static { this.init = Text$1.init; }
     static { this.registerPattern = Text$1.registerPattern; }
     static { this.preloadPatterns = Text$1.preloadPatterns; }
+    static { this.setMaxFontCacheMemoryMB = Text$1.setMaxFontCacheMemoryMB; }
     // Main API - wraps core result in BufferGeometry
     static async create(options) {
         const coreResult = await Text$1.create(options);

package/dist/three/react.cjs

@@ -3,7 +3,7 @@
 var jsxRuntime = require('react/jsx-runtime');
 var react = require('react');
 var THREE = require('three');
-var index = require('./index');
+var index = require('./index.cjs');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -142,6 +142,7 @@ const Text = Object.assign(Text$1, {
     init: index.Text.init,
     registerPattern: index.Text.registerPattern,
     preloadPatterns: index.Text.preloadPatterns,
+    setMaxFontCacheMemoryMB: index.Text.setMaxFontCacheMemoryMB,
     create: index.Text.create
 });
 

package/dist/three/react.d.ts

@@ -9,6 +9,14 @@ interface HyphenationTrieNode {
     };
 }
 
+interface CacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    size: number;
+    memoryUsage: number;
+}
+
 interface BoundingBox {
     min: {
         x: number;
@@ -183,13 +191,19 @@ interface TextGeometryInfo {
         pointsRemovedByVisvalingam: number;
         pointsRemovedByColinear: number;
         originalPointCount: number;
-    };
+    } & Partial<CacheStats & {
+        hitRate: number;
+        memoryUsageMB: number;
+    }>;
     query(options: TextQueryOptions): TextRange[];
     coloredRanges?: ColoredRange[];
 }
 interface TextHandle extends TextGeometryInfo {
     getLoadedFont(): LoadedFont | undefined;
-    getCacheStatistics(): any;
+    getCacheStatistics(): (CacheStats & {
+        hitRate: number;
+        memoryUsageMB: number;
+    }) | null;
     clearCache(): void;
     measureTextWidth(text: string, letterSpacing?: number): number;
     update(options: Partial<TextOptions>): Promise<TextHandle>;
@@ -228,7 +242,7 @@ interface ColoredRange {
 }
 interface TextOptions {
     text: string;
-    font?: string | ArrayBuffer;
+    font: string | ArrayBuffer;
     size?: number;
     depth?: number;
     lineHeight?: number;
@@ -329,7 +343,6 @@ declare class Text$1 {
     getFontMetrics(): FontMetrics;
     static preloadPatterns(languages: string[], patternsPath?: string): Promise<void>;
     static registerPattern(language: string, pattern: HyphenationTrieNode): void;
-    static clearFontCache(): void;
     static setMaxFontCacheMemoryMB(limitMB: number): void;
     getLoadedFont(): LoadedFont | undefined;
     measureTextWidth(text: string, letterSpacing?: number): number;
@@ -343,14 +356,6 @@ declare class Text$1 {
     destroy(): void;
 }
 
-interface CacheStats {
-    hits: number;
-    misses: number;
-    evictions: number;
-    size: number;
-    memoryUsage: number;
-}
-
 interface ThreeTextProps extends Omit<TextOptions$1, 'text'> {
     children: string;
     font: string | ArrayBuffer;
@@ -369,6 +374,7 @@ declare const Text: react.ForwardRefExoticComponent<ThreeTextProps & react.RefAt
     init: typeof Text$1.init;
     registerPattern: typeof Text$1.registerPattern;
     preloadPatterns: typeof Text$1.preloadPatterns;
+    setMaxFontCacheMemoryMB: typeof Text$1.setMaxFontCacheMemoryMB;
     create: typeof Text$2.create;
 };
 

package/dist/three/react.js

@@ -1,7 +1,7 @@
 import { jsx } from 'react/jsx-runtime';
 import { forwardRef, useState, useRef, useMemo, useEffect } from 'react';
 import * as THREE from 'three';
-import { Text as Text$2 } from './index';
+import { Text as Text$2 } from './index.js';
 
 function deepEqual(a, b) {
     if (a === b)
@@ -121,6 +121,7 @@ const Text = Object.assign(Text$1, {
     init: Text$2.init,
     registerPattern: Text$2.registerPattern,
     preloadPatterns: Text$2.preloadPatterns,
+    setMaxFontCacheMemoryMB: Text$2.setMaxFontCacheMemoryMB,
     create: Text$2.create
 });
 

package/dist/types/core/Text.d.ts

@@ -43,7 +43,6 @@ export declare class Text {
     getFontMetrics(): FontMetrics;
     static preloadPatterns(languages: string[], patternsPath?: string): Promise<void>;
     static registerPattern(language: string, pattern: HyphenationTrieNode): void;
-    static clearFontCache(): void;
     static setMaxFontCacheMemoryMB(limitMB: number): void;
     getLoadedFont(): LoadedFont | undefined;
     measureTextWidth(text: string, letterSpacing?: number): number;

package/dist/types/core/types.d.ts

@@ -1,4 +1,5 @@
 import type { HyphenationTrieNode } from '../hyphenation';
+import type { CacheStats } from '../utils/LRUCache';
 import type { Vec2, Vec3, BoundingBox } from './vectors';
 export type { HyphenationTrieNode };
 export interface Path {
@@ -249,13 +250,19 @@ export interface TextGeometryInfo {
         pointsRemovedByVisvalingam: number;
         pointsRemovedByColinear: number;
         originalPointCount: number;
-    };
+    } & Partial<CacheStats & {
+        hitRate: number;
+        memoryUsageMB: number;
+    }>;
     query(options: TextQueryOptions): TextRange[];
     coloredRanges?: ColoredRange[];
 }
 export interface TextHandle extends TextGeometryInfo {
     getLoadedFont(): LoadedFont | undefined;
-    getCacheStatistics(): any;
+    getCacheStatistics(): (CacheStats & {
+        hitRate: number;
+        memoryUsageMB: number;
+    }) | null;
     clearCache(): void;
     measureTextWidth(text: string, letterSpacing?: number): number;
     update(options: Partial<TextOptions>): Promise<TextHandle>;
@@ -294,7 +301,7 @@ export interface ColoredRange {
 }
 export interface TextOptions {
     text: string;
-    font?: string | ArrayBuffer;
+    font: string | ArrayBuffer;
     size?: number;
     depth?: number;
     lineHeight?: number;

package/dist/types/three/index.d.ts

@@ -2,10 +2,14 @@ import { BufferGeometry } from 'three';
 import { Text as TextCore } from '../core/Text';
 import type { TextOptions, TextGeometryInfo as CoreTextGeometryInfo, LoadedFont } from '../core/types';
 import type { HyphenationTrieNode } from '../hyphenation';
+import type { CacheStats } from '../utils/LRUCache';
 export interface ThreeTextGeometryInfo extends Omit<CoreTextGeometryInfo, 'vertices' | 'normals' | 'indices' | 'colors' | 'glyphAttributes'> {
     geometry: BufferGeometry;
     getLoadedFont(): LoadedFont | undefined;
-    getCacheStatistics(): any;
+    getCacheStatistics(): (CacheStats & {
+        hitRate: number;
+        memoryUsageMB: number;
+    }) | null;
     clearCache(): void;
     measureTextWidth(text: string, letterSpacing?: number): number;
     update(options: Partial<TextOptions>): Promise<ThreeTextGeometryInfo>;
@@ -16,6 +20,7 @@ export declare class Text {
     static init: typeof TextCore.init;
     static registerPattern: typeof TextCore.registerPattern;
     static preloadPatterns: typeof TextCore.preloadPatterns;
+    static setMaxFontCacheMemoryMB: typeof TextCore.setMaxFontCacheMemoryMB;
     static create(options: TextOptions): Promise<ThreeTextGeometryInfo>;
 }
 export type { TextOptions, ThreeTextGeometryInfo as TextGeometryInfo, LoadedFont };

package/dist/types/three/react.d.ts

@@ -6,5 +6,6 @@ export declare const Text: import("react").ForwardRefExoticComponent<import("./T
     init: typeof import("..").Text.init;
     registerPattern: typeof import("..").Text.registerPattern;
     preloadPatterns: typeof import("..").Text.preloadPatterns;
+    setMaxFontCacheMemoryMB: typeof import("..").Text.setMaxFontCacheMemoryMB;
     create: typeof ThreeTextCore.create;
 };

package/package.json

@@ -1,37 +1,47 @@
 {
   "name": "three-text",
-  "version": "0.2.18",
-  "description": "3D font rendering and text layout engine for the web",
+  "version": "0.2.19",
+  "description": "3D mesh font geometry and text layout engine for the web",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "type": "module",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
     "./three": {
+      "types": "./dist/three/index.d.ts",
       "import": "./dist/three/index.js",
       "require": "./dist/three/index.cjs"
     },
     "./three/react": {
+      "types": "./dist/three/react.d.ts",
       "import": "./dist/three/react.js",
       "require": "./dist/three/react.cjs"
     },
     "./webgl": {
+      "types": "./dist/webgl/index.d.ts",
       "import": "./dist/webgl/index.js",
       "require": "./dist/webgl/index.cjs"
     },
     "./webgpu": {
+      "types": "./dist/webgpu/index.d.ts",
       "import": "./dist/webgpu/index.js",
       "require": "./dist/webgpu/index.cjs"
     },
     "./p5": {
+      "types": "./dist/p5/index.d.ts",
       "import": "./dist/p5/index.js",
       "require": "./dist/p5/index.cjs"
     },
-    "./patterns/*": "./dist/patterns/*"
+    "./patterns/*": {
+      "types": "./dist/patterns/*.d.ts",
+      "import": "./dist/patterns/*.js",
+      "require": "./dist/patterns/*.cjs"
+    }
   },
   "files": [
     "dist",
@@ -95,6 +105,7 @@
     "libtess": "^1.2.2"
   },
   "devDependencies": {
+    "@webgpu/types": "^0.1.64",
     "@react-three/fiber": ">=8.0.0",
     "@rollup/plugin-commonjs": "^25.0.0",
     "@rollup/plugin-node-resolve": "^15.0.0",