@forgeax/engine-render 0.1.23 → 0.1.24

package/README.md

@@ -42,12 +42,31 @@ capability facts, then `observe(receipt, request)` for receipt-bound evidence.
 
 ### AI cold-start route
 
-An AI consumer can start with the public sequence `createRenderer -> attach ->
-draw -> inspect -> observe`. Keep the draw input unchanged when retrying. On a
-failure, branch on `error.code`; read the correlated `expected`, `hint`, and
-typed `detail`, repair that owner, and submit the same request again. Public
-consumers do not parse `message` and never receive graph nodes, devices,
-history textures, or prepared handles.
+An AI consumer can start with the public sequence `state -> inspect -> recover
+-> FrameReceipt`. `Renderer.state()` is the closed lifecycle union: only
+`alive` admits a frame; `device-lost` permits one explicit recovery flight;
+`recovering` shares that flight; `faulted` requires a new Renderer; and
+`disposed` is terminal. `inspect()` is detached POD evidence for the current
+state and recovery attempt. After `recover()` succeeds, submit the unchanged
+draw input and use the new `FrameReceipt` as the proof for that generation.
+
+`inspect().recovery` is always present. Its `phase` is `null` outside an active
+attempt and otherwise follows `quiesce`, `acquire-adapter`, `acquire-device`,
+`rehydrate`, `compile-graph`, `publish`, and `cleanup`. The projection also
+reports the `fromGeneration`/`candidateGeneration` fence, monotonic `attempt`,
+`lastOutcome`, committed `rehydratedRoots`, and bounded `staleLossEvents`.
+These are detached facts; they never expose devices, graphs, textures, or
+mutable resource collections.
+
+During `device-lost` or `recovering`, the App keeps its host heartbeat but does
+not advance the World or submit a frame. A failed `Result` is repaired from
+`error.code`, `expected`, `hint`, and typed `detail`: wait for the shared
+recovery flight, explicitly retry, repair the named owner, or create a new
+Renderer according to the closed error. Do not parse `message`. Target and
+history tokens retain logical identity, but their new-generation contents are
+uninitialized until a successful receipt; a neutral target or last-known-good
+fallback is not proof of real recovery. Public consumers never receive graph
+nodes, devices, history textures, or prepared handles.
 
  The current-source manifest and schema identify `source`, `build`, `backend`,
  `runner`, and `frameIdentity`. Structural graph receipts, Browser/Dawn
@@ -74,6 +93,26 @@ plan. Register it at construction with
 `createRenderer(canvas, { features: [feature] })`. A feature never receives a
 device, queue, encoder, staging builder, or submit callback.
 
+## RenderFeature: the producer seam (first-read index)
+
+The public route is one `RenderFeature<FrameData>` through the active RenderGraph
+and `Standard Pipeline`. Here `type FrameData` is the
+producer-owned extracted value; `plan(data, context)` declares named resources and passes.
+Register it with
+`createRenderer(canvas, { features: [feature] })`. The renderer derives graph
+access, preparation, recording, and recovery; the feature never receives a
+device, queue, encoder, or submit callback. Each declaration becomes a
+`RenderGraph pass` inside the active frame submit boundary.
+
+### Material contract projection
+
+Render consumes only the Pack-owned material publication projection. Its
+inputs are runtime bool/value data, composed module slots, and the closed
+compiler context; render never authors, cooks, writes DDC, or selects a
+fallback material. The projection preserves `layoutIdentity`,
+`programIdentity`, `cookIdentity`, and `materialPublicationIdentity` so a
+stale draw can be traced to the first producer divergence.
+
 ### Directional shadow quality: author → inspect → recover
 
 `DirectionalLight` is the only authoring entry for directional shadow quality.
@@ -501,6 +540,70 @@ Render owns this consumption route:
 | `cook` output | Record only validated shader artifacts. |
 | `recovery` | Preserve the structured failure so the source contract or cooked module can be repaired. |
 
+## Standard physical material authoring
+
+`Materials.standard` is the public authoring entry point for the Standard
+root. It emits one `MaterialAsset.parameters` contract; values and texture
+coordinates are projections of that contract, not a second feature mask. A
+base-only root keeps `forward + deferred + shadow`, while declaring any
+second-stage layer or physical texture selects `forward + shadow`.
+
+```ts
+import { Materials } from '@forgeax/engine-render';
+
+const material = Materials.standard({
+  baseColor: [0.72, 0.48, 0.22, 1],
+  metallic: 0,
+  roughness: 0.34,
+  clearcoat: 0.7,
+  clearcoatRoughness: 0.18,
+  anisotropyStrength: 0.35,
+  anisotropyRotation: Math.PI / 2,
+  sheenColor: [0.08, 0.03, 0.02],
+  sheenRoughness: 0.25,
+  iridescence: 0.5,
+  iridescenceIor: 1.4,
+  iridescenceThicknessMinimum: 120,
+  iridescenceThicknessMaximum: 380,
+  specular: 0.9,
+  specularColor: [1, 0.92, 0.8],
+  ior: 1.5,
+});
+```
+
+The layer contract and texture semantics are fixed at the root:
+
+| Layer / slot | Defaults | Texture facts | Pass / frame rule |
+|:--|:--|:--|:--|
+| `clearcoat`, `clearcoatRoughness` | `0`, `0` | `clearcoatTexture.R`, `clearcoatRoughnessTexture.G`, `clearcoatNormalTexture.RG` | coat normal needs `NORMAL + UV + tangent`; coat energy attenuates the base |
+| `anisotropyStrength`, `anisotropyRotation` | `0`, `0` radians | `anisotropyTexture.RG` direction, `.B` strength | always needs a tangent frame; rotation changes the GGX highlight axis |
+| `sheenColor`, `sheenRoughness` | `[0,0,0]`, `0` | color RGB is sRGB; roughness A is linear | Charlie lobe stays below clearcoat and uses existing IBL resources |
+| `iridescence`, `iridescenceIor`, `iridescenceThickness*` | `0`, `1.3`, `100..400 nm` | strength R, thickness G; min may exceed max | bounded thin-film Fresnel modifies base reflection |
+| `specular`, `specularColor`, `ior` | `1`, `[1,1,1]`, `1.5` | `specularTexture.A` and `specularColorTexture.RGB` (sRGB for color) | dielectric F0 uses valid IOR; metallic uses the base metal response |
+
+> [!CAUTION]
+> A missing or conflicting anisotropy tangent input returns the structured
+> `material-tangent-required` error. Repair the mesh producer by supplying a
+> finite `TANGENT : vec4` (including `.w` handedness), or by supplying
+> `NORMAL`, the selected UV set, and triangle topology so the importer can
+> generate and persist the frame. Do not substitute an identity or derivative
+> fallback.
+
+For a texture, pass a `MaterialTextureValue` when the slot needs a sampler or
+non-default coordinates; `coordinates.set` and `coordinates.transform` stay
+with that slot. glTF authors use the same fields through the importer, which
+preserves the chain `parse → MaterialAsset → cook → Pack refs → load`.
+
+The public recovery path is:
+
+```mermaid
+flowchart LR
+  A["inspect root and receipt"] --> B["branch on error.code"]
+  B --> C["repair source, mesh, or root"]
+  C --> D["re-import / re-cook"]
+  D --> E["load the new generation and draw"]
+```
+
 ### Mesh material binding resolution
 
 Render resolves one effective material table per logical mesh slot before
@@ -518,6 +621,25 @@ uses the neutral engine material.
 
 The render path is `MaterialAsset` -> extract snapshot -> prepare resources -> record the per-slot `coordinates` and values. The effective `parent` is already resolved before extract. If a material contract or reflection binding fails, preserve the structured error and repair the source contract or cooked module before drawing again; that is the recovery route. The render package owns consumption, not material import or cook policy.
 
+### Materials factory color inputs
+
+The high-level `Materials.standard` and `Materials.unlit` factories normalize
+authored colors at their boundary. Numeric RGB/RGBA tuples are linear-sRGB and
+are copied unchanged; CSS/Hex strings and `0xRRGGBB` integers are sRGB inputs
+and are decoded once. Use `Materials.srgb(tuple)` when a numeric tuple is known
+to be sRGB. Generated assets carry `colorSpace: 'linear'`, so extraction does
+not decode them a second time. The low-level `MaterialAsset` contract remains
+authored-sRGB by default for serialized `type: 'color'` values; mark those
+values `colorSpace: 'linear'` when they are already linear. Texture color space
+continues to come from each texture asset and is not overridden by material
+array metadata.
+
+```ts
+const linear = Materials.standard({ baseColor: [0.5, 0.5, 0.5, 1] });
+const css = Materials.standard({ baseColor: '#808080' });
+const explicitSrgb = Materials.unlit(Materials.srgb([0.5, 0.5, 0.5, 1]));
+```
+
 ### Resident material observation
 
 `renderer.inspect().meshMaterialBindings[]` is the detached observation of the
@@ -778,9 +900,9 @@ and emits indirect arguments with `firstInstance = 0`.
 
 The Standard frame activates the production raster lane when compute, storage
 buffers, and indirect drawing are available. The current lane accepts opaque,
-rigid default-unlit passes with batch-stable render state, ordinary instances,
-indexed or non-indexed geometry, multiple submeshes and material slots, and the
-canonical `12F` vertex layout. It also accepts persistent rigid multi-World
+rigid default-unlit triangle-list passes with batch-stable render state,
+ordinary instances, indexed or non-indexed geometry, multiple submeshes and
+material slots, and the canonical `12F` vertex layout. It also accepts persistent rigid multi-World
 composition. Candidates come from the complete persistent projection rather
 than the CPU-visible snapshot. The same typed graph imports the scene and mesh
 buffers, runs the three compute passes, and consumes generated arguments with

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

@@ -0,0 +1,9 @@
+import type { ImportTransport } from '@forgeax/engine-types';
+/** Build-tool inputs forwarded from the host into renderer assembly. */
+export interface BundlerOptions {
+    readonly importTransport?: ImportTransport | undefined;
+    readonly shaderManifestUrl?: string | undefined;
+    /** Exact checkout revision emitted by the build-tool adapter. */
+    readonly build?: string | undefined;
+}
+//# sourceMappingURL=bundler-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundler-contract.d.ts","sourceRoot":"","sources":["../../src/assembly/bundler-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC"}

package/dist/assembly/device-feature-admission.d.ts

@@ -1,5 +1,13 @@
 import type { RhiAdapter, RhiDevice } from '@forgeax/engine-rhi';
 export declare const STANDARD_PBR_REQUIRED_SAMPLED_TEXTURES = 17;
+/**
+ * The complete Standard physical root can declare all optional texture slots.
+ * Its material group therefore needs one more sampled-texture entry than the
+ * extended-lighting topology alone. Request this ceiling when the adapter can
+ * provide it; lower-capability devices remain fail-closed at material
+ * pipeline admission instead of receiving an invalid WebGPU layout.
+ */
+export declare const STANDARD_PHYSICAL_REQUIRED_SAMPLED_TEXTURES = 21;
 export interface DeviceFeatureAdmissionOptions {
     readonly gpuPassTiming?: object | undefined;
     readonly captureGpuTimings?: boolean | undefined;

package/dist/assembly/device-feature-admission.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device-feature-admission.d.ts","sourceRoot":"","sources":["../../src/assembly/device-feature-admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAejE,eAAO,MAAM,sCAAsC,KAAK,CAAC;AAEzD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE;QACxB,QAAQ,CAAC,gCAAgC,EAAE,MAAM,CAAC;KACnD,CAAC;CACH;AAED,KAAK,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9F,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,CAwBxB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,GAAG,SAAS,CAKpC;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,4BAA4B,CAAC,GAC7E,OAAO,CAOT"}
+{"version":3,"file":"device-feature-admission.d.ts","sourceRoot":"","sources":["../../src/assembly/device-feature-admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAejE,eAAO,MAAM,sCAAsC,KAAK,CAAC;AACzD;;;;;;GAMG;AACH,eAAO,MAAM,2CAA2C,KAAK,CAAC;AAE9D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE;QACxB,QAAQ,CAAC,gCAAgC,EAAE,MAAM,CAAC;KACnD,CAAC;CACH;AAED,KAAK,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9F,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,CA0BxB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,GAAG,SAAS,CAKpC;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,4BAA4B,CAAC,GAC7E,OAAO,CAOT"}

package/dist/assembly/extended-lighting-fallback.d.ts

@@ -0,0 +1,13 @@
+import type { Buffer, RhiDevice, Texture, TextureView } from '@forgeax/engine-rhi';
+export interface ExtendedLightingFallbackResources {
+    readonly iesProfileTexture: Texture;
+    readonly cookieTexture: Texture;
+    readonly cookieMatrixBuffer: Buffer;
+    readonly iesProfileTextureView: TextureView;
+    readonly cookieTextureView: TextureView;
+    readonly ltcLambertTextureView: TextureView;
+    readonly ltcGgxTextureView: TextureView;
+}
+/** Allocate the always-valid fallback resources for the extended-lighting BGL. */
+export declare function createExtendedLightingFallbackResources(device: RhiDevice, enabled: boolean): ExtendedLightingFallbackResources | undefined;
+//# sourceMappingURL=extended-lighting-fallback.d.ts.map

package/dist/assembly/extended-lighting-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extended-lighting-fallback.d.ts","sourceRoot":"","sources":["../../src/assembly/extended-lighting-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAEN,SAAS,EAET,OAAO,EACP,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAgB7B,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,qBAAqB,EAAE,WAAW,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC;IACxC,QAAQ,CAAC,qBAAqB,EAAE,WAAW,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC;CACzC;AA0FD,kFAAkF;AAClF,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,OAAO,GACf,iCAAiC,GAAG,SAAS,CA0F/C"}

package/dist/assembly/factory.d.ts

@@ -1,246 +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 three
- * 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`).
- *
- *   - build: exact checkout revision emitted by the build-tool adapter and
- *     carried into renderer-owned inspection identity.
- *
- * 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;
-    /** Exact checkout revision emitted by the build-tool adapter. */
-    readonly build?: 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, extendedLightingShaderAvailableOrTransmissionCapable?: 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, extendedLightingShaderAvailable?: 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, 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;
-/**
- * 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 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;
+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/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"}