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,37 @@
1
+ // The toast has its own band, clear of everything a player taps: it starts
2
+ // under the top of the view on a phone, or over the bottom of it on a
3
+ // desktop, and is moved past whatever lies there -- down the view on a phone
4
+ // (under the HUD, then under a question), up it on a desktop (over Talk, Sit,
5
+ // the invite button) -- until it meets nothing. Rectangles are in viewport
6
+ // CSS pixels; only those crossing the centred toast's span are in its way.
7
+ // No DOM here, so the same geometry can be held by
8
+ // `scripts/test-toast-band.mjs`.
9
+ // Returns one inset (`top` or `bottom`). It starts `start` px down a phone
10
+ // (12, or the safe area's inset where that is more) or 64 px up a desktop. Where no place in the
11
+ // view is clear, it stays at the last place tried that the view holds, past
12
+ // as much as it could be moved; the box is kept in the view where it fits.
13
+ export function toastBand({ desktop, viewW, viewH, width, height, rects = [], gap = 6, start = 12 }) {
14
+ const left = (viewW - width) / 2;
15
+ const right = (viewW + width) / 2;
16
+ const cross = rects.filter((rect) => rect.right > left && rect.left < right);
17
+ const answer = (y) => {
18
+ const kept = Math.max(0, Math.min(y, Math.max(0, viewH - height)));
19
+ return { [desktop ? 'bottom' : 'top']: desktop ? Math.max(0, viewH - kept - height) : kept };
20
+ };
21
+ let y = desktop ? viewH - 64 - height : start;
22
+ let last = null;
23
+ for (let step = 0; step <= cross.length; step += 1) {
24
+ const met = cross.filter((rect) => rect.bottom + gap > y && rect.top - gap < y + height);
25
+ if (met.length === 0) {
26
+ if (y >= 0 && y + height <= viewH) {
27
+ return answer(y);
28
+ }
29
+ break;
30
+ }
31
+ y = desktop ? Math.min(...met.map((rect) => rect.top)) - gap - height : Math.max(...met.map((rect) => rect.bottom)) + gap;
32
+ if (y >= 0 && y + height <= viewH) {
33
+ last = y;
34
+ }
35
+ }
36
+ return answer(last ?? y);
37
+ }
@@ -5,6 +5,7 @@
5
5
  // too far away to see. A game draws none of it.
6
6
 
7
7
  import { deck, hub } from './state.js';
8
+ import { guestName } from './signIn.js';
8
9
  import { NAME_NEAR_M } from './attention.js';
9
10
 
10
11
  // How often the place is asked where the tracked players are.
@@ -327,7 +328,7 @@ export function makeTogether() {
327
328
  key: `p:${playerId}`,
328
329
  playerId,
329
330
  userId,
330
- username: username || null,
331
+ username: hub.guests?.has(playerId) ? guestName(username) : username || null,
331
332
  rank: t?.party ? 0 : t?.friend ? 1 : 3,
332
333
  mark: t?.party ? '● ' : t?.friend ? '★ ' : '',
333
334
  where: town ? (hub.whereAt[playerId]?.where ?? 'in town') : null,
@@ -345,6 +346,9 @@ export function makeTogether() {
345
346
  if (typeof f.door === 'string' && !door) {
346
347
  continue;
347
348
  }
349
+ // At home in their own House behind that door (a host that says so):
350
+ // Join visits that owner's House, not this player's own.
351
+ const owner = door && f.home === true && typeof f.ownerUserId === 'string' && /^[1-9]\d{0,9}$/.test(f.ownerUserId) ? f.ownerUserId : null;
348
352
  here.push({
349
353
  key: `u:${f.userId}`,
350
354
  playerId: null,
@@ -352,9 +356,10 @@ export function makeTogether() {
352
356
  username: f.username ?? null,
353
357
  rank: 2,
354
358
  mark: '★ ',
355
- where: door ? `inside ${door.title ?? 'a game'}` : 'in another part of town',
359
+ where: owner ? `inside ${f.username ? `${f.username}'s` : 'their'} House` : door ? `inside ${door.title ?? 'a game'}` : 'in another part of town',
356
360
  actions: [{ id: door ? 'door' : 'jump', text: 'Join' }],
357
361
  door: door?.id ?? null,
362
+ ...(owner ? { owner } : {}),
358
363
  });
359
364
  }
360
365
  // A stable sort: each group keeps the roster's order.
@@ -472,6 +477,38 @@ export function makeTogether() {
472
477
  };
473
478
  }
474
479
 
480
+ // A goal pointer's words (contract v1.13): the place's text, and beyond
481
+ // `nearM` how far it is -- `measured`, the player's straight line to the
482
+ // actor, unless the label says otherwise (v1.39): `distanceM` is the number
483
+ // to show instead (the walk to the end of a route whose next corner the
484
+ // pointer aims at; also not shown within `nearM`), and `distance: false`
485
+ // shows none. A `distanceM` that is not a finite number of metres from 0 up
486
+ // is not there, and the measured one is shown as before.
487
+ export function goalText(label, measured, nearM) {
488
+ if (label.distance === false) {
489
+ return label.text;
490
+ }
491
+ const given = typeof label.distanceM === 'number' && Number.isFinite(label.distanceM) && label.distanceM >= 0;
492
+ const d = given ? label.distanceM : measured;
493
+ return d > nearM ? `${label.text} · ${Math.round(d)} m` : label.text;
494
+ }
495
+
496
+ // v1.81: pick the nearest goals that can actually be drawn. A hint has no
497
+ // edge arrow; an off-screen hint never takes a visible goal's place.
498
+ export function goalPointers(goals, max, pointerFor) {
499
+ const pointers = [];
500
+ for (const goal of [...goals].sort((a, b) => a.d - b.d)) {
501
+ const pointer = pointerFor(goal);
502
+ if (goal.label.edge !== false || pointer.angle === null) {
503
+ pointers.push(pointer);
504
+ if (pointers.length === max) {
505
+ break;
506
+ }
507
+ }
508
+ }
509
+ return pointers;
510
+ }
511
+
475
512
  // One pointer at a point in the world: over it while it is on the clear part
476
513
  // of the screen (`angle` null), else at the screen's edge along the way to it
477
514
  // as the camera sees it. Friends (above) and a place's goal labels
@@ -0,0 +1,43 @@
1
+ // v1.91: only an opted-in place installs a listener. Keep the listener off
2
+ // resident scenes behind doors, and send immediately (hidden tabs stop RAF).
3
+ export function makeVisibility(doc = globalThis.document, now = Date.now) {
4
+ let target = null;
5
+ let last = null;
6
+ let listening = false;
7
+ const changed = () => {
8
+ if (!target || target.net.closed?.()) {
9
+ return;
10
+ }
11
+ if (target.net.status && target.net.status().state !== 'connected') {
12
+ return;
13
+ }
14
+ const visible = doc.visibilityState !== 'hidden';
15
+ if (visible === last) {
16
+ return;
17
+ }
18
+ target.net.send({ k: 'hub-visibility', visible, at: now() });
19
+ last = visible;
20
+ };
21
+ return {
22
+ sync(net, key, enabled) {
23
+ if (!enabled || !net || !doc?.addEventListener) {
24
+ if (listening) {
25
+ doc.removeEventListener('visibilitychange', changed);
26
+ }
27
+ listening = false;
28
+ target = null;
29
+ last = null;
30
+ return;
31
+ }
32
+ if (target?.net !== net || target?.key !== key) {
33
+ target = { net, key };
34
+ last = null;
35
+ }
36
+ if (!listening) {
37
+ doc.addEventListener('visibilitychange', changed);
38
+ listening = true;
39
+ }
40
+ changed(); // Includes a change while the connection could not send.
41
+ },
42
+ };
43
+ }
@@ -0,0 +1,92 @@
1
+ // Client-only policy for the opted-in Weakest picture. The engine still owns
2
+ // task stepping, geometry disposal/clones and the first-drawn-frame fence.
3
+ import { orderLookBake } from '@imports/castle.physics-3d/engine3d/lookbake';
4
+
5
+ export function makeWeakestLookBake(queue) {
6
+ const previousBudget = queue.budgetMs;
7
+ const stats = { budgetMs: 24, placedAt: null, pending: queue.pending, shown: false };
8
+ let nextOrder = -Infinity;
9
+ let renderTarget = null;
10
+ let previousAfter = null;
11
+ let afterRender = null;
12
+ let ownedAfter = false;
13
+ let lastNow = 0;
14
+ let active = true;
15
+ queue.hubWeakest = stats;
16
+
17
+ function frame(scene, now) {
18
+ if (scene.multiplayer?.placed?.() === true && stats.placedAt === null) {stats.placedAt = now;}
19
+ // A bounded catch-up budget, never a deadline that discards work. Phone QA
20
+ // decides whether all visible looks meet 30 s and the whole queue 60 s.
21
+ stats.budgetMs = stats.placedAt !== null && now - stats.placedAt >= 15000 ? 32 : 24;
22
+ queue.budgetMs = stats.budgetMs;
23
+ stats.pending = queue.pending;
24
+ stats.shown = queue.shown;
25
+ lastNow = now;
26
+ attachRender(scene);
27
+ order(scene, now);
28
+ }
29
+
30
+ function order(scene, now) {
31
+ if (!queue.pending || (!queue.unsorted && now < nextOrder)) {return;}
32
+ nextOrder = now + 250;
33
+ const player = scene.actorWith('Player');
34
+ const p = player?.components?.Transform;
35
+ if (!p || !Number.isFinite(p.x) || !Number.isFinite(p.z)) {return;}
36
+ const geometries = new Map();
37
+ const owners = new Map();
38
+ const nearest = (map, key, distance) => {
39
+ if (key != null && !(distance >= map.get(key))) {map.set(key, distance);}
40
+ };
41
+ for (const [id, entry] of scene.three.nodes) {
42
+ // Unbuilt models own no look task yet. Do not promote every waiting
43
+ // model just to sort; a fill adds tasks and marks the queue unsorted.
44
+ if (entry.modelWait) {continue;}
45
+ const actor = scene.getActor(id);
46
+ const at = actor?.components?.Transform;
47
+ if (!at || !Number.isFinite(at.x) || !Number.isFinite(at.z)) {continue;}
48
+ const distance = id === player.id ? 0 : 1 + (at.x - p.x) ** 2 + (at.z - p.z) ** 2;
49
+ nearest(owners, entry.modelKey, distance);
50
+ // Accessories have their own shared model keys. Geometry membership
51
+ // gives them the closest wearer's priority, including the local player.
52
+ entry.node.traverse((node) => nearest(geometries, node.geometry, distance));
53
+ }
54
+ for (const task of queue.tasks) {
55
+ for (const geometry of task.geometries) {nearest(owners, task.owner, geometries.get(geometry) ?? Number.MAX_VALUE);}
56
+ }
57
+ orderLookBake(queue, (owner) => owners.get(owner) ?? Number.MAX_VALUE);
58
+ }
59
+
60
+ function releaseRender() {
61
+ if (renderTarget?.onAfterRender === afterRender) {
62
+ if (ownedAfter) {renderTarget.onAfterRender = previousAfter;}
63
+ else {delete renderTarget.onAfterRender;}
64
+ }
65
+ renderTarget = previousAfter = afterRender = null;
66
+ }
67
+
68
+ function attachRender(scene) {
69
+ const target = scene.three.scene;
70
+ if (!target || target === renderTarget) {return;}
71
+ releaseRender();
72
+ renderTarget = target;
73
+ ownedAfter = Object.hasOwn(target, 'onAfterRender');
74
+ previousAfter = target.onAfterRender;
75
+ const prior = previousAfter;
76
+ afterRender = function (...args) {
77
+ prior?.apply(this, args);
78
+ // Models are synchronized after the hub update. This fence sees newly
79
+ // queued models before world3d.bakeLooks can sort or start any task.
80
+ if (active && renderTarget === target) {order(scene, lastNow);}
81
+ };
82
+ target.onAfterRender = afterRender;
83
+ }
84
+
85
+ function restore() {
86
+ active = false;
87
+ releaseRender();
88
+ if (queue.budgetMs === stats.budgetMs) {queue.budgetMs = previousBudget;}
89
+ if (queue.hubWeakest === stats) {delete queue.hubWeakest;}
90
+ }
91
+ return { frame, restore };
92
+ }
@@ -0,0 +1,295 @@
1
+ // Optional, scene-authored active districts. Sleeping actors retain their
2
+ // components, runtime objects and ID lookup while live passes omit them.
3
+ // Source data and server remain complete. Untagged actors always stay live.
4
+ import { makeLookBake } from '@imports/castle.physics-3d/engine3d/lookbake';
5
+ import { readCells, insideOutline } from './tiers.js';
6
+ import { makeWeakestLookBake } from './weakestLookBake.js';
7
+
8
+ export function readDistricts(value) {
9
+ if (
10
+ !value ||
11
+ value.version !== 1 ||
12
+ !Array.isArray(value.districts) ||
13
+ !Array.isArray(value.actors)
14
+ ) {
15
+ return null;
16
+ }
17
+ if (!value.districts.every((d) => d && typeof d === 'object' && typeof d.id === 'string')) {
18
+ return null;
19
+ }
20
+ const table = readCells({
21
+ version: 1,
22
+ eyeMax: 1000,
23
+ hysteresis: 0,
24
+ cells: value.districts.map((d) => ({ ...d, sees: [d.id] })),
25
+ });
26
+ if (!table) {
27
+ return null;
28
+ }
29
+ const actors = new Map();
30
+ for (const row of value.actors) {
31
+ if (
32
+ !row ||
33
+ typeof row.id !== 'string' ||
34
+ actors.has(row.id) ||
35
+ !Array.isArray(row.districts) ||
36
+ !row.districts.length ||
37
+ !row.districts.every((id) => table.byId.has(id)) ||
38
+ !Array.isArray(row.origin) ||
39
+ row.origin.length !== 2 ||
40
+ !row.origin.every(Number.isFinite) ||
41
+ !Array.isArray(row.bounds) ||
42
+ row.bounds.length !== 4 ||
43
+ !row.bounds.every(Number.isFinite) ||
44
+ row.bounds[0] > row.bounds[2] ||
45
+ row.bounds[1] > row.bounds[3]
46
+ ) {
47
+ return null;
48
+ }
49
+ actors.set(row.id, row);
50
+ }
51
+ return { table, actors };
52
+ }
53
+
54
+ // A harmless text difference invalidates existing model signatures. The bake
55
+ // queue applies the cheap look while building; asset look data stays authored,
56
+ // including when a door copies these files into a cached content pack.
57
+ function simplifiedFiles(files) {
58
+ return Object.fromEntries(
59
+ Object.entries(files).map(([path, text]) => [
60
+ path,
61
+ path.endsWith('.pxmodel') && typeof text === 'string' ? text + '\n ' : text,
62
+ ]),
63
+ );
64
+ }
65
+
66
+ // Middle shares only district sleep with Weakest, and halves Low's buffers.
67
+ export function makeWeakestTier({ profile = 'weakest' } = {}) {
68
+ const middle = profile === 'middle';
69
+ let held = null;
70
+ let source = null;
71
+ let map = null;
72
+ let districts = null;
73
+ let originalFiles = null;
74
+ let cheapFiles = null;
75
+ let cheapSnapshot = null;
76
+ let nextAt = -Infinity;
77
+ const asleep = new Map();
78
+ let ownsBake = false;
79
+ let ownsEmptyParts = false;
80
+ let bakeQueue = null;
81
+ let previousSkip;
82
+ let boundedLook = null;
83
+ let wantsBoundedLook = false;
84
+ let resolution = null;
85
+ let active = false;
86
+ let district = null;
87
+
88
+ function restore() {
89
+ if (resolution) {
90
+ const { renderer, composer, pixelRatio, composerRatio, cheapRatio, cheapComposerRatio } = resolution;
91
+ if (renderer.getPixelRatio() === cheapRatio) {
92
+ renderer.setPixelRatio(pixelRatio);
93
+ }
94
+ if (composer._pixelRatio === cheapComposerRatio) {
95
+ composer.setPixelRatio(composerRatio);
96
+ }
97
+ resolution = null;
98
+ }
99
+ for (const actor of asleep.values()) {
100
+ // The runtime checks identity, so replaced actors/loads cannot inherit
101
+ // a wake, while a data edit cannot strand an actor this profile slept.
102
+ held?.setActorSleeping?.(actor, false);
103
+ }
104
+ asleep.clear();
105
+ boundedLook?.restore();
106
+ boundedLook = null;
107
+ if (bakeQueue?.skipSurfaceBakes === !wantsBoundedLook) {
108
+ if (previousSkip === undefined) {
109
+ delete bakeQueue.skipSurfaceBakes;
110
+ } else {
111
+ bakeQueue.skipSurfaceBakes = previousSkip;
112
+ }
113
+ }
114
+ bakeQueue = null;
115
+ if (held?.files === cheapFiles) {
116
+ // Runtime-generated avatars and asset edits belong to the live file map.
117
+ for (const [path, text] of Object.entries(cheapFiles)) {
118
+ if (!cheapSnapshot.has(path) || cheapSnapshot.get(path) !== text) {
119
+ originalFiles[path] =
120
+ path.endsWith('.pxmodel') && typeof text === 'string' ? text + '\n ' : text;
121
+ }
122
+ }
123
+ for (const path of cheapSnapshot.keys()) {
124
+ if (!Object.hasOwn(cheapFiles, path)) {
125
+ delete originalFiles[path];
126
+ }
127
+ }
128
+ held.files = originalFiles;
129
+ }
130
+ if (
131
+ ownsBake &&
132
+ held &&
133
+ Object.getOwnPropertyDescriptor(held, 'bakesLookLater')?.value === true
134
+ ) {
135
+ delete held.bakesLookLater;
136
+ }
137
+ if (
138
+ ownsEmptyParts &&
139
+ Object.getOwnPropertyDescriptor(held, 'dropsEmptyParts')?.value === true
140
+ ) {
141
+ delete held.dropsEmptyParts;
142
+ }
143
+ held = source = map = districts = originalFiles = cheapFiles = cheapSnapshot = null;
144
+ nextAt = -Infinity;
145
+ ownsBake = false;
146
+ ownsEmptyParts = false;
147
+ active = false;
148
+ district = null;
149
+ }
150
+
151
+ function frame(scene, enabled, now, bounded = false, pointerTargets = null) {
152
+ if (
153
+ !enabled ||
154
+ typeof scene.setActorSleeping !== 'function' ||
155
+ scene.content ||
156
+ scene.requestedScene
157
+ ) {
158
+ restore();
159
+ return;
160
+ }
161
+ if (held !== scene || source !== scene.data || map !== scene.actors || wantsBoundedLook !== bounded) {
162
+ restore();
163
+ districts = readDistricts(scene.data?.weakestDistricts);
164
+ if (!districts) {
165
+ return;
166
+ }
167
+ wantsBoundedLook = bounded;
168
+ held = scene;
169
+ source = scene.data;
170
+ map = scene.actors;
171
+ if (!middle && scene.three) {
172
+ scene.three.lookBake ??= makeLookBake();
173
+ bakeQueue = scene.three.lookBake;
174
+ previousSkip = bakeQueue.skipSurfaceBakes;
175
+ bakeQueue.skipSurfaceBakes = !bounded;
176
+ if (bounded) {boundedLook = makeWeakestLookBake(bakeQueue);}
177
+ }
178
+ if (!middle) {
179
+ originalFiles = scene.files;
180
+ cheapFiles = simplifiedFiles(originalFiles);
181
+ cheapSnapshot = new Map(Object.entries(cheapFiles));
182
+ scene.files = cheapFiles;
183
+ if (!Object.hasOwn(scene, 'bakesLookLater')) {
184
+ ownsBake = true;
185
+ Object.defineProperty(scene, 'bakesLookLater', { value: true, configurable: true });
186
+ }
187
+ }
188
+ }
189
+ const p = scene.actorWith('Player')?.components?.Transform;
190
+ if (!p || !Number.isFinite(p.x) || !Number.isFinite(p.z)) {
191
+ restore();
192
+ return;
193
+ }
194
+ const cell = districts.table.cells.find((c) => insideOutline(c.outline, p.x, p.z))?.id ?? null;
195
+ if (!cell) {
196
+ restore();
197
+ return;
198
+ }
199
+ active = true;
200
+ boundedLook?.frame(scene, now);
201
+ // Use the engine's existing model-build variant, retaining animated and
202
+ // named attachment parts. Its signatures also rebuild the full rig on exit.
203
+ if (!middle && !Object.hasOwn(scene, 'dropsEmptyParts')) {
204
+ ownsEmptyParts = true;
205
+ Object.defineProperty(scene, 'dropsEmptyParts', { value: true, configurable: true });
206
+ }
207
+ const renderer = scene.three?.renderer;
208
+ const composer = scene.three?.composer;
209
+ if (
210
+ !resolution &&
211
+ typeof renderer?.getPixelRatio === 'function' &&
212
+ typeof renderer.setPixelRatio === 'function' &&
213
+ typeof composer?.setPixelRatio === 'function' &&
214
+ Number.isFinite(composer._pixelRatio)
215
+ ) {
216
+ const pixelRatio = renderer.getPixelRatio();
217
+ if (Number.isFinite(pixelRatio) && pixelRatio > 0) {
218
+ const cheapRatio = middle ? pixelRatio * 0.5 : Math.min(pixelRatio, composer._pixelRatio, 0.5);
219
+ const cheapComposerRatio = middle ? composer._pixelRatio * 0.5 : cheapRatio;
220
+ resolution = {
221
+ renderer,
222
+ composer,
223
+ pixelRatio,
224
+ composerRatio: composer._pixelRatio,
225
+ cheapRatio,
226
+ cheapComposerRatio,
227
+ };
228
+ renderer.setPixelRatio(cheapRatio);
229
+ composer.setPixelRatio(cheapComposerRatio);
230
+ }
231
+ }
232
+ // Labels and goal pointers read retained components through getActor,
233
+ // but keep their targets' behaviors and NPCs live too. A newly received
234
+ // target wakes immediately, even inside the district check interval.
235
+ for (const id of pointerTargets ?? []) {
236
+ const actor = asleep.get(id);
237
+ if (actor) {
238
+ scene.setActorSleeping(actor, false);
239
+ asleep.delete(id);
240
+ }
241
+ }
242
+ if (district === cell && now < nextAt) {
243
+ return;
244
+ }
245
+ district = cell;
246
+ nextAt = now + 100;
247
+ for (const [id, row] of districts.actors) {
248
+ const actor = map.get(id);
249
+ if (!actor) {
250
+ continue;
251
+ }
252
+ const c = actor.components;
253
+ const dx = Number.isFinite(c.Transform?.x) ? c.Transform.x - row.origin[0] : 0;
254
+ const dz = Number.isFinite(c.Transform?.z) ? c.Transform.z - row.origin[1] : 0;
255
+ const x0 = row.bounds[0] + dx,
256
+ z0 = row.bounds[1] + dz;
257
+ const x1 = row.bounds[2] + dx,
258
+ z1 = row.bounds[3] + dz;
259
+ // A four-metre safety apron wakes colliders before the player crosses.
260
+ const gapX = Math.max(x0 - p.x, 0, p.x - x1);
261
+ const gapZ = Math.max(z0 - p.z, 0, p.z - z1);
262
+ const near = gapX * gapX + gapZ * gapZ <= 16;
263
+ const protectedActor = c.Player || c.RouteAnchor || c.Body?.type === 'dynamic' || pointerTargets?.has(id);
264
+ const hiddenTemplate = Number.isFinite(c.Transform?.y) && c.Transform.y < -50;
265
+ const sameDistrict =
266
+ dx === 0 && dz === 0
267
+ ? row.districts.includes(cell)
268
+ : insideOutline(districts.table.byId.get(cell).outline, c.Transform?.x, c.Transform?.z);
269
+ const want = protectedActor || (!hiddenTemplate && (sameDistrict || near));
270
+ if (want) {
271
+ if (asleep.has(id)) {
272
+ scene.setActorSleeping(actor, false);
273
+ asleep.delete(id);
274
+ }
275
+ } else if (asleep.get(id) !== actor) {
276
+ scene.setActorSleeping(actor, true);
277
+ asleep.set(id, actor);
278
+ }
279
+ }
280
+ }
281
+ return {
282
+ profile,
283
+ frame,
284
+ restore,
285
+ get active() {
286
+ return active;
287
+ },
288
+ get district() {
289
+ return district;
290
+ },
291
+ get sleeping() {
292
+ return asleep.size;
293
+ },
294
+ };
295
+ }