@forgeax/engine-render 0.1.2

package/dist/hdrp-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hdrp-pipeline.d.ts","sourceRoot":"","sources":["../src/hdrp-pipeline.ts"],"names":[],"mappings":"AAOA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAsB7D,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,mBAAmB,CAAC;AAkB3B,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAEhD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAG,mBAAmB,CAAU;IAC7C,QAAQ,CAAC,QAAQ,iDAAiD;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;gBAEpE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;CAO5C;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,MAAM,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,gBAAgB,CAAC,CAahE;AAED,eAAO,MAAM,oBAAoB;;;;CAAkC,CAAC;AACpE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,yBAAyB,UAAU,CAAC;AACjD,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,EACvD,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,OAAO,GACjB,OAAO,CAET;AAyaD,eAAO,MAAM,YAAY,EAAE,cAAqC,CAAC"}

package/dist/ibl/IblPipelineCache.d.ts

@@ -0,0 +1,274 @@
+/**
+ * Shader module factory (async, injected via configureGpuDevice).
+ * Mirrors `MipmapShaderModuleFactory` from mipmap-generator.
+ */
+export type IblShaderModuleFactory = (device: object, desc: {
+    code: string;
+    label?: string;
+}) => Promise<{
+    ok: boolean;
+    value?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+}>;
+/**
+ * Per-device IBL pipeline cache instance.
+ *
+ * M3.5 (round-2 t52): the 4 pipeline slots are mutable so createIblPipelines
+ * can fill them after construction. The 4 textures + their views are also
+ * cached here so runIblPrecompute targets are stable across calls
+ * (idempotent).
+ */
+export interface IblPipelineCachePerDevice {
+    /** Color format shared by all precompute outputs for this device. */
+    outputFormat?: string;
+    /** Equirectangular-to-cubemap pipeline. */
+    equirectToCubePipeline?: any;
+    /** Diffuse irradiance convolution pipeline. */
+    irradiancePipeline?: any;
+    /** Specular prefilter pipeline. */
+    prefilterPipeline?: any;
+    /** BRDF integration LUT pipeline. */
+    brdfLutPipeline?: any;
+    /** Face uniforms BGL (shared across equirect/irradiance/prefilter, D-9). */
+    faceUniformsBgl?: any;
+    /** group(1) BGL for the equirect-to-cube pass (texture_2d + sampler). */
+    equirectGroup1Bgl?: any;
+    /** group(1) BGL for irradiance + prefilter (texture_cube + sampler). */
+    cubeGroup1Bgl?: any;
+    /** group(0) BGL for prefilter (face + prefilter uniforms). */
+    prefilterGroup0Bgl?: any;
+    /** Irradiance cubemap texture (32x32; outputFormat, cube). */
+    irradianceTexture?: any;
+    /** Irradiance cubemap view (dimension:cube). */
+    irradianceView?: any;
+    /** Per-face 2D views for irradiance (render-attachment use). */
+    irradianceFaceViews?: ReadonlyArray<any>;
+    /** Specular prefilter cubemap (128x128, 5 mip levels). */
+    prefilterTexture?: any;
+    /** Prefilter cubemap view (dimension:cube, all mips). */
+    prefilterView?: any;
+    /** Per-face 2D views per mip for prefilter (5 mips x 6 faces). */
+    prefilterFaceViewsByMip?: ReadonlyArray<ReadonlyArray<any>>;
+    /** BRDF LUT (256x256; outputFormat). */
+    brdfLutTexture?: any;
+    /** BRDF LUT view. */
+    brdfLutView?: any;
+    /** Counter: times irradiance pass has executed. AC-04: == 1 after first cook. */
+    irradianceBakeCount: number;
+    /** Counter: times prefilter pass has executed. AC-05: == 1 after first cook. */
+    prefilterBakeCount: number;
+    /** Counter: times BRDF LUT pass has executed. AC-06: == 1 after first cook. */
+    brdfLutBakeCount: number;
+}
+/**
+ * Get or create the per-device IBL pipeline cache.
+ */
+export declare function getOrCreateIblCache(device: object): IblPipelineCachePerDevice;
+/**
+ * Number of cached per-device instances (introspection hook for tests).
+ */
+export declare function iblCacheSize(): number;
+/**
+ * Check whether a device has an active cache entry (introspection for tests).
+ */
+export declare function hasIblCache(device: object): boolean;
+/**
+ * Clear the per-device cache entry for the given device, if any.
+ *
+ * feat-20260612-rhi-destroy-renderer-dispose-gpu-lifecycle / M5: called from
+ * `Renderer.dispose()` step 4 (plan-strategy D-2 6-step walk) so the IBL
+ * pipelines / textures attached to a torn-down device do not survive in the
+ * runtime cache. The underlying GPU pipeline / texture handles are not
+ * separately destroyed here -- they were created on the same RhiDevice the
+ * dispose chain is about to release at step 5 (`context.unconfigure`); the
+ * spec contract is that releasing the device tears down its child pipelines
+ * implicitly. Clearing the WeakMap entry simply lets GC reclaim the JS-side
+ * cache record.
+ *
+ * Idempotent (architecture-principles §6): a second call after the entry
+ * was deleted is a no-op.
+ */
+export declare function clearIblCacheForDevice(device: object): void;
+/**
+ * Set the ibl.wgsl source string. Called once by the consumer
+ * (e.g., AssetRegistry) when the shader module source is loaded.
+ */
+export declare function setIblWgslSource(source: string): void;
+/**
+ * Get the cached ibl.wgsl source string.
+ * Throws if not yet loaded.
+ */
+export declare function getIblWgslSource(): string;
+export interface IblComposedShaders {
+    /** ibl-equirect-to-cube composed (cubemap_vs + equirectToCube_fs). */
+    readonly equirectToCube: string;
+    /** ibl-irradiance composed (cubemap_vs + irradianceConvolve_fs). */
+    readonly irradiance: string;
+    /** ibl-prefilter composed (cubemap_vs + prefilterEnv_fs). */
+    readonly prefilter: string;
+    /** ibl-brdf-lut composed (fullscreen_vs + brdfLutBake_fs). */
+    readonly brdfLut: string;
+}
+/**
+ * Inject the composed ibl-* shader sources used by createIblPipelines.
+ * Called once by the engine bootstrap (createRenderer step "shader-load")
+ * with the 4 composed entries from ShaderRegistry.
+ */
+export declare function setIblComposedShaders(sources: IblComposedShaders): void;
+/**
+ * Retrieve the cached composed shader bundle.
+ * Returns undefined when the runtime is operating without a real shader
+ * source (mock device unit tests that exercise pipeline dispatch surface
+ * only).
+ */
+export declare function getIblComposedShaders(): IblComposedShaders | undefined;
+export declare const CUBEMAP_FACE_VERTICES: Float32Array<ArrayBuffer>;
+export declare const CAPTURE_VIEW_PROJS: Float32Array<ArrayBufferLike>[];
+export declare const IRRADIANCE_SIZE = 32;
+export declare const PREFILTER_SIZE = 128;
+export declare const PREFILTER_MIP_LEVELS = 5;
+export declare const BRDF_LUT_SIZE = 256;
+/**
+ * Minimal device shape used by createIblPipelines + runIblPrecompute. The
+ * surface is intentionally narrow so unit-level mock devices can exercise
+ * the dispatch path without standing up the full RHI shim.
+ */
+export interface IblPipelineDevice {
+    createBindGroupLayout(desc: any): {
+        ok: true;
+        value: any;
+    } | {
+        ok: false;
+        error: unknown;
+    };
+    createPipelineLayout(desc: any): {
+        ok: true;
+        value: any;
+    } | {
+        ok: false;
+        error: unknown;
+    };
+    createRenderPipeline(desc: any): {
+        ok: true;
+        value: any;
+    } | {
+        ok: false;
+        error: unknown;
+    };
+    createBuffer(desc: any): {
+        ok: true;
+        value: any;
+    } | {
+        ok: false;
+        error: unknown;
+    };
+    createTexture(desc: any): {
+        ok: true;
+        value: any;
+    } | {
+        ok: false;
+        error: unknown;
+    };
+    createTextureView(texture: any, desc: any): {
+        ok: true;
+        value: any;
+    } | {
+        ok: false;
+        error: unknown;
+    };
+    createSampler(desc?: any): {
+        ok: true;
+        value: any;
+    } | {
+        ok: false;
+        error: unknown;
+    };
+    createBindGroup(desc: any): {
+        ok: true;
+        value: any;
+    } | {
+        ok: false;
+        error: unknown;
+    };
+    createCommandEncoder(desc?: any): {
+        ok: true;
+        value: any;
+    } | {
+        ok: false;
+        error: unknown;
+    };
+    readonly queue: {
+        submit(buffers: ReadonlyArray<any>): unknown;
+        writeBuffer?: (...args: any[]) => unknown;
+    };
+}
+/**
+ * Create 4 independent GPURenderPipelines + their shared / per-pass bind
+ * group layouts. Pipeline slots are stored on the per-device cache and
+ * survive across calls (D-1 startup-once cook).
+ *
+ * D-9: faceUniforms BGL (@group(0) for equirect/irradiance/prefilter) is
+ * a single instance reused across 3 pipelines (binary-compatible).
+ * group(1) is per-pipeline: texture_2d for equirect, texture_cube for
+ * irradiance + prefilter, none for brdf-lut.
+ */
+export declare function createIblPipelines(device: IblPipelineDevice, factory: IblShaderModuleFactory, cubeOutputFormat?: any): Promise<{
+    ok: true;
+    value: {
+        equirectToCubePipeline: any;
+        irradiancePipeline: any;
+        prefilterPipeline: any;
+        brdfLutPipeline: any;
+    };
+} | {
+    ok: false;
+    error: unknown;
+}>;
+/**
+ * Options consumed by runIblPrecompute. The caller (the internal
+ * GpuResourceStore equirect-to-cubemap projection) provides the equirect input
+ * + cubemap target GPU resources; the face-uniform / prefilter-uniform buffers
+ * come from the t55 helpers.
+ */
+export interface RunIblPrecomputeOptions {
+    readonly device: IblPipelineDevice;
+    readonly equirectGpuTex: any;
+    readonly equirectView: any;
+    readonly cubeGpuTex: any;
+    readonly cubeView: any;
+    readonly cubeFaceViews: ReadonlyArray<any>;
+    readonly faceUniformsBuffer: any;
+    readonly prefilterUniformsBuffer: any;
+    readonly cubeVertexBuffer: any;
+}
+/**
+ * Execute the 4 IBL precompute passes (equirect-to-cube / irradiance /
+ * prefilter / brdf-lut) in a single CommandEncoder and submit.
+ *
+ * Counter invariant (AC-20, plan D-7 / N-3): the
+ * `irradiance/prefilter/brdfLut BakeCount` counters are incremented
+ * AFTER queue.submit returns. If submit throws or returns Result.err, the
+ * counters stay at 0 -- this is the prime safety guard against the
+ * round-1 "counter += 1 as dispatch proxy" anti-pattern.
+ *
+ * Returns Result.err with code='ibl-precompute-not-dispatched' when the
+ * underlying device lacks queue.submit or any of the 4 pipelines was not
+ * created (createIblPipelines must run first).
+ */
+export declare function runIblPrecompute(opts: RunIblPrecomputeOptions): {
+    ok: true;
+    value: {
+        submitted: boolean;
+    };
+} | {
+    ok: false;
+    error: {
+        code: string;
+        expected: string;
+        hint: string;
+    };
+};
+//# sourceMappingURL=IblPipelineCache.d.ts.map

package/dist/ibl/IblPipelineCache.d.ts.map

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

package/dist/ibl/cubemap-projection.d.ts

@@ -0,0 +1,23 @@
+/** The canonical diffuse IBL payload stores irradiance as E times pi. */
+export declare const IBL_DIFFUSE_PAYLOAD_SEMANTIC: "irradianceEOverPi";
+export type IblDiffusePayloadSemantic = typeof IBL_DIFFUSE_PAYLOAD_SEMANTIC;
+export interface IblCapabilityReport {
+    readonly capabilityStatus: 'supported' | 'degraded';
+    readonly executionStatus: 'notExecuted' | 'complete';
+    readonly verdict: 'failed' | 'passed';
+    readonly rgba16floatRenderable: boolean;
+    readonly outputFormat: 'rgba16float' | null;
+    readonly fallbackArtifact: 'white-cube' | null;
+    readonly expectedImpact: string;
+    readonly hint: string;
+}
+export declare function describeIblCapability(input: {
+    readonly rgba16floatRenderable: boolean;
+}): IblCapabilityReport;
+/**
+ * Build a perspective projection matrix for rendering into cubemap faces.
+ * Y is negated to match WebGPU's top-left framebuffer origin (unlike OpenGL's bottom-left).
+ * All cubemap passes (equirect-to-cube / irradiance / prefilter) should use this.
+ */
+export declare function cubemapCaptureProjection(fovy: number, near: number, far: number): Float32Array;
+//# sourceMappingURL=cubemap-projection.d.ts.map

package/dist/ibl/cubemap-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cubemap-projection.d.ts","sourceRoot":"","sources":["../../src/ibl/cubemap-projection.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,eAAO,MAAM,4BAA4B,EAAG,mBAA4B,CAAC;AACzE,MAAM,MAAM,yBAAyB,GAAG,OAAO,4BAA4B,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,gBAAgB,EAAE,WAAW,GAAG,UAAU,CAAC;IACpD,QAAQ,CAAC,eAAe,EAAE,aAAa,GAAG,UAAU,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACtC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC,GAAG,mBAAmB,CAuBtB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAU9F"}

package/dist/ibl/face-uniforms.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Minimal device shape consumed by the helpers -- mirrors
+ * `IblPipelineDevice` createBuffer surface plus queue.writeBuffer.
+ */
+export interface FaceUniformsDevice {
+    createBuffer(desc: any): {
+        ok: true;
+        value: any;
+    } | {
+        ok: false;
+        error: unknown;
+    };
+    readonly queue: {
+        writeBuffer?: (...args: any[]) => unknown;
+    };
+}
+/**
+ * Allocate the 6-face viewProj uniform buffer. Size = 6 * 256 bytes so
+ * each face slot is dynamic-offset addressable.
+ */
+export declare function createFaceUniformsBuffer(device: FaceUniformsDevice): {
+    ok: true;
+    value: any;
+} | {
+    ok: false;
+    error: unknown;
+};
+/**
+ * Allocate the prefilter sub-pass uniform buffer. Size = 30 * 256 bytes.
+ */
+export declare function createPrefilterUniformsBuffer(device: FaceUniformsDevice): {
+    ok: true;
+    value: any;
+} | {
+    ok: false;
+    error: unknown;
+};
+/**
+ * Write a single face's viewProj matrix at the dynamic-offset slot.
+ *
+ * @param device device with queue.writeBuffer
+ * @param buffer face-uniforms buffer from createFaceUniformsBuffer
+ * @param faceIdx 0..5
+ * @param viewProj 16-element column-major mat4
+ */
+export declare function writeFaceUniforms(device: FaceUniformsDevice, buffer: any, faceIdx: number, viewProj: Float32Array): void;
+/**
+ * Write all 6 capture viewProj matrices into the face-uniforms buffer.
+ * Uses the static CAPTURE_VIEW_PROJS SSOT from IblPipelineCache.
+ */
+export declare function writeAllFaceUniforms(device: FaceUniformsDevice, buffer: any): void;
+/**
+ * Write a single prefilter sub-pass uniform slot (roughness + faceSize).
+ * subPassIdx = mip * 6 + face.
+ */
+export declare function writePrefilterUniforms(device: FaceUniformsDevice, buffer: any, subPassIdx: number, roughness: number, mipFaceSize: number): void;
+/**
+ * Write all 30 prefilter sub-pass uniforms (5 mip x 6 face) with
+ * roughness = mip / (mipLevels - 1) and mipFaceSize halved per mip.
+ */
+export declare function writeAllPrefilterUniforms(device: FaceUniformsDevice, buffer: any): void;
+export declare const FACE_UNIFORMS_STRIDE = 256;
+export declare const FACE_UNIFORMS_BUFFER_SIZE: number;
+export declare const PREFILTER_UNIFORMS_BUFFER_SIZE: number;
+//# sourceMappingURL=face-uniforms.d.ts.map

package/dist/ibl/face-uniforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"face-uniforms.d.ts","sourceRoot":"","sources":["../../src/ibl/face-uniforms.ts"],"names":[],"mappings":"AAwBA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAEjC,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAClF,QAAQ,CAAC,KAAK,EAAE;QAEd,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;KAC3C,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,GAEzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAO1D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,kBAAkB,GAEzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAO1D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAE1B,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,GACrB,IAAI,CASN;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,EAE1B,MAAM,EAAE,GAAG,GACV,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,kBAAkB,EAE1B,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,IAAI,CAON;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,kBAAkB,EAE1B,MAAM,EAAE,GAAG,GACV,IAAI,CAQN;AAED,eAAO,MAAM,oBAAoB,MAAwB,CAAC;AAC1D,eAAO,MAAM,yBAAyB,QAAqC,CAAC;AAC5E,eAAO,MAAM,8BAA8B,QAAkD,CAAC"}

package/dist/ibl/skylight-bind-group.d.ts

@@ -0,0 +1,130 @@
+import type { BindGroupEntry, Buffer, Result, RhiError, Sampler, SamplerDescriptor, Texture, TextureDescriptor, TextureView, TextureViewDescriptor } from '@forgeax/engine-rhi';
+export declare const FALLBACK_BYTES_PER_ROW = 256;
+/**
+ * Minimal RhiDevice subset used by the skylight fallback helper.
+ * Mirrors RhiDevice for the methods touched by this module (charter P4
+ * narrowest surface -- avoids dragging the full RhiDevice in for tests).
+ */
+export interface SkylightDevice {
+    createSampler(desc: SamplerDescriptor): Result<Sampler, RhiError>;
+    createTexture(desc: TextureDescriptor): Result<Texture, RhiError>;
+    createTextureView(tex: Texture, desc: TextureViewDescriptor): Result<TextureView, RhiError>;
+    createBuffer(desc: {
+        label?: string | undefined;
+        size: number;
+        usage: number;
+        mappedAtCreation?: boolean | undefined;
+    }): Result<Buffer, RhiError>;
+}
+/**
+ * Minimal queue subset used for fallback resource upload (zero-pixel
+ * texture seed + intensity=0 uniform seed).
+ */
+export interface SkylightQueue {
+    writeTexture(destination: {
+        texture: unknown;
+        mipLevel?: number;
+        origin?: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    }, data: ArrayBufferView, dataLayout: {
+        offset: number;
+        bytesPerRow: number;
+        rowsPerImage: number;
+    }, size: {
+        width: number;
+        height: number;
+        depthOrArrayLayers: number;
+    }): Result<void, RhiError> | unknown;
+    writeBuffer(buffer: Buffer, bufferOffset: number, data: ArrayBufferView): Result<void, RhiError> | unknown;
+}
+/**
+ * Skylight bind group resources (cube + cube + 2D LUT + intensity uniform).
+ * The active set comes from the IblPipelineCache precompute path; the
+ * fallback set is the 1x1 zero identity bundle below.
+ */
+export interface SkylightBindGroupResources {
+    readonly irradianceView: TextureView;
+    readonly irradianceSampler: Sampler;
+    readonly prefilterView: TextureView;
+    readonly prefilterSampler: Sampler;
+    readonly brdfLutView: TextureView;
+    readonly brdfLutSampler: Sampler;
+    readonly intensityBuffer: Buffer;
+}
+/**
+ * Fallback resource bundle attached to `PipelineState.skylightFallback`.
+ * The M4 round-4 recordFrame branch reads this bundle when
+ * `skylightCount === 0` and feeds it through
+ * `assembleMaterialWithSkylightEntries` so the PBR material BindGroup
+ * binds the same 14-entry layout shape with zero data + intensity=0.
+ *
+ * No stand-alone `bindGroup` field: the round-2 stand-alone Skylight BG
+ * is gone (D-5 round-4); the fallback resources flow into the PBR
+ * material BG at binding 7..13.
+ */
+export interface SkylightFallback {
+    readonly irradianceTexture: Texture;
+    readonly irradianceView: TextureView;
+    readonly prefilterTexture: Texture;
+    readonly prefilterView: TextureView;
+    readonly brdfLutTexture: Texture;
+    readonly brdfLutView: TextureView;
+    readonly sampler: Sampler;
+    readonly intensityBuffer: Buffer;
+}
+/**
+ * Append the 7 Skylight BindGroupLayout entries after the existing PBR
+ * user-region entries. Pure function -- the
+ * caller passes the result to `device.createBindGroupLayout`. Charter P4
+ * consistent abstraction: one BGL holds material + Skylight together,
+ * no second `@group(4)` allocated.
+ *
+ * Throws if the input is too short to contain the material UBO plus one
+ * sampler/texture pair (defensive guard; mirrors charter P3 explicit failure).
+ */
+export declare function mergeSkylightIntoMaterialBgl(materialBglEntries: readonly GPUBindGroupLayoutEntry[]): GPUBindGroupLayoutEntry[];
+/**
+ * Append the 7 Skylight BindGroupEntry resources (binding 7..13) onto the
+ * existing PBR material BindGroupEntry values (binding 0..6). The caller
+ * passes the result to `device.createBindGroup` as part of the merged
+ * material BG.
+ *
+ * The skylight argument may be the fallback identity bundle (rendered
+ * with ambient=0) or the active IblPipelineCache output bundle. Same
+ * call site, same layout shape -- charter P4 + F1 (AI users do not need
+ * a `if (hasSkylight)` branch when writing demos).
+ */
+export interface EmissiveAoBindGroupResources {
+    readonly emissiveSampler: Sampler;
+    readonly emissiveView: TextureView;
+    readonly occlusionSampler: Sampler;
+    readonly occlusionView: TextureView;
+}
+export declare function assembleMaterialWithSkylightEntries(materialEntries: readonly BindGroupEntry[], skylight: SkylightBindGroupResources, emissiveAo?: EmissiveAoBindGroupResources | undefined): BindGroupEntry[];
+/**
+ * Allocate the fallback Skylight resource bundle: 1x1 WHITE rgba16float
+ * irradiance/prefilter texture_cube pair + 1x1 rg16float BRDF approximation
+ * `[1, 0]` + a 16-byte uniform buffer + a single
+ * linear / clamp-to-edge sampler reused across all three texture slots.
+ *
+ * Two regimes share this bundle (the per-frame Skylight uniform selects):
+ *   - No Skylight entity: render-system-record writes intensity=0, so
+ *       ambient = whiteIrradiance * kD * albedo * color * 0 == 0
+ *     -- physically black, no `if (hasSkylight)` shader branch (D-5 round-4).
+ *   - Skylight with NO cubemap (downstream integration #4): record writes the
+ *     user's intensity + color, so the WHITE irradiance gives an instant
+ *     solid-color ambient and a neutral white specular reflection with no
+ *     async precompute. The 1x1 BRDF approximation is intentionally roughness
+ *     independent; a real cubemap swaps in the prefiltered IBL views and LUT.
+ *
+ * No stand-alone BindGroupLayout / BindGroup is created here -- those
+ * roles moved into the PBR material BGL factory (D-5 round-4). The
+ * caller (createRenderer) feeds the resource handles below through
+ * `assembleMaterialWithSkylightEntries` when composing the per-frame
+ * material BindGroup.
+ */
+export declare function createSkylightFallback(device: SkylightDevice, queue: SkylightQueue): SkylightFallback;
+//# sourceMappingURL=skylight-bind-group.d.ts.map

package/dist/ibl/skylight-bind-group.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+export { materialContribution, renderPipelineContribution, samplerContribution, } from './assets/asset-decoders';
+export type { RenderAssetPort } from './assets/render-asset-port';
+export { Atmosphere } from './components/atmosphere';
+export type { Antialias, CameraProjection, Tonemap } from './components/camera';
+export { ANTIALIAS_FXAA, ANTIALIAS_MSAA, ANTIALIAS_NONE, ANTIALIAS_TAA, antialiasFromF32, BLOOM_DISABLED, BLOOM_ENABLED, CAMERA_PROJECTION_ORTHOGRAPHIC, CAMERA_PROJECTION_PERSPECTIVE, Camera, cameraProjectionFromF32, orthographic, perspective, TONEMAP_ACES_FILMIC, TONEMAP_AGX, TONEMAP_CINEON, TONEMAP_LINEAR, TONEMAP_NEUTRAL, TONEMAP_NONE, TONEMAP_REINHARD, TONEMAP_REINHARD_EXTENDED, tonemapFromF32, tonemapToU32, } from './components/camera';
+export * from './components/directional-light';
+export { Fog, SKYBOX_MODE_CUBEMAP, SkyboxBackground, type SkyboxMode, Skylight, skyboxModeFromF32, } from './components/environment';
+export { Instances, type InstancesData } from './components/instances';
+export { Layer } from './components/layer';
+export * from './components/mesh-filter';
+export * from './components/mesh-renderer';
+export { PointLight } from './components/point-light';
+export { PointLightShadow } from './components/point-light-shadow';
+export { PostProcessParams } from './components/post-process-params';
+export { SceneInstance, type SceneInstanceOverrideRecord, type SceneInstanceState, } from './components/scene-instance';
+export { SortKey } from './components/sort-key';
+export { SpotLight } from './components/spot-light';
+export { Visibility, type VisibilityState, VisibilityStateValue, visibilityStateFromU32, } from './components/visibility';
+export { type AtmosphereSnapshot, type EnvironmentSelectionInput, type ExtractedEnvironment, selectEnvironmentSource, } from './environment/extracted-environment';
+export { type EnvironmentInspection, type EnvironmentInspectionInput, type EnvironmentInspectionState, type EnvironmentInspectionTaa, type FogEnvironmentProjectionInput, inspectEnvironmentGeneration, projectFogEnvironment, } from './environment/inspection';
+export { type AtmosphereCapsInsufficientDetail, AtmosphereCapsInsufficientError, type AtmosphereCardinalityInvalidDetail, AtmosphereCardinalityInvalidError, type AtmosphereField, type AtmosphereParameterInvalidDetail, AtmosphereParameterInvalidError, type AtmosphereProducerFailedDetail, AtmosphereProducerFailedError, type AtmosphereSunMissingDetail, AtmosphereSunMissingError, type EnvironmentSourceConflictDetail, EnvironmentSourceConflictError, type EquirectProjectionFailedDetail, type FogOwnerConflictDetail, FogOwnerConflictError, type FogParametersInvalidDetail, FogParametersInvalidError, ObservationUnavailableError, type RenderError, type RenderErrorCode, RenderFeatureCapabilityMissingError, RenderFeatureDrawRecordingFailedError, RenderFeaturePassOrderConflictError, RenderFeaturePreparationFailedError, RenderFeaturePreparedStateMismatchError, RenderFeatureRegistrationConflictError, RenderFeatureStageFailedError, type RenderValidationErrorCode, ResourceInvalidValueError, SpawnLightInvalidBoundsError, SpriteInstancesCountMismatchError, SpriteInstancesMutuallyExclusiveWithInstancesError, SpriteInstancesRequiresSpriteShaderError, TaaCapsInsufficientError, TemporalUnsupportedError, type TemporalUnsupportedReason, } from './errors/index';
+export { RecoverError, type RecoverErrorCode } from './errors/recover';
+export { resolveVisibility, type VisibilityResolution, type VisibilitySnapshot, } from './extract/visibility';
+/**
+ * Public producer seam: RenderFeature, its narrow stage contexts, structured
+ * diagnostics, graph contribution vocabulary, and prepared graphics facade.
+ * This root declaration is the AI-discoverable API authority; host
+ * construction details remain under the internal entry.
+ */
+export * from './features';
+export { createRenderFeatureTarget, type RenderFeatureTargetHandle, type RenderFeatureTargetInput, type RenderFeatureTargetKind, } from './features/targets';
+export { Materials, materialTextureValue } from './materials';
+export type { MeshMaterialBindingDiagnostic, MeshMaterialBindingObservation, MeshMaterialBindingSource, ResolvedMeshMaterialBinding, } from './mesh-material-bindings';
+export { type MeshNotResidentDetail, type MeshRangeInvalidDetail, type MeshRangeInvalidReason, type MeshShapeMismatchDetail, MeshUpdateError, type MeshUpdateErrorCode, } from './mesh-update-errors';
+export type { PersistentRenderSceneInspection, RenderSceneResyncReason, } from './persistent-render-scene';
+export { PipelineError, type PipelineErrorCode } from './pipeline-errors';
+export { ownedRendererPlugin, renderComponentsPlugin, rendererPlugin, renderFeaturePlugin, } from './plugin';
+export { PostProcessError, type PostProcessErrorCode } from './post-process-errors';
+export { type FrameObservation, type FrameObservationMetadata, type FrameObservationOptions, type FrameObservationReadback, type FrameObservationSource, observeCurrentFrame, } from './record/frame-observation';
+export { createMembershipTiming, MEMBERSHIP_TIMING_REASON_CODES, MEMBERSHIP_TIMING_REASON_MAPPING, MEMBERSHIP_TIMING_REASON_SCHEMA, type MembershipTimingController, MembershipTimingError, type MembershipTimingGpuOutputSource, type MembershipTimingGpuReport, type MembershipTimingOptions, type MembershipTimingReasonCode, type MembershipTimingReport, } from './record/membership-timing';
+export { TONEMAP_POST_PROCESS_ID } from './render-graph-primitives';
+export { type BuiltinEnvironmentPipeline, createEnvironmentPipelineTopology, type RenderColorDomain, type RenderPipeline, type RenderPipelineBuildContext, type RenderPipelineFeatureTarget, type RenderPipelineFrame, type RenderPipelineTopology, resolvePostColorDomainContract, resolveToneOutputContract, type ToneOutputContract, } from './render-pipeline';
+export type { RenderPipelineContext } from './render-pipeline-context';
+export { createRenderPipelineTarget, importRenderPipelineSurface, type RenderPipelineTarget, } from './render-pipeline-target';
+export type { RenderSceneInspection } from './render-system';
+export type { DrawOwnerOptions, HealthChangeListener, HealthDetailDeviceLost, HealthDetailInternalFault, HealthReason, HealthSnapshot, Renderer, RendererBackend, RendererError, RendererErrorListener, RendererInstallError, RendererLostInfo, RendererLostListener, RendererOptions, RenderPhase, RenderPhaseSkipReason, RenderResult, } from './renderer';
+export { RENDER_PHASE_CATALOG } from './renderer';
+export type { RhiBackendInstrumentation } from './renderer/backend-selection';
+export { ACTIVE_CAMERA_KEY, type ActiveCamera, getActiveCamera, setActiveCamera, } from './systems/active-camera';
+export type { TaaHistoryInspection, TaaHistoryResetReason } from './taa-history-store';
+export type { TemporalCoverageClass, TemporalCoverageContribution, TemporalCoverageSummary, TemporalMissingReason, TemporalProducerLane, TemporalReactiveReason, } from './temporal-coverage';
+export { TEMPORAL_MISSING_REASONS, TEMPORAL_PRODUCER_LANES, TEMPORAL_REACTIVE_REASONS, } from './temporal-coverage';
+export type { TemporalFrameTransactionInspection, TemporalHistoryDirection, } from './temporal-frame-transaction';
+export type { TemporalInspection, TemporalInspectionCoverage, TemporalInspectionRecovery, TemporalInspectionStatus, } from './temporal-inspection';
+export { addTypedBloomPasses, addTypedCompositePostEffects, addTypedFrameObservationPass, addTypedFullscreenPass, addTypedScenePass, addTypedSkyboxPass, addTypedSsaoPasses, addTypedTonemapPass, type TypedBloomTargets, type TypedFullscreenPassOptions, type TypedScenePassOptions, type TypedSsaoTargets, } from './typed-render-graph-primitives';
+export { URP_PIPELINE_ID } from './urp-pipeline';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.mjs

@@ -0,0 +1,5 @@
+export { MORPH_COMPUTE_WGSL, MORPH_MAX_TARGETS, createMorphFeature, createMorphReentryState, deriveMorphBounds, materialContribution, morphCullDecision, ownedRendererPlugin, renderComponentsPlugin, renderFeaturePlugin, renderPipelineContribution, rendererPlugin, samplerContribution, stepMorphReentry } from './chunk-LXNGO6AO.mjs';
+export { ACTIVE_CAMERA_KEY, MEMBERSHIP_TIMING_REASON_CODES, MEMBERSHIP_TIMING_REASON_MAPPING, MEMBERSHIP_TIMING_REASON_SCHEMA, MembershipTimingError, MeshUpdateError, PipelineError, PostProcessError, RENDER_FEATURE_VERTEX_LAYOUTS, RENDER_PHASE_CATALOG, RecoverError, RenderFeatureComputeGraphProjection, RenderFeatureGraphBufferRegistry, RenderFeatureRasterGraphProjection, SCENE_TEMPORAL_CLEAR_VALUE, SCENE_TEMPORAL_PACKED_ABI, SCENE_TEMPORAL_TARGET_FORMAT, SCENE_TEMPORAL_TARGET_SAMPLE_COUNT, TEMPORAL_MISSING_REASONS, TEMPORAL_PRODUCER_LANES, TEMPORAL_REACTIVE_REASONS, TONEMAP_POST_PROCESS_ID, URP_PIPELINE_ID, addTypedBloomPasses, addTypedCompositePostEffects, addTypedFrameObservationPass, addTypedFullscreenPass, addTypedScenePass, addTypedSkyboxPass, addTypedSsaoPasses, addTypedTonemapPass, createEnvironmentPipelineTopology, createMembershipTiming, createRenderFeatureContributionStaging, createRenderFeatureGpuWorkResolver, createRenderFeatureTarget, createRenderPipelineTarget, getActiveCamera, importRenderPipelineSurface, inspectEnvironmentGeneration, isRenderFeatureTargetHandle, observeCurrentFrame, projectFogEnvironment, projectRenderFeatureContributions, renderFeatureAttachmentResource, resolvePostColorDomainContract, resolveToneOutputContract, resolveVisibility, selectEnvironmentSource, setActiveCamera } from './chunk-A5QCJSNL.mjs';
+export { ANTIALIAS_FXAA, ANTIALIAS_MSAA, ANTIALIAS_NONE, ANTIALIAS_TAA, Atmosphere, AtmosphereCapsInsufficientError, AtmosphereCardinalityInvalidError, AtmosphereParameterInvalidError, AtmosphereProducerFailedError, AtmosphereSunMissingError, BLOOM_DISABLED, BLOOM_ENABLED, CAMERA_PROJECTION_ORTHOGRAPHIC, CAMERA_PROJECTION_PERSPECTIVE, Camera, DirectionalLight, EnvironmentSourceConflictError, Fog, FogOwnerConflictError, FogParametersInvalidError, Instances, Layer, Materials, MeshFilter, MeshRenderer, ObservationUnavailableError, PointLight, PointLightShadow, PostProcessParams, RenderFeatureCapabilityMissingError, RenderFeatureDrawRecordingFailedError, RenderFeaturePassOrderConflictError, RenderFeaturePreparationFailedError, RenderFeaturePreparedStateMismatchError, RenderFeatureRegistrationConflictError, RenderFeatureStageFailedError, ResourceInvalidValueError, SKYBOX_MODE_CUBEMAP, SceneInstance, SkyboxBackground, Skylight, SortKey, SpawnLightInvalidBoundsError, SpotLight, SpriteInstancesCountMismatchError, SpriteInstancesMutuallyExclusiveWithInstancesError, SpriteInstancesRequiresSpriteShaderError, TONEMAP_ACES_FILMIC, TONEMAP_AGX, TONEMAP_CINEON, TONEMAP_LINEAR, TONEMAP_NEUTRAL, TONEMAP_NONE, TONEMAP_REINHARD, TONEMAP_REINHARD_EXTENDED, TaaCapsInsufficientError, TemporalUnsupportedError, Visibility, VisibilityStateValue, antialiasFromF32, cameraProjectionFromF32, materialTextureValue, orthographic, perspective, skyboxModeFromF32, tonemapFromF32, tonemapToU32, visibilityStateFromU32 } from './chunk-YAKEQPWO.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}