@driftengine/ui2d 4.4.2 → 4.6.0

package/README.md

@@ -2,7 +2,7 @@
 
 The 2D layer: quads with a texture on them, batched, in the order you drew them.
 
-**Cost: 8.7 KB gzipped on top of core.** Measured by `scripts/size-gate.test.mjs`, which fails if it
+**Cost: 8.8 KB gzipped on top of core.** Measured by `scripts/size-gate.test.mjs`, which fails if it
 drifts more than 3% — the number is derived from the same floors that gate asserts, so a README
 quoting a stale one is a red suite rather than a thing somebody notices.
 

package/dist/spriteGl.js

@@ -2,14 +2,18 @@
 import { SPRITE_FRAG, SPRITE_VERT } from './shaders/sprite.js';
 import { SPRITE_FLOATS } from './spriteBatch.js';
 /**
- * The unit this pass borrows for the length of one draw.
+ * The unit this pass borrows for the length of one draw: the last of the thirty-two a program's
+ * stages share, which WebGL2 guarantees, and which core's texture-unit gate keeps every lit-pass
+ * unit below.
  *
- * Fourteen is above every unit `lightBudget.ts` assigns — `COOKIE_ATLAS_TEXTURE_UNIT` is the
- * highest at thirteen — and below the sixteen WebGL2 guarantees. The pass releases it before it
- * returns, because a texture left bound to a unit a later pass attaches is a feedback loop rather
- * than a wrong colour.
+ * **It was fourteen, on the reasoning that fourteen was above every unit the lit pass assigned**, and
+ * that stopped being true when DriftLight's atlas and the glass tints took units thirteen to
+ * sixteen. The pass releases its unit before it returns — a texture left bound where a later pass
+ * attaches is a feedback loop — so sprites drawn between two mesh draws unbound the lit pass's
+ * texture on fourteen, and the next mesh sampled nothing there. A unit per stage is a separate,
+ * smaller guarantee; this program declares one sampler, so the combined pool is the one that binds.
  */
-const SPRITE_UNIT = 14;
+const SPRITE_UNIT = 31;
 /** Bytes per instance. Fourteen floats; see `SPRITE_FLOATS`. */
 const STRIDE = SPRITE_FLOATS * 4;
 function compile(gl, kind, source, label) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftengine/ui2d",
-  "version": "4.4.2",
+  "version": "4.6.0",
   "description": "The 2D layer: batched sprites, sheets, tilemaps, and a retained interface tree over them",
   "license": "Apache-2.0",
   "type": "module",
@@ -27,7 +27,7 @@
   ],
   "sideEffects": false,
   "peerDependencies": {
-    "@driftengine/core": "4.4.2"
+    "@driftengine/core": "4.6.0"
   },
   "author": "Drift Technologies",
   "repository": {

package/src/spriteGl.ts

@@ -6,14 +6,18 @@ import type { SpriteBatch } from './spriteBatch.ts';
 import type { SpriteTextureOptions } from './spriteTexture.ts';
 
 /**
- * The unit this pass borrows for the length of one draw.
+ * The unit this pass borrows for the length of one draw: the last of the thirty-two a program's
+ * stages share, which WebGL2 guarantees, and which core's texture-unit gate keeps every lit-pass
+ * unit below.
  *
- * Fourteen is above every unit `lightBudget.ts` assigns — `COOKIE_ATLAS_TEXTURE_UNIT` is the
- * highest at thirteen — and below the sixteen WebGL2 guarantees. The pass releases it before it
- * returns, because a texture left bound to a unit a later pass attaches is a feedback loop rather
- * than a wrong colour.
+ * **It was fourteen, on the reasoning that fourteen was above every unit the lit pass assigned**, and
+ * that stopped being true when DriftLight's atlas and the glass tints took units thirteen to
+ * sixteen. The pass releases its unit before it returns — a texture left bound where a later pass
+ * attaches is a feedback loop — so sprites drawn between two mesh draws unbound the lit pass's
+ * texture on fourteen, and the next mesh sampled nothing there. A unit per stage is a separate,
+ * smaller guarantee; this program declares one sampler, so the combined pool is the one that binds.
  */
-const SPRITE_UNIT = 14;
+const SPRITE_UNIT = 31;
 
 /** Bytes per instance. Fourteen floats; see `SPRITE_FLOATS`. */
 const STRIDE = SPRITE_FLOATS * 4;