@forgeax/engine-render 0.1.32 → 0.1.33

package/dist/{chunk-GWCEMDVR.mjs → chunk-PLAXOOX5.mjs}

@@ -1,4 +1,4 @@
-import { RenderIntentInvalidError, DynamicResolutionRequiresTaaError, ShadowInvalidConfigError, VolumeOwnerConflictError, VolumeDensityShapeMismatchError, VolumeInvalidBoundsError, VolumeInvalidParametersError, DynamicResolutionInvalidParameterError } from './chunk-6TFBXLRJ.mjs';
+import { RenderIntentInvalidError, DynamicResolutionRequiresTaaError, ShadowInvalidConfigError, EnvironmentSourceConflictError, FogCardinalityError, VolumeOwnerConflictError, VolumeDensityShapeMismatchError, VolumeInvalidBoundsError, VolumeInvalidParametersError, DynamicResolutionInvalidParameterError, AtmosphereInvalidParameterError } from './chunk-NB2S7ZRX.mjs';
 import { defineComponent, Entity } from '@forgeax/engine-ecs';
 import { TONEMAP_SHADER_MODE } from '@forgeax/engine-shader';
 import { R_MIN, err, ok } from '@forgeax/engine-types';
@@ -11,7 +11,11 @@ var Atmosphere = defineComponent("Atmosphere", {
   rayleigh: { type: "f32", default: 1 },
   mieCoefficient: { type: "f32", default: 5e-3 },
   mieDirectionalG: { type: "f32", default: 0.8 },
-  sunAngularRadius: { type: "f32", default: 4675e-6 }
+  sunAngularRadius: { type: "f32", default: 4675e-6 },
+  /** Independent multiplier for the analytic circumsolar lobe. */
+  circumsolarStrength: { type: "f32", default: 1 },
+  /** Relative angular width of the analytic circumsolar lobe. */
+  circumsolarWidth: { type: "f32", default: 1 }
 });
 var CAMERA_PROJECTION_PERSPECTIVE = 0;
 var CAMERA_PROJECTION_ORTHOGRAPHIC = 1;
@@ -199,6 +203,14 @@ function antialiasFromF32(value) {
 }
 var BLOOM_DISABLED = 0;
 var BLOOM_ENABLED = 1;
+var CAMERA_BLOOM_INTENSITY_MIN = 0;
+var CAMERA_BLOOM_INTENSITY_MAX = 8;
+var CAMERA_BLOOM_THRESHOLD_MIN = 0;
+var CAMERA_BLOOM_THRESHOLD_MAX = 65504;
+var CAMERA_BLOOM_SOFT_KNEE_MIN = 0;
+var CAMERA_BLOOM_SOFT_KNEE_MAX = 1;
+var CAMERA_BLOOM_SCATTER_MIN = 0;
+var CAMERA_BLOOM_SCATTER_MAX = 0.95;
 function bloomEnabledFromF32(value) {
   if (value === BLOOM_DISABLED) return "off";
   if (value === BLOOM_ENABLED) return "on";
@@ -210,6 +222,40 @@ function bloomEnabledFromF32(value) {
     "select Camera bloom off or on"
   );
 }
+function validateBloomRange(field, value, min, max) {
+  if (!Number.isFinite(value) || value < min || value > max) {
+    throw cameraError(
+      "camera-bloom-invalid",
+      field,
+      value,
+      `a finite value in [${min}, ${max}]`,
+      `set Camera.${field} to a finite value in [${min}, ${max}]`
+    );
+  }
+}
+function validateCameraBloom(bloom, threshold, intensity, softKnee, scatter) {
+  const enabled = bloomEnabledFromF32(bloom);
+  validateBloomRange(
+    "bloomThreshold",
+    threshold,
+    CAMERA_BLOOM_THRESHOLD_MIN,
+    CAMERA_BLOOM_THRESHOLD_MAX
+  );
+  validateBloomRange(
+    "bloomIntensity",
+    intensity,
+    CAMERA_BLOOM_INTENSITY_MIN,
+    CAMERA_BLOOM_INTENSITY_MAX
+  );
+  validateBloomRange(
+    "bloomSoftKnee",
+    softKnee,
+    CAMERA_BLOOM_SOFT_KNEE_MIN,
+    CAMERA_BLOOM_SOFT_KNEE_MAX
+  );
+  validateBloomRange("bloomScatter", scatter, CAMERA_BLOOM_SCATTER_MIN, CAMERA_BLOOM_SCATTER_MAX);
+  return enabled;
+}
 var Camera = defineComponent("Camera", {
   fov: { type: "f32" },
   aspect: { type: "f32" },
@@ -236,7 +282,8 @@ var Camera = defineComponent("Camera", {
   bloom: { type: "f32", default: 0 },
   bloomThreshold: { type: "f32", default: 1 },
   bloomIntensity: { type: "f32", default: 1 },
-  bloomBlurRadius: { type: "f32", default: 4 },
+  bloomSoftKnee: { type: "f32", default: 0.5 },
+  bloomScatter: { type: "f32", default: 0.7 },
   // M1 target camera role: zero means this camera is eligible for display;
   // non-zero shared targets are auxiliary producers whose views and receipt
   // promotion remain owned by Renderer.
@@ -777,7 +824,8 @@ var MeshRenderer = defineComponent("MeshRenderer", {
 var MotionBlur = defineComponent("MotionBlur", {
   shutterAngle: { type: "f32", default: 180 },
   maxRadiusPixels: { type: "f32", default: 32 },
-  sampleCount: { type: "f32", default: 8 }
+  sampleCount: { type: "f32", default: 8 },
+  targetFps: { type: "f32", default: 60 }
 });
 var PointLight = defineComponent("PointLight", {
   // color carries an explicit layer-2 default [1,1,1] (white); the array
@@ -973,6 +1021,183 @@ var Visibility = defineComponent(
     }
   }
 );
+
+// src/environment/signature.ts
+function sorted(items) {
+  return [...items].sort((left, right) => left.entityKey - right.entityKey);
+}
+function environmentSignature(input) {
+  return JSON.stringify({
+    environments: sorted(input.environments),
+    fogs: sorted(input.fogs),
+    suns: sorted(input.suns)
+  });
+}
+function environmentOnlySignature(input) {
+  return JSON.stringify({
+    environments: sorted(input.environments),
+    suns: sorted(input.suns)
+  });
+}
+function fogOnlySignature(input) {
+  return JSON.stringify({ fogs: sorted(input.fogs) });
+}
+function environmentFactSignatures(input) {
+  return {
+    environmentSignature: environmentOnlySignature(input),
+    fogSignature: fogOnlySignature(input),
+    signature: environmentSignature(input)
+  };
+}
+
+// src/extract/environment.ts
+var ATMOSPHERE_PARAMETER_RANGES = Object.freeze({
+  turbidity: Object.freeze({ min: 1, max: 20 }),
+  rayleigh: Object.freeze({ min: 0, max: Number.POSITIVE_INFINITY }),
+  mieCoefficient: Object.freeze({ min: 0, max: Number.POSITIVE_INFINITY }),
+  mieDirectionalG: Object.freeze({ min: 0, max: 0.999 }),
+  sunAngularRadius: Object.freeze({ min: 0, max: Number.POSITIVE_INFINITY }),
+  circumsolarStrength: Object.freeze({ min: 0, max: 4 }),
+  circumsolarWidth: Object.freeze({ min: 0.25, max: 4 })
+});
+function validateFogParameters(candidate) {
+  if (candidate.color.length !== 3) {
+    return {
+      field: "color",
+      value: candidate.color.length,
+      expected: "exactly three finite channels in [0, 1]"
+    };
+  }
+  for (let index = 0; index < candidate.color.length; index += 1) {
+    const value = candidate.color[index];
+    if (value === void 0 || !Number.isFinite(value) || value < 0 || value > 1) {
+      return {
+        field: `color[${index}]`,
+        value: value ?? Number.NaN,
+        expected: "a finite number in [0, 1]"
+      };
+    }
+  }
+  if (!Number.isFinite(candidate.density) || candidate.density < 0) {
+    return { field: "density", value: candidate.density, expected: "a finite number >= 0" };
+  }
+  if (!Number.isFinite(candidate.heightFalloff) || candidate.heightFalloff < 0) {
+    return {
+      field: "heightFalloff",
+      value: candidate.heightFalloff,
+      expected: "a finite number >= 0"
+    };
+  }
+  if (!Number.isFinite(candidate.maxOpacity) || candidate.maxOpacity < 0 || candidate.maxOpacity > 1) {
+    return {
+      field: "maxOpacity",
+      value: candidate.maxOpacity,
+      expected: "a finite number in [0, 1]"
+    };
+  }
+  return void 0;
+}
+function validateAtmosphereParameters(parameters) {
+  for (const field of Object.keys(ATMOSPHERE_PARAMETER_RANGES)) {
+    const value = parameters[field];
+    const range = ATMOSPHERE_PARAMETER_RANGES[field];
+    if (!Number.isFinite(value) || value < range.min || value > range.max) {
+      return new AtmosphereInvalidParameterError(field, value, range);
+    }
+  }
+  return void 0;
+}
+
+// src/environment/frame.ts
+var SKYLIGHT_RECOVERY_FALLBACK = Object.freeze({
+  kind: "skylight",
+  active: false
+});
+var EnvironmentSelectionParameterError = class extends Error {
+  code = "environment-selection-invalid";
+  expected;
+  hint;
+  detail;
+  constructor(field, value, expected) {
+    super(`environment selection field ${field} is invalid`);
+    this.name = "EnvironmentSelectionParameterError";
+    this.expected = expected;
+    this.hint = `set ${field} to a finite value satisfying ${expected}`;
+    this.detail = { field, value };
+  }
+};
+var SunCardinalityError = class extends Error {
+  code = "sun-cardinality";
+  expected = "atmosphere has exactly one sun owner";
+  hint = "add exactly one DirectionalLight sun for the atmosphere owner";
+  detail;
+  constructor(value) {
+    super(`atmosphere sun cardinality is ${value}`);
+    this.name = "SunCardinalityError";
+    this.detail = { field: "sun", value };
+  }
+};
+function freezeCandidate(candidate) {
+  return Object.freeze(candidate);
+}
+function freezeFog(candidate) {
+  return Object.freeze({
+    ...candidate,
+    color: Object.freeze([...candidate.color])
+  });
+}
+function selectEnvironment(input) {
+  if (input.environments.length > 1) {
+    return err(
+      new EnvironmentSourceConflictError(
+        [...input.environments].sort((left, right) => left.entityKey - right.entityKey).map(({ kind, entityKey, sourceKey }) => ({ kind, entityKey, sourceKey }))
+      )
+    );
+  }
+  if (input.fogs.length > 1) return err(new FogCardinalityError(input.fogs.length));
+  const selectedFog = input.fogs[0];
+  if (selectedFog !== void 0) {
+    const issue = validateFogParameters(selectedFog);
+    if (issue !== void 0) {
+      return err(new EnvironmentSelectionParameterError(issue.field, issue.value, issue.expected));
+    }
+  }
+  const selected = input.environments[0];
+  if (selected?.kind === "atmosphere") {
+    const invalid3 = validateAtmosphereParameters(selected.atmosphere);
+    if (invalid3 !== void 0) return err(invalid3);
+  }
+  if (selected?.kind === "atmosphere" && input.suns.length !== 1) {
+    return err(new SunCardinalityError(input.suns.length));
+  }
+  const source = selected === void 0 ? { kind: "none" } : selected.kind === "atmosphere" ? {
+    kind: "atmosphere",
+    entityKey: selected.entityKey,
+    sourceKey: selected.sourceKey,
+    atmosphere: Object.freeze({ ...selected.atmosphere })
+  } : {
+    kind: "image",
+    entityKey: selected.entityKey,
+    sourceKey: selected.sourceKey
+  };
+  const sun = input.suns[0] === void 0 ? void 0 : freezeCandidate({ ...input.suns[0] });
+  const fog = selectedFog === void 0 ? void 0 : freezeFog(selectedFog);
+  const signatureInput = {
+    environments: selected === void 0 ? [] : [selected],
+    fogs: selectedFog === void 0 ? [] : [selectedFog],
+    suns: input.suns
+  };
+  const signatures = environmentFactSignatures(signatureInput);
+  const result = {
+    source: Object.freeze(source),
+    fog,
+    ...signatures,
+    revision: 0,
+    sun
+  };
+  Object.defineProperty(result, "lane", { value: input.lane, enumerable: false });
+  return ok(Object.freeze(result));
+}
 var DEPTH_OF_FIELD_PARAMS_BYTE_SIZE = 64;
 var MIN_F_STOP = Math.fround(0.7);
 var MAX_F_STOP = Math.fround(32);
@@ -1677,6 +1902,6 @@ function extractVolumetricFog(inputs) {
   return ok({ status: "available", fog: validated.value });
 }
 
-export { ANTIALIAS_FXAA, ANTIALIAS_MSAA, ANTIALIAS_NONE, ANTIALIAS_TAA, Atmosphere, 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, CUBE_CAMERA_FACE_ORDER, CUBE_CAMERA_UPDATE_CONTINUOUS, CUBE_CAMERA_UPDATE_ONCE, CUBE_CAMERA_UPDATE_ON_DEMAND, Camera, CameraError, CubeCamera, DEFAULT_DEPTH_OF_FIELD_PARAMS, DEPTH_OF_FIELD_PARAMS_BYTE_SIZE, DepthOfField, DepthOfFieldQualityValue, DepthOfFieldSideValue, DepthOfFieldValidationError, DirectionalLight, DirectionalShadowFilterValue, DynamicResolution, Fog, Instances, Layer, LightProbe, Lines, MeshFilter, MeshRenderer, MotionBlur, PointLight, PointLightShadow, PointShapeValue, Points, PostProcessParams, REFLECTION_PROBE_UPDATE_CONTINUOUS, REFLECTION_PROBE_UPDATE_ONCE, REFLECTION_PROBE_UPDATE_ON_CHANGE, RectAreaLight, ReflectionProbe, SKYBOX_MODE_CUBEMAP, SceneInstance, ScreenSpaceReflection, SkyboxBackground, Skylight, SortKey, SpotLight, TONEMAP_ACES_FILMIC, TONEMAP_AGX, TONEMAP_CINEON, TONEMAP_LINEAR, TONEMAP_NEUTRAL, TONEMAP_NONE, TONEMAP_REINHARD, TONEMAP_REINHARD_EXTENDED, Visibility, VisibilityStateValue, VolumetricFog, antialiasFromF32, bloomEnabledFromF32, buildCubeCameraFaceViews, cameraExposureFromColumns, cameraProjectionFromF32, computeInvRangeSquared, cubeCameraUpdateIntentFromF32, cubeCameraUpdateIntentToF32, degToCos, depthOfFieldQualityCode, depthOfFieldQualityFromF32, depthOfFieldRequestFailure, depthOfFieldSideCode, depthOfFieldSideFromF32, depthOfFieldTapCount, directionalShadowQualityFromF32, extractVolumetricFog, hasVolumetricFogCapability, orthographic, packDepthOfFieldParams, perspective, pointShapeFromU32, projectMeshMaterialBindingObservation, reflectionProbeUpdateIntentFromF32, reflectionProbeUpdateIntentToF32, resolveDepthOfFieldFrameParams, resolveDepthOfFieldParams, resolveIntegratedVolumeConsumer, resolveMeshMaterialBindings, resolveSelectedVolumetricLight, resolveVisibility, resolveVolumetricFogLightPair, signedDepthOfFieldCoC, summarizeMeshMaterialBindings, tonemapFromF32, tonemapToU32, validateCameraColorGrading, validateCameraExposure, validateDepthOfFieldFrameParams, validateDepthOfFieldParams, validateDirection, validateDirectionalLightData, validateDynamicResolutionCamera, validateDynamicResolutionParameters, validateLightProbeData, validatePointLightData, validatePointLightShadowData, validateRectAreaLightData, validateSpotLightData, validateVolumetricFog, visibilityStateFromU32 };
-//# sourceMappingURL=chunk-GWCEMDVR.mjs.map
-//# sourceMappingURL=chunk-GWCEMDVR.mjs.map
+export { ANTIALIAS_FXAA, ANTIALIAS_MSAA, ANTIALIAS_NONE, ANTIALIAS_TAA, Atmosphere, 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, CAMERA_PROJECTION_PERSPECTIVE, CAMERA_TEMPERATURE_MAX, CAMERA_TEMPERATURE_MIN, CAMERA_TINT_MAX, CAMERA_TINT_MIN, CUBE_CAMERA_FACE_ORDER, CUBE_CAMERA_UPDATE_CONTINUOUS, CUBE_CAMERA_UPDATE_ONCE, CUBE_CAMERA_UPDATE_ON_DEMAND, Camera, CameraError, CubeCamera, DEFAULT_DEPTH_OF_FIELD_PARAMS, DEPTH_OF_FIELD_PARAMS_BYTE_SIZE, DepthOfField, DepthOfFieldQualityValue, DepthOfFieldSideValue, DepthOfFieldValidationError, DirectionalLight, DirectionalShadowFilterValue, DynamicResolution, Fog, Instances, Layer, LightProbe, Lines, MeshFilter, MeshRenderer, MotionBlur, PointLight, PointLightShadow, PointShapeValue, Points, PostProcessParams, REFLECTION_PROBE_UPDATE_CONTINUOUS, REFLECTION_PROBE_UPDATE_ONCE, REFLECTION_PROBE_UPDATE_ON_CHANGE, RectAreaLight, ReflectionProbe, SKYBOX_MODE_CUBEMAP, SKYLIGHT_RECOVERY_FALLBACK, SceneInstance, ScreenSpaceReflection, SkyboxBackground, Skylight, SortKey, SpotLight, SunCardinalityError, TONEMAP_ACES_FILMIC, TONEMAP_AGX, TONEMAP_CINEON, TONEMAP_LINEAR, TONEMAP_NEUTRAL, TONEMAP_NONE, TONEMAP_REINHARD, TONEMAP_REINHARD_EXTENDED, Visibility, VisibilityStateValue, VolumetricFog, antialiasFromF32, buildCubeCameraFaceViews, cameraExposureFromColumns, cameraProjectionFromF32, computeInvRangeSquared, cubeCameraUpdateIntentFromF32, cubeCameraUpdateIntentToF32, degToCos, depthOfFieldQualityCode, depthOfFieldQualityFromF32, depthOfFieldRequestFailure, depthOfFieldSideCode, depthOfFieldSideFromF32, depthOfFieldTapCount, directionalShadowQualityFromF32, extractVolumetricFog, hasVolumetricFogCapability, orthographic, packDepthOfFieldParams, perspective, pointShapeFromU32, projectMeshMaterialBindingObservation, reflectionProbeUpdateIntentFromF32, reflectionProbeUpdateIntentToF32, resolveDepthOfFieldFrameParams, resolveDepthOfFieldParams, resolveIntegratedVolumeConsumer, resolveMeshMaterialBindings, resolveSelectedVolumetricLight, resolveVisibility, resolveVolumetricFogLightPair, selectEnvironment, signedDepthOfFieldCoC, summarizeMeshMaterialBindings, tonemapFromF32, tonemapToU32, validateCameraBloom, validateCameraColorGrading, validateCameraExposure, validateDepthOfFieldFrameParams, validateDepthOfFieldParams, validateDirection, validateDirectionalLightData, validateDynamicResolutionCamera, validateDynamicResolutionParameters, validateLightProbeData, validatePointLightData, validatePointLightShadowData, validateRectAreaLightData, validateSpotLightData, validateVolumetricFog, visibilityStateFromU32 };
+//# sourceMappingURL=chunk-PLAXOOX5.mjs.map
+//# sourceMappingURL=chunk-PLAXOOX5.mjs.map