@threenative/core 0.3.11 → 0.3.13

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 (236) hide show
  1. package/README.md +1 -1
  2. package/capabilities.json +1988 -204
  3. package/dist/{assets-YUbXa3-Y.d.ts → assets-CfMKnOsK.d.ts} +78 -1
  4. package/dist/camera-shake-CZKOfGn4.d.ts +46 -0
  5. package/dist/{canvas-layer-vCtanIeB.d.ts → canvas-layer-G7ttVy7y.d.ts} +1 -1
  6. package/dist/chunk-4SRAQFTU.js +133 -0
  7. package/dist/chunk-CFGTPFUH.js +231 -0
  8. package/dist/chunk-DIPIJICH.js +8916 -0
  9. package/dist/chunk-EEABDLUC.js +2237 -0
  10. package/dist/chunk-EFWZWLPY.js +1895 -0
  11. package/dist/chunk-GXY7B3JG.js +46 -0
  12. package/dist/chunk-GYUZJQ7U.js +280 -0
  13. package/dist/chunk-H4J6IAJE.js +504 -0
  14. package/dist/chunk-KIRUKTBQ.js +187 -0
  15. package/dist/chunk-QWJEMUUT.js +94 -0
  16. package/dist/chunk-SV4QVUTQ.js +31 -0
  17. package/dist/chunk-U4YHUKKL.js +615 -0
  18. package/dist/chunk-VP43GIWW.js +18 -0
  19. package/dist/chunk-XDTZ4QMO.js +160 -0
  20. package/dist/default-tone-mapping-GgKPTiBP.d.ts +4 -0
  21. package/dist/{game-DzMcitDO.d.ts → game-k8K3hZai.d.ts} +85 -9
  22. package/dist/hot.d.ts +5 -4
  23. package/dist/hot.js +5 -52
  24. package/dist/index.d.ts +633 -1351
  25. package/dist/index.js +12873 -23068
  26. package/dist/{model-lod-CTpZ6imz.d.ts → model-lod-DPTzeCcD.d.ts} +35 -3
  27. package/dist/playtest.d.ts +5 -4
  28. package/dist/playtest.js +25 -75
  29. package/dist/quality-BYqKGAwo.d.ts +868 -0
  30. package/dist/react-css.js +1 -215
  31. package/dist/react.d.ts +3 -2
  32. package/dist/render-environment.d.ts +170 -0
  33. package/dist/render-environment.js +352 -0
  34. package/dist/{renderer-rZm0hVqq.d.ts → renderer-BtOSseYf.d.ts} +42 -35
  35. package/dist/spells/index.d.ts +643 -0
  36. package/dist/spells/index.js +1558 -0
  37. package/dist/spells/ultra/index.d.ts +1600 -0
  38. package/dist/spells/ultra/index.js +6804 -0
  39. package/dist/terrain-jobs-worker.js +1 -123
  40. package/dist/two-sided-foliage-W523J3UM.js +1 -0
  41. package/dist/ui-layer.js +6 -384
  42. package/dist/worker.js +13 -43
  43. package/dist/world.d.ts +988 -268
  44. package/dist/world.js +17464 -18290
  45. package/mcp/animation-server.mjs +1 -1
  46. package/mcp/animation.mjs +2 -3
  47. package/mcp/engine-server.mjs +245 -52
  48. package/mcp/servers.mjs +10 -3
  49. package/mcp/terrain.mjs +8 -0
  50. package/package.json +19 -7
  51. package/patches/three@0.187.0-prd269-upgrade.patch +2102 -0
  52. package/patches/three@0.187.0.patch +2004 -407
  53. package/src/animation-batch.ts +193 -0
  54. package/src/animation-layers.ts +7 -3
  55. package/src/animation.ts +209 -29
  56. package/src/asset-cache.ts +3 -3
  57. package/src/asset-memo.ts +202 -0
  58. package/src/assets.ts +437 -125
  59. package/src/auto-batch.ts +190 -44
  60. package/src/card-lod.ts +152 -0
  61. package/src/compressed-texture-preparation.ts +1008 -0
  62. package/src/compute-driven.ts +1 -1
  63. package/src/config.ts +8 -0
  64. package/src/debug.ts +103 -22
  65. package/src/dev-global.ts +54 -0
  66. package/src/engine-hooks.ts +37 -0
  67. package/src/frame-budget.ts +50 -23
  68. package/src/game-boot-phase.ts +269 -0
  69. package/src/game-dev-tools.ts +86 -0
  70. package/src/game-frame-loop.ts +958 -0
  71. package/src/game-renderer-metrics.ts +77 -0
  72. package/src/game-startup.ts +1076 -0
  73. package/src/game-ui.ts +84 -0
  74. package/src/game-validate.ts +70 -0
  75. package/src/game.ts +198 -2264
  76. package/src/gamepad-mappings.ts +269 -0
  77. package/src/generated/console-markers.ts +13 -0
  78. package/src/geometry-capture.ts +28 -4
  79. package/src/gpu-readings.ts +98 -0
  80. package/src/gpu-scene-bvh.ts +149 -36
  81. package/src/hot.ts +4 -7
  82. package/src/index.ts +141 -9
  83. package/src/input.ts +237 -25
  84. package/src/instanced-batch-lod.ts +3 -8
  85. package/src/interpolation.ts +171 -40
  86. package/src/launch-diagnostics.ts +22 -12
  87. package/src/look/ao-admission.ts +25 -0
  88. package/src/look/auto-exposure.ts +5 -16
  89. package/src/look/default-tone-mapping.ts +41 -5
  90. package/src/look/filmic-tone-mapping.ts +15 -13
  91. package/src/look/local-exposure.ts +2 -7
  92. package/src/look/look-diagnostics.ts +3 -3
  93. package/src/look/quad-pass.ts +21 -0
  94. package/src/look/quality.ts +14 -5
  95. package/src/look/unreal-bloom.ts +4 -13
  96. package/src/look/world-environment.ts +113 -103
  97. package/src/loop.ts +29 -0
  98. package/src/merge-parts.ts +20 -24
  99. package/src/model-lod.ts +139 -17
  100. package/src/particle-kinds.ts +515 -0
  101. package/src/particle-significance.ts +12 -0
  102. package/src/particles.ts +19 -10
  103. package/src/picking.ts +17 -3
  104. package/src/platform.ts +23 -4
  105. package/src/playtest.ts +27 -1
  106. package/src/profiling/FrameStages.ts +5 -6
  107. package/src/profiling/Spans.ts +3 -17
  108. package/src/profiling/debug-telemetry.ts +2 -6
  109. package/src/profiling/render-list-validate.ts +6 -15
  110. package/src/projection-apply.ts +4 -1
  111. package/src/projection-marker.ts +2 -1
  112. package/src/projection-plan.ts +9 -6
  113. package/src/quiet-markers.ts +3 -10
  114. package/src/render/cpu-bvh.ts +100 -0
  115. package/src/render/depth-pyramid.ts +6 -14
  116. package/src/render/environment/environmentContribution.ts +202 -0
  117. package/src/render/environment/environmentRadiance.ts +44 -0
  118. package/src/render/environment/environmentSampleCache.ts +56 -0
  119. package/src/render/environment/environmentSampling.ts +201 -0
  120. package/src/render/environment/environmentSnapshot.ts +71 -0
  121. package/src/render/environment/gate.ts +57 -0
  122. package/src/render/mesh-pool.ts +4 -20
  123. package/src/render/probe-trace.ts +872 -0
  124. package/src/render/probe-volume.ts +780 -34
  125. package/src/render/radiance-cache.ts +17 -0
  126. package/src/render/resolution-subrect.ts +2 -0
  127. package/src/render/rough-diffuse.ts +46 -12
  128. package/src/render/soft-shadow.ts +27 -12
  129. package/src/render/virtual-shadow-adaptive.ts +55 -0
  130. package/src/render/virtual-shadow-casters.ts +175 -0
  131. package/src/render/virtual-shadow-layers.ts +76 -0
  132. package/src/render/virtual-shadow-level.ts +224 -0
  133. package/src/render/virtual-shadow-markers.ts +193 -0
  134. package/src/render/virtual-shadow-options.ts +370 -0
  135. package/src/render/virtual-shadow-pages.ts +5 -0
  136. package/src/render/virtual-shadow-partial.ts +13 -0
  137. package/src/render/virtual-shadow.ts +231 -1008
  138. package/src/render/world-impostor-surface.ts +402 -40
  139. package/src/render/world-impostor.ts +5 -2
  140. package/src/render-camera-cull.ts +98 -3
  141. package/src/render-environment.ts +41 -0
  142. package/src/render-pass-budget.ts +34 -7
  143. package/src/renderProjection.ts +22 -0
  144. package/src/renderer-config.ts +36 -0
  145. package/src/renderer-facts.ts +37 -0
  146. package/src/renderer.ts +144 -65
  147. package/src/resolution-scaler.ts +3 -2
  148. package/src/scene-entry-inspectors.ts +61 -0
  149. package/src/snow-field.ts +2 -1
  150. package/src/spells/cast-pool.ts +361 -0
  151. package/src/spells/index.ts +177 -0
  152. package/src/spells/mechanisms.ts +295 -0
  153. package/src/spells/reaction-field.ts +415 -0
  154. package/src/spells/spell-lights.ts +139 -0
  155. package/src/spells/spell-world.ts +187 -0
  156. package/src/spells/spell.ts +397 -0
  157. package/src/spells/spells.ts +283 -0
  158. package/src/spells/ultra/engine/camera.ts +184 -0
  159. package/src/spells/ultra/engine/quality.ts +96 -0
  160. package/src/spells/ultra/index.ts +52 -0
  161. package/src/spells/ultra/main.ts +305 -0
  162. package/src/spells/ultra/scene/arenaMaterial.ts +325 -0
  163. package/src/spells/ultra/spells/cast.ts +233 -0
  164. package/src/spells/ultra/spells/fire.ts +1267 -0
  165. package/src/spells/ultra/vfx/FluidVolume.ts +816 -0
  166. package/src/spells/ultra/vfx/FluidVolume.tsl.ts +855 -0
  167. package/src/spells/ultra/vfx/FxTarget.ts +61 -0
  168. package/src/spells/ultra/vfx/GroundField.ts +1399 -0
  169. package/src/spells/ultra/vfx/Particles.ts +1475 -0
  170. package/src/spells/ultra/vfx/Ribbons.ts +645 -0
  171. package/src/spells/ultra/vfx/Shockwaves.ts +286 -0
  172. package/src/spells/ultra/vfx/Volumes.ts +489 -0
  173. package/src/spells/ultra/vfx/common.ts +1195 -0
  174. package/src/spells/ultra/vfx/noise.ts +441 -0
  175. package/src/startup-offscreen-bytes.ts +78 -0
  176. package/src/startup-readiness.ts +128 -34
  177. package/src/static-transform.ts +25 -19
  178. package/src/streamed-textures.ts +112 -0
  179. package/src/streaming.ts +68 -4
  180. package/src/texture-streaming.ts +331 -0
  181. package/src/version.ts +1 -1
  182. package/src/warmup.ts +56 -8
  183. package/src/water-surface.ts +9 -3
  184. package/src/worker.ts +12 -2
  185. package/src/world-bundle-safety.ts +446 -0
  186. package/src/world-cell-batches.ts +1178 -0
  187. package/src/world-cell-chunks.ts +1128 -0
  188. package/src/world-cell-data.ts +995 -0
  189. package/src/world-cell-impostors.ts +1461 -0
  190. package/src/world-cell-lod-bias.ts +151 -0
  191. package/src/world-cell-models.ts +1074 -0
  192. package/src/world-cell-options.ts +177 -0
  193. package/src/world-cell-placements.ts +798 -0
  194. package/src/world-cell-prewarm.ts +592 -0
  195. package/src/world-cell-readiness.ts +357 -0
  196. package/src/world-cell-records.ts +401 -0
  197. package/src/world-cell-render-bundles.ts +459 -0
  198. package/src/world-cell-render-gpu-dress.ts +710 -0
  199. package/src/world-cell-render-main-cull.ts +540 -0
  200. package/src/world-cell-render-shadow-claims.ts +198 -0
  201. package/src/world-cell-render-util.ts +259 -0
  202. package/src/world-cell-render.ts +1501 -0
  203. package/src/world-cell-residency.ts +754 -0
  204. package/src/world-cell-stale.ts +238 -0
  205. package/src/world-cells.ts +1335 -10418
  206. package/src/world-chunk-shadow.ts +308 -0
  207. package/src/world-collar.ts +315 -0
  208. package/src/world-gpu-flags.ts +131 -0
  209. package/src/world-gpu-readback.ts +881 -0
  210. package/src/world-gpu-reference.ts +524 -0
  211. package/src/world-gpu-scene.ts +256 -2286
  212. package/src/world-gpu-shadow.ts +203 -0
  213. package/src/world-gpu-types.ts +409 -0
  214. package/src/world-gpu-validation.ts +518 -0
  215. package/src/world-heightfield.ts +802 -0
  216. package/src/world-load-limiter.ts +111 -0
  217. package/src/world-model-sections.ts +80 -0
  218. package/src/world-noise.ts +241 -0
  219. package/src/world-package.ts +42 -0
  220. package/src/world-region.ts +1 -1
  221. package/src/world-river-ribbon.ts +282 -0
  222. package/src/world-root-frame.ts +39 -0
  223. package/src/world-shore-field.ts +91 -0
  224. package/src/world-static-pose.ts +163 -0
  225. package/src/world-surface-sampler.ts +48 -0
  226. package/src/world-terrain-splat.ts +361 -153
  227. package/src/world-tile-budget.ts +249 -0
  228. package/src/world-tile-geometry.ts +469 -0
  229. package/src/world-tile-lod.ts +408 -0
  230. package/src/world-tile-observation.ts +566 -0
  231. package/src/world-tile-stitch.ts +166 -0
  232. package/src/world-tiles.ts +247 -1755
  233. package/src/world-validate.ts +6 -14
  234. package/src/world-warm.ts +51 -0
  235. package/src/world-water-bodies.ts +359 -0
  236. package/src/world.ts +48 -741
@@ -1,5 +1,5 @@
1
- import { Camera, Object3D, Mesh, BufferGeometry } from 'three';
2
- import { I as IRendererLike, a as IFrameBudgetWindow, b as IFrameBudgetSimulation } from './renderer-rZm0hVqq.js';
1
+ import { Camera, Object3D, Mesh, BufferGeometry, Sphere } from 'three';
2
+ import { I as IRendererLike, a as IFrameBudgetWindow, b as IFrameBudgetSimulation } from './renderer-BtOSseYf.js';
3
3
 
4
4
  /** One simulation that can yield its compute work. */
5
5
  interface IBudgetCandidate {
@@ -173,13 +173,45 @@ declare function lodPixelScale(camera: Camera, viewportHeight: number, depth: nu
173
173
  declare const DISCRETE_LOD_DEFAULT_ERROR_PIXELS = 1;
174
174
  /** Default coarsen hysteresis when no resolved policy reaches the loader. */
175
175
  declare const DISCRETE_LOD_DEFAULT_HYSTERESIS = 0.15;
176
+ /**
177
+ * One baked chain: LOD0 is the mesh's own geometry, then one derived geometry per level sharing the
178
+ * same vertex attributes and differing only in index.
179
+ *
180
+ * A chain belongs to the geometry, not to the mesh, because `Object3D.clone()` — which is how a game
181
+ * reuses an imported model, and what `SkeletonUtils.clone` does for a rig — copies the mesh but
182
+ * *shares* its geometry. Keying selection to mesh identity would silently drop every clone to LOD0
183
+ * forever; recovering the chain from the geometry the clone carries is what makes a clone behave
184
+ * like the source.
185
+ */
186
+ interface ILodChain {
187
+ readonly levels: BufferGeometry[];
188
+ readonly errors: readonly number[];
189
+ readonly base: BufferGeometry;
190
+ /** Local-space bounds of the base, shared by every mesh over the chain; the mesh matrix is not. */
191
+ readonly sphere: Sphere;
192
+ }
176
193
  /** Resolved runtime policy the loader stamps onto a controller, from the manifest. */
177
194
  interface IModelLodPolicy {
178
195
  readonly hysteresis: number;
179
196
  readonly maxPixelError: number;
180
197
  }
198
+ /** True while a geometry is a streamed coarse companion the full model has not replaced yet. */
199
+ declare function isStreamedGeometry(geometry: BufferGeometry): boolean;
181
200
  /** The LOD0 geometry of a mesh under a discrete chain, or the mesh's own geometry otherwise. */
182
201
  declare function baseGeometryOf(mesh: Mesh): BufferGeometry;
202
+ /**
203
+ * The chain registered against `geometry`, or `undefined` when the geometry carries none.
204
+ *
205
+ * For a caller that draws one geometry many times. A `ModelLod` swaps one mesh's geometry, so an
206
+ * instanced batch — which cannot swap a geometry per instance — derives levels of its own from these
207
+ * numbers and crosses between them by distance instead. Selection stays here: this reads the chain
208
+ * out and hands it over, and the caller does the arithmetic {@link projectedLodError} documents, with
209
+ * a screen-space error budget of its own — a batch's placements are all at different distances, so
210
+ * the budget the loader registered the chain with, which is calibrated for the one mesh it drives,
211
+ * is not the one that applies. Any level of a chain answers, since a clone may be carrying a derived
212
+ * geometry.
213
+ */
214
+ declare function lodChainOf(geometry: BufferGeometry): ILodChain | undefined;
183
215
  /**
184
216
  * Takes every discrete-LOD mesh under `root` through this frame's selection.
185
217
  *
@@ -194,4 +226,4 @@ declare function updateModelLods(root: {
194
226
  traverse(callback: (object: object) => void): void;
195
227
  }, camera: Camera, viewportHeight: number): number;
196
228
 
197
- export { ComputeDrivenRegistry as C, DISCRETE_LOD_DEFAULT_ERROR_PIXELS as D, GPUReadback as G, type IComputeDriven as I, type ILodView as a, type IModelLodPolicy as b, type IGPUReadbackSample as c, type IBudgetCandidate as d, DISCRETE_LOD_DEFAULT_HYSTERESIS as e, type IGPUReadbackOptions as f, baseGeometryOf as g, lodPixelScale as l, updateModelLods as u };
229
+ export { ComputeDrivenRegistry as C, DISCRETE_LOD_DEFAULT_ERROR_PIXELS as D, GPUReadback as G, type IComputeDriven as I, type IGPUReadbackSample as a, type ILodView as b, type IModelLodPolicy as c, type IBudgetCandidate as d, DISCRETE_LOD_DEFAULT_HYSTERESIS as e, type IGPUReadbackOptions as f, baseGeometryOf as g, lodPixelScale as h, isStreamedGeometry as i, lodChainOf as l, updateModelLods as u };
@@ -1,11 +1,12 @@
1
1
  import { JsonValue, JsonPrimitive } from '@threenative/playtest/protocol';
2
2
  export { PLAYTEST_CLOCK_GLOBAL } from '@threenative/playtest/protocol';
3
- import { a as IGamePluginHooks } from './game-DzMcitDO.js';
4
- import './assets-YUbXa3-Y.js';
3
+ import { a as IGamePluginHooks } from './game-k8K3hZai.js';
4
+ import './assets-CfMKnOsK.js';
5
5
  import 'three';
6
- import './renderer-rZm0hVqq.js';
6
+ import './renderer-BtOSseYf.js';
7
7
  import 'three/webgpu';
8
- import './canvas-layer-vCtanIeB.js';
8
+ import './default-tone-mapping-GgKPTiBP.js';
9
+ import './canvas-layer-G7ttVy7y.js';
9
10
  import 'zustand/vanilla';
10
11
 
11
12
  /**
package/dist/playtest.js CHANGED
@@ -1,79 +1,14 @@
1
+ import { PIPELINE_CENSUS_CAPABILITY, discardEngineCountsSinceLastFrame, readRenderChainObservation, CORE_VERSION } from './chunk-EEABDLUC.js';
2
+ import { GEOMETRY_CAPTURE_CAPABILITY } from './chunk-EFWZWLPY.js';
3
+ import './chunk-GYUZJQ7U.js';
4
+ import { audioRuntimeSnapshot } from './chunk-U4YHUKKL.js';
5
+ import './chunk-XDTZ4QMO.js';
6
+ import './chunk-VP43GIWW.js';
1
7
  import { requestedPlaytestClockMode, assertJsonSafe, PLAYTEST_PROTOCOL_LIMITS } from '@threenative/playtest/protocol';
2
8
  export { PLAYTEST_CLOCK_GLOBAL } from '@threenative/playtest/protocol';
3
9
  import { installThreePlaytestBridge } from '@threenative/playtest/three';
4
- import { Sphere, Vector3, Object3D } from 'three';
10
+ import { Object3D } from 'three';
5
11
 
6
- // src/playtest.ts
7
- var AUDIO_STATE = /* @__PURE__ */ Symbol.for("threenative.audio.runtime");
8
- function audioState() {
9
- const host = globalThis;
10
- const existing = host[AUDIO_STATE];
11
- if (existing !== void 0) return existing;
12
- const created = { buses: /* @__PURE__ */ new Set(), cueCounts: /* @__PURE__ */ new Map(), cueLog: [] };
13
- host[AUDIO_STATE] = created;
14
- return created;
15
- }
16
- function audioRuntimeSnapshot() {
17
- let queued = 0;
18
- let voices = 0;
19
- let pooled = 0;
20
- let paused = 0;
21
- const unsupported = /* @__PURE__ */ new Set();
22
- const state = audioState();
23
- for (const bus of state.buses) {
24
- queued += bus.queued;
25
- voices += bus.voices;
26
- pooled += bus.pooled;
27
- paused += bus.pausedVoices;
28
- for (const option of bus.unsupported) unsupported.add(option);
29
- }
30
- return {
31
- cues: Object.fromEntries(state.cueCounts),
32
- paused,
33
- pooled,
34
- queued,
35
- recentCues: state.cueLog.map((entry) => ({ ...entry })),
36
- unsupported: [...unsupported].sort(),
37
- voices
38
- };
39
- }
40
- var GEOMETRY_CAPTURE_CAPABILITY = "runtime.geometry";
41
- new Sphere();
42
- new Vector3();
43
- new Vector3();
44
-
45
- // src/version.ts
46
- var CORE_VERSION = "0.3.11";
47
-
48
- // src/pipeline-census.ts
49
- var PIPELINE_CENSUS_CAPABILITY = "runtime.pipelineCensus";
50
-
51
- // src/profiling/FrameCounters.ts
52
- function discardEngineCountsSinceLastFrame(host = globalThis) {
53
- host.__tnEngineCounterRebase?.();
54
- }
55
-
56
- // src/render/chain.ts
57
- var REPORT_KEY = /* @__PURE__ */ Symbol.for("threenative.renderChain.report");
58
- function storedReport(target) {
59
- return target[REPORT_KEY];
60
- }
61
- function readRenderChainReport(renderer) {
62
- if (!isObject(renderer)) return void 0;
63
- const raw = readRawRenderer(renderer);
64
- return storedReport(renderer) ?? (isObject(raw) ? storedReport(raw) : void 0);
65
- }
66
- function readRenderChainObservation(renderer) {
67
- return readRenderChainReport(renderer)?.applied;
68
- }
69
- function readRawRenderer(renderer) {
70
- return "raw" in renderer ? renderer.raw : renderer;
71
- }
72
- function isObject(value) {
73
- return typeof value === "object" && value !== null;
74
- }
75
-
76
- // src/playtest.ts
77
12
  var currentAgent = typeof navigator === "undefined" ? "node" : navigator.userAgent;
78
13
  function playtest(options = {}) {
79
14
  let dispose;
@@ -211,14 +146,22 @@ function playtest(options = {}) {
211
146
  installRuntimeChannels(installation.bridge, runtime);
212
147
  if (runnerAnnounced()) {
213
148
  runtime?.enableRuntimeDiagnostics?.();
214
- if (!wallClock) runtime?.freezeClock?.();
149
+ if (!wallClock)
150
+ runtime?.freezeClock?.(
151
+ shouldHoldUntilAttached(options) && runtime.settleClock !== void 0 ? 0 : void 0
152
+ );
215
153
  }
216
154
  dispose = installation.dispose;
217
155
  attached = holdUntilAttached(
218
156
  installation.bridge,
219
157
  options,
220
158
  () => startSceneEntered,
221
- runtime?.startSceneLoaded
159
+ runtime?.startSceneLoaded,
160
+ // The live mode, not the one this setup started with: a run that switched to the wall
161
+ // clock mid-run measures frames, and a settle would re-freeze the loop it just released.
162
+ () => {
163
+ if (clockMode !== "wall-clock") runtime?.settleClock?.();
164
+ }
222
165
  );
223
166
  const cleanup = () => {
224
167
  if (!clockDisposed && clockRuntime?._setClockMode !== void 0)
@@ -273,7 +216,7 @@ function runnerAnnounced() {
273
216
  const host = globalThis;
274
217
  return host[PLAYTEST_RUNNER_EXPECTED_GLOBAL] === true || host.TN_PLAYTEST_ENDPOINT !== void 0;
275
218
  }
276
- function holdUntilAttached(bridge, options, startSceneEntered, startSceneLoaded) {
219
+ function holdUntilAttached(bridge, options, startSceneEntered, startSceneLoaded, settleClock) {
277
220
  if (!shouldHoldUntilAttached(options)) return void 0;
278
221
  const timeoutMs = options.attachTimeoutMs ?? PLAYTEST_ATTACH_TIMEOUT_MS;
279
222
  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
@@ -281,6 +224,12 @@ function holdUntilAttached(bridge, options, startSceneEntered, startSceneLoaded)
281
224
  }
282
225
  const describe = bridge.describe;
283
226
  const applySetup = bridge.applySetup;
227
+ let worldSettled = false;
228
+ const settle = () => {
229
+ if (worldSettled) return;
230
+ worldSettled = true;
231
+ settleClock?.();
232
+ };
284
233
  return new Promise((resolve, reject) => {
285
234
  let settled = false;
286
235
  const timer = setTimeout(() => {
@@ -320,6 +269,7 @@ function holdUntilAttached(bridge, options, startSceneEntered, startSceneLoaded)
320
269
  bridge.describe = async () => {
321
270
  release();
322
271
  await startSceneEntered();
272
+ settle();
323
273
  return describe();
324
274
  };
325
275
  });