@forgeax/engine-render 0.1.28 → 0.1.30

package/src/typed-shadow-passes.ts

@@ -1,7 +1,18 @@
-import type { RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
+import type {
+  GraphAccess,
+  RenderGraphBuilder,
+  RenderGraphError,
+} from '@forgeax/engine-render-graph';
 import { ok, type Result } from '@forgeax/engine-types';
 import { PointShadowAtlasUninitializedError } from './errors/render';
+import type { RenderFeatureShadowDraws } from './features/render-graph-raster';
+import {
+  type ShadowViewIdentity,
+  type ShadowViewProjection,
+  shadowViewRasterAccesses,
+} from './gpu-driven/shadow-views';
 import { GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING } from './gpu-texture-usage';
+import type { RenderFrameState } from './record/frame-snapshot';
 import type { _InternalRenderPipelineContext } from './record/render-context';
 import {
   encodeDirectionalShadowPass,
@@ -18,6 +29,25 @@ export interface TypedShadowTargets {
   readonly point?: RenderPipelineTarget | undefined;
 }
 
+/**
+ * Cache decisions are frame facts, not graph topology guesses. The
+ * directional cache predates the view pool and remains a direct context field;
+ * point/spot entries are optional projections published by the GPU shadow
+ * owner. A missing projection is a cache miss, preserving the existing CPU
+ * shadow path until that view has a committed generation.
+ */
+function shadowViewCacheReuse(frame: RenderPipelineFrame, identity: ShadowViewIdentity): boolean {
+  const context = frame as _InternalRenderPipelineContext;
+  const gpuShadowViews = context.gpuDrivenShadowViews;
+  if (gpuShadowViews !== undefined) return gpuShadowViews.cacheHit(identity);
+  if (identity.kind === 'directional') return context.directionalShadowCacheReuse;
+  const state = context.frameState as RenderFrameState & {
+    readonly shadowViewCacheReuse?: ReadonlyMap<string, boolean> | undefined;
+  };
+  const key = `${identity.kind}:${identity.index}:${identity.face ?? ''}`;
+  return state.shadowViewCacheReuse?.get(key) === true;
+}
+
 function recordShadowPass(
   graph: RenderGraphBuilder<RenderPipelineFrame>,
   name: string,
@@ -25,9 +55,10 @@ function recordShadowPass(
   loadOp: 'clear' | 'load',
   encode: Parameters<RenderGraphBuilder<RenderPipelineFrame>['addRasterPass']>[1]['encode'],
   executeIf?: (frame: RenderPipelineFrame) => boolean,
+  extraAccesses: readonly GraphAccess[] = [],
 ): Result<void, RenderGraphError> {
   return graph.addRasterPass(name, {
-    accesses: [{ resource: target.view, usage: 'depth-stencil-write' }],
+    accesses: [{ resource: target.view, usage: 'depth-stencil-write' }, ...extraAccesses],
     colorAttachments: [],
     depthStencilAttachment: {
       view: target.view,
@@ -43,7 +74,19 @@ function recordShadowPass(
 export function addTypedShadowPasses(
   graph: RenderGraphBuilder<RenderPipelineFrame>,
   topology: RenderPipelineTopology,
+  projectGpuDrivenShadowOrFeatures?:
+    | ((identity: ShadowViewIdentity) => Result<ShadowViewProjection | undefined, RenderGraphError>)
+    | RenderFeatureShadowDraws<RenderPipelineFrame>,
+  features?: RenderFeatureShadowDraws<RenderPipelineFrame>,
 ): Result<TypedShadowTargets, RenderGraphError> {
+  const projectGpuDrivenShadow =
+    typeof projectGpuDrivenShadowOrFeatures === 'function'
+      ? projectGpuDrivenShadowOrFeatures
+      : undefined;
+  const shadowFeatures =
+    typeof projectGpuDrivenShadowOrFeatures === 'function'
+      ? features
+      : (projectGpuDrivenShadowOrFeatures ?? features);
   let directional: RenderPipelineTarget | undefined;
   if (topology.shadow.directional !== 'disabled') {
     const { mapSize, cascadeCount } = topology.shadow.directional;
@@ -61,19 +104,40 @@ export function addTypedShadowPasses(
     for (let cascade = 0; cascade < cascadeCount; cascade += 1) {
       const col = cascade % atlasGrid.columns;
       const row = Math.floor(cascade / atlasGrid.columns);
+      const shadowProjection = projectGpuDrivenShadow?.({
+        kind: 'directional',
+        index: cascade,
+      });
+      if (shadowProjection !== undefined && !shadowProjection.ok) return shadowProjection;
       const added = recordShadowPass(
         graph,
         `shadowCascade${cascade}`,
         directionalTarget,
         cascade === 0 ? 'clear' : 'load',
-        ({ pass, frame }) =>
-          encodeDirectionalShadowPass(frame as never, pass, cascade, {
-            x: col * mapSize,
-            y: row * mapSize,
-            w: mapSize,
-            h: mapSize,
-          }),
-        (frame) => !(frame as _InternalRenderPipelineContext).directionalShadowCacheReuse,
+        ({ pass, frame, resources }) =>
+          encodeDirectionalShadowPass(
+            frame as never,
+            pass,
+            cascade,
+            {
+              x: col * mapSize,
+              y: row * mapSize,
+              w: mapSize,
+              h: mapSize,
+            },
+            shadowFeatures === undefined
+              ? undefined
+              : (view) => shadowFeatures.encode(pass, frame, resources, view),
+          ),
+        (frame) =>
+          shadowFeatures !== undefined ||
+          !shadowViewCacheReuse(frame, { kind: 'directional', index: cascade }),
+        [
+          ...(shadowProjection?.ok === true && shadowProjection.value?.graphResources !== undefined
+            ? shadowViewRasterAccesses(shadowProjection.value.graphResources)
+            : []),
+          ...(shadowFeatures?.accesses ?? []),
+        ],
       );
       if (!added.ok) return added;
     }
@@ -127,6 +191,15 @@ export function addTypedShadowPasses(
     };
     for (let pointIndex = 0; pointIndex < topology.shadow.pointCount; pointIndex += 1) {
       for (let face = 0; face < 6; face += 1) {
+        const shadowProjection = projectGpuDrivenShadow?.({
+          kind: 'point',
+          index: pointIndex,
+          face,
+        });
+        if (shadowProjection !== undefined && !shadowProjection.ok) return shadowProjection;
+        const identity = { kind: 'point' as const, index: pointIndex, face };
+        const cacheReuse = (frame: RenderPipelineFrame): boolean =>
+          shadowViewCacheReuse(frame, identity);
         const faceView = graph.view(texture.value, {
           label: `point-shadow-${pointIndex}-${face}`,
           dimension: '2d',
@@ -145,7 +218,24 @@ export function addTypedShadowPasses(
             sampleCount: 1,
           },
           'clear',
-          ({ pass, frame }) => encodePointShadowPass(frame as never, pass, pointIndex, face),
+          ({ pass, frame, resources }) =>
+            encodePointShadowPass(
+              frame as never,
+              pass,
+              pointIndex,
+              face,
+              shadowFeatures === undefined
+                ? undefined
+                : (view) => shadowFeatures.encode(pass, frame, resources, view),
+            ),
+          (frame) => shadowFeatures !== undefined || !cacheReuse(frame),
+          [
+            ...(shadowProjection?.ok === true &&
+            shadowProjection.value?.graphResources !== undefined
+              ? shadowViewRasterAccesses(shadowProjection.value.graphResources)
+              : []),
+            ...(shadowFeatures?.accesses ?? []),
+          ],
         );
         if (!added.ok) return added;
       }
@@ -158,12 +248,32 @@ export function addTypedShadowPasses(
   });
   if (!spot.ok) return spot;
   for (let spotIndex = 0; spotIndex < Math.max(1, topology.shadow.spotCount); spotIndex += 1) {
+    const shadowProjection = projectGpuDrivenShadow?.({ kind: 'spot', index: spotIndex });
+    if (shadowProjection !== undefined && !shadowProjection.ok) return shadowProjection;
+    const identity = { kind: 'spot' as const, index: spotIndex };
+    const cacheReuse = (frame: RenderPipelineFrame): boolean =>
+      shadowViewCacheReuse(frame, identity);
     const added = recordShadowPass(
       graph,
       topology.shadow.spotCount === 0 ? 'spot-shadow' : `spot-shadow-${spotIndex}`,
       spot.value,
       spotIndex === 0 ? 'clear' : 'load',
-      ({ pass, frame }) => encodeSpotShadowPass(frame as never, pass, spotIndex),
+      ({ pass, frame, resources }) =>
+        encodeSpotShadowPass(
+          frame as never,
+          pass,
+          spotIndex,
+          shadowFeatures === undefined
+            ? undefined
+            : (view) => shadowFeatures.encode(pass, frame, resources, view),
+        ),
+      (frame) => shadowFeatures !== undefined || !cacheReuse(frame),
+      [
+        ...(shadowProjection?.ok === true && shadowProjection.value?.graphResources !== undefined
+          ? shadowViewRasterAccesses(shadowProjection.value.graphResources)
+          : []),
+        ...(shadowFeatures?.accesses ?? []),
+      ],
     );
     if (!added.ok) return added;
   }

package/src/volume/component.ts

@@ -35,6 +35,7 @@ export interface VolumetricFogAuthoring {
   readonly light: EntityHandle;
   /** The optional same-World SpotLight paired with a PointLight. */
   readonly spotLight?: EntityHandle;
+  /** Linear scalar density over bounds; the renderer adds no noise or animation. */
   readonly density: VolumeDensityBinding;
   readonly bounds: VolumeBounds;
   readonly extinction: readonly [number, number, number];

package/src/volume/passes.ts

@@ -481,9 +481,9 @@ export function addVolumetricFogPasses(
       const densitySampler = frame.runtime.device.createSampler({
         minFilter: 'linear',
         magFilter: 'linear',
-        addressModeU: 'repeat',
-        addressModeV: 'repeat',
-        addressModeW: 'repeat',
+        addressModeU: 'clamp-to-edge',
+        addressModeV: 'clamp-to-edge',
+        addressModeW: 'clamp-to-edge',
       });
       if (!densitySampler.ok) throw densitySampler.error;
       const bindings = volumeBindGroup(frame, integrate.layout, [

package/src/volume/temporal.ts

@@ -36,6 +36,16 @@ export type VolumeTemporalReset =
   | { readonly reset: false }
   | { readonly reset: true; readonly reason: VolumeTemporalResetReason };
 
+/** TAAU remains dependency-deferred until its sibling reaches this branch. */
+export const VOLUME_TAAU_DEPENDENCY = Object.freeze({
+  status: 'dependency-deferred' as const,
+  siblingFeature: 'feat-20260831-taau-dynamic-resolution',
+  candidateShas: Object.freeze([
+    '6a0b8fe01ab81d5b60704f2120fa3f9b056742e4',
+    '677a7a40852d748e2af3352e2666d7c310115d0a',
+  ]),
+});
+
 export function resolveVolumeTemporalReset(
   previous: VolumeTemporalSignature,
   next: VolumeTemporalSignature,

package/dist/chunk-GE3SDD72.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/temporal/coverage.ts","../src/temporal/temporal-view.ts","../src/temporal/taa-history-store.ts","../src/temporal/frame-coordinator.ts"],"names":[],"mappings":"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","file":"chunk-GE3SDD72.mjs","sourcesContent":["import type { SceneDataLane, SceneDataSchemaId } from './scene-data';\n\nexport interface SceneDataCoverage {\n  readonly schema: SceneDataSchemaId;\n  readonly lane: SceneDataLane;\n  readonly producerId: string;\n  readonly complete: boolean;\n  readonly contributorIds: readonly string[];\n  readonly exactContributorIds: readonly string[];\n  readonly reactiveContributorIds: readonly string[];\n  readonly missingContributorIds: readonly string[];\n  readonly omittedMissingContributorCount: number;\n}\n\nexport interface TemporalCoverage {\n  readonly width: number;\n  readonly height: number;\n  readonly bytes: number;\n  readonly fullScreen: true;\n}\n\nexport function createTemporalCoverage(width: number, height: number): TemporalCoverage {\n  if (!Number.isSafeInteger(width) || width <= 0) throw new RangeError('width must be positive.');\n  if (!Number.isSafeInteger(height) || height <= 0)\n    throw new RangeError('height must be positive.');\n  return Object.freeze({ width, height, bytes: 32 * width * height, fullScreen: true as const });\n}\n\nexport type SceneDataContributorKind = 'exact' | 'reactive';\nexport interface SceneDataContributor {\n  readonly id: string;\n  readonly kind: SceneDataContributorKind;\n}\nexport function classifySceneDataCoverage(input: {\n  readonly contributors: readonly SceneDataContributor[];\n  readonly requiredContributorIds: readonly string[];\n}): {\n  readonly exactContributorIds: readonly string[];\n  readonly reactiveContributorIds: readonly string[];\n  readonly missingContributorIds: readonly string[];\n  readonly omittedMissingContributorCount: number;\n  readonly complete: boolean;\n} {\n  const exactContributorIds = input.contributors.filter((c) => c.kind === 'exact').map((c) => c.id);\n  const reactiveContributorIds = input.contributors\n    .filter((c) => c.kind === 'reactive')\n    .map((c) => c.id);\n  const available = new Set(input.contributors.map((c) => c.id));\n  const missing = input.requiredContributorIds.filter((id) => !available.has(id));\n  return {\n    exactContributorIds: Object.freeze(exactContributorIds),\n    reactiveContributorIds: Object.freeze(reactiveContributorIds),\n    missingContributorIds: Object.freeze(missing.slice(0, 32)),\n    omittedMissingContributorCount: Math.max(0, missing.length - 32),\n    complete: missing.length === 0,\n  };\n}\nexport function scanSceneDataCoverage(input: {\n  readonly schema: SceneDataSchemaId;\n  readonly lane: SceneDataLane;\n  readonly producerId: string;\n  readonly contributorIds: readonly string[];\n  readonly requiredContributorIds: readonly string[];\n}): SceneDataCoverage {\n  const classification = classifySceneDataCoverage({\n    contributors: input.contributorIds.map((id) => ({ id, kind: 'exact' as const })),\n    requiredContributorIds: input.requiredContributorIds,\n  });\n  return Object.freeze({\n    schema: input.schema,\n    lane: input.lane,\n    producerId: input.producerId,\n    ...classification,\n    contributorIds: Object.freeze([...input.contributorIds]),\n  });\n}\n","import { mat4 } from '@forgeax/engine-math';\nimport type { CameraProjection } from '../components/camera';\nimport type { CameraSnapshot } from '../render-contract';\n\nexport const TEMPORAL_JITTER_SAMPLE_COUNT = 8;\n\nexport type TemporalViewResetReason =\n  | 'first-frame'\n  | 'camera-switch'\n  | 'history-version-changed'\n  | 'projection-kind-changed'\n  | 'projection-range-changed';\n\nexport interface SubmittedTemporalView {\n  readonly viewId: string;\n  readonly historyVersion: number;\n  readonly projection: CameraProjection;\n  readonly near: number;\n  readonly far: number;\n  readonly jitterUv: readonly [number, number];\n  readonly unjitteredViewProjection: Float32Array;\n}\n\nexport interface TemporalView {\n  readonly viewId: string;\n  readonly historyVersion: number;\n  readonly temporalFrameIndex: number;\n  readonly historyValid: boolean;\n  readonly resetReason: TemporalViewResetReason | undefined;\n  readonly currentJitterUv: readonly [number, number];\n  readonly previousJitterUv: readonly [number, number];\n  readonly currentJitteredViewProjection: Float32Array;\n  readonly currentUnjitteredViewProjection: Float32Array;\n  readonly previousUnjitteredViewProjection: Float32Array;\n  readonly projection: CameraProjection;\n  readonly near: number;\n  readonly far: number;\n}\n\nexport interface TemporalViewInput {\n  readonly camera: CameraSnapshot;\n  readonly temporalFrameIndex: number;\n  readonly surfaceWidth: number;\n  readonly surfaceHeight: number;\n  readonly lastSubmitted?: SubmittedTemporalView;\n}\n\nexport function temporalViewId(worldId: number, entityKey: number): string {\n  const raw = entityKey >>> 0;\n  const index = raw & 0x00ffffff;\n  const generation = (raw >>> 24) & 0xff;\n  return `${worldId}:${index}:${generation}`;\n}\n\nfunction halton(index: number, base: number): number {\n  let result = 0;\n  let fraction = 1 / base;\n  let value = index;\n  while (value > 0) {\n    result += fraction * (value % base);\n    value = Math.floor(value / base);\n    fraction /= base;\n  }\n  return result;\n}\n\nexport function temporalJitterSample(temporalFrameIndex: number): readonly [number, number] {\n  const sampleIndex =\n    ((Math.trunc(temporalFrameIndex) % TEMPORAL_JITTER_SAMPLE_COUNT) +\n      TEMPORAL_JITTER_SAMPLE_COUNT) %\n    TEMPORAL_JITTER_SAMPLE_COUNT;\n  const haltonIndex = sampleIndex + 1;\n  return [halton(haltonIndex, 2) - 0.5, halton(haltonIndex, 3) - 0.5];\n}\n\nfunction temporalJitterUv(\n  temporalFrameIndex: number,\n  surfaceWidth: number,\n  surfaceHeight: number,\n): readonly [number, number] {\n  const sample = temporalJitterSample(temporalFrameIndex);\n  return [sample[0] / Math.max(1, surfaceWidth), sample[1] / Math.max(1, surfaceHeight)];\n}\n\nfunction cameraProjection(camera: CameraSnapshot): Float32Array {\n  const projection = mat4.create();\n  if (camera.projection === 'orthographic') {\n    mat4.orthographic(\n      projection,\n      camera.orthoLeft,\n      camera.orthoRight,\n      camera.orthoTop,\n      camera.orthoBottom,\n      camera.near,\n      camera.far,\n    );\n  } else {\n    mat4.perspective(projection, camera.fov, camera.aspect, camera.near, camera.far);\n  }\n  return projection;\n}\n\nfunction resetReason(\n  current: CameraSnapshot,\n  viewId: string,\n  previous: SubmittedTemporalView | undefined,\n): TemporalViewResetReason | undefined {\n  if (previous === undefined) return 'first-frame';\n  if (previous.viewId !== viewId) return 'camera-switch';\n  if (previous.historyVersion !== (current.historyVersion ?? 0)) {\n    return 'history-version-changed';\n  }\n  if (previous.projection !== current.projection) return 'projection-kind-changed';\n  if (!Object.is(previous.near, current.near) || !Object.is(previous.far, current.far)) {\n    return 'projection-range-changed';\n  }\n  return undefined;\n}\n\nexport function projectTemporalView(input: TemporalViewInput): TemporalView {\n  const { camera } = input;\n  const viewId = temporalViewId(camera.worldId ?? 0, camera.entityKey ?? 0);\n  const currentJitterUv = temporalJitterUv(\n    input.temporalFrameIndex,\n    input.surfaceWidth,\n    input.surfaceHeight,\n  );\n  const view = mat4.invert(mat4.create(), camera.world);\n  const projection = cameraProjection(camera);\n  const currentUnjitteredViewProjection = mat4.multiply(mat4.create(), projection, view);\n  const clipJitter = mat4.identity(mat4.create());\n  clipJitter[12] = currentJitterUv[0] * 2;\n  clipJitter[13] = currentJitterUv[1] * -2;\n  const jitteredProjection = mat4.multiply(mat4.create(), clipJitter, projection);\n  const currentJitteredViewProjection = mat4.multiply(mat4.create(), jitteredProjection, view);\n  const reason = resetReason(camera, viewId, input.lastSubmitted);\n  const historyValid = reason === undefined;\n  return {\n    viewId,\n    historyVersion: camera.historyVersion ?? 0,\n    temporalFrameIndex: input.temporalFrameIndex,\n    historyValid,\n    resetReason: reason,\n    currentJitterUv,\n    previousJitterUv: historyValid\n      ? (input.lastSubmitted?.jitterUv ?? currentJitterUv)\n      : currentJitterUv,\n    currentJitteredViewProjection,\n    currentUnjitteredViewProjection,\n    previousUnjitteredViewProjection: historyValid\n      ? (input.lastSubmitted?.unjitteredViewProjection ?? currentUnjitteredViewProjection)\n      : currentUnjitteredViewProjection,\n    projection: camera.projection,\n    near: camera.near,\n    far: camera.far,\n  };\n}\n\nexport function snapshotSubmittedTemporalView(view: TemporalView): SubmittedTemporalView {\n  return {\n    viewId: view.viewId,\n    historyVersion: view.historyVersion,\n    projection: view.projection,\n    near: view.near,\n    far: view.far,\n    jitterUv: [view.currentJitterUv[0], view.currentJitterUv[1]],\n    unjitteredViewProjection: new Float32Array(view.currentUnjitteredViewProjection),\n  };\n}\n","export type TaaHistoryResetReason =\n  | 'first-frame'\n  | 'camera-cut'\n  | 'resize'\n  | 'recover'\n  | 'device-generation';\n\nexport interface TaaHistoryInspection {\n  readonly token: number;\n  readonly deviceGeneration: number;\n  readonly content: 'uninitialized' | 'active';\n  readonly fallback: 'neutral-texture';\n  readonly requestVersion: number;\n  readonly generation: number;\n  readonly seed: number;\n  readonly attempt: 'none' | 'active' | 'committed' | 'aborted';\n  readonly valid: boolean;\n  readonly resetReason: TaaHistoryResetReason | undefined;\n}\n\nexport interface TaaHistoryReceipt {\n  readonly deviceGeneration: number;\n  readonly completed: boolean;\n}\n\nexport interface TaaHistoryAttempt {\n  readonly generation: number;\n  readonly seed: number;\n  commit(receipt?: TaaHistoryReceipt): void;\n  abort(): void;\n}\n\nlet nextHistoryToken = 1;\n\n/** TAA-only history owner. No global registry or backend handle crosses this boundary. */\nexport class TaaHistoryStore {\n  private readonly token = nextHistoryToken++;\n  private deviceGeneration = 0;\n  private content: TaaHistoryInspection['content'] = 'uninitialized';\n  private requestVersion = 0;\n  private generation = 0;\n  private seed = 0;\n  private valid = false;\n  private attempt: TaaHistoryInspection['attempt'] = 'none';\n  private resetReason: TaaHistoryResetReason | undefined;\n\n  begin(reason: TaaHistoryResetReason | undefined = undefined): TaaHistoryAttempt {\n    const generation = this.generation;\n    const seed = this.seed;\n    this.attempt = 'active';\n    let state: 'active' | 'committed' | 'aborted' = 'active';\n    return {\n      generation,\n      seed,\n      commit: (receipt) => {\n        if (state !== 'active') return;\n        if (\n          receipt !== undefined &&\n          (!receipt.completed || receipt.deviceGeneration !== this.deviceGeneration)\n        ) {\n          state = 'aborted';\n          this.attempt = 'aborted';\n          return;\n        }\n        state = 'committed';\n        this.attempt = 'committed';\n        this.valid = true;\n        this.content = 'active';\n        this.requestVersion += 1;\n        this.generation += 1;\n        this.seed += 1;\n        this.resetReason = reason;\n      },\n      abort: () => {\n        if (state !== 'active') return;\n        state = 'aborted';\n        this.attempt = 'aborted';\n      },\n    };\n  }\n\n  seedHistory(reason: TaaHistoryResetReason = 'first-frame'): void {\n    this.valid = false;\n    this.content = 'uninitialized';\n    this.resetReason = reason;\n    this.attempt = 'none';\n  }\n\n  reset(reason: TaaHistoryResetReason): void {\n    this.generation = 0;\n    this.seed = 0;\n    this.valid = false;\n    this.content = 'uninitialized';\n    this.attempt = 'none';\n    this.resetReason = reason;\n  }\n\n  recoverForGeneration(deviceGeneration: number): void {\n    if (!Number.isSafeInteger(deviceGeneration) || deviceGeneration < 0) {\n      throw new RangeError('deviceGeneration must be a non-negative safe integer.');\n    }\n    this.deviceGeneration = deviceGeneration;\n    this.valid = false;\n    this.content = 'uninitialized';\n    this.attempt = 'none';\n    this.resetReason = 'device-generation';\n  }\n\n  inspect(): TaaHistoryInspection {\n    return {\n      token: this.token,\n      deviceGeneration: this.deviceGeneration,\n      content: this.content,\n      fallback: 'neutral-texture',\n      requestVersion: this.requestVersion,\n      generation: this.generation,\n      seed: this.seed,\n      attempt: this.attempt,\n      valid: this.valid,\n      resetReason: this.resetReason,\n    };\n  }\n}\n","import { err, ok, type Result } from '@forgeax/engine-types';\nimport type { CameraSnapshot } from '../render-contract';\nimport { classifySceneDataCoverage, type SceneDataContributor } from './coverage';\nimport { type TaaHistoryAttempt, TaaHistoryStore } from './taa-history-store';\nimport {\n  projectTemporalView,\n  type SubmittedTemporalView,\n  snapshotSubmittedTemporalView,\n  type TemporalView,\n} from './temporal-view';\n\n/** The only stages that may publish a temporal frame. */\nexport type TemporalFrameStage = 'build' | 'encode' | 'finish' | 'submit';\n\nexport type TemporalFrameErrorCode = 'taa-unavailable' | 'temporal-active' | 'temporal-not-active';\n\nexport interface TemporalFrameError {\n  readonly code: TemporalFrameErrorCode;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail?: Readonly<Record<string, unknown>>;\n}\n\nexport interface TemporalFrameSnapshot<T = unknown> {\n  readonly epoch: number;\n  readonly previous: T | undefined;\n  readonly historyAttempt: 'none' | 'active' | 'committed' | 'aborted';\n  readonly attempt: 'none' | 'active' | 'committed' | 'aborted';\n  readonly lastFailure: TemporalFrameStage | undefined;\n  readonly coverage: {\n    readonly exactContributorIds: readonly string[];\n    readonly reactiveContributorIds: readonly string[];\n    readonly missingContributorIds: readonly string[];\n    readonly omittedMissingContributorCount: number;\n  };\n}\n\nexport interface TemporalFrameBeginInput<T = unknown> {\n  readonly current: T;\n  readonly antialias: 'none' | 'fxaa' | 'msaa' | 'taa';\n  /** Enables the shared transaction for a temporal feature without TAA. */\n  readonly temporalDemand?: boolean;\n  readonly available?: boolean;\n  readonly contributors?: readonly SceneDataContributor[];\n  readonly requiredContributorIds?: readonly string[];\n  /** Projection produced before record uploads; it commits with the frame. */\n  readonly temporalView?: TemporalView;\n}\n\nexport interface TemporalFrameCandidate<T = unknown> {\n  readonly epoch: number;\n  readonly current: T;\n  readonly previous: T | undefined;\n  readonly history: { readonly direction: 'a-to-b' | 'b-to-a'; readonly valid: boolean };\n  readonly contributors: readonly SceneDataContributor[];\n  readonly requiredContributorIds: readonly string[];\n  readonly temporalView?: TemporalView;\n}\n\nexport interface TemporalFramePhases<T = unknown> {\n  readonly build: () => T;\n  readonly encode: (built: T) => void;\n  readonly finish: () => void;\n  readonly submit: () => void;\n}\n\nexport interface TemporalFrameReceipt<T = unknown> {\n  readonly epoch: number;\n  readonly previous: T;\n  readonly historyDirection: 'a-to-b' | 'b-to-a';\n}\n\nexport type ReflectionFallbackTemporalReset =\n  | { readonly reset: false }\n  | { readonly reset: true; readonly reason: 'reflection-fallback-generation' };\n\n/** Maps committed producer generations into the existing temporal reset seam. */\nexport function resolveReflectionFallbackTemporalReset(\n  previousGeneration: number | undefined,\n  nextGeneration: number | undefined,\n): ReflectionFallbackTemporalReset {\n  if (previousGeneration === undefined || nextGeneration === undefined) return { reset: false };\n  return previousGeneration === nextGeneration\n    ? { reset: false }\n    : { reset: true, reason: 'reflection-fallback-generation' };\n}\n\n/**\n * Keeps SSR admission on the existing producer-generation reset seam. The\n * admission path never allocates or resolves temporal history itself.\n */\nexport function resolveSsrAdmissionTemporalReset(\n  previousGeneration: number | undefined,\n  nextGeneration: number | undefined,\n): ReflectionFallbackTemporalReset {\n  return resolveReflectionFallbackTemporalReset(previousGeneration, nextGeneration);\n}\n\nfunction failure(code: TemporalFrameErrorCode, hint: string): TemporalFrameError {\n  return {\n    code,\n    expected:\n      code === 'taa-unavailable'\n        ? 'TAA resources and capability are available'\n        : 'one temporal frame is active',\n    hint,\n  };\n}\n\n/**\n * Renderer-owned temporal transaction. It has no graph or backend dependency:\n * graph assembly supplies the four phase callbacks and only submit publishes\n * the candidate snapshot.\n */\nexport class TemporalFrameCoordinator<T = unknown> {\n  readonly historyStore: TaaHistoryStore;\n  private epoch: number;\n  private previous: T | undefined;\n  private active: TemporalFrameCandidate<T> | undefined;\n  private attempt: TemporalFrameSnapshot<T>['attempt'] = 'none';\n  private historyAttempt: TemporalFrameSnapshot<T>['historyAttempt'] = 'none';\n  private lastFailure: TemporalFrameStage | undefined;\n  private historyDirection: 'a-to-b' | 'b-to-a' = 'a-to-b';\n  private temporalFrameIndex = 0;\n  private lastSubmittedView: SubmittedTemporalView | undefined;\n  private coverage: TemporalFrameSnapshot<T>['coverage'] = {\n    exactContributorIds: [],\n    reactiveContributorIds: [],\n    missingContributorIds: [],\n    omittedMissingContributorCount: 0,\n  };\n  private readonly historyAttempts = new WeakMap<object, TaaHistoryAttempt>();\n\n  constructor(\n    initial: {\n      readonly epoch?: number;\n      readonly previous?: T;\n      readonly historyStore?: TaaHistoryStore;\n    } = {},\n  ) {\n    this.historyStore = initial.historyStore ?? new TaaHistoryStore();\n    this.epoch = initial.epoch ?? 0;\n    this.previous = initial.previous;\n  }\n\n  begin(input: TemporalFrameBeginInput<T>): Result<TemporalFrameCandidate<T>, TemporalFrameError> {\n    const demanded = input.antialias === 'taa' || input.temporalDemand === true;\n    if (!demanded) {\n      return ok({\n        epoch: this.epoch,\n        current: input.current,\n        previous: this.previous,\n        history: { direction: this.historyDirection, valid: false },\n        contributors: Object.freeze([...(input.contributors ?? [])]),\n        requiredContributorIds: Object.freeze([...(input.requiredContributorIds ?? [])]),\n        ...(input.temporalView === undefined ? {} : { temporalView: input.temporalView }),\n      });\n    }\n    if (input.available === false) {\n      return err(\n        failure('taa-unavailable', 'enable rgba16float temporal targets and retry the frame'),\n      );\n    }\n    if (this.active !== undefined) {\n      return err(\n        failure(\n          'temporal-active',\n          'commit or abort the active temporal frame before beginning another',\n        ),\n      );\n    }\n    const candidate: TemporalFrameCandidate<T> = {\n      epoch: this.epoch + 1,\n      current: input.current,\n      previous: this.previous,\n      history: { direction: this.historyDirection, valid: this.previous !== undefined },\n      contributors: Object.freeze([...(input.contributors ?? [])]),\n      requiredContributorIds: Object.freeze([...(input.requiredContributorIds ?? [])]),\n      ...(input.temporalView === undefined ? {} : { temporalView: input.temporalView }),\n    };\n    if (input.antialias === 'taa') {\n      this.historyAttempts.set(candidate, this.historyStore.begin());\n    }\n    this.active = candidate;\n    this.attempt = 'active';\n    this.historyAttempt = input.antialias === 'taa' ? 'active' : 'none';\n    this.lastFailure = undefined;\n    return ok(candidate);\n  }\n\n  commit(\n    candidate: TemporalFrameCandidate<T>,\n  ): Result<TemporalFrameReceipt<T>, TemporalFrameError> {\n    if (this.active !== candidate) {\n      return err(failure('temporal-not-active', 'commit the candidate returned by begin'));\n    }\n    this.epoch = candidate.epoch;\n    this.previous = candidate.current;\n    if (candidate.temporalView !== undefined) {\n      this.lastSubmittedView = snapshotSubmittedTemporalView(candidate.temporalView);\n      this.temporalFrameIndex += 1;\n    }\n    this.historyDirection = candidate.history.direction === 'a-to-b' ? 'b-to-a' : 'a-to-b';\n    const historyAttempt = this.historyAttempts.get(candidate);\n    historyAttempt?.commit({\n      deviceGeneration: this.historyStore.inspect().deviceGeneration,\n      completed: true,\n    });\n    this.coverage = classifySceneDataCoverage({\n      contributors: candidate.contributors,\n      requiredContributorIds: candidate.requiredContributorIds,\n    });\n    this.active = undefined;\n    historyAttempt?.abort();\n    this.historyAttempts.delete(candidate);\n    this.attempt = 'committed';\n    this.historyAttempt = historyAttempt === undefined ? 'none' : 'committed';\n    return ok({\n      epoch: this.epoch,\n      previous: candidate.current,\n      historyDirection: candidate.history.direction,\n    });\n  }\n\n  abort(candidate: TemporalFrameCandidate<T>, stage: TemporalFrameStage = 'submit'): void {\n    if (this.active !== candidate) return;\n    this.historyAttempts.get(candidate)?.abort();\n    this.historyAttempts.delete(candidate);\n    this.active = undefined;\n    this.attempt = 'aborted';\n    this.historyAttempt = 'aborted';\n    this.lastFailure = stage;\n  }\n\n  run(\n    input: TemporalFrameBeginInput<T>,\n    phases: TemporalFramePhases<T>,\n  ): Result<TemporalFrameReceipt<T> | undefined, TemporalFrameError> {\n    const started = this.begin(input);\n    if (!started.ok) return started;\n    const candidate = started.value;\n    if (input.antialias !== 'taa' && input.temporalDemand !== true) return ok(undefined);\n    try {\n      const built = phases.build();\n      phases.encode(built);\n      phases.finish();\n      phases.submit();\n    } catch (cause) {\n      const stage = this.stageFromError(cause);\n      this.abort(candidate, stage);\n      return err({\n        code: 'temporal-not-active',\n        expected: `temporal ${stage} succeeds before commit`,\n        hint: 'inspect the underlying stage failure and retry the frame',\n        detail: { stage, cause },\n      });\n    }\n    return this.commit(candidate);\n  }\n\n  inspect(): TemporalFrameSnapshot<T> {\n    return {\n      epoch: this.epoch,\n      previous: this.previous,\n      historyAttempt: this.historyAttempt,\n      attempt: this.attempt,\n      lastFailure: this.lastFailure,\n      coverage: this.coverage,\n    };\n  }\n\n  /**\n   * Derive the current/previous camera matrices without mutating history.\n   * `commit()` is the only operation that publishes the returned view, so a\n   * graph/finish/submit failure leaves the last successful view intact.\n   */\n  prepareTemporalView(\n    camera: CameraSnapshot,\n    surfaceWidth: number,\n    surfaceHeight: number,\n  ): TemporalView | undefined {\n    const demanded =\n      camera.antialias === 'taa' ||\n      (camera.motionBlur?.shutterAngle !== undefined && camera.motionBlur.shutterAngle > 0);\n    if (!demanded) return undefined;\n    return projectTemporalView({\n      camera,\n      temporalFrameIndex: this.temporalFrameIndex,\n      surfaceWidth,\n      surfaceHeight,\n      ...(this.lastSubmittedView === undefined ? {} : { lastSubmitted: this.lastSubmittedView }),\n    });\n  }\n\n  reset(\n    reason:\n      | 'cut'\n      | 'resize'\n      | 'camera-switch'\n      | 'detach'\n      | 'recover'\n      | 'device-loss'\n      | 'device-generation' = 'recover',\n  ): void {\n    void reason;\n    this.active = undefined;\n    this.epoch = 0;\n    this.previous = undefined;\n    this.temporalFrameIndex = 0;\n    this.lastSubmittedView = undefined;\n    this.historyDirection = 'a-to-b';\n    this.historyStore.reset(\n      reason === 'cut' || reason === 'camera-switch'\n        ? 'camera-cut'\n        : reason === 'resize'\n          ? 'resize'\n          : reason === 'device-generation' || reason === 'device-loss'\n            ? 'device-generation'\n            : 'recover',\n    );\n    this.attempt = 'none';\n    this.historyAttempt = 'none';\n    this.lastFailure = undefined;\n    this.coverage = {\n      exactContributorIds: [],\n      reactiveContributorIds: [],\n      missingContributorIds: [],\n      omittedMissingContributorCount: 0,\n    };\n  }\n\n  private stageFromError(cause: unknown): TemporalFrameStage {\n    if (typeof cause === 'object' && cause !== null && 'stage' in cause) {\n      const stage = (cause as { stage?: unknown }).stage;\n      if (stage === 'build' || stage === 'encode' || stage === 'finish' || stage === 'submit')\n        return stage;\n    }\n    return 'submit';\n  }\n}\n"]}

package/dist/chunk-GF523LHF.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/assembly/material/surface-projection.ts","../src/materials.ts"],"names":["pass"],"mappings":"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","file":"chunk-GF523LHF.mjs","sourcesContent":["import { DEFAULT_STANDARD_SURFACE_MODULE } from '@forgeax/engine-shader';\nimport type {\n  MaterialPass,\n  MaterialRenderState,\n  MaterialValue,\n  StandardLayerPlan,\n} from '@forgeax/engine-types';\n\nexport const STANDARD_MATERIAL_MODULE = 'forgeax_material::standard';\nexport { DEFAULT_STANDARD_SURFACE_MODULE };\n\nexport type StandardSurfacePassName = 'forward' | 'deferred' | 'shadow-caster';\nexport type StandardSurfaceGeometryVariant = 'rigid' | 'skinned' | 'instanced';\nexport type StandardSurfaceLightingLane = 'direct' | 'clustered';\nexport type StandardSurfaceKind = 'standard' | 'full-custom';\n\nexport interface StandardSurfaceProjectionOptions {\n  readonly surfaceModule: string;\n  readonly values: Readonly<Record<string, MaterialValue | null>>;\n  readonly renderState?: MaterialRenderState;\n  readonly castShadow?: boolean;\n  readonly queue?: number;\n  readonly geometryVariant?: StandardSurfaceGeometryVariant;\n  readonly lightingLane?: StandardSurfaceLightingLane;\n  readonly alphaClip?: boolean;\n  readonly surfaceKind?: StandardSurfaceKind;\n  readonly declaredPasses?: readonly StandardSurfacePassName[];\n  readonly layerPlan?: StandardLayerPlan;\n}\n\nfunction pass(\n  name: StandardSurfacePassName,\n  options: StandardSurfaceProjectionOptions,\n  fragmentEntry: string,\n): MaterialPass {\n  const authoredState = options.renderState ?? {};\n  const authoredRecord = authoredState as Readonly<Record<string, unknown>>;\n  const tags = (authoredRecord.tags ?? {}) as Readonly<Record<string, string>>;\n  const lightMode =\n    name === 'shadow-caster' ? 'ShadowCaster' : name === 'forward' ? 'Forward' : 'Deferred';\n  return {\n    name,\n    program: {\n      module:\n        name === 'shadow-caster' ? 'forgeax::default-shadow-caster' : STANDARD_MATERIAL_MODULE,\n      fragmentEntry,\n      moduleSlots: { surface: options.surfaceModule },\n    },\n    renderState: {\n      ...authoredState,\n      tags:\n        options.surfaceModule === DEFAULT_STANDARD_SURFACE_MODULE\n          ? { LightMode: lightMode, ...tags }\n          : {\n              ...tags,\n              LightMode: lightMode,\n              SurfaceModule: options.surfaceModule,\n              SurfaceKind: options.surfaceKind ?? 'standard',\n              GeometryVariant: options.geometryVariant ?? 'rigid',\n              LightingLane: options.lightingLane ?? 'direct',\n              AlphaClip: options.alphaClip === true ? 'enabled' : 'disabled',\n            },\n      ...(options.queue === undefined ? {} : { queue: options.queue }),\n    },\n  };\n}\n\n/** Project one custom or default Surface into the existing Standard pass family. */\nexport function projectStandardSurfacePasses(\n  options: StandardSurfaceProjectionOptions,\n): [MaterialPass, ...MaterialPass[]] {\n  const authoredPasses = options.declaredPasses;\n  const passNames: StandardSurfacePassName[] =\n    options.surfaceKind === 'full-custom' && authoredPasses !== undefined\n      ? [...authoredPasses]\n      : (['forward'] as StandardSurfacePassName[]);\n  if (authoredPasses === undefined || options.surfaceKind !== 'full-custom') {\n    const blended = options.renderState?.blend !== undefined;\n    if (!blended && options.layerPlan?.mode !== 'physical') passNames.push('deferred');\n    if (options.castShadow !== false) passNames.push('shadow-caster');\n  }\n  const entries = passNames.map((name) =>\n    pass(\n      name,\n      options,\n      name === 'forward' ? 'fs_main' : name === 'deferred' ? 'fs_gbuffer' : 'fs_shadow',\n    ),\n  );\n  const passes = entries as [MaterialPass, ...MaterialPass[]];\n  return passes;\n}\n","import { color } from '@forgeax/engine-math';\nimport { DEFAULT_STANDARD_PBR_PARAM_SCHEMA } from '@forgeax/engine-shader';\nimport type {\n  MaterialAsset,\n  MaterialColorSpace,\n  MaterialParameter,\n  MaterialPass,\n  MaterialRenderState,\n  MaterialValue,\n} from '@forgeax/engine-types';\nimport { deriveStandardLayerPlan, standardSurfaceParameters } from '@forgeax/engine-types';\nimport {\n  DEFAULT_STANDARD_SURFACE_MODULE,\n  projectStandardSurfacePasses,\n} from './assembly/material/surface-projection';\n\nexport type MaterialTransmissionValidationReason =\n  | 'non-finite'\n  | 'range'\n  | 'shape'\n  | 'blend'\n  | 'depth-write';\n\n/** Structured authoring failure for the Standard transmission contract. */\nexport class MaterialTransmissionContractError extends Error {\n  readonly code = 'material-transmission-contract-invalid' as const;\n  readonly expected = 'transmission material values satisfy finite ranges and Forward depth rules';\n  readonly hint =\n    'repair the named transmission value or pass state before publishing the material';\n  readonly detail: {\n    readonly code: 'material-transmission-contract-invalid';\n    readonly material: 'Standard';\n    readonly parameter:\n      | 'transmission'\n      | 'ior'\n      | 'thickness'\n      | 'attenuationColor'\n      | 'attenuationDistance';\n    readonly reason: MaterialTransmissionValidationReason;\n    readonly actual?: unknown;\n  };\n\n  constructor(\n    parameter: (typeof MaterialTransmissionContractError.prototype.detail)['parameter'],\n    reason: MaterialTransmissionValidationReason,\n    actual?: unknown,\n  ) {\n    super(`Materials.standard: ${parameter} violates the transmission contract (${reason})`);\n    this.name = 'MaterialTransmissionContractError';\n    this.detail = {\n      code: 'material-transmission-contract-invalid',\n      material: 'Standard',\n      parameter,\n      reason,\n      ...(actual === undefined ? {} : { actual }),\n    };\n  }\n}\n\nexport const SPRITE_PREMULTIPLIED_ALPHA_BLEND: GPUBlendState = {\n  color: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha', operation: 'add' },\n  alpha: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha', operation: 'add' },\n};\n\nconst UNLIT_MODULE = 'forgeax_material::unlit';\nconst SPRITE_MODULE = 'forgeax_material::sprite';\n\nexport type MaterialColorTuple3 = readonly [number, number, number];\nexport type MaterialColorTuple4 = readonly [number, number, number, number];\nexport type MaterialColorInput3 = MaterialColorTuple3 | string | number;\nexport type MaterialColorInput4 = MaterialColorTuple4 | string | number;\n\nfunction colorHexFromNumber(value: number): string {\n  if (!Number.isInteger(value) || value < 0 || value > 0xffffff) {\n    throw new Error(`material color number must be an integer in [0, 0xffffff], got ${value}`);\n  }\n  return `#${value.toString(16).padStart(6, '0')}`;\n}\n\nfunction linearColorFromInput(\n  input: MaterialColorInput3 | MaterialColorInput4,\n  channels: 3 | 4,\n): readonly number[] {\n  if (typeof input === 'number' || typeof input === 'string') {\n    const parsed = color.create();\n    color.fromCss(parsed, typeof input === 'number' ? colorHexFromNumber(input) : input);\n    return channels === 3\n      ? [parsed[0] as number, parsed[1] as number, parsed[2] as number]\n      : Array.from(parsed);\n  }\n  if (input.length !== channels) {\n    throw new Error(`material color tuple must contain ${channels} channels, got ${input.length}`);\n  }\n  return [...input];\n}\n\n/** Convert an explicit sRGB numeric tuple into the linear tuple factories store. */\nexport function srgb(input: MaterialColorTuple3): MaterialColorTuple3;\nexport function srgb(input: MaterialColorTuple4): MaterialColorTuple4;\nexport function srgb(input: readonly number[]): readonly number[] {\n  if (input.length !== 3 && input.length !== 4) {\n    throw new Error(`sRGB material color tuple must contain 3 or 4 channels, got ${input.length}`);\n  }\n  const parsed = color.create(input[0] ?? 0, input[1] ?? 0, input[2] ?? 0, input[3] ?? 1);\n  color.srgbToLinear(parsed, parsed);\n  return input.length === 3\n    ? [parsed[0] as number, parsed[1] as number, parsed[2] as number]\n    : [parsed[0] as number, parsed[1] as number, parsed[2] as number, parsed[3] as number];\n}\n\nfunction authoredColorParameter(\n  name: string,\n  type: 'color' | 'vec3',\n  colorSpace: MaterialColorSpace,\n  optional = false,\n): MaterialParameter {\n  return {\n    name,\n    type,\n    ...(type === 'color' && colorSpace === 'srgb' ? {} : { colorSpace }),\n    ...(optional ? { optional: true } : {}),\n  };\n}\n\nfunction standardParameters(\n  colorSpace: MaterialColorSpace,\n  opts: StandardOpts,\n): readonly MaterialParameter[] {\n  const physicalNames = new Set<string>();\n  const addPhysical = (...names: readonly string[]) => {\n    for (const name of names) physicalNames.add(name);\n  };\n  if (\n    opts.clearcoat !== undefined ||\n    opts.clearcoatRoughness !== undefined ||\n    opts.clearcoatNormalScale !== undefined ||\n    opts.clearcoatTexture !== undefined ||\n    opts.clearcoatRoughnessTexture !== undefined ||\n    opts.clearcoatNormalTexture !== undefined\n  ) {\n    addPhysical(\n      'clearcoat',\n      'clearcoatRoughness',\n      'clearcoatNormalScale',\n      ...(opts.clearcoatTexture === undefined ? [] : ['clearcoatTexture']),\n      ...(opts.clearcoatRoughnessTexture === undefined ? [] : ['clearcoatRoughnessTexture']),\n      ...(opts.clearcoatNormalTexture === undefined ? [] : ['clearcoatNormalTexture']),\n    );\n  }\n  if (\n    opts.anisotropyStrength !== undefined ||\n    opts.anisotropyRotation !== undefined ||\n    opts.anisotropyTexture !== undefined\n  ) {\n    addPhysical('anisotropyStrength', 'anisotropyRotation');\n    if (opts.anisotropyTexture !== undefined) addPhysical('anisotropyTexture');\n  }\n  if (\n    opts.sheenColor !== undefined ||\n    opts.sheenRoughness !== undefined ||\n    opts.sheenColorTexture !== undefined ||\n    opts.sheenRoughnessTexture !== undefined\n  ) {\n    addPhysical('sheenColor', 'sheenRoughness');\n    if (opts.sheenColorTexture !== undefined) addPhysical('sheenColorTexture');\n    if (opts.sheenRoughnessTexture !== undefined) addPhysical('sheenRoughnessTexture');\n  }\n  if (\n    opts.iridescence !== undefined ||\n    opts.iridescenceIor !== undefined ||\n    opts.iridescenceThicknessMinimum !== undefined ||\n    opts.iridescenceThicknessMaximum !== undefined ||\n    opts.iridescenceTexture !== undefined ||\n    opts.iridescenceThicknessTexture !== undefined\n  ) {\n    addPhysical(\n      'iridescence',\n      'iridescenceIor',\n      'iridescenceThicknessMinimum',\n      'iridescenceThicknessMaximum',\n      ...(opts.iridescenceTexture === undefined ? [] : ['iridescenceTexture']),\n      ...(opts.iridescenceThicknessTexture === undefined ? [] : ['iridescenceThicknessTexture']),\n    );\n  }\n  const baseNames = new Set([\n    'baseColor',\n    'metallic',\n    'roughness',\n    'metallicChannel',\n    'roughnessChannel',\n    'aoChannel',\n    'extraChannel',\n    'emissive',\n    'emissiveIntensity',\n    'occlusionStrength',\n    'alphaCutoff',\n    'normalScale',\n    'baseColorTexture',\n    'metallicRoughnessTexture',\n    'normalTexture',\n    'emissiveTexture',\n    'occlusionTexture',\n    'specular',\n    'specularColor',\n    // IOR is part of the always-present dielectric F0 contract. The\n    // transmission layer may be absent, but the Standard shader still\n    // consumes this scalar for the base reflection path.\n    'ior',\n  ]);\n  if (opts.specularTexture !== undefined) baseNames.add('specularTexture');\n  if (opts.specularColorTexture !== undefined) baseNames.add('specularColorTexture');\n  if (\n    opts.transmission !== undefined ||\n    opts.ior !== undefined ||\n    opts.thickness !== undefined ||\n    opts.transmissionTexture !== undefined ||\n    opts.thicknessTexture !== undefined ||\n    opts.attenuationColor !== undefined ||\n    opts.attenuationDistance !== undefined\n  ) {\n    for (const name of [\n      'transmission',\n      'ior',\n      'thickness',\n      'attenuationColor',\n      'attenuationDistance',\n      'transmissionTexture',\n      'thicknessTexture',\n    ]) {\n      baseNames.add(name);\n    }\n  }\n  // All Standard fields come from one root schema. Physical fields are\n  // projected by the authored option membership above; appending a second\n  // physical schema would create a parallel ABI authority.\n  const availableSchema = DEFAULT_STANDARD_PBR_PARAM_SCHEMA;\n  // Keep the generated Standard UBO's numeric run contiguous before any\n  // texture coordinate records. The built-in WGSL places the complete\n  // physical root (including clearcoat scalars) after the base numeric run\n  // and before all coordinate pairs; appending physical entries after the\n  // base texture records would otherwise derive a different ABI.\n  const numericSchema = availableSchema.filter((entry) => !entry.type.startsWith('texture'));\n  const textureSchema = availableSchema.filter((entry) => entry.type.startsWith('texture'));\n  const orderedSchema = [...numericSchema, ...textureSchema];\n  return orderedSchema\n    .filter((entry) => baseNames.has(entry.name) || physicalNames.has(entry.name))\n    .map((entry) => {\n      const type = entry.type.startsWith('texture') ? 'texture' : entry.type;\n      const isRequired =\n        entry.name === 'baseColor' || entry.name === 'metallic' || entry.name === 'roughness';\n      const authoredColor =\n        entry.type === 'color' || (entry.type === 'vec3' && entry.name !== 'attenuationColor');\n      const schemaColorSpace = 'colorSpace' in entry ? entry.colorSpace : undefined;\n      const colorSpaceProjection: { colorSpace?: MaterialColorSpace } = {};\n      if (authoredColor && !(type === 'color' && colorSpace === 'srgb')) {\n        colorSpaceProjection.colorSpace = colorSpace;\n      } else if (!authoredColor && schemaColorSpace !== undefined) {\n        colorSpaceProjection.colorSpace = schemaColorSpace;\n      }\n      return {\n        name: entry.name,\n        type,\n        ...colorSpaceProjection,\n        ...(isRequired ? {} : { optional: true }),\n      } as MaterialParameter;\n    });\n}\n\nfunction unlitParameters(colorSpace: MaterialColorSpace): readonly MaterialParameter[] {\n  return [\n    authoredColorParameter('baseColor', 'color', colorSpace),\n    { name: 'alphaCutoff', type: 'f32', optional: true },\n    { name: 'baseColorTexture', type: 'texture', optional: true },\n  ];\n}\n\nfunction pass(\n  name: string,\n  module: string,\n  renderState: MaterialRenderState | undefined,\n  fragmentEntry?: string,\n  queue?: number,\n): MaterialPass {\n  const lightMode =\n    name === 'shadow-caster' ? 'ShadowCaster' : name === 'deferred' ? 'Deferred' : 'Forward';\n  const authoredState = (renderState ?? {}) as Readonly<Record<string, unknown>>;\n  const authoredTags = authoredState.tags as Readonly<Record<string, string>> | undefined;\n  return {\n    name,\n    program: {\n      module,\n      ...(fragmentEntry === undefined ? {} : { fragmentEntry }),\n    },\n    renderState: {\n      ...authoredState,\n      tags: { LightMode: lightMode, ...authoredTags },\n      ...(queue === undefined ? {} : { queue }),\n    },\n  };\n}\n\nfunction shadowCasterRenderState(\n  renderState: MaterialRenderState | undefined,\n): MaterialRenderState | undefined {\n  if (renderState?.cullMode === undefined && renderState?.frontFace === undefined) return undefined;\n  return {\n    ...(renderState.cullMode === undefined ? {} : { cullMode: renderState.cullMode }),\n    ...(renderState.frontFace === undefined ? {} : { frontFace: renderState.frontFace }),\n  };\n}\n\ninterface UnlitOpts {\n  readonly castShadow?: boolean;\n  readonly baseColorTexture?: MaterialValue;\n  readonly alphaCutoff?: number;\n  readonly renderState?: MaterialRenderState;\n  readonly queue?: number;\n}\n\nfunction unlit(rgba: MaterialColorInput4, opts?: UnlitOpts): MaterialAsset {\n  if (opts?.alphaCutoff !== undefined && (opts.alphaCutoff < 0 || opts.alphaCutoff > 1)) {\n    throw new Error(`Materials.unlit: alphaCutoff must be in [0, 1], got ${opts.alphaCutoff}`);\n  }\n  const values: Record<string, MaterialValue> = { baseColor: linearColorFromInput(rgba, 4) };\n  if (opts?.baseColorTexture !== undefined) values.baseColorTexture = opts.baseColorTexture;\n  if (opts?.alphaCutoff !== undefined) values.alphaCutoff = opts.alphaCutoff;\n  const passes: [MaterialPass, ...MaterialPass[]] = [\n    pass('forward', UNLIT_MODULE, opts?.renderState, undefined, opts?.queue),\n  ];\n  if (opts?.castShadow !== false) {\n    passes.push(pass('shadow-caster', UNLIT_MODULE, shadowCasterRenderState(opts?.renderState)));\n  }\n  return {\n    kind: 'material',\n    colorSpace: 'linear',\n    passes,\n    parameters: unlitParameters('linear'),\n    values,\n  };\n}\n\ninterface StandardOpts {\n  /** Numeric tuples are linear; Hex/CSS strings and numbers are sRGB inputs. */\n  readonly baseColor: MaterialColorInput4;\n  readonly metallic?: number;\n  readonly roughness?: number;\n  /** Texture channel used for the metallic factor; glTF defaults to B (2). */\n  readonly metallicChannel?: number;\n  /** Texture channel used for the roughness factor; glTF defaults to G (1). */\n  readonly roughnessChannel?: number;\n  readonly clearcoat?: number;\n  readonly clearcoatRoughness?: number;\n  readonly clearcoatTexture?: MaterialValue;\n  readonly clearcoatRoughnessTexture?: MaterialValue;\n  readonly clearcoatNormalTexture?: MaterialValue;\n  readonly clearcoatNormalScale?: number;\n  readonly anisotropyStrength?: number;\n  readonly anisotropyRotation?: number;\n  readonly anisotropyTexture?: MaterialValue;\n  readonly sheenColor?: MaterialColorInput3;\n  readonly sheenRoughness?: number;\n  readonly sheenColorTexture?: MaterialValue;\n  readonly sheenRoughnessTexture?: MaterialValue;\n  readonly iridescence?: number;\n  readonly iridescenceIor?: number;\n  readonly iridescenceThicknessMinimum?: number;\n  readonly iridescenceThicknessMaximum?: number;\n  readonly iridescenceTexture?: MaterialValue;\n  readonly iridescenceThicknessTexture?: MaterialValue;\n  readonly specular?: number;\n  readonly specularColor?: MaterialColorInput3;\n  readonly specularTexture?: MaterialValue;\n  readonly specularColorTexture?: MaterialValue;\n  readonly emissive?: MaterialColorInput3;\n  readonly emissiveIntensity?: number;\n  readonly emissiveTexture?: MaterialValue;\n  readonly baseColorTexture?: MaterialValue;\n  readonly metallicRoughnessTexture?: MaterialValue;\n  readonly normalTexture?: MaterialValue;\n  readonly occlusionTexture?: MaterialValue;\n  readonly occlusionStrength?: number;\n  readonly alphaCutoff?: number;\n  readonly transmission?: number;\n  readonly transmissionTexture?: MaterialValue;\n  readonly ior?: number;\n  readonly thickness?: number;\n  readonly thicknessTexture?: MaterialValue;\n  readonly attenuationColor?: readonly [number, number, number];\n  readonly attenuationDistance?: number;\n  readonly renderState?: MaterialRenderState;\n  readonly castShadow?: boolean;\n  readonly queue?: number;\n}\n\n/** Built-in Standard authoring surface with engine-owned parameter defaults. */\nexport interface DefaultStandardOptions extends StandardOpts {\n  readonly surfaceModule?: never;\n  readonly parameters?: never;\n  readonly values?: never;\n}\n\n/** Import-first Standard Surface authoring; the root parameter contract stays caller-owned. */\nexport interface CustomStandardSurfaceOptions {\n  readonly surfaceModule: string;\n  readonly parameters: readonly MaterialParameter[];\n  readonly values: Readonly<Record<string, MaterialValue>>;\n  readonly colorSpace?: MaterialColorSpace;\n  readonly renderState?: MaterialRenderState;\n  readonly castShadow?: boolean;\n  readonly queue?: number;\n  readonly baseColor?: never;\n  readonly metallic?: never;\n  readonly roughness?: never;\n  readonly metallicChannel?: never;\n  readonly roughnessChannel?: never;\n  readonly clearcoat?: never;\n  readonly clearcoatRoughness?: never;\n  readonly clearcoatTexture?: never;\n  readonly clearcoatRoughnessTexture?: never;\n  readonly clearcoatNormalTexture?: never;\n  readonly clearcoatNormalScale?: never;\n  readonly anisotropyStrength?: never;\n  readonly anisotropyRotation?: never;\n  readonly anisotropyTexture?: never;\n  readonly sheenColor?: never;\n  readonly sheenRoughness?: never;\n  readonly sheenColorTexture?: never;\n  readonly sheenRoughnessTexture?: never;\n  readonly iridescence?: never;\n  readonly iridescenceIor?: never;\n  readonly iridescenceThicknessMinimum?: never;\n  readonly iridescenceThicknessMaximum?: never;\n  readonly iridescenceTexture?: never;\n  readonly iridescenceThicknessTexture?: never;\n  readonly specular?: never;\n  readonly specularColor?: never;\n  readonly specularTexture?: never;\n  readonly specularColorTexture?: never;\n  readonly emissive?: never;\n  readonly emissiveIntensity?: never;\n  readonly emissiveTexture?: never;\n  readonly baseColorTexture?: never;\n  readonly metallicRoughnessTexture?: never;\n  readonly normalTexture?: never;\n  readonly occlusionTexture?: never;\n  readonly occlusionStrength?: never;\n  readonly alphaCutoff?: never;\n  readonly transmission?: never;\n  readonly transmissionTexture?: never;\n  readonly ior?: never;\n  readonly thickness?: never;\n  readonly thicknessTexture?: never;\n  readonly attenuationColor?: never;\n  readonly attenuationDistance?: never;\n}\n\nexport type StandardOptions = DefaultStandardOptions | CustomStandardSurfaceOptions;\n\nfunction validateChannel(\n  name: 'metallicChannel' | 'roughnessChannel',\n  value: number | undefined,\n): void {\n  if (value !== undefined && (!Number.isInteger(value) || value < 0 || value > 3)) {\n    throw new Error(`Materials.standard: ${name} must be an integer in [0, 3], got ${value}`);\n  }\n}\n\nfunction validateFiniteRange(\n  name: 'transmission' | 'ior' | 'thickness' | 'attenuationDistance',\n  value: number | undefined,\n  minimum: number,\n  maximum?: number,\n): void {\n  if (value === undefined || !Number.isFinite(value)) {\n    if (value === undefined) return;\n    throw new MaterialTransmissionContractError(name, 'non-finite', value);\n  }\n  if (value < minimum || (maximum !== undefined && value > maximum)) {\n    throw new MaterialTransmissionContractError(name, 'range', value);\n  }\n}\n\nfunction standardDefault(opts: DefaultStandardOptions): MaterialAsset {\n  const occlusionStrength = opts.occlusionStrength ?? 1;\n  if (occlusionStrength < 0 || occlusionStrength > 1) {\n    throw new Error(\n      `Materials.standard: occlusionStrength must be in [0, 1], got ${occlusionStrength}`,\n    );\n  }\n  if (opts.alphaCutoff !== undefined && (opts.alphaCutoff < 0 || opts.alphaCutoff > 1)) {\n    throw new Error(`Materials.standard: alphaCutoff must be in [0, 1], got ${opts.alphaCutoff}`);\n  }\n  validateChannel('metallicChannel', opts.metallicChannel);\n  validateChannel('roughnessChannel', opts.roughnessChannel);\n  const transmission = opts.transmission ?? 0;\n  const ior = opts.ior ?? 1.5;\n  const thickness = opts.thickness ?? 0;\n  const attenuationColor = opts.attenuationColor ?? [1, 1, 1];\n  validateFiniteRange('transmission', transmission, 0, 1);\n  validateFiniteRange('ior', ior, 1);\n  validateFiniteRange('thickness', thickness, 0);\n  validateFiniteRange('attenuationDistance', opts.attenuationDistance, Number.MIN_VALUE);\n  if (\n    attenuationColor.length !== 3 ||\n    attenuationColor.some((value) => !Number.isFinite(value) || value < 0 || value > 1)\n  ) {\n    throw new MaterialTransmissionContractError('attenuationColor', 'shape', attenuationColor);\n  }\n  if (transmission > 0 && opts.renderState?.blend !== undefined) {\n    throw new MaterialTransmissionContractError('transmission', 'blend', opts.renderState.blend);\n  }\n  if (transmission > 0 && opts.renderState?.depthWriteEnabled === true) {\n    throw new MaterialTransmissionContractError('transmission', 'depth-write', true);\n  }\n  const values: Record<string, MaterialValue> = {\n    baseColor: linearColorFromInput(opts.baseColor, 4),\n    metallic: opts.metallic ?? 0,\n    roughness: opts.roughness ?? 0.5,\n    occlusionStrength,\n    specular: opts.specular ?? 1,\n    specularColor:\n      opts.specularColor === undefined ? [1, 1, 1] : linearColorFromInput(opts.specularColor, 3),\n    transmission,\n    ior,\n    thickness,\n    attenuationColor,\n  };\n  if (opts.metallicChannel !== undefined) values.metallicChannel = opts.metallicChannel;\n  if (opts.roughnessChannel !== undefined) values.roughnessChannel = opts.roughnessChannel;\n  if (opts.clearcoat !== undefined) values.clearcoat = opts.clearcoat;\n  if (opts.clearcoatRoughness !== undefined) values.clearcoatRoughness = opts.clearcoatRoughness;\n  if (opts.clearcoatTexture !== undefined) values.clearcoatTexture = opts.clearcoatTexture;\n  if (opts.clearcoatRoughnessTexture !== undefined) {\n    values.clearcoatRoughnessTexture = opts.clearcoatRoughnessTexture;\n  }\n  if (opts.clearcoatNormalTexture !== undefined) {\n    values.clearcoatNormalTexture = opts.clearcoatNormalTexture;\n  }\n  if (opts.clearcoatNormalScale !== undefined)\n    values.clearcoatNormalScale = opts.clearcoatNormalScale;\n  if (opts.anisotropyStrength !== undefined) values.anisotropyStrength = opts.anisotropyStrength;\n  if (opts.anisotropyRotation !== undefined) values.anisotropyRotation = opts.anisotropyRotation;\n  if (opts.anisotropyTexture !== undefined) values.anisotropyTexture = opts.anisotropyTexture;\n  if (opts.sheenColor !== undefined) values.sheenColor = linearColorFromInput(opts.sheenColor, 3);\n  if (opts.sheenRoughness !== undefined) values.sheenRoughness = opts.sheenRoughness;\n  if (opts.sheenColorTexture !== undefined) values.sheenColorTexture = opts.sheenColorTexture;\n  if (opts.sheenRoughnessTexture !== undefined) {\n    values.sheenRoughnessTexture = opts.sheenRoughnessTexture;\n  }\n  if (opts.iridescence !== undefined) values.iridescence = opts.iridescence;\n  if (opts.iridescenceIor !== undefined) values.iridescenceIor = opts.iridescenceIor;\n  if (opts.iridescenceThicknessMinimum !== undefined) {\n    values.iridescenceThicknessMinimum = opts.iridescenceThicknessMinimum;\n  }\n  if (opts.iridescenceThicknessMaximum !== undefined) {\n    values.iridescenceThicknessMaximum = opts.iridescenceThicknessMaximum;\n  }\n  if (opts.iridescenceTexture !== undefined) values.iridescenceTexture = opts.iridescenceTexture;\n  if (opts.iridescenceThicknessTexture !== undefined) {\n    values.iridescenceThicknessTexture = opts.iridescenceThicknessTexture;\n  }\n  if (opts.emissive !== undefined) values.emissive = linearColorFromInput(opts.emissive, 3);\n  if (opts.emissiveIntensity !== undefined) values.emissiveIntensity = opts.emissiveIntensity;\n  if (opts.emissiveTexture !== undefined) values.emissiveTexture = opts.emissiveTexture;\n  if (opts.baseColorTexture !== undefined) values.baseColorTexture = opts.baseColorTexture;\n  if (opts.metallicRoughnessTexture !== undefined) {\n    values.metallicRoughnessTexture = opts.metallicRoughnessTexture;\n  }\n  if (opts.normalTexture !== undefined) values.normalTexture = opts.normalTexture;\n  if (opts.occlusionTexture !== undefined) values.occlusionTexture = opts.occlusionTexture;\n  if (opts.specularTexture !== undefined) values.specularTexture = opts.specularTexture;\n  if (opts.specularColorTexture !== undefined) {\n    values.specularColorTexture = opts.specularColorTexture;\n  }\n  if (opts.alphaCutoff !== undefined) values.alphaCutoff = opts.alphaCutoff;\n  if (opts.transmissionTexture !== undefined) values.transmissionTexture = opts.transmissionTexture;\n  if (opts.thicknessTexture !== undefined) values.thicknessTexture = opts.thicknessTexture;\n  if (opts.attenuationDistance !== undefined) values.attenuationDistance = opts.attenuationDistance;\n  const forwardRenderState =\n    transmission > 0 ? { ...(opts.renderState ?? {}), depthWriteEnabled: false } : opts.renderState;\n  const parameters = standardSurfaceParameters(standardParameters('linear', opts));\n  const declaredNames = new Set(parameters.map((parameter) => parameter.name));\n  for (const name of Object.keys(values)) {\n    if (!declaredNames.has(name)) delete values[name];\n  }\n  const layerPlan = deriveStandardLayerPlan(parameters);\n  const projected = projectStandardSurfacePasses({\n    surfaceModule: DEFAULT_STANDARD_SURFACE_MODULE,\n    values,\n    ...(forwardRenderState === undefined ? {} : { renderState: forwardRenderState }),\n    ...(opts.castShadow === undefined ? {} : { castShadow: opts.castShadow }),\n    ...(opts.queue === undefined ? {} : { queue: opts.queue }),\n    layerPlan,\n  });\n  const passes = (\n    transmission > 0 ? projected.filter((entry) => entry.name !== 'deferred') : projected\n  ) as [MaterialPass, ...MaterialPass[]];\n  return {\n    kind: 'material',\n    colorSpace: 'linear',\n    passes,\n    parameters,\n    values,\n  };\n}\n\nfunction standardCustom(opts: CustomStandardSurfaceOptions): MaterialAsset {\n  const layerPlan = deriveStandardLayerPlan(\n    opts.parameters.filter((parameter) => parameter.optional !== true),\n  );\n  return {\n    kind: 'material',\n    ...(opts.colorSpace === undefined || opts.colorSpace === 'srgb'\n      ? {}\n      : { colorSpace: opts.colorSpace }),\n    passes: projectStandardSurfacePasses({\n      surfaceModule: opts.surfaceModule,\n      values: opts.values,\n      ...(opts.renderState === undefined ? {} : { renderState: opts.renderState }),\n      ...(opts.castShadow === undefined ? {} : { castShadow: opts.castShadow }),\n      ...(opts.queue === undefined ? {} : { queue: opts.queue }),\n      layerPlan,\n    }),\n    parameters: standardSurfaceParameters(opts.parameters),\n    values: opts.values,\n  };\n}\n\nexport function standard(options: StandardOptions): MaterialAsset {\n  return options.surfaceModule === undefined ? standardDefault(options) : standardCustom(options);\n}\n\nexport const Materials = { unlit, standard, srgb } as const;\n\nexport { SPRITE_MODULE };\n"]}