@forgeax/engine-render 0.1.27 → 0.1.29

package/dist/assembly/webgpu-pbr-ready.d.ts

@@ -0,0 +1,38 @@
+import type { BindGroupLayout, PipelineLayout, Result, RhiDevice, ShaderModule } from '@forgeax/engine-rhi';
+import { type RhiError } from '@forgeax/engine-rhi';
+import type { MaterialShaderManifestEntry } from '@forgeax/engine-shader';
+import type { ManifestEntry } from '@forgeax/engine-types';
+import { type GpuDrivenPbrProgram } from '../gpu-driven/pbr-program';
+import { type PbrPipelineLayoutBundle } from '../pbr-pipeline';
+export type AsyncCreateShaderModule = (device: RhiDevice, desc: {
+    code: string;
+    label?: string | undefined;
+}) => Promise<Result<ShaderModule, RhiError>>;
+export interface GpuDrivenPbrReadyModules {
+    readonly pbrSkinModule: ShaderModule | null;
+    readonly gpuDrivenPbrPrograms: ReadonlyMap<string, GpuDrivenPbrProgram>;
+}
+export interface GpuDrivenPbrReadyLayouts {
+    readonly pbrSkinPipelineLayout: PipelineLayout | null;
+    readonly pbrSkinProbePipelineLayout: PipelineLayout | null;
+    readonly pbrSkinMeshBindGroupLayout: BindGroupLayout | null;
+    readonly gpuDrivenInstancesBindGroupLayout: BindGroupLayout | null;
+    readonly gpuDrivenPbrPipelineLayout: PipelineLayout | null;
+    readonly gpuDrivenPbrSkinPipelineLayout: PipelineLayout | null;
+}
+interface GpuDrivenPbrModuleInput {
+    readonly device: RhiDevice;
+    readonly storageBufferCapable: boolean;
+    readonly asyncCreateShaderModule: AsyncCreateShaderModule | undefined;
+    readonly pbrSkinEntry: ManifestEntry | undefined;
+    readonly pbrManifestEntry: MaterialShaderManifestEntry | undefined;
+    readonly pbrSkinManifestEntry: MaterialShaderManifestEntry | undefined;
+    readonly extendedLightingShaderAvailable: boolean;
+    readonly directionalPcssAvailable: boolean;
+    readonly projectorAvailable: boolean;
+    readonly seedShaderModule: (label: string, module: ShaderModule) => void;
+}
+export declare function buildGpuDrivenPbrReadyModules(input: GpuDrivenPbrModuleInput): Promise<GpuDrivenPbrReadyModules>;
+export declare function buildGpuDrivenPbrReadyLayouts(device: RhiDevice, storageBufferCapable: boolean, pbrLayouts: PbrPipelineLayoutBundle): GpuDrivenPbrReadyLayouts;
+export {};
+//# sourceMappingURL=webgpu-pbr-ready.d.ts.map

package/dist/assembly/webgpu-pbr-ready.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpu-pbr-ready.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-pbr-ready.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,MAAM,EACN,SAAS,EACT,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAM,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,KAAK,mBAAmB,EAAyB,MAAM,2BAA2B,CAAC;AAE5F,OAAO,EAKL,KAAK,uBAAuB,EAE7B,MAAM,iBAAiB,CAAC;AASzB,MAAM,MAAM,uBAAuB,GAAG,CACpC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KAC/C,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE7C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,qBAAqB,EAAE,cAAc,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,0BAA0B,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,0BAA0B,EAAE,eAAe,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,iCAAiC,EAAE,eAAe,GAAG,IAAI,CAAC;IACnE,QAAQ,CAAC,0BAA0B,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,8BAA8B,EAAE,cAAc,GAAG,IAAI,CAAC;CAChE;AAED,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,uBAAuB,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,YAAY,EAAE,aAAa,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,2BAA2B,GAAG,SAAS,CAAC;IACnE,QAAQ,CAAC,oBAAoB,EAAE,2BAA2B,GAAG,SAAS,CAAC;IACvE,QAAQ,CAAC,+BAA+B,EAAE,OAAO,CAAC;IAClD,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CAC1E;AAYD,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CAoGnC;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,OAAO,EAC7B,UAAU,EAAE,uBAAuB,GAClC,wBAAwB,CAqD1B"}

package/dist/assembly/webgpu-ready-mipmap.d.ts

@@ -0,0 +1,11 @@
+import type { MipmapShaderModuleFactory } from '@forgeax/engine-assets-runtime';
+import type { RhiDevice } from '@forgeax/engine-rhi';
+import type { GpuResidencyCache } from '../device/gpu-residency';
+import type { RhiBackendPack } from './backend-contract';
+export declare function adaptMipmapShaderModuleFactory(factory: RhiBackendPack['createShaderModule']): MipmapShaderModuleFactory | undefined;
+/**
+ * Prewarm the mipmap pipeline while the renderer is still on its async ready
+ * path. A manifest-free camera-only renderer must not create the shader.
+ */
+export declare function prewarmMipmapPipeline(rhiDevice: RhiDevice, gpuStore: GpuResidencyCache, hasMaterialManifest: boolean): Promise<void>;
+//# sourceMappingURL=webgpu-ready-mipmap.d.ts.map

package/dist/assembly/webgpu-ready-mipmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpu-ready-mipmap.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-ready-mipmap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,cAAc,CAAC,oBAAoB,CAAC,GAC5C,yBAAyB,GAAG,SAAS,CAGvC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,iBAAiB,EAC3B,mBAAmB,EAAE,OAAO,GAC3B,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/assembly/webgpu-ready.d.ts

@@ -5,7 +5,7 @@ export type { MaterialShaderManifestEntry } from '@forgeax/engine-shader';
 import type { GpuResidencyCache } from '../device/gpu-residency';
 import type { DeviceScope, RhiErrorListenerRegistry } from '../lifecycle';
 import { type PipelineGroup2Contract } from '../pbr-pipeline';
-import { type VolumetricFogShaderSources } from '../render-contract';
+import { type AtmosphereShaderSources, type SsrShaderSources, type VolumetricFogShaderSources } from '../render-contract';
 import { type PipelineState } from '../render-system';
 import { type MeshSsboGrowResult, type MeshSsboState } from './mesh-ssbo-grow';
 /**
@@ -39,7 +39,7 @@ export declare function buildReadyWebGPU(rhiDevice: RhiDevice, rendererScope: De
  * during Renderer.initialization so prepared graphics do not fail on their first
  * frame while the shared async shader adapter is still warming up.
  */
-requiredMaterialShaders: readonly string[], 
+requiredMaterialShaders: readonly string[], standardPbrShaderUvSetCount: number, 
 /** Fullscreen feature modules compiled before the first synchronous frame. */
 requiredFullscreenPostProcesses: readonly {
     readonly identity: string;
@@ -51,5 +51,9 @@ registerBuiltinFxaa: (source: string) => void, registerBuiltinTemporalPostProces
     readonly taaResolve?: string;
 }) => void, 
 /** Install manifest-owned volume utility sources only after all four modules compile. */
-setVolumetricFogShaderSources: (sources: VolumetricFogShaderSources) => void): Promise<PipelineState>;
+setVolumetricFogShaderSources: (sources: VolumetricFogShaderSources) => void, 
+/** Install manifest-owned SSR utility sources only after all five modules compile. */
+setSsrShaderSources: (sources: SsrShaderSources) => void, 
+/** Install manifest-owned atmosphere utility sources only after both modules compile. */
+setAtmosphereShaderSources: (sources: AtmosphereShaderSources) => void): Promise<PipelineState>;
 //# sourceMappingURL=webgpu-ready.d.ts.map

package/dist/assembly/webgpu-ready.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgpu-ready.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-ready.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAKV,cAAc,EACd,MAAM,EACN,SAAS,EAET,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAM,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI9E,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,yBAAyB,CAAC;AAwBjF,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAIL,KAAK,sBAAsB,EAE5B,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAkB1B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,WAAW,EAC1B,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,EAAE,iBAAiB,EAC3B,uBAAuB,EACnB,CAAC,CACC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KAC/C,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,GAC7C,SAAS,EACb,aAAa,EAAE,wBAAwB;AACvC;;;;GAIG;AACH,uBAAuB,EAAE,SAAS,MAAM,EAAE;AAC1C,8EAA8E;AAC9E,+BAA+B,EAAE,SAAS;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,EAAE,EAUH,mBAAmB,EAAE,CACnB,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,kBAAkB,EACjD,KAAK,EAAE,aAAa,KACjB,IAAI,EAQT,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,EAQ/D,+BAA+B,EAAE,CAC/B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,sBAAsB,KACnC,IAAI,EAST,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI;AAChD,sEAAsE;AACtE,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAC7C,oCAAoC,EAAE,CAAC,OAAO,EAAE;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAK,IAAI;AACV,yFAAyF;AACzF,6BAA6B,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,IAAI,GAC3E,OAAO,CAAC,aAAa,CAAC,CAwwHxB"}
+{"version":3,"file":"webgpu-ready.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-ready.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAKV,cAAc,EACd,MAAM,EACN,SAAS,EAET,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAM,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAM9E,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,yBAAyB,CAAC;AAwBjF,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,EAGL,KAAK,sBAAsB,EAG5B,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EAErB,KAAK,0BAA0B,EAChC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAmB1B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,WAAW,EAC1B,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,EAAE,iBAAiB,EAC3B,uBAAuB,EACnB,CAAC,CACC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KAC/C,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,GAC7C,SAAS,EACb,aAAa,EAAE,wBAAwB;AACvC;;;;GAIG;AACH,uBAAuB,EAAE,SAAS,MAAM,EAAE,EAC1C,2BAA2B,EAAE,MAAM;AACnC,8EAA8E;AAC9E,+BAA+B,EAAE,SAAS;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,EAAE,EAUH,mBAAmB,EAAE,CACnB,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,kBAAkB,EACjD,KAAK,EAAE,aAAa,KACjB,IAAI,EAQT,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,EAQ/D,+BAA+B,EAAE,CAC/B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,sBAAsB,KACnC,IAAI,EAST,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI;AAChD,sEAAsE;AACtE,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAC7C,oCAAoC,EAAE,CAAC,OAAO,EAAE;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAK,IAAI;AACV,yFAAyF;AACzF,6BAA6B,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,IAAI;AAC5E,sFAAsF;AACtF,mBAAmB,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI;AACxD,yFAAyF;AACzF,0BAA0B,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,GACrE,OAAO,CAAC,aAAa,CAAC,CAixHxB"}

package/dist/assembly/webgpu-renderer-bootstrap.d.ts

@@ -0,0 +1,10 @@
+import type { RendererOptions } from '../render-contract';
+import type { RhiBackendPack } from './backend-contract';
+import type { BundlerOptions } from './bundler-contract';
+import type { RendererAssemblyImplementation } from './host-contract';
+import type { WebGPUOutcome, WebGPURendererInternals } from './webgpu-renderer-contract';
+export type { WebGPUOutcome, WebGPURendererInternals } from './webgpu-renderer-contract';
+export type WebGPURendererFactory = (internals: WebGPURendererInternals) => Promise<RendererAssemblyImplementation>;
+/** Acquire the selected backend and build one renderer generation. */
+export declare function tryCreateWebGPURenderer(canvas: HTMLCanvasElement | OffscreenCanvas, options: RendererOptions | undefined, pack: RhiBackendPack, bundler: BundlerOptions | undefined, createRenderer: WebGPURendererFactory): Promise<WebGPUOutcome>;
+//# sourceMappingURL=webgpu-renderer-bootstrap.d.ts.map

package/dist/assembly/webgpu-renderer-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpu-renderer-bootstrap.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-renderer-bootstrap.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAEzF,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAEzF,MAAM,MAAM,qBAAqB,GAAG,CAClC,SAAS,EAAE,uBAAuB,KAC/B,OAAO,CAAC,8BAA8B,CAAC,CAAC;AAE7C,sEAAsE;AACtE,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,iBAAiB,GAAG,eAAe,EAC3C,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,cAAc,EAAE,qBAAqB,GACpC,OAAO,CAAC,aAAa,CAAC,CAyDxB"}

package/dist/assembly/webgpu-renderer-contract.d.ts

@@ -0,0 +1,62 @@
+import type { RhiCanvasContext, RhiDevice, RhiError } from '@forgeax/engine-rhi';
+import type { ImportTransport } from '@forgeax/engine-types';
+import type { RenderFeatureHost } from '../features/host';
+import type { HealthListenerRegistry, LostListenerRegistry, RhiErrorListenerRegistry } from '../lifecycle';
+import type { GpuPassTimingReason } from '../record/gpu-pass-timing/errors.js';
+import type { GpuPassTimingCapture, GpuPassTimingFrameIdentity } from '../record/gpu-pass-timing/index.js';
+import type { AtmosphereShaderSources, FrameObservationDomain, RenderDebugOverlay, RendererOptions, SsrShaderSources, VolumetricFogShaderSources } from '../render-contract';
+import type { TypedFrameObservationCapture } from '../typed-render-graph-primitives';
+import type { RhiBackendPack } from './backend-contract';
+import type { BundlerOptions } from './bundler-contract';
+import type { RendererAssemblyImplementation } from './host-contract';
+import type { MeshSsboGrowResult, MeshSsboState } from './mesh-ssbo-grow';
+export type WebGPUOutcome = {
+    kind: 'ok';
+    renderer: RendererAssemblyImplementation;
+} | {
+    kind: 'rhi-err';
+    error: RhiError;
+} | {
+    kind: 'throw';
+    error: Error;
+};
+export interface WebGPURendererInternals {
+    canvas: HTMLCanvasElement | OffscreenCanvas;
+    device: RhiDevice;
+    context: RhiCanvasContext;
+    options: RendererOptions | undefined;
+    bundler: BundlerOptions | undefined;
+    lostRegistry: LostListenerRegistry;
+    errorRegistry: RhiErrorListenerRegistry;
+    healthRegistry: HealthListenerRegistry;
+    pack: RhiBackendPack;
+    importTransport?: ImportTransport | undefined;
+    growMeshSsbo?: (neededSlots: number) => MeshSsboGrowResult;
+    meshSsboState?: MeshSsboState;
+    featureHost?: RenderFeatureHost;
+    debugOverlay?: RenderDebugOverlay;
+    volumetricFogShaders?: VolumetricFogShaderSources | undefined;
+    ssrShaders?: SsrShaderSources | undefined;
+    atmosphereShaders?: AtmosphereShaderSources | undefined;
+    gpuPassTimingSubmittedWork?: Promise<void> | undefined;
+    lossObserver: {
+        current?: (detail: string) => void;
+    };
+    generationState: {
+        current: number;
+        onStaleLoss?: () => void;
+    };
+    getMaterialShaderUvSetCount?: (materialShaderId: string) => number | undefined;
+    gpuPassTimingFrameIdentity?: GpuPassTimingFrameIdentity | undefined;
+    gpuPassTimingCapture?: GpuPassTimingCapture | undefined;
+    gpuPassTimingBeginReason?: GpuPassTimingReason | undefined;
+    observationCaptureOwner?: {
+        register(capture: TypedFrameObservationCapture): void;
+        consume(frameNumber: number): readonly TypedFrameObservationCapture[];
+        drain(): readonly TypedFrameObservationCapture[];
+    };
+    observationCaptureDomains?: readonly FrameObservationDomain[] | undefined;
+    observationFrameId?: number | undefined;
+    observationGraphGeneration?: number | undefined;
+}
+//# sourceMappingURL=webgpu-renderer-contract.d.ts.map

package/dist/assembly/webgpu-renderer-contract.d.ts.map

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

package/dist/assembly/webgpu-renderer-guards.d.ts

@@ -0,0 +1,9 @@
+import type { World } from '@forgeax/engine-ecs';
+import { RendererOperationError } from '../errors/render';
+/**
+ * Derived geometry and voxel physics publish together. A draw is rejected
+ * until that pair has completed its fixed-step writeback, so the renderer
+ * never consumes a half-published World snapshot.
+ */
+export declare function derivedPhysicsFrameError(worlds: readonly World[]): RendererOperationError<'frame-input-invalid'> | undefined;
+//# sourceMappingURL=webgpu-renderer-guards.d.ts.map

package/dist/assembly/webgpu-renderer-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpu-renderer-guards.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-renderer-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAgC,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAExF;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,KAAK,EAAE,GACvB,sBAAsB,CAAC,qBAAqB,CAAC,GAAG,SAAS,CAqB3D"}

package/dist/assembly/webgpu-renderer-observation.d.ts

@@ -0,0 +1,6 @@
+import type { Buffer } from '@forgeax/engine-rhi';
+import { RendererContractFailureError } from '../errors/render';
+import type { TypedFrameObservationCapture } from '../typed-render-graph-primitives';
+/** Dispose receipt-bound readback buffers while retaining failed ownership. */
+export declare function disposeObservationCaptureSet(captures: readonly TypedFrameObservationCapture[], destroyed: WeakSet<Buffer>, failures: WeakMap<Buffer, RendererContractFailureError>, fire: (failure: RendererContractFailureError) => void): RendererContractFailureError | undefined;
+//# sourceMappingURL=webgpu-renderer-observation.d.ts.map

package/dist/assembly/webgpu-renderer-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpu-renderer-observation.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-renderer-observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAErF,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,SAAS,4BAA4B,EAAE,EACjD,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,EAC1B,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,4BAA4B,CAAC,EACvD,IAAI,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,IAAI,GACpD,4BAA4B,GAAG,SAAS,CAgC1C"}

package/dist/assembly/webgpu-renderer-recovery-failure.d.ts

@@ -0,0 +1,12 @@
+import type { DeviceResourceKind } from '../device/resource-types';
+import type { RecoveryGuidance, RecoveryPhase } from './renderer-lifecycle';
+export interface RecoveryFailureLocation {
+    readonly phase: RecoveryPhase;
+    readonly retryable: boolean;
+    readonly guidance: RecoveryGuidance;
+    readonly owner: string;
+    readonly resourceKind: DeviceResourceKind;
+    readonly cause: unknown;
+}
+export declare function createRecoveryFailureLocation(phase: RecoveryPhase, cause: unknown, overrides?: Partial<Omit<RecoveryFailureLocation, 'phase' | 'cause'>>): RecoveryFailureLocation;
+//# sourceMappingURL=webgpu-renderer-recovery-failure.d.ts.map

package/dist/assembly/webgpu-renderer-recovery-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpu-renderer-recovery-failure.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-renderer-recovery-failure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE5E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAaD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,OAAO,EACd,SAAS,GAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,OAAO,CAAC,CAAM,GACxE,uBAAuB,CAkCzB"}

package/dist/assembly/webgpu-renderer.d.ts

@@ -1,151 +1,17 @@
-import type { RhiCanvasContext, RhiDevice } from '@forgeax/engine-rhi';
-import { RhiError } from '@forgeax/engine-rhi';
-import type { ImportTransport } from '@forgeax/engine-types';
 export type { MaterialShaderManifestEntry } from '@forgeax/engine-shader';
-import type { DeviceResourceKind } from '../device/resource-types';
-import { type RenderFeatureHost } from '../features/host';
-import { HealthListenerRegistry, LostListenerRegistry, RhiErrorListenerRegistry } from '../lifecycle';
-import type { RecoveryColdWorkGuard } from '../record/render-context';
-import type { RenderDebugOverlay, RendererOptions, VolumetricFogShaderSources } from '../render-contract';
+import type { RendererOptions } from '../render-contract';
 import type { RhiBackendPack } from './backend-contract';
 import type { BundlerOptions } from './bundler-contract';
-import type { RendererAssemblyImplementation } from './host-contract';
-import type { MeshSsboGrowResult, MeshSsboState } from './mesh-ssbo-grow';
-import { type RecoveryGuidance, type RecoveryPhase } from './renderer-lifecycle';
+export type { RecoveryFailureLocation } from './webgpu-renderer-recovery-failure';
+import type { WebGPUOutcome } from './webgpu-renderer-contract';
 export type { BundlerOptions } from './bundler-contract';
 export { assembleMaterialProjection } from './material/assembly';
 export type { LayoutKind, MaterialShaderBindingContract, MaterialShaderVertexInputContract, } from './material-shader-policy';
 export { allowsUnlitPreparedFallback, isSharedMaterialUserRegionCompatible, normalizeMaterialShaderVariantSet, resolveMaterialShaderBackendArtifactKey, resolveMaterialShaderBindingContract, resolveMaterialShaderUvSetCount, resolveMaterialShaderVariantSet, resolveMaterialShaderVertexInputContract, selectNoColorPbrVariant, selectPipelineLayoutForVariant, shouldDeferMissingPreparedMaterialShader, } from './material-shader-policy';
-export type { MeshSsboBufferWrapper, MeshSsboGrowController, MeshSsboGrowControllerInit, MeshSsboGrowDevice, MeshSsboGrowErrorRegistry, MeshSsboGrowResult, MeshSsboState, } from './mesh-ssbo-grow';
-export { createMeshSsboGrowController, deriveStorageBufferCeiling, INITIAL_MESH_SSBO_SLOT_COUNT, requireMeshSsboBuffer, } from './mesh-ssbo-grow';
+export { createMeshSsboGrowController, deriveStorageBufferCeiling, INITIAL_MESH_SSBO_SLOT_COUNT, type MeshSsboBufferWrapper, type MeshSsboGrowController, type MeshSsboGrowControllerInit, type MeshSsboGrowDevice, type MeshSsboGrowErrorRegistry, type MeshSsboGrowResult, type MeshSsboState, requireMeshSsboBuffer, } from './mesh-ssbo-grow';
 export { exposeRenderer } from './renderer-facade';
-export { selectHdrpPbrPrewarmVariants, selectProbePrewarmVariants, selectSkinPrewarmVariants, selectStandardPbrTransmissionPrewarmVariants, } from './shader-prewarm-policy';
-/**
- * Bundler-layer injection accepted by `createRenderer` (and proxied by
- * `createApp`) as the optional third argument.
- *
- * feat-20260608-create-app-param-surface-trim / M2 / D-3: aggregates the two
- * host-injected build-tool channels:
- *
- *   - shaderManifestUrl: the URL the host's vite-plugin-shader emit step
- *     wrote `manifest.json` to. When this field is omitted (or `bundler`
- *     itself is omitted), createRenderer falls back to
- *     '/shaders/manifest.json' (D-2 q5-A) so the LO 1.1 zero-config takeoff
- *     path keeps working without explicit injection. Tests can inject via a
- *     `data:application/json,...` URL to bypass fetch.
- *
- *   - importTransport: dev-only ImportTransport forwarded verbatim to the
- *     AssetRegistry third ctor slot so DDC-miss assets can lazy-import.
- *     Absent => shipped form (a DDC miss fails fast with `asset-not-imported`).
- *
- * The interface is structurally shared with `@forgeax/engine-app` while this
- * package keeps the renderer independent from the host package.
- */
-/**
- * Wire the spec `device.lost` Promise into the lost / error / health channels
- * (research §F-4 / R2). A genuine device loss fans out through `errorRegistry`
- * so the public `renderer.subscribe` error event triggers, and
- * through `healthRegistry` so `health().reason` flips to `'device-lost'`
- * (feat-20260622-s5 M1/M2). Explicit renderer teardown is observable through
- * `onLost`, but is not a runtime error and must not manufacture an RhiError.
- *
- * Extracted to a single helper (SSOT) so the createRenderer assembly path AND
- * the recover() rebuild path attach byte-identical fan-out to whichever device
- * is current — recover() mints a fresh device whose own `lost` Promise must be
- * re-wired to the SAME registries the host already subscribed to.
- */
-/**
- * tryCreateWebGPURenderer returns three kinds of outcome (fix-f1 / w16):
- * - `ok`           → Renderer created successfully
- * - `rhi-err`      → RHI Result.err path (preserves the original RhiError
- *                    for AI consumers to read; now includes context acquisition
- *                    failures via pack.rhi.acquireCanvasContext)
- * - `throw`        → exception path (caught and wrapped by the caller as
- *                    an Error)
- */
-export type WebGPUOutcome = {
-    kind: 'ok';
-    renderer: RendererAssemblyImplementation;
-} | {
-    kind: 'rhi-err';
-    error: RhiError;
-} | {
-    kind: 'throw';
-    error: Error;
-};
+export { selectGpuDrivenSceneIndexVariant, selectHdrpPbrPrewarmVariants, selectProbePrewarmVariants, selectSkinPrewarmVariants, selectStandardPbrTransmissionPrewarmVariants, } from './shader-prewarm-policy';
+export type { WebGPUOutcome, WebGPURendererInternals } from './webgpu-renderer-contract';
+export { disposeObservationCaptureSet } from './webgpu-renderer-observation';
 export declare function tryCreateWebGPURenderer(canvas: HTMLCanvasElement | OffscreenCanvas, options: RendererOptions | undefined, pack: RhiBackendPack, bundler: BundlerOptions | undefined): Promise<WebGPUOutcome>;
-export interface WebGPURendererInternals {
-    canvas: HTMLCanvasElement | OffscreenCanvas;
-    device: RhiDevice;
-    context: RhiCanvasContext;
-    options: RendererOptions | undefined;
-    /**
-     * feat-20260608-create-app-param-surface-trim / M2 / D-3: BundlerOptions
-     * forwarded verbatim from createRenderer's third arg. Carries
-     * shaderManifestUrl (host-injected vite-plugin-shader emit URL; absent =>
-     * createRenderer falls back to '/shaders/manifest.json') and the
-     * importTransport that previously rode a dedicated internal slot.
-     */
-    bundler: BundlerOptions | undefined;
-    lostRegistry: LostListenerRegistry;
-    errorRegistry: RhiErrorListenerRegistry;
-    healthRegistry: HealthListenerRegistry;
-    /** M3 D-P4 auto-select pack — carries the dynamic-imported rhi-webgpu / rhi-wgpu singleton + optional async shader factory. */
-    pack: RhiBackendPack;
-    /**
-     * feat-20260604-hdr-equirect-cube-importer-loader M4 / w16 (D-3): the
-     * dev-only ImportTransport, forwarded verbatim from createRenderer to the
-     * AssetRegistry third ctor slot. `undefined` keeps the shipped form (DDC
-     * miss fails fast with `asset-not-imported`, AC-08).
-     */
-    importTransport?: ImportTransport | undefined;
-    /**
-     * feat-20260608-mesh-ssbo-dynamic-grow-l1-lift-1024-entity-cap M2 / T-M2-05:
-     * mesh-SSBO grow hook surfaced by `makeWebGPURenderer` after the controller
-     * is constructed. Undefined before `makeWebGPURenderer` runs; populated by
-     * the time the renderer is returned to the caller. M3's record stage reads
-     * this field via the runtime path that bridges into render-system-record.ts
-     * (the bridging plumbing is in M3's targetFiles).
-     *
-     * Returns `{ ok: true }` when the grow completed (or short-circuited
-     * idempotently); `{ ok: false, code }` with a fired structured error
-     * (`MeshSsboCeilingReachedError` or `MeshSsboCapacityExceededError`) when
-     * the request cannot be satisfied. Never throws (D-5).
-     */
-    growMeshSsbo?: (neededSlots: number) => MeshSsboGrowResult;
-    /**
-     * feat-20260608-mesh-ssbo-dynamic-grow-l1-lift-1024-entity-cap M3 / T-M3-04:
-     * read-only handle to the grow controller's state (slotCount + wrapper
-     * refs), surfaced alongside `growMeshSsbo` so `ensureMeshSsboCapacity`
-     * (record-stage wiring) can short-circuit when slotCount already covers the
-     * frame's renderable count and so the dev-mode info log can report the
-     * before/after slot count transition. Undefined until buildReadyWebGPU
-     * has wired the controller; identity stable across grow events.
-     */
-    meshSsboState?: MeshSsboState;
-    /** Host-owned producer features; created before device-bound assembly starts. */
-    featureHost?: RenderFeatureHost;
-    /** App-owned overlay capability read by the typed graph at frame time. */
-    debugOverlay?: RenderDebugOverlay;
-    /** Composed renderer utility sources installed atomically at build-ready. */
-    volumetricFogShaders?: VolumetricFogShaderSources | undefined;
-    gpuPassTimingSubmittedWork?: Promise<void> | undefined;
-    lossObserver: {
-        current?: (detail: string) => void;
-    };
-    generationState: {
-        current: number;
-        onStaleLoss?: () => void;
-    };
-    recoveryColdWorkGuard?: RecoveryColdWorkGuard | undefined;
-    getMaterialShaderUvSetCount?: (materialShaderId: string) => number | undefined;
-}
-export interface RecoveryFailureLocation {
-    readonly phase: RecoveryPhase;
-    readonly retryable: boolean;
-    readonly guidance: RecoveryGuidance;
-    readonly owner: string;
-    readonly resourceKind: DeviceResourceKind;
-    readonly cause: unknown;
-}
 //# sourceMappingURL=webgpu-renderer.d.ts.map

package/dist/assembly/webgpu-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgpu-renderer.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-renderer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"webgpu-renderer.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-renderer.ts"],"names":[],"mappings":"AAyCA,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAsE1E,OAAO,KAAK,EAUV,eAAe,EAQhB,MAAM,oBAAoB,CAAC;AAgB5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA2DzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAUlF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAUhE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EACV,UAAU,EACV,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,2BAA2B,EAC3B,oCAAoC,EACpC,iCAAiC,EACjC,uCAAuC,EACvC,oCAAoC,EACpC,+BAA+B,EAC/B,+BAA+B,EAC/B,wCAAwC,EACxC,uBAAuB,EACvB,8BAA8B,EAC9B,wCAAwC,GACzC,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,gCAAgC,EAChC,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,4CAA4C,GAC7C,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAI7E,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,iBAAiB,GAAG,eAAe,EAC3C,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,cAAc,GAAG,SAAS,GAClC,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/assembly/webgpu-vertex-layouts.d.ts

@@ -1,89 +1,33 @@
-import type { GpuVertexBufferLayoutEntry } from '@forgeax/engine-geometry';
+import { type GpuVertexBufferLayoutEntry, type VertexLayoutProjection } from '@forgeax/engine-geometry';
 import type { VertexAttributeMap } from '@forgeax/engine-types';
-export declare const PBR_SKIN_SENTINEL_ATTR_BUFFER: ArrayBuffer;
-/** Default 4-attribute vertex layout used as fallback when meshAttributes is undefined. */
-export declare const DEFAULT_VERTEX_ATTRS: VertexAttributeMap;
+/** Geometry-owned maps retained here only as feature-pipeline aliases. */
 export declare const PREPARED_INSTANCE_VERTEX_ATTRS: VertexAttributeMap;
 export declare const PREPARED_MATERIAL_INSTANCE_VERTEX_ATTRS: VertexAttributeMap;
-export declare const POSITION_SIZE_COLOR_INSTANCE_VERTEX_BUFFERS: {
-    arrayStride: number;
-    stepMode: "instance";
-    attributes: ({
-        shaderLocation: number;
-        offset: number;
-        format: "float32x3";
-    } | {
-        shaderLocation: number;
-        offset: number;
-        format: "float32x2";
-    } | {
-        shaderLocation: number;
-        offset: number;
-        format: "float32x4";
-    })[];
-}[];
-export declare const BILLBOARD_MATERIAL_INSTANCE_VERTEX_BUFFERS: {
-    arrayStride: number;
-    stepMode: "instance";
-    attributes: ({
-        shaderLocation: number;
-        offset: number;
-        format: "float32x3";
-    } | {
-        shaderLocation: number;
-        offset: number;
-        format: "float32x2";
-    } | {
-        shaderLocation: number;
-        offset: number;
-        format: "float32x4";
-    })[];
-}[];
-export declare const TOPOLOGY_SEGMENT_INSTANCE_VERTEX_BUFFERS: {
-    arrayStride: number;
-    stepMode: "instance";
-    attributes: ({
-        shaderLocation: number;
-        offset: number;
-        format: "float32x3";
-    } | {
-        shaderLocation: number;
-        offset: number;
-        format: "float32x4";
-    } | {
-        shaderLocation: number;
-        offset: number;
-        format: "float32x2";
-    })[];
-}[];
-export declare const MESH_GEOMETRY_MATERIAL_INSTANCE_VERTEX_BUFFERS: ({
-    arrayStride: number;
-    stepMode: "vertex";
-    attributes: ({
-        shaderLocation: number;
-        offset: number;
-        format: "float32x3";
-    } | {
-        shaderLocation: number;
-        offset: number;
-        format: "float32x2";
-    } | {
-        shaderLocation: number;
-        offset: number;
-        format: "float32x4";
-    })[];
-} | {
-    arrayStride: number;
-    stepMode: "instance";
-    attributes: ({
-        shaderLocation: number;
-        offset: number;
-        format: "float32x3";
-    } | {
-        shaderLocation: number;
-        offset: number;
-        format: "float32x4";
-    })[];
-})[];
+export declare const POSITION_SIZE_COLOR_INSTANCE_VERTEX_BUFFERS: GPUVertexBufferLayout[];
+export declare const BILLBOARD_MATERIAL_INSTANCE_VERTEX_BUFFERS: GPUVertexBufferLayout[];
+export declare const TOPOLOGY_SEGMENT_INSTANCE_VERTEX_BUFFERS: GPUVertexBufferLayout[];
+/**
+ * The mesh stream is derived from geometry's canonical attribute projection.
+ * The second stream remains a feature-owned instance ABI because it carries
+ * particle transform/material data rather than MeshAsset attributes.
+ */
+export declare const MESH_GEOMETRY_MATERIAL_INSTANCE_VERTEX_BUFFERS: GPUVertexBufferLayout[];
+export declare function isPreparedMaterialVertexLayout(layout: string | undefined): boolean;
+/**
+ * Derive the prepared particle layout that appends one to four material-input
+ * vec4 lanes to the instance stream. The base layouts stay shared with the
+ * no-input path; only the final stream stride and locations change, which
+ * keeps the vertex-data ABI and pipeline cache key in lockstep.
+ */
+export declare function particleMaterialInputVertexBuffers(vertexLayout: string | undefined, lanes?: number): readonly GPUVertexBufferLayout[] | undefined;
 export declare function toGpuVertexBufferLayouts(entries: readonly GpuVertexBufferLayoutEntry[]): readonly GPUVertexBufferLayout[];
+export declare function resolveWebGPUVertexBufferLayouts(options: {
+    vertexInputContract: 'none' | 'render-material';
+    vertexLayout: string | undefined;
+    vertexLayoutProjection: VertexLayoutProjection | undefined;
+    resolvedUvSetCount: number | undefined;
+    layoutKind: string;
+    meshAttributes: VertexAttributeMap | undefined;
+    particleInputLanes: number | undefined;
+}): readonly GPUVertexBufferLayout[];
 //# sourceMappingURL=webgpu-vertex-layouts.d.ts.map

package/dist/assembly/webgpu-vertex-layouts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgpu-vertex-layouts.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-vertex-layouts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOhE,eAAO,MAAM,6BAA6B,aAAqB,CAAC;AAEhE,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB,EAAE,kBAKlC,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,kBAM5C,CAAC;AAEF,eAAO,MAAM,uCAAuC,EAAE,kBAOrD,CAAC;AAEF,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;GAUZ,CAAC;AAE7C,eAAO,MAAM,0CAA0C;;;;;;;;;;;;;;;;GAgBX,CAAC;AAE7C,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;GAWT,CAAC;AAE7C,eAAO,MAAM,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyBf,CAAC;AAgB7C,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,0BAA0B,EAAE,GAC7C,SAAS,qBAAqB,EAAE,CAUlC"}
+{"version":3,"file":"webgpu-vertex-layouts.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-vertex-layouts.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,0BAA0B,EAE/B,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AA0FhE,0EAA0E;AAC1E,eAAO,MAAM,8BAA8B,oBAAoC,CAAC;AAChF,eAAO,MAAM,uCAAuC,oBAA4B,CAAC;AAUjF,eAAO,MAAM,2CAA2C,yBAEZ,CAAC;AAE7C,eAAO,MAAM,0CAA0C,yBAEX,CAAC;AAE7C,eAAO,MAAM,wCAAwC,yBAET,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,8CAA8C,yBAGf,CAAC;AAW7C,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,qBAAqB,EAAE,GAAG,SAAS,CA8B9C;AAgBD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,0BAA0B,EAAE,GAC7C,SAAS,qBAAqB,EAAE,CAUlC;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE;IACxD,mBAAmB,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAChD,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,sBAAsB,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC3D,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC/C,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC,GAAG,SAAS,qBAAqB,EAAE,CAsDnC"}

package/dist/authoring.mjs

@@ -1,7 +1,7 @@
-export { GlyphText, SpritePlayback, setActiveCamera, spritePlaybackModeFromU32 } from './chunk-FJ6P52EE.mjs';
-export { SpriteAnimation, SpriteInstances, SpriteRegionOverride, TileLayer, Tilemap, TilemapSort } from './chunk-JDWARUOI.mjs';
+export { GlyphText, SpritePlayback, spritePlaybackModeFromU32 } from './chunk-ILQ5MEZF.mjs';
+export { SpriteAnimation, SpriteInstances, SpriteRegionOverride, TileLayer, Tilemap, TilemapSort, setActiveCamera } from './chunk-PA5DRJNI.mjs';
 export { TransparentSort } from './chunk-RXZ3RGOU.mjs';
-export { SPRITE_PREMULTIPLIED_ALPHA_BLEND } from './chunk-GF523LHF.mjs';
+export { SPRITE_PREMULTIPLIED_ALPHA_BLEND } from './chunk-BLXGONR2.mjs';
 import { ok } from '@forgeax/engine-types';
 
 function createFullscreenRenderFeature(options) {