@forgeax/engine-render 0.1.28 → 0.1.30

package/src/index.ts

@@ -10,23 +10,26 @@ export {
   materialContribution,
   renderPipelineContribution,
   samplerContribution,
-} from './assets/asset-decoders';
+} from './assets/asset-decoders.js';
 // Runtime contract: leases, frame receipts, detached inspection, profile,
 // lifecycle state, and the single renderer event stream.
 export type {
   CubeCameraFaceView,
   CubeCameraFaceViewInput,
-} from './capture/cube-views';
-export { buildCubeCameraFaceViews } from './capture/cube-views';
-export { Atmosphere } from './components/atmosphere';
+} from './capture/cube-views.js';
+export { buildCubeCameraFaceViews } from './capture/cube-views.js';
+export { Atmosphere } from './components/atmosphere.js';
 // ECS render vocabulary and grouped closed values.
 export type {
   Antialias,
   BloomEnabled,
   CameraData,
+  CameraErrorCode,
+  CameraErrorDetail,
+  CameraExposure,
   CameraProjection,
   Tonemap,
-} from './components/camera';
+} from './components/camera.js';
 export {
   ANTIALIAS_FXAA,
   ANTIALIAS_MSAA,
@@ -34,9 +37,17 @@ export {
   ANTIALIAS_TAA,
   BLOOM_DISABLED,
   BLOOM_ENABLED,
+  CAMERA_EXPOSURE_MODE_AUTO,
+  CAMERA_EXPOSURE_MODE_MANUAL,
   CAMERA_PROJECTION_ORTHOGRAPHIC,
   CAMERA_PROJECTION_PERSPECTIVE,
+  CAMERA_TEMPERATURE_MAX,
+  CAMERA_TEMPERATURE_MIN,
+  CAMERA_TINT_MAX,
+  CAMERA_TINT_MIN,
   Camera,
+  CameraError,
+  cameraExposureFromColumns,
   cameraProjectionFromF32,
   orthographic,
   perspective,
@@ -48,7 +59,9 @@ export {
   TONEMAP_NONE,
   TONEMAP_REINHARD,
   TONEMAP_REINHARD_EXTENDED,
-} from './components/camera';
+  validateCameraColorGrading,
+  validateCameraExposure,
+} from './components/camera.js';
 export {
   CUBE_CAMERA_FACE_ORDER,
   CUBE_CAMERA_UPDATE_CONTINUOUS,
@@ -60,27 +73,33 @@ export {
   type CubeCameraUpdateIntent,
   cubeCameraUpdateIntentFromF32,
   cubeCameraUpdateIntentToF32,
-} from './components/cube-camera';
-export * from './components/directional-light';
-export { Fog } from './components/fog';
-export { Instances, type InstancesData } from './components/instances';
-export { Layer } from './components/layer';
-export * from './components/light-helpers';
-export { LightProbe } from './components/light-probe';
-export { Lines } from './components/lines';
-export * from './components/mesh-filter';
-export * from './components/mesh-renderer';
-export { MotionBlur } from './components/motion-blur';
-export { PointLight } from './components/point-light';
-export { PointLightShadow } from './components/point-light-shadow';
+} from './components/cube-camera.js';
+export * from './components/directional-light.js';
+export {
+  DynamicResolution,
+  type DynamicResolutionData,
+  validateDynamicResolutionCamera,
+  validateDynamicResolutionParameters,
+} from './components/dynamic-resolution.js';
+export { Fog } from './components/fog.js';
+export { Instances, type InstancesData } from './components/instances.js';
+export { Layer } from './components/layer.js';
+export * from './components/light-helpers.js';
+export { LightProbe } from './components/light-probe.js';
+export { Lines } from './components/lines.js';
+export * from './components/mesh-filter.js';
+export * from './components/mesh-renderer.js';
+export { MotionBlur } from './components/motion-blur.js';
+export { PointLight } from './components/point-light.js';
+export { PointLightShadow } from './components/point-light-shadow.js';
 export {
   type PointShape,
   PointShapeValue,
   Points,
   pointShapeFromU32,
-} from './components/points';
-export { PostProcessParams } from './components/post-process-params';
-export { RectAreaLight } from './components/rect-area-light';
+} from './components/points.js';
+export { PostProcessParams } from './components/post-process-params.js';
+export { RectAreaLight } from './components/rect-area-light.js';
 export {
   REFLECTION_PROBE_UPDATE_CONTINUOUS,
   REFLECTION_PROBE_UPDATE_ON_CHANGE,
@@ -90,23 +109,27 @@ export {
   type ReflectionProbeUpdateIntent,
   reflectionProbeUpdateIntentFromF32,
   reflectionProbeUpdateIntentToF32,
-} from './components/reflection-probe';
-export { SceneInstance } from './components/scene-instance';
+} from './components/reflection-probe.js';
+export { SceneInstance } from './components/scene-instance.js';
+export {
+  ScreenSpaceReflection,
+  type ScreenSpaceReflectionData,
+} from './components/screen-space-reflection';
 export {
   SKYBOX_MODE_CUBEMAP,
   SkyboxBackground,
   type SkyboxMode,
-} from './components/skybox-background';
-export { Skylight } from './components/skylight';
-export { SortKey } from './components/sort-key';
-export type { SpotLightAuthoring, SpotLightProjector } from './components/spot-light';
-export { SpotLight } from './components/spot-light';
+} from './components/skybox-background.js';
+export { Skylight } from './components/skylight.js';
+export { SortKey } from './components/sort-key.js';
+export type { SpotLightAuthoring, SpotLightProjector } from './components/spot-light.js';
+export { SpotLight } from './components/spot-light.js';
 export {
   Visibility,
   type VisibilityState,
   VisibilityStateValue,
   visibilityStateFromU32,
-} from './components/visibility';
+} from './components/visibility.js';
 export type {
   DynamicGeometryCandidate,
   DynamicGeometryCandidateState,
@@ -117,20 +140,28 @@ export type {
   DynamicGeometryOrdering,
   DynamicGeometryPrepareInput,
   DynamicGeometryReceipt,
-} from './dynamic-geometry';
+} from './dynamic-geometry.js';
 export {
   createDynamicGeometryLifecycle,
   DynamicGeometryError,
-} from './dynamic-geometry';
+} from './dynamic-geometry.js';
 export type {
   EnvironmentInspection,
   EnvironmentInspectionFailure,
   EnvironmentInspectionGeneration,
   EnvironmentInspectionStatus,
-} from './environment/inspection';
+} from './environment/inspection.js';
 // Public structured operation failure union. Concrete error classes stay
 // behind the Renderer Result/event boundary.
 export type {
+  GpuDrivenPreparationErrorCode,
+  GpuDrivenPreparationErrorDetail,
+  GpuDrivenPreparationReason,
+  GpuDrivenRecoveryAction,
+} from './errors/gpu-driven';
+export { GpuDrivenPreparationError } from './errors/gpu-driven';
+export type {
+  DynamicResolutionError,
   ReflectionProbeBudgetExceededDetail,
   RenderError,
   RenderErrorCode,
@@ -141,27 +172,30 @@ export type {
   RenderTargetStateInvalidDetail,
   SceneDataUnavailableDetail,
   SceneDataUnavailableReason,
-} from './errors/render';
+} from './errors/render.js';
 export {
   AtmosphereInvalidParameterError,
+  DynamicResolutionInvalidParameterError,
+  DynamicResolutionRequiresTaaError,
+  DynamicResolutionTimingUnavailableError,
   EnvironmentGenerationFailedError,
   EnvironmentSourceConflictError,
   FogCardinalityError,
   OwnerStageFailedError,
   SceneDataUnavailableError,
   TaaCapsInsufficientError,
-} from './errors/render';
+} from './errors/render.js';
 export type {
   EnvironmentFrame,
   EnvironmentSource,
   FogFrame,
   FramePlan,
-} from './extract/environment';
+} from './extract/environment.js';
 export {
   resolveVisibility,
   type VisibilityResolution,
   type VisibilitySnapshot,
-} from './extract/visibility';
+} from './extract/visibility.js';
 export type {
   RenderFeatureLogicalTarget,
   RenderFeatureMaterialShaderBindingContract,
@@ -169,7 +203,7 @@ export type {
   RenderFeaturePlan,
   RenderFeaturePlanContext,
   RenderFeatureResourceDeclaration,
-} from './features/plan';
+} from './features/plan.js';
 // Minimal declarative extension contract. Implementations use relative
 // imports; the root does not expose prepared state, graph projectors, target
 // handles, or builtin feature factories.
@@ -183,7 +217,7 @@ export type {
   RenderFeatureShaderModuleMode,
   RenderFeatureStatus,
   RenderFeatureWorldVisibilitySnapshot,
-} from './features/types';
+} from './features/types.js';
 export {
   beginProbeIblUpdate,
   createIblKernelCache,
@@ -195,11 +229,18 @@ export {
   REFLECTION_PROBE_IBL_STAGES,
   type ReflectionProbeIblStage,
   resetIblKernelCaches,
-} from './ibl/kernel-cache';
+} from './ibl/kernel-cache.js';
 export type {
   BloomInspection,
+  GpuDrivenLane,
+  GpuDrivenLaneReason,
+  GpuDrivenLaneSummary,
+  GpuDrivenPreparationFailureInspection,
+  GpuDrivenProductionInspection,
+  GpuDrivenStructureMetrics,
   LightInspection,
   LodOcclusionInspection,
+  MaterialTextureSourceInspection,
   MotionBlurInspection,
   MotionBlurInspectionStatus,
   ReflectionFallbackFailureStage,
@@ -209,10 +250,31 @@ export type {
   ReflectionFallbackRecoveryAction,
   ReflectionProbeInspection,
   ReflectionProbeSelectionInspection,
+  RenderFeatureGraphInspection,
+  RenderFeatureHostInspection,
   TransmissionInspection,
-} from './inspection-types';
-export type { InstanceCollectionInspection } from './instances';
+} 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,
+} from './instances';
+export {
+  MaterialAuthoringContractError,
   type MaterialColorInput3,
   type MaterialColorInput4,
   type MaterialColorTuple3,
@@ -220,7 +282,7 @@ export {
   Materials,
   MaterialTransmissionContractError,
   srgb,
-} from './materials';
+} from './materials.js';
 export {
   type MeshMaterialBindingObservation,
   type MeshMaterialBindingPreparationFailure,
@@ -231,24 +293,53 @@ export {
   type MeshMaterialBindingTextureObservation,
   projectMeshMaterialBindingObservation,
   summarizeMeshMaterialBindings,
-} from './mesh-material-bindings';
+} from './mesh-material-bindings.js';
+export type { RenderExtent } from './pipeline/render-extent.js';
 export type {
   StandardClusterTransportInspection,
   StandardLightingInspection,
   StandardNoLocalLightingInspection,
-} from './pipeline/standard-lighting/inspection';
+} from './pipeline/standard-lighting/inspection.js';
+export type {
+  AutoExposureCapabilityUnavailableDetail,
+  AutoExposureError,
+  AutoExposureErrorCode,
+  AutoExposureErrorDetail,
+  AutoExposureErrorDetailByCode,
+  AutoExposureErrorRecord,
+  AutoExposureInspection,
+  AutoExposureInspectionInput,
+  AutoExposureInvalidParameterDetail,
+  AutoExposureReceipt,
+  AutoExposureResetReason,
+  AutoExposureStageFailedDetail,
+  AutoExposureStaleGenerationDetail,
+} from './pipeline/standard-output/auto-exposure/inspection.js';
+export {
+  AutoExposureCapabilityUnavailableError,
+  AutoExposureInvalidParameterError,
+  AutoExposureStageFailedError,
+  AutoExposureStaleGenerationError,
+  createAutoExposureError,
+  createAutoExposureInspection,
+} from './pipeline/standard-output/auto-exposure/inspection.js';
+export type {
+  StandardLutFailure,
+  StandardLutInspection,
+  StandardLutState,
+} from './pipeline/standard-output/lut-state.js';
 // The host-facing default is a stable profile value; implementation-only
 // pipeline helpers remain behind the package boundary.
 export {
   DEFAULT_STANDARD_PROFILE,
   type StandardVolumetricFogProfile,
   type StandardVolumetricFogQuality,
-} from './pipeline/standard-profile';
-export { renderComponentsPlugin } from './plugin';
+} from './pipeline/standard-profile.js';
+export { renderComponentsPlugin } from './plugin.js';
 export {
   inspectPointShadow,
   type PointShadowInspection,
-} from './point-shadow-inspection';
+} from './point-shadow-inspection.js';
 export {
   admitPointsLines,
   type LinesStyleInput,
@@ -257,8 +348,8 @@ export {
   type PointsLinesAdmissionInput,
   type PointsLinesAdmissionLimits,
   type PointsStyleInput,
-} from './points-lines/admission';
-export type { PointsLinesInspection } from './points-lines/inspection';
+} from './points-lines/admission.js';
+export type { PointsLinesInspection } from './points-lines/inspection.js';
 /**
  * Public bounded GPU pass facts. Use the single `gpuPassTiming` opt-in,
  * `draw()` receipt, and `observe(receipt, { include: ['timings'] })` route.
@@ -295,17 +386,17 @@ export {
   createProbeFilterState,
   type ProbeFilterState,
   probeFilterIsSteady,
-} from './reflection/filter';
+} from './reflection/filter.js';
 export {
   buildReflectionProbeTable,
   type ReflectionProbeTable,
   type ReflectionProbeTableRow,
   reflectionProbeTableBytes,
-} from './reflection/gpu-table';
+} from './reflection/gpu-table.js';
 export {
   inspectReflectionFallback,
   type ReflectionFallbackFailureInput,
-} from './reflection/inspection';
+} from './reflection/inspection.js';
 export {
   admitReflectionProbe,
   DEFAULT_REFLECTION_PROBE_LIMITS,
@@ -321,8 +412,9 @@ export {
   type SkylightSelection,
   selectReflectionProbe,
   validateReflectionProbeInput,
-} from './reflection/projection';
+} from './reflection/projection.js';
 export type {
+  CameraOutputSnapshot,
   CubeCameraSnapshot,
   FrameCamera,
   FrameEnvironment,
@@ -338,24 +430,25 @@ export type {
   RenderProfile,
   RenderResult,
   RenderWorldLease,
-} from './render-contract';
-export { RENDER_PHASE_CATALOG } from './render-contract';
+} from './render-contract.js';
+export { RENDER_PHASE_CATALOG } from './render-contract.js';
 export type {
   TemporalInspectionInput,
   TemporalInspectionStatus,
-} from './renderer-inspect';
+} from './renderer-inspect.js';
+export type { RenderSceneBounds } from './scene/render-scene-types.js';
 export type {
   GpuFrameTiming,
   GpuFrameTimingProtocol,
   GpuFrameTimingRecord,
   GpuFrameTimingSample,
   GpuFrameTimingSummary,
-} from './scene/visibility/gpu-frame-timing';
+} from './scene/visibility/gpu-frame-timing.js';
 export {
   createGpuFrameTiming,
   recordGpuFrameTiming,
   summarizeGpuFrameTiming,
-} from './scene/visibility/gpu-frame-timing';
+} from './scene/visibility/gpu-frame-timing.js';
 export type {
   LodOcclusionDegradation,
   LodOcclusionFallback,
@@ -369,19 +462,19 @@ export type {
   LodOcclusionWorldAttribution,
   LodOcclusionWorldInspection,
   LodOcclusionWorldInspectionInput,
-} from './scene/visibility/inspection';
+} from './scene/visibility/inspection.js';
 export {
   consumeLodOcclusionInspection,
   inspectLodOcclusion,
   LOD_OCCLUSION_INSPECTION_MAX_BYTES,
   LOD_OCCLUSION_INSPECTION_SCHEMA,
   serializeLodOcclusionInspection,
-} from './scene/visibility/inspection';
+} from './scene/visibility/inspection.js';
 export {
   SHADOW_ATLAS_DEFAULT_FACE_SIZE,
   SHADOW_ATLAS_DEFAULT_LAYERS,
   ShadowAtlas,
-} from './shadow-atlas';
+} from './shadow-atlas.js';
 export type {
   SsrAdmissionBudget,
   SsrAdmissionFailure,
@@ -392,24 +485,50 @@ export type {
   SsrDependenciesInspection,
   SsrFormatReceipt,
   SsrReflectionFallbackReceipt,
+  SsrSpatialAdmission,
+  SsrSpatialCamera,
+  SsrSpatialCapabilities,
+  SsrSpatialEnvironment,
+  SsrSpatialLane,
+  SsrSpatialStatus,
+  SsrSpatialWork,
   SsrTemporalReceipt,
-} from './ssr/admission';
+} from './ssr/admission.js';
 export {
   admitSsrM0,
+  admitSsrSpatial,
   projectSsrDependencies,
   resolveSsrAdmissionGeneration,
   SSR_FORMAT_PROFILE,
   SSR_FORMAT_STAGES,
+  validateScreenSpaceReflection,
   zeroSsrAdmissionWork,
-} from './ssr/admission';
+} from './ssr/admission.js';
 export {
   composeSsrReflection,
   type SsrCompositionInput,
   type SsrCompositionInputError,
   type SsrCompositionResult,
   type SsrReflectionColor,
-} from './ssr/composition';
-export { getActiveCamera, setActiveCamera } from './systems/active-camera';
+} from './ssr/composition.js';
+export type {
+  SsrConfigField,
+  SsrConfigInvalidError,
+  SsrConfigRange,
+  SsrSpatialUnavailableReason,
+  SsrUnavailableError,
+} from './ssr/errors.js';
+export type {
+  SsrSpatialHistoryInspection,
+  SsrSpatialInspection,
+  SsrSpatialInspectionFailure,
+  SsrSpatialInspectionProjection,
+} from './ssr/inspection.js';
+export {
+  projectSsrSpatialInspection,
+  serializeSsrSpatialInspection,
+} from './ssr/inspection.js';
+export { getActiveCamera, setActiveCamera } from './systems/active-camera.js';
 export type {
   RenderTarget,
   RenderTargetAdmissionLimits,
@@ -425,8 +544,8 @@ export type {
   RenderTargetTextureAspect,
   RenderTargetTextureSource,
   RenderTargetTextureSourceOptions,
-} from './targets/contracts';
-export type { TemporalInspection, TemporalResourceInspection } from './temporal/inspection';
+} from './targets/contracts.js';
+export type { TemporalInspection, TemporalResourceInspection } from './temporal/inspection.js';
 export {
   SCENE_DATA_TEMPORAL_V1_DESCRIPTOR,
   SCENE_DATA_TEMPORAL_V1_SCHEMA,
@@ -434,15 +553,15 @@ export {
   type SceneDataSchemaId,
   type SceneDataTarget,
   type SceneDataTemporalV1Descriptor,
-} from './temporal/scene-data';
+} from './temporal/scene-data.js';
 export {
   createSceneDataCatalog,
   type SceneDataAvailability,
   type SceneDataCatalog,
   type SceneDataCatalogOptions,
   type SceneDataInspection,
-} from './temporal/scene-data-catalog';
-export type { TemporalView } from './temporal/view';
+} from './temporal/scene-data-catalog.js';
+export type { TemporalView } from './temporal/view.js';
 export {
   hasVolumetricFogCapability,
   type IntegratedVolumeResource,
@@ -453,7 +572,7 @@ export {
   type VolumetricFogLightKind,
   type VolumetricFogLightPairResolution,
   type VolumetricFogLightResolution,
-} from './volume/capability';
+} from './volume/capability.js';
 export {
   type ValidatedVolumetricFog,
   type VolumeBounds,
@@ -462,12 +581,12 @@ export {
   type VolumetricFogAuthoring,
   type VolumetricFogLightSelection,
   validateVolumetricFog,
-} from './volume/component';
-export { extractVolumetricFog, type VolumetricFogExtract } from './volume/extract';
+} from './volume/component.js';
+export { extractVolumetricFog, type VolumetricFogExtract } from './volume/extract.js';
 export {
   inspectVolumetricFog,
   type VolumetricFogInspection,
   type VolumetricFogInspectionInput,
   type VolumetricFogInspectionStatus,
   type VolumetricFogResourceStage,
-} from './volume/inspection';
+} from './volume/inspection.js';