@flighthq/render-gl 0.3.0 → 0.3.1-next.1050.9114695

package/dist/glTextureResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"glTextureResolver.js","sourceRoot":"","sources":["../src/glTextureResolver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"glTextureResolver.js","sourceRoot":"","sources":["../src/glTextureResolver.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/render-gl",
-  "version": "0.3.0",
+  "version": "0.3.1-next.1050.9114695",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,15 +38,16 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/color": "0.3.0",
-    "@flighthq/entity": "0.3.0",
-    "@flighthq/log": "0.3.0",
-    "@flighthq/scene2d": "0.3.0",
-    "@flighthq/geometry": "0.3.0",
-    "@flighthq/render": "0.3.0",
-    "@flighthq/signals": "0.3.0",
-    "@flighthq/texture": "0.3.0",
-    "@flighthq/types": "0.3.0"
+    "@flighthq/color": "0.3.1-next.1050.9114695",
+    "@flighthq/entity": "0.3.1-next.1050.9114695",
+    "@flighthq/log": "0.3.1-next.1050.9114695",
+    "@flighthq/scene2d": "0.3.1-next.1050.9114695",
+    "@flighthq/geometry": "0.3.1-next.1050.9114695",
+    "@flighthq/render": "0.3.1-next.1050.9114695",
+    "@flighthq/registry": "0.3.1-next.1050.9114695",
+    "@flighthq/signals": "0.3.1-next.1050.9114695",
+    "@flighthq/texture": "0.3.1-next.1050.9114695",
+    "@flighthq/types": "0.3.1-next.1050.9114695"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/enableGlRenderStateGuards.test.ts

@@ -1,5 +1,7 @@
 import { setLogSink } from '@flighthq/log/contract';
+import { getRenderStateRuntime } from '@flighthq/render/contract';
 import type { LogEntry } from '@flighthq/types/contract';
+import { RegistryEntryState } from '@flighthq/types/contract';
 
 import { areGlRenderStateGuardsEnabled, enableGlRenderStateGuards } from './enableGlRenderStateGuards';
 import { useGlProgram } from './glDraw';
@@ -25,8 +27,16 @@ describe('enableGlRenderStateGuards', () => {
   it('installs the state-local multiple-root guard idempotently', () => {
     const state = createState();
     enableGlRenderStateGuards(state);
+    const table = getRenderStateRuntime(state).registries.renderRootGuard;
+    expect(table).toMatchObject({
+      entry: { state: RegistryEntryState.Bound },
+      onMiss: 'Disabled',
+      registry: 'RenderRootGuard',
+      shape: 'slot',
+    });
     enableGlRenderStateGuards(state);
     expect(areGlRenderStateGuardsEnabled(state)).toBe(true);
+    expect(getRenderStateRuntime(state).registries.renderRootGuard).toBe(table);
   });
 });
 

package/src/glCompressedTexture.test.ts

@@ -1,5 +1,5 @@
 import type { CompressedImage, GlCompressedTextureSupport, TextureContainer } from '@flighthq/types/contract';
-import { CompressedImageTextureSourceKind } from '@flighthq/types/contract';
+import { CompressedImageTextureSourceKind, RegistryEntryState } from '@flighthq/types/contract';
 
 import {
   detectGlCompressedTextureSupport,
@@ -119,23 +119,35 @@ describe('hasGlCompressedTextureFormat', () => {
 });
 
 describe('registerGlCompressedTextureDecoder', () => {
-  it('installs the decoder on the render-state runtime and clears it with null', () => {
+  it('replaces the decoder policy slot and clears it with null', () => {
     const { state } = createGlState();
+    const runtime = getGlRenderStateRuntime(state);
+    const before = runtime.registries.compressedTextureDecoder;
     const decode = vi.fn(() => new Uint8ClampedArray(4));
     registerGlCompressedTextureDecoder(state, decode);
-    expect(getGlRenderStateRuntime(state).compressedTextureDecoder).toBe(decode);
+    expect(runtime.registries.compressedTextureDecoder).not.toBe(before);
+    expect(runtime.registries.compressedTextureDecoder.entry).toEqual({
+      state: RegistryEntryState.Bound,
+      value: decode,
+    });
     registerGlCompressedTextureDecoder(state, null);
-    expect(getGlRenderStateRuntime(state).compressedTextureDecoder).toBeNull();
+    expect(runtime.registries.compressedTextureDecoder.entry).toBeNull();
   });
 });
 
 describe('registerGlCompressedTextureUpload', () => {
-  it('installs the compressed upload seam on the render-state runtime and clears it with null', () => {
+  it('replaces the compressed upload policy slot and clears it with null', () => {
     const { state } = createGlState();
+    const runtime = getGlRenderStateRuntime(state);
+    const before = runtime.registries.compressedTextureUpload;
     registerGlCompressedTextureUpload(state);
-    expect(getGlRenderStateRuntime(state).compressedTextureUpload).toBeTypeOf('function');
+    expect(runtime.registries.compressedTextureUpload).not.toBe(before);
+    expect(runtime.registries.compressedTextureUpload.entry).toMatchObject({
+      state: RegistryEntryState.Bound,
+      value: expect.any(Function),
+    });
     registerGlCompressedTextureUpload(state, null);
-    expect(getGlRenderStateRuntime(state).compressedTextureUpload).toBeNull();
+    expect(runtime.registries.compressedTextureUpload.entry).toBeNull();
   });
 
   it('uploads a CompressedImage once installed, threading the registered decoder', () => {
@@ -144,8 +156,11 @@ describe('registerGlCompressedTextureUpload', () => {
     const decode = vi.fn(() => rgba);
     registerGlCompressedTextureUpload(state);
     registerGlCompressedTextureDecoder(state, decode);
-    const uploader = getGlRenderStateRuntime(state).compressedTextureUpload!;
-    const ok = uploader(gl, uploadableCompressedImage(), decode);
+    const entry = getGlRenderStateRuntime(state).registries.compressedTextureUpload.entry;
+    expect(entry?.state).toBe(RegistryEntryState.Bound);
+    const uploader = entry?.state === RegistryEntryState.Bound ? entry.value : null;
+    expect(uploader).not.toBeNull();
+    const ok = uploader!(gl, uploadableCompressedImage(), decode);
     expect(ok).toBe(true);
     expect(decode).toHaveBeenCalledWith('bc3', 4, 4, expect.any(Uint8Array));
   });
@@ -153,10 +168,12 @@ describe('registerGlCompressedTextureUpload', () => {
   it('rejects non-2D containers because the installed image bridge is bound to TEXTURE_2D', () => {
     const { state } = createGlState();
     registerGlCompressedTextureUpload(state);
-    const uploader = getGlRenderStateRuntime(state).compressedTextureUpload!;
+    const entry = getGlRenderStateRuntime(state).registries.compressedTextureUpload.entry;
+    const uploader = entry?.state === RegistryEntryState.Bound ? entry.value : null;
+    expect(uploader).not.toBeNull();
     const gl = makeGl({ WEBGL_compressed_texture_s3tc: S3TC_EXT });
-    expect(uploader(gl, uploadableCompressedImage({ faces: 6 }), null)).toBe(false);
-    expect(uploader(gl, uploadableCompressedImage({ layers: 2 }), null)).toBe(false);
+    expect(uploader!(gl, uploadableCompressedImage({ faces: 6 }), null)).toBe(false);
+    expect(uploader!(gl, uploadableCompressedImage({ layers: 2 }), null)).toBe(false);
     expect(gl.compressedTexImage2D).not.toHaveBeenCalled();
     expect(gl.texStorage3D).not.toHaveBeenCalled();
   });

package/src/glDraw.test.ts

@@ -1,3 +1,4 @@
+import { getRegistryTableEntry } from '@flighthq/registry/contract';
 import { getTextureSource } from '@flighthq/texture/contract';
 import type { Bitmap, CompressedImage, Image, SamplerLike, Texture } from '@flighthq/types/contract';
 import {
@@ -27,7 +28,7 @@ import {
   updateGlTexture,
   useGlProgram,
 } from './glDraw';
-import { getGlRenderStateRuntime } from './glRenderState';
+import { createGlOffscreenRenderState, getGlRenderStateRuntime } from './glRenderState';
 import { registerGlBitmapShader } from './glShaderRegistry';
 import { createGlState } from './glTestHelper';
 
@@ -833,6 +834,24 @@ describe('registerGlBlendMode', () => {
     const g = gl as unknown as { ONE: number; ZERO: number };
     expect(gl.blendFunc).toHaveBeenCalledWith(g.ZERO, g.ONE);
   });
+
+  it("replaces the table without changing an offscreen state's retained snapshot", () => {
+    const { state: screen } = createGlState();
+    const initial = { src: 'DST_COLOR', dst: 'ZERO' } as const;
+    const replacement = { src: 'ZERO', dst: 'ONE' } as const;
+    registerGlBlendMode(screen, 'acme.Foo', initial);
+    const snapshot = getGlRenderStateRuntime(screen).registries.blendRealizations;
+    const offscreen = createGlOffscreenRenderState(screen);
+
+    registerGlBlendMode(screen, 'acme.Foo', replacement);
+
+    expect(getGlRenderStateRuntime(screen).registries.blendRealizations).not.toBe(snapshot);
+    expect(getGlRenderStateRuntime(offscreen).registries.blendRealizations).toBe(snapshot);
+    expect(getRegistryTableEntry(snapshot, 'acme.Foo')).toBe(initial);
+    expect(getRegistryTableEntry(getGlRenderStateRuntime(screen).registries.blendRealizations, 'acme.Foo')).toBe(
+      replacement,
+    );
+  });
 });
 
 describe('setGlQuadMatrixFromOffset', () => {
@@ -841,7 +860,7 @@ describe('setGlQuadMatrixFromOffset', () => {
     // Identity transform + offset (dx=10, dy=20): effective tx = 0 + 1*10 + 0*20 = 10
     const runtime = getGlRenderStateRuntime(state);
     setGlQuadMatrixFromOffset(state, 1, 0, 0, 1, 0, 0, 10, 20);
-    expect(gl.uniformMatrix3fv).toHaveBeenCalledWith(runtime.shaderLoc.locMatrix, false, runtime.matrixArray);
+    expect(gl.uniformMatrix3fv).toHaveBeenCalledWith(runtime.shaderLoc!.locMatrix, false, runtime.matrixArray);
     // tx * 2/200 - 1 = 10 * 0.01 - 1 = -0.9
     expect(runtime.matrixArray[6]).toBeCloseTo(-0.9);
     // -ty * 2/100 + 1 = -20 * 0.02 + 1 = 0.6
@@ -914,13 +933,13 @@ describe('useGlProgram', () => {
     const runtime = getGlRenderStateRuntime(state);
     runtime.currentProgram = null;
     useGlProgram(state);
-    expect(gl.useProgram).toHaveBeenCalledWith(runtime.shaderLoc.program);
+    expect(gl.useProgram).toHaveBeenCalledWith(runtime.shaderLoc!.program);
   });
 
   it('does not call useProgram when program is already active', () => {
     const { state, gl } = createGlState();
     const runtime = getGlRenderStateRuntime(state);
-    runtime.currentProgram = runtime.shaderLoc.program;
+    runtime.currentProgram = runtime.shaderLoc!.program;
     useGlProgram(state);
     expect(gl.useProgram).not.toHaveBeenCalled();
   });
@@ -930,7 +949,7 @@ describe('useGlProgram', () => {
     const runtime = getGlRenderStateRuntime(state);
     runtime.currentProgram = null;
     useGlProgram(state);
-    expect(runtime.currentProgram).toBe(runtime.shaderLoc.program);
+    expect(runtime.currentProgram).toBe(runtime.shaderLoc!.program);
   });
 
   it('uses the registered bitmap shader program and locations', () => {
@@ -938,7 +957,7 @@ describe('useGlProgram', () => {
     const runtime = getGlRenderStateRuntime(state);
     const shader = {
       bind: vi.fn(),
-      locations: { ...runtime.shaderLoc, program: {} as WebGLProgram },
+      locations: { ...runtime.shaderLoc!, program: {} as WebGLProgram },
       program: {} as WebGLProgram,
     };
     shader.locations.program = shader.program;

package/src/glMaterialRegistry.test.ts

@@ -3,6 +3,7 @@ import type { GlMaterialRenderer, Material } from '@flighthq/types/contract';
 import { RenderRegistry, StandardMaterialKind } from '@flighthq/types/contract';
 
 import { getGlMaterialRenderer, registerGlMaterialRenderer, resolveGlMaterialRenderer } from './glMaterialRegistry';
+import { getGlRenderStateRuntime } from './glRenderState';
 import { createGlState } from './glTestHelper';
 
 const TestKind = 'TestMaterial';
@@ -22,8 +23,23 @@ describe('getGlMaterialRenderer', () => {
 describe('registerGlMaterialRenderer', () => {
   it('registers a renderer retrievable by kind', () => {
     const { state } = createGlState();
+    const before = getGlRenderStateRuntime(state).registries.materialRenderers;
     registerGlMaterialRenderer(state, TestKind, testRenderer);
     expect(getGlMaterialRenderer(state, TestKind)).toBe(testRenderer);
+    expect(getGlRenderStateRuntime(state).registries.materialRenderers).not.toBe(before);
+    expect(before.entries.size).toBe(0);
+  });
+
+  it('is last-write-wins without mutating the earlier snapshot', () => {
+    const { state } = createGlState();
+    const replacement: GlMaterialRenderer = { instanceFloatCount: 0, bind() {} };
+    registerGlMaterialRenderer(state, TestKind, testRenderer);
+    const before = getGlRenderStateRuntime(state).registries.materialRenderers;
+
+    registerGlMaterialRenderer(state, TestKind, replacement);
+
+    expect(getGlMaterialRenderer(state, TestKind)).toBe(replacement);
+    expect(before.entries.get(TestKind)).toEqual({ state: 'bound', value: testRenderer });
   });
 });