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,194 @@
1
+ import { Color, Fog } from 'three';
2
+
3
+ // A hub game's fallback picture. It is deliberately only a clear colour and
4
+ // Three's built-in linear fog: no mesh, texture, shader or render pass. The
5
+ // fog begins before the engine's 60 m ground reaches its edge, while leaving
6
+ // enough distance for an ordinary door game's whole yard.
7
+ export const DEFAULT_SKY_COLOR = '#bfe3f2';
8
+ export const DEFAULT_FOG_NEAR = 18;
9
+ export const DEFAULT_FOG_FAR = 60;
10
+ export const FALL_FADE_BELOW_M = 1;
11
+ export const FALL_RETURN_S = 0.45;
12
+
13
+ const hexColor = (value) => typeof value === 'string' && /^#[\da-f]{6}$/i.test(value);
14
+ const clamp01 = (value) => Math.max(0, Math.min(1, value));
15
+
16
+ // Presence is intentional here. A malformed/newer authored key keeps the
17
+ // picture it had before rather than silently becoming the hub fallback, and a
18
+ // tier may shadow the parsed `scene.sky` getter with an own null without
19
+ // making the authored scene keyless.
20
+ export function hasAuthoredEnvironment(data) {
21
+ const engine = data?.engine;
22
+ return Boolean(
23
+ (data && Object.hasOwn(data, 'background')) ||
24
+ (engine && (Object.hasOwn(engine, 'sky') || Object.hasOwn(engine, 'view')))
25
+ );
26
+ }
27
+
28
+ function colorEquals(a, b) {
29
+ return Boolean(a?.isColor && b?.isColor && a.equals(b));
30
+ }
31
+
32
+ function rendererColor(renderer) {
33
+ if (typeof renderer?.getClearColor !== 'function') {return null;}
34
+ return renderer.getClearColor(new Color()).clone();
35
+ }
36
+
37
+ function clearAlpha(renderer) {
38
+ return typeof renderer?.getClearAlpha === 'function' ? renderer.getClearAlpha() : 1;
39
+ }
40
+
41
+ function zoneColor(scene) {
42
+ const data = scene?.data;
43
+ const viewColor = data?.engine?.view?.fogColor;
44
+ if (hexColor(viewColor)) {return new Color(viewColor);}
45
+ const fogColor = scene?.three?.scene?.fog?.color;
46
+ if (fogColor?.isColor) {return fogColor.clone();}
47
+
48
+ const zones = data?.engine?.sky?.zones;
49
+ if (Array.isArray(zones) && zones.length) {
50
+ const state = scene.skyZone;
51
+ const byId = new Map(zones.filter((zone) => hexColor(zone?.color)).map((zone) => [zone.id, zone.color]));
52
+ const home = zones.find((zone) => zone?.box === undefined && hexColor(zone?.color));
53
+ const from = byId.get(state?.from) ?? byId.get(state?.id) ?? home?.color ?? zones.find((zone) => hexColor(zone?.color))?.color;
54
+ if (from) {
55
+ const color = new Color(from);
56
+ const to = byId.get(state?.to);
57
+ if (to && state?.blend > 0) {color.lerp(new Color(to), clamp01(state.blend));}
58
+ return color;
59
+ }
60
+ }
61
+ const background = scene?.three?.scene?.background;
62
+ if (background?.isColor) {return background.clone();}
63
+ if (hexColor(data?.background)) {return new Color(data.background);}
64
+ return new Color(DEFAULT_SKY_COLOR);
65
+ }
66
+
67
+ function cssColor(color) {
68
+ return `#${color.getHexString()}`;
69
+ }
70
+
71
+ // The default environment is scene-local and owns only the exact values it
72
+ // writes. `frame` also supplies the fall transition for authored scenes: the
73
+ // WebGL canvas fades over its parent's sky/fog colour, which covers materials
74
+ // that opt out of fog without another render pass. Chrome remains readable.
75
+ export function makeDefaultEnvironment() {
76
+ const state = {
77
+ scene: null,
78
+ data: null,
79
+ world: null,
80
+ fog: null,
81
+ fogBefore: null,
82
+ clearBefore: null,
83
+ clearAlpha: 1,
84
+ clearWritten: null,
85
+ fade: 0,
86
+ canvas: null,
87
+ parent: null,
88
+ opacityBefore: '',
89
+ backgroundBefore: '',
90
+ opacityWritten: null,
91
+ backgroundWritten: null,
92
+ };
93
+
94
+ const restorePicture = () => {
95
+ const world = state.world;
96
+ if (world?.scene?.fog === state.fog) {world.scene.fog = state.fogBefore;}
97
+ const renderer = world?.renderer;
98
+ const current = rendererColor(renderer);
99
+ if (state.clearWritten && colorEquals(current, state.clearWritten) && clearAlpha(renderer) === state.clearAlpha) {
100
+ renderer.setClearColor(state.clearBefore, state.clearAlpha);
101
+ }
102
+ state.fog = null;
103
+ state.fogBefore = null;
104
+ state.clearBefore = null;
105
+ state.clearWritten = null;
106
+ };
107
+
108
+ const restoreFade = () => {
109
+ if (state.canvas && state.opacityWritten !== null && state.canvas.style.opacity === state.opacityWritten) {
110
+ state.canvas.style.opacity = state.opacityBefore;
111
+ }
112
+ if (state.parent && state.backgroundWritten !== null && state.parent.style.background === state.backgroundWritten) {
113
+ state.parent.style.background = state.backgroundBefore;
114
+ }
115
+ state.fade = 0;
116
+ state.canvas = null;
117
+ state.parent = null;
118
+ state.opacityBefore = '';
119
+ state.backgroundBefore = '';
120
+ state.opacityWritten = null;
121
+ state.backgroundWritten = null;
122
+ };
123
+
124
+ const restore = () => {
125
+ restoreFade();
126
+ restorePicture();
127
+ state.scene = null;
128
+ state.data = null;
129
+ state.world = null;
130
+ };
131
+
132
+ const adopt = (scene) => {
133
+ const world = scene?.three;
134
+ if (state.scene === scene && state.data === scene?.data && state.world === world) {return;}
135
+ restore();
136
+ if (!world) {return;}
137
+ state.scene = scene;
138
+ state.data = scene.data;
139
+ state.world = world;
140
+ if (hasAuthoredEnvironment(scene.data) || world.scene?.background || world.scene?.fog) {return;}
141
+ const renderer = world.renderer;
142
+ const before = rendererColor(renderer);
143
+ if (!before || typeof renderer.setClearColor !== 'function') {return;}
144
+ state.fogBefore = world.scene.fog;
145
+ state.fog = new Fog(DEFAULT_SKY_COLOR, DEFAULT_FOG_NEAR, DEFAULT_FOG_FAR);
146
+ world.scene.fog = state.fog;
147
+ state.clearBefore = before;
148
+ state.clearAlpha = clearAlpha(renderer);
149
+ state.clearWritten = new Color(DEFAULT_SKY_COLOR);
150
+ renderer.setClearColor(state.clearWritten, state.clearAlpha);
151
+ };
152
+
153
+ const drawFade = (scene, amount) => {
154
+ const canvas = scene?.three?.renderer?.domElement;
155
+ const parent = canvas?.parentElement;
156
+ if (!canvas?.style || !parent?.style) {return;}
157
+ if (state.canvas !== canvas || state.parent !== parent) {
158
+ const fade = state.fade;
159
+ restoreFade();
160
+ state.fade = fade;
161
+ state.canvas = canvas;
162
+ state.parent = parent;
163
+ state.opacityBefore = canvas.style.opacity;
164
+ state.backgroundBefore = parent.style.background;
165
+ }
166
+ const color = cssColor(zoneColor(scene));
167
+ const opacity = String(1 - amount);
168
+ canvas.style.opacity = opacity;
169
+ parent.style.background = color;
170
+ // CSSOM normalizes colours (usually to rgb(...)) and sometimes numbers.
171
+ // Remember what the browser retained, not what was assigned.
172
+ state.opacityWritten = canvas.style.opacity;
173
+ state.backgroundWritten = parent.style.background;
174
+ };
175
+
176
+ const frame = (scene, local, fallY, dt = 0, enabled = true) => {
177
+ if (enabled === false) {
178
+ restore();
179
+ return;
180
+ }
181
+ adopt(scene);
182
+ const y = local?.components?.Transform?.y;
183
+ let target = 0;
184
+ if (typeof fallY === 'number' && Number.isFinite(y)) {
185
+ target = clamp01((fallY - y) / FALL_FADE_BELOW_M);
186
+ }
187
+ if (target > state.fade) {state.fade = target;}
188
+ else {state.fade = Math.max(target, state.fade - Math.max(0, dt) / FALL_RETURN_S);}
189
+ if (state.fade > 0) {drawFade(scene, state.fade);}
190
+ else if (state.canvas) {restoreFade();}
191
+ };
192
+
193
+ return { frame, restore };
194
+ }
@@ -0,0 +1,39 @@
1
+ // Report only a fixed category to the current server. Never inspect error text.
2
+ export function makeDoorErrors(win = globalThis.window, doc = globalThis.document) {
3
+ let target = null, listening = false, last = null, next = 0;
4
+ const report = result => {
5
+ if (!target || doc?.visibilityState === 'hidden' || target.closed?.() ||
6
+ (target.status && target.status().state !== 'connected')) {return;}
7
+ const now = Date.now();
8
+ if (now < next) {return;}
9
+ next = now + 10000;
10
+ try {target.send({ k: 'hub-door-error', result });} catch { /* Best effort. */ }
11
+ };
12
+ const exception = () => report(2);
13
+ const visibility = () => {last = null;};
14
+ return {
15
+ sync(net, enabled, now) {
16
+ if (!enabled || target !== net) {last = null;}
17
+ target = enabled ? net : null;
18
+ if (Boolean(target) !== listening && win?.addEventListener) {
19
+ for (const name of ['error', 'unhandledrejection']) {
20
+ if (target) {win.addEventListener(name, exception);}
21
+ else {win.removeEventListener(name, exception);}
22
+ }
23
+ if (target) {doc?.addEventListener?.('visibilitychange', visibility);}
24
+ else {doc?.removeEventListener?.('visibilitychange', visibility);}
25
+ listening = Boolean(target);
26
+ }
27
+ // A visible render gap >= 2 seconds. Hidden tabs do not count as stalls.
28
+ if (target && doc?.visibilityState !== 'hidden' && last !== null && now - last >= 2000) {report(1);}
29
+ last = target && doc?.visibilityState !== 'hidden' ? now : null;
30
+ },
31
+ dispose() {
32
+ if (listening) {
33
+ for (const name of ['error', 'unhandledrejection']) {win.removeEventListener(name, exception);}
34
+ }
35
+ doc?.removeEventListener?.('visibilitychange', visibility);
36
+ target = null; listening = false; last = null;
37
+ },
38
+ };
39
+ }
@@ -0,0 +1,131 @@
1
+ // Earned items (contract §11, v1.53): the second wearable slot. A hub game
2
+ // declares the small things it gives for a stated deed in its castle.json
3
+ // (`hub.unlocks`), gives one with `hub.unlock(playerId, id)`, and the town
4
+ // alone chooses which one a player shows. Each player shows at most one, drawn
5
+ // beside whatever the Look slot (`hub.wear`) puts on the head: a badge or pin
6
+ // on the chest, a belt round the waist, a sash across the torso, or a small
7
+ // thing held in the right hand.
8
+ //
9
+ // The place sends playerId -> `{ class, shape, color, name }` (`hubEarned`, and
10
+ // `hub-earned` alone for a hidden pair, as `hubWear` / `hub-wear`), and
11
+ // `makeEarned` draws each under the avatar's own node, as `wear.js` draws a
12
+ // hat: so it moves, turns and hides with the avatar, and nothing is sent or
13
+ // made as an actor. Nothing here runs for a place where nobody shows one.
14
+ //
15
+ // The shapes are the kit's models, `models/earned/<shape>.pxmodel`
16
+ // (scripts/gen-earned.mjs), with the avatars' outline look. The item's colour
17
+ // takes the place of the model's main colour (`EARNED_MAIN`, which only main
18
+ // materials carry); trims keep theirs. A shape this kit has no model of, or a
19
+ // shape drawn for another class than the item's, is kept and not drawn.
20
+ //
21
+ // The lists below import nothing, so a place's server may read them
22
+ // (`@imports/castle.hub-game/code/client/earned.js`) to check a declaration
23
+ // against exactly what every client can draw, as it reads `hats.js` `HATS`.
24
+
25
+ export const EARNED_CLASSES = ['badge', 'pin', 'belt', 'sash', 'held'];
26
+
27
+ // Each shape and the class it is drawn for. A badge's shape may be pinned and
28
+ // a pin's worn as a badge: both sit on the chest.
29
+ export const EARNED_SHAPE_CLASS = {
30
+ 'badge-round': 'badge',
31
+ 'badge-star': 'badge',
32
+ 'badge-shield': 'badge',
33
+ 'pin-round': 'pin',
34
+ 'belt-plain': 'belt',
35
+ 'sash-plain': 'sash',
36
+ 'held-lantern': 'held',
37
+ 'held-trophy': 'held',
38
+ 'held-net': 'held',
39
+ 'held-ball': 'held',
40
+ };
41
+
42
+ export const EARNED_SHAPES = Object.keys(EARNED_SHAPE_CLASS);
43
+
44
+ // The colour the models' main materials are written in, replaced by the item's.
45
+ export const EARNED_MAIN = '#3aa0d8';
46
+
47
+ export const earnedFile = (shape, square = false) => `models/earned/${square ? 'square/' : ''}${shape}.pxmodel`;
48
+ // The ring shapes that have a square model for a boxy body.
49
+ export const SQUARE_SHAPES = ['belt-plain', 'sash-plain'];
50
+
51
+ const COLOR = /^#[0-9a-f]{6}$/i;
52
+ const CHEST = new Set(['badge', 'pin']);
53
+ // The model's feet stand this far under the avatar's origin (wear.js).
54
+ const MODEL_FEET_Y = -0.7;
55
+ // Each ring model (a belt, a sash) is made 0.2 m out from its middle and
56
+ // stretched to the body it goes round.
57
+ const RING_R = 0.2;
58
+ // Badges are drawn this much bigger than their models and pins this much, so
59
+ // they read across a street as the halos they replace did.
60
+ export const BADGE_SCALE = 2.6;
61
+ export const PIN_SCALE = 2.1;
62
+ // A badge has a soft glow in its colour behind it (`wear.js` draws it), this
63
+ // far out from its middle: light under the badge fading to nothing.
64
+ export const BADGE_GLOW_R = 0.32;
65
+ // And held things this much bigger, about their grip.
66
+ export const HELD_SCALE = 1.2;
67
+
68
+ // Where an earned item sits on an avatar this kit has no fit for (`avatar.js`
69
+ // `earnedFit` gives null): a body about toon's.
70
+ const DEFAULT_FIT = {
71
+ chest: [0.09, 0.6, 0.2, 20],
72
+ waist: [0.37, 0.23, 0.23],
73
+ sash: [0.51, 0.35, 0.26, 45],
74
+ hand: [-0.33, 0.34, 0.01],
75
+ };
76
+
77
+ const mm = (n) => Math.round(n * 1000) / 1000;
78
+
79
+ // Whether `shape` is drawn for class `cls`.
80
+ export function drawnFor(shape, cls) {
81
+ const own = EARNED_SHAPE_CLASS[shape];
82
+ if (!own) {
83
+ return false;
84
+ }
85
+ return own === cls || (CHEST.has(own) && CHEST.has(cls));
86
+ }
87
+
88
+ // What to draw for an earned item `{ class, shape, color }` on an avatar with
89
+ // earned fit `fit` (`avatar.js`): a plain description, the same every time for
90
+ // the same arguments, or null for nothing (an unknown shape, a shape of
91
+ // another class, no colour).
92
+ // { shape, file, color, position: [x, y, z], yaw, tilt, scale: [x, y, z], glow? }
93
+ // in metres over the avatar's origin and degrees: the model is scaled, then
94
+ // tilted about z (a sash, rising to the wearer's right shoulder), then turned
95
+ // `yaw` about y, then moved to `position`. `glow` (a badge) is the radius of
96
+ // its soft glow.
97
+ export function earnedLook(item, fit = null) {
98
+ const cls = item?.class;
99
+ const shape = item?.shape;
100
+ const color = typeof item?.color === 'string' && COLOR.test(item.color) ? item.color.toLowerCase() : null;
101
+ if (!color || !EARNED_CLASSES.includes(cls) || !drawnFor(shape, cls)) {
102
+ return null;
103
+ }
104
+ const f = fit ?? DEFAULT_FIT;
105
+ const square = f.square === true && SQUARE_SHAPES.includes(shape);
106
+ const base = { shape, file: earnedFile(shape, square), color };
107
+ if (CHEST.has(cls)) {
108
+ // The shape says how big it is drawn: a badge's shape pinned is a badge.
109
+ const [x, y, z, yaw, size = 1] = f.chest;
110
+ const badge = EARNED_SHAPE_CLASS[shape] === 'badge';
111
+ const k = mm((badge ? BADGE_SCALE : PIN_SCALE) * size);
112
+ return { ...base, position: [x, mm(MODEL_FEET_Y + y), z], yaw, tilt: 0, scale: [k, k, k], ...(badge ? { glow: mm(BADGE_GLOW_R * size) } : {}) };
113
+ }
114
+ if (cls === 'belt') {
115
+ const [y, rx, rz] = f.waist;
116
+ return { ...base, position: [0, mm(MODEL_FEET_Y + y), 0], yaw: 0, tilt: 0, scale: [mm(rx / RING_R), 1, mm(rz / RING_R)] };
117
+ }
118
+ if (cls === 'sash') {
119
+ // `a` is the half length of the ring in its tilted plane.
120
+ const [y, a, rz, tilt] = f.sash;
121
+ return { ...base, position: [0, mm(MODEL_FEET_Y + y), 0], yaw: 0, tilt: -tilt, scale: [mm(a / RING_R), 1, mm(rz / RING_R)] };
122
+ }
123
+ const [x, y, z] = f.hand;
124
+ return { ...base, position: [x, mm(MODEL_FEET_Y + y), z], yaw: 0, tilt: 0, scale: [HELD_SCALE, HELD_SCALE, HELD_SCALE] };
125
+ }
126
+
127
+ // The model text an item is built from: the shape's model with its main
128
+ // colour made the item's. Trims never carry `EARNED_MAIN`.
129
+ export function tinted(text, color) {
130
+ return text.split(`"${EARNED_MAIN}"`).join(JSON.stringify(color.toLowerCase()));
131
+ }
@@ -0,0 +1,75 @@
1
+ // Where an emote's emoji is drawn: on the head it belongs to, never under
2
+ // the top chrome (the HUD's box, a question card, Back, the sound button).
3
+ // In a portrait phone with the camera looking down, a fixed height over the
4
+ // body projects far up the screen, into the HUD's lines or the sky, and the
5
+ // player never reads it as their own wave. No DOM here, so
6
+ // `scripts/test-emote-bubble.mjs` can hold it; the client projects the head
7
+ // (`idle.js` `labels`) and the chrome (`chrome.js` `setLabels`) measures and
8
+ // moves.
9
+ //
10
+ // The rule (`placeEmoteBubble`): just above the head's top, centred on it;
11
+ // where that leaves the view's top edge or meets a band, beside the head on
12
+ // the side with more room, centred on it; kept on the view; and last, from
13
+ // under any band it still meets (`emoteBubbleShift`).
14
+
15
+ // Pixels between a bubble beside the head and the head, a moved bubble and
16
+ // the band it was moved under, and kept off every side of the view.
17
+ export const BUBBLE_GAP = 8;
18
+ export const BUBBLE_EDGE = 6;
19
+ // Over the head, the emoji's own glyph leaves a little air: it sits right on
20
+ // the model's box (whose top, ears and hats included, is often above what
21
+ // reads as the head).
22
+ export const HEAD_GAP = 0;
23
+
24
+ const overlaps = (a, b) => a.left < b.right && b.left < a.right && a.top < b.bottom && b.top < a.bottom;
25
+ const clamp = (v, lo, hi) => Math.max(lo, Math.min(v, Math.max(lo, hi)));
26
+
27
+ // `rect` and `bands` are `{ left, right, top, bottom }` in CSS pixels;
28
+ // `viewW` the view's width. Returns `{ dx, dy }`, both 0 when nothing is in
29
+ // the way: a bubble over a band goes to just under the lowest band it meets,
30
+ // a bubble's width to the right, and again under any band it then meets.
31
+ export function emoteBubbleShift(rect, bands, viewW) {
32
+ const w = rect.right - rect.left;
33
+ let r = rect;
34
+ let moved = false;
35
+ for (let i = 0; i <= bands.length; i += 1) {
36
+ const hit = bands.filter((b) => overlaps(r, b));
37
+ if (!hit.length) {
38
+ break;
39
+ }
40
+ const down = Math.max(...hit.map((b) => b.bottom)) + BUBBLE_GAP - r.top;
41
+ let left = r.left;
42
+ if (!moved) {
43
+ moved = true;
44
+ left = clamp(rect.left + w, BUBBLE_EDGE, viewW - BUBBLE_EDGE - w);
45
+ }
46
+ r = { left, right: left + w, top: r.top + down, bottom: r.bottom + down };
47
+ }
48
+ return { dx: r.left - rect.left, dy: r.top - rect.top };
49
+ }
50
+
51
+ // `head` is the head's rect on screen, `size` the bubble's `{ w, h }`, `view`
52
+ // `{ w, h }`, `lift` pixels more above the head (its rise). The placed rect,
53
+ // or null for a head wholly off the view: its bubble is not drawn, as an off-
54
+ // screen label never was, rather than clamped beside someone else.
55
+ export function placeEmoteBubble(head, size, bands, view, lift = 0) {
56
+ if (head.right <= 0 || head.left >= view.w || head.bottom <= 0 || head.top >= view.h) {
57
+ return null;
58
+ }
59
+ const { w, h } = size;
60
+ const cx = (head.left + head.right) / 2;
61
+ const left = clamp(cx - w / 2, BUBBLE_EDGE, view.w - BUBBLE_EDGE - w);
62
+ const bottom = head.top - HEAD_GAP - lift;
63
+ let r = { left, right: left + w, top: bottom - h, bottom };
64
+ if (r.top < BUBBLE_EDGE || bands.some((b) => overlaps(r, b))) {
65
+ // Beside the head, on its open side, centred on it.
66
+ const roomRight = view.w - head.right;
67
+ const roomLeft = head.left;
68
+ const x = roomRight >= roomLeft ? head.right + BUBBLE_GAP : head.left - BUBBLE_GAP - w;
69
+ const bx = clamp(x, BUBBLE_EDGE, view.w - BUBBLE_EDGE - w);
70
+ const by = clamp((head.top + head.bottom) / 2 - h / 2, BUBBLE_EDGE, view.h - BUBBLE_EDGE - h);
71
+ r = { left: bx, right: bx + w, top: by, bottom: by + h };
72
+ }
73
+ const { dx, dy } = emoteBubbleShift(r, bands, view.w);
74
+ return { left: r.left + dx, right: r.right + dx, top: r.top + dy, bottom: r.bottom + dy };
75
+ }
@@ -0,0 +1,18 @@
1
+ // The server does not catch a player while the place holds them. Keep the
2
+ // client-side floor guard and fall fade on that same condition: otherwise a
3
+ // legitimate low hold fights the server's pose and can leave the view faded.
4
+ // Travel suppresses both too, because the previous place remains in client
5
+ // state until the trip installs its destination.
6
+ export function activeFallY(fallY, held, travelling) {
7
+ return typeof fallY === 'number' && !held && !travelling ? fallY : null;
8
+ }
9
+
10
+ export function holdFallenPlayer(scene, local, fallY) {
11
+ const t = local?.components.Transform;
12
+ if (typeof fallY !== 'number' || !t || t.y >= fallY - 1) {
13
+ return;
14
+ }
15
+ t.y = fallY - 1;
16
+ scene.physics3d?.bodyOf?.(local)?.setTranslation({ x: t.x, y: t.y, z: t.z }, true);
17
+ scene.physics3d?.setVelocity?.(local, { x: 0, y: 0, z: 0 });
18
+ }
@@ -0,0 +1,233 @@
1
+ import { ensureActorModel } from './modelReady.js';
2
+ import * as THREE from 'three';
3
+ import { mergeGeometries } from 'three/addons/utils/BufferGeometryUtils.js';
4
+ import { lookOf, rigOf, sharedFor } from './avatarShare.js';
5
+
6
+ const PLAIN_RENDER = String(THREE.Object3D.prototype.onBeforeRender);
7
+
8
+ // Low-only, opt-in resting bodies for remote avatars beyond 12m. Animated
9
+ // rigs keep updating while hidden, so coming within 10m restores the current
10
+ // pose. Names and worn objects are siblings of the rig and are untouched.
11
+ // Every geometry here is owned; materials remain the kit's shared copies.
12
+ export function makeFarAvatars() {
13
+ const rows = new Map();
14
+ const cache = new Map();
15
+ let nextAt = -Infinity;
16
+ const here = new THREE.Vector3();
17
+ const there = new THREE.Vector3();
18
+
19
+ function release(id) {
20
+ const row = rows.get(id);
21
+ if (!row) {
22
+ return;
23
+ }
24
+ rows.delete(id);
25
+ row.node.removeEventListener('removed', row.removed);
26
+ row.rig.visible = row.visible;
27
+ row.proxy.removeFromParent();
28
+ row.built.users -= 1;
29
+ if (!row.built.users) {
30
+ for (const mesh of row.built.meshes) {
31
+ mesh.geometry.dispose();
32
+ }
33
+ cache.delete(row.template);
34
+ }
35
+ }
36
+
37
+ function build(template) {
38
+ // Deferred look baking owns geometry.clone while writing AO, including
39
+ // models without outlines. A merged buffer cannot follow those writes.
40
+ let waiting = false;
41
+ template.traverse((object) => {
42
+ if (
43
+ object.isMesh &&
44
+ (Array.isArray(object.material) ||
45
+ object.material?.visible === false ||
46
+ Object.hasOwn(object.geometry, 'clone'))
47
+ ) {
48
+ waiting = true;
49
+ }
50
+ });
51
+ if (waiting) {
52
+ return null;
53
+ }
54
+ const groups = new Map();
55
+ let supported = true;
56
+ template.updateMatrixWorld(true);
57
+ const inverse = template.matrixWorld.clone().invert();
58
+ template.traverseVisible((mesh) => {
59
+ if (!mesh.isMesh || mesh.userData.lookOutline) {
60
+ return;
61
+ }
62
+ const material = mesh.material;
63
+ const look = lookOf(material);
64
+ if (
65
+ String(mesh.onBeforeRender) !== PLAIN_RENDER ||
66
+ mesh.isSkinnedMesh ||
67
+ mesh.isInstancedMesh ||
68
+ !mesh.visible ||
69
+ look === null ||
70
+ material.transparent ||
71
+ material.opacity !== 1 ||
72
+ Object.keys(mesh.geometry.morphAttributes).length ||
73
+ mesh.geometry.drawRange.start !== 0 ||
74
+ mesh.geometry.drawRange.count !== Infinity
75
+ ) {
76
+ supported = false;
77
+ return;
78
+ }
79
+ let group = groups.get(look);
80
+ if (!group) {
81
+ group = { material: sharedFor(material), geometries: [] };
82
+ groups.set(look, group);
83
+ }
84
+ const matrix = inverse.clone().multiply(mesh.matrixWorld);
85
+ // Three corrects front faces for a reflected mesh transform. Baking
86
+ // that reflection into positions would lose the correction.
87
+ if (matrix.determinant() < 0) {
88
+ supported = false;
89
+ return;
90
+ }
91
+ const geometry = mesh.geometry.clone();
92
+ geometry.applyMatrix4(matrix);
93
+ group.geometries.push(geometry);
94
+ });
95
+ const meshes = [];
96
+ for (const group of groups.values()) {
97
+ const geometry = supported ? mergeGeometries(group.geometries) : null;
98
+ for (const part of group.geometries) {
99
+ part.dispose();
100
+ }
101
+ if (!geometry) {
102
+ supported = false;
103
+ continue;
104
+ }
105
+ const mesh = new THREE.Mesh(geometry, group.material);
106
+ mesh.castShadow = false;
107
+ mesh.receiveShadow = true;
108
+ mesh.userData.hubFarAvatarBody = true;
109
+ meshes.push(mesh);
110
+ }
111
+ if (!supported || !meshes.length) {
112
+ for (const mesh of meshes) {
113
+ mesh.geometry.dispose();
114
+ }
115
+ return null;
116
+ }
117
+ return { meshes, users: 0 };
118
+ }
119
+
120
+ function add(id, entry, rig, template) {
121
+ let built = cache.get(template);
122
+ if (!built) {
123
+ built = build(template);
124
+ if (!built) {
125
+ return;
126
+ }
127
+ cache.set(template, built);
128
+ }
129
+ const proxy = new THREE.Group();
130
+ proxy.name = 'hub-far-avatar';
131
+ proxy.position.copy(rig.position);
132
+ proxy.quaternion.copy(rig.quaternion);
133
+ proxy.scale.copy(rig.scale);
134
+ for (const mesh of built.meshes) {
135
+ proxy.add(mesh.clone());
136
+ }
137
+ const removed = () => release(id);
138
+ const row = { node: entry.node, rig, template, built, proxy, visible: rig.visible, removed };
139
+ rows.set(id, row);
140
+ built.users += 1;
141
+ entry.node.add(proxy);
142
+ entry.node.addEventListener('removed', removed);
143
+ rig.visible = false;
144
+ }
145
+
146
+ function clear() {
147
+ for (const id of [...rows.keys()]) {
148
+ release(id);
149
+ }
150
+ nextAt = -Infinity;
151
+ }
152
+
153
+ function update(scene, actorIds, localId, active, now, realLimit = Infinity) {
154
+ if (!active) {
155
+ clear();
156
+ return;
157
+ }
158
+ if (now < nextAt) {
159
+ return;
160
+ }
161
+ nextAt = now + 250;
162
+ const world = scene.three;
163
+ const local = world?.nodes?.get(localId)?.node;
164
+ if (!local) {
165
+ clear();
166
+ return;
167
+ }
168
+ local.getWorldPosition(here);
169
+ const ids = new Set(actorIds);
170
+ for (const id of ids) {ensureActorModel(world, id);}
171
+ for (const [id, row] of rows) {
172
+ if (
173
+ !ids.has(id) ||
174
+ id === localId ||
175
+ world.nodes.get(id)?.node !== row.node ||
176
+ rigOf(row.node) !== row.rig ||
177
+ world.models.get(world.nodes.get(id)?.modelKey)?.template !== row.template
178
+ ) {
179
+ release(id);
180
+ }
181
+ }
182
+ const distances = new Map();
183
+ if (Number.isFinite(realLimit)) {
184
+ for (const id of ids) {
185
+ const node = world.nodes.get(id)?.node;
186
+ if (id !== localId && node && rigOf(node)) {
187
+ distances.set(id, node.getWorldPosition(there).distanceTo(here));
188
+ }
189
+ }
190
+ }
191
+ const nearest = Number.isFinite(realLimit)
192
+ ? new Set(
193
+ [...distances]
194
+ .sort((a, b) => a[1] - b[1] || String(a[0]).localeCompare(String(b[0])))
195
+ .slice(0, realLimit)
196
+ .map(([id]) => id),
197
+ )
198
+ : null;
199
+ for (const id of ids) {
200
+ if (id === localId) {
201
+ continue;
202
+ }
203
+ const entry = world.nodes.get(id);
204
+ const rig = rigOf(entry?.node);
205
+ if (!rig) {
206
+ continue;
207
+ }
208
+ const distance = entry.node.getWorldPosition(there).distanceTo(here);
209
+ if (rows.has(id)) {
210
+ if ((!nearest || nearest.has(id)) && distance < 10) {
211
+ release(id);
212
+ }
213
+ } else if (
214
+ ((nearest && !nearest.has(id)) || distance > 12) &&
215
+ rig.visible &&
216
+ entry.node.parent
217
+ ) {
218
+ const template = world.models.get(entry.modelKey)?.template;
219
+ if (template) {
220
+ add(id, entry, rig, template);
221
+ }
222
+ }
223
+ }
224
+ }
225
+
226
+ return {
227
+ update,
228
+ clear,
229
+ get size() {
230
+ return rows.size;
231
+ },
232
+ };
233
+ }