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
@@ -16,7 +16,8 @@
16
16
 
17
17
  import * as THREE from 'three';
18
18
  import { mergeGeometries } from 'three/examples/jsm/utils/BufferGeometryUtils.js';
19
- import { addOutlineAttributes } from './look';
19
+ import { outlinePartByPart, outlineMergedLater } from './look';
20
+ import { markKitHooks } from './kithooks';
20
21
 
21
22
  // Meters per screen pixel under the third-person camera, and under the far
22
23
  // overhead camera of the space decks.
@@ -535,14 +536,16 @@ function mergeBatch({ anchor, meshes, radius, castShadow }) {
535
536
  );
536
537
 
537
538
  // Outline normals are smoothed over vertices at one place, and are found
538
- // part by part, so parts that touch keep an outline between them.
539
- if (radius >= OUTLINE_MIN_RADIUS) {
540
- geometries.forEach(addOutlineAttributes);
541
- }
539
+ // part by part, so parts that touch keep an outline between them. `later`
540
+ // is where the parts lie, when the look bakes after the model is drawn.
541
+ const later = radius >= OUTLINE_MIN_RADIUS ? outlinePartByPart(geometries) : null;
542
542
  const geometry = mergeGeometries(geometries, false);
543
543
  if (!geometry) {
544
544
  return;
545
545
  }
546
+ if (later) {
547
+ outlineMergedLater(geometry, later);
548
+ }
546
549
  const material = meshes[0].material.clone();
547
550
  material.color.set('#ffffff');
548
551
  material.vertexColors = true;
@@ -689,6 +692,7 @@ function finishFromVertices(material) {
689
692
  .replace('#include <metalnessmap_fragment>', 'float metalnessFactor = vPartFinish.y;');
690
693
  };
691
694
  material.customProgramCacheKey = () => `part-finish|${previousKey.call(material)}`;
695
+ markKitHooks(material, previous, previousKey);
692
696
  }
693
697
 
694
698
  //
@@ -1,8 +1,8 @@
1
1
  // Pointer, wheel and right-button input for a scene that set `"engine": {
2
- // "camera": { "follow": "rigid", "control": "orbit" } }` (the kit's CLAUDE.md
2
+ // "camera": { "follow": "rigid", "control": "orbit" } }` (docs/engine-camera.md
3
3
  // has the terms): the player turns, tilts and zooms the Player's camera.
4
4
  // Scene3DPlayer's `attachInput` makes this the first time a pointer goes down
5
- // under the key or a Player runs under it (`runtime.orbitInput()`), hands
5
+ // under the key, Shift is pressed there, or a Player runs under it (`runtime.orbitInput()`), hands
6
6
  // each pointer that goes down under the key to it, and leaves every other one
7
7
  // to the handlers it always had. A runtime that never meets the key never
8
8
  // makes it.
@@ -12,7 +12,18 @@
12
12
  // in the right half turns and tilts the camera; two fingers that both
13
13
  // landed in the right half are a pinch, which zooms. The left half is the
14
14
  // stick's: a finger that lands there is never part of a pinch.
15
- // - mouse: a drag with any button turns and tilts; the wheel zooms.
15
+ // - mouse: a drag with any button turns and tilts; the wheel zooms. On a
16
+ // desktop the drag holds the pointer lock (Roblox's right-drag): a right
17
+ // press asks for it at once, any other button once the drag passes the
18
+ // tap slop, so a click is never locked. While locked the turn comes from
19
+ // movementX/Y; the lock ends with the drag (the last button up, a blur,
20
+ // the page hidden, a scene load, detach), and when the browser ends it
21
+ // (Escape, the host taking focus) the drag ends with no tap. Where the
22
+ // lock is missing or refused the drag goes on as before, on the pointer
23
+ // capture taken at the press (see `attachOrbitInput`).
24
+ // Shift or the desktop lock button keeps the lock until toggled off,
25
+ // Escape, blur, page hidden or a scene load. Then every mouse move turns,
26
+ // with no button needed; a quick left click still jumps.
16
27
  // - a short tap that did not move is a jump, as without the key (a mouse's
17
28
  // left button only).
18
29
  //
@@ -117,6 +128,12 @@ export function makeLookGestures(stick, onTap, tuning) {
117
128
  look,
118
129
  roleOf: (id) => pointers.get(id)?.role ?? null,
119
130
 
131
+ // A mouse move under shift lock needs no held pointer or tap slop.
132
+ turn(dx, dy) {
133
+ asked.yaw += (Number.isFinite(dx) ? dx : 0) * LOOK_RAD_PER_PX;
134
+ asked.pitch += (Number.isFinite(dy) ? dy : 0) * LOOK_RAD_PER_PX;
135
+ },
136
+
120
137
  // `at` is { x, y, time, mouse, button, left }: where (CSS px), when (ms),
121
138
  // whether it is a mouse and which button, and whether it is in the left
122
139
  // half of the canvas.
@@ -196,6 +213,15 @@ export function makeLookGestures(stick, onTap, tuning) {
196
213
  drop();
197
214
  },
198
215
 
216
+ // A mouse drag made a look at once (a second button pressed while it
217
+ // was still a tap): it will not jump.
218
+ drag(id) {
219
+ const p = pointers.get(id);
220
+ if (!p || !p.mouse || p.role !== 'tap') return;
221
+ p.moved = true;
222
+ p.role = 'look';
223
+ },
224
+
199
225
  // A wheel event's deltaY and deltaMode: away from the player is nearer.
200
226
  wheel(deltaY, deltaMode) {
201
227
  const px = deltaY * (deltaMode === 1 ? WHEEL_LINE_PX : deltaMode === 2 ? WHEEL_NOTCH_PX : 1);
@@ -222,8 +248,23 @@ export const isOrbitLook = (look) => ours.has(look);
222
248
  // pointer, listener or pending look here, and a pointer held across any load
223
249
  // does nothing more until it lifts: the handlers attachInput always had do
224
250
  // not know it either.
225
- export function attachOrbitInput(canvas, runtime, stick, onTap, tuning) {
251
+ //
252
+ // `onLost`, when given, is the canvas's own pointerup handler, for a
253
+ // pointer whose capture a lock of ours took (Scene3DPlayer passes its own,
254
+ // so a keyless pointer goes through the keyless path). It is handed the
255
+ // pointer's real pointerup or pointercancel when that lands beyond the
256
+ // canvas while the lock (or our request, or our exit) is on, and a made-up
257
+ // pointercancel for one whose lift was never seen at all. Without it these
258
+ // go to this input's own `up`.
259
+ export function attachOrbitInput(canvas, runtime, stick, onTap, tuning, onLost) {
226
260
  const gestures = makeLookGestures(stick, onTap, tuning);
261
+ const lift = (event) => {
262
+ if (onLost) onLost(event);
263
+ else input.up(event);
264
+ };
265
+ let control;
266
+ const lock = makeMouseLock(canvas, gestures, lift, () => control.update());
267
+ control = makeShiftLockControl(canvas, runtime, lock, () => input.shiftLock.toggle());
227
268
  let listening = false;
228
269
  const onWheel = (event) => {
229
270
  event.preventDefault();
@@ -237,20 +278,39 @@ export function attachOrbitInput(canvas, runtime, stick, onTap, tuning) {
237
278
  canvas.removeEventListener('contextmenu', onContextMenu);
238
279
  };
239
280
  gestures.look.listen = () => {
240
- if (listening || runtime.cameraControl !== 'orbit') return;
281
+ if (runtime.cameraControl !== 'orbit') return;
282
+ control.show();
283
+ if (listening) return;
241
284
  listening = true;
242
285
  canvas.addEventListener('wheel', onWheel, { passive: false });
243
286
  canvas.addEventListener('contextmenu', onContextMenu);
244
287
  };
245
288
  gestures.look.reset = () => {
246
289
  gestures.cancel();
290
+ lock.drop();
247
291
  unlisten();
292
+ control.hide();
248
293
  };
249
294
  ours.add(gestures.look);
250
295
  runtime.lookInput = gestures.look;
251
- return {
296
+ const input = {
297
+ shiftLock: {
298
+ get active() {
299
+ return lock.shiftLock.active;
300
+ },
301
+ toggle() {
302
+ if (runtime.cameraControl !== 'orbit') return;
303
+ control.useKeyboard();
304
+ control.show();
305
+ lock.shiftLock.toggle(control.available());
306
+ },
307
+ },
308
+ // Moves also belong here with no held pointer while shift lock is on.
309
+ get active() {
310
+ return gestures.busy || lock.shiftLock.active;
311
+ },
252
312
  // Whether a pointer that went down under the key is still down: its
253
- // moves and its lift are this file's.
313
+ // lift is this file's.
254
314
  get busy() {
255
315
  return gestures.busy;
256
316
  },
@@ -265,13 +325,465 @@ export function attachOrbitInput(canvas, runtime, stick, onTap, tuning) {
265
325
  button: event.button,
266
326
  left: event.clientX - rect.left < rect.width / 2,
267
327
  });
268
- canvas.setPointerCapture(event.pointerId);
328
+ // Under a lock a capture cannot be taken (InvalidStateError); the
329
+ // lock's end gives it (`lock.held`).
330
+ lock.held(event.pointerId, true);
331
+ lock.capture(event.pointerId);
332
+ lock.down(event);
269
333
  },
270
- move: (event) => gestures.move(event.pointerId, event.clientX, event.clientY),
271
- up: (event) => gestures.up(event.pointerId, performance.now(), event.type === 'pointercancel'),
334
+ move: (event) => lock.move(event) ?? gestures.move(event.pointerId, event.clientX, event.clientY),
335
+ up: (event) => {
336
+ const ours = gestures.up(event.pointerId, performance.now(), event.type === 'pointercancel');
337
+ lock.held(event.pointerId, false);
338
+ lock.up(event);
339
+ return ours;
340
+ },
341
+ // A pointer that went down or up on the canvas without the key
342
+ // (Scene3DPlayer's own handlers, in a runtime that has met the key): it
343
+ // is held, and gets its capture back when a lock of ours ends.
344
+ pointer: (event) => lock.held(event.pointerId, event.type === 'pointerdown'),
272
345
  detach: () => {
273
346
  gestures.cancel();
347
+ lock.drop();
274
348
  unlisten();
349
+ control.detach();
350
+ },
351
+ };
352
+ return input;
353
+ }
354
+
355
+ // Made only by an orbit input; its DOM appears after hardware keyboard input.
356
+ // It lives beside the canvas so it never enters the canvas's pointer path.
357
+ function makeShiftLockControl(canvas, runtime, lock, toggle) {
358
+ const doc = canvas.ownerDocument;
359
+ let media;
360
+ let button = null;
361
+ let keyboardInput = false;
362
+ let observing = false;
363
+ const view = doc?.defaultView;
364
+ const onKeyDown = (event) => {
365
+ if (event.isComposing || event.altKey || event.ctrlKey || event.metaKey ||
366
+ event.target?.isContentEditable || event.target?.closest?.('input, textarea, select')) return;
367
+ if (/^(Key[WASDEF]|Arrow(Up|Down|Left|Right)|Space|Enter|Tab|ShiftLeft|ShiftRight)$/.test(event.code)) {
368
+ keyboardInput = true;
369
+ show();
370
+ }
371
+ };
372
+ const onPointerDown = (event) => {
373
+ if (event.pointerType !== 'touch' && event.pointerType !== 'pen') return;
374
+ keyboardInput = false;
375
+ lock.drop();
376
+ show();
377
+ };
378
+ const unobserve = () => {
379
+ keyboardInput = false;
380
+ if (!observing) return;
381
+ view?.removeEventListener('keydown', onKeyDown, true);
382
+ view?.removeEventListener('pointerdown', onPointerDown, true);
383
+ observing = false;
384
+ };
385
+ const available = () => {
386
+ if (typeof canvas.requestPointerLock !== 'function' || typeof doc?.exitPointerLock !== 'function') return false;
387
+ media ??= doc.defaultView?.matchMedia?.('(hover: hover) and (pointer: fine)');
388
+ return media?.matches === true;
389
+ };
390
+ const update = () => {
391
+ if (button === null) return;
392
+ button.setAttribute('aria-pressed', String(lock.shiftLock.active));
393
+ button.style.color = lock.shiftLock.active ? '#7bd9ed' : '#e6e6e2';
394
+ button.style.background = lock.shiftLock.active ? 'rgba(32, 66, 74, 0.8)' : 'rgba(0, 0, 0, 0.45)';
395
+ };
396
+ const onDown = (event) => {
397
+ event.stopPropagation();
398
+ event.preventDefault();
399
+ };
400
+ const onClick = (event) => {
401
+ event.stopPropagation();
402
+ canvas.focus();
403
+ toggle();
404
+ };
405
+ function show() {
406
+ if (!observing) {
407
+ view?.addEventListener('keydown', onKeyDown, true);
408
+ view?.addEventListener('pointerdown', onPointerDown, true);
409
+ observing = true;
410
+ }
411
+ const visible = runtime.cameraControl === 'orbit' && keyboardInput && available();
412
+ if (visible && button === null && canvas.parentElement) {
413
+ button = doc.createElement('button');
414
+ button.type = 'button';
415
+ button.title = 'Shift lock (Shift)';
416
+ button.setAttribute('aria-label', button.title);
417
+ button.innerHTML = '<svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><rect x="5" y="10" width="14" height="11" rx="3"/><path d="M8 10V7a4 4 0 0 1 8 0v3"/><path d="M12 14v3"/></svg>';
418
+ Object.assign(button.style, {
419
+ position: 'absolute', right: '16px', bottom: '16px', width: '44px', height: '44px',
420
+ border: '1px solid rgba(230, 230, 226, 0.3)', borderRadius: '10px', padding: '0',
421
+ alignItems: 'center', justifyContent: 'center', cursor: 'pointer', zIndex: '1',
422
+ touchAction: 'none',
423
+ });
424
+ button.addEventListener('pointerdown', onDown);
425
+ button.addEventListener('click', onClick);
426
+ canvas.parentElement.appendChild(button);
427
+ update();
428
+ }
429
+ // Called every keyed frame: the style is written only when it changes.
430
+ const display = visible ? 'flex' : 'none';
431
+ if (button !== null && button.style.display !== display) button.style.display = display;
432
+ }
433
+ return {
434
+ available,
435
+ update,
436
+ useKeyboard() { keyboardInput = true; },
437
+ show,
438
+ hide() {
439
+ unobserve();
440
+ if (button !== null && button.style.display !== 'none') button.style.display = 'none';
441
+ },
442
+ detach() {
443
+ unobserve();
444
+ if (button === null) return;
445
+ button.removeEventListener('pointerdown', onDown);
446
+ button.removeEventListener('click', onClick);
447
+ button.remove();
448
+ button = null;
449
+ },
450
+ };
451
+ }
452
+
453
+ // The pointer lock a desktop mouse look-drag or shift lock holds under the key (only
454
+ // `pointerType === 'mouse'`; touch and pen never come here).
455
+ // Shift lock owns it from its toggle gesture until turned off or cancelled;
456
+ // the drag path never asks for it or releases it while that owner is on.
457
+ //
458
+ // - asked for: on a right-button press at once; for any other button once
459
+ // the drag passes the tap slop (it is a look then), or when a second
460
+ // button is pressed while it is still a tap. So a left tap still jumps
461
+ // and a click is never locked. At most once per drag.
462
+ // - while locked, the turn comes from movementX/Y at LOOK_RAD_PER_PX (the
463
+ // pointer's client position stands still under a lock); before it lands,
464
+ // and without it, from clientX/Y as always.
465
+ // - let go of (exitPointerLock): on the drag's pointerup (pointer events
466
+ // send it when the last button is up), a pointermove with no button
467
+ // down (a lost pointerup), the window's blur, the page hidden, a scene
468
+ // load (`reset`) and detach. The browser puts the cursor back where the
469
+ // lock began.
470
+ // - ended by the browser (Escape, the host page taking focus): the drag is
471
+ // let go of, no tap, so no look or stick is left held.
472
+ // - a lock of ours that lands when no drag wants it (the button came up
473
+ // first, the next press is still a tap, a scene load came between) is
474
+ // let go of as soon as it is known.
475
+ // - a lock that lands takes the capture of every pointer down on the
476
+ // canvas (the spec's implicit release), touch and keyless ones too, and
477
+ // a capture cannot be taken while it is on. So every pointer that went
478
+ // down on the canvas and has not come up (`held`; Scene3DPlayer reports
479
+ // the ones its keyless handlers take through `pointer`) gets its capture
480
+ // back when a lock of ours ends, however it ends: when its
481
+ // pointerlockchange comes, not when pointerLockElement clears (Chromium
482
+ // clears it inside exitPointerLock and sends the event later). One that
483
+ // lifts beyond the canvas meanwhile is caught by the document (capture
484
+ // phase) and its own pointerup handed to its own handler, so a tap
485
+ // still jumps; one whose lift was never seen and cannot be captured
486
+ // again is let go of as a pointercancel would be. Both through `onLost`.
487
+ // - missing (no requestPointerLock: iOS, old browsers), throwing, its
488
+ // promise rejecting (a sandbox without allow-pointer-lock, Chrome's
489
+ // refusal of a re-lock just after Escape) or pointerlockerror: that drag
490
+ // goes on unlocked, on the pointer capture `down` took, so a drag that
491
+ // leaves the frame keeps turning and its release outside still ends it.
492
+ // The next drag asks again.
493
+ //
494
+ // Listeners, each only while it is needed: the window's blur and the
495
+ // document's visibilitychange while a mouse button or shift lock is held under the key;
496
+ // pointerlockchange while a drag has asked or shift lock wants it, and while our exit's event has
497
+ // not come (so the captures can be given back, a scene load between or
498
+ // not); the document's pointerup and pointercancel (capture phase) while a
499
+ // request of ours is on its way, the lock is ours, or our exit's event has
500
+ // not come; and, where requestPointerLock returns no promise (old Safari), while a request is on its way, with pointerlockerror
501
+ // too. A request that returns a promise is followed by the promise alone,
502
+ // so a scene load with one on its way leaves no listener behind, and a
503
+ // pointerlockerror (which does not say whose it is) is not taken for ours
504
+ // then. Without a promise an error may be another element's, so ours is
505
+ // still watched for SETTLE_MS after one.
506
+ const SETTLE_MS = 1000;
507
+
508
+ function makeMouseLock(canvas, gestures, lift, onShiftChange) {
509
+ const doc = canvas.ownerDocument ?? null;
510
+ const win = doc?.defaultView ?? null;
511
+ const supported = () => doc !== null && typeof canvas.requestPointerLock === 'function' && typeof doc.exitPointerLock === 'function';
512
+ // The mouse pointer down under the key: { id, x, y, asked, failed, had }.
513
+ // x, y is where the gestures last saw it (moved by movementX/Y while
514
+ // locked); `had` is whether it held the lock.
515
+ let drag = null;
516
+ // Intent while asking, and mode on only once the lock actually lands.
517
+ let shiftWanted = false;
518
+ let shiftOn = false;
519
+ // Our request on its way: { promise, timer }, or null.
520
+ let request = null;
521
+ // exitPointerLock called and its pointerlockchange not yet come. Not read
522
+ // off pointerLockElement: Chromium clears that inside the call and sends
523
+ // the event after. (If the event never came, `exitTimer` stands in.)
524
+ let exiting = false;
525
+ let exitTimer = null;
526
+ const on = { change: false, error: false, away: false, 'away-window': false, stray: false };
527
+ const locked = () => doc !== null && doc.pointerLockElement === canvas;
528
+ const wanted = () => shiftWanted || (drag !== null && drag.asked && !drag.failed);
529
+ const ours = () => locked() && !exiting;
530
+ // Every pointer down on the canvas, with the key or without: a lock that
531
+ // lands takes their captures (the Pointer Events spec's implicit release),
532
+ // and when a lock of ours ends each gets it back.
533
+ const down = new Set();
534
+ // Whether the lock now on (or just let go of) is ours.
535
+ let had = false;
536
+ // Whether the pointer is captured (or the capture could not be checked).
537
+ const capture = (id) => {
538
+ try {
539
+ canvas.setPointerCapture(id);
540
+ } catch {
541
+ // Not down any more (NotFoundError), or the lock still on.
542
+ return false;
543
+ }
544
+ return typeof canvas.hasPointerCapture !== 'function' || canvas.hasPointerCapture(id) !== false;
545
+ };
546
+ const release = () => {
547
+ if (!locked() || exiting) return;
548
+ exiting = true;
549
+ had = true;
550
+ try {
551
+ doc.exitPointerLock();
552
+ } catch {
553
+ exiting = false;
554
+ return;
555
+ }
556
+ clearTimeout(exitTimer);
557
+ exitTimer = setTimeout(() => {
558
+ exitTimer = null;
559
+ if (exiting && !locked()) onChange();
560
+ }, SETTLE_MS);
561
+ };
562
+ const toggle = (name, want, target, type, fn, options) => {
563
+ if (on[name] === want) return;
564
+ on[name] = want;
565
+ for (const t of type) (want ? target.addEventListener : target.removeEventListener).call(target, t, fn, options);
566
+ };
567
+ const sync = () => {
568
+ if (doc === null) return;
569
+ const eventOnly = request !== null && !request.promise;
570
+ // shiftWanted stays true for the whole time shiftOn is true too.
571
+ const away = drag !== null || shiftWanted;
572
+ toggle('change', eventOnly || exiting || shiftWanted || (drag !== null && drag.asked), doc, ['pointerlockchange'], onChange);
573
+ toggle('stray', request !== null || had || exiting, doc, ['pointerup', 'pointercancel'], onStray, true);
574
+ toggle('error', eventOnly, doc, ['pointerlockerror'], onError);
575
+ toggle('away', away, doc, ['visibilitychange'], onAway);
576
+ if (win !== null) toggle('away-window', away, win, ['blur'], onAway);
577
+ };
578
+ const endShift = () => {
579
+ if (!shiftWanted && !shiftOn) return;
580
+ shiftWanted = false;
581
+ shiftOn = false;
582
+ drag = null;
583
+ gestures.cancel();
584
+ onShiftChange();
585
+ };
586
+ // The drag ends with no tap: what it asked of the camera stays, the
587
+ // pointer is this file's no more.
588
+ const letGo = () => {
589
+ const id = drag.id;
590
+ drag = null;
591
+ gestures.up(id, performance.now(), true);
592
+ };
593
+ const done = (r) => {
594
+ if (request !== r) return false;
595
+ clearTimeout(r.timer);
596
+ request = null;
597
+ return true;
598
+ };
599
+ const failed = () => {
600
+ if (!locked() && shiftWanted) endShift();
601
+ if (drag !== null && drag.asked && !locked()) drag.failed = true;
602
+ sync();
603
+ };
604
+ // One owner: shift lock keeps it across mouse presses and releases.
605
+ const landed = () => {
606
+ if (locked()) {
607
+ had = true;
608
+ if (shiftWanted) {
609
+ shiftOn = true;
610
+ onShiftChange();
611
+ } else if (wanted()) drag.had = true;
612
+ else release();
613
+ }
614
+ sync();
615
+ };
616
+ const ask = () => {
617
+ if (!wanted() || shiftOn || drag?.had) return;
618
+ if (ours()) {
619
+ landed();
620
+ return;
621
+ }
622
+ // A request on its way, or our own exit not yet done: what settles it
623
+ // asks again if this drag still wants the lock.
624
+ if (request !== null || exiting) return;
625
+ let result;
626
+ try {
627
+ result = canvas.requestPointerLock();
628
+ } catch {
629
+ failed();
630
+ return;
631
+ }
632
+ const r = { promise: typeof result?.then === 'function', timer: null };
633
+ request = r;
634
+ if (r.promise) {
635
+ result.then(
636
+ () => {
637
+ if (done(r)) {
638
+ if (locked()) landed();
639
+ else failed();
640
+ }
641
+ },
642
+ () => {
643
+ if (done(r)) failed();
644
+ }
645
+ );
646
+ }
647
+ };
648
+ function onChange() {
649
+ if (locked()) {
650
+ if (request !== null && !request.promise) done(request);
651
+ landed();
652
+ return;
653
+ }
654
+ exiting = false;
655
+ clearTimeout(exitTimer);
656
+ exitTimer = null;
657
+ if (shiftOn) endShift();
658
+ if (had) {
659
+ had = false;
660
+ // One that cannot have it back came up while the lock had its
661
+ // capture, and its lift was not seen even by the document: it is let
662
+ // go of as a pointercancel would (the stick idles, no tap).
663
+ for (const id of [...down]) {
664
+ if (down.has(id) && !capture(id)) {
665
+ down.delete(id);
666
+ lift({ type: 'pointercancel', pointerId: id });
667
+ }
668
+ }
669
+ }
670
+ if (drag !== null && drag.had) letGo();
671
+ else ask();
672
+ sync();
673
+ }
674
+ function onError() {
675
+ const r = request;
676
+ if (r === null || r.promise) return;
677
+ // Maybe another element's: this drag goes on unlocked, and ours is
678
+ // still watched for a while in case it lands after all.
679
+ failed();
680
+ r.timer ??= setTimeout(() => {
681
+ if (!done(r)) return;
682
+ // A shift lock asked for meanwhile waited on this request, which never
683
+ // landed: it is off, so the next toggle asks again.
684
+ if (shiftWanted && !locked()) endShift();
685
+ sync();
686
+ }, SETTLE_MS);
687
+ }
688
+ // A held pointer lifted beyond the canvas while a lock of ours could have
689
+ // its capture: its own handler gets its own event, as the capture would
690
+ // have given it.
691
+ function onStray(event) {
692
+ if (event.target === canvas || !down.has(event.pointerId)) return;
693
+ lift(event);
694
+ }
695
+ function onAway(event) {
696
+ if (event.type === 'visibilitychange' && doc.visibilityState !== 'hidden') return;
697
+ endShift();
698
+ if (drag !== null) letGo();
699
+ release();
700
+ sync();
701
+ }
702
+ const want = () => {
703
+ if (drag.asked) return;
704
+ drag.asked = true;
705
+ ask();
706
+ sync();
707
+ };
708
+ return {
709
+ shiftLock: {
710
+ get active() {
711
+ return shiftOn;
712
+ },
713
+ toggle(available) {
714
+ if (shiftWanted || shiftOn) {
715
+ endShift();
716
+ release();
717
+ } else if (available && supported() && !exiting) {
718
+ // Never defer a shift-lock request until an unlock event: the
719
+ // request must run here, in the user's keydown or click gesture.
720
+ shiftWanted = true;
721
+ if (drag !== null) letGo();
722
+ ask();
723
+ }
724
+ sync();
725
+ },
726
+ },
727
+ capture,
728
+ held(id, isDown) {
729
+ if (isDown) down.add(id);
730
+ else down.delete(id);
731
+ },
732
+ down(event) {
733
+ if (event.pointerType !== 'mouse' || doc === null) return;
734
+ if (shiftWanted || shiftOn) return;
735
+ // One mouse: a press while another is held lost its pointerup.
736
+ if (drag !== null && drag.id !== event.pointerId) gestures.up(drag.id, performance.now(), true);
737
+ drag = { id: event.pointerId, x: event.clientX, y: event.clientY, asked: false, failed: false, had: false };
738
+ if (event.button === 2 && supported()) want();
739
+ else release();
740
+ sync();
741
+ },
742
+ // Undefined for a pointer that is not the drag: the caller hands it to
743
+ // the gestures as always.
744
+ move(event) {
745
+ if (shiftOn && event.pointerType === 'mouse') {
746
+ if (ours()) gestures.turn(event.movementX, event.movementY);
747
+ // A missing pointerup still lets go of a press, without ending
748
+ // shift lock or making that press a look-drag.
749
+ if (event.buttons === 0) gestures.up(event.pointerId, performance.now(), true);
750
+ return true;
751
+ }
752
+ if (drag === null || event.pointerId !== drag.id) return undefined;
753
+ if (event.buttons === 0) {
754
+ // Every button is up and no pointerup came.
755
+ letGo();
756
+ release();
757
+ sync();
758
+ return true;
759
+ }
760
+ if (ours()) {
761
+ drag.x += Number.isFinite(event.movementX) ? event.movementX : 0;
762
+ drag.y += Number.isFinite(event.movementY) ? event.movementY : 0;
763
+ } else {
764
+ drag.x = event.clientX;
765
+ drag.y = event.clientY;
766
+ }
767
+ const result = gestures.move(drag.id, drag.x, drag.y);
768
+ // A second button pressed while the drag is held (a chord comes as a
769
+ // pointermove): a tap no more, and the lock is asked for.
770
+ if (event.button >= 0 && (event.buttons & (event.buttons - 1)) !== 0) gestures.drag(drag.id);
771
+ if (gestures.roleOf(drag.id) === 'look' && supported()) want();
772
+ else if (!wanted()) release();
773
+ return result;
774
+ },
775
+ up(event) {
776
+ if (drag === null || event.pointerId !== drag.id) return;
777
+ drag = null;
778
+ release();
779
+ sync();
780
+ },
781
+ // Every pointer was let go of (a scene load, detach): so is the lock.
782
+ drop() {
783
+ endShift();
784
+ drag = null;
785
+ release();
786
+ sync();
275
787
  },
276
788
  };
277
789
  }
@@ -0,0 +1,48 @@
1
+ // The orbit camera's lens (`"engine": { "camera": { "follow": "rigid",
2
+ // "control": "orbit" } }`): a vertical field of view of `engine.camera.fov`
3
+ // degrees (10 to 120; anything else, or none, is ORBIT_FOV, Roblox's 70)
4
+ // while a scene with the key plays.
5
+ //
6
+ // `fitOrbitLens` sets it on each frame of a keyed scene (world3d.js
7
+ // `renderWorld`), keeping the lens the camera had when the key first met it
8
+ // (`world.orbitLens`). `giveBackOrbitLens` gives that lens back, exactly, and
9
+ // keeps nothing after; it runs when the keyed scene goes, before any code of
10
+ // what follows can run: on every scene load (the physics system's `reset`,
11
+ // at the start of `load`, before the new scene's data is in), on an editor's
12
+ // frame (`renderWorld` with no runtime) and on `disposeWorld`. So a keyless
13
+ // scene's own code always starts from the lens the camera had before the
14
+ // key, and whatever field of view it sets stands: no keyless frame looks at
15
+ // the camera. A keyed scene after a keyed scene takes the lens again on its
16
+ // first frame. A world that never played the key has no `orbitLens` and none
17
+ // of this touches its camera.
18
+ //
19
+ // No imports: systems/physics3d.js and the tests load it alone.
20
+ export const ORBIT_FOV = 70;
21
+
22
+ export function orbitFov(data) {
23
+ const fov = data?.engine?.camera?.fov;
24
+ return typeof fov === 'number' && fov >= 10 && fov <= 120 ? fov : ORBIT_FOV;
25
+ }
26
+
27
+ // One frame of a keyed scene: the lens it asks for, on the world's camera.
28
+ export function fitOrbitLens(world, runtime) {
29
+ const camera = world.camera;
30
+ world.orbitLens ??= { fov: camera.fov };
31
+ const fov = orbitFov(runtime.data);
32
+ if (camera.fov !== fov) {
33
+ camera.fov = fov;
34
+ camera.updateProjectionMatrix();
35
+ }
36
+ }
37
+
38
+ // The keyed scene has gone: the lens the camera had before it, back.
39
+ export function giveBackOrbitLens(world) {
40
+ const lens = world?.orbitLens;
41
+ if (!lens) return;
42
+ world.orbitLens = null;
43
+ const camera = world.camera;
44
+ if (camera && camera.fov !== lens.fov) {
45
+ camera.fov = lens.fov;
46
+ camera.updateProjectionMatrix();
47
+ }
48
+ }