@threenative/core 0.3.10 → 0.3.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (158) hide show
  1. package/capabilities.json +1096 -26
  2. package/dist/camera-shake-CZKOfGn4.d.ts +46 -0
  3. package/dist/{canvas-layer-vCtanIeB.d.ts → canvas-layer-CWuFRT7G.d.ts} +1 -1
  4. package/dist/chunk-2Z44XSI2.js +35 -0
  5. package/dist/chunk-5O73CDMR.js +1849 -0
  6. package/dist/chunk-6KLNISRJ.js +153 -0
  7. package/dist/chunk-7UUT3TY5.js +133 -0
  8. package/dist/chunk-CFGTPFUH.js +231 -0
  9. package/dist/chunk-DBELTTTM.js +615 -0
  10. package/dist/chunk-GMHATRPW.js +7701 -0
  11. package/dist/chunk-GXY7B3JG.js +46 -0
  12. package/dist/chunk-KIRUKTBQ.js +187 -0
  13. package/dist/chunk-N5LRP4BR.js +220 -0
  14. package/dist/chunk-OKXUCASC.js +2238 -0
  15. package/dist/chunk-QWJEMUUT.js +94 -0
  16. package/dist/chunk-VAZM36TV.js +497 -0
  17. package/dist/{game-DzMcitDO.d.ts → game-D7pAzZUY.d.ts} +15 -3
  18. package/dist/hot.d.ts +3 -3
  19. package/dist/hot.js +2 -46
  20. package/dist/index.d.ts +329 -302
  21. package/dist/index.js +10565 -22533
  22. package/dist/{model-lod-CTpZ6imz.d.ts → model-lod-B6BMqS1r.d.ts} +33 -3
  23. package/dist/playtest.d.ts +3 -3
  24. package/dist/playtest.js +24 -75
  25. package/dist/react-css.js +1 -215
  26. package/dist/react.d.ts +2 -2
  27. package/dist/{renderer-rZm0hVqq.d.ts → renderer-DvFVoAgj.d.ts} +13 -4
  28. package/dist/spells/index.d.ts +643 -0
  29. package/dist/spells/index.js +1558 -0
  30. package/dist/spells/ultra/index.d.ts +1600 -0
  31. package/dist/spells/ultra/index.js +6804 -0
  32. package/dist/terrain-jobs-worker.js +1 -123
  33. package/dist/two-sided-foliage-W523J3UM.js +1 -0
  34. package/dist/ui-layer.js +5 -384
  35. package/dist/worker.js +4 -41
  36. package/dist/world.d.ts +725 -259
  37. package/dist/world.js +16714 -18284
  38. package/mcp/animation-server.mjs +1 -1
  39. package/mcp/animation.mjs +2 -3
  40. package/mcp/engine-server.mjs +142 -47
  41. package/mcp/servers.mjs +9 -2
  42. package/mcp/terrain.mjs +8 -0
  43. package/package.json +14 -6
  44. package/patches/three@0.187.0-prd269-upgrade.patch +2102 -0
  45. package/patches/three@0.187.0.patch +2004 -407
  46. package/src/assets.ts +9 -2
  47. package/src/card-lod.ts +152 -0
  48. package/src/compressed-texture-preparation.ts +1008 -0
  49. package/src/frame-budget.ts +31 -20
  50. package/src/game-dev-tools.ts +93 -0
  51. package/src/game-frame-loop.ts +995 -0
  52. package/src/game-renderer-metrics.ts +77 -0
  53. package/src/game-startup.ts +1001 -0
  54. package/src/game-validate.ts +70 -0
  55. package/src/game.ts +253 -1935
  56. package/src/index.ts +27 -2
  57. package/src/launch-diagnostics.ts +22 -12
  58. package/src/look/ao-admission.ts +24 -0
  59. package/src/look/filmic-tone-mapping.ts +15 -13
  60. package/src/look/look-diagnostics.ts +3 -3
  61. package/src/look/quality.ts +10 -5
  62. package/src/look/world-environment.ts +76 -9
  63. package/src/loop.ts +29 -0
  64. package/src/model-lod.ts +42 -3
  65. package/src/particle-kinds.ts +515 -0
  66. package/src/picking.ts +17 -3
  67. package/src/playtest.ts +27 -1
  68. package/src/projection-apply.ts +4 -1
  69. package/src/projection-plan.ts +9 -6
  70. package/src/render/mesh-pool.ts +1 -1
  71. package/src/render/resolution-subrect.ts +2 -0
  72. package/src/render/rough-diffuse.ts +46 -12
  73. package/src/render/soft-shadow.ts +27 -12
  74. package/src/render/virtual-shadow-adaptive.ts +55 -0
  75. package/src/render/virtual-shadow-casters.ts +175 -0
  76. package/src/render/virtual-shadow-layers.ts +76 -0
  77. package/src/render/virtual-shadow-level.ts +224 -0
  78. package/src/render/virtual-shadow-markers.ts +193 -0
  79. package/src/render/virtual-shadow-options.ts +370 -0
  80. package/src/render/virtual-shadow-pages.ts +5 -0
  81. package/src/render/virtual-shadow.ts +213 -992
  82. package/src/render/world-impostor-surface.ts +293 -34
  83. package/src/render-camera-cull.ts +32 -1
  84. package/src/render-pass-budget.ts +34 -7
  85. package/src/renderProjection.ts +22 -0
  86. package/src/renderer.ts +92 -37
  87. package/src/snow-field.ts +1 -1
  88. package/src/spells/cast-pool.ts +361 -0
  89. package/src/spells/index.ts +177 -0
  90. package/src/spells/mechanisms.ts +295 -0
  91. package/src/spells/reaction-field.ts +415 -0
  92. package/src/spells/spell-lights.ts +139 -0
  93. package/src/spells/spell-world.ts +187 -0
  94. package/src/spells/spell.ts +397 -0
  95. package/src/spells/spells.ts +283 -0
  96. package/src/spells/ultra/engine/camera.ts +184 -0
  97. package/src/spells/ultra/engine/quality.ts +96 -0
  98. package/src/spells/ultra/index.ts +52 -0
  99. package/src/spells/ultra/main.ts +305 -0
  100. package/src/spells/ultra/scene/arenaMaterial.ts +325 -0
  101. package/src/spells/ultra/spells/cast.ts +233 -0
  102. package/src/spells/ultra/spells/fire.ts +1267 -0
  103. package/src/spells/ultra/vfx/FluidVolume.ts +816 -0
  104. package/src/spells/ultra/vfx/FluidVolume.tsl.ts +855 -0
  105. package/src/spells/ultra/vfx/FxTarget.ts +61 -0
  106. package/src/spells/ultra/vfx/GroundField.ts +1399 -0
  107. package/src/spells/ultra/vfx/Particles.ts +1475 -0
  108. package/src/spells/ultra/vfx/Ribbons.ts +645 -0
  109. package/src/spells/ultra/vfx/Shockwaves.ts +286 -0
  110. package/src/spells/ultra/vfx/Volumes.ts +489 -0
  111. package/src/spells/ultra/vfx/common.ts +1195 -0
  112. package/src/spells/ultra/vfx/noise.ts +441 -0
  113. package/src/startup-readiness.ts +128 -34
  114. package/src/version.ts +1 -1
  115. package/src/warmup.ts +56 -8
  116. package/src/water-surface.ts +9 -3
  117. package/src/world-bundle-safety.ts +401 -0
  118. package/src/world-cell-batches.ts +1216 -0
  119. package/src/world-cell-chunks.ts +1132 -0
  120. package/src/world-cell-data.ts +995 -0
  121. package/src/world-cell-impostors.ts +1449 -0
  122. package/src/world-cell-lod-bias.ts +151 -0
  123. package/src/world-cell-models.ts +1074 -0
  124. package/src/world-cell-options.ts +189 -0
  125. package/src/world-cell-placements.ts +694 -0
  126. package/src/world-cell-prewarm.ts +557 -0
  127. package/src/world-cell-readiness.ts +357 -0
  128. package/src/world-cell-render-bundles.ts +459 -0
  129. package/src/world-cell-render-gpu-dress.ts +714 -0
  130. package/src/world-cell-render-main-cull.ts +484 -0
  131. package/src/world-cell-render-shadow-claims.ts +198 -0
  132. package/src/world-cell-render-util.ts +246 -0
  133. package/src/world-cell-render.ts +1493 -0
  134. package/src/world-cell-residency.ts +745 -0
  135. package/src/world-cells.ts +1318 -10418
  136. package/src/world-chunk-shadow.ts +308 -0
  137. package/src/world-collar.ts +315 -0
  138. package/src/world-gpu-flags.ts +163 -0
  139. package/src/world-gpu-readback.ts +881 -0
  140. package/src/world-gpu-reference.ts +510 -0
  141. package/src/world-gpu-scene.ts +214 -2264
  142. package/src/world-gpu-shadow.ts +190 -0
  143. package/src/world-gpu-types.ts +381 -0
  144. package/src/world-gpu-validation.ts +518 -0
  145. package/src/world-heightfield.ts +802 -0
  146. package/src/world-load-limiter.ts +106 -0
  147. package/src/world-noise.ts +241 -0
  148. package/src/world-package.ts +42 -0
  149. package/src/world-region.ts +1 -1
  150. package/src/world-terrain-splat.ts +365 -149
  151. package/src/world-tile-budget.ts +256 -0
  152. package/src/world-tile-geometry.ts +469 -0
  153. package/src/world-tile-lod.ts +408 -0
  154. package/src/world-tile-observation.ts +566 -0
  155. package/src/world-tile-stitch.ts +166 -0
  156. package/src/world-tiles.ts +170 -1745
  157. package/src/world-water-bodies.ts +359 -0
  158. package/src/world.ts +35 -741
package/dist/index.d.ts CHANGED
@@ -1,16 +1,17 @@
1
1
  import * as three from 'three';
2
2
  import { Object3D, AnimationClip, AnimationMixer, Vector3, Camera, Group, Scene, Texture, Matrix4, Mesh, BufferGeometry, Box3, Material, DataTexture, InstancedMesh, ColorRepresentation, DirectionalLight, DepthTexture, LightShadow, Color, HemisphereLight, ToneMapping, FogExp2, Vector2, RenderTarget, Sprite, CatmullRomCurve3 } from 'three';
3
+ export { a as CameraShake, C as CameraShakeCurve, I as ICameraShakeOffset, b as ICameraShakeOptions } from './camera-shake-CZKOfGn4.js';
3
4
  export { A as AssetPriority, b as IAssetCacheReport, c as IAssetCacheState, I as IAssetLoader, a as IAssetLoaderOptions, d as IAssetPrefetchProgress, e as IAssetRequestOptions, f as ITextureOptions, g as createAssetLoader, r as reconcileMirroredClips } from './assets-YUbXa3-Y.js';
4
5
  export { A as AudioBus, I as IAudioBusOptions, b as IAudioCompressorOptions, c as IAudioPlayOptions, r as resetAudioCueLedger } from './audio-DIJE5HTr.js';
5
- export { C as CanvasLayer } from './canvas-layer-vCtanIeB.js';
6
- import { b as IGamePluginRuntime, a as IGamePluginHooks } from './game-DzMcitDO.js';
7
- export { A as AfterPhysicsCallback, C as ContextMenuPolicy, G as GEOMETRY_ASSET_KEY, c as GEOMETRY_CAPTURE_DEFAULT_LIMIT, d as GEOMETRY_CAPTURE_MAX_LIMIT, e as GEOMETRY_CAPTURE_SORTS, f as GEOMETRY_CAPTURE_TIMEOUT_MS, g as GEOMETRY_CAPTURE_WALK_CAP, h as GeometryCaptureSort, i as ICtx, I as IGame, j as IGameObservationContribution, k as IGameObservationSampleRequest, l as IGamePlatformSource, m as IGeometryCaptureAsset, n as IGeometryCaptureMesh, o as IGeometryCapturePass, p as IGeometryCaptureReport, q as IGeometryCaptureRequest, r as IGeometryCaptureRow, s as IInputAction, t as IInputGamepad, u as IPointerDragHandle, v as IPointerEvent3D, w as IPointerEvents3D, x as IPointerEvents3DOptions, y as IPointerEvents3DPicker, z as IPointerState, B as IRandom, D as IRawInputPointer, E as IRawInputPointerEdge, F as IRawInputState, H as IRaycastOptions, J as IScenePickerOptions, K as IThreeNativeAudioConfig, L as IThreeNativeAudioLoop, M as IThreeNativeAudioOverride, N as IThreeNativeAudioSpectrum, O as IThreeNativeBootSplash, P as IThreeNativeConfig, Q as IThreeNativeIconVariants, R as IThreeNativeLodConfig, S as IThreeNativeLodGenerationConfig, T as IThreeNativeLodOverride, U as IThreeNativeLodRuntimeConfig, V as IThreeNativeTexturesConfig, W as ITweenOptions, X as IWarmUpCacheOptions, Y as IWarmUpObservation, Z as IWarmUpOptions, _ as IWarmUpProgress, $ as IWarmUpRenderer, a0 as IWarmUpReport, a1 as InputBindings, a2 as InputMap, a3 as InputPlatformSource, a4 as PointerEvent3DListener, a5 as PointerEvent3DType, a6 as PointerEvents3D, a7 as Scene, a8 as SceneFrame, a9 as ScenePicker, aa as ScheduleHandle, ab as Scheduler, ac as ThreeNativeBackgroundMode, ad as ThreeNativeLodMinTrianglesScope, ae as ThreeNativeLodPreset, af as ThreeNativeOrientation, ag as ThreeNativeUiRenderer, ah as WarmUpCacheStatus, ai as WarmUpObservationStatus, aj as afterPhysics, ak as captureMouse, al as createRandom, am as defineGame, an as warmUpScene } from './game-DzMcitDO.js';
6
+ export { C as CanvasLayer } from './canvas-layer-CWuFRT7G.js';
7
+ import { b as IGamePluginRuntime, a as IGamePluginHooks } from './game-D7pAzZUY.js';
8
+ export { A as AfterPhysicsCallback, C as ContextMenuPolicy, G as GEOMETRY_ASSET_KEY, c as GEOMETRY_CAPTURE_DEFAULT_LIMIT, d as GEOMETRY_CAPTURE_MAX_LIMIT, e as GEOMETRY_CAPTURE_SORTS, f as GEOMETRY_CAPTURE_TIMEOUT_MS, g as GEOMETRY_CAPTURE_WALK_CAP, h as GeometryCaptureSort, i as ICtx, I as IGame, j as IGameObservationContribution, k as IGameObservationSampleRequest, l as IGamePlatformSource, m as IGeometryCaptureAsset, n as IGeometryCaptureMesh, o as IGeometryCapturePass, p as IGeometryCaptureReport, q as IGeometryCaptureRequest, r as IGeometryCaptureRow, s as IInputAction, t as IInputGamepad, u as IPointerDragHandle, v as IPointerEvent3D, w as IPointerEvents3D, x as IPointerEvents3DOptions, y as IPointerEvents3DPicker, z as IPointerState, B as IRandom, D as IRawInputPointer, E as IRawInputPointerEdge, F as IRawInputState, H as IRaycastOptions, J as IScenePickerOptions, K as IThreeNativeAudioConfig, L as IThreeNativeAudioLoop, M as IThreeNativeAudioOverride, N as IThreeNativeAudioSpectrum, O as IThreeNativeBootSplash, P as IThreeNativeConfig, Q as IThreeNativeIconVariants, R as IThreeNativeLodConfig, S as IThreeNativeLodGenerationConfig, T as IThreeNativeLodOverride, U as IThreeNativeLodRuntimeConfig, V as IThreeNativeTexturesConfig, W as ITweenOptions, X as IWarmUpCacheOptions, Y as IWarmUpObservation, Z as IWarmUpOptions, _ as IWarmUpProgress, $ as IWarmUpRenderer, a0 as IWarmUpReport, a1 as InputBindings, a2 as InputMap, a3 as InputPlatformSource, a4 as PointerEvent3DListener, a5 as PointerEvent3DType, a6 as PointerEvents3D, a7 as Scene, a8 as SceneFrame, a9 as ScenePicker, aa as ScheduleHandle, ab as Scheduler, ac as ThreeNativeBackgroundMode, ad as ThreeNativeLodMinTrianglesScope, ae as ThreeNativeLodPreset, af as ThreeNativeOrientation, ag as ThreeNativeUiRenderer, ah as WarmUpCacheStatus, ai as WarmUpObservationStatus, aj as afterPhysics, ak as captureMouse, al as createRandom, am as defineGame, an as warmUpScene } from './game-D7pAzZUY.js';
8
9
  import * as three_webgpu from 'three/webgpu';
9
10
  import { StorageTexture, ComputeNode, UniformNode, Node, TextureNode, CubeRenderTarget, WebGPURenderer, NodeMaterial, StorageBufferNode, StructTypeNode, Data3DTexture, ShadowBaseNode, NodeBuilder, NodeFrame, SpriteNodeMaterial, StorageTextureNode, Storage3DTexture } from 'three/webgpu';
10
- import { I as IRendererLike, h as IStageGpuReading, F as FramePassKind, a as IFrameBudgetWindow } from './renderer-rZm0hVqq.js';
11
- export { D as DEFAULT_PIPELINE_CENSUS_LIMIT, i as DEFAULT_TARGET_FPS, j as FRAME_BUDGET_MARKER, k as FRAME_BUDGET_PHASES, l as FRAME_HITCH_MARKER, m as FrameBudget, n as FrameBudgetPhase, o as FrameCounters, p as ICounterDevice, g as IFrameBudgetOptions, q as IFrameBudgetPassSummary, b as IFrameBudgetSimulation, r as IFrameBudgetSummary, s as IFrameCounters, d as IFramePhaseSample, e as IPipelineCensus, t as IPipelineCensusCounts, u as IPipelineCensusEvent, v as IPipelineCensusOptions, w as IPipelineProvenance, x as IPipelineShaderObservation, y as IPlatformInfo, z as IRenderChainApplied, A as IRenderChainBudgetWindow, B as IRenderChainDroppedStage, C as IRenderChainOptions, E as IRenderChainRenderer, G as IRenderChainRequest, H as IRenderChainStage, J as IRenderChainStageContext, K as IRenderChainVelocityMeasurement, L as IRenderChainVelocityReport, M as IRenderChainVelocityRequest, N as IRenderChainVelocityResult, c as IRenderPassSample, O as ITargetFps, P as IVelocityRenderPass, Q as MAX_TARGET_FPS, R as MainDrawSource, S as PIPELINE_CENSUS_CAPABILITY, T as PIPELINE_CENSUS_VERSION, U as PipelineCensus, V as PipelineCensusMode, W as PipelineCensusStatus, X as PlatformFormFactor, Y as PlatformOS, Z as PlatformRuntime, _ as RENDER_CHAIN_MARKER, $ as RENDER_CHAIN_STAGE_ORDER, a0 as RENDER_CHAIN_TIERS, a1 as RenderChain, a2 as RenderChainSource, a3 as RenderChainStageId, a4 as RenderChainStageName, a5 as RenderChainTier, a6 as RenderChainTierRequest, a7 as RenderChainVelocitySource, a8 as RendererToneMapping, a9 as TargetFpsSource, aa as VELOCITY_OUTPUT_NAME, ab as VELOCITY_PREVIOUS_BONE_MATRICES, ac as VELOCITY_PREVIOUS_INSTANCE_MATRICES, ad as VELOCITY_PREVIOUS_WORLD_MATRIX, ae as VelocityTracker, af as counterDeviceOf, ag as createPipelineCensus, ah as ensureVelocityOutput, ai as getPlatform, aj as isMobile, ak as isNative, al as isTouchscreenAvailable, am as isWeb, an as prewarm, ao as readRenderChainObservation, ap as readRenderChainReport, aq as readVelocityPreviousBoneMatrices, ar as readVelocityPreviousMatrices, as as readVelocityPreviousWorldMatrix, at as resolveTargetFps, au as snapRefreshRate, av as stageGpuReading, aw as velocityTexture, ax as withVelocityContext } from './renderer-rZm0hVqq.js';
12
- import { I as IComputeDriven$1, c as IGPUReadbackSample, d as IBudgetCandidate } from './model-lod-CTpZ6imz.js';
13
- export { C as ComputeDrivenRegistry, D as DISCRETE_LOD_DEFAULT_ERROR_PIXELS, e as DISCRETE_LOD_DEFAULT_HYSTERESIS, G as GPUReadback, f as IGPUReadbackOptions, g as baseGeometryOf, l as lodPixelScale, u as updateModelLods } from './model-lod-CTpZ6imz.js';
11
+ import { I as IRendererLike, h as IStageGpuReading, F as FramePassKind, a as IFrameBudgetWindow } from './renderer-DvFVoAgj.js';
12
+ export { D as DEFAULT_PIPELINE_CENSUS_LIMIT, i as DEFAULT_TARGET_FPS, j as FRAME_BUDGET_MARKER, k as FRAME_BUDGET_PHASES, l as FRAME_HITCH_MARKER, m as FrameBudget, n as FrameBudgetPhase, o as FrameCounters, p as ICounterDevice, g as IFrameBudgetOptions, q as IFrameBudgetPassSummary, b as IFrameBudgetSimulation, r as IFrameBudgetSummary, s as IFrameCounters, d as IFramePhaseSample, e as IPipelineCensus, t as IPipelineCensusCounts, u as IPipelineCensusEvent, v as IPipelineCensusOptions, w as IPipelineProvenance, x as IPipelineShaderObservation, y as IPlatformInfo, z as IRenderChainApplied, A as IRenderChainBudgetWindow, B as IRenderChainDroppedStage, C as IRenderChainOptions, E as IRenderChainRenderer, G as IRenderChainRequest, H as IRenderChainStage, J as IRenderChainStageContext, K as IRenderChainVelocityMeasurement, L as IRenderChainVelocityReport, M as IRenderChainVelocityRequest, N as IRenderChainVelocityResult, c as IRenderPassSample, O as ITargetFps, P as IVelocityRenderPass, Q as MAX_TARGET_FPS, R as MainDrawSource, S as PIPELINE_CENSUS_CAPABILITY, T as PIPELINE_CENSUS_VERSION, U as PipelineCensus, V as PipelineCensusMode, W as PipelineCensusStatus, X as PlatformFormFactor, Y as PlatformOS, Z as PlatformRuntime, _ as RENDER_CHAIN_MARKER, $ as RENDER_CHAIN_STAGE_ORDER, a0 as RENDER_CHAIN_TIERS, a1 as RenderChain, a2 as RenderChainSource, a3 as RenderChainStageId, a4 as RenderChainStageName, a5 as RenderChainTier, a6 as RenderChainTierRequest, a7 as RenderChainVelocitySource, a8 as RendererToneMapping, a9 as TargetFpsSource, aa as VELOCITY_OUTPUT_NAME, ab as VELOCITY_PREVIOUS_BONE_MATRICES, ac as VELOCITY_PREVIOUS_INSTANCE_MATRICES, ad as VELOCITY_PREVIOUS_WORLD_MATRIX, ae as VelocityTracker, af as counterDeviceOf, ag as createPipelineCensus, ah as ensureVelocityOutput, ai as getPlatform, aj as isMobile, ak as isNative, al as isTouchscreenAvailable, am as isWeb, an as prewarm, ao as readRenderChainObservation, ap as readRenderChainReport, aq as readVelocityPreviousBoneMatrices, ar as readVelocityPreviousMatrices, as as readVelocityPreviousWorldMatrix, at as resolveTargetFps, au as snapRefreshRate, av as stageGpuReading, aw as velocityTexture, ax as withVelocityContext } from './renderer-DvFVoAgj.js';
13
+ import { I as IComputeDriven$1, a as IGPUReadbackSample, d as IBudgetCandidate } from './model-lod-B6BMqS1r.js';
14
+ export { C as ComputeDrivenRegistry, D as DISCRETE_LOD_DEFAULT_ERROR_PIXELS, e as DISCRETE_LOD_DEFAULT_HYSTERESIS, G as GPUReadback, f as IGPUReadbackOptions, g as baseGeometryOf, l as lodChainOf, h as lodPixelScale, u as updateModelLods } from './model-lod-B6BMqS1r.js';
14
15
  import { SkyMesh } from 'three/addons/objects/SkyMesh.js';
15
16
  import { pass } from 'three/tsl';
16
17
  import { Node as Node$1, UniformNode as UniformNode$1 } from 'three/src/nodes/Nodes.js';
@@ -580,57 +581,12 @@ declare class Billboard3D {
580
581
  update(camera?: Camera): this;
581
582
  }
582
583
 
583
- type CameraShakeCurve = (phase: number) => number;
584
- interface ICameraShakeOptions {
585
- /** Position amplitude in world metres, supplied by the game. */
586
- readonly amplitude: Vector3;
587
- /** Rotation amplitude in radians around x/y/z, supplied by the game. */
588
- readonly rotationAmplitude: Vector3;
589
- /** Curve cycles per second, supplied by the game. */
590
- readonly frequency: number;
591
- /** Exponential envelope decay per second, supplied by the game. */
592
- readonly decay: number;
593
- /** Game-authored waveform sampled at `elapsed * frequency * 2π`. */
594
- readonly curve: CameraShakeCurve;
595
- }
596
- interface ICameraShakeOffset {
597
- readonly position: Vector3;
598
- readonly rotation: Vector3;
599
- }
600
- /**
601
- * Produce a transient camera offset without owning or mutating a camera.
602
- *
603
- * The caller supplies the amplitudes, frequency, decay and waveform. {@link update} evaluates the
604
- * waveform against the caller's fixed-step delta and returns a reusable position/rotation offset;
605
- * a template can compose it after its own camera rig and damping.
606
- */
607
- declare class CameraShake {
608
- #private;
609
- readonly amplitude: Vector3;
610
- readonly rotationAmplitude: Vector3;
611
- readonly frequency: number;
612
- readonly decay: number;
613
- readonly curve: CameraShakeCurve;
614
- readonly offset: ICameraShakeOffset;
615
- constructor(options: ICameraShakeOptions);
616
- get active(): boolean;
617
- get elapsed(): number;
618
- /** Start or restart the authored shake waveform. */
619
- trigger(): this;
620
- /** Stop the effect and clear the offset. */
621
- stop(): this;
622
- /** Evaluate the current offset and advance by one caller-supplied fixed-step delta. */
623
- update(dt: number): ICameraShakeOffset;
624
- }
625
-
626
584
  /**
627
585
  * Why a launch stopped, said where the player can read it.
628
586
  *
629
- * A launch has exactly two ways to go wrong quietly, and both were measured on a real game:
630
- * progress stops moving (a decode that never returns, an asset that never settles) and the GPU
631
- * device is lost (another process had taken 94% of VRAM). In both the loop keeps iterating, the
632
- * loading layer keeps painting, and the only account of what happened is a line on stdout — which
633
- * a player does not have, and which a bug report therefore never carries.
587
+ * A launch can fail when a scene load rejects, progress stops moving, or the GPU device is
588
+ * lost. Without a report, the player sees a loading layer while the actionable error stays
589
+ * on stdout or in a discarded scene-transition promise.
634
590
  *
635
591
  * So the failure is reported as text, once, through `onLaunchFailure` — and core stops there. Core
636
592
  * cannot draw it: on the native host `document` is a Three.js compatibility stub whose
@@ -638,12 +594,8 @@ declare class CameraShake {
638
594
  * that needs it. The page owns the presentation (and the copy-to-clipboard button players are
639
595
  * asked for when they report a launch that hung); this owns the noticing and the wording.
640
596
  */
641
- /**
642
- * What failed. `stalled` is "no progress for a while"; `device-lost` is the GPU going away;
643
- * `scene-load-failed` is a scene's `load()` rejecting and `start-failed` is `start()` rejecting,
644
- * each of which otherwise reads as a stall.
645
- */
646
- type LaunchFailureKind = "stalled" | "device-lost" | "scene-load-failed" | "start-failed";
597
+ /** What failed: startup progress, a rejected scene load/start, or a lost GPU device. */
598
+ type LaunchFailureKind = "stalled" | "device-lost" | "load-failed" | "scene-load-failed" | "start-failed";
647
599
  interface ILaunchFailure {
648
600
  readonly kind: LaunchFailureKind;
649
601
  /** One human sentence, already naming the numbers — this is what the Copy button copies. */
@@ -1568,6 +1520,25 @@ declare class ClusteredBatch {
1568
1520
  update(camera: Camera, viewportHeight: number): number;
1569
1521
  }
1570
1522
 
1523
+ /**
1524
+ * A far level for a card mesh: keep `keep` of its cards and grow each kept card about its own
1525
+ * centre so the mesh holds its total surface area.
1526
+ *
1527
+ * Needle and leaf cards are disconnected quads, so an edge-collapse simplifier cannot reduce them
1528
+ * (the asset cook's chain skips them, and a far tree drew every card of its middle level to the
1529
+ * horizon). Dropping cards alone thins the crown, so the kept ones take the lost area, as Unreal's
1530
+ * Nanite "Preserve Area" foliage does (UE 5.8.3:
1531
+ * Engine/Source/Developer/MeshSimplifier/Private/MeshSimplify.cpp `PreserveSurfaceArea`).
1532
+ *
1533
+ * A card is one island of triangles joined by shared vertex indices. The choice is deterministic: a
1534
+ * fixed-seed shuffle of the islands, taken until the triangle share is met. Positions move; every
1535
+ * other attribute is kept, and a uniform scale about the centre leaves normals and UVs valid.
1536
+ *
1537
+ * Only the drawn range counts: a material section cut from a shared index by `setDrawRange` thins its
1538
+ * own triangles, and the result, whose index holds just the kept ones, draws its whole index.
1539
+ */
1540
+ declare function thinCards(geometry: BufferGeometry, keep: number): BufferGeometry;
1541
+
1571
1542
  /**
1572
1543
  * What the gate did on the last frame, in the shape a frame-budget window reports.
1573
1544
  *
@@ -2649,176 +2620,10 @@ declare class SurfaceLights {
2649
2620
  }
2650
2621
 
2651
2622
  /**
2652
- * Renderer-independent bookkeeping for virtual shadow pages.
2653
- *
2654
- * Four pieces, none of which know a GPU exists: stable virtual page addresses and a bounded
2655
- * physical page pool with LRU eviction (`PhysicalPagePool`), camera-centred clip windows snapped
2656
- * to whole pages in a light-space basis (`DirectionalClipmap`), the pages a frame needs from
2657
- * receiver points and visible caster bounds (`ReceiverDemandPass`), and the pages a moving caster
2658
- * dirties (`ShadowInvalidationTracker`). `VirtualShadowNode` in `virtual-shadow.ts` is the only
2659
- * consumer; everything here is pure so its rules are provable in a node-environment spec.
2623
+ * What a {@link VirtualShadowNode} is asked for, what it reports, and the default of every knob.
2660
2624
  *
2661
- * Fail closed: malformed input throws at the boundary instead of producing a page that samples
2662
- * nothing.
2663
- */
2664
- /** A plain `{x, y, z}` triple; three's `Vector3` satisfies it without a copy. */
2665
- interface IVector3Like {
2666
- readonly x: number;
2667
- readonly y: number;
2668
- readonly z: number;
2669
- }
2670
- /** An axis-aligned world-space box as two corners. */
2671
- interface IBoundsLike {
2672
- readonly min: IVector3Like;
2673
- readonly max: IVector3Like;
2674
- }
2675
- /** A point in the light-space basis: `u` and `v` across the light, `w` toward it. */
2676
- interface ILightSpacePoint {
2677
- readonly u: number;
2678
- readonly v: number;
2679
- readonly w: number;
2680
- }
2681
- /** The address of one virtual page: a clip level and integer page coordinates. */
2682
- interface IVirtualPageAddress {
2683
- readonly level: number;
2684
- readonly x: number;
2685
- readonly y: number;
2686
- readonly key: string;
2687
- }
2688
- /** One clip level's window of `pagesPerAxis²` virtual pages around the centre. */
2689
- interface IClipWindow {
2690
- readonly level: number;
2691
- readonly extent: number;
2692
- readonly pageWorldSize: number;
2693
- /** Pages a window trails its followed centre by before it moves and re-renders. */
2694
- readonly refreshPages: number;
2695
- readonly minX: number;
2696
- readonly minY: number;
2697
- readonly maxX: number;
2698
- readonly maxY: number;
2699
- }
2700
- interface IDirectionalClipmapOptions {
2701
- /** Unit-free direction *toward* the source; normalised here. */
2702
- readonly direction: IVector3Like;
2703
- /** Half-width of each level's window in world units, finest first. */
2704
- readonly clipExtents: readonly number[];
2705
- /** Texels per window edge: one value for every level, or one per level finest first. */
2706
- readonly pagesPerAxis: number | readonly number[];
2707
- /**
2708
- * Fraction of an extent inside which a point selects that level, `(0, 1]`, default 0.9. One value
2709
- * for every level, or one per level finest first, the last entry standing in for the rest.
2710
- */
2711
- readonly selectionGuard?: number | readonly number[];
2712
- /**
2713
- * Fraction of an extent a level's window may trail its followed centre by before it re-renders,
2714
- * `[0, 1)`, default 0.125. Rounded to whole texels with one texel reserved for a deferred render;
2715
- * `0` keeps the old one-texel step. Larger steps re-render a level less often as the camera walks. One value
2716
- * for every level, or one per level finest first, the last entry standing in for the rest.
2717
- */
2718
- readonly refreshStep?: number | readonly number[];
2719
- /**
2720
- * The smallest ratio of a window's light-space height to its width, `(0, 1]`, default 1. A low
2721
- * sun stretches a texel along the light's V axis by `1 / sin(elevation)` of floor, so a window
2722
- * the same height as it is wide would make every shadow edge across the floor that much blurrier.
2723
- * A ratio below 1 shrinks the height to `sin(elevation)`, never under this value, and the texels
2724
- * then cover the same floor area at any sun height. A sun within 18 degrees of the zenith keeps
2725
- * square windows. Page coordinates stay square: `v` counts pages in that shrunken height.
2726
- */
2727
- readonly minAspect?: number;
2728
- }
2729
- /**
2730
- * Camera-centred clip windows in a light-space basis, snapped to whole pages.
2731
- *
2732
- * The basis is right-handed (`U × V = W`). A page camera placed along `+W` with `up = V` then
2733
- * renders screen X = `V × W` = `+U`, which is the axis the sampler reads the atlas along. The
2734
- * prototype this was ported from built `V = U × W` and every page came out mirrored.
2735
- */
2736
- declare class DirectionalClipmap {
2737
- #private;
2738
- readonly clipExtents: readonly number[];
2739
- /**
2740
- * Per level, finest first; the last entry stands in for every level past it. Mutable through
2741
- * {@link setRefreshStep} so a level whose own render is expensive can be stepped further, which
2742
- * is fewer grid positions for its window rather than a different grid.
2743
- */
2744
- refreshStep: number[];
2745
- /** Per level, finest first; the last entry stands in for every level past it. */
2746
- readonly selectionGuard: readonly number[];
2747
- readonly levelCount: number;
2748
- basisU: IVector3Like;
2749
- basisV: IVector3Like;
2750
- basisW: IVector3Like;
2751
- /** Window height over width: `v` is metres along `basisV` divided by this. 1 is a square window. */
2752
- vScale: number;
2753
- readonly minAspect: number;
2754
- centerWorld: IVector3Like;
2755
- centerLight: ILightSpacePoint;
2756
- constructor({ direction, clipExtents, pagesPerAxis, selectionGuard, refreshStep, minAspect, }: IDirectionalClipmapOptions);
2757
- /** Re-orient the basis; returns true when it changed enough that cached pages are stale. */
2758
- setDirection(direction: IVector3Like): boolean;
2759
- project(worldPoint: IVector3Like): ILightSpacePoint;
2760
- unproject({ u, v, w }: {
2761
- u: number;
2762
- v: number;
2763
- w?: number;
2764
- }): IVector3Like;
2765
- /** Re-step one level's window: the trail its followed centre may move before it re-renders. */
2766
- setRefreshStep(level: number, step: number): void;
2767
- /** Texels per edge of `level`'s window. */
2768
- pagesAt(level: number): number;
2769
- /** Resize the windows (one value, or one per level); every window is placed afresh. */
2770
- setPagesPerAxis(pagesPerAxis: number | readonly number[]): void;
2771
- updateCenter(worldPoint: IVector3Like): readonly IClipWindow[];
2772
- getWindow(level: number): IClipWindow;
2773
- pageWorldSize(level: number): number;
2774
- containsPage(level: number, x: number, y: number): boolean;
2775
- worldToPage(worldPoint: IVector3Like, level: number): IVirtualPageAddress;
2776
- /** The finest level whose guarded extent contains the point, else the coarsest. */
2777
- selectLevel(worldPoint: IVector3Like): number;
2778
- /** Light-space extent and world centre (at `w = 0`) of one page. */
2779
- pageBounds(level: number, x: number, y: number): {
2780
- level: number;
2781
- x: number;
2782
- y: number;
2783
- minU: number;
2784
- minV: number;
2785
- maxU: number;
2786
- maxV: number;
2787
- centerU: number;
2788
- centerV: number;
2789
- pageWorldSize: number;
2790
- centerWorld: IVector3Like;
2791
- };
2792
- boundsToPageRange(bounds: IBoundsLike, level: number): {
2793
- minX: number;
2794
- maxX: number;
2795
- minY: number;
2796
- maxY: number;
2797
- };
2798
- boundsToPageKeys(bounds: IBoundsLike, level: number): string[];
2799
- windowPages(level: number): IVirtualPageAddress[];
2800
- }
2801
- /**
2802
- * Remembers each tracked caster's last bounds and dirties every page the old and new bounds
2803
- * cover on every level when they change. Unchanged bounds dirty nothing.
2625
+ * Types and defaults only: the node owns the mechanism these describe.
2804
2626
  */
2805
- declare class ShadowInvalidationTracker {
2806
- #private;
2807
- readonly clipmap: DirectionalClipmap;
2808
- constructor(clipmap: DirectionalClipmap);
2809
- get trackedCount(): number;
2810
- /** Record a caster's current bounds; returns true when pages were dirtied. */
2811
- update(id: number | string, bounds: IBoundsLike): boolean;
2812
- has(id: number | string): boolean;
2813
- remove(id: number | string): boolean;
2814
- /** Dirty the current coverage of every tracked caster; returns the pending key count. */
2815
- invalidateAll(): number;
2816
- /** Drop trackers whose id is not in `liveIds`, dirtying the pages they covered. */
2817
- prune(liveIds: ReadonlySet<number | string>): number;
2818
- consumeInvalidatedKeys(): Set<string>;
2819
- clear(): void;
2820
- }
2821
-
2822
2627
  /**
2823
2628
  * Options for {@link VirtualShadowNode}. Every value is a mechanism parameter; the light's own
2824
2629
  * `shadow` keeps bias, normalBias, intensity, map type and filter, exactly as with a stock shadow.
@@ -2829,6 +2634,17 @@ interface IVirtualShadowOptions {
2829
2634
  * increasing. Default `[16, 48, 144]`: three windows, each three times wider than the last.
2830
2635
  */
2831
2636
  readonly clipExtents?: readonly number[];
2637
+ /**
2638
+ * The widest step between two levels, default 2: where `clipExtents` jump further, levels are
2639
+ * inserted at even ratios, as UE 5.8.3 doubles every clipmap level (`GetLevelRadius`,
2640
+ * Engine/Source/Runtime/Renderer/Private/VirtualShadowMaps/VirtualShadowMapClipmap.cpp:175-179). A
2641
+ * receiver crossing a level edge then changes texel size by at most this ratio: across `[24, 320]`
2642
+ * the texel grew 13 times at once and every tree on the edge flipped from self-shadowed to flat
2643
+ * lit. Per-level lists (`mapSize`, `refreshStep`, `selectionGuard`, `invalidationDelay`) give an
2644
+ * inserted level the value of the authored level it leads into. `Infinity` keeps the authored
2645
+ * levels as they are, and `TN_VIRTUAL_SHADOW_OVERRIDE` reports it.
2646
+ */
2647
+ readonly maxLevelRatio?: number;
2832
2648
  /**
2833
2649
  * Resolution bias in stops, default 0. Mirrors Unreal's
2834
2650
  * `r.Shadow.Virtual.ResolutionLodBiasDirectional`; a quality tier sets it. With the default map
@@ -3134,7 +2950,187 @@ interface IVirtualShadowDraws {
3134
2950
  */
3135
2951
  readonly keys: number;
3136
2952
  }
3137
- declare const VIRTUAL_SHADOW_MARKER = "TN_VIRTUAL_SHADOW";
2953
+
2954
+ /**
2955
+ * Renderer-independent bookkeeping for virtual shadow pages.
2956
+ *
2957
+ * Four pieces, none of which know a GPU exists: stable virtual page addresses and a bounded
2958
+ * physical page pool with LRU eviction (`PhysicalPagePool`), camera-centred clip windows snapped
2959
+ * to whole pages in a light-space basis (`DirectionalClipmap`), the pages a frame needs from
2960
+ * receiver points and visible caster bounds (`ReceiverDemandPass`), and the pages a moving caster
2961
+ * dirties (`ShadowInvalidationTracker`). `VirtualShadowNode` in `virtual-shadow.ts` is the only
2962
+ * consumer; everything here is pure so its rules are provable in a node-environment spec.
2963
+ *
2964
+ * Fail closed: malformed input throws at the boundary instead of producing a page that samples
2965
+ * nothing.
2966
+ */
2967
+ /** A plain `{x, y, z}` triple; three's `Vector3` satisfies it without a copy. */
2968
+ interface IVector3Like {
2969
+ readonly x: number;
2970
+ readonly y: number;
2971
+ readonly z: number;
2972
+ }
2973
+ /** An axis-aligned world-space box as two corners. */
2974
+ interface IBoundsLike {
2975
+ readonly min: IVector3Like;
2976
+ readonly max: IVector3Like;
2977
+ }
2978
+ /** A point in the light-space basis: `u` and `v` across the light, `w` toward it. */
2979
+ interface ILightSpacePoint {
2980
+ readonly u: number;
2981
+ readonly v: number;
2982
+ readonly w: number;
2983
+ }
2984
+ /** The address of one virtual page: a clip level and integer page coordinates. */
2985
+ interface IVirtualPageAddress {
2986
+ readonly level: number;
2987
+ readonly x: number;
2988
+ readonly y: number;
2989
+ readonly key: string;
2990
+ }
2991
+ /** One clip level's window of `pagesPerAxis²` virtual pages around the centre. */
2992
+ interface IClipWindow {
2993
+ readonly level: number;
2994
+ readonly extent: number;
2995
+ readonly pageWorldSize: number;
2996
+ /** Pages a window trails its followed centre by before it moves and re-renders. */
2997
+ readonly refreshPages: number;
2998
+ readonly minX: number;
2999
+ readonly minY: number;
3000
+ readonly maxX: number;
3001
+ readonly maxY: number;
3002
+ }
3003
+ interface IDirectionalClipmapOptions {
3004
+ /** Unit-free direction *toward* the source; normalised here. */
3005
+ readonly direction: IVector3Like;
3006
+ /** Half-width of each level's window in world units, finest first. */
3007
+ readonly clipExtents: readonly number[];
3008
+ /** Texels per window edge: one value for every level, or one per level finest first. */
3009
+ readonly pagesPerAxis: number | readonly number[];
3010
+ /**
3011
+ * Fraction of an extent inside which a point selects that level, `(0, 1]`, default 0.9. One value
3012
+ * for every level, or one per level finest first, the last entry standing in for the rest.
3013
+ */
3014
+ readonly selectionGuard?: number | readonly number[];
3015
+ /**
3016
+ * Fraction of an extent a level's window may trail its followed centre by before it re-renders,
3017
+ * `[0, 1)`, default 0.125. Rounded to whole texels with one texel reserved for a deferred render;
3018
+ * `0` keeps the old one-texel step. Larger steps re-render a level less often as the camera walks. One value
3019
+ * for every level, or one per level finest first, the last entry standing in for the rest.
3020
+ */
3021
+ readonly refreshStep?: number | readonly number[];
3022
+ /**
3023
+ * The smallest ratio of a window's light-space height to its width, `(0, 1]`, default 1. A low
3024
+ * sun stretches a texel along the light's V axis by `1 / sin(elevation)` of floor, so a window
3025
+ * the same height as it is wide would make every shadow edge across the floor that much blurrier.
3026
+ * A ratio below 1 shrinks the height to `sin(elevation)`, never under this value, and the texels
3027
+ * then cover the same floor area at any sun height. A sun within 18 degrees of the zenith keeps
3028
+ * square windows. Page coordinates stay square: `v` counts pages in that shrunken height.
3029
+ */
3030
+ readonly minAspect?: number;
3031
+ }
3032
+ /**
3033
+ * Camera-centred clip windows in a light-space basis, snapped to whole pages.
3034
+ *
3035
+ * The basis is right-handed (`U × V = W`). A page camera placed along `+W` with `up = V` then
3036
+ * renders screen X = `V × W` = `+U`, which is the axis the sampler reads the atlas along. The
3037
+ * prototype this was ported from built `V = U × W` and every page came out mirrored.
3038
+ */
3039
+ declare class DirectionalClipmap {
3040
+ #private;
3041
+ readonly clipExtents: readonly number[];
3042
+ /**
3043
+ * Per level, finest first; the last entry stands in for every level past it. Mutable through
3044
+ * {@link setRefreshStep} so a level whose own render is expensive can be stepped further, which
3045
+ * is fewer grid positions for its window rather than a different grid.
3046
+ */
3047
+ refreshStep: number[];
3048
+ /** Per level, finest first; the last entry stands in for every level past it. */
3049
+ readonly selectionGuard: readonly number[];
3050
+ readonly levelCount: number;
3051
+ basisU: IVector3Like;
3052
+ basisV: IVector3Like;
3053
+ basisW: IVector3Like;
3054
+ /** Window height over width: `v` is metres along `basisV` divided by this. 1 is a square window. */
3055
+ vScale: number;
3056
+ readonly minAspect: number;
3057
+ centerWorld: IVector3Like;
3058
+ centerLight: ILightSpacePoint;
3059
+ constructor({ direction, clipExtents, pagesPerAxis, selectionGuard, refreshStep, minAspect, }: IDirectionalClipmapOptions);
3060
+ /** Re-orient the basis; returns true when it changed enough that cached pages are stale. */
3061
+ setDirection(direction: IVector3Like): boolean;
3062
+ project(worldPoint: IVector3Like): ILightSpacePoint;
3063
+ unproject({ u, v, w }: {
3064
+ u: number;
3065
+ v: number;
3066
+ w?: number;
3067
+ }): IVector3Like;
3068
+ /** Re-step one level's window: the trail its followed centre may move before it re-renders. */
3069
+ setRefreshStep(level: number, step: number): void;
3070
+ /** Texels per edge of `level`'s window. */
3071
+ pagesAt(level: number): number;
3072
+ /** Resize the windows (one value, or one per level); every window is placed afresh. */
3073
+ setPagesPerAxis(pagesPerAxis: number | readonly number[]): void;
3074
+ updateCenter(worldPoint: IVector3Like): readonly IClipWindow[];
3075
+ getWindow(level: number): IClipWindow;
3076
+ pageWorldSize(level: number): number;
3077
+ containsPage(level: number, x: number, y: number): boolean;
3078
+ worldToPage(worldPoint: IVector3Like, level: number): IVirtualPageAddress;
3079
+ /** The finest level whose guarded extent contains the point, else the coarsest. */
3080
+ selectLevel(worldPoint: IVector3Like): number;
3081
+ /** Light-space extent and world centre (at `w = 0`) of one page. */
3082
+ pageBounds(level: number, x: number, y: number): {
3083
+ level: number;
3084
+ x: number;
3085
+ y: number;
3086
+ minU: number;
3087
+ minV: number;
3088
+ maxU: number;
3089
+ maxV: number;
3090
+ centerU: number;
3091
+ centerV: number;
3092
+ pageWorldSize: number;
3093
+ centerWorld: IVector3Like;
3094
+ };
3095
+ boundsToPageRange(bounds: IBoundsLike, level: number): {
3096
+ minX: number;
3097
+ maxX: number;
3098
+ minY: number;
3099
+ maxY: number;
3100
+ };
3101
+ boundsToPageKeys(bounds: IBoundsLike, level: number): string[];
3102
+ windowPages(level: number): IVirtualPageAddress[];
3103
+ }
3104
+ /**
3105
+ * Remembers each tracked caster's last bounds and dirties every page the old and new bounds
3106
+ * cover on every level when they change. Unchanged bounds dirty nothing.
3107
+ */
3108
+ declare class ShadowInvalidationTracker {
3109
+ #private;
3110
+ readonly clipmap: DirectionalClipmap;
3111
+ constructor(clipmap: DirectionalClipmap);
3112
+ /** Dirty page keys not yet consumed by the next shadow render. */
3113
+ get pending(): number;
3114
+ get trackedCount(): number;
3115
+ /** Record a caster's current bounds; returns true when pages were dirtied. */
3116
+ update(id: number | string, bounds: IBoundsLike): boolean;
3117
+ has(id: number | string): boolean;
3118
+ remove(id: number | string): boolean;
3119
+ /** Dirty the current coverage of every tracked caster; returns the pending key count. */
3120
+ invalidateAll(): number;
3121
+ /** Drop trackers whose id is not in `liveIds`, dirtying the pages they covered. */
3122
+ prune(liveIds: ReadonlySet<number | string>): number;
3123
+ consumeInvalidatedKeys(): Set<string>;
3124
+ clear(): void;
3125
+ }
3126
+
3127
+ /**
3128
+ * The object layers a virtual shadow draws on, and the clip ladder its levels sit at.
3129
+ *
3130
+ * One owner for the numbers: the node renders the maps, `WorldCells` mints the casters on these
3131
+ * bits, and the chunk proxies stand in for merged geometry. A copy that drifts puts the world's
3132
+ * casters on a layer no level camera reads, and no error says so — the shadow is simply missing.
3133
+ */
3138
3134
  /**
3139
3135
  * The object layer tracked casters are enabled on, so each level's mover camera sees only them.
3140
3136
  * Keep it free of other uses; the main camera never needs it (tracked objects keep layer 0).
@@ -3155,6 +3151,81 @@ declare const VIRTUAL_SHADOW_CASTER_LAYER = 28;
3155
3151
  * so whichever a level picks is there; the main camera renders neither.
3156
3152
  */
3157
3153
  declare const VIRTUAL_SHADOW_WIDE_CASTER_LAYER = 27;
3154
+
3155
+ /**
3156
+ * The `TN_VIRTUAL_SHADOW`, `TN_SHADOW_REFRESH`, `TN_SHADOW_GATE` and `TN_LAMP_SHADOW` lines, how
3157
+ * often each prints, and the parsers that read them back.
3158
+ *
3159
+ * A marker is the only way a browser run can see inside the node: which level is being throttled,
3160
+ * which one is shedding its tiniest casters, and what a frame's shadow work cost. The parsers are
3161
+ * here so a harness reads exactly the shape the node prints.
3162
+ */
3163
+ declare const VIRTUAL_SHADOW_MARKER = "TN_VIRTUAL_SHADOW";
3164
+ /**
3165
+ * Parse a `TN_VIRTUAL_SHADOW` console line back into its complete stats, or `undefined`.
3166
+ *
3167
+ * @situation inspect virtual shadow cache and mover counters from a renderer log
3168
+ * @constraint non-marker lines and markers with incomplete or non-numeric stats return `undefined`
3169
+ * @example
3170
+ * const stats = readVirtualShadowMarker(line);
3171
+ * if (stats !== undefined) console.log(stats.reuseRatio);
3172
+ */
3173
+ declare function readVirtualShadowMarker(line: string): IVirtualShadowStats | undefined;
3174
+ /**
3175
+ * One frame's shadow passes on the owned engine with the spot and point light maps apart from the
3176
+ * sun's (PRD-650). The sun's draws and the lamps' add up to every shadow draw the renderer submitted.
3177
+ */
3178
+ interface ILampShadowStats {
3179
+ readonly frame: number;
3180
+ readonly shadowDraws: number;
3181
+ /** The sun's maps: its virtual levels or its plain map. `gpuMs` is -1 until a GPU sample resolves. */
3182
+ readonly sun: {
3183
+ readonly draws: number;
3184
+ readonly gpuMs: number;
3185
+ };
3186
+ /** The lamp maps the frame redrew (a cube's six faces are one), their draws, and their GPU time. */
3187
+ readonly lamps: {
3188
+ readonly redraws: number;
3189
+ readonly draws: number;
3190
+ readonly gpuMs: number;
3191
+ };
3192
+ }
3193
+ declare const LAMP_SHADOW_MARKER = "TN_LAMP_SHADOW";
3194
+ interface ILampShadowCounters {
3195
+ readonly lampRedraws: number;
3196
+ readonly lampDraws: number;
3197
+ readonly shadowDraws: number;
3198
+ readonly sunGpuMs: number;
3199
+ readonly lampGpuMs: number;
3200
+ }
3201
+ /**
3202
+ * The `TN_LAMP_SHADOW` line for the renderer's last frame, or `undefined` on a renderer that keeps
3203
+ * no lamp counters (three's own).
3204
+ *
3205
+ * @situation log lamp shadow redraws and GPU time apart from the sun's on the owned engine
3206
+ * @constraint counters that do not add up to the frame's shadow draws throw TN_LAMP_SHADOW_INVALID
3207
+ * @example
3208
+ * const line = lampShadowMarker(renderer, frame);
3209
+ * if (line !== undefined) console.info(line);
3210
+ */
3211
+ declare function lampShadowMarker(renderer: {
3212
+ readonly info?: {
3213
+ readonly engine?: {
3214
+ readonly shadows?: ILampShadowCounters;
3215
+ };
3216
+ };
3217
+ }, frame: number): string | undefined;
3218
+ /**
3219
+ * Parse a `TN_LAMP_SHADOW` line back into its stats, or `undefined`.
3220
+ *
3221
+ * @situation count lamp shadow redraws from a renderer log, for example a moving-caster run
3222
+ * @constraint non-marker lines and markers whose sun and lamp draws do not add up return `undefined`
3223
+ * @example
3224
+ * const stats = readLampShadowMarker(line);
3225
+ * if (stats !== undefined) console.log(stats.lamps.redraws);
3226
+ */
3227
+ declare function readLampShadowMarker(line: string): ILampShadowStats | undefined;
3228
+
3158
3229
  /**
3159
3230
  * One directional shadow for a whole open world: camera-centred clip levels, each snapped to its
3160
3231
  * own texel grid and re-rendered only when its window moves. Movers never touch that cache: a
@@ -3182,11 +3253,13 @@ declare const VIRTUAL_SHADOW_WIDE_CASTER_LAYER = 27;
3182
3253
  * @situation shadow map too coarse over a big terrain
3183
3254
  * @situation one directional light shadow for a whole open world
3184
3255
  * @situation shadows shimmer when the camera moves
3256
+ * @situation shadow edges, tree lighting or level sharpness change while a third-person camera turns around its hero
3185
3257
  * @constraint the light must be a DirectionalLight with `castShadow` and a target in the scene
3186
3258
  * @constraint clipExtents are half-widths in world units, finest first, strictly increasing
3187
3259
  * @constraint movers sort themselves: a layer-0 caster whose world matrix, instance matrix or deformation changed draws through the mover maps and leaves the cached levels, and returns to them after `staticAfterFrames` quiet frames; the cache redraws only the region it left
3188
3260
  * @constraint `trackCaster(object)` is the override that pins an object as a mover for good (it enables layer `VIRTUAL_SHADOW_MOVER_LAYER` on the object and its descendants), and `pinStatic(object)` opts an object out of detection; tracking or untracking refreshes only that object's region
3189
3261
  * @override bias, biasNode, normalBias, intensity, radius, blurSamples, mapType and filterNode stay on `light.shadow`; mapSize and the other options here have defaults
3262
+ * @override setFocus(point) centres every window on a subject (a third-person hero) instead of the eye, so an orbiting eye moves no shadow; setFocus(undefined) hands them back
3190
3263
  * @override followViewFocus: false keeps eye follow; receiverPlaneBias: false uses only authored bias
3191
3264
  * @override minWindowAspect: below 1, a level is as high as `sin(sun elevation)` times its width, never under this, so a low sun's floor shadows keep the texel density of a high sun's; the default 1 keeps square levels
3192
3265
  * @example
@@ -3223,6 +3296,12 @@ declare class VirtualShadowNode extends ShadowBaseNode {
3223
3296
  * callers that already update this tracker still invalidate the affected cached levels.
3224
3297
  */
3225
3298
  readonly tracker: ShadowInvalidationTracker;
3299
+ /** Core startup cover: drain all due levels without steady-state invalidation delays. */
3300
+ startupCovered: boolean;
3301
+ /** Three's type flag; core's startup gate reads it so the game loop never imports this class. */
3302
+ readonly isVirtualShadowNode = true;
3303
+ /** Every map is present and no requested/delayed invalidation remains. */
3304
+ get settled(): boolean;
3226
3305
  constructor(light: DirectionalLight, options?: IVirtualShadowOptions);
3227
3306
  /** The per-frame counters, as of the last `updateBefore`. */
3228
3307
  get stats(): IVirtualShadowStats;
@@ -3265,74 +3344,20 @@ declare class VirtualShadowNode extends ShadowBaseNode {
3265
3344
  invalidateRegion(bounds: IBoundsLike & {
3266
3345
  admission?: boolean;
3267
3346
  }, admission?: boolean): void;
3347
+ /**
3348
+ * Centre every clip window on `point` instead of the camera's eye, or on the eye again with
3349
+ * `undefined`. The point is the view's subject: a third-person hero, an orbit pivot. Level
3350
+ * selection, blend bands and window pans then depend on the subject alone, so a camera that turns
3351
+ * around it (its eye travels the arm's whole circle) moves no shadow edge and re-renders no page.
3352
+ * Unreal does the same for a view target (UE 5.8.3: VirtualShadowMapClipmap.cpp:256-295 moves the
3353
+ * clipmap WorldOrigin onto it). Call it whenever the subject moves; an unchanged point costs one
3354
+ * comparison. The point is copied, so a live `position` can be passed every frame.
3355
+ */
3356
+ setFocus(point: IVector3Like | undefined): void;
3268
3357
  setup(builder: NodeBuilder): Node | null | undefined;
3269
3358
  updateBefore(frame: NodeFrame): undefined;
3270
3359
  dispose(): void;
3271
3360
  }
3272
- /**
3273
- * Parse a `TN_VIRTUAL_SHADOW` console line back into its complete stats, or `undefined`.
3274
- *
3275
- * @situation inspect virtual shadow cache and mover counters from a renderer log
3276
- * @constraint non-marker lines and markers with incomplete or non-numeric stats return `undefined`
3277
- * @example
3278
- * const stats = readVirtualShadowMarker(line);
3279
- * if (stats !== undefined) console.log(stats.reuseRatio);
3280
- */
3281
- declare function readVirtualShadowMarker(line: string): IVirtualShadowStats | undefined;
3282
- /**
3283
- * One frame's shadow passes on the owned engine with the spot and point light maps apart from the
3284
- * sun's (PRD-650). The sun's draws and the lamps' add up to every shadow draw the renderer submitted.
3285
- */
3286
- interface ILampShadowStats {
3287
- readonly frame: number;
3288
- readonly shadowDraws: number;
3289
- /** The sun's maps: its virtual levels or its plain map. `gpuMs` is -1 until a GPU sample resolves. */
3290
- readonly sun: {
3291
- readonly draws: number;
3292
- readonly gpuMs: number;
3293
- };
3294
- /** The lamp maps the frame redrew (a cube's six faces are one), their draws, and their GPU time. */
3295
- readonly lamps: {
3296
- readonly redraws: number;
3297
- readonly draws: number;
3298
- readonly gpuMs: number;
3299
- };
3300
- }
3301
- declare const LAMP_SHADOW_MARKER = "TN_LAMP_SHADOW";
3302
- interface ILampShadowCounters {
3303
- readonly lampRedraws: number;
3304
- readonly lampDraws: number;
3305
- readonly shadowDraws: number;
3306
- readonly sunGpuMs: number;
3307
- readonly lampGpuMs: number;
3308
- }
3309
- /**
3310
- * The `TN_LAMP_SHADOW` line for the renderer's last frame, or `undefined` on a renderer that keeps
3311
- * no lamp counters (three's own).
3312
- *
3313
- * @situation log lamp shadow redraws and GPU time apart from the sun's on the owned engine
3314
- * @constraint counters that do not add up to the frame's shadow draws throw TN_LAMP_SHADOW_INVALID
3315
- * @example
3316
- * const line = lampShadowMarker(renderer, frame);
3317
- * if (line !== undefined) console.info(line);
3318
- */
3319
- declare function lampShadowMarker(renderer: {
3320
- readonly info?: {
3321
- readonly engine?: {
3322
- readonly shadows?: ILampShadowCounters;
3323
- };
3324
- };
3325
- }, frame: number): string | undefined;
3326
- /**
3327
- * Parse a `TN_LAMP_SHADOW` line back into its stats, or `undefined`.
3328
- *
3329
- * @situation count lamp shadow redraws from a renderer log, for example a moving-caster run
3330
- * @constraint non-marker lines and markers whose sun and lamp draws do not add up return `undefined`
3331
- * @example
3332
- * const stats = readLampShadowMarker(line);
3333
- * if (stats !== undefined) console.log(stats.lamps.redraws);
3334
- */
3335
- declare function readLampShadowMarker(line: string): ILampShadowStats | undefined;
3336
3361
 
3337
3362
  declare module "three" {
3338
3363
  interface Material {
@@ -3461,9 +3486,10 @@ declare function addFoliageBackLight(material: Material, backIrradiance: Node<"v
3461
3486
  declare module "three" {
3462
3487
  interface Material {
3463
3488
  /**
3464
- * Unreal's Substrate rough diffuse, the EON model (PRD-653): direct light shades the diffuse lobe of a
3465
- * standard or physical material with EON where three shades Lambert. The default is off. Indirect light
3466
- * stays Lambert, and a material changed after its first draw needs `needsUpdate`.
3489
+ * Unreal's Substrate slab as a fresh project compiles it (PRD-653, PRD-632): direct light shades the diffuse lobe
3490
+ * of a standard or physical material with EON where three shades Lambert, with no energy conservation (the diffuse
3491
+ * keeps the light three's Fresnel takes, the specular has no multi-scattering weight). The default is off.
3492
+ * Indirect light stays three's, and a material changed after its first draw needs `needsUpdate`.
3467
3493
  */
3468
3494
  roughDiffuse?: boolean;
3469
3495
  }
@@ -3602,7 +3628,8 @@ interface IFilmicCurve {
3602
3628
  * The largest scene-linear value, after exposure, that one channel can hold when the colour goes into Unreal's
3603
3629
  * colour LUT (the top of its 14-stop log shaper, `Engine/Shaders/Private/GammaCorrectionCommon.ush`: `LogToLin(1)`
3604
3630
  * minus `LogToLin(0)`). A channel above it is clipped there, so the sun disc and a hot emitter lose their hue
3605
- * earlier than an unbounded curve would. 0, the default, leaves the channel unbounded; pass `LUT_CLIP` for Unreal's.
3631
+ * earlier than an unbounded curve would. `LUT_CLIP` is the default, as in Unreal; 0 is the named override that leaves
3632
+ * the channel unbounded.
3606
3633
  */
3607
3634
  readonly lutClip: number;
3608
3635
  }
@@ -4190,8 +4217,8 @@ declare const lookDiagnostics: {
4190
4217
  aaAlphaSqueezed: boolean;
4191
4218
  /** Runs N denoise passes over the SSGI gather at any layer, for an A/B against the tier's count. */
4192
4219
  denoisePasses: number | undefined;
4193
- /** Turns on the film curve's 43.7 channel clip (off by default), the ON arm of a paired capture. */
4194
- lutClipOn: boolean;
4220
+ /** Turns off the film curve's 43.7 channel clip (on by default), the OFF arm of a paired capture. */
4221
+ lutClipOff: boolean;
4195
4222
  /** Draws one GI term alone (PRD-646); needs the gather, so it applies at layer 7 and above. */
4196
4223
  giVisualize: GIVisualizeMode;
4197
4224
  };
@@ -5949,6 +5976,6 @@ declare function boneLengthDeviations(root: Object3D, bind: IBoneLengthSnapshot,
5949
5976
  * unavoidable here — core is bundled for browsers and cannot read `package.json` at runtime — so
5950
5977
  * the spec now asserts this equals the manifest instead of asserting a number somebody typed.
5951
5978
  */
5952
- declare const version = "0.3.10";
5979
+ declare const version = "0.3.12";
5953
5980
 
5954
- export { ATLAS_PADDING, ATMOSPHERE_LUT_RESOLUTIONS, AnimationComposer, AnimationPlayer, Atmosphere, type AtmosphereDirection, AtmosphereLuts, type AtmosphereRgb, AutoExposureNode, Billboard3D, type BillboardLockAxis, BlendSpace1D, BlendSpace2D, BudgetLadder, type BudgetVerdict, CameraShake, type CameraShakeCurve, type ChainStage, ClusteredBatch, ClusteredMesh, Daylight, ENVIRONMENT_TOO_SMALL_MARKER, EPIC_SSGI, type FinalGatherMethod, FlightModel, FluidField2D, FluidParticles3D, FramePassKind, GIBudget, type GIMethod, GIVisualize, type GIVisualizeMode, GI_METHODS, GI_VISUALIZE_MODES, GPUParticles3D, GPUSceneBVH, type GPUSceneBVHTraceFunction, GroundSnap, type IAddInSlicesOptions, type IAddInSlicesProgress, type IAddInSlicesReport, type IAircraftAirframe, type IAnimationComposerOptions, type IAnimationLayer, type IAnimationMask, type IAnimationMotionDelta, type IAnimationPlayOptions, type IAnimationPlayerOptions, type IAnimationRootMotionOptions, type IAnimationUpdateRateReport, type IAtmosphereLutResolution, type IAtmosphereLutResolutions, type IAtmosphereOptions, type IAtmosphereParameterPatch, type IAtmosphereParameters, type IAtmosphereScenePass, type IBillboard3DOptions, type IBoneContactReport, type IBoneLengthDeviation, type IBoneLengthDeviationReport, type IBoneLengthDeviationsOptions, type IBoneLengthSnapshot, type IBonePoseError, type IBudgetLadderOptions, type IBudgetWindow, type ICameraShakeOffset, type ICameraShakeOptions, type IClipBindingReport, type IClipCoverageReport, type IClipPoseErrorOptions, type IClipPoseErrorReport, type IClipPoseSubject, type IClipTrackBinding, type IClusterTable, type IClusteredBatchBuildOptions, type IClusteredBatchOptions, type IClusteredMeshOptions, type IClusteredPlacement, IComputeDriven$1 as IComputeDriven, type IDaylightOptions, type IEmitParticleRequest, type IExposureSettings, type IFlightAxes, type IFlightControls, type IFlightDeck, type IFlightEnvironment, type IFlightForces, type IFlightModelOptions, type IFlightModifiers, type IFlightQuaternion, type IFlightState, type IFlightVector3, type IFluidBounds, type IFluidCollider, type IFluidFieldOptions, type IFluidFieldSampler, type IFluidFieldVector2, type IFluidParticlesOptions, type IFluidParticlesStats, IFrameBudgetWindow, type IGIBudgetOptions, type IGIBudgetReport, type IGIVisualizeOptions, type IGPUParticles3DOptions, type IGPUParticles3DRuntime, type IGPUParticles3DSpawnBuffers, type IGPUParticles3DSpawnRequest, type IGPUParticles3DStats, IGPUReadbackSample, type IGPUSceneBVHMaterialGroup, type IGPUSceneBVHOptions, IGamePluginHooks, IGamePluginRuntime, type IGiTier, type IGroundSnapOptions, type IInstancedBatchBuildOptions, type IInstancedBatchOptions, type IInstancedPlacement, type ILampShadowStats, type ILaunchFailure, type ILoadAllOptions, type ILoadAllProgress, type IMatrixWorldReport, type IMeasureThreePoseOptions, type IMergeByMaterialOptions, type IMergePart, type IMergePartsOptions, type INormaliseToMetresOptions, type IPathFollow3DOptions, type IPathFollow3DProjection, type IPathFollow3DSample, type IProbeVolumeBakeProgress, type IProbeVolumeCoefficient, type IProbeVolumeObservation, type IProbeVolumeOptions, type IReflectionRoute, type IReplayOptions, type IReplayRecording, type IReplayRecordingSample, type IResolvedAtmosphereParameters, type IRippleFieldFlow, type IRippleFieldOptions, type ISceneShape, type ISceneWarning, type IShadowFilter, type IShadowFilterBudgetOptions, type IShadowFilterReport, type IShadowTier, type ISkeletalMesh3DOptions, type ISkyCaptureOptions, type ISoftBody3DOptions, type ISoftBodyCollision, type ISolarPosition, type ISolarPositionInput, type ISourceAngleShadowInputs, type ISourceAngleShadowOptions, type ISpanProbeTarget, type ISpanSummary, type ISpanWindow, type ISpectralOceanCascade, type ISpectralOceanHeight, type ISpectralOceanOptions, type ISpriteAnimator3DOptions, type ISpriteFrame3D, IStageGpuReading, type IStaticTransformCensus, type IStrideReport, type ISurfaceCacheMaterial, type ISurfaceCacheOptions, type ISurfaceCacheReport, type ISurfaceCacheTexture, type ISurfaceLight, type ISurfaceLightsOptions, type IThreePoseBounds, type IThreePoseMeasurement, type ITracedHit, type ITracedRay, type ITracedReflectionsOptions, type ITracerPool3DOptions, type ITracerSpawnOptions, type IUnlitFoliageWarning, type IValidationReport, type IVirtualShadowOptions, type IVirtualShadowStats, type IWaterReflectionOptions, type IWaterSurfaceOptions, type IWaveFieldDomainWarp, type IWaveFieldGraphOptions, type IWaveFieldOptions, type IWaveFieldSample, type IWaveFieldWave, type IWorldEnvironmentOptions, type IWorldEnvironmentStageContext, type IWorldEnvironmentTarget, InstancedBatch, LAMP_SHADOW_MARKER, LUT_RESOLUTIONS, type LaunchFailureKind, type MatrixWorldMode, MatrixWorldPass, NEUTRAL_FLIGHT_MODIFIERS, type NormaliseAxis, OPACITY_IGNORED_MARKER, type OutputRenderer, PROBE_VOLUME_MARKER, PathFollow3D, ProbeVolume, type ProbeVolumeDensity, type QualityTier, RENDERLIST_VALIDATE_FLAG, RENDERLIST_VALIDATE_MARKER, type Recording, RenderListValidator, type ReplayPointer, RippleField, SCENE_WARNING_MARKER, SHADOW_FILTER_TIERS, SHADOW_STAGES, SPANS, SPANS_FLAG, SPANS_MARKER, SPAN_COUNT, SPAN_NAMES, STATIC_TRANSFORM_MARKER, type ScreenSpaceAA, ShadowFilterBudget, type ShadowFilterTier, SkeletalMesh3D, SkyCapture, SkyCaptureSchedule, SoftBody3D, type SpanId, SpanRecorder, SpectralOcean, SpriteAnimator3D, type SpritePlaybackMode, type SsgiQuality, SurfaceCache, SurfaceLights, type ThreePoseQuaternion, type ThreePoseVector, type TonemapMode, TracedReflections, TracerPool3D, UNLIT_FOLIAGE_FIX, UNLIT_FOLIAGE_MARKER, VIRTUAL_SHADOW_CASTER_LAYER, VIRTUAL_SHADOW_MARKER, VIRTUAL_SHADOW_MOVER_LAYER, VIRTUAL_SHADOW_WIDE_CASTER_LAYER, VirtualShadowNode, WaterSurface3D, type WaveDirection, WaveField, WorldEnvironment, addFoliageBackLight, addInSlices, addSpan, aerodynamicCoefficients, airDensity, aircraftMass, alwaysRender, attachToBone, attitudeAxes, beginSpan, boneContact, boneLengthDeviations, boneLengths, bvhIntersectFirstHit, clipBoneCoverage, clipPoseError, clipTrackBindings, createReplayDriver, debugFlag, describeSceneShape, describeSceneWarning, directionFromSolarPosition, directionalTransmittance, displayPeriodMs, endSpan, ev100FromCamera, ev100FromExposure, ev100FromLuminance, exposeDebug, exposureFromEv100, exposureSettings, formatSceneWarning, formatSpansWindow, formatUnlitFoliageWarning, formatValidationReport, gearClearance, installFilmicToneMapping, installSpanProbes, invalidateStatic, isStatic, lampPenumbraTangent, lampShadowMarker, loadAll, lookDiagnostics, markStatic, measureThreePose, mergeByMaterial, mergeParts, normaliseToMetres, onLaunchFailure, parseReplayRecording, penumbraUv, posedBounds, qualityPreset, qualityTiers, rayStruct, readGIMarker, readLampShadowMarker, readProbeVolumeObservation, readShadowTierMarker, readVirtualShadowMarker, refreshStaticTransforms, renderListValidationRequested, renderTrapAudit, replay, resetStaticTransforms, resolveAtmosphereLutResolutions, resolveAtmosphereParameters, sceneWarning, setAttitude, setSpanRecorder, skeletonBones, softCircleDataTexture, solarPosition, solarPositionAt, sourceAngleShadowFilter, sourceRadiusShadowFilter, spanNow, spanRecorder, spansRequested, staticTransformCensus, unlitFoliageWarning, unmarkStatic, updateAtmosphereParameters, updateClusteredMeshes, useRoughDiffuse, validateWorldMatrices, version, zenithTransmittance };
5981
+ export { ATLAS_PADDING, ATMOSPHERE_LUT_RESOLUTIONS, AnimationComposer, AnimationPlayer, Atmosphere, type AtmosphereDirection, AtmosphereLuts, type AtmosphereRgb, AutoExposureNode, Billboard3D, type BillboardLockAxis, BlendSpace1D, BlendSpace2D, BudgetLadder, type BudgetVerdict, type ChainStage, ClusteredBatch, ClusteredMesh, Daylight, ENVIRONMENT_TOO_SMALL_MARKER, EPIC_SSGI, type FinalGatherMethod, FlightModel, FluidField2D, FluidParticles3D, FramePassKind, GIBudget, type GIMethod, GIVisualize, type GIVisualizeMode, GI_METHODS, GI_VISUALIZE_MODES, GPUParticles3D, GPUSceneBVH, type GPUSceneBVHTraceFunction, GroundSnap, type IAddInSlicesOptions, type IAddInSlicesProgress, type IAddInSlicesReport, type IAircraftAirframe, type IAnimationComposerOptions, type IAnimationLayer, type IAnimationMask, type IAnimationMotionDelta, type IAnimationPlayOptions, type IAnimationPlayerOptions, type IAnimationRootMotionOptions, type IAnimationUpdateRateReport, type IAtmosphereLutResolution, type IAtmosphereLutResolutions, type IAtmosphereOptions, type IAtmosphereParameterPatch, type IAtmosphereParameters, type IAtmosphereScenePass, type IBillboard3DOptions, type IBoneContactReport, type IBoneLengthDeviation, type IBoneLengthDeviationReport, type IBoneLengthDeviationsOptions, type IBoneLengthSnapshot, type IBonePoseError, type IBudgetLadderOptions, type IBudgetWindow, type IClipBindingReport, type IClipCoverageReport, type IClipPoseErrorOptions, type IClipPoseErrorReport, type IClipPoseSubject, type IClipTrackBinding, type IClusterTable, type IClusteredBatchBuildOptions, type IClusteredBatchOptions, type IClusteredMeshOptions, type IClusteredPlacement, IComputeDriven$1 as IComputeDriven, type IDaylightOptions, type IEmitParticleRequest, type IExposureSettings, type IFlightAxes, type IFlightControls, type IFlightDeck, type IFlightEnvironment, type IFlightForces, type IFlightModelOptions, type IFlightModifiers, type IFlightQuaternion, type IFlightState, type IFlightVector3, type IFluidBounds, type IFluidCollider, type IFluidFieldOptions, type IFluidFieldSampler, type IFluidFieldVector2, type IFluidParticlesOptions, type IFluidParticlesStats, IFrameBudgetWindow, type IGIBudgetOptions, type IGIBudgetReport, type IGIVisualizeOptions, type IGPUParticles3DOptions, type IGPUParticles3DRuntime, type IGPUParticles3DSpawnBuffers, type IGPUParticles3DSpawnRequest, type IGPUParticles3DStats, IGPUReadbackSample, type IGPUSceneBVHMaterialGroup, type IGPUSceneBVHOptions, IGamePluginHooks, IGamePluginRuntime, type IGiTier, type IGroundSnapOptions, type IInstancedBatchBuildOptions, type IInstancedBatchOptions, type IInstancedPlacement, type ILampShadowStats, type ILaunchFailure, type ILoadAllOptions, type ILoadAllProgress, type IMatrixWorldReport, type IMeasureThreePoseOptions, type IMergeByMaterialOptions, type IMergePart, type IMergePartsOptions, type INormaliseToMetresOptions, type IPathFollow3DOptions, type IPathFollow3DProjection, type IPathFollow3DSample, type IProbeVolumeBakeProgress, type IProbeVolumeCoefficient, type IProbeVolumeObservation, type IProbeVolumeOptions, type IReflectionRoute, type IReplayOptions, type IReplayRecording, type IReplayRecordingSample, type IResolvedAtmosphereParameters, type IRippleFieldFlow, type IRippleFieldOptions, type ISceneShape, type ISceneWarning, type IShadowFilter, type IShadowFilterBudgetOptions, type IShadowFilterReport, type IShadowTier, type ISkeletalMesh3DOptions, type ISkyCaptureOptions, type ISoftBody3DOptions, type ISoftBodyCollision, type ISolarPosition, type ISolarPositionInput, type ISourceAngleShadowInputs, type ISourceAngleShadowOptions, type ISpanProbeTarget, type ISpanSummary, type ISpanWindow, type ISpectralOceanCascade, type ISpectralOceanHeight, type ISpectralOceanOptions, type ISpriteAnimator3DOptions, type ISpriteFrame3D, IStageGpuReading, type IStaticTransformCensus, type IStrideReport, type ISurfaceCacheMaterial, type ISurfaceCacheOptions, type ISurfaceCacheReport, type ISurfaceCacheTexture, type ISurfaceLight, type ISurfaceLightsOptions, type IThreePoseBounds, type IThreePoseMeasurement, type ITracedHit, type ITracedRay, type ITracedReflectionsOptions, type ITracerPool3DOptions, type ITracerSpawnOptions, type IUnlitFoliageWarning, type IValidationReport, type IVirtualShadowOptions, type IVirtualShadowStats, type IWaterReflectionOptions, type IWaterSurfaceOptions, type IWaveFieldDomainWarp, type IWaveFieldGraphOptions, type IWaveFieldOptions, type IWaveFieldSample, type IWaveFieldWave, type IWorldEnvironmentOptions, type IWorldEnvironmentStageContext, type IWorldEnvironmentTarget, InstancedBatch, LAMP_SHADOW_MARKER, LUT_RESOLUTIONS, type LaunchFailureKind, type MatrixWorldMode, MatrixWorldPass, NEUTRAL_FLIGHT_MODIFIERS, type NormaliseAxis, OPACITY_IGNORED_MARKER, type OutputRenderer, PROBE_VOLUME_MARKER, PathFollow3D, ProbeVolume, type ProbeVolumeDensity, type QualityTier, RENDERLIST_VALIDATE_FLAG, RENDERLIST_VALIDATE_MARKER, type Recording, RenderListValidator, type ReplayPointer, RippleField, SCENE_WARNING_MARKER, SHADOW_FILTER_TIERS, SHADOW_STAGES, SPANS, SPANS_FLAG, SPANS_MARKER, SPAN_COUNT, SPAN_NAMES, STATIC_TRANSFORM_MARKER, type ScreenSpaceAA, ShadowFilterBudget, type ShadowFilterTier, SkeletalMesh3D, SkyCapture, SkyCaptureSchedule, SoftBody3D, type SpanId, SpanRecorder, SpectralOcean, SpriteAnimator3D, type SpritePlaybackMode, type SsgiQuality, SurfaceCache, SurfaceLights, type ThreePoseQuaternion, type ThreePoseVector, type TonemapMode, TracedReflections, TracerPool3D, UNLIT_FOLIAGE_FIX, UNLIT_FOLIAGE_MARKER, VIRTUAL_SHADOW_CASTER_LAYER, VIRTUAL_SHADOW_MARKER, VIRTUAL_SHADOW_MOVER_LAYER, VIRTUAL_SHADOW_WIDE_CASTER_LAYER, VirtualShadowNode, WaterSurface3D, type WaveDirection, WaveField, WorldEnvironment, addFoliageBackLight, addInSlices, addSpan, aerodynamicCoefficients, airDensity, aircraftMass, alwaysRender, attachToBone, attitudeAxes, beginSpan, boneContact, boneLengthDeviations, boneLengths, bvhIntersectFirstHit, clipBoneCoverage, clipPoseError, clipTrackBindings, createReplayDriver, debugFlag, describeSceneShape, describeSceneWarning, directionFromSolarPosition, directionalTransmittance, displayPeriodMs, endSpan, ev100FromCamera, ev100FromExposure, ev100FromLuminance, exposeDebug, exposureFromEv100, exposureSettings, formatSceneWarning, formatSpansWindow, formatUnlitFoliageWarning, formatValidationReport, gearClearance, installFilmicToneMapping, installSpanProbes, invalidateStatic, isStatic, lampPenumbraTangent, lampShadowMarker, loadAll, lookDiagnostics, markStatic, measureThreePose, mergeByMaterial, mergeParts, normaliseToMetres, onLaunchFailure, parseReplayRecording, penumbraUv, posedBounds, qualityPreset, qualityTiers, rayStruct, readGIMarker, readLampShadowMarker, readProbeVolumeObservation, readShadowTierMarker, readVirtualShadowMarker, refreshStaticTransforms, renderListValidationRequested, renderTrapAudit, replay, resetStaticTransforms, resolveAtmosphereLutResolutions, resolveAtmosphereParameters, sceneWarning, setAttitude, setSpanRecorder, skeletonBones, softCircleDataTexture, solarPosition, solarPositionAt, sourceAngleShadowFilter, sourceRadiusShadowFilter, spanNow, spanRecorder, spansRequested, staticTransformCensus, thinCards, unlitFoliageWarning, unmarkStatic, updateAtmosphereParameters, updateClusteredMeshes, useRoughDiffuse, validateWorldMatrices, version, zenithTransmittance };