@forgeax/engine-render 0.1.20 → 0.1.21

package/dist/{chunk-CDTWTHZR.mjs → chunk-FS2KNUQH.mjs}

@@ -1,8 +1,10 @@
-import { PointsLinesBudgetExceededError, VolumeOwnerConflictError, VolumeDensityShapeMismatchError, VolumeInvalidBoundsError, VolumeInvalidParametersError, PointsLinesStyleUnsupportedError, PointsLinesMaterialUnsupportedError, PointsLinesInvalidStyleError, PointsLinesTopologyMismatchError } from './chunk-TBQJOK2L.mjs';
+import { RenderIntentInvalidError, PointsLinesBudgetExceededError, VolumeOwnerConflictError, VolumeDensityShapeMismatchError, VolumeInvalidBoundsError, VolumeInvalidParametersError, PointsLinesStyleUnsupportedError, PointsLinesMaterialUnsupportedError, PointsLinesInvalidStyleError, PointsLinesTopologyMismatchError } from './chunk-6OPXDQ2E.mjs';
 import { defineComponent, Entity } from '@forgeax/engine-ecs';
 import { TONEMAP_SHADER_MODE } from '@forgeax/engine-shader';
 import { err, ok } from '@forgeax/engine-types';
+import { mat4 } from '@forgeax/engine-math';
 import { Transform, projectHierarchy } from '@forgeax/engine-scene';
+import { createWorldProjection } from '@forgeax/engine-ecs/projection';
 
 var Atmosphere = defineComponent("Atmosphere", {
   turbidity: { type: "f32", default: 2 },
@@ -106,6 +108,10 @@ var Camera = defineComponent("Camera", {
   bloomThreshold: { type: "f32", default: 1 },
   bloomIntensity: { type: "f32", default: 1 },
   bloomBlurRadius: { type: "f32", default: 4 },
+  // 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.
+  target: { type: "shared<RenderTarget>", simulationTransient: true },
   // feat-20260709 M3 / D-3: clear-color is one inline `array<f32,4>` column.
   // The earlier 4-scalar form (clearR/G/B/A) was chosen when this was believed
   // to be the only SoA-safe shape; the Transform (pos/quat/scale) and light
@@ -165,6 +171,75 @@ function orthographic(opts) {
     top: opts.top
   };
 }
+var CUBE_CAMERA_UPDATE_ONCE = 0;
+var CUBE_CAMERA_UPDATE_ON_DEMAND = 1;
+var CUBE_CAMERA_UPDATE_CONTINUOUS = 2;
+var CUBE_CAMERA_FACE_ORDER = ["+X", "-X", "+Y", "-Y", "+Z", "-Z"];
+function cubeCameraUpdateIntentFromF32(value) {
+  switch (value) {
+    case CUBE_CAMERA_UPDATE_ONCE:
+      return "once";
+    case CUBE_CAMERA_UPDATE_ON_DEMAND:
+      return "on-demand";
+    case CUBE_CAMERA_UPDATE_CONTINUOUS:
+      return "continuous";
+    default:
+      throw new RenderIntentInvalidError("CubeCamera", value);
+  }
+}
+function cubeCameraUpdateIntentToF32(intent) {
+  switch (intent) {
+    case "once":
+      return CUBE_CAMERA_UPDATE_ONCE;
+    case "on-demand":
+      return CUBE_CAMERA_UPDATE_ON_DEMAND;
+    case "continuous":
+      return CUBE_CAMERA_UPDATE_CONTINUOUS;
+  }
+}
+var CubeCamera = defineComponent("CubeCamera", {
+  target: { type: "shared<RenderTarget>", simulationTransient: true },
+  near: { type: "f32", default: 0.1 },
+  far: { type: "f32", default: 100 },
+  updateIntent: { type: "f32", default: CUBE_CAMERA_UPDATE_ONCE },
+  requestVersion: { type: "u32", default: 0 },
+  faceBudget: { type: "u32", default: 1 }
+});
+
+// src/components/directional-shadow-filter.ts
+var DirectionalShadowFilterValue = Object.freeze({
+  pcf1: 1,
+  pcf3: 2,
+  pcf5: 3,
+  pcssMedium: 4,
+  pcssHigh: 5
+});
+function directionalShadowQualityFromF32(value, angularRadiusRadians, maxPenumbraTexels) {
+  switch (value) {
+    case DirectionalShadowFilterValue.pcf1:
+      return { kind: "pcf", kernel: 1 };
+    case DirectionalShadowFilterValue.pcf3:
+      return { kind: "pcf", kernel: 3 };
+    case DirectionalShadowFilterValue.pcf5:
+      return { kind: "pcf", kernel: 5 };
+    case DirectionalShadowFilterValue.pcssMedium:
+      return {
+        kind: "pcss",
+        preset: "medium",
+        angularRadiusRadians,
+        maxPenumbraTexels
+      };
+    case DirectionalShadowFilterValue.pcssHigh:
+      return {
+        kind: "pcss",
+        preset: "high",
+        angularRadiusRadians,
+        maxPenumbraTexels
+      };
+    default:
+      return void 0;
+  }
+}
 var DirectionalLight = defineComponent("DirectionalLight", {
   // direction is the ONLY field with no default (D-5): omitting it lands the
   // array layer-3 all-zero [0,0,0], which the renderer owner rejects -- there is no
@@ -188,7 +263,13 @@ var DirectionalLight = defineComponent("DirectionalLight", {
   // reach. Default 200 world units (matches UE-style "dynamic shadow
   // distance"; the old farPlane default was 50).
   shadowDistance: { type: "f32", default: 200 },
-  pcfKernelSize: { type: "f32", default: 3 }
+  shadowFilter: {
+    type: "enum",
+    default: DirectionalShadowFilterValue.pcf3,
+    labels: DirectionalShadowFilterValue
+  },
+  shadowAngularRadius: { type: "f32", default: 465e-5 },
+  maxPenumbraTexels: { type: "f32", default: 32 }
 });
 var Fog = defineComponent("Fog", {
   color: { type: "array<f32, 3>", default: new Float32Array([0.5, 0.5, 0.5]) },
@@ -276,6 +357,39 @@ var schema = {
   data: "buffer"
 };
 var PostProcessParams = defineComponent("PostProcessParams", schema);
+var REFLECTION_PROBE_UPDATE_ONCE = 0;
+var REFLECTION_PROBE_UPDATE_ON_CHANGE = 1;
+var REFLECTION_PROBE_UPDATE_CONTINUOUS = 2;
+function reflectionProbeUpdateIntentFromF32(value) {
+  switch (value) {
+    case REFLECTION_PROBE_UPDATE_ONCE:
+      return "once";
+    case REFLECTION_PROBE_UPDATE_ON_CHANGE:
+      return "on-change";
+    case REFLECTION_PROBE_UPDATE_CONTINUOUS:
+      return "continuous";
+    default:
+      throw new RenderIntentInvalidError("ReflectionProbe", value);
+  }
+}
+function reflectionProbeUpdateIntentToF32(intent) {
+  switch (intent) {
+    case "once":
+      return REFLECTION_PROBE_UPDATE_ONCE;
+    case "on-change":
+      return REFLECTION_PROBE_UPDATE_ON_CHANGE;
+    case "continuous":
+      return REFLECTION_PROBE_UPDATE_CONTINUOUS;
+  }
+}
+var ReflectionProbe = defineComponent("ReflectionProbe", {
+  halfExtents: { type: "array<f32, 3>", default: new Float32Array([1, 1, 1]) },
+  priority: { type: "f32", default: 0 },
+  intensity: { type: "f32", default: 1 },
+  resolution: { type: "u32", default: 256 },
+  updateIntent: { type: "f32", default: REFLECTION_PROBE_UPDATE_ONCE },
+  invalidationVersion: { type: "u32", default: 0 }
+});
 var SceneInstance = defineComponent(
   "SceneInstance",
   {
@@ -542,6 +656,179 @@ function inspectVolumetricFog(input) {
     candidateSelectedLight: recovery?.candidateSelectedLight
   });
 }
+var FACE_ORIENTATION = [
+  { direction: [1, 0, 0], up: [0, 1, 0] },
+  { direction: [-1, 0, 0], up: [0, 1, 0] },
+  { direction: [0, 1, 0], up: [0, 0, -1] },
+  { direction: [0, -1, 0], up: [0, 0, 1] },
+  { direction: [0, 0, 1], up: [0, 1, 0] },
+  { direction: [0, 0, -1], up: [0, 1, 0] }
+];
+function assertRange(near, far) {
+  if (!Number.isFinite(near) || near <= 0 || !Number.isFinite(far) || far <= near) {
+    throw new RangeError("CubeCamera requires finite near > 0 and far > near.");
+  }
+}
+function buildCubeCameraFaceViews(input) {
+  assertRange(input.near, input.far);
+  const views = [];
+  for (const [index, face] of CUBE_CAMERA_FACE_ORDER.entries()) {
+    const orientation = FACE_ORIENTATION[index];
+    if (orientation === void 0)
+      throw new Error(`CubeCamera face orientation missing at ${index}`);
+    const target = [
+      (input.position[0] ?? 0) + orientation.direction[0],
+      (input.position[1] ?? 0) + orientation.direction[1],
+      (input.position[2] ?? 0) + orientation.direction[2]
+    ];
+    const view = mat4.lookAt(mat4.create(), input.position, target, orientation.up);
+    const projection = mat4.perspective(mat4.create(), Math.PI / 2, 1, input.near, input.far);
+    const viewProjection = mat4.multiply(mat4.create(), projection, view);
+    views.push({
+      position: input.position,
+      face,
+      direction: orientation.direction,
+      up: orientation.up,
+      near: input.near,
+      far: input.far,
+      view,
+      projection,
+      viewProjection
+    });
+  }
+  return views;
+}
+
+// src/mesh-material-bindings.ts
+var EMPTY_RESIDENCY = Object.freeze({
+  readiness: "pending",
+  samplers: Object.freeze([]),
+  textures: Object.freeze([])
+});
+function projectMeshMaterialBindingObservation(input) {
+  const residency = input.bindings.map((_, index) => {
+    const value = input.residency?.[index] ?? EMPTY_RESIDENCY;
+    return Object.freeze({
+      ...value,
+      samplers: Object.freeze(value.samplers.map((sampler) => Object.freeze({ ...sampler }))),
+      textures: Object.freeze(value.textures.map((texture) => Object.freeze({ ...texture }))),
+      ...value.preparationFailure === void 0 ? {} : {
+        preparationFailure: Object.freeze({
+          ...value.preparationFailure,
+          ...value.preparationFailure.detail === void 0 ? {} : { detail: Object.freeze({ ...value.preparationFailure.detail }) }
+        })
+      }
+    });
+  });
+  return {
+    worldId: input.worldId,
+    entityKey: input.entityKey,
+    bindings: Object.freeze([...input.bindings]),
+    diagnostics: Object.freeze([...input.diagnostics]),
+    residency: Object.freeze(residency)
+  };
+}
+function summarizeMeshMaterialBindings(observations) {
+  let ready = 0;
+  let pending = 0;
+  let failed = 0;
+  let lastKnownGood = 0;
+  let textureCount = 0;
+  let samplerCount = 0;
+  for (const observation of observations) {
+    for (const residency of observation.residency) {
+      switch (residency.readiness) {
+        case "ready":
+          ready += 1;
+          break;
+        case "pending":
+          pending += 1;
+          break;
+        case "failed":
+          failed += 1;
+          break;
+        case "last-known-good":
+          lastKnownGood += 1;
+          break;
+      }
+      textureCount += residency.textures.length;
+      samplerCount += residency.samplers.length;
+    }
+  }
+  return {
+    total: ready + pending + failed + lastKnownGood,
+    ready,
+    pending,
+    failed,
+    lastKnownGood,
+    textureCount,
+    samplerCount
+  };
+}
+function resolveMeshMaterialBindings(mesh, rendererOverrides, deps) {
+  const bindings = [];
+  const diagnostics = [];
+  if (!Array.isArray(mesh.materialSlots)) {
+    return { ok: false, code: "mesh-material-slots-missing" };
+  }
+  if (rendererOverrides.length > mesh.materialSlots.length) {
+    diagnostics.push({
+      code: "mesh-renderer-material-override-overflow",
+      slotIndex: mesh.materialSlots.length
+    });
+  }
+  for (let slotIndex = 0; slotIndex < mesh.materialSlots.length; slotIndex++) {
+    const override = rendererOverrides[slotIndex] ?? 0;
+    if (override !== 0 && deps.isValidOverride(override)) {
+      bindings.push({ handle: override, source: "renderer-override" });
+      continue;
+    }
+    if (override !== 0) {
+      diagnostics.push({
+        code: "mesh-renderer-material-override-invalid",
+        slotIndex,
+        handle: override
+      });
+    }
+    const declaredDefault = mesh.materialSlots[slotIndex]?.defaultMaterial;
+    if (declaredDefault !== void 0) {
+      const handle = deps.resolveMeshDefault(declaredDefault);
+      if (handle === void 0) {
+        return {
+          ok: false,
+          code: "mesh-default-material-not-ready",
+          slotIndex,
+          defaultMaterial: declaredDefault
+        };
+      }
+      bindings.push({ handle, source: "mesh-default" });
+      continue;
+    }
+    bindings.push({ handle: 0, source: "engine-default" });
+  }
+  return { ok: true, bindings, diagnostics };
+}
+
+// src/point-shadow-inspection.ts
+function inspectPointShadow(snapshots, shadowAtlasCapacity) {
+  const requested = snapshots.length;
+  const admitted = snapshots.reduce(
+    (count, snapshot) => snapshot.shadowAtlasLayer >= 0 && snapshot.shadowAtlasLayer < shadowAtlasCapacity ? count + 1 : count,
+    0
+  );
+  const status = requested === 0 ? "inactive" : requested > shadowAtlasCapacity || admitted !== requested ? "over-budget" : "ready";
+  return Object.freeze({
+    status,
+    requested,
+    admitted,
+    // A point shadow only samples an atlas after it owns an atlas layer. Keep
+    // these names explicit for AI diagnostics while deriving both from the
+    // one layer projection above.
+    shadowed: admitted,
+    shadowAtlasOccupancy: admitted,
+    shadowAtlasCapacity
+  });
+}
 function hasVolumetricFogCapability(caps, shaders) {
   return caps.compute && caps.storageTexture && shaders !== void 0;
 }
@@ -628,7 +915,260 @@ function resolveSelectedVolumetricLight(world, entity) {
 function resolveIntegratedVolumeConsumer(resource, consumer) {
   return { consumer, resource };
 }
+
+// src/reflection/filter.ts
+function createProbeFilterState(input) {
+  return {
+    probeIndex: input.probeIndex,
+    faceCount: input.faceCount ?? 6,
+    mipCount: input.mipCount,
+    cursor: 0,
+    activeGeneration: input.activeGeneration ?? 0
+  };
+}
+function advanceProbeFilter(state) {
+  const total = state.faceCount * state.mipCount;
+  if (state.cursor >= total) return void 0;
+  return {
+    probeIndex: state.probeIndex,
+    faceIndex: state.cursor % state.faceCount,
+    mipLevel: Math.floor(state.cursor / state.faceCount)
+  };
+}
+function commitProbeFilterStep(state, success) {
+  if (!success) return state;
+  const nextCursor = state.cursor + 1;
+  const complete = nextCursor >= state.faceCount * state.mipCount;
+  return {
+    ...state,
+    cursor: nextCursor,
+    activeGeneration: complete ? state.activeGeneration + 1 : state.activeGeneration
+  };
+}
+function probeFilterIsSteady(state) {
+  return state.cursor >= state.faceCount * state.mipCount;
+}
+function normalize(vector) {
+  const length = Math.hypot(vector[0], vector[1], vector[2]);
+  if (length === 0) return [0, 0, 1];
+  return [vector[0] / length, vector[1] / length, vector[2] / length];
+}
+function boxProjectReflectionDirection(direction, boxCenter, halfExtents, point) {
+  const ray = normalize(direction);
+  let distance = Number.POSITIVE_INFINITY;
+  for (let axis = 0; axis < 3; axis += 1) {
+    const component = ray[axis] ?? 0;
+    if (component === 0) continue;
+    const extent = halfExtents[axis] ?? 0;
+    const edge = component > 0 ? (boxCenter[axis] ?? 0) + extent : (boxCenter[axis] ?? 0) - extent;
+    const candidate = (edge - (point[axis] ?? 0)) / component;
+    if (candidate > 0) distance = Math.min(distance, candidate);
+  }
+  if (!Number.isFinite(distance)) return ray;
+  return normalize([
+    (point[0] ?? 0) + ray[0] * distance - (boxCenter[0] ?? 0),
+    (point[1] ?? 0) + ray[1] * distance - (boxCenter[1] ?? 0),
+    (point[2] ?? 0) + ray[2] * distance - (boxCenter[2] ?? 0)
+  ]);
+}
+
+// src/reflection/gpu-table.ts
+function buildReflectionProbeTable(rows) {
+  const ordered = rows.slice().sort((a, b) => a.index - b.index);
+  const indices = /* @__PURE__ */ new Map();
+  for (const row of ordered) {
+    if (row.primitiveKey !== void 0) indices.set(row.primitiveKey, row.index);
+  }
+  const indexFor = (primitiveKey2) => indices.get(primitiveKey2);
+  return {
+    rows: Object.freeze(ordered),
+    cpuIndexByPrimitive: indexFor,
+    gpuIndexByPrimitive: indexFor
+  };
+}
+function reflectionProbeTableBytes(table) {
+  return table.rows.length * 48;
+}
+
+// src/reflection/projection.ts
+var REFLECTION_PROBE_BYTES_PER_TEXEL = 8;
+var DEFAULT_REFLECTION_PROBE_LIMITS = Object.freeze({
+  maxProbes: 16,
+  maxResolution: 256,
+  maxBytes: 64 * 1024 * 1024
+});
+function validateReflectionProbeInput(input) {
+  for (let index = 0; index < input.halfExtents.length; index += 1) {
+    const value = input.halfExtents[index];
+    if (value === void 0 || !Number.isFinite(value) || value <= 0) {
+      return {
+        ok: false,
+        error: {
+          code: "reflection-probe-input-invalid",
+          field: `halfExtents[${index}]`,
+          value,
+          expected: "a finite number greater than zero"
+        }
+      };
+    }
+  }
+  if (!Number.isFinite(input.priority)) {
+    return {
+      ok: false,
+      error: {
+        code: "reflection-probe-input-invalid",
+        field: "priority",
+        value: input.priority,
+        expected: "a finite number"
+      }
+    };
+  }
+  if (!Number.isFinite(input.intensity) || input.intensity < 0) {
+    return {
+      ok: false,
+      error: {
+        code: "reflection-probe-input-invalid",
+        field: "intensity",
+        value: input.intensity,
+        expected: "a finite number greater than or equal to zero"
+      }
+    };
+  }
+  if (!Number.isInteger(input.resolution) || input.resolution <= 0) {
+    return {
+      ok: false,
+      error: {
+        code: "reflection-probe-input-invalid",
+        field: "resolution",
+        value: input.resolution,
+        expected: "a positive integer"
+      }
+    };
+  }
+  return { ok: true };
+}
+function estimateReflectionProbeBytes(resolution, limits = DEFAULT_REFLECTION_PROBE_LIMITS) {
+  const maxResolution = limits.maxResolution ?? DEFAULT_REFLECTION_PROBE_LIMITS.maxResolution;
+  const clamped = Math.min(resolution, maxResolution);
+  let mipTexels = 0;
+  for (let size = clamped; size >= 1; size = Math.floor(size / 2)) {
+    mipTexels += size * size;
+  }
+  return mipTexels * 6 * REFLECTION_PROBE_BYTES_PER_TEXEL;
+}
+function admitReflectionProbe(input, current, limits = DEFAULT_REFLECTION_PROBE_LIMITS) {
+  const maxProbes = limits.maxProbes ?? DEFAULT_REFLECTION_PROBE_LIMITS.maxProbes;
+  const maxBytes = limits.maxBytes ?? DEFAULT_REFLECTION_PROBE_LIMITS.maxBytes;
+  const maxResolution = limits.maxResolution ?? DEFAULT_REFLECTION_PROBE_LIMITS.maxResolution;
+  const requested = estimateReflectionProbeBytes(input.resolution, { maxResolution });
+  if (input.resolution > maxResolution || current.acceptedCount >= maxProbes || current.acceptedBytes + requested > maxBytes) {
+    return {
+      ok: false,
+      error: {
+        code: "reflection-probe-budget-exceeded",
+        requested,
+        activeCount: current.acceptedCount,
+        activeBytes: current.acceptedBytes,
+        maxProbes,
+        maxBytes
+      }
+    };
+  }
+  return { ok: true, acceptedBytes: current.acceptedBytes + requested };
+}
+function contains(fact, point) {
+  return fact.halfExtents.every((extent, axis) => {
+    const center = fact.center[axis] ?? 0;
+    const coordinate = point[axis] ?? 0;
+    return Math.abs(coordinate - center) <= extent;
+  });
+}
+function normalizedDistance(fact, point) {
+  let squared = 0;
+  for (let axis = 0; axis < 3; axis += 1) {
+    const delta = (point[axis] ?? 0) - (fact.center[axis] ?? 0);
+    const extent = fact.halfExtents[axis] ?? 1;
+    squared += (delta / extent) ** 2;
+  }
+  return squared;
+}
+function isBetter(candidate, current, facts) {
+  const candidateFact = facts.find(
+    (fact) => fact.worldId === candidate.worldId && fact.entityKey === candidate.entityKey
+  );
+  const currentFact = facts.find(
+    (fact) => fact.worldId === current.worldId && fact.entityKey === current.entityKey
+  );
+  if (candidateFact === void 0 || currentFact === void 0) return false;
+  if (candidateFact.priority !== currentFact.priority)
+    return candidateFact.priority > currentFact.priority;
+  if (candidate.normalizedDistance !== current.normalizedDistance) {
+    return candidate.normalizedDistance < current.normalizedDistance;
+  }
+  return candidate.worldId < current.worldId || candidate.worldId === current.worldId && candidate.entityKey < current.entityKey;
+}
+function selectReflectionProbe(facts, primitiveCenter) {
+  let selected;
+  for (const fact of facts) {
+    if (!contains(fact, primitiveCenter)) continue;
+    const candidate = {
+      kind: "probe",
+      worldId: fact.worldId,
+      entityKey: fact.entityKey,
+      normalizedDistance: normalizedDistance(fact, primitiveCenter)
+    };
+    if (selected === void 0 || isBetter(candidate, selected, facts)) selected = candidate;
+  }
+  return selected ?? { kind: "skylight" };
+}
+function primitiveKey(worldId, entityKey) {
+  return `${worldId}:${entityKey}`;
+}
+var ReflectionProbeProjection = class {
+  revision = 0;
+  facts = [];
+  selected = /* @__PURE__ */ new Map();
+  signature = "";
+  scannedPrimitives = 0;
+  update(facts, primitives) {
+    const nextFacts = facts.slice().sort((a, b) => a.worldId - b.worldId || a.entityKey - b.entityKey);
+    const signature = JSON.stringify({ facts: nextFacts, primitives });
+    if (signature === this.signature) return this.snapshot();
+    this.signature = signature;
+    this.facts = nextFacts;
+    this.selected = /* @__PURE__ */ new Map();
+    for (const primitive of primitives) {
+      this.selected.set(
+        primitiveKey(primitive.worldId, primitive.entityKey),
+        selectReflectionProbe(nextFacts, primitive.center)
+      );
+    }
+    this.scannedPrimitives = primitives.length;
+    this.revision += 1;
+    return this.snapshot();
+  }
+  snapshot() {
+    return {
+      revision: this.revision,
+      facts: this.facts,
+      selected: this.selected,
+      scannedPrimitives: this.scannedPrimitives
+    };
+  }
+  selection(worldId, entityKey) {
+    return this.selected.get(primitiveKey(worldId, entityKey)) ?? { kind: "skylight" };
+  }
+};
+var VISIBILITY_CACHE = /* @__PURE__ */ new WeakMap();
 function resolveVisibility(world, hierarchy = projectHierarchy(world)) {
+  const cached = VISIBILITY_CACHE.get(world);
+  const changes = cached?.changes ?? createWorldProjection(world, { components: [Visibility] });
+  if (cached !== void 0) {
+    const evidence = changes.poll();
+    if (evidence.status === "delta" && evidence.changes.length === 0 && cached.hierarchy === hierarchy) {
+      return cached.snapshot;
+    }
+  }
   const query = world.query({ read: [Visibility] });
   const visitVisibilityRows = (visit) => {
     if (!query.ok) return;
@@ -689,7 +1229,7 @@ function resolveVisibility(world, hierarchy = projectHierarchy(world)) {
       return result;
     };
   };
-  return {
+  const snapshot = {
     diagnostics: hierarchy.diagnostics,
     hasAnyIntent: intentCount > 0,
     hasAnyHiddenIntent,
@@ -702,6 +1242,8 @@ function resolveVisibility(world, hierarchy = projectHierarchy(world)) {
       return resolveEntity?.(entity)?.effective ?? "visible";
     }
   };
+  VISIBILITY_CACHE.set(world, { changes, hierarchy, snapshot });
+  return snapshot;
 }
 var VolumetricFog = defineComponent("VolumetricFog", {
   light: { type: "entity" },
@@ -747,6 +1289,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_PROJECTION_ORTHOGRAPHIC, CAMERA_PROJECTION_PERSPECTIVE, Camera, DirectionalLight, Fog, Instances, Layer, Lines, MeshFilter, MeshRenderer, MotionBlur, PointLight, PointLightShadow, PointShapeValue, Points, PostProcessParams, SKYBOX_MODE_CUBEMAP, SceneInstance, 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, admitPointsLines, antialiasFromF32, bloomEnabledFromF32, cameraProjectionFromF32, extractVolumetricFog, hasVolumetricFogCapability, inspectVolumetricFog, orthographic, perspective, pointShapeFromU32, resolveIntegratedVolumeConsumer, resolveSelectedVolumetricLight, resolveVisibility, resolveVolumetricFogLightPair, tonemapFromF32, tonemapToU32, validateVolumetricFog, visibilityStateFromU32 };
-//# sourceMappingURL=chunk-CDTWTHZR.mjs.map
-//# sourceMappingURL=chunk-CDTWTHZR.mjs.map
+export { ANTIALIAS_FXAA, ANTIALIAS_MSAA, ANTIALIAS_NONE, ANTIALIAS_TAA, Atmosphere, BLOOM_DISABLED, BLOOM_ENABLED, CAMERA_PROJECTION_ORTHOGRAPHIC, CAMERA_PROJECTION_PERSPECTIVE, CUBE_CAMERA_FACE_ORDER, CUBE_CAMERA_UPDATE_CONTINUOUS, CUBE_CAMERA_UPDATE_ONCE, CUBE_CAMERA_UPDATE_ON_DEMAND, Camera, CubeCamera, DEFAULT_REFLECTION_PROBE_LIMITS, DirectionalLight, DirectionalShadowFilterValue, Fog, Instances, Layer, Lines, MeshFilter, MeshRenderer, MotionBlur, PointLight, PointLightShadow, PointShapeValue, Points, PostProcessParams, REFLECTION_PROBE_UPDATE_CONTINUOUS, REFLECTION_PROBE_UPDATE_ONCE, REFLECTION_PROBE_UPDATE_ON_CHANGE, ReflectionProbe, ReflectionProbeProjection, SKYBOX_MODE_CUBEMAP, SceneInstance, 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, admitPointsLines, admitReflectionProbe, advanceProbeFilter, antialiasFromF32, bloomEnabledFromF32, boxProjectReflectionDirection, buildCubeCameraFaceViews, buildReflectionProbeTable, cameraProjectionFromF32, commitProbeFilterStep, createProbeFilterState, cubeCameraUpdateIntentFromF32, cubeCameraUpdateIntentToF32, directionalShadowQualityFromF32, estimateReflectionProbeBytes, extractVolumetricFog, hasVolumetricFogCapability, inspectPointShadow, inspectVolumetricFog, orthographic, perspective, pointShapeFromU32, probeFilterIsSteady, projectMeshMaterialBindingObservation, reflectionProbeTableBytes, reflectionProbeUpdateIntentFromF32, reflectionProbeUpdateIntentToF32, resolveIntegratedVolumeConsumer, resolveMeshMaterialBindings, resolveSelectedVolumetricLight, resolveVisibility, resolveVolumetricFogLightPair, selectReflectionProbe, summarizeMeshMaterialBindings, tonemapFromF32, tonemapToU32, validateReflectionProbeInput, validateVolumetricFog, visibilityStateFromU32 };
+//# sourceMappingURL=chunk-FS2KNUQH.mjs.map
+//# sourceMappingURL=chunk-FS2KNUQH.mjs.map