@flighthq/render-gl 0.5.1-next.1069.554a2ac → 0.5.1-next.1201.9b49dee

package/src/glRenderTargetPool.test.ts

@@ -1,17 +1,17 @@
 import {
-  acquireGlRenderTarget,
-  createGlRenderTargetPool,
-  destroyGlRenderTargetPool,
-  initializeGlRenderTargetPool,
-  releaseGlRenderTarget,
+  acquireGlTextureRenderTarget,
+  createGlTextureRenderTargetPool,
+  destroyGlTextureRenderTargetPool,
+  initializeGlTextureRenderTargetPool,
+  releaseGlTextureRenderTarget,
 } from './glRenderTargetPool';
 import { createGlState } from './glTestHelper';
 
-describe('acquireGlRenderTarget', () => {
+describe('acquireGlTextureRenderTarget', () => {
   it('allocates a new target when the pool is empty', () => {
     const { state } = createGlState();
-    const pool = createGlRenderTargetPool();
-    const target = acquireGlRenderTarget(state, pool, { width: 64, height: 48 });
+    const pool = createGlTextureRenderTargetPool();
+    const target = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48 });
     expect(target.width).toBe(64);
     expect(target.height).toBe(48);
     expect(pool.free.length).toBe(0);
@@ -19,39 +19,39 @@ describe('acquireGlRenderTarget', () => {
 
   it('reuses a matching released target instead of allocating', () => {
     const { state } = createGlState();
-    const pool = createGlRenderTargetPool();
-    const first = acquireGlRenderTarget(state, pool, { width: 64, height: 48 });
-    releaseGlRenderTarget(pool, first);
+    const pool = createGlTextureRenderTargetPool();
+    const first = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48 });
+    releaseGlTextureRenderTarget(pool, first);
 
-    const reused = acquireGlRenderTarget(state, pool, { width: 64, height: 48 });
+    const reused = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48 });
     expect(reused).toBe(first);
     expect(pool.free.length).toBe(0);
   });
 
   it('does not reuse a target with a different color space', () => {
     const { state } = createGlState();
-    const pool = createGlRenderTargetPool();
-    const first = acquireGlRenderTarget(state, pool, { width: 64, height: 48, colorSpace: 'linear' });
+    const pool = createGlTextureRenderTargetPool();
+    const first = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48, colorSpace: 'linear' });
     expect(first.colorSpace).toBe('linear');
-    releaseGlRenderTarget(pool, first);
+    releaseGlTextureRenderTarget(pool, first);
 
-    const other = acquireGlRenderTarget(state, pool, { width: 64, height: 48, colorSpace: 'srgb' });
+    const other = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48, colorSpace: 'srgb' });
     expect(other).not.toBe(first);
     expect(pool.free).toContain(first);
   });
 
   it('does not reuse a target with different heterogeneous color formats', () => {
     const { state } = createGlState();
-    const pool = createGlRenderTargetPool();
-    const first = acquireGlRenderTarget(state, pool, {
+    const pool = createGlTextureRenderTargetPool();
+    const first = acquireGlTextureRenderTarget(state, pool, {
       width: 64,
       height: 48,
       colorAttachments: 2,
       colorFormats: ['rgba8', 'rgba8'],
     });
-    releaseGlRenderTarget(pool, first);
+    releaseGlTextureRenderTarget(pool, first);
 
-    const other = acquireGlRenderTarget(state, pool, {
+    const other = acquireGlTextureRenderTarget(state, pool, {
       width: 64,
       height: 48,
       colorAttachments: 2,
@@ -64,11 +64,11 @@ describe('acquireGlRenderTarget', () => {
   it('reuses the effective rgba8 target when a preferred float format is unsupported', () => {
     const { state, gl } = createGlState();
     vi.spyOn(gl, 'getExtension').mockReturnValue(null);
-    const pool = createGlRenderTargetPool();
-    const first = acquireGlRenderTarget(state, pool, { width: 64, height: 48, format: 'rgba8' });
-    releaseGlRenderTarget(pool, first);
+    const pool = createGlTextureRenderTargetPool();
+    const first = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48, format: 'rgba8' });
+    releaseGlTextureRenderTarget(pool, first);
 
-    const reused = acquireGlRenderTarget(state, pool, { width: 64, height: 48, format: 'rgba32f' }, 'preferred');
+    const reused = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48, format: 'rgba32f' }, 'preferred');
     expect(reused).toBe(first);
     expect(reused.format).toBe('rgba8');
     expect(reused.requestedAxes.format).toBe('rgba32f');
@@ -78,15 +78,15 @@ describe('acquireGlRenderTarget', () => {
   it('refuses an unsupported required float format without consuming a fallback target', () => {
     const { state, gl } = createGlState();
     vi.spyOn(gl, 'getExtension').mockReturnValue(null);
-    const pool = createGlRenderTargetPool();
-    const fallback = acquireGlRenderTarget(state, pool, { width: 64, height: 48, format: 'rgba8' });
-    releaseGlRenderTarget(pool, fallback);
+    const pool = createGlTextureRenderTargetPool();
+    const fallback = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48, format: 'rgba8' });
+    releaseGlTextureRenderTarget(pool, fallback);
     const createFramebufferSpy = vi.spyOn(gl, 'createFramebuffer');
     const clearSpy = vi.spyOn(gl, 'clear');
     createFramebufferSpy.mockClear();
     clearSpy.mockClear();
 
-    const refused = acquireGlRenderTarget(state, pool, { width: 64, height: 48, format: 'rgba32f' }, 'required');
+    const refused = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48, format: 'rgba32f' }, 'required');
     expect(refused).toBeNull();
     expect(pool.free).toEqual([fallback]);
     expect(createFramebufferSpy).not.toHaveBeenCalled();
@@ -96,9 +96,9 @@ describe('acquireGlRenderTarget', () => {
   it('allocates a supported required float format', () => {
     const { state, gl } = createGlState();
     vi.spyOn(gl, 'getExtension').mockReturnValue({} as never);
-    const pool = createGlRenderTargetPool();
+    const pool = createGlTextureRenderTargetPool();
 
-    const target = acquireGlRenderTarget(state, pool, { width: 64, height: 48, format: 'rgba16f' }, 'required');
+    const target = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48, format: 'rgba16f' }, 'required');
     expect(target).not.toBeNull();
     expect(target?.format).toBe('rgba16f');
     expect(target?.requestedAxes.format).toBe('rgba16f');
@@ -106,35 +106,29 @@ describe('acquireGlRenderTarget', () => {
 
   it('does not reuse a target with a different depth mode', () => {
     const { state } = createGlState();
-    const pool = createGlRenderTargetPool();
-    const first = acquireGlRenderTarget(state, pool, { width: 64, height: 48, depth: 'none' });
-    releaseGlRenderTarget(pool, first);
+    const pool = createGlTextureRenderTargetPool();
+    const first = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48, depth: 'none' });
+    releaseGlTextureRenderTarget(pool, first);
 
-    const other = acquireGlRenderTarget(state, pool, { width: 64, height: 48, depth: 'depth-stencil' });
+    const other = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48, depth: 'depth-stencil' });
     expect(other).not.toBe(first);
     expect(pool.free).toContain(first);
   });
 
-  it('re-stamps clear policy and requested axes on a compatible target', () => {
+  it('re-stamps requested axes on a compatible target', () => {
     const { state } = createGlState();
-    const pool = createGlRenderTargetPool();
-    const first = acquireGlRenderTarget(state, pool, {
+    const pool = createGlTextureRenderTargetPool();
+    const first = acquireGlTextureRenderTarget(state, pool, {
       width: 64,
       height: 48,
-      clearColors: [0xff0000ff],
-      clearDepth: 0.25,
     });
-    releaseGlRenderTarget(pool, first);
+    releaseGlTextureRenderTarget(pool, first);
 
-    const reused = acquireGlRenderTarget(state, pool, {
+    const reused = acquireGlTextureRenderTarget(state, pool, {
       width: 64,
       height: 48,
-      clearColors: [0x00ff00ff],
-      clearDepth: 0.75,
     });
     expect(reused).toBe(first);
-    expect(reused.clearColors).toEqual([0x00ff00ff]);
-    expect(reused.clearDepth).toBe(0.75);
     expect(reused.requestedAxes).toEqual({
       width: 64,
       height: 48,
@@ -149,11 +143,11 @@ describe('acquireGlRenderTarget', () => {
 
   it('allocates a new target when the free target has different dimensions', () => {
     const { state } = createGlState();
-    const pool = createGlRenderTargetPool();
-    const first = acquireGlRenderTarget(state, pool, { width: 64, height: 48 });
-    releaseGlRenderTarget(pool, first);
+    const pool = createGlTextureRenderTargetPool();
+    const first = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48 });
+    releaseGlTextureRenderTarget(pool, first);
 
-    const other = acquireGlRenderTarget(state, pool, { width: 128, height: 48 });
+    const other = acquireGlTextureRenderTarget(state, pool, { width: 128, height: 48 });
     expect(other).not.toBe(first);
     // The mismatched target stays parked in the free list.
     expect(pool.free).toContain(first);
@@ -161,47 +155,46 @@ describe('acquireGlRenderTarget', () => {
 
   it('matches the ceiled, clamped descriptor dimensions', () => {
     const { state } = createGlState();
-    const pool = createGlRenderTargetPool();
-    const first = acquireGlRenderTarget(state, pool, { width: 10.2, height: 0 });
-    releaseGlRenderTarget(pool, first);
+    const pool = createGlTextureRenderTargetPool();
+    const first = acquireGlTextureRenderTarget(state, pool, { width: 10.2, height: 0 });
+    releaseGlTextureRenderTarget(pool, first);
 
     // 10.2 -> 11, 0 -> 1; an equivalent descriptor must hit the same parked target.
-    const reused = acquireGlRenderTarget(state, pool, { width: 10.9, height: 0.4 });
+    const reused = acquireGlTextureRenderTarget(state, pool, { width: 10.9, height: 0.4 });
     expect(reused).toBe(first);
   });
 
   it('clears a reused target so it is handed back clean', () => {
     const { state, gl } = createGlState();
-    const pool = createGlRenderTargetPool();
-    const first = acquireGlRenderTarget(state, pool, { width: 64, height: 48 });
-    releaseGlRenderTarget(pool, first);
+    const pool = createGlTextureRenderTargetPool();
+    const first = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48 });
+    releaseGlTextureRenderTarget(pool, first);
 
-    // Only the reuse path clears — spy after the first (fresh) acquire so we measure just the reuse.
-    const clearSpy = vi.spyOn(gl, 'clear');
-    const reused = acquireGlRenderTarget(state, pool, { width: 64, height: 48 });
+    const clearSpy = vi.spyOn(gl, 'clearBufferfv');
+    const reused = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 48 });
     expect(reused).toBe(first);
     expect(clearSpy).toHaveBeenCalled();
   });
 });
 
-describe('createGlRenderTargetPool', () => {
+describe('createGlTextureRenderTargetPool', () => {
   it('returns a pool with an empty free list', () => {
-    const pool = createGlRenderTargetPool();
+    const pool = createGlTextureRenderTargetPool();
     expect(pool.free).toEqual([]);
   });
 });
 
-describe('destroyGlRenderTargetPool', () => {
+describe('destroyGlTextureRenderTargetPool', () => {
   it('destroys every parked target and empties the free list', () => {
     const { state, gl } = createGlState();
-    const pool = createGlRenderTargetPool();
-    const a = acquireGlRenderTarget(state, pool, { width: 32, height: 32 });
-    const b = acquireGlRenderTarget(state, pool, { width: 16, height: 16 });
-    releaseGlRenderTarget(pool, a);
-    releaseGlRenderTarget(pool, b);
+    const pool = createGlTextureRenderTargetPool();
+    const a = acquireGlTextureRenderTarget(state, pool, { width: 32, height: 32 });
+    const b = acquireGlTextureRenderTarget(state, pool, { width: 16, height: 16 });
+    releaseGlTextureRenderTarget(pool, a);
+    releaseGlTextureRenderTarget(pool, b);
 
     const deleteSpy = vi.spyOn(gl, 'deleteFramebuffer');
-    destroyGlRenderTargetPool(state, pool);
+    destroyGlTextureRenderTargetPool(pool);
 
     expect(deleteSpy).toHaveBeenCalledWith(a.framebuffer);
     expect(deleteSpy).toHaveBeenCalledWith(b.framebuffer);
@@ -210,24 +203,24 @@ describe('destroyGlRenderTargetPool', () => {
 
   it('is a no-op on an empty pool', () => {
     const { state } = createGlState();
-    const pool = createGlRenderTargetPool();
-    expect(() => destroyGlRenderTargetPool(state, pool)).not.toThrow();
+    const pool = createGlTextureRenderTargetPool();
+    expect(() => destroyGlTextureRenderTargetPool(pool)).not.toThrow();
   });
 });
 
-describe('initializeGlRenderTargetPool', () => {
+describe('initializeGlTextureRenderTargetPool', () => {
   it('is the construction initializer of createGlRenderTargetPool', () => {
-    expect(typeof initializeGlRenderTargetPool).toBe('function');
+    expect(typeof initializeGlTextureRenderTargetPool).toBe('function');
   });
 });
-describe('releaseGlRenderTarget', () => {
+describe('releaseGlTextureRenderTarget', () => {
   it('returns the target to the free list without destroying it', () => {
     const { state, gl } = createGlState();
-    const pool = createGlRenderTargetPool();
-    const target = acquireGlRenderTarget(state, pool, { width: 64, height: 64 });
+    const pool = createGlTextureRenderTargetPool();
+    const target = acquireGlTextureRenderTarget(state, pool, { width: 64, height: 64 });
 
     const deleteSpy = vi.spyOn(gl, 'deleteFramebuffer');
-    releaseGlRenderTarget(pool, target);
+    releaseGlTextureRenderTarget(pool, target);
 
     expect(pool.free).toContain(target);
     expect(deleteSpy).not.toHaveBeenCalled();

package/src/glRenderTexture.test.ts

@@ -1,5 +1,5 @@
 import { addLogSink, createMemoryLogSink, getMemoryLogSinkEntries, removeLogSink } from '@flighthq/log/contract';
-import type { RenderTexture } from '@flighthq/types/contract';
+import type { RenderTargetClear, RenderTexture } from '@flighthq/types/contract';
 import { RenderTargetTextureSourceKind } from '@flighthq/types/contract';
 
 import { enableGlRenderTextureGuards } from './enableGlRenderTextureGuards';
@@ -23,7 +23,7 @@ describe('bindGlRenderTexture', () => {
   it('binds the existing target texture without uploading pixels', () => {
     const { state, gl } = createRenderTextureState();
     const renderTexture = createRenderTexture({ height: 8, width: 8 });
-    renderIntoGlRenderTexture(state, renderTexture, () => {});
+    renderIntoGlRenderTexture(state, renderTexture, () => {}, TRANSPARENT_CLEAR);
     const uploads = vi.mocked(gl.texImage2D).mock.calls.length;
 
     const texture = bindGlRenderTexture(state, renderTexture);
@@ -47,7 +47,7 @@ describe('clearGlRenderTexture', () => {
 
     clearGlRenderTexture(state, renderTexture);
 
-    expect(gl.clear).toHaveBeenCalledWith(gl.COLOR_BUFFER_BIT);
+    expect(gl.clearBufferfv).toHaveBeenCalledWith(gl.COLOR, 0, expect.anything());
     expect(isGlRenderTextureReady(state, renderTexture)).toBe(true);
     expect(renderTexture.version).toBe(1);
   });
@@ -57,7 +57,7 @@ describe('destroyGlRenderTexture', () => {
   it('deletes the hidden target and returns the source to unrendered state', () => {
     const { state, gl } = createRenderTextureState();
     const renderTexture = createRenderTexture({ height: 8, width: 8 });
-    renderIntoGlRenderTexture(state, renderTexture, () => {});
+    renderIntoGlRenderTexture(state, renderTexture, () => {}, TRANSPARENT_CLEAR);
 
     destroyGlRenderTexture(state, renderTexture);
 
@@ -76,9 +76,14 @@ describe('enableGlRenderTextureGuards', () => {
     enableGlRenderTextureGuards(state);
     try {
       bindGlRenderTexture(state, unrendered);
-      renderIntoGlRenderTexture(state, writing, () => {
-        bindGlRenderTexture(state, writing);
-      });
+      renderIntoGlRenderTexture(
+        state,
+        writing,
+        () => {
+          bindGlRenderTexture(state, writing);
+        },
+        TRANSPARENT_CLEAR,
+      );
 
       const entries = getMemoryLogSinkEntries(sink);
       expect(entries).toHaveLength(2);
@@ -108,7 +113,7 @@ describe('getGlRenderTextureColorSpace', () => {
     const renderTexture = createRenderTexture({ height: 8, width: 8 });
 
     expect(getGlRenderTextureColorSpace(state, renderTexture)).toBe('linear');
-    renderIntoGlRenderTexture(state, renderTexture, () => {});
+    renderIntoGlRenderTexture(state, renderTexture, () => {}, TRANSPARENT_CLEAR);
     expect(getGlRenderTextureColorSpace(state, renderTexture)).toBe('linear');
   });
 });
@@ -145,7 +150,7 @@ describe('isGlRenderTextureReady', () => {
     const renderTexture = createRenderTexture({ height: 8, width: 8 });
 
     expect(isGlRenderTextureReady(state, renderTexture)).toBe(false);
-    renderIntoGlRenderTexture(state, renderTexture, () => {});
+    renderIntoGlRenderTexture(state, renderTexture, () => {}, TRANSPARENT_CLEAR);
     expect(isGlRenderTextureReady(state, renderTexture)).toBe(true);
   });
 });
@@ -154,8 +159,8 @@ describe('renderIntoGlRenderTexture', () => {
   it('lazily creates a target and marks it ready after the callback completes', () => {
     const { state } = createRenderTextureState();
     const renderTexture = createRenderTexture({ depth: true, height: 24, width: 32 });
-    const callback = vi.fn((callbackState) => {
-      expect(callbackState).toBe(state);
+    const callback = vi.fn((pass) => {
+      expect(pass.state).toBe(state);
       expect(explainGlRenderTexture(state, renderTexture).status).toBe('writing');
     });
 
@@ -166,7 +171,7 @@ describe('renderIntoGlRenderTexture', () => {
     });
     expect(renderTexture.version).toBe(0);
 
-    renderIntoGlRenderTexture(state, renderTexture, callback);
+    renderIntoGlRenderTexture(state, renderTexture, callback, TRANSPARENT_CLEAR);
 
     expect(callback).toHaveBeenCalledOnce();
     expect(renderTexture.version).toBe(1);
@@ -183,9 +188,14 @@ describe('renderIntoGlRenderTexture', () => {
     const renderTexture = createRenderTexture({ height: 8, width: 8 });
 
     expect(() =>
-      renderIntoGlRenderTexture(state, renderTexture, () => {
-        throw new Error('producer failed');
-      }),
+      renderIntoGlRenderTexture(
+        state,
+        renderTexture,
+        () => {
+          throw new Error('producer failed');
+        },
+        TRANSPARENT_CLEAR,
+      ),
     ).toThrow('producer failed');
 
     expect(explainGlRenderTexture(state, renderTexture).status).toBe('unrendered');
@@ -195,12 +205,17 @@ describe('renderIntoGlRenderTexture', () => {
   it('invalidates a previously-ready target when a replacement render throws', () => {
     const { state } = createRenderTextureState();
     const renderTexture = createRenderTexture({ height: 8, width: 8 });
-    renderIntoGlRenderTexture(state, renderTexture, () => {});
+    renderIntoGlRenderTexture(state, renderTexture, () => {}, TRANSPARENT_CLEAR);
 
     expect(() =>
-      renderIntoGlRenderTexture(state, renderTexture, () => {
-        throw new Error('replacement failed');
-      }),
+      renderIntoGlRenderTexture(
+        state,
+        renderTexture,
+        () => {
+          throw new Error('replacement failed');
+        },
+        TRANSPARENT_CLEAR,
+      ),
     ).toThrow('replacement failed');
 
     expect(explainGlRenderTexture(state, renderTexture).status).toBe('unrendered');
@@ -211,14 +226,19 @@ describe('renderIntoGlRenderTexture', () => {
     const { state } = createRenderTextureState();
     const renderTexture = createRenderTexture({ height: 8, width: 8 });
 
-    renderIntoGlRenderTexture(state, renderTexture, () => {
-      getGlRenderStateRuntime(state).currentMaskDepth = 1;
+    renderIntoGlRenderTexture(
+      state,
+      renderTexture,
+      () => {
+        getGlRenderStateRuntime(state).currentMaskDepth = 1;
 
-      expect(() => renderIntoGlRenderTexture(state, renderTexture, () => {})).toThrow(
-        'cannot nest the active framebuffer while a contour clip is live',
-      );
-      expect(explainGlRenderTexture(state, renderTexture).status).toBe('writing');
-    });
+        expect(() => renderIntoGlRenderTexture(state, renderTexture, () => {}, TRANSPARENT_CLEAR)).toThrow(
+          'cannot nest the active framebuffer while a contour clip is live',
+        );
+        expect(explainGlRenderTexture(state, renderTexture).status).toBe('writing');
+      },
+      TRANSPARENT_CLEAR,
+    );
 
     expect(explainGlRenderTexture(state, renderTexture).status).toBe('ready');
   });
@@ -226,11 +246,11 @@ describe('renderIntoGlRenderTexture', () => {
   it('resizes the retained target when the source dimensions change', () => {
     const { state } = createRenderTextureState();
     const renderTexture = createRenderTexture({ height: 16, width: 32 });
-    renderIntoGlRenderTexture(state, renderTexture, () => {});
+    renderIntoGlRenderTexture(state, renderTexture, () => {}, TRANSPARENT_CLEAR);
 
     renderTexture.source.width = 12;
     renderTexture.source.height = 10;
-    renderIntoGlRenderTexture(state, renderTexture, () => {});
+    renderIntoGlRenderTexture(state, renderTexture, () => {}, TRANSPARENT_CLEAR);
 
     expect(explainGlRenderTexture(state, renderTexture)).toEqual({
       height: 10,
@@ -244,9 +264,14 @@ describe('renderIntoGlRenderTexture', () => {
     const renderTexture = createRenderTexture({ height: 8, width: 8 });
     let whileWriting: WebGLTexture | null = {} as WebGLTexture;
 
-    renderIntoGlRenderTexture(state, renderTexture, () => {
-      whileWriting = bindGlRenderTexture(state, renderTexture);
-    });
+    renderIntoGlRenderTexture(
+      state,
+      renderTexture,
+      () => {
+        whileWriting = bindGlRenderTexture(state, renderTexture);
+      },
+      TRANSPARENT_CLEAR,
+    );
 
     expect(whileWriting).toBeNull();
     expect(bindGlRenderTexture(state, renderTexture)).not.toBeNull();
@@ -324,3 +349,5 @@ function createRenderTexture(options: { depth?: boolean; height: number; width:
     version: 0,
   } as unknown as RenderTexture;
 }
+
+const TRANSPARENT_CLEAR: Readonly<RenderTargetClear> = { color: [0, 0, 0, 0], depth: 1.0, stencil: 0 };

package/src/glSkinPaletteTexture.test.ts

@@ -159,6 +159,15 @@ describe('uploadGlSkinPaletteTexture', () => {
     expect(palette.jointCapacity).toBe(6);
   });
 
+  it('throws when MAX_TEXTURE_SIZE is not positive', () => {
+    const { gl } = makeGl(0);
+    const palette = createGlSkinPaletteTexture(gl);
+
+    expect(() => uploadGlSkinPaletteTexture(gl, palette, makePalette(1), 1)).toThrow(
+      'WebGL MAX_TEXTURE_SIZE must be greater than zero',
+    );
+  });
+
   it('wraps into multiple rows when totalTexels exceeds MAX_TEXTURE_SIZE', () => {
     const { gl, calls } = makeGl(16);
     const palette = createGlSkinPaletteTexture(gl);

package/src/glTextureResolver.test.ts

@@ -206,7 +206,11 @@ describe('registerGlRenderTextureResolver', () => {
       return previous?.(parameter);
     });
     const texture = textureWithTarget();
-    renderIntoGlRenderTexture(state, texture as RenderTexture, () => {});
+    renderIntoGlRenderTexture(state, texture as RenderTexture, () => {}, {
+      color: [0, 0, 0, 0],
+      depth: 1.0,
+      stencil: 0,
+    });
     registerGlRenderTextureResolver(state);
     const uploads = vi.mocked(gl.texImage2D).mock.calls.length;
 

package/dist/glBackground.d.ts

@@ -1,3 +0,0 @@
-import type { GlRenderState } from '@flighthq/types/contract';
-export declare function renderGlBackground(state: GlRenderState): void;
-//# sourceMappingURL=glBackground.d.ts.map

package/dist/glBackground.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"glBackground.d.ts","sourceRoot":"","sources":["../src/glBackground.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAI9D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAwB7D"}

package/dist/glBackground.js

@@ -1,19 +0,0 @@
-import { srgbChannelToLinear } from '@flighthq/color/contract';
-import { getGlRenderStateRuntime } from './glRenderState';
-export function renderGlBackground(state) {
-    const runtime = getGlRenderStateRuntime(state);
-    const gl = state.gl;
-    const viewport = runtime.renderTargetViewport;
-    gl.viewport(viewport?.x ?? 0, viewport?.y ?? 0, viewport?.width ?? gl.drawingBufferWidth, viewport?.height ?? gl.drawingBufferHeight);
-    const rgba = state.backgroundColorRgba;
-    if (rgba.length >= 4 && rgba[3] > 0) {
-        const linear = runtime.currentRenderTarget?.colorSpace === 'linear';
-        gl.clearColor(linear ? srgbChannelToLinear(rgba[0]) : rgba[0], linear ? srgbChannelToLinear(rgba[1]) : rgba[1], linear ? srgbChannelToLinear(rgba[2]) : rgba[2], rgba[3]);
-    }
-    else {
-        gl.clearColor(0, 0, 0, 0);
-    }
-    gl.clear(gl.COLOR_BUFFER_BIT);
-    runtime.context.currentBlendSignature = null;
-}
-//# sourceMappingURL=glBackground.js.map

package/dist/glBackground.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"glBackground.js","sourceRoot":"","sources":["../src/glBackground.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACrD,MAAM,OAAO,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;IACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAC9C,EAAE,CAAC,QAAQ,CACT,QAAQ,EAAE,CAAC,IAAI,CAAC,EAChB,QAAQ,EAAE,CAAC,IAAI,CAAC,EAChB,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,kBAAkB,EACxC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC,mBAAmB,CAC3C,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,mBAAmB,CAAC;IACvC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,UAAU,KAAK,QAAQ,CAAC;QACpE,EAAE,CAAC,UAAU,CACX,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAC/C,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAC/C,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAC/C,IAAI,CAAC,CAAC,CAAC,CACR,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC;IAC9B,OAAO,CAAC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;AAC/C,CAAC"}

package/dist/glContext.d.ts

@@ -1,3 +0,0 @@
-import type { GlContext, GlContextOptions } from '@flighthq/types/contract';
-export declare function createGlContextFromCanvasElement(canvas: HTMLCanvasElement, options?: Readonly<GlContextOptions>): GlContext;
-//# sourceMappingURL=glContext.d.ts.map

package/dist/glContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"glContext.d.ts","sourceRoot":"","sources":["../src/glContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5E,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,QAAQ,CAAC,gBAAgB,CAAM,GACvC,SAAS,CAWX"}

package/dist/glContext.js

@@ -1,16 +0,0 @@
-// Web-only acquisition constructor. Context-first/native callers do not import this module, keeping
-// HTMLCanvasElement.getContext out of their bundles.
-export function createGlContextFromCanvasElement(canvas, options = {}) {
-    const contextAttributes = {
-        alpha: true,
-        antialias: options.antialias ?? true,
-        powerPreference: options.powerPreference ?? 'default',
-        stencil: true,
-        ...options.contextAttributes,
-    };
-    const context = canvas.getContext('webgl2', contextAttributes);
-    if (context === null)
-        throw new Error('Failed to get WebGL2 context.');
-    return context;
-}
-//# sourceMappingURL=glContext.js.map

package/dist/glContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"glContext.js","sourceRoot":"","sources":["../src/glContext.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,qDAAqD;AACrD,MAAM,UAAU,gCAAgC,CAC9C,MAAyB,EACzB,UAAsC,EAAE;IAExC,MAAM,iBAAiB,GAA2B;QAChD,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,SAAS;QACrD,OAAO,EAAE,IAAI;QACb,GAAG,OAAO,CAAC,iBAAiB;KAC7B,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC/D,IAAI,OAAO,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACvE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/src/glBackground.test.ts

@@ -1,68 +0,0 @@
-import { srgbChannelToLinear } from '@flighthq/color/contract';
-
-import { renderGlBackground } from './glBackground';
-import { getGlRenderStateRuntime } from './glRenderState';
-import { createGlState } from './glTestHelper';
-
-describe('renderGlBackground', () => {
-  it('calls clearColor with zeros when background alpha is 0', () => {
-    const { state, gl } = createGlState({ backgroundColorRgba: [0, 0, 0, 0] });
-    renderGlBackground(state);
-    expect(gl.clearColor).toHaveBeenCalledWith(0, 0, 0, 0);
-  });
-
-  it('calls clearColor with the RGBA values when background is non-transparent', () => {
-    const { state, gl } = createGlState({ backgroundColorRgba: [1, 0, 0, 1] });
-    renderGlBackground(state);
-    expect(gl.clearColor).toHaveBeenCalledWith(1, 0, 0, 1);
-  });
-
-  it('calls clearColor with zeros when RGBA array has fewer than 4 elements', () => {
-    const { state, gl } = createGlState({ backgroundColorRgba: [] });
-    renderGlBackground(state);
-    expect(gl.clearColor).toHaveBeenCalledWith(0, 0, 0, 0);
-  });
-
-  it('always calls gl.clear with COLOR_BUFFER_BIT', () => {
-    const { state, gl } = createGlState();
-    renderGlBackground(state);
-    expect(gl.clear).toHaveBeenCalledWith((gl as unknown as { COLOR_BUFFER_BIT: number }).COLOR_BUFFER_BIT);
-  });
-
-  it('preserves an active partial-target viewport origin', () => {
-    const { state, gl } = createGlState();
-    getGlRenderStateRuntime(state).renderTargetViewport = { height: 40, width: 30, x: 10, y: 20 };
-
-    renderGlBackground(state);
-
-    expect(gl.viewport).toHaveBeenLastCalledWith(10, 20, 30, 40);
-  });
-
-  it('invalidates currentBlendSignature', () => {
-    const { state } = createGlState();
-    const runtime = getGlRenderStateRuntime(state);
-    runtime.context.currentBlendSignature = { dst: 0, equation: 0, src: 0 };
-    renderGlBackground(state);
-    expect(runtime.context.currentBlendSignature).toBeNull();
-  });
-
-  it('passes fractional RGBA values through unchanged', () => {
-    const { state, gl } = createGlState({ backgroundColorRgba: [0.5, 0.25, 0.75, 0.8] });
-    renderGlBackground(state);
-    expect(gl.clearColor).toHaveBeenCalledWith(0.5, 0.25, 0.75, 0.8);
-  });
-
-  it('decodes an sRGB background when the active target stores linear scene color', () => {
-    const { state, gl } = createGlState({ backgroundColorRgba: [0.5, 0.25, 0.75, 0.8] });
-    getGlRenderStateRuntime(state).currentRenderTarget = { colorSpace: 'linear' } as never;
-
-    renderGlBackground(state);
-
-    expect(gl.clearColor).toHaveBeenCalledWith(
-      srgbChannelToLinear(0.5),
-      srgbChannelToLinear(0.25),
-      srgbChannelToLinear(0.75),
-      0.8,
-    );
-  });
-});