castle-web-cli 0.4.232 → 0.4.234

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 (587) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,232 @@
1
+ // Lifecycle owns the mode. Syncs and three.js listeners cannot enter it.
2
+ const bindings = new WeakMap();
3
+ const EVENTS = ['added', 'removed', 'childadded', 'childremoved'];
4
+
5
+ // Called only by the player after a keyed scene load has completed. A
6
+ // keyless player never calls this, binds a system, or allocates mode state.
7
+ export function prepareEmptyNodes(world, runtime) {
8
+ if (world.emptyNodesBlocked || world.emptyPass || world.emptyNodes?.dispatchDepth || world.disposed || world.skipEmptyNodesOff || !runtime.skipsEmptyNodes) return;
9
+ world.emptyNodesOwned = true;
10
+ world.emptyNodesBlocked = true;
11
+ try {
12
+ let bound = bindings.get(world);
13
+ if (bound?.runtime !== runtime) {
14
+ forgetEmptyNodes(world, true);
15
+ if (world.disposed) return;
16
+ bound = { runtime };
17
+ bindings.set(world, bound);
18
+ const reset = () => {
19
+ if (bindings.get(world) === bound) forgetEmptyNodes(world, true);
20
+ };
21
+ runtime.registerSystem({ reset, dispose: reset });
22
+ }
23
+ if (world.emptyNodes) return;
24
+ const state = { runtime, records: new Map(), dirty: new Set(), identity: sceneIsIdentity(world.scene), depth: 0, dispatchDepth: 0, draining: false };
25
+ world.emptyNodes = state;
26
+ state.sceneChanged = event => {
27
+ if (state.records.has(event.child)) state.dirty.add(event.child);
28
+ };
29
+ state.restoreDispatch = bracketDispatch(world.scene, state);
30
+ for (const event of ['childadded', 'childremoved']) world.scene.addEventListener(event, state.sceneChanged);
31
+ for (const entry of world.nodes.values()) watchEmptyNode(world, entry);
32
+ } finally {
33
+ delete world.emptyNodesBlocked;
34
+ }
35
+ }
36
+
37
+ // The player's load latch brackets the WHOLE load, including other systems'
38
+ // reset callbacks before our system is reached. Worlds that never asked do
39
+ // not call it.
40
+ export function loadEmptyScene(world, runtime, load) {
41
+ const blocked = world.emptyNodesBlocked;
42
+ world.emptyNodesBlocked = true;
43
+ try {
44
+ forgetEmptyNodes(world, true);
45
+ return load(runtime);
46
+ } finally {
47
+ if (blocked) world.emptyNodesBlocked = true;
48
+ else delete world.emptyNodesBlocked;
49
+ }
50
+ }
51
+
52
+ // Only keyed objects get a dispatch bracket. Preserve singleton event fields
53
+ // and cover ALL listeners, including a later listener that syncs or throws.
54
+ function bracketDispatch(node, state) {
55
+ const restorers = [];
56
+ // add/remove also bracket the child's added/removed dispatch, which three
57
+ // runs BEFORE the parent's child event. A throw there still queues dirty.
58
+ for (const method of ['dispatchEvent', 'add', 'remove']) {
59
+ const own = Object.getOwnPropertyDescriptor(node, method);
60
+ const original = node[method];
61
+ const bracket = function (...args) {
62
+ state.dispatchDepth++;
63
+ try { return original.apply(this, args); }
64
+ finally {
65
+ state.dispatchDepth--;
66
+ if (method !== 'dispatchEvent') {
67
+ if (state.records.has(node)) state.dirty.add(node);
68
+ else for (const child of args) if (state.records.has(child)) state.dirty.add(child);
69
+ }
70
+ }
71
+ };
72
+ node[method] = bracket;
73
+ restorers.push(() => {
74
+ if (node[method] !== bracket) return;
75
+ if (own) Object.defineProperty(node, method, own);
76
+ else delete node[method];
77
+ });
78
+ }
79
+ return () => { for (const restore of restorers) restore(); };
80
+ }
81
+
82
+ export const EMPTY_PASS_ABORTED = Symbol('empty actor pass invalidated');
83
+
84
+ // The active outer pass holds its original state even after reset deletes it.
85
+ export function checkEmptyPass(world, state = world.emptyPass) {
86
+ if (world.disposed || world.emptyNodes !== state) throw EMPTY_PASS_ABORTED;
87
+ }
88
+
89
+ // Detached matrices are world space only for an identity scene.
90
+ function sceneIsIdentity(scene) {
91
+ const p = scene.position;
92
+ const q = scene.quaternion;
93
+ const s = scene.scale;
94
+ if (scene.parent || p.x || p.y || p.z || q.x || q.y || q.z || q.w !== 1 || s.x !== 1 || s.y !== 1 || s.z !== 1) return false;
95
+ if (!scene.matrixAutoUpdate) {
96
+ const e = scene.matrix.elements;
97
+ for (let i = 0; i < 16; i++) if (e[i] !== (i % 5 === 0 ? 1 : 0)) return false;
98
+ }
99
+ return scene.matrixWorldAutoUpdate === true;
100
+ }
101
+
102
+ export function watchEmptyNode(world, entry) {
103
+ const state = world.emptyNodes;
104
+ const node = entry.node;
105
+ if (state.records.has(node)) return;
106
+ const record = { entry, restoreDispatch: bracketDispatch(node, state), changed: () => {
107
+ state.dirty.add(node);
108
+ } };
109
+ state.records.set(node, record);
110
+ for (const event of EVENTS) node.addEventListener(event, record.changed);
111
+ state.dirty.add(node);
112
+ }
113
+
114
+ function unwatch(node, record) {
115
+ for (const event of EVENTS) node.removeEventListener(event, record.changed);
116
+ record.restoreDispatch();
117
+ delete node.emptyDetached;
118
+ }
119
+
120
+ export function releaseEmptyNode(world, node) {
121
+ const state = world.emptyNodes;
122
+ const record = state.records.get(node);
123
+ if (!record) return;
124
+ unwatch(node, record);
125
+ state.records.delete(node);
126
+ state.dirty.delete(node);
127
+ }
128
+
129
+ // Adoption is a one-time engine point; settled static roots are never visited.
130
+ export function freezeEmptyNode(world, node) {
131
+ if (node.emptyDetached) updateEmptyNode(node);
132
+ }
133
+
134
+ export function updateEmptyNode(node) {
135
+ node.updateMatrixWorld();
136
+ if (node.freezes !== undefined && node.freezes === node.skipping.epoch && node.frozenAt !== node.skipping.epoch) node.updateMatrixWorld();
137
+ }
138
+
139
+ function reconcile(world, state, node, record) {
140
+ if (world.nodes.get(node.userData.actorId) !== record.entry) return;
141
+ if (node.children.length === 0 && state.identity) {
142
+ if (node.parent === world.scene) {
143
+ node.emptyDetached = true;
144
+ world.scene.remove(node);
145
+ checkEmptyPass(world, state);
146
+ // Removal listeners can move the scene. A detached local matrix is
147
+ // no longer world space then, so restore this node before proceeding.
148
+ if (!sceneIsIdentity(world.scene)) {
149
+ delete node.emptyDetached;
150
+ if (!node.parent) world.scene.add(node);
151
+ checkEmptyPass(world, state);
152
+ } else if (!node.parent && !node.children.length) updateEmptyNode(node);
153
+ }
154
+ } else if (node.emptyDetached) {
155
+ delete node.emptyDetached;
156
+ // A consumer's deliberate hiding/reparenting remains its own.
157
+ if (!node.parent) world.scene.add(node);
158
+ checkEmptyPass(world, state);
159
+ }
160
+ }
161
+
162
+ // Only at the START of an outermost sync, never on its way out. Events fired
163
+ // in the body wait for the next sync. A dispatch bracket defers reentrant
164
+ // syncs without trusting event.target, which a throwing listener can strand.
165
+ export function syncEmptyNodes(world, state) {
166
+ if (state.draining || state.dispatchDepth) return;
167
+ checkEmptyPass(world, state);
168
+ const identity = sceneIsIdentity(world.scene);
169
+ if (identity !== state.identity) {
170
+ state.identity = identity;
171
+ for (const node of state.records.keys()) state.dirty.add(node);
172
+ }
173
+ if (state.dirty.size === 0) return;
174
+ const pending = [...state.dirty];
175
+ state.dirty.clear();
176
+ state.draining = true;
177
+ let index = 0;
178
+ try {
179
+ for (; index < pending.length; index++) {
180
+ const node = pending[index];
181
+ const record = state.records.get(node);
182
+ if (record) reconcile(world, state, node, record);
183
+ checkEmptyPass(world, state);
184
+ // Both removal and attachment run foreign listeners. Recheck before
185
+ // the next detach, and revisit earlier detached roots in this pass.
186
+ const identity = sceneIsIdentity(world.scene);
187
+ if (identity !== state.identity) {
188
+ state.identity = identity;
189
+ for (const node of state.records.keys()) pending.push(node);
190
+ }
191
+ }
192
+ } catch (error) {
193
+ if (!world.disposed && world.emptyNodes === state) {
194
+ for (; index < pending.length; index++) state.dirty.add(pending[index]);
195
+ }
196
+ throw error;
197
+ } finally {
198
+ state.draining = false;
199
+ }
200
+ }
201
+
202
+ export function forgetEmptyNodes(world, restore = false) {
203
+ const state = world.emptyNodes;
204
+ if (!state) return;
205
+ // Guard the entire restore, including reentrant loads from consumer code.
206
+ const blocked = world.emptyNodesBlocked;
207
+ world.emptyNodesBlocked = true;
208
+ delete world.emptyNodes;
209
+ state.draining = true;
210
+ const restoreNodes = [];
211
+ for (const [node, record] of state.records) {
212
+ if (restore && node.emptyDetached) restoreNodes.push([node, record.entry]);
213
+ unwatch(node, record);
214
+ }
215
+ for (const event of ['childadded', 'childremoved']) world.scene.removeEventListener(event, state.sceneChanged);
216
+ state.restoreDispatch();
217
+ let failed = null;
218
+ try {
219
+ for (const [node, entry] of restoreNodes) {
220
+ if (world.disposed) break;
221
+ if (!node.parent && world.nodes.get(node.userData.actorId) === entry) {
222
+ try { world.scene.add(node); } catch (error) { failed ??= { error }; }
223
+ }
224
+ }
225
+ } finally {
226
+ state.records.clear();
227
+ state.dirty.clear();
228
+ if (blocked) world.emptyNodesBlocked = true;
229
+ else delete world.emptyNodesBlocked;
230
+ }
231
+ if (failed) throw failed.error;
232
+ }
@@ -0,0 +1,99 @@
1
+ // The player's clock: which animation frames run a frame, and the dt each one
2
+ // that runs is handed. Without a cap (`runtime.maxFps` 0) every animation
3
+ // frame runs and is handed the time since the last one, at most 0.033 s, as
4
+ // the loop always did. With `"engine": { "maxFps": n }` (docs/engine-frame-cap.md
5
+ // has the terms) a frame runs only once at least RUN_SHARE of 1/n seconds has
6
+ // passed since the last frame that ran -- by time, never by counting frames --
7
+ // and is handed all the time since that frame, so nothing skipped is lost:
8
+ // neither time (up to what physics can step, below) nor input (a key pressed
9
+ // and let go, or a drag begun and ended, between two frames that run is lent
10
+ // to the next one, `updateLending`).
11
+
12
+ import { prepareModelConsumers } from './modelready.js';
13
+
14
+ // The longest step a frame is handed without a cap, in seconds.
15
+ export const MAX_DT = 0.033;
16
+
17
+ // The longest step a capped frame is handed: three of the physics system's
18
+ // fixed 1/60 s steps (`systems/physics3d.js`). It steps at most four a frame
19
+ // and throws away whatever is left once it has taken four, so a frame handed
20
+ // more than 3/60 s, on top of the less than 1/60 s it may carry over, could
21
+ // leave physics behind the behaviours' clock. A cap of 30 (the lowest there
22
+ // is) has frames 1/30 s apart, under this; it cuts only a late frame, as
23
+ // MAX_DT does without a cap.
24
+ export const MAX_CAPPED_DT = 3 / 60;
25
+
26
+ // The share of the cap's interval that must have passed. A refresh timestamp
27
+ // only ever lands on the display's own vsync, so the rule picks a whole number
28
+ // of refreshes per frame, and RUN_SHARE decides which: at 60 the threshold is
29
+ // 13.0 ms, which a 60 Hz display passes on every refresh even with timestamps
30
+ // 1.8 ms early or late; 75 Hz (13.3 ms) too; 90, 120 and 144 Hz every second
31
+ // refresh (11.1, 8.3 and 6.9 ms do not pass, twice that does): 45, 60 and 72
32
+ // fps; 165 and 180 Hz every third, 240 Hz every fourth: 55, 60, 60 fps. Each
33
+ // is a steady cadence, one dt every frame. It sits between the multiples of
34
+ // the common refresh periods (11.1, 12.1 and 12.5 ms below it, 13.3 and 13.9
35
+ // above), not on one, where a display would alternate.
36
+ export const RUN_SHARE = 0.78;
37
+
38
+ export function makeFrameClock(now) {
39
+ return { previousTime: now, ran: false };
40
+ }
41
+
42
+ // The dt for the animation frame at `now` (its requestAnimationFrame
43
+ // timestamp), or null when it is skipped. The first frame a clock sees always
44
+ // runs.
45
+ export function nextFrame(clock, now, maxFps) {
46
+ if (maxFps > 0 && clock.ran && now - clock.previousTime < (RUN_SHARE * 1000) / maxFps) return null;
47
+ const dt = Math.min(maxFps > 0 ? MAX_CAPPED_DT : MAX_DT, (now - clock.previousTime) / 1000);
48
+ clock.previousTime = now;
49
+ clock.ran = true;
50
+ return dt;
51
+ }
52
+
53
+ // What the input handlers keep for the next frame that runs, under a cap
54
+ // only: every key that went down (`keys`, codes and key names as
55
+ // `runtime.keys` holds them) and the drag stick's last direction while a
56
+ // drag held it (`stick`). Without a cap the handlers write nothing here.
57
+ export function makeInputLatch() {
58
+ return { keys: new Set(), stick: null };
59
+ }
60
+
61
+ // Runs `runtime.update(dt)` for a capped frame with what went down since the
62
+ // last frame that ran lent to it: a key in `latch.keys` that is no longer held
63
+ // is in `runtime.keys` for this update, and when no drag holds the stick now,
64
+ // the last direction a drag gave it since that frame is in
65
+ // `runtime.moveInput`. Afterwards both are as the handlers left them: lent
66
+ // keys come out of `runtime.keys` and a lent stick goes back to rest. The latch is emptied
67
+ // either way. So a press shorter than the frames that were skipped is seen
68
+ // by exactly one frame, as it would have been without the cap; a key held
69
+ // across it is seen as held, as always. A tap's jump, the grab key and the
70
+ // hub's buttons are latches or handlers of their own and lose nothing.
71
+ export function updateLending(runtime, latch, dt) {
72
+ const keys = runtime.keys;
73
+ const move = runtime.moveInput;
74
+ const lent = [];
75
+ for (const code of latch.keys) {
76
+ if (keys.has(code)) continue;
77
+ keys.add(code);
78
+ lent.push(code);
79
+ }
80
+ latch.keys.clear();
81
+ const stick = latch.stick && move && !move.active ? latch.stick : null;
82
+ latch.stick = null;
83
+ if (stick) {
84
+ move.active = true;
85
+ move.x = stick.x;
86
+ move.y = stick.y;
87
+ }
88
+ try {
89
+ prepareModelConsumers(runtime.three, runtime);
90
+ runtime.update(dt);
91
+ } finally {
92
+ for (const code of lent) keys.delete(code);
93
+ if (stick) {
94
+ move.active = false;
95
+ move.x = 0;
96
+ move.y = 0;
97
+ }
98
+ }
99
+ }
@@ -0,0 +1,140 @@
1
+ import * as RAPIER from './rapier.js';
2
+ import { assertFrozenEqual, frozenState } from './frozenstatics.js';
3
+
4
+ export class FrozenPhysics {
5
+ constructor(system, scene) {
6
+ this.system = system;
7
+ this.scene = scene;
8
+ this.owner = scene.frozenActors;
9
+ this.pending = this.owner.consumer(undefined, () => {
10
+ this.dispose();
11
+ if (system.frozenPhysics === this) system.frozenPhysics = null;
12
+ }, true);
13
+ // Only unsafe or exposed actors need unconditional per-frame visits.
14
+ // Observed writes arrive through pending; awake dynamics come from Rapier.
15
+ this.moving = new Map();
16
+ this.settling = new Map();
17
+ this.sampled = new Map();
18
+ // Rapier's active island list does not include a newly created/woken body
19
+ // until the next step. Keep it pending until its first pre-step snapshot.
20
+ this.newDynamics = new Map();
21
+ this.exposed = new Set();
22
+ }
23
+
24
+ forgetMotion(id, entry) {
25
+ for (const cache of [this.settling, this.sampled, this.newDynamics]) {
26
+ if (entry === undefined || cache.get(id) === entry) cache.delete(id);
27
+ }
28
+ }
29
+
30
+ forgetBody(id) {
31
+ this.forgetMotion(id);
32
+ this.moving.delete(id);
33
+ this.exposed.delete(id);
34
+ }
35
+
36
+ active() {
37
+ const entries = new Map();
38
+ this.system.world.forEachActiveRigidBody(body => {
39
+ if (body.bodyType() !== RAPIER.RigidBodyType.Dynamic || body.isSleeping()) return;
40
+ const entry = this.system.bodies.get(body.userData);
41
+ if (entry?.body.handle === body.handle) entries.set(body.userData, entry);
42
+ });
43
+ return entries;
44
+ }
45
+
46
+ // Rapier supplies awake dynamics. The last moving pose is sampled once
47
+ // more after sleep, so interpolation settles exactly as in the full loop.
48
+ stepEntries() {
49
+ const entries = new Map([...this.settling, ...this.newDynamics, ...this.active()]);
50
+ this.newDynamics.clear();
51
+ for (const [id, entry] of entries) {
52
+ if (this.system.bodies.get(id) !== entry || entry.body.bodyType() !== RAPIER.RigidBodyType.Dynamic) {
53
+ this.forgetMotion(id, entry);
54
+ entries.delete(id);
55
+ continue;
56
+ }
57
+ this.sampled.set(id, entry);
58
+ }
59
+ return entries.values();
60
+ }
61
+
62
+ simulate(dt) {
63
+ const { system, scene } = this;
64
+ this.sampled.clear();
65
+ const actors = new Set(this.pending.take(false));
66
+ for (const actor of this.moving.values()) actors.add(actor);
67
+ for (const id of this.active().keys()) {
68
+ const actor = scene.getActor(id);
69
+ if (actor) actors.add(actor);
70
+ }
71
+ const live = [];
72
+ const ordered = [...actors].sort((a, b) => (a.components.Layout?.z ?? 0) - (b.components.Layout?.z ?? 0) ||
73
+ (this.owner.records.get(a)?.order ?? -1) - (this.owner.records.get(b)?.order ?? -1));
74
+ for (const actor of ordered) {
75
+ if (scene.getActor(actor.id) !== actor || scene.isActorSleeping(actor) || !actor.components.Transform) {
76
+ if (scene.getActor(actor.id) && scene.getActor(actor.id) !== actor) continue;
77
+ system.removeBody(actor.id);
78
+ this.moving.delete(actor.id);
79
+ this.settling.delete(actor.id);
80
+ continue;
81
+ }
82
+ const previous = system.bodies.get(actor.id);
83
+ const entry = system.bodyFor(actor);
84
+ const type = entry.body.bodyType();
85
+ if (type === RAPIER.RigidBodyType.Dynamic && (entry !== previous || !entry.body.isSleeping())) this.newDynamics.set(actor.id, entry);
86
+ if (type !== RAPIER.RigidBodyType.Dynamic) this.forgetMotion(actor.id);
87
+ const unsafe = this.owner.records.get(actor)?.componentsUnsafe || this.exposed.has(actor.id);
88
+ if (unsafe) this.moving.set(actor.id, actor);
89
+ else this.moving.delete(actor.id);
90
+ live.push(actor);
91
+ if (system.frozenPhysicsVisits) system.frozenPhysicsVisits(actor);
92
+ }
93
+ system.pushUnchanged(live);
94
+ system.step(dt);
95
+ const dynamic = new Map([...this.settling, ...this.sampled, ...this.active()]);
96
+ for (const actor of live) {
97
+ const entry = system.bodies.get(actor.id);
98
+ if (entry?.body.bodyType() === RAPIER.RigidBodyType.Dynamic) dynamic.set(actor.id, entry);
99
+ }
100
+ const write = [];
101
+ for (const [id, entry] of dynamic) {
102
+ const actor = scene.getActor(id);
103
+ if (!actor || system.bodies.get(id) !== entry) continue;
104
+ write.push(actor);
105
+ const prev = entry.prev;
106
+ const p = entry.body.translation(), q = entry.body.rotation();
107
+ if (prev && (prev.x !== p.x || prev.y !== p.y || prev.z !== p.z || prev.qx !== q.x || prev.qy !== q.y || prev.qz !== q.z || prev.qw !== q.w)) this.settling.set(id, entry);
108
+ else this.settling.delete(id);
109
+ }
110
+ write.sort((a, b) => (a.components.Layout?.z ?? 0) - (b.components.Layout?.z ?? 0) || this.owner.records.get(a).order - this.owner.records.get(b).order);
111
+ this.owner.writingPhysics++;
112
+ try { system.writeBack({ getActors: () => write }); }
113
+ finally { this.owner.writingPhysics--; }
114
+ if (scene.three?.auditFrozenStatics === true) this.audit();
115
+ system.dispatchCallbacks(scene);
116
+ }
117
+
118
+ audit() {
119
+ const { system, scene } = this;
120
+ const before = bodyState(system);
121
+ const all = scene.getActors();
122
+ system.reconcileUnchanged(all);
123
+ system.pushUnchanged(all);
124
+ assertFrozenEqual(before, bodyState(system), 'body signatures/poses');
125
+ }
126
+
127
+ dispose() {
128
+ this.pending.dispose();
129
+ this.moving.clear();
130
+ this.settling.clear();
131
+ this.sampled.clear();
132
+ this.newDynamics.clear();
133
+ this.exposed.clear();
134
+ }
135
+ }
136
+
137
+ function bodyState(system) {
138
+ return frozenState([...system.bodies].map(([id, entry]) =>
139
+ [id, entry.sig, entry.body.bodyType(), entry.body.translation(), entry.body.rotation()]));
140
+ }