@flighthq/render-wgpu 0.5.1-next.3302.76ece6b → 0.5.1-next.4304.322dc96

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/render-wgpu`. The `@
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/render-wgpu@0.5.1-next.3302.76ece6b](https://github.com/flighthq/flight/tree/76ece6bee38e3d07816f341b7f017bfcec3e8e29/packages/render-wgpu)
-- [License](https://github.com/flighthq/flight/blob/76ece6bee38e3d07816f341b7f017bfcec3e8e29/LICENSE.md)
+- [Source for @flighthq/render-wgpu@0.5.1-next.4304.322dc96](https://github.com/flighthq/flight/tree/322dc963fc5a404a31bc0cc612e906de504ea024/packages/render-wgpu)
+- [License](https://github.com/flighthq/flight/blob/322dc963fc5a404a31bc0cc612e906de504ea024/LICENSE.md)

package/dist/enableWgpuTextureResolverGuards.d.ts

@@ -1,4 +1,5 @@
+import type { LogState } from '@flighthq/log/contract';
 import type { WgpuRenderState } from '@flighthq/types/contract';
 export declare function areWgpuTextureResolverGuardsEnabled(state: WgpuRenderState): boolean;
-export declare function enableWgpuTextureResolverGuards(state: WgpuRenderState): void;
+export declare function enableWgpuTextureResolverGuards(state: WgpuRenderState, logState: LogState | null): void;
 //# sourceMappingURL=enableWgpuTextureResolverGuards.d.ts.map

package/dist/enableWgpuTextureResolverGuards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enableWgpuTextureResolverGuards.d.ts","sourceRoot":"","sources":["../src/enableWgpuTextureResolverGuards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAKhE,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEnF;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAI5E"}
+{"version":3,"file":"enableWgpuTextureResolverGuards.d.ts","sourceRoot":"","sources":["../src/enableWgpuTextureResolverGuards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAKhE,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEnF;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAIvG"}

package/dist/enableWgpuTextureResolverGuards.js

@@ -5,13 +5,16 @@ import { getWgpuRenderStateRuntime } from "./wgpuRenderState.js";
 export function areWgpuTextureResolverGuardsEnabled(state) {
     return areRenderRegistriesGuardsEnabled(state);
 }
-export function enableWgpuTextureResolverGuards(state) {
-    enableRenderRegistriesGuards(state);
+export function enableWgpuTextureResolverGuards(state, logState) {
+    enableRenderRegistriesGuards(state, logState);
     const runtime = getWgpuRenderStateRuntime(state);
-    runtime.mipmapDegradedGuard = warnOnMipmapDegradation;
+    runtime.mipmapDegradedGuard = (degradedState) => warnOnMipmapDegradation(logState, degradedState);
 }
-function warnOnMipmapDegradation(state) {
-    logOnce('render-wgpu:mipmap-degraded', LogLevel.Warn, {
+function warnOnMipmapDegradation(logState, state) {
+    if (logState === null)
+        return;
+    // The render guards take no clock, so the warning is stamped at time zero.
+    logOnce(logState, 0, 'render-wgpu:mipmap-degraded', LogLevel.Warn, {
         message: 'bindWgpuBitmapTexture: mipmaps requested but no WGPU mipmap generator registered — texture allocated with a single mip level (bilinear fallback). Call registerWgpuMipmapGeneration(state) to enable trilinear/anisotropic sampling.',
         state,
     }, 'render-wgpu');

package/dist/enableWgpuTextureResolverGuards.js.map

@@ -1 +1 @@
-{"version":3,"file":"enableWgpuTextureResolverGuards.js","sourceRoot":"","sources":["../src/enableWgpuTextureResolverGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gCAAgC,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAE3G,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,UAAU,mCAAmC,CAAC,KAAsB;IACxE,OAAO,gCAAgC,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAAsB;IACpE,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,CAAC,mBAAmB,GAAG,uBAAuB,CAAC;AACxD,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAsB;IACrD,OAAO,CACL,6BAA6B,EAC7B,QAAQ,CAAC,IAAI,EACb;QACE,OAAO,EACL,sOAAsO;QACxO,KAAK;KACN,EACD,aAAa,CACd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"enableWgpuTextureResolverGuards.js","sourceRoot":"","sources":["../src/enableWgpuTextureResolverGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,gCAAgC,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAE3G,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,UAAU,mCAAmC,CAAC,KAAsB;IACxE,OAAO,gCAAgC,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAAsB,EAAE,QAAyB;IAC/F,4BAA4B,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,CAAC,mBAAmB,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,uBAAuB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACpG,CAAC;AAED,SAAS,uBAAuB,CAAC,QAAyB,EAAE,KAAsB;IAChF,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO;IAC9B,2EAA2E;IAC3E,OAAO,CACL,QAAQ,EACR,CAAC,EACD,6BAA6B,EAC7B,QAAQ,CAAC,IAAI,EACb;QACE,OAAO,EACL,sOAAsO;QACxO,KAAK;KACN,EACD,aAAa,CACd,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/render-wgpu",
-  "version": "0.5.1-next.3302.76ece6b",
+  "version": "0.5.1-next.4304.322dc96",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,16 +38,16 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/color": "0.5.1-next.3302.76ece6b",
-    "@flighthq/entity": "0.5.1-next.3302.76ece6b",
-    "@flighthq/geometry": "0.5.1-next.3302.76ece6b",
-    "@flighthq/log": "0.5.1-next.3302.76ece6b",
-    "@flighthq/render": "0.5.1-next.3302.76ece6b",
-    "@flighthq/registry": "0.5.1-next.3302.76ece6b",
-    "@flighthq/signals": "0.5.1-next.3302.76ece6b",
-    "@flighthq/bitmap": "0.5.1-next.3302.76ece6b",
-    "@flighthq/texture": "0.5.1-next.3302.76ece6b",
-    "@flighthq/types": "0.5.1-next.3302.76ece6b"
+    "@flighthq/color": "0.5.1-next.4304.322dc96",
+    "@flighthq/entity": "0.5.1-next.4304.322dc96",
+    "@flighthq/geometry": "0.5.1-next.4304.322dc96",
+    "@flighthq/log": "0.5.1-next.4304.322dc96",
+    "@flighthq/render": "0.5.1-next.4304.322dc96",
+    "@flighthq/registry": "0.5.1-next.4304.322dc96",
+    "@flighthq/signals": "0.5.1-next.4304.322dc96",
+    "@flighthq/bitmap": "0.5.1-next.4304.322dc96",
+    "@flighthq/texture": "0.5.1-next.4304.322dc96",
+    "@flighthq/types": "0.5.1-next.4304.322dc96"
   },
   "peerDependencies": {
     "@webgpu/types": "^0.1.70"

package/src/enableWgpuTextureResolverGuards.test.ts

@@ -1,6 +1,13 @@
-import { addLogSink, createMemoryLogSink, getMemoryLogSinkEntries, removeLogSink } from '@flighthq/log/contract';
+import {
+  addLogSink,
+  createLogState,
+  createMemoryLogSink,
+  getMemoryLogSinkEntries,
+  removeLogSink,
+} from '@flighthq/log/contract';
+import type { LogState } from '@flighthq/log/contract';
 import { createTexture } from '@flighthq/texture/contract';
-import type { ImageResource } from '@flighthq/types/contract';
+import type { ImageResource, LogEntry, MemoryLogSink } from '@flighthq/types/contract';
 
 import {
   areWgpuTextureResolverGuardsEnabled,
@@ -11,6 +18,13 @@ import { getWgpuRenderStateRuntime } from './wgpuRenderState.ts';
 import { createWgpuRenderStateForTest, installWgpuMock } from './wgpuTestHelper.ts';
 import { registerWgpuTextureResolver, resolveWgpuTexture } from './wgpuTextureResolver.ts';
 
+// Each test logs into a fresh caller-owned state, so logOnce keys never leak between tests.
+let logState: LogState;
+
+beforeEach(() => {
+  logState = createLogState();
+});
+
 beforeAll(() => {
   installWgpuMock();
 });
@@ -20,7 +34,7 @@ describe('areWgpuTextureResolverGuardsEnabled', () => {
     const state = await createWgpuRenderStateForTest();
     expect(areWgpuTextureResolverGuardsEnabled(state)).toBe(false);
 
-    enableWgpuTextureResolverGuards(state);
+    enableWgpuTextureResolverGuards(state, logState);
     expect(areWgpuTextureResolverGuardsEnabled(state)).toBe(true);
   });
 });
@@ -28,8 +42,8 @@ describe('areWgpuTextureResolverGuardsEnabled', () => {
 describe('enableWgpuTextureResolverGuards', () => {
   it('is idempotent', async () => {
     const state = await createWgpuRenderStateForTest();
-    enableWgpuTextureResolverGuards(state);
-    enableWgpuTextureResolverGuards(state);
+    enableWgpuTextureResolverGuards(state, logState);
+    enableWgpuTextureResolverGuards(state, logState);
     expect(areWgpuTextureResolverGuardsEnabled(state)).toBe(true);
   });
 
@@ -38,15 +52,15 @@ describe('enableWgpuTextureResolverGuards', () => {
     const missing = textureWithKind('acme.missing.wgpu');
     const registered = textureWithKind('acme.registered.wgpu');
     const sink = createMemoryLogSink(4);
-    addLogSink(sink.sink);
-    enableWgpuTextureResolverGuards(state);
+    addLogSink(logState, sink.sink);
+    enableWgpuTextureResolverGuards(state, logState);
     registerWgpuTextureResolver(state, 'acme.registered.wgpu', () => null);
     try {
       expect(resolveWgpuTexture(state, missing)).toBeNull();
       expect(resolveWgpuTexture(state, missing)).toBeNull();
       expect(resolveWgpuTexture(state, registered)).toBeNull();
 
-      const entries = getMemoryLogSinkEntries(sink);
+      const entries = readMemoryLogEntries(sink);
       expect(entries).toHaveLength(1);
       expect(entries[0]?.data).toMatchObject({
         kind: 'acme.missing.wgpu',
@@ -54,35 +68,35 @@ describe('enableWgpuTextureResolverGuards', () => {
           'resolveWgpuTexture: texture source kind has no registered resolver — call registerWgpuTextureResolver(state, sourceKind, resolver)',
       });
     } finally {
-      removeLogSink(sink.sink);
+      removeLogSink(logState, sink.sink);
     }
   });
 
   it('installs the mipmap-degraded guard on the runtime', async () => {
     const state = await createWgpuRenderStateForTest();
     expect(getWgpuRenderStateRuntime(state).mipmapDegradedGuard).toBeNull();
-    enableWgpuTextureResolverGuards(state);
+    enableWgpuTextureResolverGuards(state, logState);
     expect(getWgpuRenderStateRuntime(state).mipmapDegradedGuard).not.toBeNull();
   });
 
   it('logs a warning when mipmaps are requested without a registered generator', async () => {
     const state = await createWgpuRenderStateForTest();
     const sink = createMemoryLogSink(4);
-    addLogSink(sink.sink);
-    enableWgpuTextureResolverGuards(state);
+    addLogSink(logState, sink.sink);
+    enableWgpuTextureResolverGuards(state, logState);
     try {
       const canvas = document.createElement('canvas');
       canvas.width = 8;
       canvas.height = 8;
       bindWgpuTexture(state, canvas, true);
 
-      const entries = getMemoryLogSinkEntries(sink);
+      const entries = readMemoryLogEntries(sink);
       expect(entries).toHaveLength(1);
       expect(entries[0]?.data).toMatchObject({
         message: expect.stringContaining('no WGPU mipmap generator registered'),
       });
     } finally {
-      removeLogSink(sink.sink);
+      removeLogSink(logState, sink.sink);
     }
   });
 });
@@ -93,3 +107,9 @@ function textureWithKind(kind: string) {
     source: { kind } as ImageResource,
   });
 }
+
+function readMemoryLogEntries(handle: Readonly<MemoryLogSink>): LogEntry[] {
+  const entries: LogEntry[] = [];
+  getMemoryLogSinkEntries(entries, handle);
+  return entries;
+}

package/src/wgpuDeviceLoss.test.ts

@@ -219,7 +219,7 @@ describe('observeWgpuDeviceLoss', () => {
     const deviceRuntime = {
       device,
       lost: null,
-      signals: { onDeviceLost: createSignal<(info: GPUDeviceLostInfo) => void>() },
+      signals: { onDeviceLost: createSignal<GPUDeviceLostInfo>() },
     } as unknown as WgpuDeviceRuntime;
     let emissions = 0;
     connectSignal(deviceRuntime.signals!.onDeviceLost, () => {

package/src/wgpuQuadMaterialRegistry.test.ts

@@ -1,6 +1,19 @@
-import { addLogSink, createMemoryLogSink, getMemoryLogSinkEntries, removeLogSink } from '@flighthq/log/contract';
+import {
+  addLogSink,
+  createLogState,
+  createMemoryLogSink,
+  getMemoryLogSinkEntries,
+  removeLogSink,
+} from '@flighthq/log/contract';
+import type { LogState } from '@flighthq/log/contract';
 import { enableRenderRegistriesGuards, explainRenderRegistriesMisses } from '@flighthq/render/contract';
-import type { Material, WgpuQuadMaterialRenderer, WgpuRenderState } from '@flighthq/types/contract';
+import type {
+  LogEntry,
+  Material,
+  MemoryLogSink,
+  WgpuQuadMaterialRenderer,
+  WgpuRenderState,
+} from '@flighthq/types/contract';
 import { StandardMaterialKind, EntityRuntimeKey, RenderRegistryTable } from '@flighthq/types/contract';
 
 import {
@@ -10,6 +23,13 @@ import {
 } from './wgpuQuadMaterialRegistry.ts';
 import { createWgpuDeviceState, createWgpuRenderStateRuntime, getWgpuRenderStateRuntime } from './wgpuRenderState.ts';
 
+// Each test logs into a fresh caller-owned state, so logOnce keys never leak between tests.
+let logState: LogState;
+
+beforeEach(() => {
+  logState = createLogState();
+});
+
 const TestKind = 'TestMaterial';
 const testRenderer: WgpuQuadMaterialRenderer = {
   instanceFloatCount: 0,
@@ -80,9 +100,9 @@ describe('resolveWgpuQuadMaterialRenderer', () => {
 
   it('reports the missing kind against the wgpu registrar, not the gl one', () => {
     const state = makeState();
-    enableRenderRegistriesGuards(state);
+    enableRenderRegistriesGuards(state, logState);
     const sink = createMemoryLogSink(4);
-    addLogSink(sink.sink);
+    addLogSink(logState, sink.sink);
 
     try {
       resolveWgpuQuadMaterialRenderer(state, makeMaterial(TestKind));
@@ -90,14 +110,20 @@ describe('resolveWgpuQuadMaterialRenderer', () => {
       expect(explainRenderRegistriesMisses(state).misses).toEqual([
         { kind: TestKind, registry: RenderRegistryTable.MaterialRenderer },
       ]);
-      expect(getMemoryLogSinkEntries(sink)[0]?.data).toMatchObject({
+      expect(readMemoryLogEntries(sink)[0]?.data).toMatchObject({
         kind: TestKind,
         message:
           'resolveWgpuQuadMaterialRenderer: material kind has no registered renderer, so nodes using it do not draw — call registerWgpuQuadMaterialRenderer(state, kind, renderer)',
         registry: RenderRegistryTable.MaterialRenderer,
       });
     } finally {
-      removeLogSink(sink.sink);
+      removeLogSink(logState, sink.sink);
     }
   });
 });
+
+function readMemoryLogEntries(handle: Readonly<MemoryLogSink>): LogEntry[] {
+  const entries: LogEntry[] = [];
+  getMemoryLogSinkEntries(entries, handle);
+  return entries;
+}

package/src/wgpuRenderState.test.ts

@@ -251,7 +251,7 @@ describe('createWgpuOffscreenRenderState', () => {
     registerWgpuQuadMaterialRenderer(screen, 'acme.Material', materialRenderer);
     registerWgpuTextureResolver(screen, 'acme.Texture', textureResolver);
     enableColorAdjustments(screen);
-    enableColorAdjustmentGuards(screen);
+    enableColorAdjustmentGuards(screen, null);
     registerPaddingResolver(screen, 'acme.Effect', paddingResolver);
     getWgpuRenderStateRuntime(screen).registries.colorAdjustmentFeature = colorAdjustmentFeature;
     getWgpuRenderStateRuntime(screen).registries.colorAdjustmentFeatureGuard = colorAdjustmentFeatureGuard;