@quake2ts/test-utils 0.0.848 → 0.0.850

package/dist/index.cjs

@@ -245,6 +245,7 @@ __export(index_exports, {
   createVisualTestScenario: () => createVisualTestScenario,
   createWebGLPlaywrightSetup: () => createWebGLPlaywrightSetup,
   createWebGLRenderTestSetup: () => createWebGLRenderTestSetup,
+  createWebGPULifecycle: () => createWebGPULifecycle,
   encodedVisForClusters: () => encodedVisForClusters,
   expectAnimationSnapshot: () => expectAnimationSnapshot,
   expectNoDoubleTransform: () => expectNoDoubleTransform,
@@ -309,6 +310,7 @@ __export(index_exports, {
   teardownBrowserEnvironment: () => teardownBrowserEnvironment,
   teardownMockAudioContext: () => teardownMockAudioContext,
   teardownNodeEnvironment: () => teardownNodeEnvironment,
+  test: () => test,
   testComputeShader: () => testComputeShader,
   testPipelineRendering: () => testPipelineRendering,
   testWebGLAnimation: () => testWebGLAnimation,
@@ -1622,22 +1624,22 @@ function createMockInventory(overrides = {}) {
   return inventory;
 }
 function createMockItem(id, overrides = {}) {
-  let base;
-  base = import_game7.WEAPON_ITEMS[id] || import_game7.HEALTH_ITEMS[id] || import_game7.ARMOR_ITEMS[id] || import_game7.POWERUP_ITEMS[id] || import_game7.POWER_ARMOR_ITEMS[id] || import_game7.KEY_ITEMS[id] || import_game7.FLAG_ITEMS[id];
-  if (!base) {
-    base = {
+  let base2;
+  base2 = import_game7.WEAPON_ITEMS[id] || import_game7.HEALTH_ITEMS[id] || import_game7.ARMOR_ITEMS[id] || import_game7.POWERUP_ITEMS[id] || import_game7.POWER_ARMOR_ITEMS[id] || import_game7.KEY_ITEMS[id] || import_game7.FLAG_ITEMS[id];
+  if (!base2) {
+    base2 = {
       id,
       name: `Mock Item ${id}`
     };
   }
   return {
-    ...base,
+    ...base2,
     ...overrides
   };
 }
 function createMockWeaponItem(weaponId, overrides = {}) {
   const found = Object.values(import_game7.WEAPON_ITEMS).find((w) => w.weaponId === weaponId);
-  const base = found ? { ...found } : {
+  const base2 = found ? { ...found } : {
     type: "weapon",
     id: `weapon_${weaponId}`,
     name: `Mock Weapon ${weaponId}`,
@@ -1647,7 +1649,7 @@ function createMockWeaponItem(weaponId, overrides = {}) {
     pickupAmmo: 0,
     fireRate: 1
   };
-  return { ...base, ...overrides };
+  return { ...base2, ...overrides };
 }
 function createMockHealthItem(amount, overrides = {}) {
   return {
@@ -1673,27 +1675,27 @@ function createMockAmmoItem(ammoItemId, overrides = {}) {
   if (!def) {
     throw new Error(`Unknown ammo item id: ${ammoItemId}`);
   }
-  const base = {
+  const base2 = {
     id: def.id,
     name: `Mock Ammo ${def.id}`
   };
   return {
-    ...base,
+    ...base2,
     ...overrides
   };
 }
 function createMockPowerupItem(id, duration, overrides = {}) {
   const found = import_game7.POWERUP_ITEMS[id];
-  const base = found ? { ...found } : {
+  const base2 = found ? { ...found } : {
     type: "powerup",
     id,
     name: `Mock Powerup ${id}`,
     timer: duration
   };
   if (duration !== void 0 && !found) {
-    base.timer = duration;
+    base2.timer = duration;
   }
-  return { ...base, ...overrides };
+  return { ...base2, ...overrides };
 }
 
 // src/server/mocks/transport.ts
@@ -3255,6 +3257,45 @@ async function createHeadlessTestContext() {
   };
 }
 
+// src/setup/webgpu-lifecycle.ts
+function createWebGPULifecycle() {
+  const devices = [];
+  const renderers = [];
+  return {
+    track(device) {
+      devices.push(device);
+    },
+    trackRenderer(renderer) {
+      renderers.push(renderer);
+    },
+    async cleanup() {
+      for (const renderer of renderers) {
+        try {
+          renderer.dispose();
+        } catch (e) {
+          console.warn("Error disposing renderer:", e);
+        }
+      }
+      renderers.length = 0;
+      const allDevices = [...devices];
+      devices.length = 0;
+      if (allDevices.length === 0) return;
+      const lostPromises = allDevices.map((d) => d.lost);
+      for (const device of allDevices) {
+        try {
+          device.destroy();
+        } catch (e) {
+          console.warn("Error destroying device:", e);
+        }
+      }
+      await Promise.all(lostPromises);
+    },
+    count() {
+      return devices.length + renderers.length;
+    }
+  };
+}
+
 // src/setup/headless-webgl.ts
 function createHeadlessWebGL(options = {}) {
   const width = options.width ?? 256;
@@ -3962,7 +4003,7 @@ function createMockAssetManager(overrides) {
     getMemoryUsage: import_vitest13.vi.fn().mockReturnValue({ textures: 0, audio: 0 }),
     clearCache: import_vitest13.vi.fn(),
     preloadAssets: import_vitest13.vi.fn().mockResolvedValue(void 0),
-    queueLoad: import_vitest13.vi.fn().mockImplementation((path6) => Promise.resolve({})),
+    queueLoad: import_vitest13.vi.fn().mockImplementation((path7) => Promise.resolve({})),
     ...overrides
   };
 }
@@ -5211,10 +5252,10 @@ function writeVec3(view, offset, vec) {
 function encodePlanes(planes) {
   const view = allocBuffer(planes.length * 20);
   planes.forEach((plane, index) => {
-    const base = index * 20;
-    writeVec3(view, base, plane.normal);
-    view.setFloat32(base + 12, plane.dist, true);
-    view.setInt32(base + 16, plane.type, true);
+    const base2 = index * 20;
+    writeVec3(view, base2, plane.normal);
+    view.setFloat32(base2 + 12, plane.dist, true);
+    view.setInt32(base2 + 16, plane.type, true);
   });
   return new Uint8Array(view.buffer);
 }
@@ -5226,77 +5267,77 @@ function encodeVertices(vertices) {
 function encodeNodes(nodes) {
   const view = allocBuffer(nodes.length * 28);
   nodes.forEach((node, index) => {
-    const base = index * 28;
-    view.setInt32(base, node.planeIndex, true);
-    view.setInt32(base + 4, node.children[0], true);
-    view.setInt32(base + 8, node.children[1], true);
-    view.setInt16(base + 12, node.mins[0], true);
-    view.setInt16(base + 14, node.mins[1], true);
-    view.setInt16(base + 16, node.mins[2], true);
-    view.setInt16(base + 18, node.maxs[0], true);
-    view.setInt16(base + 20, node.maxs[1], true);
-    view.setInt16(base + 22, node.maxs[2], true);
-    view.setUint16(base + 24, node.firstFace, true);
-    view.setUint16(base + 26, node.numFaces, true);
+    const base2 = index * 28;
+    view.setInt32(base2, node.planeIndex, true);
+    view.setInt32(base2 + 4, node.children[0], true);
+    view.setInt32(base2 + 8, node.children[1], true);
+    view.setInt16(base2 + 12, node.mins[0], true);
+    view.setInt16(base2 + 14, node.mins[1], true);
+    view.setInt16(base2 + 16, node.mins[2], true);
+    view.setInt16(base2 + 18, node.maxs[0], true);
+    view.setInt16(base2 + 20, node.maxs[1], true);
+    view.setInt16(base2 + 22, node.maxs[2], true);
+    view.setUint16(base2 + 24, node.firstFace, true);
+    view.setUint16(base2 + 26, node.numFaces, true);
   });
   return new Uint8Array(view.buffer);
 }
 function encodeTexInfo(texInfos) {
   const view = allocBuffer(texInfos.length * 76);
   texInfos.forEach((tex, index) => {
-    const base = index * 76;
-    writeVec3(view, base, tex.s);
-    view.setFloat32(base + 12, tex.sOffset, true);
-    writeVec3(view, base + 16, tex.t);
-    view.setFloat32(base + 28, tex.tOffset, true);
-    view.setInt32(base + 32, tex.flags, true);
-    view.setInt32(base + 36, tex.value, true);
+    const base2 = index * 76;
+    writeVec3(view, base2, tex.s);
+    view.setFloat32(base2 + 12, tex.sOffset, true);
+    writeVec3(view, base2 + 16, tex.t);
+    view.setFloat32(base2 + 28, tex.tOffset, true);
+    view.setInt32(base2 + 32, tex.flags, true);
+    view.setInt32(base2 + 36, tex.value, true);
     const textureBytes = new TextEncoder().encode(tex.texture);
-    new Uint8Array(view.buffer).set(textureBytes.slice(0, 32), base + 40);
-    view.setInt32(base + 72, tex.nextTexInfo, true);
+    new Uint8Array(view.buffer).set(textureBytes.slice(0, 32), base2 + 40);
+    view.setInt32(base2 + 72, tex.nextTexInfo, true);
   });
   return new Uint8Array(view.buffer);
 }
 function encodeFaces(faces) {
   const view = allocBuffer(faces.length * 20);
   faces.forEach((face, index) => {
-    const base = index * 20;
-    view.setUint16(base, face.planeIndex, true);
-    view.setInt16(base + 2, face.side, true);
-    view.setInt32(base + 4, face.firstEdge, true);
-    view.setInt16(base + 8, face.numEdges, true);
-    view.setInt16(base + 10, face.texInfo, true);
-    face.styles.forEach((style, sIndex) => view.setUint8(base + 12 + sIndex, style));
-    view.setInt32(base + 16, face.lightOffset, true);
+    const base2 = index * 20;
+    view.setUint16(base2, face.planeIndex, true);
+    view.setInt16(base2 + 2, face.side, true);
+    view.setInt32(base2 + 4, face.firstEdge, true);
+    view.setInt16(base2 + 8, face.numEdges, true);
+    view.setInt16(base2 + 10, face.texInfo, true);
+    face.styles.forEach((style, sIndex) => view.setUint8(base2 + 12 + sIndex, style));
+    view.setInt32(base2 + 16, face.lightOffset, true);
   });
   return new Uint8Array(view.buffer);
 }
 function encodeLeafs(leafs) {
   const view = allocBuffer(leafs.length * 28);
   leafs.forEach((leaf, index) => {
-    const base = index * 28;
-    view.setInt32(base, leaf.contents, true);
-    view.setInt16(base + 4, leaf.cluster, true);
-    view.setInt16(base + 6, leaf.area, true);
-    view.setInt16(base + 8, leaf.mins[0], true);
-    view.setInt16(base + 10, leaf.mins[1], true);
-    view.setInt16(base + 12, leaf.mins[2], true);
-    view.setInt16(base + 14, leaf.maxs[0], true);
-    view.setInt16(base + 16, leaf.maxs[1], true);
-    view.setInt16(base + 18, leaf.maxs[2], true);
-    view.setUint16(base + 20, leaf.firstLeafFace, true);
-    view.setUint16(base + 22, leaf.numLeafFaces, true);
-    view.setUint16(base + 24, leaf.firstLeafBrush, true);
-    view.setUint16(base + 26, leaf.numLeafBrushes, true);
+    const base2 = index * 28;
+    view.setInt32(base2, leaf.contents, true);
+    view.setInt16(base2 + 4, leaf.cluster, true);
+    view.setInt16(base2 + 6, leaf.area, true);
+    view.setInt16(base2 + 8, leaf.mins[0], true);
+    view.setInt16(base2 + 10, leaf.mins[1], true);
+    view.setInt16(base2 + 12, leaf.mins[2], true);
+    view.setInt16(base2 + 14, leaf.maxs[0], true);
+    view.setInt16(base2 + 16, leaf.maxs[1], true);
+    view.setInt16(base2 + 18, leaf.maxs[2], true);
+    view.setUint16(base2 + 20, leaf.firstLeafFace, true);
+    view.setUint16(base2 + 22, leaf.numLeafFaces, true);
+    view.setUint16(base2 + 24, leaf.firstLeafBrush, true);
+    view.setUint16(base2 + 26, leaf.numLeafBrushes, true);
   });
   return new Uint8Array(view.buffer);
 }
 function encodeEdges(edges) {
   const view = allocBuffer(edges.length * 4);
   edges.forEach((edge, index) => {
-    const base = index * 4;
-    view.setUint16(base, edge[0], true);
-    view.setUint16(base + 2, edge[1], true);
+    const base2 = index * 4;
+    view.setUint16(base2, edge[0], true);
+    view.setUint16(base2 + 2, edge[1], true);
   });
   return new Uint8Array(view.buffer);
 }
@@ -5304,32 +5345,32 @@ function encodeModels(models) {
   const entrySize = 48;
   const view = allocBuffer(models.length * entrySize);
   models.forEach((model, index) => {
-    const base = index * entrySize;
-    writeVec3(view, base, model.mins);
-    writeVec3(view, base + 12, model.maxs);
-    writeVec3(view, base + 24, model.origin);
-    view.setInt32(base + 36, model.headNode, true);
-    view.setInt32(base + 40, model.firstFace, true);
-    view.setInt32(base + 44, model.numFaces, true);
+    const base2 = index * entrySize;
+    writeVec3(view, base2, model.mins);
+    writeVec3(view, base2 + 12, model.maxs);
+    writeVec3(view, base2 + 24, model.origin);
+    view.setInt32(base2 + 36, model.headNode, true);
+    view.setInt32(base2 + 40, model.firstFace, true);
+    view.setInt32(base2 + 44, model.numFaces, true);
   });
   return new Uint8Array(view.buffer);
 }
 function encodeBrushes(brushes) {
   const view = allocBuffer(brushes.length * 12);
   brushes.forEach((brush, index) => {
-    const base = index * 12;
-    view.setInt32(base, brush.firstSide, true);
-    view.setInt32(base + 4, brush.numSides, true);
-    view.setInt32(base + 8, brush.contents, true);
+    const base2 = index * 12;
+    view.setInt32(base2, brush.firstSide, true);
+    view.setInt32(base2 + 4, brush.numSides, true);
+    view.setInt32(base2 + 8, brush.contents, true);
   });
   return new Uint8Array(view.buffer);
 }
 function encodeBrushSides(sides) {
   const view = allocBuffer(sides.length * 4);
   sides.forEach((side, index) => {
-    const base = index * 4;
-    view.setUint16(base, side.planeIndex, true);
-    view.setInt16(base + 2, side.texInfo, true);
+    const base2 = index * 4;
+    view.setUint16(base2, side.planeIndex, true);
+    view.setInt16(base2 + 2, side.texInfo, true);
   });
   return new Uint8Array(view.buffer);
 }
@@ -5424,18 +5465,18 @@ function encodeFrames(frames, numVertices) {
   const frameSize = 40 + numVertices * 4;
   const view = allocBuffer2(frames.length * frameSize);
   frames.forEach((frame, frameIndex) => {
-    const base = frameIndex * frameSize;
+    const base2 = frameIndex * frameSize;
     const scale = frame.scale ?? { x: 1, y: 1, z: 1 };
     const translate = frame.translate ?? { x: 0, y: 0, z: 0 };
-    view.setFloat32(base, scale.x, true);
-    view.setFloat32(base + 4, scale.y, true);
-    view.setFloat32(base + 8, scale.z, true);
-    view.setFloat32(base + 12, translate.x, true);
-    view.setFloat32(base + 16, translate.y, true);
-    view.setFloat32(base + 20, translate.z, true);
-    writeCString(view, base + 24, frame.name, 16);
+    view.setFloat32(base2, scale.x, true);
+    view.setFloat32(base2 + 4, scale.y, true);
+    view.setFloat32(base2 + 8, scale.z, true);
+    view.setFloat32(base2 + 12, translate.x, true);
+    view.setFloat32(base2 + 16, translate.y, true);
+    view.setFloat32(base2 + 20, translate.z, true);
+    writeCString(view, base2 + 24, frame.name, 16);
     frame.vertices.forEach((vertex, index) => {
-      const offset = base + 40 + index * 4;
+      const offset = base2 + 40 + index * 4;
       view.setUint8(offset, Math.round((vertex.position.x - translate.x) / scale.x));
       view.setUint8(offset + 1, Math.round((vertex.position.y - translate.y) / scale.y));
       view.setUint8(offset + 2, Math.round((vertex.position.z - translate.z) / scale.z));
@@ -5501,18 +5542,18 @@ function buildMd2(options) {
   view.setInt32(64, offsetEnd, true);
   skins.forEach((skin, index) => writeCString(view, offsetSkins + index * 64, skin, 64));
   options.texCoords.forEach((coord, index) => {
-    const base = offsetTexCoords + index * 4;
-    view.setInt16(base, coord.s, true);
-    view.setInt16(base + 2, coord.t, true);
+    const base2 = offsetTexCoords + index * 4;
+    view.setInt16(base2, coord.s, true);
+    view.setInt16(base2 + 2, coord.t, true);
   });
   options.triangles.forEach((tri, index) => {
-    const base = offsetTriangles + index * 12;
-    view.setUint16(base, tri.vertexIndices[0], true);
-    view.setUint16(base + 2, tri.vertexIndices[1], true);
-    view.setUint16(base + 4, tri.vertexIndices[2], true);
-    view.setUint16(base + 6, tri.texCoordIndices[0], true);
-    view.setUint16(base + 8, tri.texCoordIndices[1], true);
-    view.setUint16(base + 10, tri.texCoordIndices[2], true);
+    const base2 = offsetTriangles + index * 12;
+    view.setUint16(base2, tri.vertexIndices[0], true);
+    view.setUint16(base2 + 2, tri.vertexIndices[1], true);
+    view.setUint16(base2 + 4, tri.vertexIndices[2], true);
+    view.setUint16(base2 + 6, tri.texCoordIndices[0], true);
+    view.setUint16(base2 + 8, tri.texCoordIndices[1], true);
+    view.setUint16(base2 + 10, tri.texCoordIndices[2], true);
   });
   new Uint8Array(view.buffer, offsetFrames, frameBlockSize).set(encodeFrames(options.frames, numVertices));
   new Uint8Array(view.buffer, offsetGlCommands, glSize).set(glData);
@@ -6295,6 +6336,100 @@ var verifySmoothing = (states) => {
   };
 };
 
+// src/engine/builders/visual-testing.ts
+var import_vitest23 = require("vitest");
+var import_path4 = __toESM(require("path"), 1);
+var test = import_vitest23.test.extend({
+  expectSnapshot: async ({ task }, use) => {
+    const impl = async (pixels, nameOrOptions) => {
+      const updateBaseline = process.env.UPDATE_VISUAL === "1" || process.argv.includes("--update-snapshots") || process.argv.includes("-u");
+      const testFile = task.file?.filepath;
+      const testDir = testFile ? import_path4.default.dirname(testFile) : import_path4.default.join(process.cwd(), "tests");
+      const snapshotDir = import_path4.default.join(testDir, "__snapshots__");
+      const name = typeof nameOrOptions === "string" ? nameOrOptions : nameOrOptions.name;
+      const description = typeof nameOrOptions === "string" ? void 0 : nameOrOptions.description;
+      await expectSnapshot(pixels, {
+        name,
+        description,
+        width: 256,
+        height: 256,
+        updateBaseline,
+        snapshotDir
+      });
+    };
+    await use(impl);
+  },
+  renderAndExpectSnapshot: async ({ task }, use) => {
+    const updateBaseline = process.env.UPDATE_VISUAL === "1" || process.argv.includes("--update-snapshots") || process.argv.includes("-u");
+    const testFile = task.file?.filepath;
+    const testDir = testFile ? import_path4.default.dirname(testFile) : import_path4.default.join(process.cwd(), "tests");
+    const snapshotDir = import_path4.default.join(testDir, "__snapshots__");
+    let setup;
+    const impl = async (fn, nameOrOptions) => {
+      const name = typeof nameOrOptions === "string" ? nameOrOptions : nameOrOptions.name;
+      const description = typeof nameOrOptions === "string" ? void 0 : nameOrOptions.description;
+      const depth = typeof nameOrOptions === "string" ? false : !!nameOrOptions.depth;
+      setup = await createRenderTestSetup(256, 256, { depth });
+      const { device } = setup.context;
+      try {
+        const commandEncoder = device.createCommandEncoder();
+        const renderFn = await fn(
+          device,
+          setup.context.format || "rgba8unorm",
+          commandEncoder,
+          setup.renderTargetView
+        );
+        device.pushErrorScope("validation");
+        if (typeof renderFn === "function") {
+          const passDescriptor = {
+            colorAttachments: [{
+              view: setup.renderTargetView,
+              loadOp: "clear",
+              clearValue: { r: 0, g: 0, b: 0, a: 0 },
+              storeOp: "store"
+            }]
+          };
+          if (setup.depthTargetView) {
+            passDescriptor.depthStencilAttachment = {
+              view: setup.depthTargetView,
+              depthClearValue: 1,
+              depthLoadOp: "clear",
+              depthStoreOp: "discard"
+            };
+          }
+          const pass = commandEncoder.beginRenderPass(passDescriptor);
+          renderFn(pass);
+          pass.end();
+        } else {
+        }
+        device.queue.submit([commandEncoder.finish()]);
+        const error = await device.popErrorScope();
+        if (error) {
+          throw new Error(`WebGPU validation error: ${error.message}`);
+        }
+        const pixels = await captureTexture(device, setup.renderTarget, setup.width, setup.height);
+        await expectSnapshot(pixels, {
+          name,
+          description,
+          width: setup.width,
+          height: setup.height,
+          updateBaseline,
+          snapshotDir
+        });
+      } finally {
+        if (setup) {
+          await setup.cleanup();
+          setup = void 0;
+        }
+      }
+    };
+    await use(impl);
+    if (setup) {
+      await setup.cleanup();
+    }
+  }
+});
+
 // src/e2e/playwright.ts
 async function createPlaywrightTestClient(options = {}) {
   let playwright;
@@ -6379,7 +6514,7 @@ function throttleBandwidth(bytesPerSecond) {
 var import_pngjs2 = require("pngjs");
 var import_pixelmatch2 = __toESM(require("pixelmatch"), 1);
 var import_promises3 = __toESM(require("fs/promises"), 1);
-var import_path4 = __toESM(require("path"), 1);
+var import_path5 = __toESM(require("path"), 1);
 async function captureGameScreenshot(page, name) {
   const canvasElement = page.locator("canvas");
   if (await canvasElement.count() > 0) {
@@ -6398,7 +6533,7 @@ async function takeScreenshot(canvas, filepath) {
   } else {
     throw new Error("Unsupported canvas type for screenshot");
   }
-  await import_promises3.default.mkdir(import_path4.default.dirname(filepath), { recursive: true });
+  await import_promises3.default.mkdir(import_path5.default.dirname(filepath), { recursive: true });
   await import_promises3.default.writeFile(filepath, buffer);
 }
 function compareScreenshots(baseline, current, threshold = 0.01) {
@@ -6657,6 +6792,7 @@ function createVisualTestScenario(sceneName) {
   createVisualTestScenario,
   createWebGLPlaywrightSetup,
   createWebGLRenderTestSetup,
+  createWebGPULifecycle,
   encodedVisForClusters,
   expectAnimationSnapshot,
   expectNoDoubleTransform,
@@ -6721,6 +6857,7 @@ function createVisualTestScenario(sceneName) {
   teardownBrowserEnvironment,
   teardownMockAudioContext,
   teardownNodeEnvironment,
+  test,
   testComputeShader,
   testPipelineRendering,
   testWebGLAnimation,