three-text 0.4.5 → 0.4.7

package/dist/index.umd.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.4.5
+ * three-text v0.4.7
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -1471,7 +1471,7 @@
                 FONT_SIGNATURE_OPEN_TYPE_CFF
             ];
             if (!validSignatures.includes(sfntVersion)) {
-                throw new Error(`Invalid font format. Expected TTF/OTF (or WOFF), got signature: 0x${sfntVersion.toString(16)}`);
+                throw new Error(`Invalid font format. Expected TTF/OTF/WOFF/WOFF2, got signature: 0x${sfntVersion.toString(16)}`);
             }
             const tableDirectory = parseTableDirectory(view);
             const isCFF = tableDirectory.has(TABLE_TAG_CFF) || tableDirectory.has(TABLE_TAG_CFF2);
@@ -1660,7 +1660,7 @@
                 FONT_SIGNATURE_OPEN_TYPE_CFF
             ];
             if (!validSignatures.includes(sfntVersion)) {
-                throw new Error(`Invalid font format. Expected TTF/OTF (or WOFF), got signature: 0x${sfntVersion.toString(16)}`);
+                throw new Error(`Invalid font format. Expected TTF/OTF/WOFF/WOFF2, got signature: 0x${sfntVersion.toString(16)}`);
             }
             const tableDirectory = parseTableDirectory(view);
             const nameTableOffset = tableDirectory.get(TABLE_TAG_NAME)?.offset ?? 0;
@@ -1894,6 +1894,10 @@
         }
     }
 
+    let woff2Decoder = null;
+    function setWoff2Decoder(decoder) {
+        woff2Decoder = decoder;
+    }
     // Uses DecompressionStream to decompress WOFF (WOFF is just zlib compressed TTF/OTF so we can use deflate)
     class WoffConverter {
         static detectFormat(buffer) {
@@ -1995,6 +1999,21 @@
             logger.log('WOFF font decompressed successfully');
             return sfntData.buffer.slice(0, sfntOffset);
         }
+        static async decompressWoff2(woff2Buffer) {
+            const view = new DataView(woff2Buffer);
+            const signature = view.getUint32(0);
+            if (signature !== FONT_SIGNATURE_WOFF2) {
+                throw new Error('Not a valid WOFF2 font');
+            }
+            if (!woff2Decoder) {
+                throw new Error('WOFF2 fonts require enabling the decoder. Add to your code:\n' +
+                    "  import { decode } from 'woff2-decode';\n" +
+                    '  Text.enableWoff2(decode);');
+            }
+            const decoded = await woff2Decoder(woff2Buffer);
+            logger.log('WOFF2 font decompressed successfully');
+            return decoded.buffer;
+        }
         static async decompressZlib(compressedData) {
             const stream = new ReadableStream({
                 start(controller) {
@@ -2025,7 +2044,8 @@
                 fontBuffer = await WoffConverter.decompressWoff(fontBuffer);
             }
             else if (format === 'woff2') {
-                throw new Error('WOFF2 fonts are not yet supported. Please use WOFF or TTF/OTF format.');
+                logger.log('WOFF2 font detected, decompressing...');
+                fontBuffer = await WoffConverter.decompressWoff2(fontBuffer);
             }
             const view = new DataView(fontBuffer);
             const sfntVersion = view.getUint32(0);
@@ -2034,7 +2054,7 @@
                 FONT_SIGNATURE_OPEN_TYPE_CFF
             ];
             if (!validSignatures.includes(sfntVersion)) {
-                throw new Error(`Invalid font format. Expected TTF/OTF (or WOFF), got signature: 0x${sfntVersion.toString(16)}`);
+                throw new Error(`Invalid font format. Expected TTF/OTF/WOFF/WOFF2, got signature: 0x${sfntVersion.toString(16)}`);
             }
             const { hb, module } = await this.getHarfBuzzInstance();
             try {
@@ -5586,6 +5606,11 @@
         static { this.fontCacheMemoryBytes = 0; }
         static { this.maxFontCacheMemoryBytes = Infinity; }
         static { this.fontIdCounter = 0; }
+        // Enable WOFF2 font support (adds ~45KB to bundle if imported)
+        // Usage: import { decode } from 'woff2-decode'; Text.enableWoff2(decode);
+        static enableWoff2(decoder) {
+            setWoff2Decoder(decoder);
+        }
         // Stringify with sorted keys for cache stability
         static stableStringify(obj) {
             const keys = Object.keys(obj).sort();