@forgeax/engine-render 0.1.21 → 0.1.24

package/dist/assembly/factory.d.ts

@@ -1,238 +1,10 @@
-import { MeshSsboCapacityExceededError, MeshSsboCeilingReachedError } from '@forgeax/engine-assets-runtime';
-import type { Buffer, PipelineLayout, RhiDevice } from '@forgeax/engine-rhi';
-import { type MaterialShaderManifestEntry } from '@forgeax/engine-shader';
-import type { ImportTransport, ParamSchemaEntry } from '@forgeax/engine-types';
-export type { MaterialShaderManifestEntry } from '@forgeax/engine-shader';
-import type { RenderFeatureMaterialShaderBindingContract } from '../features/plan';
-import type { Renderer, RendererOptions } from '../render-contract';
+import type { RendererOptions } from '../render-contract';
 import { type RhiBackendPack } from './backend-contract';
-import type { RendererAssemblyImplementation, RendererHostImplementation } from './host-contract';
-export { assembleMaterialProjection } from './material/assembly';
-export { projectMaterialPipeline, routeMaterialPipeline, updateMaterialRuntimeValues, } from './material/pipeline-projection';
-/**
- * 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 duplicated structurally in `@forgeax/engine-app`
- * (BundlerOptions exported from packages/app); demos consume through the app
- * package, the engine accepts via this local minimal shape so packages/runtime
- * does NOT depend on packages/app (charter P4 + reverse-coupling deny-list).
- * TypeScript structural typing makes the two interchangeable at every call
- * site (M3 forgeaxBundlerAdapter() returns the same shape).
- */
-export interface BundlerOptions {
-    readonly importTransport?: ImportTransport | undefined;
-    readonly shaderManifestUrl?: string | undefined;
-}
-/** Build a Renderer from the backend pack supplied by the Runtime host. */
-/**
- * Per-variant PipelineLayout selector (M4.5 / D-10 option A).
- *
- * The resolved HDRP group(2) contract needs the 7-slot BGL chain
- * (`hdrpPbrPipelineLayout`); ordinary material contracts keep the 1-slot
- * mesh-array BGL chain (`pbrPipelineLayout`). Variant keys select source
- * artifacts only and never override this contract.
- *
- * Returns `null` when the selected layout is unavailable. An HDRP variant
- * never falls back to the URP layout: its clustered WGSL and group(2) ABI
- * must be admitted together or the draw fails closed.
- *
- * Pure function — exported for unit-test access (M4.5 / w35).
- */
-/**
- * Closed enum of pipeline-layout kinds the selector can dispatch to.
- *
- * `pbr` — standard PBR (1-entry mesh-array BGL).
- * `pbr-skin` — bug-20260611-skin-pipeline-layout: 3-entry mesh-array BGL
- *   (binding 0 meshes + binding 1 current palette + binding 2 previous
- *   palette) for the `forgeax::pbr-skin`
- *   material shader.
- * `hdrp-pbr` — feat-20260609 HDRP cluster-forward variant (7-slot group(2)
- *   BGL substituted at slot 2).
- * `sprite-urp` — bug-20260708 M2 (c): sprite / sprite-lit shaders reuse
- *   the URP 1-slot mesh-array BGL (they don't declare
- *   CLUSTER_FORWARD_AVAILABLE) but their canonical all-true variant key
- *   `''` (`SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET`) MUST NOT trigger
- *   the `variantSet===''` → HDRP branch of the selector. Callers
- *   (`buildPipelineContext`) resolve `sprite-urp` from the sprite
- *   `materialShaderId` and pass it through; the selector short-circuits
- *   to `pbrPipelineLayout` before the HDRP check.
- *
- * AC-09 grep gate: the selector body (`selectPipelineLayoutForVariant`)
- * **MUST NOT** contain literal `'forgeax::pbr-skin'` (or another
- * shader-id literal). The caller resolves `LayoutKind` upstream and passes
- * the structured value through (charter P4 consistent abstraction). New
- * material-shader layouts add a `LayoutKind` member + a PipelineState slot
- * + a switch arm here in one cut (charter P3 extensibility).
- */
-export type LayoutKind = 'pbr' | 'pbr-skin' | 'hdrp-pbr' | 'hdrp-skin' | 'sprite-urp' | 'unlit-urp';
-/** The closed group(2) contract resolved from the selected WGSL artifact. */
-export type { PipelineGroup2Contract } from '../pbr-pipeline';
-export { resolvePipelineGroup2Contract } from '../pbr-pipeline';
-/**
- * Return every device-capability HDRP PBR variant that needs a lazy module
- * label seeded during renderer boot. Color availability is intentionally not
- * filtered: colored and no-color meshes use distinct composed WGSL modules.
- * Transmission is filtered by the same sampled-texture capability gate as
- * Standard transmission because HDRP shares the material texture ABI.
- */
-export declare function selectHdrpPbrPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, transmissionCapable: boolean, directionalPcssAvailable?: boolean, projectorAvailable?: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
-/** Return every active-capability pbr-skin variant used by URP and HDRP draws. */
-export declare function selectSkinPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
-/**
- * Select both Standard transmission states from the manifest for exact-label
- * prewarming. The requested keys come from declared variants; no key is
- * synthesized and no source fallback is permitted.
- */
-export declare function selectStandardPbrTransmissionPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, directionalPcssAvailable?: boolean, projectorAvailable?: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
-/**
- * Select the PBR variant that matches a fallback mesh with no COLOR_0 input.
- * Unknown/custom material IDs may still use the legacy PBR fallback, so that
- * path must obey the same geometry-owned vertex-color axis as registered PBR.
- */
-export declare function selectNoColorPbrVariant(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, variantSet: string | undefined, directionalPcssAvailable?: boolean, projectorAvailable?: boolean): MaterialShaderManifestEntry['variants'][number] | undefined;
-export type MaterialShaderBindingContract = RenderFeatureMaterialShaderBindingContract;
-export type MaterialShaderVertexInputContract = 'none' | 'render-material';
-export declare function resolveMaterialShaderBindingContract(source: string): MaterialShaderBindingContract;
-export declare function resolveMaterialShaderVertexInputContract(source: string): MaterialShaderVertexInputContract;
-/**
- * Decide whether a custom material's user-region can use the shared PBR
- * bind-group layout. Resource names are not part of a WebGPU layout contract:
- * the only safe reuse test is that every derived binding in the custom schema
- * is an identical prefix of the canonical user-region descriptor, including
- * binding kind and its full shape (sample type, view dimension, sampler mode,
- * dynamic-offset flags, and visibility). A texture3d/array or comparison /
- * storage resource must therefore take the per-shader layout path even when
- * its field count is small.
- */
-export declare function isSharedMaterialUserRegionCompatible(paramSchema: readonly ParamSchemaEntry[]): boolean;
-export declare function allowsUnlitPreparedFallback(depthFormatOverride: GPUTextureFormat | null | undefined, vertexLayout: string | undefined, materialShaderId?: string): boolean;
-/**
- * Prepared VFX draws own their vertex inputs and bind groups. A missing
- * authored material shader is therefore retryable, but it is never safe to
- * substitute the built-in PBR module: PBR declares mesh/instance groups that
- * the VFX draw does not bind. Returning true keeps the feature on its
- * structured next-frame recovery path instead of creating an invalid PSO.
- */
-export declare function shouldDeferMissingPreparedMaterialShader(vertexLayout: string | undefined): boolean;
-export declare function selectPipelineLayoutForVariant(state: {
-    readonly pbrPipelineLayout: PipelineLayout | null;
-    readonly hdrpPbrPipelineLayout: PipelineLayout | null;
-    readonly pbrSkinPipelineLayout: PipelineLayout | null;
-    readonly hdrpSkinPipelineLayout?: PipelineLayout | null;
-} | null, _variantSet: string | undefined, layoutKind?: LayoutKind): PipelineLayout | null;
-/**
- * Resolve a requested material variant against the actual backend capabilities.
- * Record callers use the native-capability request; the backend-owned axes
- * must be rewritten before the request reaches shader lookup and PSO layout
- * selection.
- */
-export declare function resolveMaterialShaderVariantSet(requestedVariantSet: string | undefined, variants: ReadonlyArray<{
-    readonly defines: Readonly<Record<string, boolean>>;
-}>, backendKind: RhiDevice['caps']['backendKind'], storageBuffer: boolean, projectorAvailable?: boolean): string | undefined;
-/**
- * Keep a single-source material on its canonical module identity. A manifest
- * entry with no variants cannot consume a synthesized capability or geometry
- * axis, so carrying one into the pipeline cache only creates an uncached lazy
- * compile beside the prewarmed source module.
- */
-export declare function normalizeMaterialShaderVariantSet(requestedVariantSet: string | undefined, manifestEntry: MaterialShaderManifestEntry | undefined): string | undefined;
+import type { BundlerOptions } from './bundler-contract';
+import type { RendererAssemblyImplementation } from './host-contract';
+export type { BundlerOptions } from './bundler-contract';
+export type { LayoutKind, MaterialShaderBindingContract, MaterialShaderManifestEntry, MaterialShaderVertexInputContract, MeshSsboBufferWrapper, MeshSsboGrowController, MeshSsboGrowControllerInit, MeshSsboGrowDevice, MeshSsboGrowErrorRegistry, MeshSsboGrowResult, MeshSsboState, } from './webgpu-renderer';
+export { allowsUnlitPreparedFallback, assembleMaterialProjection, createMeshSsboGrowController, deriveStorageBufferCeiling, exposeRenderer, isSharedMaterialUserRegionCompatible, normalizeMaterialShaderVariantSet, projectMaterialPipeline, resolveMaterialShaderBindingContract, resolveMaterialShaderVariantSet, resolveMaterialShaderVertexInputContract, routeMaterialPipeline, selectHdrpPbrPrewarmVariants, selectNoColorPbrVariant, selectPipelineLayoutForVariant, selectProbePrewarmVariants, selectSkinPrewarmVariants, selectStandardPbrTransmissionPrewarmVariants, shouldDeferMissingPreparedMaterialShader, updateMaterialRuntimeValues, } from './webgpu-renderer';
+/** Build a renderer after selecting the host-supplied backend pack. */
 export declare function createRenderer(canvas: unknown, options?: RendererOptions, bundler?: BundlerOptions, backend?: RhiBackendPack): Promise<RendererAssemblyImplementation>;
-/** Narrow the concrete host to the lease/receipt-only public contract. */
-export declare function exposeRenderer(renderer: RendererHostImplementation): Renderer;
-/**
- * Derive a usable storage-buffer ceiling from device limits.
- *
- * Mirrors the `SKIN_PALETTE_MAX_BINDING_BYTES` 0/undefined floor pattern
- * (createRenderer.ts:4070-4073): when `maxStorageBufferBindingSize` is 0 or
- * undefined (WebKit `downlevel_webgl2_defaults`), climb the fallback chain —
- * `maxBufferSize` → `maxUniformBufferBindingSize` → WebGPU spec floor
- * 134217728 (128 MiB).
- *
- * Pure helper — no device dependency, directly testable in node.
- */
-export declare function deriveStorageBufferCeiling(limits: Readonly<{
-    maxStorageBufferBindingSize?: number;
-    maxBufferSize?: number;
-    maxUniformBufferBindingSize?: number;
-}>): number;
-/**
- * Mesh + material buffer wrapper carrying the inner `Buffer` handle plus
- * the byte-size at the time of allocation. The wrapper-object identity is
- * stable across grow events — only `.buffer` and `.sizeInBytes` are mutated
- * in place — so `PipelineState.meshStorageBuffer` / `materialUniformBuffer`
- * fields capture the wrapper once and survive grow events without a re-bind
- * cycle through the public Renderer surface (research §F8 R1).
- */
-export interface MeshSsboBufferWrapper {
-    buffer: Buffer | null;
-    sizeInBytes: number;
-}
-/** Closure-local grow state surfaced for spy assertions in unit tests. */
-export interface MeshSsboState {
-    slotCount: number;
-    mesh: MeshSsboBufferWrapper;
-    material: MeshSsboBufferWrapper;
-}
-/** `growMeshSsbo` return shape (D-5: Result-like, never throws). */
-export type MeshSsboGrowResult = {
-    readonly ok: true;
-} | {
-    readonly ok: false;
-    readonly code: 'mesh-ssbo-ceiling-reached' | 'mesh-ssbo-capacity-exceeded';
-    /** Pre-grow slotCount — the caller can render up to this many slots (degraded subset). */
-    readonly degradedToSlotCount: number;
-};
-/** Minimal device surface the grow controller needs (mocked in unit tests). */
-export interface MeshSsboGrowDevice {
-    readonly limits: {
-        readonly maxStorageBufferBindingSize: number;
-    };
-    readonly createBuffer: (descriptor: {
-        readonly label?: string;
-        readonly size: number;
-        readonly usage: number;
-        readonly mappedAtCreation?: boolean;
-    }) => Buffer;
-}
-/** Minimal error-registry surface (just `fire` — `RhiErrorListenerRegistry` matches). */
-export interface MeshSsboGrowErrorRegistry {
-    fire: (e: MeshSsboCeilingReachedError | MeshSsboCapacityExceededError) => void;
-}
-export interface MeshSsboGrowControllerInit {
-    readonly device: MeshSsboGrowDevice;
-    readonly errorRegistry: MeshSsboGrowErrorRegistry;
-    readonly initialSlotCount: number;
-    readonly perEntityStride: number;
-    readonly meshUsage: number;
-    readonly materialUsage: number;
-}
-export interface MeshSsboGrowController {
-    readonly state: MeshSsboState;
-    /** Allocate the initial mesh + material buffer pair at `initialSlotCount`. */
-    readonly initialBuild: () => void;
-    /** Grow to satisfy `neededSlots`; idempotent + ceiling-aware. */
-    readonly growMeshSsbo: (neededSlots: number) => MeshSsboGrowResult;
-}
-/**
- * Build a closure-scoped mesh-SSBO grow controller. Module-scope so unit
- * tests (`__tests__/mesh-ssbo-grow.test.ts`) can construct it with a fake
- * device + spy errorRegistry without spinning up the full WebGPU renderer
- * (charter F2 minimal surface — the controller is the testable seam).
- */
-export declare function createMeshSsboGrowController(init: MeshSsboGrowControllerInit): MeshSsboGrowController;
 //# sourceMappingURL=factory.d.ts.map

package/dist/assembly/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/assembly/factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/assembly/factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAqCtE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EACV,UAAU,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,iCAAiC,EACjC,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,cAAc,EACd,oCAAoC,EACpC,iCAAiC,EACjC,uBAAuB,EACvB,oCAAoC,EACpC,+BAA+B,EAC/B,wCAAwC,EACxC,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,4CAA4C,EAC5C,wCAAwC,EACxC,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAqD3B,uEAAuE;AACvE,wBAAsB,cAAc,CAClC,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,8BAA8B,CAAC,CAqBzC"}

package/dist/assembly/host-contract.d.ts

@@ -5,6 +5,7 @@ import type { RenderPipelineAsset } from '@forgeax/engine-types';
 import type { RecoverFailure } from '../errors/recover';
 import type { ObservationUnavailableError, RenderError } from '../errors/render';
 import type { RenderFeature, RenderFeatureDiagnostics } from '../features/types';
+import type { GpuDrivenProductionInspection, LodOcclusionInspection } from '../inspection-types';
 import type { MeshMaterialBindingObservation } from '../mesh-material-bindings';
 import type { FrameObservation, FrameObservationOptions } from '../record/frame';
 import type { CurrentGraphTarget, GraphTargetCaptureRequest } from '../record/frame-snapshot';
@@ -38,6 +39,15 @@ export interface RendererHostImplementation {
     destroyRenderTarget(target: RenderTarget): RenderResult<void, RenderError>;
     setProfile(profile: RenderProfile): RenderResult<void, RenderError>;
     inspect(): RenderInspection;
+    /**
+     * Internal bounded inspection for high-cardinality producers. The public
+     * snapshot also carries the full persistent render-scene record table, which
+     * is intentionally not materialized for per-frame performance evidence.
+     */
+    inspectLodOcclusion(): {
+        readonly lodOcclusion: LodOcclusionInspection | undefined;
+        readonly gpuDriven: GpuDrivenProductionInspection;
+    };
     drawFrame(request: RenderFrameInput): RenderResult<FrameReceipt, RhiError | RenderError>;
     observe(receipt: FrameReceipt, request: FrameObservationRequest): Promise<RenderResult<FrameReceiptObservation, RenderError>>;
     releaseSurface(): RenderResult<void, RhiError>;

package/dist/assembly/host-contract.d.ts.map

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

package/dist/assembly/material/assembly.d.ts

@@ -1,5 +1,5 @@
-import type { CookedMaterialRecord } from '@forgeax/engine-pack/material-cook';
-import type { MaterialValue } from '@forgeax/engine-types';
+import { type CookedMaterialRecord } from '@forgeax/engine-pack/material-cook';
+import type { MaterialValue, StandardLayerPlan } from '@forgeax/engine-types';
 export interface MaterialRenderPassProjection {
     readonly name: string;
     readonly module: string;
@@ -16,6 +16,7 @@ export interface MaterialRenderProjection {
     readonly passes: readonly MaterialRenderPassProjection[];
     readonly runtimeValues: Readonly<Record<string, MaterialValue | null>>;
     readonly staticSelection: readonly string[];
+    readonly layerPlan: StandardLayerPlan;
 }
 export declare function assembleMaterialProjection(record: CookedMaterialRecord): MaterialRenderProjection;
 //# sourceMappingURL=assembly.d.ts.map

package/dist/assembly/material/assembly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assembly.d.ts","sourceRoot":"","sources":["../../../src/assembly/material/assembly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACzD,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAkBD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,wBAAwB,CASjG"}
+{"version":3,"file":"assembly.d.ts","sourceRoot":"","sources":["../../../src/assembly/material/assembly.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG9E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACzD,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAkBD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,wBAAwB,CAoBjG"}

package/dist/assembly/material/standard-layer-projection.d.ts

@@ -0,0 +1,10 @@
+import type { MaterialParameter, MaterialPass, StandardLayerPlan } from '@forgeax/engine-types';
+/**
+ * Renderer projection of the compiler-owned Standard layer contract.
+ *
+ * The renderer receives the prepared parameter/pass snapshot and never keeps
+ * a second parameter-name inventory. This function is intentionally pure so
+ * assembly and tests observe the same mode and pass family as cooking.
+ */
+export declare function projectStandardLayerPlan(parameters: readonly MaterialParameter[], passes: readonly MaterialPass[]): StandardLayerPlan;
+//# sourceMappingURL=standard-layer-projection.d.ts.map

package/dist/assembly/material/standard-layer-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-layer-projection.d.ts","sourceRoot":"","sources":["../../../src/assembly/material/standard-layer-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAGhG;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,iBAAiB,CAEnB"}

package/dist/assembly/material-shader-policy.d.ts

@@ -0,0 +1,168 @@
+import type { AssetRegistry } from '@forgeax/engine-assets-runtime';
+import type { PipelineLayout, Result, RhiDevice, ShaderModule } from '@forgeax/engine-rhi';
+import { RhiError } from '@forgeax/engine-rhi';
+import { type MaterialShaderManifestEntry, type ShaderCatalog, type ShaderCatalogDevice } from '@forgeax/engine-shader';
+import type { ParamSchemaEntry } from '@forgeax/engine-types';
+import type { RenderFeatureMaterialShaderBindingContract } from '../features/plan';
+import type { RhiErrorListenerRegistry } from '../lifecycle';
+/**
+ * Sync-shaped `ShaderCatalogDevice` adapter wrapping the backend pack's
+ * async `createShaderModule(rhiDevice, desc)`.
+ *
+ * Shape: fire-and-forget pre-bake — the first call for hash X returns
+ * `Result.err(RhiError)` (a pending signal) while kicking off the async
+ * createShaderModule + cache write; subsequent calls for the same hash hit
+ * the cache and return `Result.ok(ShaderModule)` (charter proposition 9
+ * graceful degradation).
+ *
+ * @placeholder M3 scope limit: the full async pre-bake wiring is delivered
+ * by the ECS-driven render pipeline (later closure). The current shape is
+ * already enough to support MVP-2.2 instance-per-engine + AI consumer
+ * onboarding (charter proposition 1 progressive disclosure / proposition 4
+ * explicit failure with retry guidance in the error hint).
+ */
+/**
+ * Extended ShaderCatalogDevice contract for engine internals: adds a
+ * `seedModule(label, module)` to populate the lazy adapter cache from an
+ * already-compiled module, so eager-built modules (PBR / unlit / shadow
+ * caster) and the lazy MaterialShader pipeline cache share one cache and
+ * the lazy path is hit-on-first-call (no 1-frame warmup) for engine-shipped
+ * shaders. Externally still typed as ShaderCatalogDevice (see callers in
+ * ShaderCatalog).
+ */
+export interface ShaderDeviceAdapterInternal extends ShaderCatalogDevice {
+    /**
+     * feat-20260609 R3-fixup: seed the adapter's moduleCache with an
+     * already-compiled ShaderModule under `label`. Used by the eager
+     * shadow_caster pre-bake so the lazy PSO build hit on
+     * `module-forgeax::default-shadow-caster` returns OK on frame 1.
+     */
+    seedModule(label: string, module: ShaderModule): void;
+    invalidateModule(label: string): void;
+}
+type ShaderModuleAdapterMode = 'validated' | 'immediate';
+export declare function makeShaderDeviceAdapter(rhiDevice: RhiDevice, _errorRegistry: RhiErrorListenerRegistry, asyncCreateShaderModule: ((device: RhiDevice, desc: {
+    code: string;
+    label?: string | undefined;
+}) => Promise<Result<ShaderModule, RhiError>>) | undefined, immediateCreateShaderModule: ((device: RhiDevice, desc: {
+    code: string;
+    label?: string | undefined;
+}) => Result<ShaderModule, RhiError>) | undefined, mode?: ShaderModuleAdapterMode): ShaderDeviceAdapterInternal;
+/**
+ * Fallback path for the M3 D-P4 auto-select facade when the backend pack
+ * does not supply a top-level async `createShaderModule` (e.g. the rhi-wgpu
+ * path which routes through the synchronous `device.createShaderModule`
+ * entry, or an explicit escape-hatch instance that omits the async
+ * factory). The forgeax `RhiDevice` interface intentionally does not expose
+ * a sync `createShaderModule` (fix-f3; see packages/rhi/src/index.ts line
+ * 1164), so this helper performs a structural probe + returns a structured
+ * error when neither the async factory nor a structural sync entry exists
+ * (charter proposition 4 explicit failure baseline).
+ */
+export declare function invokeDeviceCreateShaderModule(rhiDevice: RhiDevice, desc: {
+    code: string;
+    label?: string | undefined;
+}): Promise<Result<ShaderModule, RhiError>>;
+/**
+ * bug-20260601-hello-tonemap-material-register M1: prepare engine-shipped
+ * material shaders (cap gate + manifest load + registration) before the
+ * renderer is returned so that `register<MaterialAsset>` referencing an
+ * engine shader (e.g. `forgeax::default-standard-pbr`) succeeds without
+ * waiting for `renderer.initialization` (plan-strategy D-1/D-2/D-5).
+ *
+ * Failures (cap-gate insufficient, manifest-malformed, shader-not-found)
+ * throw structured `RhiError` / `ShaderError` which propagate through
+ * `createRenderer`'s synchronous reject path (D-2 structured reject).
+ */
+export declare function prepareMaterialShaders(rhiDevice: RhiDevice, getShader: () => ShaderCatalog, assets: AssetRegistry, materialShaderUvSetCounts: Map<string, number>): Promise<void>;
+/**
+ * Per-variant PipelineLayout selector (M4.5 / D-10 option A).
+ *
+ * The HDRP variant (`CLUSTER_FORWARD_AVAILABLE=true` or canonical `''`
+ * all-true when the shader declares the cluster axis) needs the 7-slot
+ * group(2) BGL chain (`hdrpPbrPipelineLayout`); URP variants
+ * (`CLUSTER_FORWARD_AVAILABLE=false` / undefined / no axis) keep the
+ * 1-slot mesh-array BGL chain (`pbrPipelineLayout`).
+ *
+ * Returns `null` only when the URP fallback layout itself is null
+ * (Camera-only / empty-manifest path). When the HDRP layout is null but
+ * URP exists, the HDRP variant gracefully falls back to URP — the WGSL
+ * resolved upstream by `findVariantByKey` is the URP variant in that
+ * case (manifest entry with all-true definesKey === '' was registered
+ * with isHdrpActive=false at boot when storage-buffer caps are absent).
+ *
+ * Pure function — exported for unit-test access (M4.5 / w35).
+ */
+/**
+ * Closed enum of pipeline-layout kinds the selector can dispatch to.
+ *
+ * `pbr` — standard PBR (1-entry mesh-array BGL).
+ * `pbr-skin` — bug-20260611-skin-pipeline-layout: 2-entry mesh-array BGL
+ *   (binding 0 meshes + binding 1 palette) for the `forgeax::pbr-skin`
+ *   material shader.
+ * `hdrp-pbr` — feat-20260609 HDRP cluster-forward variant (7-slot group(2)
+ *   BGL substituted at slot 2).
+ * `sprite-urp` — bug-20260708 M2 (c): sprite / sprite-lit shaders reuse
+ *   the URP 1-slot mesh-array BGL (they don't declare
+ *   CLUSTER_FORWARD_AVAILABLE) but their canonical all-true variant key
+ *   `''` (`SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET`) MUST NOT trigger
+ *   the `variantSet===''` → HDRP branch of the selector. Callers
+ *   (`buildPipelineContext`) resolve `sprite-urp` from the sprite
+ *   `materialShaderId` and pass it through; the selector short-circuits
+ *   to `pbrPipelineLayout` before the HDRP check.
+ *
+ * AC-09 grep gate: the selector body (`selectPipelineLayoutForVariant`)
+ * **MUST NOT** contain literal `'forgeax::pbr-skin'` (or another
+ * shader-id literal). The caller resolves `LayoutKind` upstream and passes
+ * the structured value through (charter P4 consistent abstraction). New
+ * material-shader layouts add a `LayoutKind` member + a PipelineState slot
+ * + a switch arm here in one cut (charter P3 extensibility).
+ */
+export type LayoutKind = 'pbr' | 'pbr-skin' | 'hdrp-pbr' | 'hdrp-skin' | 'sprite-urp' | 'unlit-urp';
+export declare function isSharedMaterialUserRegionCompatible(paramSchema: readonly ParamSchemaEntry[]): boolean;
+/**
+ * Select the PBR variant that matches a fallback mesh with no COLOR_0 input.
+ * Unknown/custom material IDs may still use the legacy PBR fallback, so that
+ * path must obey the same geometry-owned vertex-color axis as registered PBR.
+ */
+export declare function selectNoColorPbrVariant(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, variantSet: string | undefined, extendedLightingShaderAvailable?: boolean, directionalPcssAvailable?: boolean, projectorAvailable?: boolean): MaterialShaderManifestEntry['variants'][number] | undefined;
+export type MaterialShaderBindingContract = RenderFeatureMaterialShaderBindingContract;
+export type MaterialShaderVertexInputContract = 'none' | 'render-material';
+export declare function resolveMaterialShaderBindingContract(source: string): MaterialShaderBindingContract;
+export declare function resolveMaterialShaderVertexInputContract(source: string): MaterialShaderVertexInputContract;
+export declare function allowsUnlitPreparedFallback(depthFormatOverride: GPUTextureFormat | null | undefined, vertexLayout: string | undefined, materialShaderId?: string): boolean;
+/**
+ * Prepared VFX draws own their vertex inputs and bind groups. A missing
+ * authored material shader is therefore retryable, but it is never safe to
+ * substitute the built-in PBR module: PBR declares mesh/instance groups that
+ * the VFX draw does not bind. Returning true keeps the feature on its
+ * structured next-frame recovery path instead of creating an invalid PSO.
+ */
+export declare function shouldDeferMissingPreparedMaterialShader(vertexLayout: string | undefined): boolean;
+export declare function selectPipelineLayoutForVariant(state: {
+    readonly pbrPipelineLayout: PipelineLayout | null;
+    readonly pbrProbePipelineLayout?: PipelineLayout | null;
+    readonly hdrpPbrPipelineLayout: PipelineLayout | null;
+    readonly hdrpProbePbrPipelineLayout?: PipelineLayout | null;
+    readonly pbrSkinPipelineLayout: PipelineLayout | null;
+    readonly pbrSkinProbePipelineLayout?: PipelineLayout | null;
+    readonly hdrpSkinPipelineLayout?: PipelineLayout | null;
+} | null, variantSet: string | undefined, layoutKind?: LayoutKind): PipelineLayout | null;
+/**
+ * Resolve a requested material variant against the actual backend capabilities.
+ * Record callers use the native-capability request; the backend-owned axes
+ * must be rewritten before the request reaches shader lookup and PSO layout
+ * selection.
+ */
+export declare function resolveMaterialShaderVariantSet(requestedVariantSet: string | undefined, variants: ReadonlyArray<{
+    readonly defines: Readonly<Record<string, boolean>>;
+}>, backendKind: RhiDevice['caps']['backendKind'], storageBuffer: boolean, maxSampledTexturesPerShaderStageOrProjectorAvailable?: number | boolean): string | undefined;
+/**
+ * Keep a single-source material on its canonical module identity. A manifest
+ * entry with no variants cannot consume a synthesized capability or geometry
+ * axis, so carrying one into the pipeline cache only creates an uncached lazy
+ * compile beside the prewarmed source module.
+ */
+export declare function normalizeMaterialShaderVariantSet(requestedVariantSet: string | undefined, manifestEntry: MaterialShaderManifestEntry | undefined): string | undefined;
+export {};
+//# sourceMappingURL=material-shader-policy.d.ts.map

package/dist/assembly/material-shader-policy.d.ts.map

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

package/dist/assembly/material-shader-prewarm.d.ts

@@ -0,0 +1,21 @@
+import type { Result, RhiDevice, ShaderModule } from '@forgeax/engine-rhi';
+import { RhiError } from '@forgeax/engine-rhi';
+import type { ShaderCatalog } from '@forgeax/engine-shader';
+type AsyncCreateShaderModule = (device: RhiDevice, desc: {
+    code: string;
+    label?: string | undefined;
+}) => Promise<Result<ShaderModule, RhiError>>;
+/**
+ * Prewarm producer-declared material shaders and all published capability
+ * variants before the first prepared frame. Variant labels mirror the lazy
+ * material pipeline adapter's module lookup contract.
+ */
+export declare function prewarmRequiredMaterialShaders({ rhiDevice, registry, asyncCreateShaderModule, requiredMaterialShaders, seedShaderModule, }: {
+    readonly rhiDevice: RhiDevice;
+    readonly registry: ShaderCatalog;
+    readonly asyncCreateShaderModule: AsyncCreateShaderModule | undefined;
+    readonly requiredMaterialShaders: readonly string[];
+    readonly seedShaderModule: (label: string, module: ShaderModule) => void;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=material-shader-prewarm.d.ts.map

package/dist/assembly/material-shader-prewarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-shader-prewarm.d.ts","sourceRoot":"","sources":["../../src/assembly/material-shader-prewarm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAK5D,KAAK,uBAAuB,GAAG,CAC7B,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;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,EACnD,SAAS,EACT,QAAQ,EACR,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,GACjB,EAAE;IACD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,uBAAuB,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CAC1E,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DhB"}