@driftengine/core 4.6.0 → 4.6.1

package/CHANGELOG.json

@@ -1,4 +1,15 @@
 [
+ {
+  "version": "4.6.1",
+  "date": "2026-10-01",
+  "entries": [
+   {
+    "kind": "fixed",
+    "short": "A mesh with no triangles is skipped by every pass instead of drawn as nothing, so a game's console no longer fills with WebGPU warnings about empty draws.",
+    "text": "**A mesh with no triangles draws nothing, in every pass, on both backends.** A game's world can hold an empty mesh, for a level with none of that kind of geometry, and every pass it reached issued a draw of zero indices: WebGPU answers each with a warning, five on one game's first screen (the frame, its reflection, the sun's static and peeled maps and a lamp's shadow faces), and WebGL2 counted draws that drew nothing. `GpuMesh.indexCount` and `Mesh.indexCount` carry the rule, and every place a mesh enters a pass skips an empty one beside its other checks: meshes, translucent meshes, instanced batches, light volumes, shadow casters, glass depth and the motion pass. A game that already skipped its empty meshes itself can keep doing so."
+   }
+  ]
+ },
  {
   "version": "4.6.0",
   "date": "2026-10-01",

package/README.md

@@ -2,7 +2,7 @@
 
 The runtime everything needs: renderer, loop, camera, input, geometry. Collision and dynamics live in [`@driftengine/physics`](../physics/README.md), which this package depends on and re-exports whole, so reaching for them through this barrel works as it always did.
 
-**Cost: 698.9 KB gzipped, importing `createRenderer`.** Measured by `scripts/size-gate.test.mjs`, which fails if it drifts more than
+**Cost: 699.0 KB gzipped, importing `createRenderer`.** Measured by `scripts/size-gate.test.mjs`, which fails if it drifts more than
 3% — the number is a fact about the build rather than a claim in a document.
 
 Part of [DriftEngine](../../README.md). See [`docs/ARCHITECTURE.md`](../../docs/ARCHITECTURE.md)

package/dist/render/backend/webgl2/renderer.js

@@ -2844,7 +2844,8 @@ export class WebGL2Renderer {
         if (this.contextLost)
             return;
         const mesh = batch.mesh;
-        if (!mesh.complete)
+        /* Nor a batch of a mesh with nothing in it: see `Mesh.indexCount`. */
+        if (!mesh.complete || mesh.indexCount === 0)
             return;
         const count = Math.min(data.count, batch.capacity);
         if (count === 0)
@@ -6215,8 +6216,9 @@ export class WebGL2Renderer {
     _previousModel = null) {
         if (this.contextLost)
             return;
-        /* Geometry that has not all arrived is not drawn. See `Mesh.complete`. */
-        if (!mesh.complete)
+        /* Geometry that has not all arrived is not drawn, nor a mesh with none. See `Mesh.complete`
+           and `Mesh.indexCount`. */
+        if (!mesh.complete || mesh.indexCount === 0)
             return;
         /*
          * Skipped where the flag asks and the bounds say so.
@@ -6406,8 +6408,9 @@ export class WebGL2Renderer {
     drawTranslucentMesh(mesh, model, opacity, options = {}) {
         if (this.contextLost)
             return;
-        /* Geometry that has not all arrived is not drawn. See `Mesh.complete`. */
-        if (!mesh.complete)
+        /* Geometry that has not all arrived is not drawn, nor a mesh with none. See `Mesh.complete`
+           and `Mesh.indexCount`. */
+        if (!mesh.complete || mesh.indexCount === 0)
             return;
         if (opacity <= 0)
             return;
@@ -6803,8 +6806,9 @@ export class WebGL2Renderer {
     drawLightVolume(mesh, model, camera, strength, length, spread, options = {}) {
         if (this.contextLost)
             return;
-        /* Geometry that has not all arrived is not drawn. See `Mesh.complete`. */
-        if (!mesh.complete)
+        /* Geometry that has not all arrived is not drawn, nor a mesh with none. See `Mesh.complete`
+           and `Mesh.indexCount`. */
+        if (!mesh.complete || mesh.indexCount === 0)
             return;
         const shown = options.medium === undefined
             ? strength

package/dist/render/backend/webgpu/buffers.d.ts

@@ -68,6 +68,13 @@ export interface GpuMesh {
         readonly weights: number;
     } | null;
     readonly indexBuffer: GPUBuffer;
+    /**
+     * How many indices the mesh draws. **Zero is a mesh with nothing to draw, and no pass draws it**:
+     * a level can hold none of some kind of geometry, and a draw of zero indices does nothing but
+     * earn a warning from the device in every pass that issues it. Every place a mesh enters a pass
+     * checks this beside `complete` or its vertex buffers, and WebGL2 skips the same meshes, so the
+     * two backends count the same draws.
+     */
     readonly indexCount: number;
     /**
      * How big this mesh is, in its own space.

package/dist/render/backend/webgpu/motionPass.js

@@ -465,7 +465,8 @@ export class MotionPass {
                 else {
                     pipeline = this.pipelineFor(mesh.vertexStride);
                 }
-                if (pipeline === null)
+                /* A mesh with nothing in it draws nothing: see `GpuMesh.indexCount`. */
+                if (pipeline === null || mesh.indexCount === 0)
                     continue;
                 if (pipeline !== bound) {
                     pass.setPipeline(pipeline);

package/dist/render/backend/webgpu/renderer.js

@@ -1982,7 +1982,7 @@ export class WebGPURenderer {
         if (!this.canDraw())
             return;
         const geometry = mesh;
-        if (geometry.vertexBuffers === undefined)
+        if (geometry.vertexBuffers === undefined || geometry.indexCount === 0)
             return;
         const vertexSlot = this.filmVerts.allocate();
         const fragmentSlot = this.filmFrags.allocate();
@@ -3465,8 +3465,9 @@ export class WebGPURenderer {
             return;
         /* Geometry that has not all arrived is not drawn, which is the surface's contract and what
            every other mesh verb here and the other backend's volume already kept. This one drew a
-           beam from a buffer still filling, and counted it, until 2026-09-19. See `Mesh.complete`. */
-        if (!mesh.complete)
+           beam from a buffer still filling, and counted it, until 2026-09-19. See `Mesh.complete`. A
+           hull with no triangles draws nothing either: see `GpuMesh.indexCount`. */
+        if (!mesh.complete || mesh.indexCount === 0)
             return;
         /* At zero it draws nothing rather than adding black, so a caller may keep the call in. That
            now covers a clear night too: a beam with no medium to light is not drawn at all. */
@@ -4426,7 +4427,7 @@ export class WebGPURenderer {
             if (cutout !== null && cutoutGroup !== null)
                 this.writeCutout(slot, cutout, DEPTH_CUTOUT_VERT_FIELDS);
             const geometry = mesh;
-            if (geometry.vertexBuffers === undefined)
+            if (geometry.vertexBuffers === undefined || geometry.indexCount === 0)
                 return;
             const cuts = cutoutGroup !== null;
             /* A two-sided caster casts from whichever face the light sees: nothing culled. */
@@ -4455,7 +4456,7 @@ export class WebGPURenderer {
                 return;
             const gpuBatch = batch;
             const geometry = gpuBatch.mesh;
-            if (geometry.vertexBuffers === undefined)
+            if (geometry.vertexBuffers === undefined || geometry.indexCount === 0)
                 return;
             const count = Math.min(data.count, gpuBatch.capacity);
             if (count === 0)
@@ -4510,7 +4511,7 @@ export class WebGPURenderer {
             this.shadowDraws.writeFloats(slot, DEPTH_VERT_FIELDS.uModel.offset, model);
             this.writeShadowWind(slot);
             const geometry = mesh;
-            if (geometry.vertexBuffers === undefined)
+            if (geometry.vertexBuffers === undefined || geometry.indexCount === 0)
                 return;
             pass.setPipeline(depthPipeline(this.pipelines, this.surface.device, this.shadowSkinnedLayout, `depth-skinned|${this.depthCullMode}|${geometry.key ?? ''}`, this.presentOf(geometry), this.depthCullMode, true));
             pass.setBindGroup(0, this.shadowSkinnedGroup(view, paletteSlot), [slot]);
@@ -4532,7 +4533,7 @@ export class WebGPURenderer {
             if (pass === null || data.count === 0)
                 return;
             const geometry = scatter;
-            if (geometry.vertexBuffers === undefined)
+            if (geometry.vertexBuffers === undefined || geometry.indexCount === 0)
                 return;
             const v = this.scatterDepthFloats;
             const at = (name) => (SCATTER_DEPTH_FIELDS[name]?.offset ?? -4) / 4;
@@ -6823,8 +6824,9 @@ export class WebGPURenderer {
     submitMesh(mesh, model, tint, opacity, blend, options = {}) {
         if (!this.canDraw() || this.viewProj === null)
             return;
-        /* Geometry that has not all arrived is not drawn. See `GpuMesh.complete`. */
-        if (!mesh.complete)
+        /* Geometry that has not all arrived is not drawn, nor a mesh with none. See `GpuMesh.complete`
+           and `GpuMesh.indexCount`. */
+        if (!mesh.complete || mesh.indexCount === 0)
             return;
         const slot = this.perDraw.allocate();
         if (slot === null) {
@@ -7212,7 +7214,8 @@ export class WebGPURenderer {
         if (!this.canDraw() || this.viewProj === null)
             return;
         const mesh = batch.mesh;
-        if (!mesh.complete)
+        /* Nor a batch of a mesh with nothing in it: see `GpuMesh.indexCount`. */
+        if (!mesh.complete || mesh.indexCount === 0)
             return;
         const count = Math.min(data.count, batch.capacity);
         if (count === 0)
@@ -7803,7 +7806,7 @@ export class WebGPURenderer {
             if (pass === null || tint === null)
                 return;
             const geometry = mesh;
-            if (geometry.vertexBuffers === undefined)
+            if (geometry.vertexBuffers === undefined || geometry.indexCount === 0)
                 return;
             const cutout = cutoutOf(material);
             const albedo = cutout === null ? null : cutout.albedo;
@@ -7834,7 +7837,7 @@ export class WebGPURenderer {
                 return;
             const gpuBatch = batch;
             const geometry = gpuBatch.mesh;
-            if (geometry.vertexBuffers === undefined)
+            if (geometry.vertexBuffers === undefined || geometry.indexCount === 0)
                 return;
             const count = Math.min(data.count, gpuBatch.capacity);
             if (count === 0)
@@ -7867,7 +7870,7 @@ export class WebGPURenderer {
             if (pass === null || tint === null)
                 return;
             const geometry = mesh;
-            if (geometry.vertexBuffers === undefined)
+            if (geometry.vertexBuffers === undefined || geometry.indexCount === 0)
                 return;
             const paletteSlot = this.skinPalettes.take(this.surface.device, palette);
             const view = paletteSlot === null ? null : this.skinPalettes.view(paletteSlot);

package/dist/render/mesh.d.ts

@@ -19,7 +19,12 @@ export declare class Mesh {
     private readonly deformable;
     /** How many floats the position buffer holds, so an update of the wrong size is refused. */
     private readonly positionFloats;
-    /** Indices one draw of it issues; the batch-size rule reads it (`cullsInstances`). */
+    /**
+     * Indices one draw of it issues; the batch-size rule reads it (`cullsInstances`). **At zero the
+     * mesh has nothing to draw and no verb draws it**, as on WebGPU (`GpuMesh.indexCount`): a draw of
+     * nothing is silent here but is still a call and a counted draw, and the two backends count the
+     * same frame.
+     */
     readonly indexCount: number;
     /**
      * The constant values this mesh's *absent* attributes are shaded with, re-applied on

package/dist/render/mesh.js

@@ -88,7 +88,12 @@ export class Mesh {
     deformable = null;
     /** How many floats the position buffer holds, so an update of the wrong size is refused. */
     positionFloats;
-    /** Indices one draw of it issues; the batch-size rule reads it (`cullsInstances`). */
+    /**
+     * Indices one draw of it issues; the batch-size rule reads it (`cullsInstances`). **At zero the
+     * mesh has nothing to draw and no verb draws it**, as on WebGPU (`GpuMesh.indexCount`): a draw of
+     * nothing is silent here but is still a call and a counted draw, and the two backends count the
+     * same frame.
+     */
     indexCount;
     /**
      * The constant values this mesh's *absent* attributes are shaded with, re-applied on

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftengine/core",
-  "version": "4.6.0",
+  "version": "4.6.1",
   "description": "DriftEngine reusable browser 3D runtime",
   "license": "Apache-2.0",
   "type": "module",
@@ -29,8 +29,8 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@driftengine/drft": "4.6.0",
-    "@driftengine/physics": "4.6.0",
+    "@driftengine/drft": "4.6.1",
+    "@driftengine/physics": "4.6.1",
     "gl-matrix": "^3.4.3"
   },
   "author": "Drift Technologies",
@@ -63,8 +63,8 @@
     "prepack": "node ../../scripts/build.mjs @driftengine/core"
   },
   "devDependencies": {
-    "@driftengine/nav": "4.6.0",
-    "@driftengine/network": "4.6.0",
-    "@driftengine/texture": "4.6.0"
+    "@driftengine/nav": "4.6.1",
+    "@driftengine/network": "4.6.1",
+    "@driftengine/texture": "4.6.1"
   }
 }

package/src/render/backend/webgl2/renderer.ts

@@ -3794,7 +3794,8 @@ export class WebGL2Renderer implements RendererApi {
   ): void {
     if (this.contextLost) return;
     const mesh = batch.mesh;
-    if (!mesh.complete) return;
+    /* Nor a batch of a mesh with nothing in it: see `Mesh.indexCount`. */
+    if (!mesh.complete || mesh.indexCount === 0) return;
     const count = Math.min(data.count, batch.capacity);
     if (count === 0) return;
     /* A culling batch's camera draw: the whole batch against the view and the occluders first,
@@ -7698,8 +7699,9 @@ export class WebGL2Renderer implements RendererApi {
     _previousModel: ReadonlyMat4 | Mover | null = null,
   ): void {
     if (this.contextLost) return;
-    /* Geometry that has not all arrived is not drawn. See `Mesh.complete`. */
-    if (!mesh.complete) return;
+    /* Geometry that has not all arrived is not drawn, nor a mesh with none. See `Mesh.complete`
+       and `Mesh.indexCount`. */
+    if (!mesh.complete || mesh.indexCount === 0) return;
 
     /*
      * Skipped where the flag asks and the bounds say so.
@@ -7885,8 +7887,9 @@ export class WebGL2Renderer implements RendererApi {
     options: TranslucentMeshOptions = {},
   ): void {
     if (this.contextLost) return;
-    /* Geometry that has not all arrived is not drawn. See `Mesh.complete`. */
-    if (!mesh.complete) return;
+    /* Geometry that has not all arrived is not drawn, nor a mesh with none. See `Mesh.complete`
+       and `Mesh.indexCount`. */
+    if (!mesh.complete || mesh.indexCount === 0) return;
 
     if (opacity <= 0) return;
 
@@ -8312,8 +8315,9 @@ export class WebGL2Renderer implements RendererApi {
     options: LightVolumeDrawOptions = {},
   ): void {
     if (this.contextLost) return;
-    /* Geometry that has not all arrived is not drawn. See `Mesh.complete`. */
-    if (!mesh.complete) return;
+    /* Geometry that has not all arrived is not drawn, nor a mesh with none. See `Mesh.complete`
+       and `Mesh.indexCount`. */
+    if (!mesh.complete || mesh.indexCount === 0) return;
     const shown =
       options.medium === undefined
         ? strength

package/src/render/backend/webgpu/buffers.ts

@@ -154,6 +154,13 @@ export interface GpuMesh {
    */
   readonly skinOffsets: { readonly joints: number; readonly weights: number } | null;
   readonly indexBuffer: GPUBuffer;
+  /**
+   * How many indices the mesh draws. **Zero is a mesh with nothing to draw, and no pass draws it**:
+   * a level can hold none of some kind of geometry, and a draw of zero indices does nothing but
+   * earn a warning from the device in every pass that issues it. Every place a mesh enters a pass
+   * checks this beside `complete` or its vertex buffers, and WebGL2 skips the same meshes, so the
+   * two backends count the same draws.
+   */
   readonly indexCount: number;
   /**
    * How big this mesh is, in its own space.

package/src/render/backend/webgpu/motionPass.ts

@@ -509,7 +509,8 @@ export class MotionPass {
         } else {
           pipeline = this.pipelineFor(mesh.vertexStride);
         }
-        if (pipeline === null) continue;
+        /* A mesh with nothing in it draws nothing: see `GpuMesh.indexCount`. */
+        if (pipeline === null || mesh.indexCount === 0) continue;
         if (pipeline !== bound) {
           pass.setPipeline(pipeline);
           bound = pipeline;

package/src/render/backend/webgpu/renderer.ts

@@ -2624,7 +2624,7 @@ export class WebGPURenderer implements RendererApi {
   ): void {
     if (!this.canDraw()) return;
     const geometry = mesh as GpuMesh & { key?: string };
-    if (geometry.vertexBuffers === undefined) return;
+    if (geometry.vertexBuffers === undefined || geometry.indexCount === 0) return;
     const vertexSlot = this.filmVerts.allocate();
     const fragmentSlot = this.filmFrags.allocate();
     if (vertexSlot === null || fragmentSlot === null) return;
@@ -4329,8 +4329,9 @@ export class WebGPURenderer implements RendererApi {
     if (!this.canDraw()) return;
     /* Geometry that has not all arrived is not drawn, which is the surface's contract and what
        every other mesh verb here and the other backend's volume already kept. This one drew a
-       beam from a buffer still filling, and counted it, until 2026-09-19. See `Mesh.complete`. */
-    if (!mesh.complete) return;
+       beam from a buffer still filling, and counted it, until 2026-09-19. See `Mesh.complete`. A
+       hull with no triangles draws nothing either: see `GpuMesh.indexCount`. */
+    if (!mesh.complete || mesh.indexCount === 0) return;
     /* At zero it draws nothing rather than adding black, so a caller may keep the call in. That
        now covers a clear night too: a beam with no medium to light is not drawn at all. */
     const shown =
@@ -5478,7 +5479,7 @@ export class WebGPURenderer implements RendererApi {
         this.writeCutout(slot, cutout, DEPTH_CUTOUT_VERT_FIELDS);
 
       const geometry = mesh as GpuMesh & { key?: string };
-      if (geometry.vertexBuffers === undefined) return;
+      if (geometry.vertexBuffers === undefined || geometry.indexCount === 0) return;
       const cuts = cutoutGroup !== null;
       /* A two-sided caster casts from whichever face the light sees: nothing culled. */
       const cull = material?.doubleSided === true ? 'none' : this.depthCullMode;
@@ -5517,7 +5518,7 @@ export class WebGPURenderer implements RendererApi {
       if (pass === null) return;
       const gpuBatch = batch as GpuInstancedBatch;
       const geometry = gpuBatch.mesh as GpuMesh & { key?: string };
-      if (geometry.vertexBuffers === undefined) return;
+      if (geometry.vertexBuffers === undefined || geometry.indexCount === 0) return;
       const count = Math.min(data.count, gpuBatch.capacity);
       if (count === 0) return;
       const cutout = cutoutOf(material);
@@ -5591,7 +5592,7 @@ export class WebGPURenderer implements RendererApi {
       this.writeShadowWind(slot);
 
       const geometry = mesh as GpuMesh & { key?: string };
-      if (geometry.vertexBuffers === undefined) return;
+      if (geometry.vertexBuffers === undefined || geometry.indexCount === 0) return;
       pass.setPipeline(
         depthPipeline(
           this.pipelines,
@@ -5621,7 +5622,7 @@ export class WebGPURenderer implements RendererApi {
       const pass = this.shadowPass;
       if (pass === null || data.count === 0) return;
       const geometry = scatter as GpuScatter;
-      if (geometry.vertexBuffers === undefined) return;
+      if (geometry.vertexBuffers === undefined || geometry.indexCount === 0) return;
 
       const v = this.scatterDepthFloats;
       const at = (name: string): number => (SCATTER_DEPTH_FIELDS[name]?.offset ?? -4) / 4;
@@ -8422,8 +8423,9 @@ export class WebGPURenderer implements RendererApi {
     options: TranslucentMeshOptions = {},
   ): void {
     if (!this.canDraw() || this.viewProj === null) return;
-    /* Geometry that has not all arrived is not drawn. See `GpuMesh.complete`. */
-    if (!mesh.complete) return;
+    /* Geometry that has not all arrived is not drawn, nor a mesh with none. See `GpuMesh.complete`
+       and `GpuMesh.indexCount`. */
+    if (!mesh.complete || mesh.indexCount === 0) return;
 
     const slot = this.perDraw.allocate();
     if (slot === null) {
@@ -8868,7 +8870,8 @@ export class WebGPURenderer implements RendererApi {
   ): void {
     if (!this.canDraw() || this.viewProj === null) return;
     const mesh = batch.mesh;
-    if (!mesh.complete) return;
+    /* Nor a batch of a mesh with nothing in it: see `GpuMesh.indexCount`. */
+    if (!mesh.complete || mesh.indexCount === 0) return;
     const count = Math.min(data.count, batch.capacity);
     if (count === 0) return;
     /* A culling batch's camera draw: the whole batch against the view and the occluders on the CPU,
@@ -9522,7 +9525,7 @@ export class WebGPURenderer implements RendererApi {
       const tint = this.glassTint;
       if (pass === null || tint === null) return;
       const geometry = mesh as GpuMesh & { key?: string };
-      if (geometry.vertexBuffers === undefined) return;
+      if (geometry.vertexBuffers === undefined || geometry.indexCount === 0) return;
       const cutout = cutoutOf(material);
       const albedo = cutout === null ? null : (cutout.albedo as unknown as GpuSurfaceTexture);
       const slot = this.shadowDraws.allocate();
@@ -9565,7 +9568,7 @@ export class WebGPURenderer implements RendererApi {
       if (pass === null || tint === null) return;
       const gpuBatch = batch as GpuInstancedBatch;
       const geometry = gpuBatch.mesh as GpuMesh & { key?: string };
-      if (geometry.vertexBuffers === undefined) return;
+      if (geometry.vertexBuffers === undefined || geometry.indexCount === 0) return;
       const count = Math.min(data.count, gpuBatch.capacity);
       if (count === 0) return;
       const cutout = cutoutOf(material);
@@ -9609,7 +9612,7 @@ export class WebGPURenderer implements RendererApi {
       const tint = this.glassTint;
       if (pass === null || tint === null) return;
       const geometry = mesh as GpuMesh & { key?: string };
-      if (geometry.vertexBuffers === undefined) return;
+      if (geometry.vertexBuffers === undefined || geometry.indexCount === 0) return;
       const paletteSlot = this.skinPalettes.take(this.surface.device, palette);
       const view = paletteSlot === null ? null : this.skinPalettes.view(paletteSlot);
       if (view === null) return;

package/src/render/mesh.ts

@@ -99,7 +99,12 @@ export class Mesh {
   private readonly deformable: { positions: WebGLBuffer; normals: WebGLBuffer } | null = null;
   /** How many floats the position buffer holds, so an update of the wrong size is refused. */
   private readonly positionFloats: number;
-  /** Indices one draw of it issues; the batch-size rule reads it (`cullsInstances`). */
+  /**
+   * Indices one draw of it issues; the batch-size rule reads it (`cullsInstances`). **At zero the
+   * mesh has nothing to draw and no verb draws it**, as on WebGPU (`GpuMesh.indexCount`): a draw of
+   * nothing is silent here but is still a call and a counted draw, and the two backends count the
+   * same frame.
+   */
   readonly indexCount: number;
   /**
    * The constant values this mesh's *absent* attributes are shaded with, re-applied on