three-text 0.2.15 → 0.2.16

package/README.md

@@ -25,11 +25,12 @@ Under the hood, three-text relies on [HarfBuzz](https://github.com/harfbuzz/harf
 
 - [Overview](#overview)
 - [Getting started](#getting-started)
+- [Architecture](#architecture)
   - [Three.js](#threejs)
   - [React Three Fiber](#react-three-fiber)
   - [p5.js](#p5js)
+  - [Coordinate systems](#coordinate-systems)
 - [Development and examples](#development-and-examples)
-- [Architecture](#architecture)
 - [Why three-text?](#why-three-text)
 - [Library structure](#library-structure)
 - [Key concepts and methods](#key-concepts-and-methods)
@@ -142,6 +143,13 @@ function draw() {
 
 `createThreeTextGeometry()` accepts all the same options as Three.js (`layout`, `fontVariations`, `depth`, etc.) and returns `{ geometry, planeBounds, glyphs }`. Use `planeBounds` to center the text
 
+### Coordinate systems
+
+The core library uses a right-handed coordinate system with +Y down. Text extrudes from z=0 toward positive Z
+
+**Three.js, WebGL, WebGPU:** Geometry is used as-is. Front cap normals point +Z
+
+**p5.js:** The adapter flips Y coordinates (p5 uses +Y up) but preserves Z. When using `directionalLight(r, g, b, x, y, z)`, note that p5 negates the direction vector internally
 
 ### Setup
 
@@ -322,7 +330,10 @@ For text with tight tracking, connected scripts, or complex kerning pairs, indiv
 
 #### Flat geometry mode
 
-When `depth` is 0, the library generates single-sided geometry with normals pointing toward the camera (positive Z direction), reducing triangles by approximately 50% compared to extruded geometry
+When `depth` is 0, the library generates single-sided geometry, reducing triangles by approximately 50%
+
+- Use `THREE.DoubleSide` for flat text so it remains visible from both sides
+- For extruded text, `THREE.FrontSide` is typical since front and back faces are separate geometry
 
 
 ## Configuration

package/dist/index.cjs

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.15
+ * three-text v0.2.16
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -2786,12 +2786,11 @@ class Extruder {
         const points = geometry.triangles.vertices;
         const triangleIndices = geometry.triangles.indices;
         const numPoints = points.length / 2;
-        // Count side-wall segments (each segment emits 4 vertices + 6 indices)
+        // Count side-wall segments (4 vertices + 6 indices per segment)
         let sideSegments = 0;
         if (depth !== 0) {
             for (const contour of geometry.contours) {
-                // Each contour is a flat [x0,y0,x1,y1,...] array; side walls connect consecutive points
-                // Contours are expected to be closed (last point repeats first), so segments = (nPoints - 1)
+                // Contours are closed (last point repeats first)
                 const contourPoints = contour.length / 2;
                 if (contourPoints >= 2)
                     sideSegments += contourPoints - 1;
@@ -2807,7 +2806,7 @@ class Extruder {
             : triangleIndices.length * 2 + sideSegments * 6;
         const indices = new Uint32Array(indexCount);
         if (depth === 0) {
-            // Flat faces only
+            // Single-sided flat geometry at z=0
             let vPos = 0;
             for (let i = 0; i < points.length; i += 2) {
                 vertices[vPos] = points[i];
@@ -2818,15 +2817,16 @@ class Extruder {
                 normals[vPos + 2] = 1;
                 vPos += 3;
             }
+            // libtess outputs CCW, use as-is for +Z facing geometry
             for (let i = 0; i < triangleIndices.length; i++) {
                 indices[i] = triangleIndices[i];
             }
             return { vertices, normals, indices };
         }
-        // Front/back faces
+        // Extruded geometry: front at z=0, back at z=depth
         const minBackOffset = unitsPerEm * 0.000025;
         const backZ = depth <= minBackOffset ? minBackOffset : depth;
-        // Fill front vertices/normals (0..numPoints-1)
+        // Cap at z=0, back face
         for (let p = 0, vi = 0; p < points.length; p += 2, vi++) {
             const base = vi * 3;
             vertices[base] = points[p];
@@ -2834,9 +2834,9 @@ class Extruder {
             vertices[base + 2] = 0;
             normals[base] = 0;
             normals[base + 1] = 0;
-            normals[base + 2] = 1;
+            normals[base + 2] = -1;
         }
-        // Fill back vertices/normals (numPoints..2*numPoints-1)
+        // Cap at z=depth, front face
         for (let p = 0, vi = 0; p < points.length; p += 2, vi++) {
             const base = (numPoints + vi) * 3;
             vertices[base] = points[p];
@@ -2844,16 +2844,16 @@ class Extruder {
             vertices[base + 2] = backZ;
             normals[base] = 0;
             normals[base + 1] = 0;
-            normals[base + 2] = -1;
+            normals[base + 2] = 1;
         }
-        // Front indices
+        // libtess outputs CCW triangles (viewed from +Z)
+        // Z=0 cap faces -Z, reverse winding
         for (let i = 0; i < triangleIndices.length; i++) {
-            indices[i] = triangleIndices[i];
+            indices[i] = triangleIndices[triangleIndices.length - 1 - i];
         }
-        // Back indices (reverse winding + offset)
+        // Z=depth cap faces +Z, use original winding
         for (let i = 0; i < triangleIndices.length; i++) {
-            indices[triangleIndices.length + i] =
-                triangleIndices[triangleIndices.length - 1 - i] + numPoints;
+            indices[triangleIndices.length + i] = triangleIndices[i] + numPoints;
         }
         // Side walls
         let nextVertex = numPoints * 2;
@@ -2864,7 +2864,7 @@ class Extruder {
                 const p0y = contour[i + 1];
                 const p1x = contour[i + 2];
                 const p1y = contour[i + 3];
-                // Unit normal for the wall quad (per-edge)
+                // Perpendicular normal for this wall segment
                 const ex = p1x - p0x;
                 const ey = p1y - p0y;
                 const lenSq = ex * ex + ey * ey;
@@ -2877,7 +2877,7 @@ class Extruder {
                 }
                 const baseVertex = nextVertex;
                 const base = baseVertex * 3;
-                // 4 vertices (two at z=0, two at z=depth)
+                // Wall quad: front edge at z=0, back edge at z=depth
                 vertices[base] = p0x;
                 vertices[base + 1] = p0y;
                 vertices[base + 2] = 0;
@@ -2890,7 +2890,7 @@ class Extruder {
                 vertices[base + 9] = p1x;
                 vertices[base + 10] = p1y;
                 vertices[base + 11] = backZ;
-                // Normals (same for all 4 wall vertices)
+                // Wall normals point perpendicular to edge
                 normals[base] = nx;
                 normals[base + 1] = ny;
                 normals[base + 2] = 0;
@@ -2903,7 +2903,7 @@ class Extruder {
                 normals[base + 9] = nx;
                 normals[base + 10] = ny;
                 normals[base + 11] = 0;
-                // Indices (two triangles)
+                // Two triangles per wall segment
                 indices[idxPos++] = baseVertex;
                 indices[idxPos++] = baseVertex + 1;
                 indices[idxPos++] = baseVertex + 2;

package/dist/index.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.15
+ * three-text v0.2.16
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -2783,12 +2783,11 @@ class Extruder {
         const points = geometry.triangles.vertices;
         const triangleIndices = geometry.triangles.indices;
         const numPoints = points.length / 2;
-        // Count side-wall segments (each segment emits 4 vertices + 6 indices)
+        // Count side-wall segments (4 vertices + 6 indices per segment)
         let sideSegments = 0;
         if (depth !== 0) {
             for (const contour of geometry.contours) {
-                // Each contour is a flat [x0,y0,x1,y1,...] array; side walls connect consecutive points
-                // Contours are expected to be closed (last point repeats first), so segments = (nPoints - 1)
+                // Contours are closed (last point repeats first)
                 const contourPoints = contour.length / 2;
                 if (contourPoints >= 2)
                     sideSegments += contourPoints - 1;
@@ -2804,7 +2803,7 @@ class Extruder {
             : triangleIndices.length * 2 + sideSegments * 6;
         const indices = new Uint32Array(indexCount);
         if (depth === 0) {
-            // Flat faces only
+            // Single-sided flat geometry at z=0
             let vPos = 0;
             for (let i = 0; i < points.length; i += 2) {
                 vertices[vPos] = points[i];
@@ -2815,15 +2814,16 @@ class Extruder {
                 normals[vPos + 2] = 1;
                 vPos += 3;
             }
+            // libtess outputs CCW, use as-is for +Z facing geometry
             for (let i = 0; i < triangleIndices.length; i++) {
                 indices[i] = triangleIndices[i];
             }
             return { vertices, normals, indices };
         }
-        // Front/back faces
+        // Extruded geometry: front at z=0, back at z=depth
         const minBackOffset = unitsPerEm * 0.000025;
         const backZ = depth <= minBackOffset ? minBackOffset : depth;
-        // Fill front vertices/normals (0..numPoints-1)
+        // Cap at z=0, back face
         for (let p = 0, vi = 0; p < points.length; p += 2, vi++) {
             const base = vi * 3;
             vertices[base] = points[p];
@@ -2831,9 +2831,9 @@ class Extruder {
             vertices[base + 2] = 0;
             normals[base] = 0;
             normals[base + 1] = 0;
-            normals[base + 2] = 1;
+            normals[base + 2] = -1;
         }
-        // Fill back vertices/normals (numPoints..2*numPoints-1)
+        // Cap at z=depth, front face
         for (let p = 0, vi = 0; p < points.length; p += 2, vi++) {
             const base = (numPoints + vi) * 3;
             vertices[base] = points[p];
@@ -2841,16 +2841,16 @@ class Extruder {
             vertices[base + 2] = backZ;
             normals[base] = 0;
             normals[base + 1] = 0;
-            normals[base + 2] = -1;
+            normals[base + 2] = 1;
         }
-        // Front indices
+        // libtess outputs CCW triangles (viewed from +Z)
+        // Z=0 cap faces -Z, reverse winding
         for (let i = 0; i < triangleIndices.length; i++) {
-            indices[i] = triangleIndices[i];
+            indices[i] = triangleIndices[triangleIndices.length - 1 - i];
         }
-        // Back indices (reverse winding + offset)
+        // Z=depth cap faces +Z, use original winding
         for (let i = 0; i < triangleIndices.length; i++) {
-            indices[triangleIndices.length + i] =
-                triangleIndices[triangleIndices.length - 1 - i] + numPoints;
+            indices[triangleIndices.length + i] = triangleIndices[i] + numPoints;
         }
         // Side walls
         let nextVertex = numPoints * 2;
@@ -2861,7 +2861,7 @@ class Extruder {
                 const p0y = contour[i + 1];
                 const p1x = contour[i + 2];
                 const p1y = contour[i + 3];
-                // Unit normal for the wall quad (per-edge)
+                // Perpendicular normal for this wall segment
                 const ex = p1x - p0x;
                 const ey = p1y - p0y;
                 const lenSq = ex * ex + ey * ey;
@@ -2874,7 +2874,7 @@ class Extruder {
                 }
                 const baseVertex = nextVertex;
                 const base = baseVertex * 3;
-                // 4 vertices (two at z=0, two at z=depth)
+                // Wall quad: front edge at z=0, back edge at z=depth
                 vertices[base] = p0x;
                 vertices[base + 1] = p0y;
                 vertices[base + 2] = 0;
@@ -2887,7 +2887,7 @@ class Extruder {
                 vertices[base + 9] = p1x;
                 vertices[base + 10] = p1y;
                 vertices[base + 11] = backZ;
-                // Normals (same for all 4 wall vertices)
+                // Wall normals point perpendicular to edge
                 normals[base] = nx;
                 normals[base + 1] = ny;
                 normals[base + 2] = 0;
@@ -2900,7 +2900,7 @@ class Extruder {
                 normals[base + 9] = nx;
                 normals[base + 10] = ny;
                 normals[base + 11] = 0;
-                // Indices (two triangles)
+                // Two triangles per wall segment
                 indices[idxPos++] = baseVertex;
                 indices[idxPos++] = baseVertex + 1;
                 indices[idxPos++] = baseVertex + 2;

package/dist/index.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.15
+ * three-text v0.2.16
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -479,9 +479,9 @@ for(let e=0;s.length>e;e+=2)a[t]=s[e],a[t+1]=s[e+1],a[t+2]=0,l[t]=0,l[t+1]=0,l[t
 for(let t=0;n.length>t;t++)c[t]=n[t]
 return{vertices:a,normals:l,indices:c}}const u=25e-6*i,f=e>u?e:u
 for(let t=0,e=0;s.length>t;t+=2,e++){const i=3*e
-a[i]=s[t],a[i+1]=s[t+1],a[i+2]=0,l[i]=0,l[i+1]=0,l[i+2]=1}for(let t=0,e=0;s.length>t;t+=2,e++){const i=3*(r+e)
-a[i]=s[t],a[i+1]=s[t+1],a[i+2]=f,l[i]=0,l[i+1]=0,l[i+2]=-1}for(let t=0;n.length>t;t++)c[t]=n[t]
-for(let t=0;n.length>t;t++)c[n.length+t]=n[n.length-1-t]+r
+a[i]=s[t],a[i+1]=s[t+1],a[i+2]=0,l[i]=0,l[i+1]=0,l[i+2]=-1}for(let t=0,e=0;s.length>t;t+=2,e++){const i=3*(r+e)
+a[i]=s[t],a[i+1]=s[t+1],a[i+2]=f,l[i]=0,l[i+1]=0,l[i+2]=1}for(let t=0;n.length>t;t++)c[t]=n[n.length-1-t]
+for(let t=0;n.length>t;t++)c[n.length+t]=n[t]+r
 let d=2*r,y=2*n.length
 for(const e of t.qi)for(let t=0;e.length-2>t;t+=2){const i=e[t],s=e[t+1],n=e[t+2],r=e[t+3],o=n-i,h=r-s,u=o*o+h*h
 let p=0,m=0

package/dist/index.min.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.15
+ * three-text v0.2.16
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -478,9 +478,9 @@ for(let e=0;s.length>e;e+=2)a[t]=s[e],a[t+1]=s[e+1],a[t+2]=0,l[t]=0,l[t+1]=0,l[t
 for(let t=0;n.length>t;t++)c[t]=n[t]
 return{vertices:a,normals:l,indices:c}}const u=25e-6*i,f=e>u?e:u
 for(let t=0,e=0;s.length>t;t+=2,e++){const i=3*e
-a[i]=s[t],a[i+1]=s[t+1],a[i+2]=0,l[i]=0,l[i+1]=0,l[i+2]=1}for(let t=0,e=0;s.length>t;t+=2,e++){const i=3*(r+e)
-a[i]=s[t],a[i+1]=s[t+1],a[i+2]=f,l[i]=0,l[i+1]=0,l[i+2]=-1}for(let t=0;n.length>t;t++)c[t]=n[t]
-for(let t=0;n.length>t;t++)c[n.length+t]=n[n.length-1-t]+r
+a[i]=s[t],a[i+1]=s[t+1],a[i+2]=0,l[i]=0,l[i+1]=0,l[i+2]=-1}for(let t=0,e=0;s.length>t;t+=2,e++){const i=3*(r+e)
+a[i]=s[t],a[i+1]=s[t+1],a[i+2]=f,l[i]=0,l[i+1]=0,l[i+2]=1}for(let t=0;n.length>t;t++)c[t]=n[n.length-1-t]
+for(let t=0;n.length>t;t++)c[n.length+t]=n[t]+r
 let d=2*r,y=2*n.length
 for(const e of t.qi)for(let t=0;e.length-2>t;t+=2){const i=e[t],s=e[t+1],n=e[t+2],r=e[t+3],o=n-i,h=r-s,u=o*o+h*h
 let p=0,g=0

package/dist/index.umd.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.15
+ * three-text v0.2.16
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -2790,12 +2790,11 @@
             const points = geometry.triangles.vertices;
             const triangleIndices = geometry.triangles.indices;
             const numPoints = points.length / 2;
-            // Count side-wall segments (each segment emits 4 vertices + 6 indices)
+            // Count side-wall segments (4 vertices + 6 indices per segment)
             let sideSegments = 0;
             if (depth !== 0) {
                 for (const contour of geometry.contours) {
-                    // Each contour is a flat [x0,y0,x1,y1,...] array; side walls connect consecutive points
-                    // Contours are expected to be closed (last point repeats first), so segments = (nPoints - 1)
+                    // Contours are closed (last point repeats first)
                     const contourPoints = contour.length / 2;
                     if (contourPoints >= 2)
                         sideSegments += contourPoints - 1;
@@ -2811,7 +2810,7 @@
                 : triangleIndices.length * 2 + sideSegments * 6;
             const indices = new Uint32Array(indexCount);
             if (depth === 0) {
-                // Flat faces only
+                // Single-sided flat geometry at z=0
                 let vPos = 0;
                 for (let i = 0; i < points.length; i += 2) {
                     vertices[vPos] = points[i];
@@ -2822,15 +2821,16 @@
                     normals[vPos + 2] = 1;
                     vPos += 3;
                 }
+                // libtess outputs CCW, use as-is for +Z facing geometry
                 for (let i = 0; i < triangleIndices.length; i++) {
                     indices[i] = triangleIndices[i];
                 }
                 return { vertices, normals, indices };
             }
-            // Front/back faces
+            // Extruded geometry: front at z=0, back at z=depth
             const minBackOffset = unitsPerEm * 0.000025;
             const backZ = depth <= minBackOffset ? minBackOffset : depth;
-            // Fill front vertices/normals (0..numPoints-1)
+            // Cap at z=0, back face
             for (let p = 0, vi = 0; p < points.length; p += 2, vi++) {
                 const base = vi * 3;
                 vertices[base] = points[p];
@@ -2838,9 +2838,9 @@
                 vertices[base + 2] = 0;
                 normals[base] = 0;
                 normals[base + 1] = 0;
-                normals[base + 2] = 1;
+                normals[base + 2] = -1;
             }
-            // Fill back vertices/normals (numPoints..2*numPoints-1)
+            // Cap at z=depth, front face
             for (let p = 0, vi = 0; p < points.length; p += 2, vi++) {
                 const base = (numPoints + vi) * 3;
                 vertices[base] = points[p];
@@ -2848,16 +2848,16 @@
                 vertices[base + 2] = backZ;
                 normals[base] = 0;
                 normals[base + 1] = 0;
-                normals[base + 2] = -1;
+                normals[base + 2] = 1;
             }
-            // Front indices
+            // libtess outputs CCW triangles (viewed from +Z)
+            // Z=0 cap faces -Z, reverse winding
             for (let i = 0; i < triangleIndices.length; i++) {
-                indices[i] = triangleIndices[i];
+                indices[i] = triangleIndices[triangleIndices.length - 1 - i];
             }
-            // Back indices (reverse winding + offset)
+            // Z=depth cap faces +Z, use original winding
             for (let i = 0; i < triangleIndices.length; i++) {
-                indices[triangleIndices.length + i] =
-                    triangleIndices[triangleIndices.length - 1 - i] + numPoints;
+                indices[triangleIndices.length + i] = triangleIndices[i] + numPoints;
             }
             // Side walls
             let nextVertex = numPoints * 2;
@@ -2868,7 +2868,7 @@
                     const p0y = contour[i + 1];
                     const p1x = contour[i + 2];
                     const p1y = contour[i + 3];
-                    // Unit normal for the wall quad (per-edge)
+                    // Perpendicular normal for this wall segment
                     const ex = p1x - p0x;
                     const ey = p1y - p0y;
                     const lenSq = ex * ex + ey * ey;
@@ -2881,7 +2881,7 @@
                     }
                     const baseVertex = nextVertex;
                     const base = baseVertex * 3;
-                    // 4 vertices (two at z=0, two at z=depth)
+                    // Wall quad: front edge at z=0, back edge at z=depth
                     vertices[base] = p0x;
                     vertices[base + 1] = p0y;
                     vertices[base + 2] = 0;
@@ -2894,7 +2894,7 @@
                     vertices[base + 9] = p1x;
                     vertices[base + 10] = p1y;
                     vertices[base + 11] = backZ;
-                    // Normals (same for all 4 wall vertices)
+                    // Wall normals point perpendicular to edge
                     normals[base] = nx;
                     normals[base + 1] = ny;
                     normals[base + 2] = 0;
@@ -2907,7 +2907,7 @@
                     normals[base + 9] = nx;
                     normals[base + 10] = ny;
                     normals[base + 11] = 0;
-                    // Indices (two triangles)
+                    // Two triangles per wall segment
                     indices[idxPos++] = baseVertex;
                     indices[idxPos++] = baseVertex + 1;
                     indices[idxPos++] = baseVertex + 2;

package/dist/index.umd.min.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.15
+ * three-text v0.2.16
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -480,9 +480,9 @@ for(let e=0;s.length>e;e+=2)a[t]=s[e],a[t+1]=s[e+1],a[t+2]=0,l[t]=0,l[t+1]=0,l[t
 for(let t=0;n.length>t;t++)c[t]=n[t]
 return{vertices:a,normals:l,indices:c}}const u=25e-6*i,f=e>u?e:u
 for(let t=0,e=0;s.length>t;t+=2,e++){const i=3*e
-a[i]=s[t],a[i+1]=s[t+1],a[i+2]=0,l[i]=0,l[i+1]=0,l[i+2]=1}for(let t=0,e=0;s.length>t;t+=2,e++){const i=3*(r+e)
-a[i]=s[t],a[i+1]=s[t+1],a[i+2]=f,l[i]=0,l[i+1]=0,l[i+2]=-1}for(let t=0;n.length>t;t++)c[t]=n[t]
-for(let t=0;n.length>t;t++)c[n.length+t]=n[n.length-1-t]+r
+a[i]=s[t],a[i+1]=s[t+1],a[i+2]=0,l[i]=0,l[i+1]=0,l[i+2]=-1}for(let t=0,e=0;s.length>t;t+=2,e++){const i=3*(r+e)
+a[i]=s[t],a[i+1]=s[t+1],a[i+2]=f,l[i]=0,l[i+1]=0,l[i+2]=1}for(let t=0;n.length>t;t++)c[t]=n[n.length-1-t]
+for(let t=0;n.length>t;t++)c[n.length+t]=n[t]+r
 let d=2*r,y=2*n.length
 for(const e of t.qi)for(let t=0;e.length-2>t;t+=2){const i=e[t],s=e[t+1],n=e[t+2],r=e[t+3],o=n-i,h=r-s,u=o*o+h*h
 let p=0,g=0

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

@@ -10,6 +10,7 @@ export interface WebGPUBufferSet {
         color?: GPUVertexBufferLayout;
     };
     indexCount: number;
+    indexFormat: GPUIndexFormat;
     dispose(): void;
 }
 export declare function createWebGPUBuffers(device: GPUDevice, textGeometry: TextGeometryInfo): WebGPUBufferSet;

package/dist/webgpu/index.cjs

@@ -4,17 +4,18 @@
 function createWebGPUBuffers(device, textGeometry) {
     const { vertices, normals, indices, colors } = textGeometry;
     const indexCount = indices.length;
+    const indexFormat = indices instanceof Uint16Array ? 'uint16' : 'uint32';
     // Interleave position and normal data for better cache coherency
     // Layout: [px, py, pz, nx, ny, nz, px, py, pz, nx, ny, nz, ...]
     const interleavedData = new Float32Array((vertices.length / 3) * 6);
     for (let i = 0; i < vertices.length / 3; i++) {
         const baseIndex = i * 6;
         const vertIndex = i * 3;
-        // Position (NO FLIP - pass through)
+        // Position
         interleavedData[baseIndex] = vertices[vertIndex];
         interleavedData[baseIndex + 1] = vertices[vertIndex + 1];
         interleavedData[baseIndex + 2] = vertices[vertIndex + 2];
-        // Normal (NO FLIP - pass through)
+        // Normal
         interleavedData[baseIndex + 3] = normals[vertIndex];
         interleavedData[baseIndex + 4] = normals[vertIndex + 1];
         interleavedData[baseIndex + 5] = normals[vertIndex + 2];
@@ -86,6 +87,7 @@ function createWebGPUBuffers(device, textGeometry) {
         buffers,
         layout,
         indexCount,
+        indexFormat,
         dispose() {
             vertexBuffer.destroy();
             indexBuffer.destroy();

package/dist/webgpu/index.d.ts

@@ -11,6 +11,7 @@ interface WebGPUBufferSet {
         color?: GPUVertexBufferLayout;
     };
     indexCount: number;
+    indexFormat: GPUIndexFormat;
     dispose(): void;
 }
 declare function createWebGPUBuffers(device: GPUDevice, textGeometry: TextGeometryInfo): WebGPUBufferSet;

package/dist/webgpu/index.js

@@ -2,17 +2,18 @@
 function createWebGPUBuffers(device, textGeometry) {
     const { vertices, normals, indices, colors } = textGeometry;
     const indexCount = indices.length;
+    const indexFormat = indices instanceof Uint16Array ? 'uint16' : 'uint32';
     // Interleave position and normal data for better cache coherency
     // Layout: [px, py, pz, nx, ny, nz, px, py, pz, nx, ny, nz, ...]
     const interleavedData = new Float32Array((vertices.length / 3) * 6);
     for (let i = 0; i < vertices.length / 3; i++) {
         const baseIndex = i * 6;
         const vertIndex = i * 3;
-        // Position (NO FLIP - pass through)
+        // Position
         interleavedData[baseIndex] = vertices[vertIndex];
         interleavedData[baseIndex + 1] = vertices[vertIndex + 1];
         interleavedData[baseIndex + 2] = vertices[vertIndex + 2];
-        // Normal (NO FLIP - pass through)
+        // Normal
         interleavedData[baseIndex + 3] = normals[vertIndex];
         interleavedData[baseIndex + 4] = normals[vertIndex + 1];
         interleavedData[baseIndex + 5] = normals[vertIndex + 2];
@@ -84,6 +85,7 @@ function createWebGPUBuffers(device, textGeometry) {
         buffers,
         layout,
         indexCount,
+        indexFormat,
         dispose() {
             vertexBuffer.destroy();
             indexBuffer.destroy();

package/package.json

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