three-text 0.4.6 → 0.4.7

package/README.md

@@ -63,14 +63,15 @@ npm install three
 
 three-text has a framework-agnostic core that processes fonts and generates geometry data. Lightweight adapters convert this data to framework-specific formats:
 
-- **`three-text`** - Core (returns raw arrays)
-- **`three-text/three`** - Three.js (returns BufferGeometry)
+- **`three-text`** - Three.js adapter (default export, returns BufferGeometry)
+- **`three-text/three`** - Same as above (explicit alias)
 - **`three-text/three/react`** - React Three Fiber component
+- **`three-text/core`** - Framework-agnostic core (returns raw arrays)
 - **`three-text/webgl`** - WebGL buffer utility
 - **`three-text/webgpu`** - WebGPU buffer utility
 - **`three-text/p5`** - p5.js adapter
 
-Choose the import that matches your stack. Most users will use `three-text/three` or `three-text/p5`
+Most users will just `import { Text } from 'three-text'` for Three.js projects
 
 ### Basic Usage
 

package/dist/index.cjs

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.4.6
+ * three-text v0.4.7
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -1997,7 +1997,7 @@ class WoffConverter {
         logger.log('WOFF font decompressed successfully');
         return sfntData.buffer.slice(0, sfntOffset);
     }
-    static decompressWoff2(woff2Buffer) {
+    static async decompressWoff2(woff2Buffer) {
         const view = new DataView(woff2Buffer);
         const signature = view.getUint32(0);
         if (signature !== FONT_SIGNATURE_WOFF2) {
@@ -2008,7 +2008,7 @@ class WoffConverter {
                 "  import { decode } from 'woff2-decode';\n" +
                 '  Text.enableWoff2(decode);');
         }
-        const decoded = woff2Decoder(woff2Buffer);
+        const decoded = await woff2Decoder(woff2Buffer);
         logger.log('WOFF2 font decompressed successfully');
         return decoded.buffer;
     }
@@ -2043,7 +2043,7 @@ class FontLoader {
         }
         else if (format === 'woff2') {
             logger.log('WOFF2 font detected, decompressing...');
-            fontBuffer = WoffConverter.decompressWoff2(fontBuffer);
+            fontBuffer = await WoffConverter.decompressWoff2(fontBuffer);
         }
         const view = new DataView(fontBuffer);
         const sfntVersion = view.getUint32(0);

package/dist/index.d.ts

@@ -352,7 +352,7 @@ declare class Text {
     private static fontCacheMemoryBytes;
     private static maxFontCacheMemoryBytes;
     private static fontIdCounter;
-    static enableWoff2(decoder: (data: ArrayBuffer | Uint8Array) => Uint8Array): void;
+    static enableWoff2(decoder: (data: ArrayBuffer | Uint8Array) => Uint8Array | Promise<Uint8Array>): void;
     private static stableStringify;
     private fontLoader;
     private loadedFont?;

package/dist/index.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.4.6
+ * three-text v0.4.7
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -1994,7 +1994,7 @@ class WoffConverter {
         logger.log('WOFF font decompressed successfully');
         return sfntData.buffer.slice(0, sfntOffset);
     }
-    static decompressWoff2(woff2Buffer) {
+    static async decompressWoff2(woff2Buffer) {
         const view = new DataView(woff2Buffer);
         const signature = view.getUint32(0);
         if (signature !== FONT_SIGNATURE_WOFF2) {
@@ -2005,7 +2005,7 @@ class WoffConverter {
                 "  import { decode } from 'woff2-decode';\n" +
                 '  Text.enableWoff2(decode);');
         }
-        const decoded = woff2Decoder(woff2Buffer);
+        const decoded = await woff2Decoder(woff2Buffer);
         logger.log('WOFF2 font decompressed successfully');
         return decoded.buffer;
     }
@@ -2040,7 +2040,7 @@ class FontLoader {
         }
         else if (format === 'woff2') {
             logger.log('WOFF2 font detected, decompressing...');
-            fontBuffer = WoffConverter.decompressWoff2(fontBuffer);
+            fontBuffer = await WoffConverter.decompressWoff2(fontBuffer);
         }
         const view = new DataView(fontBuffer);
         const sfntVersion = view.getUint32(0);

package/dist/index.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.4.6
+ * three-text v0.4.7
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -306,12 +306,12 @@ const e=i.subarray(t.offset,t.offset+t.length),n=await q.Ue(e)
 if(n.byteLength!==t.Be)throw Error(`Decompression failed: expected ${t.Be} bytes, got ${n.byteLength}`)
 return new Uint8Array(n)}))
 for(let t=0;s>t;t++){const e=l[t],i=12+16*t
-a.setUint32(i,e.tag),a.setUint32(i+4,e.t),a.setUint32(i+8,c),a.setUint32(i+12,e.Be),o.set(u[t],c),c+=e.Be,c+=(4-e.Be%4)%4}return o.buffer.slice(0,c)}static Ne(t){if(new DataView(t).getUint32(0)!==C)throw Error("Not a valid WOFF2 font")
+a.setUint32(i,e.tag),a.setUint32(i+4,e.t),a.setUint32(i+8,c),a.setUint32(i+12,e.Be),o.set(u[t],c),c+=e.Be,c+=(4-e.Be%4)%4}return o.buffer.slice(0,c)}static async Ne(t){if(new DataView(t).getUint32(0)!==C)throw Error("Not a valid WOFF2 font")
 if(!V)throw Error("WOFF2 fonts require enabling the decoder. Add to your code:\n  import { decode } from 'woff2-decode';\n  Text.enableWoff2(decode);")
-return V(t).buffer}static async Ue(t){const e=new ReadableStream({start(e){e.enqueue(t),e.close()}}).pipeThrough(new DecompressionStream("deflate"))
+return(await V(t)).buffer}static async Ue(t){const e=new ReadableStream({start(e){e.enqueue(t),e.close()}}).pipeThrough(new DecompressionStream("deflate"))
 return new Response(e).arrayBuffer()}}class Y{constructor(t){this.$e=t}async Pe(t,e){if(!t||12>t.byteLength)throw Error("Invalid font buffer: too small to be a valid font file")
 const i=q.ke(t)
-"woff"===i?t=await q.De(t):"woff2"===i&&(t=q.Ne(t))
+"woff"===i?t=await q.De(t):"woff2"===i&&(t=await q.Ne(t))
 const n=new DataView(t).getUint32(0)
 if(![L,G].includes(n))throw Error("Invalid font format. Expected TTF/OTF/WOFF/WOFF2, got signature: 0x"+n.toString(16))
 const{hb:s,module:r}=await this.$e()

package/dist/index.min.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.4.6
+ * three-text v0.4.7
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -305,12 +305,12 @@ const e=i.subarray(t.offset,t.offset+t.length),n=await q.Ne(e)
 if(n.byteLength!==t.Be)throw Error(`Decompression failed: expected ${t.Be} bytes, got ${n.byteLength}`)
 return new Uint8Array(n)}))
 for(let t=0;s>t;t++){const e=l[t],i=12+16*t
-a.setUint32(i,e.tag),a.setUint32(i+4,e.t),a.setUint32(i+8,c),a.setUint32(i+12,e.Be),o.set(u[t],c),c+=e.Be,c+=(4-e.Be%4)%4}return o.buffer.slice(0,c)}static Ue(t){if(new DataView(t).getUint32(0)!==C)throw Error("Not a valid WOFF2 font")
+a.setUint32(i,e.tag),a.setUint32(i+4,e.t),a.setUint32(i+8,c),a.setUint32(i+12,e.Be),o.set(u[t],c),c+=e.Be,c+=(4-e.Be%4)%4}return o.buffer.slice(0,c)}static async Ue(t){if(new DataView(t).getUint32(0)!==C)throw Error("Not a valid WOFF2 font")
 if(!V)throw Error("WOFF2 fonts require enabling the decoder. Add to your code:\n  import { decode } from 'woff2-decode';\n  Text.enableWoff2(decode);")
-return V(t).buffer}static async Ne(t){const e=new ReadableStream({start(e){e.enqueue(t),e.close()}}).pipeThrough(new DecompressionStream("deflate"))
+return(await V(t)).buffer}static async Ne(t){const e=new ReadableStream({start(e){e.enqueue(t),e.close()}}).pipeThrough(new DecompressionStream("deflate"))
 return new Response(e).arrayBuffer()}}class Y{constructor(t){this.$e=t}async Pe(t,e){if(!t||12>t.byteLength)throw Error("Invalid font buffer: too small to be a valid font file")
 const i=q.ke(t)
-"woff"===i?t=await q.De(t):"woff2"===i&&(t=q.Ue(t))
+"woff"===i?t=await q.De(t):"woff2"===i&&(t=await q.Ue(t))
 const n=new DataView(t).getUint32(0)
 if(![L,G].includes(n))throw Error("Invalid font format. Expected TTF/OTF/WOFF/WOFF2, got signature: 0x"+n.toString(16))
 const{hb:s,module:r}=await this.$e()

package/dist/index.umd.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.4.6
+ * three-text v0.4.7
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -1999,7 +1999,7 @@
             logger.log('WOFF font decompressed successfully');
             return sfntData.buffer.slice(0, sfntOffset);
         }
-        static decompressWoff2(woff2Buffer) {
+        static async decompressWoff2(woff2Buffer) {
             const view = new DataView(woff2Buffer);
             const signature = view.getUint32(0);
             if (signature !== FONT_SIGNATURE_WOFF2) {
@@ -2010,7 +2010,7 @@
                     "  import { decode } from 'woff2-decode';\n" +
                     '  Text.enableWoff2(decode);');
             }
-            const decoded = woff2Decoder(woff2Buffer);
+            const decoded = await woff2Decoder(woff2Buffer);
             logger.log('WOFF2 font decompressed successfully');
             return decoded.buffer;
         }
@@ -2045,7 +2045,7 @@
             }
             else if (format === 'woff2') {
                 logger.log('WOFF2 font detected, decompressing...');
-                fontBuffer = WoffConverter.decompressWoff2(fontBuffer);
+                fontBuffer = await WoffConverter.decompressWoff2(fontBuffer);
             }
             const view = new DataView(fontBuffer);
             const sfntVersion = view.getUint32(0);