three-text 0.2.7 → 0.2.9

package/dist/three/index.js

@@ -3,6 +3,41 @@ import { Text as Text$1 } from '../index.js';
 
 // Three.js adapter - wraps core text processing and returns BufferGeometry
 // This is a thin convenience layer for Three.js users
+function convertToThree(result) {
+    // Create BufferGeometry from raw arrays
+    const geometry = new BufferGeometry();
+    geometry.setAttribute('position', new Float32BufferAttribute(result.vertices, 3));
+    geometry.setAttribute('normal', new Float32BufferAttribute(result.normals, 3));
+    geometry.setIndex(new Uint32BufferAttribute(result.indices, 1));
+    // Add optional color attribute (only if provided)
+    if (result.colors) {
+        geometry.setAttribute('color', new Float32BufferAttribute(result.colors, 3));
+    }
+    if (result.glyphAttributes) {
+        geometry.setAttribute('glyphCenter', new Float32BufferAttribute(result.glyphAttributes.glyphCenter, 3));
+        geometry.setAttribute('glyphIndex', new Float32BufferAttribute(result.glyphAttributes.glyphIndex, 1));
+        geometry.setAttribute('glyphLineIndex', new Float32BufferAttribute(result.glyphAttributes.glyphLineIndex, 1));
+    }
+    geometry.computeBoundingBox();
+    // Return Three.js specific interface with utility methods
+    return {
+        geometry,
+        glyphs: result.glyphs,
+        planeBounds: result.planeBounds,
+        stats: result.stats,
+        query: result.query,
+        coloredRanges: result.coloredRanges,
+        // Pass through utility methods from core
+        getLoadedFont: result.getLoadedFont,
+        getCacheStatistics: result.getCacheStatistics,
+        clearCache: result.clearCache,
+        measureTextWidth: result.measureTextWidth,
+        update: async (newOptions) => {
+            const newCoreResult = await result.update(newOptions);
+            return convertToThree(newCoreResult);
+        }
+    };
+}
 class Text {
     // Delegate static methods to core
     static { this.setHarfBuzzPath = Text$1.setHarfBuzzPath; }
@@ -13,35 +48,7 @@ class Text {
     // Main API - wraps core result in BufferGeometry
     static async create(options) {
         const coreResult = await Text$1.create(options);
-        // Create BufferGeometry from raw arrays
-        const geometry = new BufferGeometry();
-        geometry.setAttribute('position', new Float32BufferAttribute(coreResult.vertices, 3));
-        geometry.setAttribute('normal', new Float32BufferAttribute(coreResult.normals, 3));
-        geometry.setIndex(new Uint32BufferAttribute(coreResult.indices, 1));
-        // Add optional color attribute (only if provided)
-        if (coreResult.colors) {
-            geometry.setAttribute('color', new Float32BufferAttribute(coreResult.colors, 3));
-        }
-        if (coreResult.glyphAttributes) {
-            geometry.setAttribute('glyphCenter', new Float32BufferAttribute(coreResult.glyphAttributes.glyphCenter, 3));
-            geometry.setAttribute('glyphIndex', new Float32BufferAttribute(coreResult.glyphAttributes.glyphIndex, 1));
-            geometry.setAttribute('glyphLineIndex', new Float32BufferAttribute(coreResult.glyphAttributes.glyphLineIndex, 1));
-        }
-        geometry.computeBoundingBox();
-        // Return Three.js specific interface with utility methods
-        return {
-            geometry,
-            glyphs: coreResult.glyphs,
-            planeBounds: coreResult.planeBounds,
-            stats: coreResult.stats,
-            query: coreResult.query,
-            coloredRanges: coreResult.coloredRanges,
-            // Pass through utility methods from core
-            getLoadedFont: coreResult.getLoadedFont,
-            getCacheStatistics: coreResult.getCacheStatistics,
-            clearCache: coreResult.clearCache,
-            measureTextWidth: coreResult.measureTextWidth
-        };
+        return convertToThree(coreResult);
     }
 }
 

package/dist/three/react.d.ts

@@ -275,7 +275,8 @@ interface LayoutOptions {
     exhyphenpenalty?: number;
     doublehyphendemerits?: number;
     looseness?: number;
-    disableSingleWordDetection?: boolean;
+    disableShortLineDetection?: boolean;
+    shortLineThreshold?: number;
 }
 
 interface GlyphCacheStats {
@@ -309,7 +310,12 @@ declare class Text$1 {
     static setHarfBuzzPath(path: string): void;
     static setHarfBuzzBuffer(wasmBuffer: ArrayBuffer): void;
     static init(): Promise<HarfBuzzInstance>;
-    static create(options: TextOptions): Promise<TextGeometryInfo & Pick<Text$1, 'getLoadedFont' | 'getCacheStatistics' | 'clearCache' | 'measureTextWidth'>>;
+    static create(options: TextOptions): Promise<TextGeometryInfo & Pick<Text$1, 'getLoadedFont' | 'getCacheStatistics' | 'clearCache' | 'measureTextWidth'> & {
+        update: (options: Partial<TextOptions>) => Promise<TextGeometryInfo & Pick<Text$1, 'getLoadedFont' | 'getCacheStatistics' | 'clearCache' | 'measureTextWidth'> & {
+            update: (options: Partial<TextOptions>) => Promise<any>;
+        }>;
+    }>;
+    private static resolveFont;
     private static loadAndCacheFont;
     private static generateFontContentHash;
     private setLoadedFont;
@@ -329,6 +335,7 @@ declare class Text$1 {
     getCacheStatistics(): GlyphCacheStats | null;
     clearCache(): void;
     private createGlyphAttributes;
+    private resetHelpers;
     destroy(): void;
 }
 

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

@@ -21,7 +21,12 @@ export declare class Text {
     static setHarfBuzzPath(path: string): void;
     static setHarfBuzzBuffer(wasmBuffer: ArrayBuffer): void;
     static init(): Promise<HarfBuzzInstance>;
-    static create(options: TextOptions): Promise<TextGeometryInfo & Pick<Text, 'getLoadedFont' | 'getCacheStatistics' | 'clearCache' | 'measureTextWidth'>>;
+    static create(options: TextOptions): Promise<TextGeometryInfo & Pick<Text, 'getLoadedFont' | 'getCacheStatistics' | 'clearCache' | 'measureTextWidth'> & {
+        update: (options: Partial<TextOptions>) => Promise<TextGeometryInfo & Pick<Text, 'getLoadedFont' | 'getCacheStatistics' | 'clearCache' | 'measureTextWidth'> & {
+            update: (options: Partial<TextOptions>) => Promise<any>;
+        }>;
+    }>;
+    private static resolveFont;
     private static loadAndCacheFont;
     private static generateFontContentHash;
     private setLoadedFont;
@@ -41,5 +46,6 @@ export declare class Text {
     getCacheStatistics(): import("./cache/GlyphCache").GlyphCacheStats | null;
     clearCache(): void;
     private createGlyphAttributes;
+    private resetHelpers;
     destroy(): void;
 }

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

@@ -62,7 +62,8 @@ export interface LineBreakOptions {
     exhyphenpenalty?: number;
     doublehyphendemerits?: number;
     looseness?: number;
-    disableSingleWordDetection?: boolean;
+    disableShortLineDetection?: boolean;
+    shortLineThreshold?: number;
 }
 interface LineBreakContext {
     linePenalty: number;
@@ -78,8 +79,14 @@ export declare class LineBreak {
     static findHyphenationPoints(word: string, language?: string, availablePatterns?: HyphenationPatternsMap, lefthyphenmin?: number, righthyphenmin?: number): number[];
     static itemizeText(text: string, measureText: (text: string) => number, // function to measure text width
     hyphenate?: boolean, language?: string, availablePatterns?: HyphenationPatternsMap, lefthyphenmin?: number, righthyphenmin?: number, context?: LineBreakContext): Item[];
+    static isCJK(char: string): boolean;
+    static isCJClosingPunctuation(char: string): boolean;
+    static isCJOpeningPunctuation(char: string): boolean;
+    static isCJPunctuation(char: string): boolean;
+    private static itemizeCJKText;
     private static itemizeParagraph;
-    private static hasSingleWordLines;
+    private static itemizeWordBased;
+    private static hasShortLines;
     static breakText(options: LineBreakOptions): LineInfo[];
     private static findBreakpoints;
     private static considerBreak;

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

@@ -29,6 +29,7 @@ export declare class TextShaper {
     shapeLines(lineInfos: LineInfo[], scaledLineHeight: number, letterSpacing: number, align: string, direction: TextDirection, color?: [number, number, number] | ColorOptions, originalText?: string): GlyphCluster[][];
     private shapeLineIntoClusters;
     private calculateSpaceAdjustment;
+    private calculateCJKAdjustment;
     clearCache(): void;
     getCacheStats(): import("../..").GlyphCacheStats;
 }

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

@@ -322,5 +322,6 @@ export interface LayoutOptions {
     exhyphenpenalty?: number;
     doublehyphendemerits?: number;
     looseness?: number;
-    disableSingleWordDetection?: boolean;
+    disableShortLineDetection?: boolean;
+    shortLineThreshold?: number;
 }

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

@@ -8,6 +8,7 @@ export interface ThreeTextGeometryInfo extends Omit<CoreTextGeometryInfo, 'verti
     getCacheStatistics(): any;
     clearCache(): void;
     measureTextWidth(text: string, letterSpacing?: number): number;
+    update(options: Partial<TextOptions>): Promise<ThreeTextGeometryInfo>;
 }
 export declare class Text {
     static setHarfBuzzPath: typeof TextCore.setHarfBuzzPath;

package/dist/types/utils/PerformanceLogger.d.ts

@@ -13,7 +13,6 @@ declare class PerformanceLogger {
     printSummary(): void;
     printBaseline(): void;
     clear(): void;
-    reset(): void;
     time<T>(name: string, fn: () => T, metadata?: Record<string, any>): T;
     timeAsync<T>(name: string, fn: () => Promise<T>, metadata?: Record<string, any>): Promise<T>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "three-text",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "3D font rendering and text layout engine for the web",
   "main": "dist/index.cjs",
   "module": "dist/index.js",