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,259 @@
1
+ // v1.71 companion: real place hooks, private delivery and public presence.
2
+ import assert from 'node:assert/strict';
3
+ import { register } from 'node:module';
4
+
5
+ register(`data:text/javascript,${encodeURIComponent(`
6
+ import { readFile } from 'node:fs/promises';
7
+ import { fileURLToPath } from 'node:url';
8
+ export async function load(url, context, next) {
9
+ if (url.endsWith('/code/server/hub.js?without-companion')) {
10
+ let source = await readFile(fileURLToPath(url), 'utf8');
11
+ source = source.split('\\n').filter((line) => !line.includes('import * as Companion') && !line.includes('...(' + 'h.place.companion')).join('\\n');
12
+ source = source.replace(/\\s*if \\(h.place.companion === true(?: && h.companionUsed)?\\) \\{[^{}]*\\}(?: else \\{[^{}]*\\})?/g, '');
13
+ if (source.includes('Companion.')) throw new Error('baseline still has a companion code path');
14
+ return { format: 'module', source, shortCircuit: true };
15
+ }
16
+ return next(url, context);
17
+ }
18
+ export async function resolve(specifier, context, next) {
19
+ if (specifier === '@imports/castle.multiplayer-3d/code/server/sceneBodies.js') return { url: 'data:text/javascript,export const readScene = () => globalThis.__hubTestActors;', shortCircuit: true };
20
+ if (context.parentURL?.includes('/kits/base/sdk/') && specifier.startsWith('.') && !specifier.endsWith('.js')) return next(specifier + '.js', context);
21
+ return next(specifier, context);
22
+ }
23
+
24
+ `)}`);
25
+ const { layer } = await import('../code/server/hub.js');
26
+ const { layer: baseline } = await import('../code/server/hub.js?without-companion');
27
+ const Manifest = await import('../code/server/manifest.js');
28
+ const actors = [
29
+ { id: 'player', components: { Player: {}, Transform: { x: 0, y: 1, z: 0 } } },
30
+ { id: 'floor', components: { Transform: { x: 0, y: 0, z: 0 } } },
31
+ ];
32
+ const players = [
33
+ { playerId: 'p1', userId: '101', username: 'Ada', isAnonymous: false },
34
+ { playerId: 'p2', userId: '102', username: 'Bo', isAnonymous: false },
35
+ ];
36
+ const json = (keys = {}) => ({ server: { maxPlayers: 8 }, hub: { contract: 1, title: 'House', ...keys } });
37
+ function boot(keys = {}, options = {}) {
38
+ const sent = [], ops = [], arrivals = [];
39
+ let hub;
40
+ const hooks = { ready(ctx) { hub = ctx; }, arrive(ctx, group) { arrivals.push([ctx.owner ?? null, group.map((p) => p.playerId)]); }, action(ctx, id, actionId) { ops.push([id, actionId]); }, ...(options.hooks ?? {}) };
41
+ const bodies = [];
42
+ const engine = {
43
+ createBody(sim, actor, at) {
44
+ const rb = { at: { ...at }, setEnabled() {}, setNextKinematicTranslation(at) { this.at = { ...at }; }, setNextKinematicRotation() {} };
45
+ bodies.push([actor.id, rb]);
46
+ return rb;
47
+ },
48
+ removeActor(sim, id) { sim.bodies.delete(id); sim.objects.delete(id); },
49
+ };
50
+ globalThis.__hubTestActors = structuredClone(actors);
51
+ const server = (options.layer ?? layer)(json(keys), hooks, {}, () => true, () => null, null, engine);
52
+ const session = { sessionId: options.sessionId ?? 'dev', players: [...players], hub: options.platform ?? null, send(id, msg) { sent.push([id, structuredClone(msg)]); }, broadcast(msg) { sent.push(['all', structuredClone(msg)]); } };
53
+ const world = { timeMs: 0, scenePath: 'scenes/main.scene', objects: new Map(), bodies: new Map(), players: new Map(players.map((p) => [p.playerId, { at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } }])) };
54
+ server.sceneFor(session);
55
+ server.ready(world);
56
+ const say = (id, data) => server.message(session, { playerId: id }, data);
57
+ if (options.hello !== false) {
58
+ for (const id of options.order ?? ['p1', 'p2']) {
59
+ say(id, { k: 'hub-hello', avatar: 0, party: 2 });
60
+ }
61
+ server.place(world);
62
+ }
63
+ const tick = (ms = 50) => { world.timeMs += ms; server.place(world); server.step(world, []); };
64
+ return { server, session, world, hub, sent, ops, say, tick, bodies, arrivals, hooks };
65
+ }
66
+
67
+ const spec = { look: 'lantern', say: 'Come this way', at: 'unknown-is-fine' };
68
+ const wire = (r) => r.sent.filter(([, msg]) => msg.k === 'hub-companion');
69
+ const offer = (r, playerId = 'p1') => wire(r).findLast(([id]) => id === playerId)?.[1];
70
+ let passed = 0;
71
+ async function test(name, fn) { await fn(); passed += 1; console.log(`ok: ${name}`); }
72
+
73
+ await test('v1.78 dress enums, defaults, validation and private delivery', async () => {
74
+ const { check, DRESS } = await import('../code/companionSpec.js');
75
+ for (const [key, ids] of Object.entries(DRESS)) {
76
+ for (const id of ids) { assert.doesNotThrow(() => check({ look: 'bird', dress: { [key]: id } })); }
77
+ for (const bad of [undefined, null, false, '', 'unknown', 1, [], {}]) {
78
+ assert.throws(() => check({ look: 'bird', dress: { [key]: bad } }), TypeError);
79
+ }
80
+ }
81
+ for (const dress of [{}, { species: 'songbird' }]) { assert.deepEqual(check({ look: 'bird', dress }), { look: 'bird' }); }
82
+ for (const dress of [undefined, null, [], Object.create({ species: 'owl' }), { extra: 'owl' }, { [Symbol()]: 'owl' }]) {
83
+ assert.throws(() => check({ look: 'bird', dress }), TypeError);
84
+ }
85
+ assert.throws(() => check({ look: 'lantern', dress: {} }), TypeError);
86
+ const dress = { species: 'owl', wear: 'bow', tint: 'mint' };
87
+ const r = boot({ companion: true });
88
+ assert.equal(r.hub.companionDress, true);
89
+ assert.equal(r.hub.companionPose, true);
90
+ r.hub.companion('p1', { look: 'bird', dress }); r.tick(250);
91
+ assert.deepEqual(wire(r), [['p1', { k: 'hub-companion', c: { look: 'bird', dress }, n: 1 }]]);
92
+ dress.wear = 'scarf';
93
+ assert.equal(offer(r).c.dress.wear, 'bow');
94
+ for (const state of [r.server.join(), r.server.delta()]) { assert(!JSON.stringify(state).includes('dress')); }
95
+ assert(!Object.hasOwn(boot().hub, 'companionDress'));
96
+ assert(!Object.hasOwn(boot().hub, 'companionPose'));
97
+ });
98
+ await test('v1.78 show pose validates privately and absent pose preserves literal wire bytes', async () => {
99
+ const { check } = await import('../code/companionSpec.js');
100
+ assert.deepEqual(check({ look: 'bird', pose: 'show' }), { look: 'bird', pose: 'show' });
101
+ for (const pose of [undefined, null, false, '', 'quiet', 1, [], {}]) {
102
+ assert.throws(() => check({ look: 'bird', pose }), TypeError);
103
+ }
104
+ assert.throws(() => check({ look: 'lantern', pose: 'show' }), TypeError);
105
+ let reads = 0;
106
+ check({ look: 'bird', get pose() { reads++; return 'show'; } }); assert.equal(reads, 1);
107
+ const r = boot({ companion: true });
108
+ r.hub.companion('p1', { look: 'bird', say: 'Chirp!', at: 'goal' }); r.tick(250);
109
+ assert.equal(JSON.stringify(wire(r)), '[["p1",{"k":"hub-companion","c":{"look":"bird","say":"Chirp!","at":"goal"},"n":1}]]');
110
+ r.hub.companion('p1', { look: 'bird', pose: 'show' }); r.tick(250);
111
+ assert.deepEqual(offer(r).c, { look: 'bird', pose: 'show' });
112
+ for (const state of [r.server.join(), r.server.delta()]) { assert(!JSON.stringify(state).includes('pose')); }
113
+ const count = wire(r).length;
114
+ r.hub.companion('p1', { look: 'bird', pose: 'show' }); r.tick(250);
115
+ assert.equal(wire(r).length, count);
116
+ assert.throws(() => r.hub.companion('p1', { look: 'bird', pose: 'bad' }), TypeError);
117
+ assert.deepEqual(offer(r).c, { look: 'bird', pose: 'show' });
118
+ });
119
+ await test('manifest: place-only true or absent, including explicit undefined', () => {
120
+ for (const named of [false, true]) {
121
+ for (const value of [true, false, null, 0, 1, '', 'true', [], {}, undefined]) {
122
+ const keys = named ? { places: { porch: { title: 'Porch', scene: 'scenes/porch.scene', companion: value } } } : { companion: value };
123
+ const read = Manifest.readManifest(json(keys));
124
+ assert.equal(read.errors.some((e) => e.includes('.companion')), value !== true);
125
+ if (value === true) {
126
+ const place = read.manifest.places[named ? 'porch' : 'main'];
127
+ assert.equal(Manifest.publicPlace('main', place).companion, true);
128
+ if (named) assert(!Object.hasOwn(read.manifest.places.main, 'companion'));
129
+ }
130
+ }
131
+ }
132
+ const place = Manifest.readManifest(json()).manifest.places.main;
133
+ assert(!Object.hasOwn(place, 'companion'));
134
+ assert(!Object.hasOwn(Manifest.publicPlace('main', place), 'companion'));
135
+ });
136
+ await test('eligible in arrive; no API in another place, captured API is gated', () => {
137
+ let took;
138
+ boot({ companion: true }, { hooks: { arrive(ctx, group) { took = ctx.companion(group[0].playerId, spec); } } });
139
+ assert.equal(took, true);
140
+ const r = boot({ companion: true, places: { porch: { title: 'Porch', scene: 'scenes/porch.scene' } } });
141
+ const captured = r.hub.companion;
142
+ r.session.place = 'porch'; r.server.sceneFor(r.session);
143
+ assert(!Object.hasOwn(r.hub, 'companion'));
144
+ assert.throws(() => captured('p1', spec), TypeError);
145
+ const waiting = boot({ companion: true }, { hello: false });
146
+ assert.equal(waiting.hub.companion('p1', spec), false);
147
+ });
148
+ await test('one copied follower per player; every private send targets its owner, public is ids alone', () => {
149
+ const r = boot({ companion: true });
150
+ assert(!Object.hasOwn(r.server.join(), 'hubGlow'));
151
+ r.sent.length = 0;
152
+ const copy = { ...spec };
153
+ r.hub.companion('p1', copy); copy.say = 'mutated';
154
+ r.tick(250);
155
+ assert.deepEqual(wire(r), [['p1', { k: 'hub-companion', c: spec, n: 1 }]]);
156
+ const snapshot = r.server.join();
157
+ assert.deepEqual(snapshot.hubGlow, ['p1']);
158
+ assert(!JSON.stringify(snapshot).includes(spec.say));
159
+ assert(!JSON.stringify(snapshot).includes(spec.at));
160
+ assert(!Object.hasOwn(snapshot, 'companion'));
161
+ assert.deepEqual(r.server.delta().hubGlow, ['p1']);
162
+ r.hub.companion('p1', { look: 'bird' }); r.hub.companion('p2', spec); r.tick(250);
163
+ assert.deepEqual(wire(r).slice(1), [['p1', { k: 'hub-companion', c: { look: 'bird' }, n: 2 }], ['p2', { k: 'hub-companion', c: spec, n: 3 }]]);
164
+ assert.deepEqual(r.server.join().hubGlow, ['p1', 'p2']);
165
+ assert.deepEqual(r.server.delta().hubGlow, ['p1', 'p2']);
166
+ assert.equal(r.server.delta(), null);
167
+ r.hub.companion('p1', null); r.tick(250);
168
+ assert.deepEqual(offer(r), { k: 'hub-companion', c: null, n: 4 });
169
+ assert.deepEqual(r.server.delta().hubGlow, ['p2']);
170
+ r.hub.companion('p2', null); r.tick(250);
171
+ assert.deepEqual(r.server.join().hubGlow, []);
172
+ assert.deepEqual(r.server.delta().hubGlow, []);
173
+ const cleared = offer(r, 'p2'); r.sent.length = 0;
174
+ r.say('p2', { k: 'hub-hello', resume: true });
175
+ assert.deepEqual(wire(r), [['p2', cleared]]);
176
+ assert(wire(r).every(([id]) => id === 'p1' || id === 'p2'));
177
+ });
178
+ await test('public glow sorts ids regardless of insertion order', () => {
179
+ const r = boot({ companion: true });
180
+ r.hub.companion('p2', spec); r.hub.companion('p1', { look: 'bird' });
181
+ assert.deepEqual(r.server.join().hubGlow, ['p1', 'p2']);
182
+ });
183
+ await test('validation table is atomic; own fields read once; code point and control rules', () => {
184
+ const r = boot({ companion: true });
185
+ r.hub.companion('p1', spec); r.tick(250);
186
+ const invalid = [undefined, false, [], {}, 'bird', new Date(), Object.create(spec), { look: 'other' }, { look: 'bird', unknown: true }, Object.defineProperty({ look: 'bird' }, 'extra', { value: true }), { look: 'bird', [Symbol()]: 1 }, { look: 'bird', say: undefined }, { look: 'bird', at: undefined }, ...['', ' ', '\u00a0', 'x'.repeat(81), '😀'.repeat(81), 1, 'a\nline', 'a\u2028line', 'a\u2029line', ...Array.from({ length: 32 }, (_, i) => String.fromCodePoint(i)), ...Array.from({ length: 33 }, (_, i) => String.fromCodePoint(0x7f + i)), ...[0x061c, 0x200b, 0x200c, 0x200d, 0x200e, 0x200f, 0x202a, 0x202b, 0x202c, 0x202d, 0x202e, 0x2060, 0x2061, 0x2062, 0x2063, 0x2064, 0x2065, 0x2066, 0x2067, 0x2068, 0x2069, 0xfeff].map((cp) => `a${String.fromCodePoint(cp)}b`)].map((say) => ({ look: 'bird', say })), ...['', 'x'.repeat(65), 1, null].map((at) => ({ look: 'bird', at }))];
187
+ for (const bad of invalid) assert.throws(() => r.hub.companion('p1', bad), TypeError);
188
+ r.tick(250); assert.deepEqual(offer(r), { k: 'hub-companion', c: spec, n: 1 });
189
+ assert.throws(() => r.hub.companion(null, spec), TypeError);
190
+ assert.throws(() => r.hub.companion('missing', {}), TypeError);
191
+ assert.equal(r.hub.companion('missing', spec), false);
192
+ const reads = { look: 0, say: 0, at: 0 }, record = {};
193
+ for (const key of Object.keys(reads)) Object.defineProperty(record, key, { get() { reads[key]++; return spec[key]; } });
194
+ r.hub.companion('p1', record);
195
+ assert.deepEqual(reads, { look: 1, say: 1, at: 1 });
196
+ r.hub.companion('p1', Object.assign(Object.create(null), { look: 'bird', say: '😀'.repeat(80), at: 'x'.repeat(64) }));
197
+ r.tick(250); assert.equal(offer(r).c.say, '😀'.repeat(80)); assert.equal(offer(r).n, 2);
198
+ });
199
+ await test('equal specs send nothing; newest wins, at most four tick sends/s per player', () => {
200
+ const r = boot({ companion: true }); r.sent.length = 0;
201
+ for (let i = 0; i < 10000; i++) r.hub.companion('p1', { look: i % 2 ? 'bird' : 'lantern' });
202
+ assert.deepEqual(wire(r), []); r.tick(250);
203
+ assert.deepEqual(offer(r), { k: 'hub-companion', c: { look: 'bird' }, n: 10000 });
204
+ r.hub.companion('p1', { look: 'bird' }); r.tick(250); assert.equal(wire(r).length, 1);
205
+ r.hub.companion('p1', { look: 'lantern' }); r.hub.companion('p1', { look: 'bird' }); r.tick(250); assert.equal(wire(r).length, 1);
206
+ const times = [], original = r.session.send;
207
+ r.session.send = (id, msg) => { if (msg.k === 'hub-companion') times.push([id, r.world.timeMs]); original(id, msg); };
208
+ for (let i = 0; i < 100; i++) { r.hub.companion('p1', { look: 'bird', say: String(i) }); r.hub.companion('p2', { look: 'lantern', say: String(i) }); r.tick(10); }
209
+ for (const id of ['p1', 'p2']) {
210
+ const own = times.filter(([target]) => target === id).map(([, t]) => t);
211
+ assert.equal(own.length, 4); assert(own.slice(1).every((t, i) => t - own[i] >= 250));
212
+ }
213
+ assert.equal(offer(r).c.say, '75');
214
+ });
215
+ await test('fresh hello replays; avatar hello does not; leave and absent pruning forget and remove glow', () => {
216
+ const r = boot({ companion: true }); r.hub.companion('p1', spec); r.tick(250);
217
+ r.server.delta(); r.sent.length = 0;
218
+ r.say('p1', { k: 'hub-hello', resume: true }); r.tick(250);
219
+ assert.deepEqual(wire(r), [['p1', { k: 'hub-companion', c: spec, n: 1 }]]);
220
+ r.sent.length = 0; r.say('p1', { k: 'hub-hello', again: true }); assert.deepEqual(wire(r), []);
221
+ const body = r.world.players.get('p1');
222
+ r.session.players = [players[1]]; r.world.players.delete('p1'); r.tick();
223
+ assert.deepEqual(r.server.delta().hubGlow, []);
224
+ assert.equal(r.hub.companion('p1', spec), false);
225
+ r.session.players.push(players[0]); r.world.players.set('p1', body); r.sent.length = 0;
226
+ r.say('p1', { k: 'hub-hello', resume: true }); r.tick();
227
+ assert.deepEqual(wire(r), []);
228
+ r.hub.companion('p1', spec); r.tick(250); assert.equal(offer(r).n, 2);
229
+ r.sent.length = 0; r.session.players = [players[1]]; r.tick(250);
230
+ assert.deepEqual(wire(r), []);
231
+ assert.deepEqual(r.server.join().hubGlow, []);
232
+ });
233
+ await test('keyless trace is byte-identical to a session with all companion branches removed', () => {
234
+ const trace = (implementation) => {
235
+ const r = boot({}, { layer: implementation }), snapshots = [];
236
+ assert(!Object.hasOwn(r.hub, 'companion'));
237
+ const take = () => { snapshots.push(JSON.stringify(r.server.join()), JSON.stringify(r.server.delta())); r.tick(250); };
238
+ take(); r.say('p1', { k: 'hub-hello', resume: true }); take();
239
+ r.say('p1', { k: 'hub-companion', c: spec, n: 1 }); take();
240
+ r.hub.wear('p2', { kind: 'halo', color: '#ffffff', rarity: 1 }); take();
241
+ r.session.players = [players[1]]; r.world.players.delete('p1'); take();
242
+ assert.deepEqual(wire(r), []);
243
+ assert(snapshots.every((s) => !s.includes('hubGlow') && !s.includes('companion')));
244
+ return JSON.stringify({ sent: r.sent, snapshots });
245
+ };
246
+ const now = Date.now; Date.now = () => 100000;
247
+ try { assert.equal(trace(layer), trace(baseline)); } finally { Date.now = now; }
248
+ });
249
+ console.log(`${passed} companion tests passed`);
250
+
251
+ await test('an ended visit drops the follower: nothing of it is replayed on a later hello', () => {
252
+ const r = boot({ companion: true });
253
+ r.hub.companion('p1', spec); r.tick(250);
254
+ r.hub.end(['p1']); r.tick(250);
255
+ r.sent.length = 0;
256
+ r.say('p1', { k: 'hub-hello', resume: true }); r.tick(250);
257
+ assert.deepEqual(wire(r).filter(([, m]) => m.k === 'hub-companion'), []);
258
+ assert.deepEqual(r.server.delta().hubGlow ?? [], []);
259
+ });
@@ -0,0 +1,120 @@
1
+ // Real CSS geometry for the engine/kit control seam. Run with CHROME pointing
2
+ // to the QA browser (and BROWSER_WS when using a remote GPU browser).
3
+ import assert from 'node:assert/strict';
4
+ import { readFile } from 'node:fs/promises';
5
+ import { fileURLToPath } from 'node:url';
6
+ import { chromium } from 'playwright-core';
7
+ import { launchChromium, logRenderer } from '../../../experiments/hub-town/qa/launch.mjs';
8
+
9
+ const root = new URL('../../../', import.meta.url);
10
+ const source = await readFile(new URL('../code/systems/hub.js', import.meta.url), 'utf8');
11
+ const setup = source.slice(source.indexOf(' this.chrome.setWorldLabelFocus'), source.indexOf(' Avatar.load(scene);'));
12
+ const browser = await launchChromium(chromium, { executablePath: process.env.CHROME });
13
+ try {
14
+ const page = await browser.newPage();
15
+ await page.route('http://layout.test/**', async route => {
16
+ const path = new URL(route.request().url()).pathname;
17
+ if (path === '/') return route.fulfill({ contentType: 'text/html', body: '<script type="importmap">{"imports":{"three":"/node_modules/three/build/three.module.js"}}</script><body style="margin:0"></body>' });
18
+ const url = new URL(`.${path}`, root);
19
+ assert(fileURLToPath(url).startsWith(fileURLToPath(root)));
20
+ await route.fulfill({ contentType: 'text/javascript', body: await readFile(url, 'utf8') });
21
+ });
22
+ for (const [width, height] of [[844, 390], [667, 375], [932, 430], [914, 411], [1440, 900]]) {
23
+ await page.setViewportSize({ width, height });
24
+ for (const mode of ['legacy', 'overflow', 'safe', 'act']) for (const input of ['touch', 'keyboard']) {
25
+ await page.goto('http://layout.test/');
26
+ await logRenderer(page, 'control layout');
27
+ const result = await page.evaluate(async ({ mode, input, setup }) => {
28
+ const { makeChrome } = await import('/kits/hub-game/code/client/chrome.js');
29
+ const { overlaps } = await import('/kits/hub-game/code/client/safeLayout.js');
30
+ const chrome = makeChrome({ avatarCount: 4, onBack() {}, onAvatar() {}, safeInsets: ['safe', 'act'].includes(mode) });
31
+ const soundChanges = [];
32
+ chrome.soundControl(true, { volume: 0.7, muted: false }, { onMuted: value => soundChanges.push(['muted', value]), onVolume: value => soundChanges.push(['volume', value]) });
33
+ chrome.showPicker(true, 0);
34
+ chrome.setEmotes([['wave', '👋']]); chrome.setSay({ reactions: [], phrases: [] });
35
+ chrome.setHud({ title: 'Town', text: 'Your next step is here.' }, null);
36
+ const { attachOrbitInput } = await import('/kits/physics-3d/engine3d/orbitinput.js');
37
+ const canvas = document.createElement('canvas'); document.body.append(canvas);
38
+ const runtime = { cameraControl: 'orbit', keys: new Set() };
39
+ const engine = attachOrbitInput(canvas, runtime, { set() {} }, () => {});
40
+ runtime.lookInput.listen();
41
+ if (input === 'keyboard') window.dispatchEvent(new KeyboardEvent('keydown', { code: 'KeyW' }));
42
+ else window.dispatchEvent(new PointerEvent('pointerdown', { pointerType: 'touch' }));
43
+ const scene = { persistent: {}, three: { renderer: { domElement: { parentElement: document.body } } } };
44
+ const Hub = { deck: { safeInsets: mode === 'safe', act: mode === 'act' }, hub: {} };
45
+ const context = { chrome };
46
+ const draw = () => {
47
+ new Function('Hub', 'scene', 'worldLabelFocus', setup).call(context, Hub, scene, () => false);
48
+ chrome.grabPrompt(null); chrome.sitPrompt(null); chrome.talkPrompt(null);
49
+ chrome.layoutInteractionRail();
50
+ chrome.setActions([{ id: 'invite-friend', label: 'Invite a friend' }], () => {}, true, 1, mode === 'overflow');
51
+ chrome.frameSafeInsets?.();
52
+ };
53
+ // The actual Act pair includes the talk pill and jump control.
54
+ if (mode === 'act') {
55
+ const { makeAct } = await import('/kits/hub-game/code/client/act.js');
56
+ const { hub } = await import('/kits/hub-game/code/client/state.js');
57
+ hub.place = { id: 'main', act: true };
58
+ hub.prompts = [{ id: 'rowan', verb: 'Talk to Rowan' }];
59
+ const actor = { id: 'rowan', components: { HubNpc: { name: 'Rowan' }, Transform: { x: 1, y: 1, z: 0 } } };
60
+ const act = makeAct(chrome, { perform() {} }, { prepare() {} });
61
+ Object.assign(scene, { getActors: () => [actor], getActor: () => actor, moveInput: { consumeJump() {} } });
62
+ scene.three.camera = { position: { clone: () => ({ set() { return this; }, project: () => ({ x: 0, y: 0, z: 0 }) }) } };
63
+ act.frame(scene, { net: { selfId: () => 'p', send() {} } }, { components: { Transform: { x: 0, y: 1, z: 0 } } }, true);
64
+ }
65
+ // Exercise the engine's cached cadence, including observer delivery
66
+ // before paint. A debug layout report would force a fresh measurement
67
+ // and conceal stale or drifting placement in the actual frame path.
68
+ const paint = () => new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)));
69
+ draw(); await paint(); draw(); await paint();
70
+ await new Promise(resolve => setTimeout(resolve, 550));
71
+ for (let frame = 0; frame < 8; frame++) {draw(); await paint();}
72
+ chrome.setLabels([{ id: 'rowan', x: innerWidth - 32, y: 84, text: "Hi, I'm Rowan!", npc: true, speech: true, opacity: 1 }]);
73
+ chrome.flushWorldLabels();
74
+ const greeting = [...document.querySelectorAll('div')].find(node => node.textContent === "Hi, I'm Rowan!" && node.children.length === 0);
75
+ const soundBox = document.querySelector('[data-hub="sound"]').getBoundingClientRect();
76
+ const greetingHit = greeting && getComputedStyle(greeting).visibility !== 'hidden' && overlaps(greeting.getBoundingClientRect(), soundBox);
77
+ const nodes = [...document.querySelectorAll('button')].filter(node => ['Character', 'Invite a friend'].includes(node.textContent) || /^(Emote|Quick chat|Shift lock|Sound:)/.test(node.getAttribute('aria-label') ?? '') || ['act', 'jump', 'prompt'].includes(node.dataset.hubAct));
78
+ const controls = nodes.filter(node => node.getBoundingClientRect().width > 0 && getComputedStyle(node).visibility !== 'hidden').map(node => ({ name: node.getAttribute('aria-label') || node.textContent, ...Object.fromEntries(['left','right','top','bottom','width','height'].map(key => [key, node.getBoundingClientRect()[key]])) }));
79
+ const collisions = [];
80
+ for (let i = 0; i < controls.length; i++) for (let j = i + 1; j < controls.length; j++) if (overlaps(controls[i], controls[j])) collisions.push([controls[i].name, controls[j].name]);
81
+ const corners = [{ left: 0, right: 64, top: 0, bottom: 56 }, { left: innerWidth - 64, right: innerWidth, top: 0, bottom: 56 }];
82
+ const cornerHits = controls.filter(box => corners.some(corner => overlaps(box, corner)));
83
+ const outside = controls.filter(box => box.left < 0 || box.top < 0 || box.right > innerWidth || box.bottom > innerHeight);
84
+ const prompt = document.querySelector('[data-hub="hud-prompt"]');
85
+ const promptBox = prompt.getBoundingClientRect();
86
+ const hud = { text: prompt.textContent, visible: getComputedStyle(prompt).display !== 'none' && getComputedStyle(prompt).visibility !== 'hidden',
87
+ left: promptBox.left, right: promptBox.right, top: promptBox.top, bottom: promptBox.bottom, width: promptBox.width, height: promptBox.height };
88
+ const promptHits = controls.filter(box => overlaps(box, hud));
89
+ const sound = document.querySelector('[data-hub="sound"]');
90
+ sound.dispatchEvent(new PointerEvent('pointerdown'));
91
+ draw();
92
+ chrome.flushSafeInsets?.();
93
+ const card = document.querySelector('[data-hub="sound-card"]');
94
+ const popup = card.getBoundingClientRect();
95
+ const popupHits = nodes.filter(node => node !== sound && node.getBoundingClientRect().width > 0 && getComputedStyle(node).visibility !== 'hidden' && overlaps(node.getBoundingClientRect(), popup)).map(node => node.getAttribute('aria-label') || node.textContent);
96
+ const mute = [...card.querySelectorAll('button')][0], volume = card.querySelector('input');
97
+ const reachable = [mute, volume].every(node => { const r = node.getBoundingClientRect(); return node.contains(document.elementFromPoint(r.left + r.width / 2, r.top + r.height / 2)); });
98
+ mute.dispatchEvent(new PointerEvent('pointerdown'));
99
+ volume.value = '35'; volume.dispatchEvent(new Event('input'));
100
+ sound.dispatchEvent(new PointerEvent('pointerdown'));
101
+ engine.detach(); chrome.dispose(); canvas.remove();
102
+ return { greetingHit: Boolean(greetingHit), controls, collisions, cornerHits, outside, hud, promptHits, popupHits, reachable, soundChanges, height: innerHeight };
103
+ }, { mode, input, setup });
104
+ assert.equal(result.controls.length, (mode === 'act' ? 9 : 6) - (input === 'touch' ? 1 : 0), `${mode}: required controls and talk pill measured`);
105
+ assert.equal(result.controls.some(box => box.name.startsWith('Shift lock')), input === 'keyboard', 'Shift lock follows input modality');
106
+ assert.deepEqual(result.collisions, [], `${width}x${height} ${mode} ${input}`);
107
+ assert.deepEqual(result.cornerHits, [], 'reserved corners');
108
+ assert.deepEqual(result.outside, [], 'viewport bounds');
109
+ assert(result.hud.visible && result.hud.width > 0 && result.hud.height > 0, 'HUD prompt remains visible');
110
+ assert.equal(result.hud.text, 'Your next step is here.');
111
+ assert(result.hud.top > result.height / 2 && result.hud.bottom <= result.height - 54, 'HUD prompt retains its bottom band');
112
+ assert.deepEqual(result.promptHits, [], 'HUD prompt clears the controls');
113
+ assert.equal(result.greetingHit, false, 'Rowan greeting yields to Sound');
114
+ assert.deepEqual(result.popupHits, [], 'Sound popup clears the control column');
115
+ assert(result.reachable, 'Mute and Volume receive taps');
116
+ assert.deepEqual(result.soundChanges, [['muted', true], ['volume', 0.35]]);
117
+ console.log(`${width}x${height} ${mode} ${input}: ${result.controls.length} controls clear`);
118
+ }
119
+ }
120
+ } finally { await browser.close(); }
@@ -0,0 +1,205 @@
1
+ import assert from 'node:assert/strict';
2
+ import * as THREE from 'three';
3
+ import { crowdNamesFor, layoutCrowdNames, makeCrowdNames, MAX_CANDIDATES, MIN_FONT_PX, readableSpriteBox, spriteBox } from '../code/client/crowdNames.js';
4
+ import { placeLabels } from '../code/client/padOccupancy.js';
5
+
6
+ const box = (x, y = 80, w = 50, h = 20) => ({ left: x, right: x + w, top: y, bottom: y + h });
7
+ const player = (id, x, screen = x * 100 + 20, options = {}) => ({
8
+ id,
9
+ friend: options.friend === true,
10
+ distance: options.distance ?? Math.abs(x),
11
+ at: { x, z: options.z ?? 0 },
12
+ box: options.box ?? box(screen),
13
+ });
14
+ const view = { w: 844, h: 390 };
15
+ const run = (state, candidates, now = 0, options = {}) => layoutCrowdNames(state, candidates, { now, view: options.view ?? view, obstacles: options.obstacles ?? [] });
16
+
17
+ {
18
+ const state = makeCrowdNames();
19
+ // Display text is deliberately duplicated and absent from allocator input:
20
+ // stable session ids, never name or roster order, settle the tie.
21
+ const candidates = Array.from({ length: 12 }, (_, index) => player(`p${String(index).padStart(2, '0')}`, index * 0.2, 20 + index * 60, { distance: 3 }));
22
+ const result = run(state, [...candidates].reverse());
23
+ assert.deepEqual([...result.visible].sort(), ['p00', 'p01']);
24
+ assert.equal(result.summary.count, 10);
25
+ assert.equal(result.pairTests, 66, 'the twelve-player fixture makes at most 66 pair tests');
26
+ }
27
+
28
+ {
29
+ const state = makeCrowdNames();
30
+ const incumbent = player('a', 0, 100, { distance: 1 });
31
+ assert.deepEqual([...run(state, [incumbent], 0).visible], ['a']);
32
+ const friend = player('b', 0.2, 110, { friend: true, distance: 2 });
33
+ assert.deepEqual([...run(state, [incumbent, friend], 100).visible], ['b'], 'friend priority wins even during the incumbent hold');
34
+ friend.friend = false;
35
+ assert.deepEqual([...run(state, [incumbent, friend], 150).visible], ['a'], 'friend revocation clears retained priority immediately');
36
+ }
37
+
38
+ {
39
+ const state = makeCrowdNames();
40
+ const incumbent = player('a', 0, 100, { distance: 10 });
41
+ assert.deepEqual([...run(state, [incumbent], 0).visible], ['a']);
42
+ const newcomer = player('b', 0.2, 110, { distance: 1 });
43
+ assert.deepEqual([...run(state, [incumbent, newcomer], 600).visible], ['b'], 'distance ranking takes over when a newcomer arrives after the retained-slot hold expires');
44
+ }
45
+
46
+ {
47
+ const unavailable = [player('b', 0, 100, { distance: 2 }), player('a', 0.2, 110, { distance: 2 })];
48
+ assert.deepEqual([...run(makeCrowdNames(), unavailable).visible], ['a'], 'without friend data stable id settles an equal collision');
49
+ }
50
+
51
+ {
52
+ const state = makeCrowdNames();
53
+ const farApart = [player('a', 0, 100), player('b', 20, 110)];
54
+ const result = run(state, farApart);
55
+ assert.equal(result.visible.size, 1, 'far-apart players whose screen rectangles overlap still collide');
56
+ assert.equal(result.summary.count, 1);
57
+ }
58
+
59
+ {
60
+ const state = makeCrowdNames();
61
+ const nearby = [player('a', 0, 50), player('b', 0.9, 180), player('c', 1.8, 310)];
62
+ let result = run(state, nearby, 0);
63
+ assert.equal(result.visible.size, 2, 'a connected metre-proximity group draws at most two names');
64
+ assert.equal(result.summary.count, 1);
65
+ nearby[1].at.x = 1.1;
66
+ run(state, nearby.slice(0, 2), 20);
67
+ assert.equal(state.nearPairs.size, 1, 'world grouping leaves at the wider hysteresis distance');
68
+ nearby[1].at.x = 1.3;
69
+ run(state, nearby.slice(0, 2), 40);
70
+ assert.equal(state.nearPairs.size, 0);
71
+ }
72
+
73
+ {
74
+ const state = makeCrowdNames();
75
+ const a = player('a', 0, 100);
76
+ const b = player('b', 0.2, 110);
77
+ assert.deepEqual([...run(state, [a, b], 0).visible], ['a']);
78
+ b.at.x = 10;
79
+ b.box = box(300);
80
+ assert.deepEqual([...run(state, [a, b], 100).visible], ['a'], 'a suppressed candidate does not restore immediately');
81
+ assert.deepEqual([...run(state, [a, b], 349).visible], ['a']);
82
+ assert.deepEqual([...run(state, [a, b], 350).visible].sort(), ['a', 'b'], 'eight-pixel clearance held for 250ms restores the name');
83
+ run(state, [b], 351);
84
+ assert.equal(state.chosen.has('a'), false, 'departure drops retained history immediately');
85
+ }
86
+
87
+ {
88
+ const state = makeCrowdNames();
89
+ const blocked = player('a', 0, 100);
90
+ assert.equal(run(state, [blocked], 0, { obstacles: [box(90, 70, 90, 60)] }).visible.size, 0);
91
+ const clipped = player('edge', 2, 0, { box: box(2) });
92
+ const result = run(makeCrowdNames(), [clipped]);
93
+ assert.equal(result.visible.size, 0, 'partially clipped tags are suppressed');
94
+ assert.equal(result.summary, null, 'offscreen/clipped names do not contribute to a count');
95
+ }
96
+
97
+ {
98
+ const players = Array.from({ length: 6 }, (_, index) => player(`p${index}`, index * 0.1, 20 + index * 70));
99
+ const result = run(makeCrowdNames(), players, 0, { view: { w: 509, h: 218 } });
100
+ assert.equal(result.visible.size, 0, '509x218 suppresses every individual name');
101
+ assert.equal(result.summary.count, 6);
102
+ assert.equal(result.summary.tiny, true);
103
+ }
104
+
105
+ {
106
+ const many = Array.from({ length: 40 }, (_, index) => player(`p${String(index).padStart(2, '0')}`, index * 0.05, 10 + (index % 10) * 70, { distance: index }));
107
+ const result = run(makeCrowdNames(), many);
108
+ assert.equal(result.considered, MAX_CANDIDATES);
109
+ assert.equal(result.pairTests, (MAX_CANDIDATES * (MAX_CANDIDATES - 1)) / 2, 'pair work stays bounded beyond the fixture');
110
+ }
111
+
112
+ {
113
+ const holder = {};
114
+ const net = {};
115
+ const data = {}, place = {};
116
+ const first = crowdNamesFor(holder, { scene: 'town', data, net, place, visit: 'self:0' });
117
+ first.chosen.add('a');
118
+ assert.notEqual(crowdNamesFor(holder, { scene: 'town', data, net, place, visit: 'self:1' }), first, 'same-net WORLD reconnect resets visit history');
119
+ }
120
+
121
+ {
122
+ const sprite = { position: { x: 100, y: 100, z: 0 }, scale: { x: 40, y: 20 } };
123
+ const cam = { matrixWorld: { elements: [1, 0, 0, 0, 0, 1, 0, 0] } };
124
+ const projected = spriteBox(sprite, cam, view, (_cam, x, y) => ({ x, y }));
125
+ assert.deepEqual(projected, { left: 80, right: 120, top: 90, bottom: 110 }, 'final sprite scale is projected in camera billboard axes');
126
+ }
127
+
128
+ {
129
+ const sprite = { position: { x: 100, y: 100, z: 0 }, scale: { x: 40, y: 20 } };
130
+ const cam = { matrixWorld: { elements: [1, 0, 0, 0, 0, 1, 0, 0] } };
131
+ const project = (_cam, x, y) => ({ x, y });
132
+ const result = readableSpriteBox(sprite, cam, view, project);
133
+ assert.ok(result.resized, 'a plate below the E readability floor is enlarged');
134
+ assert.ok(Math.abs((result.box.bottom - result.box.top) * 44 / 68 - MIN_FONT_PX) < 1e-9, 'the projected canvas font reaches 15 CSS pixels');
135
+ assert.deepEqual(result.box, spriteBox(sprite, cam, view, project), 'the collision box is reprojected at the final scale and camera');
136
+ assert.equal((result.box.left + result.box.right) / 2, 100, 'enlarging preserves the avatar association centre');
137
+ const zoomed = { position: sprite.position, scale: { x: 40, y: 20 } };
138
+ assert.equal(readableSpriteBox(zoomed, cam, view, (_cam, x, y) => ({ x: x * 2, y: y * 2 })).resized, null, 'a current zoom that already reads above the floor is untouched');
139
+ }
140
+
141
+ {
142
+ const project3d = (cam, x, y, z, viewport) => {
143
+ const point = new THREE.Vector3(x, y, z).project(cam);
144
+ if (point.z < -1 || point.z > 1) {return null;}
145
+ return { x: ((point.x + 1) / 2) * viewport.w, y: ((1 - point.y) / 2) * viewport.h };
146
+ };
147
+ const setCamera = (cam, angle, distance, update = false) => {
148
+ cam.position.set(-distance * Math.sin(angle), 7, distance * Math.cos(angle));
149
+ cam.lookAt(0, 1, 0);
150
+ if (update) {cam.updateMatrixWorld();}
151
+ };
152
+ const makeCamera = () => new THREE.PerspectiveCamera(50, view.w / view.h, 0.1, 100);
153
+ const makeSprites = () => ['a', 'b'].map((id) => ({ id, position: new THREE.Vector3(-2, 2, -2), scale: new THREE.Vector3(1.5, 0.35, 1) }));
154
+ const fontPx = (bounds) => (bounds.bottom - bounds.top) * 44 / 68;
155
+ const touches = (a, b, gap = 0) => a.left - gap < b.right && b.left - gap < a.right && a.top - gap < b.bottom && b.top - gap < a.bottom;
156
+ const allocate = (cam, sprites) => {
157
+ const candidates = sprites.map((sprite, index) => {
158
+ const geometry = readableSpriteBox(sprite, cam, view, project3d);
159
+ return { id: sprite.id, friend: false, distance: index + 1, at: { x: sprite.position.x, z: sprite.position.z }, ...geometry };
160
+ });
161
+ const result = run(makeCrowdNames(), candidates);
162
+ const selected = candidates.find((candidate) => result.visible.has(candidate.id));
163
+ const size = { w: 81, h: 26 };
164
+ const item = {
165
+ id: 'crowd:summary',
166
+ text: '+1 more',
167
+ x: result.summary.x,
168
+ y: result.summary.y,
169
+ box: {
170
+ left: result.summary.x - size.w / 2,
171
+ right: result.summary.x + size.w / 2,
172
+ top: result.summary.y - size.h,
173
+ bottom: result.summary.y,
174
+ },
175
+ };
176
+ const summary = placeLabels([item], null, [selected.box], view, () => size)[0];
177
+ return { selected, summary };
178
+ };
179
+
180
+ const staleCamera = makeCamera();
181
+ const staleSprites = makeSprites();
182
+ setCamera(staleCamera, 0.5, 9, true);
183
+ setCamera(staleCamera, 0.3, 8);
184
+ const stale = allocate(staleCamera, staleSprites);
185
+ assert.ok(stale.selected.resized, 'the stale view matrix appears to reach the readability floor');
186
+ assert.ok(Math.abs(fontPx(stale.selected.box) - MIN_FONT_PX) < 1e-9);
187
+ staleCamera.updateMatrixWorld(); // What WebGLRenderer does after Hub.update.
188
+ const staleRendered = spriteBox(staleSprites[0], staleCamera, view, project3d);
189
+ assert.ok(fontPx(staleRendered) < MIN_FONT_PX, 'the renderer camera update exposes stale readability geometry');
190
+ assert.ok(touches(staleRendered, stale.summary.box, 6), 'the renderer camera update moves the chosen plate into the stale summary');
191
+
192
+ const currentCamera = makeCamera();
193
+ const currentSprites = makeSprites();
194
+ setCamera(currentCamera, 0.5, 9, true);
195
+ setCamera(currentCamera, 0.3, 8);
196
+ currentCamera.updateMatrixWorld(); // E mirrors the root camera update before its shared projection pass.
197
+ const current = allocate(currentCamera, currentSprites);
198
+ currentCamera.updateMatrixWorld(); // The later renderer update is now geometry-neutral.
199
+ const currentRendered = spriteBox(currentSprites[0], currentCamera, view, project3d);
200
+ assert.deepEqual(currentRendered, current.selected.box, 'E allocates against the same camera geometry the renderer draws');
201
+ assert.ok(Math.abs(fontPx(currentRendered) - MIN_FONT_PX) < 1e-9, 'the rendered plate keeps the 15 CSS pixel floor');
202
+ assert.equal(touches(currentRendered, current.summary.box, 6), false, 'the rendered plate keeps summary clearance');
203
+ }
204
+
205
+ console.log('crowd names: stable privacy-safe ranking, grouping, hysteresis, tiny view and bounded work passed');