@forgeax/engine-render 0.1.32 → 0.1.34

package/src/ibl/skylight-bind-group.ts

@@ -242,6 +242,16 @@ export interface TransmissionBindGroupResources {
   readonly backdropView?: TextureView | null;
 }
 
+/** Renderer-owned sampled resources consumed by the single-layer medium. */
+export interface SurfaceMediumBindGroupResources {
+  readonly rawDepthSampler: Sampler;
+  readonly rawDepthView: TextureView;
+  readonly nearestLayerSampler: Sampler;
+  readonly nearestLayerView: TextureView;
+  readonly nearestDepthSampler: Sampler;
+  readonly nearestDepthView: TextureView;
+}
+
 /** Engine-owned texture injection resources derived from material parameters. */
 export interface TextureInjectionResource {
   readonly slot: number;
@@ -258,6 +268,7 @@ export function assembleMaterialWithSkylightEntries(
   skylight: SkylightBindGroupResources,
   transmission?: TransmissionBindGroupResources | null | undefined,
   textureInjections: readonly TextureInjectionResource[] = [],
+  surfaceMedium?: SurfaceMediumBindGroupResources | undefined,
 ): BindGroupEntry[] {
   // IBL injection start = end of the user-region. The user-region IS
   // `materialEntries` (UBO binding 0 + N sampler/texture pairs), so its length
@@ -314,6 +325,35 @@ export function assembleMaterialWithSkylightEntries(
         resource: { kind: 'textureView', value: transmissionView },
       },
     );
+  if (surfaceMedium !== undefined) {
+    const surfaceStart = result.length;
+    result.push(
+      {
+        binding: surfaceStart,
+        resource: { kind: 'sampler', value: surfaceMedium.rawDepthSampler },
+      },
+      {
+        binding: surfaceStart + 1,
+        resource: { kind: 'textureView', value: surfaceMedium.rawDepthView },
+      },
+      {
+        binding: surfaceStart + 2,
+        resource: { kind: 'sampler', value: surfaceMedium.nearestLayerSampler },
+      },
+      {
+        binding: surfaceStart + 3,
+        resource: { kind: 'textureView', value: surfaceMedium.nearestLayerView },
+      },
+      {
+        binding: surfaceStart + 4,
+        resource: { kind: 'sampler', value: surfaceMedium.nearestDepthSampler },
+      },
+      {
+        binding: surfaceStart + 5,
+        resource: { kind: 'textureView', value: surfaceMedium.nearestDepthView },
+      },
+    );
+  }
   // Standard physical maps occupy fixed bindings 26..45.  The `slot` value
   // is the canonical index from STANDARD_PHYSICAL_TEXTURE_FIELDS; preserve
   // gaps for omitted authored maps instead of compacting this tail.
@@ -333,13 +373,15 @@ export function assembleMaterialWithSkylightEntries(
       },
     );
   }
-  result.push({
-    binding: 47,
-    resource: {
-      kind: 'textureView',
-      value: skylight.skylightPrefilterView ?? skylight.prefilterView,
-    },
-  });
+  if (surfaceMedium === undefined) {
+    result.push({
+      binding: 47,
+      resource: {
+        kind: 'textureView',
+        value: skylight.skylightPrefilterView ?? skylight.prefilterView,
+      },
+    });
+  }
   return result;
 }
 

package/src/index.ts

@@ -11,6 +11,18 @@ export {
   renderPipelineContribution,
   samplerContribution,
 } from './assets/asset-decoders.js';
+export {
+  attachBarrelDistortionCameraFrame,
+  type BarrelDistortionCameraFrame,
+  type BarrelDistortionMapping,
+  createBarrelDistortionMapping,
+  type DisplayPoint,
+  freezeBarrelDistortionMapping,
+  mapDisplayToScene,
+  mapDisplayUvToSceneUv,
+  mapSceneToDisplay,
+  mapSceneUvToDisplayUv,
+} from './barrel-distortion.js';
 // Runtime contract: leases, frame receipts, detached inspection, profile,
 // lifecycle state, and the single renderer event stream.
 export type {
@@ -18,7 +30,107 @@ export type {
   CubeCameraFaceViewInput,
 } from './capture/cube-views.js';
 export { buildCubeCameraFaceViews } from './capture/cube-views.js';
+export {
+  buildCloudDensityCache,
+  type CloudDensityCache,
+  type CloudDensityCacheSnapshot,
+  type CloudDensitySample,
+  evaluateCloudDensity,
+  reconstructCloudDensityCache,
+  sampleCloudDensity,
+  snapshotCloudDensityCache,
+} from './cloud/density.js';
+export {
+  type CloudLayerCandidate,
+  type ExtractedCloudLayer,
+  extractCloudLayer,
+  selectCloudLayerFrame,
+} from './cloud/extract.js';
+export {
+  CLOUD_DENSITY_COMPUTE_WGSL,
+  CLOUD_HISTORY_FULLSCREEN_WGSL,
+  CLOUD_LAYER_DENSITY_BINDINGS,
+  CLOUD_LAYER_DENSITY_CACHE,
+  CLOUD_LAYER_DENSITY_OUTPUT,
+  CLOUD_LAYER_DENSITY_PROGRAM,
+  CLOUD_LAYER_FEATURE_IDENTITY,
+  CLOUD_VIEW_FULLSCREEN_WGSL,
+  CLOUD_VIEW_PARAMS_BYTES,
+  type CloudLayerFeatureFrame,
+  type CloudLayerFeatureOptions,
+  createCloudLayerFeature,
+} from './cloud/feature.js';
+export {
+  type CloudLayerBudgetObservation,
+  type CloudLayerInspection,
+  type CloudLayerInspectionInput,
+  type CloudLayerInspectionStatus,
+  type CloudLayerResourceStage,
+  type CloudPhysicalGpuEvidence,
+  cloudCapabilitiesFromRhi,
+  inspectCloudLayer,
+} from './cloud/inspection.js';
+export {
+  applyCloudSolarTransmittance,
+  type CloudInteriorLighting,
+  type CloudOpticalPath,
+  type CloudOpticalResult,
+  type CloudOpticsInput,
+  type CloudRay,
+  compositeCloudRadiance,
+  integrateCloudCameraPath,
+  integrateCloudInterior,
+  integrateCloudPath,
+  integrateCloudSolarColumn,
+  intersectCloudLayer,
+} from './cloud/optics.js';
+export {
+  CLOUD_QUALITY_PROFILES,
+  type CloudLayerAuthoring,
+  type CloudQualityProfile,
+  cloudLayerSourceKey,
+  DEFAULT_CLOUD_LAYER,
+  type ValidatedCloudLayer,
+  validateCloudLayer,
+} from './cloud/parameters.js';
+export {
+  acceptCloudLayerGeneration,
+  CLOUD_HISTORY_SURFACE_COUNT,
+  CLOUD_RGBA16FLOAT_BYTES_PER_TEXEL,
+  type CloudGpuResourceEvidence,
+  type CloudLayerGeneration,
+  type CloudLayerResourceFacts,
+  type CloudLayerResourceInputs,
+  inspectCloudLayerResources,
+  retainCloudLayerAfterFailure,
+} from './cloud/resources.js';
+export {
+  type CloudShadowProjection,
+  type CloudShadowSample,
+  createCloudShadowProjection,
+  projectCloudShadowUv,
+  sampleCloudShadow,
+} from './cloud/shadow.js';
+export {
+  type CloudHistory,
+  type CloudHistoryReprojection,
+  type CloudHistoryReprojectionInput,
+  CloudHistoryStore,
+  type CloudTemporalDecision,
+  type CloudTemporalFrame,
+  type CloudTemporalResetReason,
+  type CloudTemporalSignature,
+  cloudTemporalResetReasons,
+  cloudTemporalSignature,
+  createCloudHistory,
+  reprojectCloudHistory,
+} from './cloud/temporal.js';
 export { Atmosphere } from './components/atmosphere.js';
+export {
+  BarrelDistortion,
+  type BarrelDistortionData,
+  validateBarrelDistortionParameters,
+} from './components/barrel-distortion.js';
 // ECS render vocabulary and grouped closed values.
 export type {
   Antialias,
@@ -37,6 +149,14 @@ export {
   ANTIALIAS_TAA,
   BLOOM_DISABLED,
   BLOOM_ENABLED,
+  CAMERA_BLOOM_INTENSITY_MAX,
+  CAMERA_BLOOM_INTENSITY_MIN,
+  CAMERA_BLOOM_SCATTER_MAX,
+  CAMERA_BLOOM_SCATTER_MIN,
+  CAMERA_BLOOM_SOFT_KNEE_MAX,
+  CAMERA_BLOOM_SOFT_KNEE_MIN,
+  CAMERA_BLOOM_THRESHOLD_MAX,
+  CAMERA_BLOOM_THRESHOLD_MIN,
   CAMERA_EXPOSURE_MODE_AUTO,
   CAMERA_EXPOSURE_MODE_MANUAL,
   CAMERA_PROJECTION_ORTHOGRAPHIC,
@@ -59,9 +179,17 @@ export {
   TONEMAP_NONE,
   TONEMAP_REINHARD,
   TONEMAP_REINHARD_EXTENDED,
+  validateCameraBloom,
   validateCameraColorGrading,
   validateCameraExposure,
 } from './components/camera.js';
+export {
+  CloudLayer,
+  type CloudLayerData,
+  type CloudQuality,
+  CloudQualityValue,
+  cloudQualityFromF32,
+} from './components/cloud-layer.js';
 export {
   CUBE_CAMERA_FACE_ORDER,
   CUBE_CAMERA_UPDATE_CONTINUOUS,
@@ -155,12 +283,32 @@ export {
   createDynamicGeometryLifecycle,
   DynamicGeometryError,
 } from './dynamic-geometry.js';
+// The environment selector owns this structured recovery error. Keep the
+// class on the public environment path so consumers can branch by `code` and
+// inspect its typed `detail` without importing an owner-private module.
+export { SunCardinalityError } from './environment/frame.js';
 export type {
   EnvironmentInspection,
   EnvironmentInspectionFailure,
   EnvironmentInspectionGeneration,
   EnvironmentInspectionStatus,
 } from './environment/inspection.js';
+export type {
+  CloudLayerCacheInvalidDetail,
+  CloudLayerCapabilityMissingDetail,
+  CloudLayerError,
+  CloudLayerErrorCode,
+  CloudLayerInvalidParameterDetail,
+  CloudLayerOwnerConflictDetail,
+  CloudLayerResourceFailureDetail,
+} from './errors/cloud.js';
+export {
+  CloudLayerCacheInvalidError,
+  CloudLayerCapabilityMissingError,
+  CloudLayerInvalidParameterError,
+  CloudLayerOwnerConflictError,
+  CloudLayerResourceFailureError,
+} from './errors/cloud.js';
 // Public structured operation failure union. Concrete error classes stay
 // behind the Renderer Result/event boundary.
 export type {
@@ -171,6 +319,7 @@ export type {
 } from './errors/gpu-driven';
 export { GpuDrivenPreparationError } from './errors/gpu-driven';
 export type {
+  BarrelDistortionInvalidParameterDetail,
   DynamicResolutionError,
   ReflectionProbeBudgetExceededDetail,
   RenderError,
@@ -185,6 +334,7 @@ export type {
 } from './errors/render.js';
 export {
   AtmosphereInvalidParameterError,
+  BarrelDistortionInvalidParameterError,
   DynamicResolutionInvalidParameterError,
   DynamicResolutionRequiresTaaError,
   DynamicResolutionTimingUnavailableError,
@@ -192,9 +342,14 @@ export {
   EnvironmentSourceConflictError,
   FogCardinalityError,
   OwnerStageFailedError,
+  RendererOperationError,
   SceneDataUnavailableError,
   TaaCapsInsufficientError,
 } from './errors/render.js';
+export {
+  SINGLE_LAYER_MEDIUM_SURFACE_EXAMPLE,
+  SINGLE_LAYER_MEDIUM_SURFACE_EXAMPLES,
+} from './examples/single-layer-medium-surface.js';
 export type {
   EnvironmentFrame,
   EnvironmentSource,
@@ -206,6 +361,14 @@ export {
   type VisibilityResolution,
   type VisibilitySnapshot,
 } from './extract/visibility.js';
+export {
+  BARREL_DISTORTION_FEATURE_IDENTITY,
+  BARREL_DISTORTION_POST_PROCESS_ID,
+  BARREL_DISTORTION_WGSL,
+  BARREL_DISTORTION_WGSL_COORDINATE,
+  type BarrelDistortionFeatureFrame,
+  createBarrelDistortionRenderFeature,
+} from './features/barrel-distortion.js';
 export {
   DEFAULT_DEPTH_OF_FIELD_PARAMS,
   DEPTH_OF_FIELD_PARAMS_BYTE_SIZE,
@@ -225,6 +388,22 @@ export {
   validateDepthOfFieldFrameParams,
   validateDepthOfFieldParams,
 } from './features/depth-of-field/depth-of-field-params.js';
+export type {
+  MotionBlurInvalidParamsDetail,
+  MotionBlurParams,
+  MotionBlurSampleTier,
+} from './features/motion-blur/motion-blur-params.js';
+export {
+  DEFAULT_MOTION_BLUR_PARAMS,
+  effectiveMotionBlurSampleCount,
+  isMotionBlurIntervalValid,
+  MotionBlurValidationError,
+  motionBlurExposureScale,
+  motionBlurSampleDelta,
+  motionBlurTemporalDemand,
+  resolveMotionBlurParams,
+  validateMotionBlurParams,
+} from './features/motion-blur/motion-blur-params.js';
 export type {
   RenderFeatureLogicalTarget,
   RenderFeatureMaterialShaderBindingContract,
@@ -242,10 +421,13 @@ export type {
   RenderFeatureDiagnostics,
   RenderFeatureErrorDescriptor,
   RenderFeatureExtractContext,
+  RenderFeatureFrameContext,
   RenderFeatureHiddenEntityReport,
+  RenderFeaturePlacement,
   RenderFeatureShaderModuleMode,
   RenderFeatureStatus,
   RenderFeatureSubmission,
+  RenderFeatureViewContext,
   RenderFeatureWorldVisibilitySnapshot,
 } from './features/types.js';
 export {
@@ -261,6 +443,7 @@ export {
   resetIblKernelCaches,
 } from './ibl/kernel-cache.js';
 export type {
+  BarrelDistortionInspection,
   BloomInspection,
   DepthOfFieldInspection,
   DepthOfFieldInspectionStatus,
@@ -273,7 +456,10 @@ export type {
   LightInspection,
   LodOcclusionInspection,
   MaterialTextureSourceInspection,
+  MotionBlurExecutionPass,
+  MotionBlurExecutionReceipt,
   MotionBlurInspection,
+  MotionBlurInspectionLane,
   MotionBlurInspectionStatus,
   ReflectionFallbackFailureStage,
   ReflectionFallbackInspection,
@@ -288,22 +474,14 @@ export type {
 } from './inspection-types.js';
 export {
   type InstanceBackendKind,
-  type InstanceCollectionCreateInput,
-  type InstanceCollectionData,
-  InstanceCollectionError,
-  type InstanceCollectionErrorCode,
   type InstanceCollectionFailureCode,
   type InstanceCollectionFailureFacts,
   type InstanceCollectionId,
   type InstanceCollectionInfo,
   type InstanceCollectionInspection,
-  type InstanceCollectionInvalidDetail,
-  type InstanceCollectionResult,
-  type InstanceCollectionSnapshot,
-  InstanceCollectionStore,
-  type InstanceCollectionUpdateInput,
   type InstanceDirtyRange,
   type InstanceSubmissionLane,
+  InstanceTransformsError,
 } from './instances';
 export {
   MaterialAuthoringContractError,
@@ -451,6 +629,7 @@ export type {
   FrameCamera,
   FrameEnvironment,
   FrameObservationRequest,
+  FramePresentation,
   FrameReceipt,
   FrameReceiptObservation,
   Renderer,
@@ -560,6 +739,31 @@ export {
   projectSsrSpatialInspection,
   serializeSsrSpatialInspection,
 } from './ssr/inspection.js';
+export {
+  type DynamicInputConsumptionReceipt,
+  type DynamicInputDirtyRange,
+  DynamicInputError,
+  type DynamicInputErrorCode,
+  type DynamicInputErrorDetail,
+  type DynamicInputRange,
+  type DynamicInputResult,
+  type DynamicInputUploadReceipt,
+  type DynamicInputValue,
+  ReadonlyDynamicInputPage,
+  type SurfaceDynamicInputFrame,
+  type SurfaceDynamicInputMemberIdentity,
+} from './surface/dynamic-input.js';
+export {
+  admitSingleLayerMediumSubmission,
+  type SurfaceGpuCapability,
+  type SurfaceGpuFallbackReason,
+  type SurfaceGpuPassAdmission,
+  type SurfaceGpuSubmissionAdmission,
+  type SurfaceGpuSubmissionError,
+  type SurfaceGpuSubmissionErrorCode,
+  type SurfaceGpuSubmissionInput,
+} from './surface/gpu-driven.js';
+export type { SurfaceGpuIndirectParameters } from './surface/submission-observation.js';
 export { getActiveCamera, setActiveCamera } from './systems/active-camera.js';
 export type {
   RenderTarget,
@@ -594,6 +798,19 @@ export {
   type SceneDataInspection,
 } from './temporal/scene-data-catalog.js';
 export type { TemporalView } from './temporal/view.js';
+export {
+  composeSingleLayerMediumColor,
+  estimateSingleLayerPathLength,
+  integrateSingleLayerMedium,
+  type MediumVector3,
+  resolveSingleLayerMediumBackground,
+  type SingleLayerMediumBackgroundCandidate,
+  type SingleLayerMediumBackgroundInput,
+  type SingleLayerMediumBackgroundReason,
+  type SingleLayerMediumBackgroundResolution,
+  type SingleLayerMediumCoefficients,
+  type SingleLayerMediumOptics,
+} from './transmission/single-layer-medium.js';
 export {
   hasVolumetricFogCapability,
   type IntegratedVolumeResource,
@@ -606,12 +823,14 @@ export {
   type VolumetricFogLightResolution,
 } from './volume/capability.js';
 export {
+  MAX_VOLUMETRIC_FOG_OWNERS,
   type ValidatedVolumetricFog,
   type VolumeBounds,
   type VolumeDensityBinding,
   VolumetricFog,
   type VolumetricFogAuthoring,
   type VolumetricFogLightSelection,
+  VolumetricFogSamplingValue,
   validateVolumetricFog,
 } from './volume/component.js';
 export { extractVolumetricFog, type VolumetricFogExtract } from './volume/extract.js';