@flighthq/scene3d-wgpu 0.2.1-next.840.857425c

package/dist/wgpuUnlitPrelude.js

@@ -0,0 +1,142 @@
+import { bindWgpuVideoTexture } from '@flighthq/render-wgpu';
+import { createWgpuMeshPipeline, ensureWgpuScene3DPipeline, getWgpuMeshPreludeWgsl, getWgpuMaterialSampler, ensureWgpuPlaceholderTextureView, resolveWgpuMaterialTextureView, stashWgpuUvTransform, } from './wgpuMeshPipeline';
+import { getWgpuScene3DRuntime, getWgpuSkinningAdapter } from './wgpuScene3DRuntime';
+// Ensures (and caches per material reference) the unlit Material bind group — a uniform buffer + the
+// shared sampler + the placeholder color texture — and rewrites its uniform with this surface's linear
+// color, intensity, and alpha cutoff. Mirrors scene-gl's bindGlUnlitSurface. Returns the bind group for
+// the caller to set at group(2).
+export function bindWgpuUnlitSurface(state, pipeline, materialKey, color, intensity, alphaCutoff, colorMap) {
+    const sampler = getWgpuMaterialSampler(state, colorMap);
+    const view = resolveWgpuMaterialTextureView(state, colorMap);
+    const binding = ensureWgpuUnlitBinding(state, pipeline, materialKey, sampler, view);
+    writeWgpuUnlitUniform(state, binding, color, intensity, alphaCutoff);
+    stashWgpuUvTransform(state, colorMap);
+    return binding.bindGroup;
+}
+// Dynamic-video sibling of bindWgpuUnlitSurface. The VideoTexture uploader preserves one GPU texture
+// per stream, copies only when frameId advances, and replaces the material bind group when a resolution
+// change yields a new view. It shares the still-image shader/layout and UV-transform path.
+export function bindWgpuUnlitVideoSurface(state, pipeline, materialKey, color, intensity, alphaCutoff, colorMap) {
+    const entry = bindWgpuVideoTexture(state, colorMap);
+    const sampler = getWgpuMaterialSampler(state, colorMap);
+    const view = entry?.view ?? ensureWgpuPlaceholderTextureView(state);
+    const binding = ensureWgpuUnlitBinding(state, pipeline, materialKey, sampler, view);
+    writeWgpuUnlitUniform(state, binding, color, intensity, alphaCutoff);
+    stashWgpuUvTransform(state, colorMap);
+    return binding.bindGroup;
+}
+function ensureWgpuUnlitBinding(state, pipeline, materialKey, sampler, view) {
+    const scene = getWgpuScene3DRuntime(state);
+    let binding = scene.materialBindGroups.get(materialKey);
+    if (binding === undefined) {
+        const buffer = state.device.createBuffer({
+            size: UNLIT_UNIFORM_BYTES,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        binding = {
+            bindGroup: createWgpuUnlitBindGroup(state, pipeline, buffer, sampler, view),
+            buffer,
+            sampler,
+            views: [view],
+        };
+        scene.materialBindGroups.set(materialKey, binding);
+    }
+    else if (binding.sampler !== sampler || binding.views?.[0] !== view || (binding.views?.length ?? 0) !== 1) {
+        binding.bindGroup = createWgpuUnlitBindGroup(state, pipeline, binding.buffer, sampler, view);
+        binding.sampler = sampler;
+        binding.views ??= [view];
+        binding.views[0] = view;
+        binding.views.length = 1;
+    }
+    return binding;
+}
+function createWgpuUnlitBindGroup(state, pipeline, buffer, sampler, view) {
+    return state.device.createBindGroup({
+        layout: pipeline.materialBindGroupLayout,
+        entries: [
+            { binding: 0, resource: { buffer } },
+            { binding: 1, resource: sampler },
+            { binding: 2, resource: view },
+        ],
+    });
+}
+function writeWgpuUnlitUniform(state, binding, color, intensity, alphaCutoff) {
+    _scratch[0] = color[0];
+    _scratch[1] = color[1];
+    _scratch[2] = color[2];
+    _scratch[3] = color[3];
+    _scratch[4] = intensity;
+    _scratch[5] = alphaCutoff;
+    _scratch[6] = 0;
+    _scratch[7] = 0;
+    state.device.queue.writeBuffer(binding.buffer, 0, _scratch.buffer, 0, UNLIT_UNIFORM_BYTES);
+}
+// A short, stable, order-independent string identity for an unlit define key, used as the pipeline-
+// cache key (combined with the color format). Two keys with the same flags share a compiled pipeline.
+export function buildWgpuUnlitDefineKey(key) {
+    return `${key.alphaMaskEnabled ? 'm' : '-'}${key.doubleSided ? 'd' : '-'}${key.hasColorMap ? 'c' : '-'}`;
+}
+// Compiles the unlit module for a define key and builds the render pipeline for the given color format,
+// with the group(2) material bind-group layout (uniform + sampler + one color texture). Pure GPU work —
+// no caching — used by ensureWgpuUnlitPipeline.
+export function compileWgpuUnlitPipeline(state, key, format, blended = false, skinned = false) {
+    const device = state.device;
+    const module = device.createShaderModule({
+        code: getWgpuUnlitModuleSourceForKey(key, skinned, getWgpuSkinningAdapter(state)),
+    });
+    const materialBindGroupLayout = device.createBindGroupLayout({
+        entries: [
+            { binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: 'uniform' } },
+            { binding: 1, visibility: GPUShaderStage.FRAGMENT, sampler: { type: 'filtering' } },
+            { binding: 2, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: 'float' } },
+        ],
+    });
+    return createWgpuMeshPipeline(state, {
+        blended,
+        doubleSided: key.doubleSided,
+        format,
+        materialBindGroupLayout,
+        module,
+        skinned,
+    });
+}
+// Resolves the unlit pipeline for a define key + color format, compiling and caching it on first use
+// through the shared scene pipeline cache under the `unlit:` family namespace.
+export function ensureWgpuUnlitPipeline(state, key, format) {
+    return ensureWgpuScene3DPipeline(state, `unlit:${format}|${buildWgpuUnlitDefineKey(key)}`, (blended, skinned) => compileWgpuUnlitPipeline(state, key, format, blended, skinned));
+}
+// The full WGSL module source for a define key: the const-flag block + the shared mesh prelude (Frame/
+// Draw/vs_main/srgbToLinear) + the unlit material block + fs_main.
+export function getWgpuUnlitModuleSourceForKey(key, skinned = false, skinning = null) {
+    return (`const ALPHA_MASK : bool = ${key.alphaMaskEnabled ? 'true' : 'false'};\n` +
+        `const HAS_COLOR_MAP : bool = ${key.hasColorMap ? 'true' : 'false'};\n` +
+        getWgpuMeshPreludeWgsl(skinned, skinning) +
+        UNLIT_WGSL_BODY);
+}
+// Unlit material uniform: color vec4f (16) + params vec4f (16) = 32 bytes / 8 floats. params.x =
+// intensity, params.y = alphaCutoff.
+const UNLIT_UNIFORM_BYTES = 32;
+const UNLIT_WGSL_BODY = /* wgsl */ `
+struct UnlitMaterial {
+  color : vec4f,   // linear rgba
+  params : vec4f,  // x = intensity, y = alphaCutoff
+};
+
+@group(2) @binding(0) var<uniform> material : UnlitMaterial;
+@group(2) @binding(1) var materialSampler : sampler;
+@group(2) @binding(2) var colorTexture : texture_2d<f32>;
+
+@fragment fn fs_main(in : VertexOutput) -> @location(0) vec4f {
+  var color = material.color;
+  if (HAS_COLOR_MAP) {
+    let sampled = textureSample(colorTexture, materialSampler, in.uv);
+    color = vec4f(color.rgb * srgbToLinear(sampled.rgb), color.a * sampled.a);
+  }
+  if (ALPHA_MASK && color.a < material.params.y) {
+    discard;
+  }
+  return vec4f(color.rgb * material.params.x, color.a * in.objectAlpha);
+}
+`;
+const _scratch = new Float32Array(UNLIT_UNIFORM_BYTES / 4);
+//# sourceMappingURL=wgpuUnlitPrelude.js.map

package/dist/wgpuUnlitPrelude.js.map

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

package/dist/wgpuWireframePrelude.d.ts

@@ -0,0 +1,6 @@
+import type { LinearColor, WgpuRenderState, WgpuWireframePipeline } from '@flighthq/types';
+export declare function bindWgpuWireframeColor(state: WgpuRenderState, pipeline: Readonly<WgpuWireframePipeline>, materialKey: object, color: Readonly<LinearColor>): GPUBindGroup;
+export declare function compileWgpuWireframePipeline(state: WgpuRenderState, format: GPUTextureFormat, blended?: boolean): WgpuWireframePipeline;
+export declare function ensureWgpuWireframePipeline(state: WgpuRenderState, format: GPUTextureFormat): WgpuWireframePipeline;
+export declare function getWgpuWireframeModuleSource(): string;
+//# sourceMappingURL=wgpuWireframePrelude.d.ts.map

package/dist/wgpuWireframePrelude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuWireframePrelude.d.ts","sourceRoot":"","sources":["../src/wgpuWireframePrelude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAuB,eAAe,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAiBhH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EACzC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC3B,YAAY,CAyBd;AAKD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,UAAQ,GACd,qBAAqB,CAcvB;AAID,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,qBAAqB,CAInH;AAID,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}

package/dist/wgpuWireframePrelude.js

@@ -0,0 +1,77 @@
+import { createWgpuMeshPipeline, ensureWgpuScene3DPipeline, stashWgpuUvTransform, WGPU_MESH_PRELUDE_WGSL, } from './wgpuMeshPipeline';
+import { getWgpuScene3DRuntime } from './wgpuScene3DRuntime';
+// The Wgpu wireframe prelude — the WGSL mirror of scene-gl's glWireframePrelude. A minimal module that
+// reuses the shared vs_main (position → clip) and outputs a single flat LINE color; the wireframe
+// material draws mesh edges as GL line-list primitives (see wgpuWireframeUpload for the derived
+// line-index buffer). It has no lighting, no maps, and one variant per color format — group(2) carries
+// only the color uniform. The pipeline is built with line-list topology and cull-none.
+// Ensures (and caches per material reference) the wireframe color bind group — a single uniform buffer
+// — and rewrites it with this material's linear line color. Mirrors scene-gl's wireframe color upload.
+export function bindWgpuWireframeColor(state, pipeline, materialKey, color) {
+    const scene = getWgpuScene3DRuntime(state);
+    let binding = scene.materialBindGroups.get(materialKey);
+    if (binding === undefined) {
+        const buffer = state.device.createBuffer({
+            size: WIREFRAME_UNIFORM_BYTES,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        const bindGroup = state.device.createBindGroup({
+            layout: pipeline.materialBindGroupLayout,
+            entries: [{ binding: 0, resource: { buffer } }],
+        });
+        binding = { bindGroup, buffer };
+        scene.materialBindGroups.set(materialKey, binding);
+    }
+    _scratch[0] = color[0];
+    _scratch[1] = color[1];
+    _scratch[2] = color[2];
+    _scratch[3] = color[3];
+    state.device.queue.writeBuffer(binding.buffer, 0, _scratch.buffer, 0, WIREFRAME_UNIFORM_BYTES);
+    // Wireframe draws untextured lines, so stash identity to keep the shared Draw uniform authoritative —
+    // a prior tiled material's transform must not persist into this bind.
+    stashWgpuUvTransform(state, null);
+    return binding.bindGroup;
+}
+// Compiles the wireframe module and builds the line-list render pipeline for the given color format,
+// with a group(2) material layout carrying just the color uniform. Cull-none (lines have no winding).
+// Pure GPU work — no caching — used by ensureWgpuWireframePipeline.
+export function compileWgpuWireframePipeline(state, format, blended = false) {
+    const device = state.device;
+    const module = device.createShaderModule({ code: getWgpuWireframeModuleSource() });
+    const materialBindGroupLayout = device.createBindGroupLayout({
+        entries: [{ binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: 'uniform' } }],
+    });
+    return createWgpuMeshPipeline(state, {
+        blended,
+        doubleSided: true,
+        format,
+        materialBindGroupLayout,
+        module,
+        topology: 'line-list',
+    });
+}
+// Resolves the wireframe pipeline for a color format, compiling and caching it on first use through the
+// shared scene pipeline cache under the `wireframe:` family namespace.
+export function ensureWgpuWireframePipeline(state, format) {
+    return ensureWgpuScene3DPipeline(state, `wireframe:${format}`, (blended) => compileWgpuWireframePipeline(state, format, blended));
+}
+// The full WGSL module source: the shared mesh prelude (Frame/Draw/vs_main/srgbToLinear) + the
+// wireframe color uniform + fs_main.
+export function getWgpuWireframeModuleSource() {
+    return WGPU_MESH_PRELUDE_WGSL + WIREFRAME_WGSL_BODY;
+}
+// Wireframe material uniform: color vec4f = 16 bytes / 4 floats.
+const WIREFRAME_UNIFORM_BYTES = 16;
+const WIREFRAME_WGSL_BODY = /* wgsl */ `
+struct WireframeMaterial {
+  color : vec4f,  // linear rgba
+};
+
+@group(2) @binding(0) var<uniform> material : WireframeMaterial;
+
+@fragment fn fs_main(in : VertexOutput) -> @location(0) vec4f {
+  return vec4f(material.color.rgb, material.color.a * in.objectAlpha);
+}
+`;
+const _scratch = new Float32Array(WIREFRAME_UNIFORM_BYTES / 4);
+//# sourceMappingURL=wgpuWireframePrelude.js.map

package/dist/wgpuWireframePrelude.js.map

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

package/dist/wgpuWireframeUpload.d.ts

@@ -0,0 +1,3 @@
+import type { WgpuWireframeUpload, MeshGeometry, WgpuRenderState } from '@flighthq/types';
+export declare function ensureWgpuWireframeUpload(state: WgpuRenderState, geometry: Readonly<MeshGeometry>): WgpuWireframeUpload | null;
+//# sourceMappingURL=wgpuWireframeUpload.d.ts.map

package/dist/wgpuWireframeUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuWireframeUpload.d.ts","sourceRoot":"","sources":["../src/wgpuWireframeUpload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAQ1F,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,GAC/B,mBAAmB,GAAG,IAAI,CAiC5B"}

package/dist/wgpuWireframeUpload.js

@@ -0,0 +1,68 @@
+import { ensureWgpuMeshUpload } from './wgpuMeshUpload';
+// Lazily derives + uploads the wireframe line-index buffer for a geometry on this state, caching it
+// keyed by the geometry entity. Reuses the geometry's vertex buffer (ensuring the triangle upload
+// first) and builds a line-list index buffer from the triangle indices. A subset's triangle range
+// [indexOffset, +indexCount) maps to the line range [indexOffset * 2, +indexCount * 2) (each triangle
+// index yields two line indices), so the renderer draws a sub-range of this buffer.
+export function ensureWgpuWireframeUpload(state, geometry) {
+    const meshUpload = ensureWgpuMeshUpload(state, geometry);
+    if (meshUpload === null)
+        return null;
+    let perState = wireframeUploads.get(state);
+    if (perState === undefined) {
+        perState = new WeakMap();
+        wireframeUploads.set(state, perState);
+    }
+    let upload = perState.get(geometry);
+    if (upload !== undefined && upload.version === geometry.version) {
+        return upload;
+    }
+    const device = state.device;
+    if (upload !== undefined)
+        upload.lineIndexBuffer.destroy();
+    const lines = buildLineIndices(geometry);
+    const lineIndexBuffer = device.createBuffer({
+        size: Math.max(4, alignTo4(lines.byteLength)),
+        usage: GPUBufferUsage.INDEX | GPUBufferUsage.COPY_DST,
+    });
+    device.queue.writeBuffer(lineIndexBuffer, 0, lines.buffer, lines.byteOffset, lines.byteLength);
+    upload = {
+        indexFormat: lines instanceof Uint32Array ? 'uint32' : 'uint16',
+        lineIndexBuffer,
+        version: geometry.version,
+        vertexBuffer: meshUpload.vertexBuffer,
+    };
+    perState.set(geometry, upload);
+    return upload;
+}
+// Builds the line-list index array (two indices per triangle edge, three edges per triangle) from a
+// geometry's triangle indices. Promotes to Uint32 when any line index exceeds the Uint16 range.
+function buildLineIndices(geometry) {
+    const triangleIndices = geometry.indices;
+    const triangleCount = Math.floor(triangleIndices.length / 3);
+    const lineCount = triangleCount * 6;
+    const useUint32 = triangleIndices instanceof Uint32Array || lineCount > 65535;
+    const lines = useUint32 ? new Uint32Array(lineCount) : new Uint16Array(lineCount);
+    for (let t = 0; t < triangleCount; t++) {
+        const base = t * 3;
+        const i0 = triangleIndices[base];
+        const i1 = triangleIndices[base + 1];
+        const i2 = triangleIndices[base + 2];
+        const out = t * 6;
+        lines[out] = i0;
+        lines[out + 1] = i1;
+        lines[out + 2] = i1;
+        lines[out + 3] = i2;
+        lines[out + 4] = i2;
+        lines[out + 5] = i0;
+    }
+    return lines;
+}
+// GPU buffers written via writeBuffer must be a multiple of 4 bytes; round the requested size up.
+function alignTo4(byteLength) {
+    return (byteLength + 3) & ~3;
+}
+// Per-state wireframe upload caches, keyed by geometry. Module-local (not a runtime slot) since
+// wireframe is the only consumer; the outer WeakMap drops a state's caches when the state is GC'd.
+const wireframeUploads = new WeakMap();
+//# sourceMappingURL=wgpuWireframeUpload.js.map

package/dist/wgpuWireframeUpload.js.map

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

package/dist/wireframeWgpuMeshMaterialRenderer.d.ts

@@ -0,0 +1,4 @@
+import type { WgpuMeshMaterialRenderer, WgpuRenderState } from '@flighthq/types';
+export declare const wireframeWgpuMeshMaterialRenderer: WgpuMeshMaterialRenderer;
+export declare function registerWireframeWgpuMaterial(state: WgpuRenderState): void;
+//# sourceMappingURL=wireframeWgpuMeshMaterialRenderer.d.ts.map

package/dist/wireframeWgpuMeshMaterialRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wireframeWgpuMeshMaterialRenderer.d.ts","sourceRoot":"","sources":["../src/wireframeWgpuMeshMaterialRenderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAOV,wBAAwB,EACxB,eAAe,EAEhB,MAAM,iBAAiB,CAAC;AAgBzB,eAAO,MAAM,iCAAiC,EAAE,wBAkD/C,CAAC;AAKF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAE1E"}

package/dist/wireframeWgpuMeshMaterialRenderer.js

@@ -0,0 +1,69 @@
+import { unpackColorToLinear } from '@flighthq/color';
+import { getWgpuRenderStateRuntime } from '@flighthq/render-wgpu';
+import { WireframeMaterialKind } from '@flighthq/types';
+import { registerWgpuMeshMaterialRenderer } from './wgpuMeshMaterialRegistry';
+import { beginWgpuMeshDraw, writeWgpuDrawUniform, writeWgpuFrameUniform } from './wgpuMeshPipeline';
+import { getWgpuScene3DRuntime } from './wgpuScene3DRuntime';
+import { bindWgpuWireframeColor, ensureWgpuWireframePipeline } from './wgpuWireframePrelude';
+import { ensureWgpuWireframeUpload } from './wgpuWireframeUpload';
+// The built-in Wireframe forward renderer (WgpuMeshMaterialRenderer for WireframeMaterialKind) — the
+// WGSL mirror of wireframeGlMeshMaterialRenderer. Draws the mesh's triangle edges as line-list
+// primitives in a single flat linear color. Unlike the triangle families it does not use
+// drawWgpuMeshSubset: draw binds the derived line-index buffer (see wgpuWireframeUpload) and issues a
+// line-list indexed draw over the subset's line range. `thickness` > 1 is not honored (WebGPU has no
+// line-width control); the field is documented as best-effort and ignored. Lights are ignored. See
+// registerWireframeWgpuMaterial to install it.
+export const wireframeWgpuMeshMaterialRenderer = {
+    bind(state, material, _lights, camera) {
+        const stateRuntime = getWgpuRenderStateRuntime(state);
+        const pass = stateRuntime.renderPass;
+        if (pass === null)
+            return;
+        const wireframe = material;
+        const format = stateRuntime.currentColorFormat ?? state.format;
+        const pipeline = ensureWgpuWireframePipeline(state, format);
+        writeWgpuFrameUniform(state, camera, _lights);
+        let group;
+        if (wireframe === null) {
+            group = bindWgpuWireframeColor(state, pipeline, FALLBACK_MATERIAL, WHITE);
+        }
+        else {
+            unpackColorToLinear(_scratch, wireframe.color);
+            group = bindWgpuWireframeColor(state, pipeline, wireframe, _scratch);
+        }
+        beginWgpuMeshDraw(state, pipeline);
+        pass.setBindGroup(2, group);
+    },
+    draw(state, proxy, geometry) {
+        const stateRuntime = getWgpuRenderStateRuntime(state);
+        const pass = stateRuntime.renderPass;
+        const scene = getWgpuScene3DRuntime(state);
+        if (pass === null || scene.activeMeshPipeline === null)
+            return;
+        const subset = proxy.subset;
+        if (subset.indexCount === 0)
+            return;
+        const upload = ensureWgpuWireframeUpload(state, geometry);
+        if (upload === null)
+            return;
+        const drawBindGroup = writeWgpuDrawUniform(state, proxy);
+        _dynamicOffsets[0] = scene.pendingDrawOffset;
+        pass.setBindGroup(1, drawBindGroup, _dynamicOffsets);
+        pass.setVertexBuffer(0, upload.vertexBuffer);
+        pass.setIndexBuffer(upload.lineIndexBuffer, upload.indexFormat);
+        // Each triangle index contributes two line indices, so the subset's line range is its triangle
+        // range scaled by 2.
+        pass.drawIndexed(subset.indexCount * 2, 1, subset.indexOffset * 2, 0, 0);
+    },
+};
+// Registers the built-in Wireframe renderer for WireframeMaterialKind on this state. Opt-in (no top-
+// level side effect); call once per WgpuRenderState before drawWgpuScene3D so meshes with
+// WireframeMaterials draw.
+export function registerWireframeWgpuMaterial(state) {
+    registerWgpuMeshMaterialRenderer(state, WireframeMaterialKind, wireframeWgpuMeshMaterialRenderer);
+}
+const _scratch = [0, 0, 0, 0];
+const _dynamicOffsets = new Uint32Array(1);
+const WHITE = [1, 1, 1, 1];
+const FALLBACK_MATERIAL = {};
+//# sourceMappingURL=wireframeWgpuMeshMaterialRenderer.js.map

package/dist/wireframeWgpuMeshMaterialRenderer.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@flighthq/scene3d-wgpu",
+  "version": "0.2.1-next.840.857425c",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/scene3d-wgpu"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/camera": "0.2.1-next.840.857425c",
+    "@flighthq/color": "0.2.1-next.840.857425c",
+    "@flighthq/geometry": "0.2.1-next.840.857425c",
+    "@flighthq/image": "0.2.1-next.840.857425c",
+    "@flighthq/lighting": "0.2.1-next.840.857425c",
+    "@flighthq/log": "0.2.1-next.840.857425c",
+    "@flighthq/materials": "0.2.1-next.840.857425c",
+    "@flighthq/node": "0.2.1-next.840.857425c",
+    "@flighthq/render": "0.2.1-next.840.857425c",
+    "@flighthq/render-wgpu": "0.2.1-next.840.857425c",
+    "@flighthq/scene3d": "0.2.1-next.840.857425c",
+    "@flighthq/shading": "0.2.1-next.840.857425c",
+    "@flighthq/texture": "0.2.1-next.840.857425c",
+    "@flighthq/types": "0.2.1-next.840.857425c"
+  },
+  "devDependencies": {
+    "@flighthq/mesh": "*",
+    "@flighthq/particleemitter": "*",
+    "typescript": "^5.3.0"
+  },
+  "description": "WebGPU 3D scene renderer",
+  "sideEffects": false
+}

package/src/anisotropyPbrWgpuMeshMaterialRenderer.test.ts

@@ -0,0 +1,90 @@
+import { createCamera3D } from '@flighthq/camera';
+import { createMatrix3, createMatrix4 } from '@flighthq/geometry';
+import { createAnisotropyPbrMaterial } from '@flighthq/materials';
+import { createBoxMeshGeometry } from '@flighthq/mesh';
+import type { Camera3D, Matrix3, Matrix4, Scene3DLightBlock, Scene3DRenderProxy } from '@flighthq/types';
+import { AnisotropyPbrMaterialKind } from '@flighthq/types';
+
+import {
+  anisotropyPbrWgpuMeshMaterialRenderer,
+  registerAnisotropyPbrWgpuMaterial,
+} from './anisotropyPbrWgpuMeshMaterialRenderer';
+import { getWgpuMeshMaterialRenderer } from './wgpuMeshMaterialRegistry';
+import { makeWgpuScene3DState } from './wgpuScene3DTestHelper';
+
+function makeCamera(): Camera3D {
+  return createCamera3D({ far: 100, near: 0.1, projection: { aspect: 1, fovY: Math.PI / 3, kind: 'perspective' } });
+}
+
+function makeLights(): Scene3DLightBlock {
+  const data = new Float32Array(12);
+  data[1] = -1;
+  data[4] = 1;
+  data[5] = 1;
+  data[6] = 1;
+  data[8] = 0.1;
+  data[9] = 0.1;
+  data[10] = 0.1;
+  return { ambientCount: 1, data, directionalCount: 1, hemisphereCount: 0, pointCount: 0, spotCount: 0, version: 1 };
+}
+
+function makeProxy(): Scene3DRenderProxy {
+  const geometry = createBoxMeshGeometry();
+  return {
+    material: createAnisotropyPbrMaterial({ anisotropyStrength: 0.6 }),
+    normalMatrix: createMatrix3() as Matrix3,
+    subset: geometry.subsets[0],
+    worldMatrix: createMatrix4() as Matrix4,
+  };
+}
+
+describe('anisotropyPbrWgpuMeshMaterialRenderer', () => {
+  it('bind selects a pipeline and binds frame + material groups + uploads uniforms', () => {
+    const { fake, state } = makeWgpuScene3DState();
+    anisotropyPbrWgpuMeshMaterialRenderer.bind(
+      state,
+      createAnisotropyPbrMaterial({ anisotropyStrength: 0.6 }),
+      makeLights(),
+      makeCamera(),
+    );
+
+    expect(fake.calls.some((c) => c.name === 'createRenderPipeline')).toBe(true);
+    expect(fake.calls.some((c) => c.name === 'setPipeline')).toBe(true);
+    expect(fake.calls.filter((c) => c.name === 'setBindGroup').length).toBeGreaterThanOrEqual(2);
+    expect(fake.calls.some((c) => c.name === 'writeBuffer')).toBe(true);
+  });
+
+  it('bind compiles the ANISOTROPY extension variant', () => {
+    const { fake, state } = makeWgpuScene3DState();
+    anisotropyPbrWgpuMeshMaterialRenderer.bind(state, createAnisotropyPbrMaterial(), makeLights(), makeCamera());
+    const moduleCall = fake.calls.find((c) => c.name === 'createShaderModule');
+    const code = (moduleCall!.args[0] as { code: string }).code;
+    expect(code).toContain('const ANISOTROPY : bool = true;');
+  });
+
+  it('draw uploads geometry and issues an indexed draw over the subset range', () => {
+    const { fake, state } = makeWgpuScene3DState();
+    const proxy = makeProxy();
+    anisotropyPbrWgpuMeshMaterialRenderer.bind(state, proxy.material, makeLights(), makeCamera());
+    anisotropyPbrWgpuMeshMaterialRenderer.draw(state, proxy, createBoxMeshGeometry());
+
+    const drawCall = fake.calls.find((c) => c.name === 'drawIndexed');
+    expect(drawCall).toBeDefined();
+    expect(drawCall!.args[0]).toBe(proxy.subset.indexCount);
+    expect(drawCall!.args[2]).toBe(proxy.subset.indexOffset);
+  });
+
+  it('draw is a no-op when bind has not selected a pipeline', () => {
+    const { fake, state } = makeWgpuScene3DState();
+    anisotropyPbrWgpuMeshMaterialRenderer.draw(state, makeProxy(), createBoxMeshGeometry());
+    expect(fake.calls.some((c) => c.name === 'drawIndexed')).toBe(false);
+  });
+});
+
+describe('registerAnisotropyPbrWgpuMaterial', () => {
+  it('installs the renderer for AnisotropyPbrMaterialKind', () => {
+    const { state } = makeWgpuScene3DState();
+    registerAnisotropyPbrWgpuMaterial(state);
+    expect(getWgpuMeshMaterialRenderer(state, AnisotropyPbrMaterialKind)).toBe(anisotropyPbrWgpuMeshMaterialRenderer);
+  });
+});