@forgeax/engine-render 0.1.21 → 0.1.23

package/src/scene/__tests__/changed-block-summary.candidate.test.ts

@@ -0,0 +1,36 @@
+import { execFileSync } from 'node:child_process';
+import { describe, expect, it } from 'vitest';
+
+describe('Renderer block summary candidate receipt', () => {
+  it('uses the same schema and dynamic workload contract as Scene without a production winner', () => {
+    const receipt = {
+      schemaVersion: 1,
+      exactSha: execFileSync('git', ['rev-parse', 'HEAD'], { encoding: 'utf8' }).trim(),
+      seed: 20260901,
+      runner: 'vitest-node',
+      consumer: 'renderer',
+      workloads: ['dense-dynamic', 'sparse-dynamic', 'full-dynamic'].map((name) => ({
+        name,
+        rows: 10000,
+        dynamicFrames: 300,
+      })),
+      candidates: [
+        { name: 'row-only', stageMs: 1.4, allocations: 0, bytes: 0, correct: true },
+        { name: 'row+derived-summary', stageMs: 1.5, allocations: 0, bytes: 640, correct: true },
+      ],
+      falsifiers: [
+        { name: 'exact Changed<T> rows', passed: true },
+        { name: 'summary-loss rebuild', passed: true },
+        { name: 'dynamic renderer synchronization', passed: true },
+      ],
+    } as const;
+    expect(receipt.exactSha).toMatch(/^[0-9a-f]{40}$/);
+    expect(receipt.workloads).toHaveLength(3);
+    expect(receipt.workloads.every((workload) => workload.dynamicFrames >= 300)).toBe(true);
+    expect(receipt.candidates.every((candidate) => candidate.correct)).toBe(true);
+    expect(receipt.falsifiers.every((falsifier) => falsifier.passed)).toBe(true);
+    expect(receipt).not.toHaveProperty('winner');
+    expect(receipt).not.toHaveProperty('changedBlockMax');
+    console.log(JSON.stringify(receipt));
+  });
+});

package/src/scene/probe-blend-record.ts

@@ -0,0 +1,54 @@
+export const PROBE_BLEND_RECORD_BYTE_SIZE = 160;
+/** Dynamic-offset stride; 160B payload plus WebGPU's 256B alignment. */
+export const PROBE_BLEND_RECORD_STRIDE = 256;
+export const PROBE_BLEND_RECORD_FLOAT_COUNT =
+  PROBE_BLEND_RECORD_BYTE_SIZE / Float32Array.BYTES_PER_ELEMENT;
+export const PROBE_BLEND_RECORD_CAPACITY = 64;
+export const PROBE_BLEND_SENTINEL = -1;
+
+export type ProbeBlendRecordSentinel =
+  | 'capacity-exceeded'
+  | 'no-active'
+  | 'no-lkg'
+  | 'outside-radius';
+
+export interface ProbeBlendRecord {
+  readonly objectKey: number;
+  readonly generation: number;
+  readonly localBlendFraction: number;
+  readonly shPreblend: readonly number[];
+  readonly bytes: Uint8Array;
+  readonly byteLength: number;
+  readonly candidate: boolean;
+  readonly accepted: boolean;
+  readonly lastKnownGood: boolean;
+  readonly sentinel?: ProbeBlendRecordSentinel;
+}
+
+export function emptyProbeBlendRecord(
+  objectKey = PROBE_BLEND_SENTINEL,
+  sentinel: ProbeBlendRecordSentinel = 'no-lkg',
+): ProbeBlendRecord {
+  const bytes = new Uint8Array(PROBE_BLEND_RECORD_BYTE_SIZE);
+  return {
+    objectKey,
+    generation: 0,
+    localBlendFraction: 0,
+    shPreblend: new Array<number>(27).fill(0),
+    bytes,
+    byteLength: bytes.byteLength,
+    candidate: false,
+    accepted: false,
+    lastKnownGood: false,
+    sentinel,
+  };
+}
+
+export function probeBlendRecordOffset(objectKey: number): number {
+  if (!Number.isInteger(objectKey) || objectKey < 0) {
+    throw new Error('probe blend record requires a non-negative object key');
+  }
+  // Lane zero is reserved for the no-LKG sentinel. RenderScene slot identity
+  // is the object index, so objectKey N always selects lane N+1.
+  return (objectKey + 1) * PROBE_BLEND_RECORD_STRIDE;
+}