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

package/dist/specularGlossinessPbrWgpuMeshMaterialRenderer.js

@@ -0,0 +1,126 @@
+import { unpackColorToLinear } from '@flighthq/color';
+import { getWgpuRenderStateRuntime } from '@flighthq/render-wgpu';
+import { SpecularGlossinessPbrMaterialKind } from '@flighthq/types';
+import { buildWgpuPbrStandardDefineKey, ensureWgpuPbrMaterialBindGroup, getWgpuPbrMaterialScratch, writeWgpuPbrMaterialUniform, writeWgpuPbrStandardBlock, } from './standardPbrWgpuMeshMaterialRenderer';
+import { registerWgpuMeshMaterialRenderer } from './wgpuMeshMaterialRegistry';
+import { beginWgpuMeshDraw, drawWgpuMeshSubset, writeWgpuFrameUniform } from './wgpuMeshPipeline';
+import { ensureWgpuPbrPipeline } from './wgpuPbrPipelineCache';
+// The built-in SpecularGlossiness forward-lit mesh-material renderer (legacy KHR_materials_
+// pbrSpecularGlossiness workflow) — the WGSL mirror of specularGlossinessPbrGlMeshMaterialRenderer.
+// There is no spec-gloss path in the shader: this renderer converts the material to a
+// StandardPbrMaterialProperties block on the CPU at bind time and drives the SAME base PBR program (no
+// extension flag), so spec-gloss assets render through the one metallic-roughness uber-shader.
+//
+// CONVERSION (Khronos glTF spec-gloss → metallic-roughness):
+//   - roughness  = 1 - glossiness  (glossiness is the inverse of roughness)
+//   - metallic   = solveMetallic(diffuseBrightness, specularBrightness): the quadratic that recovers
+//                  the metallic factor from how far the specular reflectance sits above the 0.04
+//                  dielectric floor. Fully dielectric specular → 0; albedo-bright specular → 1.
+//   - baseColor  = lerp from the dielectric estimate (diffuse / (1 - 0.04)) toward the specular color
+//                  by metallic, so a dielectric keeps its diffuse albedo and a conductor takes its
+//                  specular tint as F0.
+// The conversion is an approximation — spec-gloss can express specular tints a single metallic-
+// roughness baseColor cannot reproduce exactly — but it matches the reference converter and is stable
+// for typical assets. The specularGlossinessMap is NOT remapped to a metallic-roughness map here
+// (different packing) and maps are not sampled on wgpu yet regardless; only the scalar conversion is
+// applied, while diffuse/emissive/normal/occlusion maps pass straight through to the standard block
+// (reserved, NOT sampled on wgpu yet — maps deferred).
+//
+// Colors are decoded to linear on the CPU before the conversion math; the converted standard block
+// re-packs baseColor/emissive to RGBA8 so writeWgpuPbrStandardBlock's CPU decode round-trips. See
+// registerSpecularGlossinessPbrWgpuMaterial.
+export const specularGlossinessPbrWgpuMeshMaterialRenderer = {
+    bind(state, material, lights, camera) {
+        const stateRuntime = getWgpuRenderStateRuntime(state);
+        const pass = stateRuntime.renderPass;
+        if (pass === null)
+            return;
+        const specGloss = material;
+        const standard = specGloss !== null ? convertSpecularGlossinessToStandard(specGloss) : null;
+        const key = buildWgpuPbrStandardDefineKey(standard, specGloss);
+        const format = stateRuntime.currentColorFormat ?? state.format;
+        const pipeline = ensureWgpuPbrPipeline(state, key, format);
+        writeWgpuFrameUniform(state, camera, lights);
+        const binding = ensureWgpuPbrMaterialBindGroup(state, pipeline, specGloss ?? FALLBACK_MATERIAL, standard);
+        const out = getWgpuPbrMaterialScratch();
+        writeWgpuPbrStandardBlock(out, standard, specGloss !== null ? specGloss.alphaCutoff : 0.5);
+        out.fill(0, 16);
+        writeWgpuPbrMaterialUniform(state, binding);
+        beginWgpuMeshDraw(state, pipeline);
+        pass.setBindGroup(2, binding.bindGroup);
+    },
+    draw(state, proxy, geometry) {
+        drawWgpuMeshSubset(state, proxy, geometry);
+    },
+};
+// Installs the built-in SpecularGlossiness renderer for SpecularGlossinessPbrMaterialKind on this
+// state. Opt-in (no top-level side effect): drawScene3D only draws SpecularGlossiness subsets once this
+// is called.
+export function registerSpecularGlossinessPbrWgpuMaterial(state) {
+    registerWgpuMeshMaterialRenderer(state, SpecularGlossinessPbrMaterialKind, specularGlossinessPbrWgpuMeshMaterialRenderer);
+}
+// Builds a StandardPbrMaterialProperties block from a spec-gloss material via the Khronos reference
+// conversion. Writes a packed RGBA baseColor/emissive (writeWgpuPbrStandardBlock re-decodes them), so
+// the downstream standard-block path stays identical to a native StandardPbr material. The returned
+// object is a fresh per-bind block (not pooled) — bind is not a hot inner loop, and reusing a scratch
+// block would alias across draws. Mirrors scene-gl's convertSpecularGlossinessToStandard.
+function convertSpecularGlossinessToStandard(material) {
+    unpackColorToLinear(_diffuseScratch, material.diffuse);
+    unpackColorToLinear(_specularScratch, material.specular);
+    const specularBrightness = Math.max(_specularScratch[0], _specularScratch[1], _specularScratch[2]);
+    const oneMinusSpecularStrength = 1 - specularBrightness;
+    const diffuseBrightness = Math.max(_diffuseScratch[0], _diffuseScratch[1], _diffuseScratch[2]);
+    const metallic = solveMetallic(diffuseBrightness, specularBrightness, oneMinusSpecularStrength);
+    // baseColor: blend the dielectric diffuse estimate and the specular tint by metallic, per the
+    // reference converter, then re-pack to RGBA8 for the standard block to decode.
+    const denom = Math.max(1 - DIELECTRIC_SPECULAR, 1e-4);
+    const r = lerp((_diffuseScratch[0] * oneMinusSpecularStrength) / denom, _specularScratch[0], metallic);
+    const g = lerp((_diffuseScratch[1] * oneMinusSpecularStrength) / denom, _specularScratch[1], metallic);
+    const b = lerp((_diffuseScratch[2] * oneMinusSpecularStrength) / denom, _specularScratch[2], metallic);
+    return {
+        alphaMap: null,
+        baseColor: packLinearRgba(r, g, b, _diffuseScratch[3]),
+        baseColorMap: material.diffuseMap,
+        emissive: material.emissive,
+        emissiveMap: material.emissiveMap,
+        emissiveStrength: material.emissiveStrength,
+        metallic,
+        metallicRoughnessMap: null,
+        normalMap: material.normalMap,
+        normalScale: material.normalScale,
+        occlusionMap: material.occlusionMap,
+        occlusionStrength: material.occlusionStrength,
+        roughness: 1 - material.glossiness,
+    };
+}
+function lerp(a, b, t) {
+    return a + (b - a) * t;
+}
+// Re-encodes a linear RGBA color (components in [0,1]) back to a packed 0xRRGGBBAA integer with the
+// sRgb transfer, the inverse of unpackColorToLinear, so the standard block's CPU decode round-trips.
+function packLinearRgba(r, g, b, a) {
+    const toByte = (linear) => {
+        const clamped = Math.min(Math.max(linear, 0), 1);
+        const srgb = clamped <= 0.0031308 ? clamped * 12.92 : 1.055 * Math.pow(clamped, 1 / 2.4) - 0.055;
+        return Math.round(srgb * 255) & 0xff;
+    };
+    const alpha = Math.round(Math.min(Math.max(a, 0), 1) * 255) & 0xff;
+    return ((toByte(r) << 24) | (toByte(g) << 16) | (toByte(b) << 8) | alpha) >>> 0;
+}
+// The Khronos spec-gloss → metallic solver: recovers the metallic factor from the diffuse and specular
+// reflectances by solving the quadratic that the metallic-roughness F0 model implies. Below the 0.04
+// dielectric floor the surface is fully dielectric (metallic 0).
+function solveMetallic(diffuse, specular, oneMinusSpecularStrength) {
+    if (specular < DIELECTRIC_SPECULAR)
+        return 0;
+    const a = DIELECTRIC_SPECULAR;
+    const b = (diffuse * oneMinusSpecularStrength) / (1 - DIELECTRIC_SPECULAR) + specular - 2 * DIELECTRIC_SPECULAR;
+    const c = DIELECTRIC_SPECULAR - specular;
+    const discriminant = Math.max(b * b - 4 * a * c, 0);
+    return Math.min(Math.max((-b + Math.sqrt(discriminant)) / (2 * a), 0), 1);
+}
+const DIELECTRIC_SPECULAR = 0.04;
+const FALLBACK_MATERIAL = {};
+const _diffuseScratch = [0, 0, 0, 0];
+const _specularScratch = [0, 0, 0, 0];
+//# sourceMappingURL=specularGlossinessPbrWgpuMeshMaterialRenderer.js.map

package/dist/specularGlossinessPbrWgpuMeshMaterialRenderer.js.map

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

package/dist/specularPbrWgpuMeshMaterialRenderer.d.ts

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

package/dist/specularPbrWgpuMeshMaterialRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specularPbrWgpuMeshMaterialRenderer.d.ts","sourceRoot":"","sources":["../src/specularPbrWgpuMeshMaterialRenderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAQV,wBAAwB,EACxB,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAyBzB,eAAO,MAAM,mCAAmC,EAAE,wBA6CjD,CAAC;AAIF,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAE5E"}

package/dist/specularPbrWgpuMeshMaterialRenderer.js

@@ -0,0 +1,65 @@
+import { unpackColorToLinear } from '@flighthq/color';
+import { getWgpuRenderStateRuntime } from '@flighthq/render-wgpu';
+import { SpecularPbrMaterialKind } from '@flighthq/types';
+import { buildWgpuPbrStandardDefineKey, ensureWgpuPbrMaterialBindGroup, getWgpuPbrMaterialScratch, writeWgpuPbrMaterialUniform, writeWgpuPbrStandardBlock, } from './standardPbrWgpuMeshMaterialRenderer';
+import { registerWgpuMeshMaterialRenderer } from './wgpuMeshMaterialRegistry';
+import { beginWgpuMeshDraw, drawWgpuMeshSubset, writeWgpuFrameUniform } from './wgpuMeshPipeline';
+import { ensureWgpuPbrPipeline } from './wgpuPbrPipelineCache';
+// The built-in Specular (KHR_materials_specular) forward-lit mesh-material renderer — the WGSL mirror
+// of specularPbrGlMeshMaterialRenderer. This extension gives independent control of a dielectric's
+// specular reflection: `specular` scales the base reflectance and `specularColor` tints F0, letting a
+// surface be more or less reflective than the fixed 0.04 dielectric default without changing its diffuse
+// albedo (metals keep their albedo-tinted F0). The shader recomputes F0 = mix(min(0.04 * specularColor,
+// 1) * specular, albedo, metallic) behind `const SPECULAR_EXT`. bind builds the standard define key from
+// `material.standard` + the surface trailer, sets the SPECULAR_EXT flag, selects/compiles that pipeline
+// variant for the current color format, writes the shared Frame uniform, then writes the base block +
+// the specular scale / linear-decoded specularColor into the one MaterialBlock uniform and binds it at
+// group(2). The specular strength/color maps are reserved but NOT sampled on wgpu yet (maps deferred).
+// See registerSpecularPbrWgpuMaterial.
+export const specularPbrWgpuMeshMaterialRenderer = {
+    bind(state, material, lights, camera) {
+        const stateRuntime = getWgpuRenderStateRuntime(state);
+        const pass = stateRuntime.renderPass;
+        if (pass === null)
+            return;
+        const specular = material;
+        const standard = specular !== null ? specular.standard : null;
+        const key = buildWgpuPbrStandardDefineKey(standard, specular);
+        key.specularEnabled = true;
+        const format = stateRuntime.currentColorFormat ?? state.format;
+        const pipeline = ensureWgpuPbrPipeline(state, key, format);
+        writeWgpuFrameUniform(state, camera, lights);
+        const binding = ensureWgpuPbrMaterialBindGroup(state, pipeline, specular ?? FALLBACK_MATERIAL, standard);
+        const out = getWgpuPbrMaterialScratch();
+        writeWgpuPbrStandardBlock(out, standard, specular !== null ? specular.alphaCutoff : 0.5);
+        out.fill(0, 16);
+        // specular group (floats 32..35): specular scale, specularColor.rgb (linear).
+        if (specular !== null) {
+            unpackColorToLinear(_colorScratch, specular.specularColor);
+            out[32] = specular.specular;
+            out[33] = _colorScratch[0];
+            out[34] = _colorScratch[1];
+            out[35] = _colorScratch[2];
+        }
+        else {
+            out[32] = 1;
+            out[33] = 1;
+            out[34] = 1;
+            out[35] = 1;
+        }
+        writeWgpuPbrMaterialUniform(state, binding);
+        beginWgpuMeshDraw(state, pipeline);
+        pass.setBindGroup(2, binding.bindGroup);
+    },
+    draw(state, proxy, geometry) {
+        drawWgpuMeshSubset(state, proxy, geometry);
+    },
+};
+// Installs the built-in Specular renderer for SpecularPbrMaterialKind on this state. Opt-in (no
+// top-level side effect): drawScene3D only draws Specular subsets once this is called.
+export function registerSpecularPbrWgpuMaterial(state) {
+    registerWgpuMeshMaterialRenderer(state, SpecularPbrMaterialKind, specularPbrWgpuMeshMaterialRenderer);
+}
+const FALLBACK_MATERIAL = {};
+const _colorScratch = [0, 0, 0, 0];
+//# sourceMappingURL=specularPbrWgpuMeshMaterialRenderer.js.map

package/dist/specularPbrWgpuMeshMaterialRenderer.js.map

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

package/dist/standardPbrWgpuMeshMaterialRenderer.d.ts

@@ -0,0 +1,9 @@
+import type { StandardPbrMaterialProperties, SurfaceMaterial, WgpuMeshMaterialRenderer, WgpuRenderState, WgpuPbrPipeline, WgpuPbrDefineKey, WgpuMaterialBinding } from '@flighthq/types';
+export declare const WGPU_PBR_MATERIAL_UNIFORM_FLOATS = 48;
+export declare function buildWgpuPbrStandardDefineKey(standard: Readonly<StandardPbrMaterialProperties> | null, surface: Readonly<SurfaceMaterial> | null): WgpuPbrDefineKey;
+export declare function ensureWgpuPbrMaterialBindGroup(state: WgpuRenderState, pipeline: Readonly<WgpuPbrPipeline>, key: object, standard: Readonly<StandardPbrMaterialProperties> | null): WgpuMaterialBinding;
+export declare function getWgpuPbrMaterialScratch(): Float32Array;
+export declare function writeWgpuPbrMaterialUniform(state: WgpuRenderState, binding: Readonly<WgpuMaterialBinding>): void;
+export declare function writeWgpuPbrStandardBlock(out: Float32Array, standard: Readonly<StandardPbrMaterialProperties> | null, alphaCutoff: number): void;
+export declare const standardPbrWgpuMeshMaterialRenderer: WgpuMeshMaterialRenderer;
+//# sourceMappingURL=standardPbrWgpuMeshMaterialRenderer.d.ts.map

package/dist/standardPbrWgpuMeshMaterialRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standardPbrWgpuMeshMaterialRenderer.d.ts","sourceRoot":"","sources":["../src/standardPbrWgpuMeshMaterialRenderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAQV,6BAA6B,EAC7B,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAiBzB,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAQnD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAAG,IAAI,EACxD,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,GACxC,gBAAgB,CAoBlB;AAWD,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAAG,IAAI,GACvD,mBAAmB,CA8BrB;AAMD,wBAAgB,yBAAyB,IAAI,YAAY,CAExD;AAID,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAEhH;AAQD,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAAG,IAAI,EACxD,WAAW,EAAE,MAAM,GAClB,IAAI,CA2CN;AAkBD,eAAO,MAAM,mCAAmC,EAAE,wBA4BjD,CAAC"}

package/dist/standardPbrWgpuMeshMaterialRenderer.js

@@ -0,0 +1,174 @@
+import { unpackColorToLinear } from '@flighthq/color';
+import { getWgpuRenderStateRuntime } from '@flighthq/render-wgpu';
+import { beginWgpuMeshDraw, drawWgpuMeshSubset, ensureWgpuPerMapMaterialBinding, getWgpuMaterialSampler, isWgpuTextureReady, resolveWgpuMaterialTextureView, stashWgpuUvTransform, writeWgpuFrameUniform, } from './wgpuMeshPipeline';
+import { ensureWgpuPbrPipeline } from './wgpuPbrPipelineCache';
+// The Material uniform float count (MaterialBlock = 48 floats / 192 bytes). Exported so the extension
+// renderers, which write extension factors into the shared scratch through the helpers here, agree on
+// the buffer size when they allocate + write their material bind groups.
+export const WGPU_PBR_MATERIAL_UNIFORM_FLOATS = 48;
+// The shared define key for a PBR material: the alpha-mask cutoff + double-sidedness from the surface
+// trailer, the five standard `has*Map` flags derived from the material's bound maps, and every extension
+// flag false. StandardPbr passes its own properties (it is a StandardPbrMaterialProperties) as `standard`;
+// each extension renderer passes its `material.standard` + surface trailer and then sets exactly one
+// extension flag. Keeps the one place that decides the standard flags so the compiled variant and the
+// bound resources never disagree. Mirrors scene-gl's buildGlPbrStandardDefineKey.
+export function buildWgpuPbrStandardDefineKey(standard, surface) {
+    return {
+        alphaMaskEnabled: surface !== null && surface.alphaMode === 'mask',
+        anisotropyEnabled: false,
+        clearcoatEnabled: false,
+        doubleSided: surface !== null && surface.doubleSided,
+        // Opaque materials ignore coverage (SurfaceMaterial contract) — only 'mask'/'blend' sample the map.
+        hasAlphaMap: surface !== null && surface.alphaMode !== 'opaque' && standard !== null && isWgpuTextureReady(standard.alphaMap),
+        hasBaseColorMap: standard !== null && isWgpuTextureReady(standard.baseColorMap),
+        hasEmissiveMap: standard !== null && isWgpuTextureReady(standard.emissiveMap),
+        hasMetallicRoughnessMap: standard !== null && isWgpuTextureReady(standard.metallicRoughnessMap),
+        hasNormalMap: standard !== null && isWgpuTextureReady(standard.normalMap),
+        hasOcclusionMap: standard !== null && isWgpuTextureReady(standard.occlusionMap),
+        iridescenceEnabled: false,
+        sheenEnabled: false,
+        specularEnabled: false,
+        subsurfaceEnabled: false,
+        transmissionEnabled: false,
+    };
+}
+// Allocates (once per material reference) the Material uniform buffer + bind group for a PBR material
+// and binds the material's five standard maps (base color, metallic-roughness, normal, occlusion,
+// emissive) into the map slots — each resolved to its real uploaded view, or the shared 1x1 placeholder
+// when the slot is unbound, so the layout is satisfied either way. The same path serves StandardPbr and
+// every extension — the extension factors ride in the one MaterialBlock uniform, so no extra bindings
+// are needed. The caller writes `material` (a fresh per-call key for the WeakMap, or the FALLBACK key
+// for a null material) into the scratch and uploads it before this returns. The bind group is cached by
+// `key`; the resolved views are captured at creation, so a static textured material binds its maps once.
+// Returns the bind group to set at group(2).
+export function ensureWgpuPbrMaterialBindGroup(state, pipeline, key, standard) {
+    const baseColorMap = standard !== null ? standard.baseColorMap : null;
+    // Re-resolve the primary (base-color) sampler + the six standard-block map views every bind (base-color,
+    // metallic-roughness, normal, occlusion, emissive, alpha) into a REUSED module scratch — no per-bind
+    // allocation — so ensureWgpuPerMapMaterialBinding can rebuild the bind group only when one differs.
+    // Each view is paired with its own cached sampler, matching GL's per-Texture sampler contract.
+    _samplerScratch[0] = getWgpuMaterialSampler(state, baseColorMap);
+    _samplerScratch[1] = getWgpuMaterialSampler(state, standard !== null ? standard.metallicRoughnessMap : null);
+    _samplerScratch[2] = getWgpuMaterialSampler(state, standard !== null ? standard.normalMap : null);
+    _samplerScratch[3] = getWgpuMaterialSampler(state, standard !== null ? standard.occlusionMap : null);
+    _samplerScratch[4] = getWgpuMaterialSampler(state, standard !== null ? standard.emissiveMap : null);
+    _samplerScratch[5] = getWgpuMaterialSampler(state, standard !== null ? standard.alphaMap : null);
+    _viewScratch[0] = resolveWgpuMaterialTextureView(state, baseColorMap);
+    _viewScratch[1] = resolveWgpuMaterialTextureView(state, standard !== null ? standard.metallicRoughnessMap : null);
+    _viewScratch[2] = resolveWgpuMaterialTextureView(state, standard !== null ? standard.normalMap : null);
+    _viewScratch[3] = resolveWgpuMaterialTextureView(state, standard !== null ? standard.occlusionMap : null);
+    _viewScratch[4] = resolveWgpuMaterialTextureView(state, standard !== null ? standard.emissiveMap : null);
+    _viewScratch[5] = resolveWgpuMaterialTextureView(state, standard !== null ? standard.alphaMap : null);
+    const binding = ensureWgpuPerMapMaterialBinding(state, key, pipeline.materialBindGroupLayout, WGPU_PBR_MATERIAL_UNIFORM_FLOATS * 4, _samplerScratch, _viewScratch);
+    // The base-color map's uv transform drives the shared vertex-scene2d uv every standard map samples.
+    // Runs every bind (standard + each extension routes through here), so the stash is always fresh.
+    stashWgpuUvTransform(state, standard !== null ? standard.baseColorMap : null);
+    return binding;
+}
+// Returns the shared MaterialBlock scratch the standard + extension packers write into. The extension
+// renderers fill the base block via writeWgpuPbrStandardBlock and their own factors via index into the
+// returned array, then upload it. Reused across binds (bind is not a hot inner loop, and one draw is
+// recorded before the next bind overwrites it).
+export function getWgpuPbrMaterialScratch() {
+    return _materialScratch;
+}
+// Writes the MaterialBlock scratch (192 bytes) into a material binding's uniform buffer. Call after
+// writeWgpuPbrStandardBlock + any extension packer has filled the scratch.
+export function writeWgpuPbrMaterialUniform(state, binding) {
+    state.device.queue.writeBuffer(binding.buffer, 0, _materialScratch.buffer, 0, WGPU_PBR_MATERIAL_UNIFORM_FLOATS * 4);
+}
+// Packs the StandardPbr base block (the first 16 floats of the MaterialBlock) into the shared material
+// scratch: baseColor.rgba (linear), emissive.rgb*strength, factors (metallic, roughness, normalScale,
+// occlusionStrength), flags (alphaCutoff, _, _, _). baseColor/emissive are sRgb-packed and converted to
+// linear here so the shader stays in linear space. The extension factor slots (floats 16..47) are left
+// to the caller (the extension packers) or zeroed by writeWgpuPbrMaterialBlock for StandardPbr. A null
+// block uses neutral defaults (white, dielectric, fully rough). Mirrors scene-gl's bindGlPbrStandardBlock.
+export function writeWgpuPbrStandardBlock(out, standard, alphaCutoff) {
+    if (standard === null) {
+        out[0] = 1;
+        out[1] = 1;
+        out[2] = 1;
+        out[3] = 1;
+        out[4] = 0;
+        out[5] = 0;
+        out[6] = 0;
+        out[7] = 0;
+        out[8] = 0;
+        out[9] = 1;
+        out[10] = 1;
+        out[11] = 1;
+        out[12] = alphaCutoff;
+        out[13] = 0;
+        out[14] = 0;
+        out[15] = 0;
+        return;
+    }
+    unpackColorToLinear(_colorScratch, standard.baseColor);
+    out[0] = _colorScratch[0];
+    out[1] = _colorScratch[1];
+    out[2] = _colorScratch[2];
+    out[3] = _colorScratch[3];
+    unpackColorToLinear(_colorScratch, standard.emissive);
+    const strength = standard.emissiveStrength;
+    out[4] = _colorScratch[0] * strength;
+    out[5] = _colorScratch[1] * strength;
+    out[6] = _colorScratch[2] * strength;
+    out[7] = 0;
+    out[8] = standard.metallic;
+    out[9] = standard.roughness;
+    out[10] = standard.normalScale;
+    out[11] = standard.occlusionStrength;
+    out[12] = alphaCutoff;
+    out[13] = 0;
+    out[14] = 0;
+    out[15] = 0;
+}
+// The built-in StandardPbr forward-lit mesh-material renderer (WgpuMeshMaterialRenderer for
+// StandardPbrMaterialKind) — the WGSL mirror of standardPbrGlMeshMaterialRenderer. bind selects the
+// pipeline variant for the material's alpha mode / double-sidedness + the current color-attachment
+// format (no extension flag), writes the shared Frame uniform (camera view-projection + position, the
+// packed light block), binds the pipeline + Frame bind group (beginWgpuMeshDraw), then writes + binds
+// the material's uniform/texture bind group at group(2). draw uploads the geometry's GPU buffers lazily
+// (cached by geometry.version), writes the per-draw model + normal matrices into the render-state's
+// uniform ring buffer (group(1), dynamic offset), and issues the indexed draw over the proxy's subset.
+// Depth-test LESS + depth-write on and back-face culling (unless double-sided) are baked on the
+// pipeline. The five standard maps (base color, metallic-roughness, normal, occlusion, emissive) are
+// sampled when bound — the textured pipeline variant compiles per the `has*Map` flags and the real
+// uploaded views bind into the map slots; an unbound slot falls back to the placeholder. See
+// registerStandardPbrWgpuMaterial to install it.
+//
+// Cannot be visually captured in JSDOM (no GPU adapter); the unit test asserts the pipeline/bind/draw
+// call shape against the mock device, mirrored against the verified GL result.
+export const standardPbrWgpuMeshMaterialRenderer = {
+    bind(state, material, lights, camera) {
+        const stateRuntime = getWgpuRenderStateRuntime(state);
+        const pass = stateRuntime.renderPass;
+        if (pass === null)
+            return;
+        const pbr = material;
+        const format = stateRuntime.currentColorFormat ?? state.format;
+        const pipeline = ensureWgpuPbrPipeline(state, buildWgpuPbrStandardDefineKey(pbr, pbr), format);
+        writeWgpuFrameUniform(state, camera, lights);
+        const binding = ensureWgpuPbrMaterialBindGroup(state, pipeline, pbr ?? FALLBACK_MATERIAL, pbr);
+        writeWgpuPbrStandardBlock(_materialScratch, pbr, pbr !== null ? pbr.alphaCutoff : 0.5);
+        _materialScratch.fill(0, 16);
+        writeWgpuPbrMaterialUniform(state, binding);
+        beginWgpuMeshDraw(state, pipeline);
+        pass.setBindGroup(2, binding.bindGroup);
+    },
+    draw(state, proxy, geometry) {
+        drawWgpuMeshSubset(state, proxy, geometry);
+    },
+};
+// A StandardPbrMaterial-shaped stand-in used as the material-bind-group cache key when bind is called
+// with a null material (the DefaultMaterialKind fallback). Plain neutral PBR defaults; only used for
+// identity in the WeakMap.
+const FALLBACK_MATERIAL = {};
+const _colorScratch = [0, 0, 0, 0];
+const _materialScratch = new Float32Array(WGPU_PBR_MATERIAL_UNIFORM_FLOATS);
+const _samplerScratch = new Array(6);
+// Reused per-bind resolved-view scratch (base-color, metallic-roughness, normal, occlusion, emissive,
+// alpha) so a steady-state re-bind allocates nothing; ensureWgpuPerMapMaterialBinding copies it only on
+// create/rebuild.
+const _viewScratch = new Array(6);
+//# sourceMappingURL=standardPbrWgpuMeshMaterialRenderer.js.map

package/dist/standardPbrWgpuMeshMaterialRenderer.js.map

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

package/dist/subsurfacePbrWgpuMeshMaterialRenderer.d.ts

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

package/dist/subsurfacePbrWgpuMeshMaterialRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subsurfacePbrWgpuMeshMaterialRenderer.d.ts","sourceRoot":"","sources":["../src/subsurfacePbrWgpuMeshMaterialRenderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAQV,wBAAwB,EACxB,eAAe,EAChB,MAAM,iBAAiB,CAAC;AA0BzB,eAAO,MAAM,qCAAqC,EAAE,wBA+CnD,CAAC;AAIF,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAE9E"}

package/dist/subsurfacePbrWgpuMeshMaterialRenderer.js

@@ -0,0 +1,68 @@
+import { unpackColorToLinear } from '@flighthq/color';
+import { getWgpuRenderStateRuntime } from '@flighthq/render-wgpu';
+import { SubsurfacePbrMaterialKind } from '@flighthq/types';
+import { buildWgpuPbrStandardDefineKey, ensureWgpuPbrMaterialBindGroup, getWgpuPbrMaterialScratch, writeWgpuPbrMaterialUniform, writeWgpuPbrStandardBlock, } from './standardPbrWgpuMeshMaterialRenderer';
+import { registerWgpuMeshMaterialRenderer } from './wgpuMeshMaterialRegistry';
+import { beginWgpuMeshDraw, drawWgpuMeshSubset, writeWgpuFrameUniform } from './wgpuMeshPipeline';
+import { ensureWgpuPbrPipeline } from './wgpuPbrPipelineCache';
+// The built-in Subsurface forward-lit mesh-material renderer (Flight extension; flagged non-interop —
+// there is no glTF equivalent) — the WGSL mirror of subsurfacePbrGlMeshMaterialRenderer. It
+// approximates subsurface scattering with a wrapped-diffuse term: light wrapping past the terminator
+// re-emerges tinted by `subsurfaceColor`, scaled by `subsurface` strength and inversely by `thickness`
+// (thinner material = more translucency). This is a cheap stand-in for true diffusion-profile SSS —
+// plausible for skin, wax, marble, foliage at forward-pass cost — and lives behind `const SUBSURFACE` in
+// the PBR uber-shader. bind builds the standard define key from `material.standard` + the surface
+// trailer, sets the SUBSURFACE flag, selects/compiles that pipeline variant for the current color
+// format, writes the shared Frame uniform, then writes the base block + the subsurface scalars /
+// linear-decoded subsurfaceColor into the one MaterialBlock uniform and binds it at group(2). The
+// subsurface/thickness maps are reserved but NOT sampled on wgpu yet (maps deferred). See
+// registerSubsurfacePbrWgpuMaterial.
+export const subsurfacePbrWgpuMeshMaterialRenderer = {
+    bind(state, material, lights, camera) {
+        const stateRuntime = getWgpuRenderStateRuntime(state);
+        const pass = stateRuntime.renderPass;
+        if (pass === null)
+            return;
+        const subsurface = material;
+        const standard = subsurface !== null ? subsurface.standard : null;
+        const key = buildWgpuPbrStandardDefineKey(standard, subsurface);
+        key.subsurfaceEnabled = true;
+        const format = stateRuntime.currentColorFormat ?? state.format;
+        const pipeline = ensureWgpuPbrPipeline(state, key, format);
+        writeWgpuFrameUniform(state, camera, lights);
+        const binding = ensureWgpuPbrMaterialBindGroup(state, pipeline, subsurface ?? FALLBACK_MATERIAL, standard);
+        const out = getWgpuPbrMaterialScratch();
+        writeWgpuPbrStandardBlock(out, standard, subsurface !== null ? subsurface.alphaCutoff : 0.5);
+        out.fill(0, 16);
+        // subsurface group (floats 36..39): strength, subsurfaceColor.rgb (linear); extra (float 40): thickness.
+        if (subsurface !== null) {
+            unpackColorToLinear(_colorScratch, subsurface.subsurfaceColor);
+            out[36] = subsurface.subsurface;
+            out[37] = _colorScratch[0];
+            out[38] = _colorScratch[1];
+            out[39] = _colorScratch[2];
+            out[40] = subsurface.thickness;
+        }
+        else {
+            out[36] = 0;
+            out[37] = 1;
+            out[38] = 1;
+            out[39] = 1;
+            out[40] = 0;
+        }
+        writeWgpuPbrMaterialUniform(state, binding);
+        beginWgpuMeshDraw(state, pipeline);
+        pass.setBindGroup(2, binding.bindGroup);
+    },
+    draw(state, proxy, geometry) {
+        drawWgpuMeshSubset(state, proxy, geometry);
+    },
+};
+// Installs the built-in Subsurface renderer for SubsurfacePbrMaterialKind on this state. Opt-in (no
+// top-level side effect): drawScene3D only draws Subsurface subsets once this is called.
+export function registerSubsurfacePbrWgpuMaterial(state) {
+    registerWgpuMeshMaterialRenderer(state, SubsurfacePbrMaterialKind, subsurfacePbrWgpuMeshMaterialRenderer);
+}
+const FALLBACK_MATERIAL = {};
+const _colorScratch = [0, 0, 0, 0];
+//# sourceMappingURL=subsurfacePbrWgpuMeshMaterialRenderer.js.map

package/dist/subsurfacePbrWgpuMeshMaterialRenderer.js.map

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

package/dist/toonWgpuMeshMaterialRenderer.d.ts

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

package/dist/toonWgpuMeshMaterialRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toonWgpuMeshMaterialRenderer.d.ts","sourceRoot":"","sources":["../src/toonWgpuMeshMaterialRenderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAQV,wBAAwB,EACxB,eAAe,EAEhB,MAAM,iBAAiB,CAAC;AA2BzB,eAAO,MAAM,4BAA4B,EAAE,wBA+B1C,CAAC;AAIF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAErE"}

package/dist/toonWgpuMeshMaterialRenderer.js

@@ -0,0 +1,71 @@
+import { unpackColorToLinear } from '@flighthq/color';
+import { getWgpuRenderStateRuntime } from '@flighthq/render-wgpu';
+import { ToonMaterialKind } from '@flighthq/types';
+import { registerWgpuMeshMaterialRenderer } from './wgpuMeshMaterialRegistry';
+import { beginWgpuMeshDraw, drawWgpuMeshSubset, writeWgpuFrameUniform } from './wgpuMeshPipeline';
+import { bindWgpuToonSurface, ensureWgpuToonPipeline } from './wgpuToonPrelude';
+// The built-in Toon (cel-shading) forward-lit mesh-material renderer (WgpuMeshMaterialRenderer for
+// ToonMaterialKind) — the WGSL mirror of toonGlMeshMaterialRenderer. bind selects the pipeline variant
+// for the material's alpha mode + double-sidedness + the current color-attachment format, writes the
+// shared Frame uniform (camera view-projection + position, the packed light block), binds the pipeline
+// + Frame bind group (beginWgpuMeshDraw), then writes + binds the material's uniform/texture bind group
+// (linear base color, step count, alpha cutoff) at group(2). The diffuse N·L is quantized into stepped
+// cel bands in the fragment scene2d (a stepped floor over `steps`); output is LINEAR color for the
+// rgba16float scene target. draw uploads the geometry's GPU buffers lazily (cached by geometry.version),
+// writes the per-draw model + normal matrices into the render-state's uniform ring buffer (group(1),
+// dynamic offset), and issues the indexed draw over the proxy's subset. Depth-test LESS + depth-write
+// on and back-face culling (unless double-sided) are baked on the pipeline. See registerToonWgpuMaterial
+// to install it.
+//
+// MAPS NOT SAMPLED YET: baseColorMap and ramp are not uploaded on wgpu, so the define key keeps
+// hasBaseColorMap / hasRamp false (placeholder textures bound, scalar `steps` quantizer used). This
+// mirrors the documented gap on the Unlit/StandardPbr wgpu paths — the GL Toon renderer samples both;
+// wgpu lights up the same shader branches once texture upload arrives. See wgpuToonPrelude.
+//
+// Cannot be visually captured in JSDOM (no GPU adapter); the unit test asserts the pipeline/bind/draw
+// call shape against the mock device, mirrored against the verified GL result.
+export const toonWgpuMeshMaterialRenderer = {
+    bind(state, material, lights, camera) {
+        const stateRuntime = getWgpuRenderStateRuntime(state);
+        const pass = stateRuntime.renderPass;
+        if (pass === null)
+            return;
+        const toon = material;
+        const format = stateRuntime.currentColorFormat ?? state.format;
+        const pipeline = ensureWgpuToonPipeline(state, defineKeyForMaterial(toon), format);
+        writeWgpuFrameUniform(state, camera, lights);
+        let group;
+        if (toon === null) {
+            group = bindWgpuToonSurface(state, pipeline, FALLBACK_MATERIAL, WHITE, 3, 0.5);
+        }
+        else {
+            unpackColorToLinear(_scratch, toon.baseColor);
+            group = bindWgpuToonSurface(state, pipeline, toon, _scratch, toon.steps, toon.alphaCutoff);
+        }
+        beginWgpuMeshDraw(state, pipeline);
+        pass.setBindGroup(2, group);
+    },
+    draw(state, proxy, geometry) {
+        drawWgpuMeshSubset(state, proxy, geometry);
+    },
+};
+// Registers the built-in Toon renderer for ToonMaterialKind on this state. Opt-in (no top-level side
+// effect); call once per WgpuRenderState before drawWgpuScene3D so meshes with ToonMaterials draw.
+export function registerToonWgpuMaterial(state) {
+    registerWgpuMeshMaterialRenderer(state, ToonMaterialKind, toonWgpuMeshMaterialRenderer);
+}
+// The feature define key for a Toon material: the alpha-mask cutoff and double-sidedness. The map flags
+// stay false on wgpu (texture upload not yet wired — see the renderer's maps note), so the quantizer is
+// always the scalar `steps` stepped floor and placeholder textures are bound.
+function defineKeyForMaterial(material) {
+    return {
+        alphaMaskEnabled: material !== null && material.alphaMode === 'mask',
+        doubleSided: material !== null && material.doubleSided,
+        hasBaseColorMap: false,
+        hasRamp: false,
+    };
+}
+const _scratch = [0, 0, 0, 0];
+const WHITE = [1, 1, 1, 1];
+const FALLBACK_MATERIAL = {};
+//# sourceMappingURL=toonWgpuMeshMaterialRenderer.js.map

package/dist/toonWgpuMeshMaterialRenderer.js.map

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

package/dist/transmissionVolumePbrWgpuMeshMaterialRenderer.d.ts

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

package/dist/transmissionVolumePbrWgpuMeshMaterialRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transmissionVolumePbrWgpuMeshMaterialRenderer.d.ts","sourceRoot":"","sources":["../src/transmissionVolumePbrWgpuMeshMaterialRenderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAQV,wBAAwB,EACxB,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAiCzB,eAAO,MAAM,6CAA6C,EAAE,wBA6C3D,CAAC;AAKF,wBAAgB,yCAAyC,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAMtF"}