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,298 @@
1
+ // v1.74 action chips: real hub hooks, private offers and current-id routing.
2
+ import assert from 'node:assert/strict';
3
+ import fs from 'node:fs';
4
+ import os from 'node:os';
5
+ import path from 'node:path';
6
+ import { register } from 'node:module';
7
+
8
+ register(`data:text/javascript,${encodeURIComponent(`
9
+ export async function resolve(specifier, context, next) {
10
+ if (specifier === '@imports/castle.multiplayer-3d/code/server/sceneBodies.js') return { url: 'data:text/javascript,export const readScene = () => globalThis.__hubTestActors;', shortCircuit: true };
11
+ if (context.parentURL?.includes('/kits/base/sdk/') && specifier.startsWith('.') && !specifier.endsWith('.js')) return next(specifier + '.js', context);
12
+ return next(specifier, context);
13
+ }
14
+
15
+ `)}`);
16
+ const { layer } = await import('../code/server/hub.js');
17
+ const Manifest = await import('../code/server/manifest.js');
18
+ const check = (await import('./check.mjs')).default;
19
+ const actors = [
20
+ { id: 'player', components: { Player: {}, Transform: { x: 0, y: 1, z: 0 } } },
21
+ { id: 'floor', components: { Transform: { x: 0, y: 0, z: 0 } } },
22
+ ];
23
+ const players = [
24
+ { playerId: 'p1', userId: '101', username: 'Ada', isAnonymous: false },
25
+ { playerId: 'p2', userId: '102', username: 'Bo', isAnonymous: false },
26
+ ];
27
+ const json = (keys = {}) => ({ server: { maxPlayers: 8 }, hub: { contract: 1, title: 'House', ...keys } });
28
+ function boot(keys = {}, options = {}) {
29
+ const sent = [], ops = [], arrivals = [];
30
+ let hub;
31
+ 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 ?? {}) };
32
+ const bodies = [];
33
+ const engine = {
34
+ createBody(sim, actor, at) {
35
+ const rb = { at: { ...at }, setEnabled() {}, setNextKinematicTranslation(at) { this.at = { ...at }; }, setNextKinematicRotation() {} };
36
+ bodies.push([actor.id, rb]);
37
+ return rb;
38
+ },
39
+ removeActor(sim, id) { sim.bodies.delete(id); sim.objects.delete(id); },
40
+ };
41
+ globalThis.__hubTestActors = structuredClone(actors);
42
+ const server = layer(json(keys), hooks, {}, () => true, () => null, null, engine);
43
+ 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)]); } };
44
+ 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() {} } }])) };
45
+ server.sceneFor(session);
46
+ server.ready(world);
47
+ const say = (id, data) => server.message(session, { playerId: id }, data);
48
+ if (options.hello !== false) {
49
+ for (const id of options.order ?? ['p1', 'p2']) {
50
+ say(id, { k: 'hub-hello', avatar: 0, party: 2 });
51
+ }
52
+ server.place(world);
53
+ }
54
+ const tick = (ms = 50) => { world.timeMs += ms; server.place(world); server.step(world, []); };
55
+ return { server, session, world, hub, sent, ops, say, tick, bodies, arrivals, hooks };
56
+ }
57
+ const items = [{ id: 'start', label: 'Start' }, { id: 'sit_down', label: 'Sit down' }];
58
+ const wire = (r) => r.sent.filter(([, msg]) => msg.k === 'hub-actions');
59
+ let passed = 0;
60
+ async function test(name, fn) { await fn(); passed += 1; console.log(`ok: ${name}`); }
61
+
62
+ await test('manifest and publish check: true or absent only, main and named places', async () => {
63
+ const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'hub-actions-'));
64
+ try {
65
+ fs.mkdirSync(path.join(dir, 'scenes'));
66
+ fs.writeFileSync(path.join(dir, 'scenes/main.scene'), JSON.stringify({ actors }));
67
+ for (const named of [false, true]) {
68
+ for (const value of [true, false, null, 0, 1, '', 'true', [], {}, undefined]) {
69
+ const keys = named ? { places: { porch: { title: 'Porch', scene: 'scenes/main.scene', actions: value } } } : { actions: value };
70
+ const read = Manifest.readManifest(json(keys));
71
+ const valid = value === true;
72
+ assert.equal(read.errors.some((e) => e.includes('.actions')), !valid, `read ${named}:${String(value)}`);
73
+ fs.writeFileSync(path.join(dir, 'castle.json'), JSON.stringify({ ...json(keys), server: { main: 'code/server/index.js', maxPlayers: 8 } }));
74
+ const published = await check({ deckDir: dir, self: true });
75
+ assert.equal(published.errors.some((e) => e.includes('.actions')), value !== true && value !== undefined);
76
+ if (value === true) {
77
+ assert.equal(read.manifest.places[named ? 'porch' : 'main'].actions, true);
78
+ }
79
+ }
80
+ }
81
+ const r = Manifest.readManifest(json()).manifest;
82
+ assert(!Object.hasOwn(r.places.main, 'actions'));
83
+ assert(!Object.hasOwn(Manifest.publicPlace('main', r.places.main), 'actions'));
84
+ } finally {
85
+ fs.rmSync(dir, { recursive: true });
86
+ }
87
+ });
88
+ await test('actions are place-only and a call from arrive is already eligible', () => {
89
+ const keys = { actions: true, places: { porch: { title: 'Porch', scene: 'scenes/porch.scene' } } };
90
+ const r = boot(keys);
91
+ assert.equal(typeof r.hub.actions, 'function');
92
+ const captured = r.hub.actions;
93
+ r.session.place = 'porch'; r.server.sceneFor(r.session);
94
+ assert(!Object.hasOwn(r.hub, 'actions'));
95
+ r.say('p1', { k: 'hub-action', id: 'start' }); assert.deepEqual(r.ops, []);
96
+ assert.throws(() => captured('p1', items), TypeError);
97
+ let applied;
98
+ boot({ actions: true }, { hooks: { arrive(ctx, group) { applied = ctx.actions(group[0].playerId, items); } } });
99
+ assert.equal(applied, true);
100
+ });
101
+ const offer = (r, playerId = 'p1') => wire(r).findLast(([id]) => id === playerId)?.[1];
102
+ const press = (r, playerId = 'p1', id = 'start') => r.say(playerId, { k: 'hub-action', id, n: offer(r, playerId)?.n });
103
+
104
+ await test('validation is atomic; private copies, clear and same-list suppression', () => {
105
+ const r = boot({ actions: true });
106
+ assert.equal(r.hub.actions('p1', [{ id: 'a'.repeat(24), label: 'x'.repeat(16) }, { id: 'b_1-2', label: 'B' }, { id: 'c', label: 'C' }]), true);
107
+ assert.equal(r.hub.actions('p1', items), true);
108
+ r.tick(250);
109
+ assert.deepEqual(wire(r).at(-1), ['p1', { k: 'hub-actions', items, n: 2 }]);
110
+ const count = wire(r).length;
111
+ assert.equal(r.hub.actions('p1', structuredClone(items)), true);
112
+ r.tick(250); assert.equal(wire(r).length, count);
113
+ for (const invalid of [undefined, false, {}, 'start', [null], [,], [{ id: 'A', label: 'Go' }], [{ id: '1start', label: 'Go' }], [{ id: 'start!', label: 'Go' }], [{ id: 'start\n', label: 'Go' }], [{ id: 'a'.repeat(25), label: 'Go' }], [{ id: 'start', label: '' }], [{ id: 'start', label: 'x'.repeat(17) }], [{ id: 'start', label: 1 }], [{ id: 'start', label: 'Go', extra: true }], [items[0], items[0]], [...items, items[0], items[0]]]) {
114
+ assert.throws(() => r.hub.actions('p1', invalid), TypeError);
115
+ assert.equal(wire(r).length, count);
116
+ }
117
+ assert.throws(() => r.hub.actions(null, items), TypeError);
118
+ assert.equal(r.hub.actions('missing', items), false);
119
+ assert.throws(() => r.hub.actions('missing', [{}]), TypeError);
120
+ const copy = structuredClone(items);
121
+ r.hub.actions('p2', copy); copy[0].id = 'mutated'; r.tick(250); press(r, 'p2');
122
+ assert.deepEqual(r.ops, [['p2', 'start']]);
123
+ r.hub.actions('p1', []); r.tick(250);
124
+ assert.deepEqual(wire(r).at(-1), ['p1', { k: 'hub-actions', items: null, n: 4 }]);
125
+ const clearCount = wire(r).length;
126
+ r.hub.actions('p1', null); r.hub.actions('p1', []); r.tick(250);
127
+ assert.equal(wire(r).length, clearCount);
128
+ assert(!Object.hasOwn(r.server.join(), 'actions'));
129
+ assert(!Object.hasOwn(r.server.delta() ?? {}, 'actions'));
130
+ });
131
+ await test('plain own-property records: getter values read exactly once, then validated and copied', () => {
132
+ const r = boot({ actions: true });
133
+ let ids = 0, labels = 0;
134
+ const item = {
135
+ get id() { ids += 1; return ids === 1 ? 'start' : 'x'.repeat(1000000); },
136
+ get label() { labels += 1; return labels === 1 ? 'Start' : 'x'.repeat(1000000); },
137
+ };
138
+ r.hub.actions('p1', [item]); r.tick(250);
139
+ assert.equal(ids, 1); assert.equal(labels, 1);
140
+ assert.deepEqual(offer(r), { k: 'hub-actions', items: [items[0]], n: 1 });
141
+ class Item { constructor() { this.id = 'start'; this.label = 'Start'; } }
142
+ const missing = { label: 'Start' };
143
+ const unknown = Object.defineProperty({ ...items[0] }, 'extra', { value: true });
144
+ for (const bad of [new Item(), new Date(), Object.create(items[0]), missing, unknown, { ...items[0], [Symbol('extra')]: true }, []]) {
145
+ assert.throws(() => r.hub.actions('p1', [bad]), TypeError);
146
+ }
147
+ // Plain records with a null prototype have their own fields too.
148
+ r.hub.actions('p1', [Object.assign(Object.create(null), items[0])]);
149
+ r.tick(250); assert.equal(offer(r).n, 1);
150
+ });
151
+ await test('labels count code points, reject whitespace-only, every C0/C1 and listed direction character', () => {
152
+ const r = boot({ actions: true });
153
+ const label = '😀'.repeat(16);
154
+ r.hub.actions('p1', [{ id: 'start', label }]); r.tick(250);
155
+ assert.equal(offer(r).items[0].label, label);
156
+ for (const bad of ['😀'.repeat(17), '', ' ', '\t\n', '\u00a0\u2003', ...Array.from({ length: 32 }, (_, i) => `a${String.fromCodePoint(i)}b`), ...Array.from({ length: 33 }, (_, i) => `a${String.fromCodePoint(0x7f + i)}b`), ...[0x202a, 0x202b, 0x202c, 0x202d, 0x202e, 0x2066, 0x2067, 0x2068, 0x2069, 0x200e, 0x200f].map((cp) => `a${String.fromCodePoint(cp)}b`)]) {
157
+ assert.throws(() => r.hub.actions('p1', [{ id: 'start', label: bad }]), TypeError);
158
+ }
159
+ r.tick(250); assert.equal(offer(r).n, 1);
160
+ });
161
+ await test('routing: current version and offered id for arrived connected senders only', () => {
162
+ const r = boot({ actions: true });
163
+ r.hub.actions('p1', items); r.hub.actions('p2', [{ id: 'other', label: 'Other' }]); r.tick(250);
164
+ press(r); press(r, 'p1', 'other');
165
+ for (const msg of [{}, { id: 1 }, { id: null }, { id: [] }, { id: 'start', extra: 1 }]) r.say('p1', { k: 'hub-action', n: offer(r).n, ...msg });
166
+ assert.deepEqual(r.ops, [['p1', 'start']]);
167
+ r.tick(2000);
168
+ r.hub.actions('p1', [{ id: 'new', label: 'New' }]);
169
+ press(r); r.tick(250); press(r, 'p1', 'new');
170
+ r.hub.actions('p1', null); press(r, 'p1', 'new');
171
+ assert.deepEqual(r.ops, [['p1', 'start'], ['p1', 'new']]);
172
+ r.hub.actions('p2', items); r.tick(250); r.session.players = [players[0]];
173
+ press(r, 'p2'); assert.equal(r.ops.length, 2);
174
+ const unarrived = boot({ actions: true }, { hello: false });
175
+ assert.equal(unarrived.hub.actions('p1', items), false);
176
+ unarrived.say('p1', { k: 'hub-action', id: 'start', n: 1 }); assert.deepEqual(unarrived.ops, []);
177
+ });
178
+ await test('reused ids and null/re-offer reject stale versions, including before the next send', () => {
179
+ const r = boot({ actions: true }); r.hub.actions('p1', [items[0]]); r.tick(250);
180
+ const old = offer(r).n;
181
+ r.hub.actions('p1', [{ id: 'start', label: 'Start again' }]);
182
+ r.say('p1', { k: 'hub-action', id: 'start', n: old }); assert.deepEqual(r.ops, []);
183
+ r.tick(250); assert.equal(offer(r).n, old + 1); press(r);
184
+ r.hub.actions('p1', null); r.hub.actions('p1', [items[0]]);
185
+ r.say('p1', { k: 'hub-action', id: 'start', n: old }); assert.equal(r.ops.length, 1);
186
+ r.tick(250); assert.equal(offer(r).n, old + 3); press(r); assert.equal(r.ops.length, 2);
187
+ });
188
+ await test('press version is required and must be a safe integer', () => {
189
+ const r = boot({ actions: true }); r.hub.actions('p1', items); r.tick(250);
190
+ for (const n of [undefined, null, true, '1', 1.5, NaN, Infinity, Number.MAX_SAFE_INTEGER + 1]) {
191
+ r.say('p1', { k: 'hub-action', id: 'start', n });
192
+ }
193
+ assert.deepEqual(r.ops, []); r.tick(1000); press(r); assert.equal(r.ops.length, 1);
194
+ });
195
+ await test('10,000 recorded changes coalesce; four sends/s per player, newest wins and sent-list equality suppresses', () => {
196
+ const r = boot({ actions: true }); r.sent.length = 0;
197
+ const a = [{ id: 'start', label: 'A' }], b = [{ id: 'start', label: 'B' }];
198
+ for (let i = 0; i < 10000; i++) r.hub.actions('p1', i % 2 ? b : a);
199
+ assert.deepEqual(wire(r), []);
200
+ r.tick(250); assert.deepEqual(wire(r), [['p1', { k: 'hub-actions', items: b, n: 10000 }]]);
201
+ for (let i = 0; i < 10000; i++) r.hub.actions('p1', i % 2 ? b : a);
202
+ r.tick(250); assert.equal(wire(r).length, 1, 'equal last-sent list is suppressed despite intermediate recordings');
203
+ // Back at the list the player was sent, its version stands: what they see can be pressed.
204
+ press(r); assert.deepEqual(r.ops, [['p1', 'start']]); r.ops.length = 0;
205
+ r.hub.actions('p1', a); r.hub.actions('p2', a); r.tick(0);
206
+ assert.equal(wire(r).length, 3, 'budgets are per player');
207
+ for (let i = 0; i < 4; i++) {
208
+ r.hub.actions('p1', i % 2 ? a : b);
209
+ r.tick(249); const before = wire(r).length;
210
+ r.tick(1); assert.equal(wire(r).length, before + 1);
211
+ }
212
+ const times = [];
213
+ const original = r.session.send;
214
+ r.session.send = (id, msg) => { if (msg.k === 'hub-actions') times.push(r.world.timeMs); original(id, msg); };
215
+ for (let i = 0; i < 100; i++) { r.hub.actions('p1', [{ id: 'start', label: String(i) }]); r.tick(10); }
216
+ assert.equal(times.length, 4); assert(times.slice(1).every((at, i) => at - times[i] >= 250));
217
+ });
218
+ await test('rate limit: eight burst, six/s, per player, invalid and refused presses spend tokens', () => {
219
+ const r = boot({ actions: true }); r.hub.actions('p1', items); r.hub.actions('p2', items); r.tick(250);
220
+ for (let i = 0; i < 10; i++) press(r);
221
+ assert.equal(r.ops.length, 8);
222
+ press(r, 'p2'); assert.equal(r.ops.length, 9);
223
+ r.tick(500);
224
+ for (let i = 0; i < 5; i++) press(r);
225
+ assert.equal(r.ops.length, 12);
226
+ r.tick(2000);
227
+ for (let i = 0; i < 8; i++) r.say('p1', { k: 'hub-action', id: 'start', n: offer(r).n, extra: 1 });
228
+ press(r); assert.equal(r.ops.length, 12);
229
+ let calls = 0;
230
+ const refused = boot({ actions: true }, { hooks: { action() { calls += 1; return false; } } });
231
+ refused.hub.actions('p1', items); refused.tick(250);
232
+ for (let i = 0; i < 9; i++) press(refused);
233
+ assert.equal(calls, 8);
234
+ });
235
+ await test('hook throws and rejections are contained and logged once', async () => {
236
+ const warnings = [], warn = console.warn;
237
+ console.warn = (text) => warnings.push(text);
238
+ try {
239
+ let calls = 0;
240
+ const r = boot({ actions: true }, { hooks: { action() { calls += 1; if (calls === 1) throw new Error('sync'); return Promise.reject(new Error('async')); } } });
241
+ r.hub.actions('p1', items); r.tick(250); press(r); press(r);
242
+ await new Promise((resolve) => setImmediate(resolve));
243
+ assert.equal(calls, 2);
244
+ assert.equal(warnings.filter((text) => text.includes('action hook failed')).length, 1);
245
+ } finally { console.warn = warn; }
246
+ });
247
+ await test('async hooks run concurrently and continue after departure', async () => {
248
+ const pending = [], completed = [];
249
+ const r = boot({ actions: true }, { hooks: { action(ctx, playerId) { return new Promise((resolve) => pending.push(() => { completed.push(playerId); resolve(); })); } } });
250
+ r.hub.actions('p1', items); r.tick(250); press(r); press(r);
251
+ assert.equal(pending.length, 2, 'not serialised');
252
+ r.session.players = [players[1]]; r.world.players.delete('p1'); r.tick();
253
+ pending.forEach((finish) => finish()); await new Promise((resolve) => setImmediate(resolve));
254
+ assert.deepEqual(completed, ['p1', 'p1'], 'not cancelled');
255
+ });
256
+ await test('fresh hello replays current offer once with current n; leave clears offers and avoids version reuse', () => {
257
+ const r = boot({ actions: true }); r.hub.actions('p1', items); r.tick(250);
258
+ r.sent.length = 0; r.say('p1', { k: 'hub-hello', resume: true }); r.tick(250);
259
+ assert.deepEqual(wire(r), [['p1', { k: 'hub-actions', items, n: 1 }]]);
260
+ r.sent.length = 0; r.say('p1', { k: 'hub-hello', again: true }); assert.deepEqual(wire(r), []);
261
+ r.hub.actions('p1', null); r.sent.length = 0;
262
+ r.say('p1', { k: 'hub-hello', resume: true }); r.tick(250);
263
+ assert.deepEqual(wire(r), [['p1', { k: 'hub-actions', items: null, n: 2 }]]);
264
+ r.hub.actions('p1', items); r.tick(250); const old = offer(r).n;
265
+ const body = r.world.players.get('p1');
266
+ r.session.players = [players[1]]; r.world.players.delete('p1'); r.tick();
267
+ assert.equal(r.hub.actions('p1', items), false);
268
+ r.session.players.push(players[0]); r.world.players.set('p1', body); r.sent.length = 0;
269
+ r.say('p1', { k: 'hub-hello', resume: true }); r.tick();
270
+ assert.deepEqual(wire(r), [['p1', { k: 'hub-actions', items: null, n: 0 }]]);
271
+ r.hub.actions('p1', items); r.tick(250);
272
+ // The session's one counter: never a version an earlier offer had.
273
+ assert.equal(offer(r).n, old + 1);
274
+ r.say('p1', { k: 'hub-action', id: 'start', n: old }); assert.deepEqual(r.ops, []);
275
+ press(r); assert.deepEqual(r.ops, [['p1', 'start']]);
276
+ });
277
+ await test('keyless place: no API or action lookup, no extra manifest, snapshot, delta or wire', () => {
278
+ const r = boot();
279
+ Object.defineProperty(r.hooks, 'action', { get() { throw new Error('keyless action lookup'); } });
280
+ assert(!Object.hasOwn(r.hub, 'actions'));
281
+ const before = JSON.stringify(r.server.join());
282
+ r.say('p1', { k: 'hub-action', id: 'start', n: 1 }); r.tick();
283
+ assert.equal(JSON.stringify(r.server.join()), before);
284
+ assert.deepEqual(wire(r), []); assert.deepEqual(r.ops, []);
285
+ });
286
+ await test('an offer recorded and not yet sent cannot be pressed; invisible and bidi characters are refused', () => {
287
+ const r = boot({ actions: true });
288
+ r.hub.actions('p1', [{ id: 'choose', label: 'Take apple' }]); r.tick(250);
289
+ const sent = offer(r).n;
290
+ r.hub.actions('p1', [{ id: 'choose', label: 'Buy bomb' }]);
291
+ for (let n = sent; n <= sent + 3; n++) r.say('p1', { k: 'hub-action', id: 'choose', n });
292
+ assert.deepEqual(r.ops, []);
293
+ r.tick(250); press(r, 'p1', 'choose'); assert.deepEqual(r.ops, [['p1', 'choose']]);
294
+ for (const label of ['\u061c', 'a\u200bb', '\u2060', 'x\ufeff', '\u202eevil', '\u2068x']) {
295
+ assert.throws(() => r.hub.actions('p1', [{ id: 'blank', label }]), TypeError);
296
+ }
297
+ });
298
+ console.log(`${passed} action tests passed`);
@@ -0,0 +1,44 @@
1
+ import assert from 'node:assert/strict';
2
+ import { actorUpdateDt } from '../../physics-2d/engine/updateBudget.js';
3
+ import { makeActorBudget } from '../code/client/actorBudget.js';
4
+ const a = { id: 'npc', runtime: {}, components: { HubNpc: {}, Transform: { x: 20, z: 0 } } };
5
+ const node = { userData: {} };
6
+ const scene = {
7
+ actorWith: () => ({ components: { Transform: { x: 0, z: 0 } } }),
8
+ getActors: () => [a],
9
+ three: { nodes: new Map([[a.id, { node }]]) },
10
+ };
11
+ const budget = makeActorBudget();
12
+ assert.equal(actorUpdateDt(a, 0.016), 0.016);
13
+ budget(scene, true, 0);
14
+ assert.equal(a.runtime.updateEvery, 0.1);
15
+ assert.equal(node.userData.animationEvery, 0.1);
16
+ assert.equal(actorUpdateDt(a, 0.02), 0.02);
17
+ for (let i = 0; i < 4; i++) assert.equal(actorUpdateDt(a, 0.02), null);
18
+ assert.equal(actorUpdateDt(a, 0.02), 0.1);
19
+ a.components.Transform.x = 5;
20
+ budget(scene, true, 201);
21
+ assert.equal(a.runtime.updateEvery, undefined);
22
+ assert.equal(node.userData.animationEvery, undefined);
23
+ assert.equal(actorUpdateDt(a, 0.02), 0.02);
24
+ a.components.Transform.x = 20;
25
+ budget(scene, true, 402);
26
+ budget(scene, false, 403);
27
+ assert.equal(a.runtime.updateEvery, undefined);
28
+ assert.equal(actorUpdateDt(a, 0.02), 0.02);
29
+ scene.multiplayer = { avatars: { actors: new Map([['other', 'npc']]) } };
30
+ budget(scene, true, 604);
31
+ assert.equal(a.runtime.updateEvery, undefined);
32
+ console.log(
33
+ 'actor budget: cadence, accumulated dt, near wake, High restore, avatar exemption passed',
34
+ );
35
+
36
+ // Restoration and rate changes deliver every second already accumulated.
37
+ for (const next of [undefined, 0.2]) {
38
+ const actor = { runtime: { updateEvery: 0.1 } };
39
+ let delivered = 0;
40
+ for (let i = 0; i < 5; i++) delivered += actorUpdateDt(actor, 0.02) ?? 0;
41
+ actor.runtime.updateEvery = next;
42
+ delivered += actorUpdateDt(actor, 0.02) ?? 0;
43
+ assert.ok(Math.abs(delivered - 0.12) < 1e-9);
44
+ }
@@ -11,6 +11,8 @@ const sceneStub = 'export const readScene = () => globalThis.__hubTestActors ??
11
11
  register(
12
12
  `data:text/javascript,${encodeURIComponent(`
13
13
  export async function resolve(specifier, context, next) {
14
+ if (['pxmodel', 'optimize', 'look', 'lookbake'].some((m) => specifier === '@imports/castle.physics-3d/engine3d/' + m)) return { url: ${JSON.stringify(new URL('./fixtures/engine-models-stub.mjs', import.meta.url).href)}, shortCircuit: true };
15
+ if (specifier === '@imports/castle.physics-3d/engine3d/orbitlens.js') return { url: ${JSON.stringify(new URL('../../physics-3d/engine3d/orbitlens.js', import.meta.url).href)}, shortCircuit: true };
14
16
  if (specifier === '@imports/castle.multiplayer-3d/code/server/sceneBodies.js') {
15
17
  return { url: 'data:text/javascript,${encodeURIComponent(sceneStub)}', shortCircuit: true };
16
18
  }
@@ -20,7 +22,7 @@ register(
20
22
  );
21
23
  const { layer } = await import('../code/server/hub.js');
22
24
  const Actors = await import('../code/server/actors.js');
23
- const { pieces } = await import('../code/client/wear.js');
25
+ const { look } = await import('../code/client/wear.js');
24
26
  const Wear = await import('../code/server/wear.js');
25
27
 
26
28
  const box = { kind: 'box', width: 4, height: 0.5, depth: 2, color: '#808080' };
@@ -227,12 +229,13 @@ test('mark: a coloured tag over a player who is here, for everyone, until cleare
227
229
  assert.equal(hub.mark('p1', null), false);
228
230
  });
229
231
 
230
- test('a scene with no ground catches a fallen player at the arrival, after the game may', () => {
232
+ test('every scene catches a fallen player at the arrival, after the game may', () => {
231
233
  const falls = [];
232
234
  for (const [label, sceneGround, fallHook, fallY] of [
235
+ ['implicit ground', () => null, null, undefined],
233
236
  ['no ground', () => ({ none: true }), null, undefined],
234
237
  ['fallY', () => null, null, 3],
235
- ['the game places them', () => ({ none: true }), (hub, id) => hub.placeAt(id, { x: 7, y: 2, z: 7 }), undefined],
238
+ ['the game places them', () => null, (hub, id) => hub.placeAt(id, { x: 7, y: 2, z: 7 }), undefined],
236
239
  ]) {
237
240
  const json = { server: { maxPlayers: 8 }, hub: { contract: 1, title: 'Pits', ...(fallY === undefined ? {} : { fallY }) } };
238
241
  const hooks = fallHook ? { fall: (hub, id) => (falls.push(id), fallHook(hub, id)) } : {};
@@ -253,12 +256,18 @@ test('a scene with no ground catches a fallen player at the arrival, after the g
253
256
  assert.deepEqual(body.at, { x: 7, y: 2, z: 7 }, label);
254
257
  } else {
255
258
  assert.deepEqual([body.at.x, body.at.z], [0, 0], label);
256
- assert.ok(body.at.y >= 1.2, label);
259
+ // v1.48: implicit ground proves standing height; no support keeps the drop.
260
+ assert.equal(body.at.y, label === 'no ground' ? 1.2 : 0.76, label);
257
261
  }
258
262
  }
259
263
  assert.deepEqual(falls, ['p1']);
260
- // A scene with its ground and no fallY never catches anyone.
261
- const h = layer(castleJson, {}, {}, sceneExists, () => null);
264
+ });
265
+
266
+ test('a place hold below the default fall line is not caught', () => {
267
+ let hub = null;
268
+ let falls = 0;
269
+ const json = { server: { maxPlayers: 8 }, hub: { contract: 1, title: 'Low hold' } };
270
+ const h = layer(json, { ready: (ctx) => (hub = ctx), fall: () => (falls += 1) }, {}, sceneExists, () => null);
262
271
  const session = { sessionId: 's-1', players: [{ playerId: 'p1', username: 'ada' }], hub: null, send() {}, broadcast() {} };
263
272
  h.sceneFor(session);
264
273
  const body = { at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } };
@@ -266,9 +275,16 @@ test('a scene with no ground catches a fallen player at the arrival, after the g
266
275
  h.ready(world);
267
276
  h.message(session, { playerId: 'p1' }, { k: 'hub-hello', avatar: 0 });
268
277
  h.place(world);
269
- body.at = { x: 4, y: -25, z: 4 };
278
+ hub.hold('p1', { x: 4, y: -24, z: 5 });
279
+ h.place(world);
280
+ assert.deepEqual(body.at, { x: 4, y: -24, z: 5 });
281
+ assert.equal(falls, 0);
282
+
283
+ hub.release('p1');
270
284
  h.place(world);
271
- assert.equal(body.at.y, -25);
285
+ assert.deepEqual([body.at.x, body.at.z], [0, 0]);
286
+ assert.equal(body.at.y, 0.76);
287
+ assert.equal(falls, 1, 'the same low pose is caught after release');
272
288
  });
273
289
 
274
290
  test("a dev deck door reads the destination's castle.json, its props only without one", () => {
@@ -609,25 +625,24 @@ test('wear: a wearable on a player who is here, latched for everyone, until clea
609
625
  assert.equal(hub.wear('p1', null), false);
610
626
  });
611
627
 
612
- test('wear: a wearable is drawn as pieces of the kinds the kit knows', () => {
613
- assert.equal(pieces({ kind: 'halo', color: '#ffd700', rarity: 0 }).length, 1);
614
- assert.equal(pieces({ kind: 'aura', color: '#ffd700', rarity: 9 })[0].shape.kind, 'cylinder');
615
- assert.equal(pieces({ kind: 'orbit', color: '#ffd700', rarity: 0 }).length, 1);
616
- assert.equal(pieces({ kind: 'orbit', color: '#ffd700', rarity: 9 }).length, 4);
617
- assert.equal(pieces({ kind: 'crown', color: '#ffd700', rarity: 1 }), null);
618
- assert.equal(pieces({ kind: 'halo', color: 'javascript:', rarity: 1 }), null);
619
- const small = pieces({ kind: 'halo', color: '#ffd700', rarity: 0 })[0].shape;
620
- const big = pieces({ kind: 'halo', color: '#FFD700', rarity: 99 })[0].shape;
621
- assert.ok(big.radius > small.radius && big.emissiveIntensity > small.emissiveIntensity);
622
- assert.equal(big.emissive, '#ffd700');
623
- assert.equal(big.solid, false);
628
+ test('wear: a wearable is drawn as the kinds the kit knows', () => {
629
+ assert.equal(look({ kind: 'halo', color: '#ffd700', rarity: 0 }).kind, 'halo');
630
+ assert.equal(look({ kind: 'aura', color: '#ffd700', rarity: 9 }).kind, 'aura');
631
+ assert.equal(look({ kind: 'orbit', color: '#ffd700', rarity: 0 }).n, 1);
632
+ assert.equal(look({ kind: 'orbit', color: '#ffd700', rarity: 9 }).n, 4);
633
+ assert.equal(look({ kind: 'crown', color: '#ffd700', rarity: 1 }), null);
634
+ assert.equal(look({ kind: 'halo', color: 'javascript:', rarity: 1 }), null);
635
+ const small = look({ kind: 'halo', color: '#ffd700', rarity: 0 });
636
+ const big = look({ kind: 'halo', color: '#FFD700', rarity: 99 });
637
+ assert.ok(big.radius > small.radius && big.glow > small.glow);
638
+ assert.equal(big.color, '#ffd700');
624
639
  // A halo and an orbit sit over the avatar's own top; an aura stays at its feet.
625
- const y = (kind, top) => pieces({ kind, color: '#ffd700', rarity: 0 }, top)[0].at(0).y;
640
+ const y = (kind, top) => look({ kind, color: '#ffd700', rarity: 0 }, top).y;
626
641
  assert.ok(Math.abs(y('halo', 1.3) - (y('halo', 1.7) - 0.4)) < 1e-9);
627
642
  assert.ok(Math.abs(y('orbit', 1.3) - (y('orbit', 1.7) - 0.4)) < 1e-9 && y('orbit', 1.3) < y('halo', 1.3));
628
643
  assert.equal(y('aura', 1.3), y('aura', 1.7));
629
- // An avatar this kit does not know wears them where they always were.
630
- assert.ok(Math.abs(y('halo') - 1.1) < 1e-9 && Math.abs(y('orbit') - 0.95) < 1e-9);
644
+ // An avatar this kit does not know wears them over a usual height.
645
+ assert.ok(Math.abs(y('halo') - 1.11) < 1e-9 && Math.abs(y('orbit') - 0.95) < 1e-9);
631
646
  });
632
647
 
633
648
  test('wear: a block hides a wearable as it hides the avatar, sent alone to who may see it', () => {
@@ -0,0 +1,76 @@
1
+ import assert from 'node:assert/strict';
2
+ import * as A from '../code/server/analytics.js';
3
+ import { readManifest, publicPlace } from '../code/server/manifest.js';
4
+ import * as Town from '../../../experiments/hub-town/code/server/analytics.js';
5
+ const castle = (hub = {}) => ({ hub: { contract: 1, title: 'Town', ...hub } });
6
+ const old = readManifest(castle()).manifest.places.main;
7
+ assert(!Object.hasOwn(old, 'analytics'));
8
+ const on = readManifest(castle({ analytics: true })).manifest.places.main;
9
+ assert.equal(on.analytics, true);
10
+ assert.deepEqual(publicPlace('main', on), publicPlace('main', old), 'analytics must not add client wire fields');
11
+ for (const analytics of [false, 1, 'true', {}, null]) assert(readManifest(castle({ analytics })).errors.some((e) => e.includes('.analytics')));
12
+ const v111 = readManifest(castle({ analytics: true, analyticsV111: true })).manifest.places.main;
13
+ assert.equal(v111.analyticsV111, true);
14
+ assert.deepEqual(publicPlace('main', v111), publicPlace('main', old), 'v1.111 analytics must not add client wire fields');
15
+ assert(readManifest(castle({ analyticsV111: true })).errors.some((e) => e.includes('requires analytics')));
16
+ for (const analyticsV111 of [false, 1, 'true', {}, null]) assert(readManifest(castle({ analytics: true, analyticsV111 })).errors.some((e) => e.includes('.analyticsV111')));
17
+ const calls = [];
18
+ const h = { place: { analytics: true }, manifest: {}, sim: { timeMs: 0 }, players: new Map([['p', { arrived: true }]]),
19
+ session: { hub: { track: (id, event) => { calls.push([id, event]); return Promise.resolve(true); } } }, analytics: A.create() };
20
+ A.arrive(h, [{ playerId: 'p', userId: '42' }]);
21
+ assert.equal(calls.at(-1)[1].kind, A.EVENTS.arrive);
22
+ for (const props of [{ text: 'private words' }, { subject: 'another user' }, { value: null }, { value: -1 }, { value: NaN }]) assert.equal(A.track(h, 'p', 'outcome', props), false);
23
+ for (const event of ['invite_sent', 'invite_opened', 'invite_joined', 'arrival_source', 'join_failed']) assert.equal(A.track(h, 'p', event), false, `${event} is platform-owned`);
24
+ assert.equal(A.track(h, 'stranger', 'outcome'), false);
25
+ h.sim.timeMs = 1000; A.leave(h, 'p'); A.leave(h, 'p');
26
+ assert.equal(calls.filter(([, e]) => e.kind === A.EVENTS.session_end).length, 1);
27
+ h.sim.timeMs = 31000; A.arrive(h, [{ playerId: 'p', userId: '42' }]);
28
+ assert.equal(calls.at(-1)[1].kind, A.EVENTS.reconnect);
29
+ h.sim.timeMs = 32000; A.leave(h, 'p');
30
+ A.arrive(h, [{ playerId: 'p', userId: '42', from: 'race' }]);
31
+ assert.equal(calls.at(-1)[1].kind, A.EVENTS.arrive, 'door returns are town arrivals');
32
+ h.manifest.house = {}; A.arrive(h, [{ playerId: 'p', userId: '43' }]);
33
+ assert.equal(calls.at(-1)[1].kind, A.EVENTS.house_visit, 'house entry must not be a town arrival');
34
+ const before = calls.length; h.place.analytics = undefined;
35
+ assert.equal(A.track(h, 'p', 'arrive'), false); assert.equal(calls.length, before);
36
+ // Town spans start only on accepted interactions; durations exclude the inactivity tail.
37
+ const events = [], town = { now: 0, track: (id, event, props) => events.push([id, event, props]) };
38
+ Town.pulse(town, 'p', 2); town.now = 5000; Town.pulse(town, 'p', 2, 2, 3);
39
+ town.now = 35001; Town.tick(town);
40
+ assert.deepEqual(events.map(([, event]) => event), ['activity_start', 'outcome', 'outcome', 'activity_end']);
41
+ assert.equal(events.at(-1)[2].value, 5000);
42
+ Town.leave(town, 'p'); assert.equal(events.length, 4);
43
+ console.log('hub analytics opt-in, privacy, lifecycle and engagement spans: passed');
44
+
45
+ const casts = [], fisher = { now: 0, track: (id, event) => casts.push(event) };
46
+ Town.touch(fisher, 'p', 4);
47
+ assert.deepEqual(casts, ['activity_start'], 'a cast begins fishing without inventing a catch');
48
+
49
+ const fpsConfig = { buildSha: 'a'.repeat(40), scene: 'scenes/main.scene' };
50
+ const fpsPlace = readManifest(castle({ analytics: true, fpsTelemetry: fpsConfig }));
51
+ assert.deepEqual(fpsPlace.errors, []);
52
+ assert.deepEqual(fpsPlace.manifest.places.main.fpsTelemetry, fpsConfig);
53
+ assert.deepEqual(publicPlace('main', fpsPlace.manifest.places.main), { ...publicPlace('main', on), fpsTelemetry: fpsConfig });
54
+ assert.equal(Object.hasOwn(publicPlace('main', old), 'fpsTelemetry'), false, 'absent opt-in adds no wire field');
55
+ for (const fpsTelemetry of [true, {}, { ...fpsConfig, buildSha: 'abc' }, { ...fpsConfig, scene: 'other.scene' }, { ...fpsConfig, text: 'hi' }]) {
56
+ assert(readManifest(castle({ analytics: true, fpsTelemetry })).errors.some((e) => e.includes('.fpsTelemetry')));
57
+ }
58
+ assert(readManifest(castle({ fpsTelemetry: fpsConfig })).errors.some((e) => e.includes('.fpsTelemetry')));
59
+
60
+ {
61
+ const events = [];
62
+ const h = { firstVisit: { live: ['home', 'door'] }, place: { analytics: true }, manifest: {}, sim: { timeMs: 0 },
63
+ players: new Map([['p', { arrived: true }]]), analytics: A.create(),
64
+ session: { hub: { track: (id, event) => { events.push(event); return true; } } } };
65
+ A.arrive(h, [{ playerId: 'p', userId: '42' }]);
66
+ assert.equal(events.length, 0, 'arrival waits for storage assignment');
67
+ assert.equal(A.firstVisitArrived(h, 'p', 4), false);
68
+ assert.equal(A.firstVisitArrived(h, 'p', 2), true);
69
+ assert.equal(A.firstVisitArrived(h, 'p', 1), false, 'arrival emits once');
70
+ assert.deepEqual(events, [{ kind: 1, subject: 0, value: 0, result: 1, flags: 2 }]);
71
+ A.arrive(h, [{ playerId: 'p', userId: '42', from: 'game' }]);
72
+ A.firstVisitArrived(h, 'p', 2);
73
+ assert.equal(events.at(-1).flags, 2, 'door return carries sticky variant');
74
+ A.leave(h, 'p'); A.arrive(h, [{ playerId: 'p', userId: '42' }]);
75
+ assert.equal(events.at(-1).kind, 10, 'short reconnect stays reconnect');
76
+ }
@@ -0,0 +1,28 @@
1
+ import assert from 'node:assert/strict';
2
+ import { makeAnonymousEntry } from '../code/server/anonymousEntry.js';
3
+
4
+ const guest = { playerId: 'g1', userId: '101', isAnonymous: true };
5
+ const signed = { playerId: 'p2', userId: '101', isAnonymous: false };
6
+ const pose = { x: 8, y: 1, z: 12, facing: 1.25 };
7
+ for (const pause of [30_000, 180_000]) {
8
+ const entry = makeAnonymousEntry();
9
+ entry.remember(guest, pose, 7, 11, 0);
10
+ assert.equal(entry.take({ ...signed, userId: '102' }, pause), null, 'existing-account login never merges another identity');
11
+ assert.equal(entry.take(guest, pause), null, 'guest reconnect does not consume sign-up state');
12
+ assert.deepEqual(entry.take(signed, pause), { userId: '101', playerId: 'g1', pose, avatar: 7, color: 11, until: 600_000, guestKey: 'g:g1', userKey: 'u:101' });
13
+ assert.equal(entry.take(signed, pause), null, 'one-time carry');
14
+ }
15
+ const expired = makeAnonymousEntry({ ttlMs: 30_000 });
16
+ expired.remember(guest, pose, 2, 4, 0);
17
+ assert.equal(expired.take(signed, 30_001), null);
18
+ const bounded = makeAnonymousEntry({ max: 1 });
19
+ bounded.remember(guest, pose, 2, 4, 0);
20
+ bounded.remember({ ...guest, userId: '102', playerId: 'g2' }, pose, 3, 5, 1);
21
+ assert.equal(bounded.take(signed, 2), null);
22
+ assert.equal(bounded.take({ ...signed, userId: '102' }, 2).avatar, 3);
23
+ const immutable = makeAnonymousEntry();
24
+ const moving = { ...pose };
25
+ immutable.remember(guest, moving, 1, 6, 0);
26
+ moving.x = 100;
27
+ assert.equal(immutable.take(signed, 1).pose.x, 8);
28
+ console.log('ok: sign-up continuity at 30s/3min, trusted identity, expiry, bounds, copy isolation');