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,138 @@
1
+ // Action chips (contract v1.74): private offers; the place's hook alone
2
+ // decides what a press does. No state exists in a place without `actions`.
3
+ import { REFUSED_TEXT as DIRECTIONS } from '../privateText.js';
4
+
5
+ const ID = /^[a-z][a-z0-9_-]{0,23}$/;
6
+ const SEND_EVERY_MS = 250;
7
+ const object = (value) => value !== null && typeof value === 'object' && [Object.prototype, null].includes(Object.getPrototypeOf(value));
8
+ const id = (value) => typeof value === 'string' && ID.exec(value)?.[0] === value;
9
+
10
+ function need(condition, message) {
11
+ if (!condition) {
12
+ throw new TypeError(`hub.actions: ${message}`);
13
+ }
14
+ }
15
+ function check(items) {
16
+ if (items === null) {
17
+ return null;
18
+ }
19
+ need(Array.isArray(items) && items.length <= 3, 'items must be null or an array of 0..3 items');
20
+ const out = Array.from(items, (item) => {
21
+ need(object(item), 'item must be a plain object');
22
+ need(Reflect.ownKeys(item).every((key) => ['id', 'label'].includes(key)), 'item has an unknown key');
23
+ need(Object.hasOwn(item, 'id') && Object.hasOwn(item, 'label'), 'id and label must be own properties');
24
+ const itemId = item.id, label = item.label;
25
+ need(id(itemId), 'id must be a short id');
26
+ need(typeof label === 'string' && label.length <= 32 && label.trim().length > 0 && Array.from(label).length <= 16 && !DIRECTIONS.test(label), 'label must be 1..16 characters (code points), no control, direction or zero-width characters');
27
+ return { id: itemId, label };
28
+ });
29
+ need(new Set(out.map((item) => item.id)).size === out.length, 'ids must be unique');
30
+ return out.length ? out : null;
31
+ }
32
+ function present(h, playerId) {
33
+ return h.session?.players.some((p) => p.playerId === playerId) && h.sim?.players.has(playerId);
34
+ }
35
+ function arrived(h, playerId) {
36
+ const entry = h.players.get(playerId);
37
+ return present(h, playerId) && entry?.arrived && !entry.ended;
38
+ }
39
+ function resumePreparationPending(h, playerId) {
40
+ const entry = h.resumePending?.get(playerId);
41
+ return entry !== undefined && h.players.get(playerId) === entry &&
42
+ h.resumeKept?.get(playerId)?.visibilityResumePending === true;
43
+ }
44
+ function current(h, playerId) {
45
+ return h.actionsMe?.get(playerId) ?? { items: null, n: 0, json: 'null', sentJson: 'null', sentN: 0, sentAt: -Infinity };
46
+ }
47
+ function send(h, playerId, state) {
48
+ h.session?.send(playerId, { k: 'hub-actions', items: state.items, n: state.n });
49
+ state.sentN = state.n;
50
+ state.sentJson = state.json;
51
+ state.sentAt = h.sim?.timeMs ?? 0;
52
+ }
53
+ // One counter for the place's session, so no offer ever shares a version with
54
+ // an earlier one, whoever it was for and whenever they left and came back.
55
+ function version(h) {
56
+ h.actionsSeq = (h.actionsSeq ?? 0) + 1;
57
+ return h.actionsSeq;
58
+ }
59
+
60
+ export function set(h, playerId, items) {
61
+ need(h.place.actions === true, 'this place does not declare actions');
62
+ need(typeof playerId === 'string', 'playerId must be a string');
63
+ const checked = check(items);
64
+ if (!arrived(h, playerId)) {
65
+ return false;
66
+ }
67
+ const state = current(h, playerId), json = JSON.stringify(checked);
68
+ if (state.json === json) {
69
+ return true;
70
+ }
71
+ // Record every changed list; the tick sends only the latest, at most 4/s.
72
+ // Back to the list the player was last sent, with nothing sent since: that
73
+ // offer and its version stand (the client never heard of the ones between).
74
+ const n = json === state.sentJson ? state.sentN : version(h);
75
+ (h.actionsMe ??= new Map()).set(playerId, { ...state, items: checked, json, n });
76
+ return true;
77
+ }
78
+
79
+ export function message(h, playerId, data) {
80
+ // Even a stale or malformed press spends a token. Six/s, burst eight.
81
+ if (h.place.actions !== true || !present(h, playerId)) {
82
+ return;
83
+ }
84
+ const now = h.sim.timeMs, budgets = (h.actionsBudget ??= new Map());
85
+ const b = budgets.get(playerId) ?? { tokens: 8, at: now };
86
+ b.tokens = Math.min(8, b.tokens + Math.max(0, now - b.at) * 0.006);
87
+ b.at = now;
88
+ budgets.set(playerId, b);
89
+ if (b.tokens < 1) {
90
+ return;
91
+ }
92
+ b.tokens -= 1;
93
+ if (resumePreparationPending(h, playerId) || !arrived(h, playerId) || !object(data) || data.k !== 'hub-action' ||
94
+ !Object.keys(data).every((key) => ['k', 'id', 'n'].includes(key))) {
95
+ return;
96
+ }
97
+ const actionId = data.id, n = data.n, state = current(h, playerId);
98
+ // The offer in force is the one this player was sent: a list recorded and
99
+ // not yet sent cannot be pressed, however its version was guessed.
100
+ if (!id(actionId) || !Number.isSafeInteger(n) || n !== state.n || n !== state.sentN || !state.items?.some((item) => item.id === actionId)) {
101
+ return;
102
+ }
103
+ const failed = (error) => {
104
+ if (!h.actionFailed) {
105
+ h.actionFailed = true;
106
+ console.warn(`[hub] action hook failed: ${error?.message ?? error}`);
107
+ }
108
+ };
109
+ try {
110
+ Promise.resolve(h.hooks.action?.(h.ctx, playerId, actionId)).catch(failed);
111
+ } catch (error) {
112
+ failed(error);
113
+ }
114
+ }
115
+
116
+ export function joinedAfresh(h, playerId) {
117
+ const state = current(h, playerId);
118
+ (h.actionsMe ??= new Map()).set(playerId, state);
119
+ send(h, playerId, state);
120
+ }
121
+ export function forget(h, playerId) {
122
+ h.actionsMe?.delete(playerId);
123
+ h.actionsBudget?.delete(playerId);
124
+ }
125
+ export function prune(h) {
126
+ for (const playerId of new Set([...(h.actionsMe?.keys() ?? []), ...(h.actionsBudget?.keys() ?? [])])) {
127
+ if (!present(h, playerId)) {
128
+ forget(h, playerId);
129
+ continue;
130
+ }
131
+ const state = h.actionsMe?.get(playerId);
132
+ // By version, not by content: a list changed and changed back has a new
133
+ // version the client must hear, or its presses would never match.
134
+ if (state && state.n !== state.sentN && h.sim.timeMs - state.sentAt >= SEND_EVERY_MS) {
135
+ send(h, playerId, state);
136
+ }
137
+ }
138
+ }
@@ -21,7 +21,7 @@ export const TINT_RATE = 20;
21
21
  export const TINT_BURST = 40;
22
22
  export const MAX_TINTS = 128;
23
23
  // The box a moved actor stays in: multiplayer-3d's world bounds.
24
- const BOUNDS = { xz: 200, low: -30, high: 80 };
24
+ export const BOUNDS = { xz: 200, low: -30, high: 80 };
25
25
  // A turn a move may ask for at most (a hundred turns): enough for any spin,
26
26
  // small enough that interpolating it stays finite.
27
27
  const MAX_TURN_DEG = 36000;
@@ -400,6 +400,14 @@ export function despawn(h, id, engine) {
400
400
  for (const mine of h.labelsMe?.values() ?? []) {
401
401
  mine.delete(id);
402
402
  }
403
+ // v1.62: a gone copy's private visibility goes with it, so it never holds
404
+ // one of a viewer's override slots; the next send carries the shorter list.
405
+ for (const [viewer, mine] of h.visMe ?? []) {
406
+ mine.delete(id);
407
+ if (mine.size === 0) {
408
+ h.visMe.delete(viewer);
409
+ }
410
+ }
403
411
  if (h.sim && engine?.removeActor) {
404
412
  engine.removeActor(h.sim, id);
405
413
  }
@@ -424,7 +432,8 @@ export function templatesOf(h) {
424
432
  const out = Object.create(null);
425
433
  for (const { from } of h.spawned.values()) {
426
434
  if (!Object.hasOwn(out, from)) {
427
- out[from] = h.actors.find((a) => a.id === from)?.components ?? null;
435
+ const components = h.actors.find((a) => a.id === from)?.components ?? null;
436
+ out[from] = h.qualityDecor?.has(from) && components ? { ...components, decor: true } : components;
428
437
  }
429
438
  }
430
439
  return out;
@@ -0,0 +1,83 @@
1
+ // v1.93: server only. A place without analytics creates no state or messages.
2
+ export const EVENTS = Object.freeze({ arrive: 1, door_enter: 2, door_exit: 3, game_result: 4,
3
+ activity_start: 5, activity_end: 6, outcome: 7, first_play: 8, pointer_stage: 9,
4
+ reconnect: 10, session_end: 11, furniture_placed: 12, furniture_moved: 13,
5
+ pet_named: 14, guestbook_signed: 15, house_visit: 16, house_time: 17,
6
+ npc_chat_count: 18, token_earned: 19, token_spent: 20, invite_sent: 21,
7
+ invite_opened: 22, invite_joined: 23, arrival_source: 24, join_failed: 25 });
8
+ export const SUBJECTS = Object.freeze({ town: 0, tag: 1, garden: 2, boat: 3, fishing: 4,
9
+ jobs: 5, lanterns: 6, stamps: 7, market: 8, npc: 9, house: 10 });
10
+ export const create = () => ({ visits: new Map(), departed: new Map() });
11
+ export function track(h, playerId, name, props = {}) {
12
+ // v1.111 events are emitted only by Ghost at its committed invite/admission
13
+ // boundaries. Authored server code cannot claim that one happened.
14
+ if (h.place.analytics !== true || !EVENTS[name] || EVENTS[name] >= EVENTS.invite_sent || !h.players.get(playerId)?.arrived) {return false;}
15
+ if (!props || typeof props !== 'object' || Array.isArray(props) || Object.keys(props).some((k) => !['subject', 'value', 'result', 'flags'].includes(k))) {return false;}
16
+ const event = { kind: EVENTS[name] };
17
+ for (const [key, max] of [['subject', 65535], ['value', 2147483647], ['result', 255], ['flags', 3]]) {
18
+ const n = Object.hasOwn(props, key) ? props[key] : 0;
19
+ if (!Number.isSafeInteger(n) || n < 0 || n > max) {return false;}
20
+ event[key] = n;
21
+ }
22
+ try {
23
+ const pending = h.session?.hub?.track?.(playerId, event);
24
+ if (pending && typeof pending.catch === 'function') {pending.catch(() => {});}
25
+ return pending !== undefined && pending !== false;
26
+ } catch { return false; }
27
+ }
28
+ export function arrive(h, group) {
29
+ const a = h.analytics, now = h.sim.timeMs;
30
+ // Retain at most one short reconnect window per departed account.
31
+ for (const [key, at] of a.departed) {if (now - at > 600000) {a.departed.delete(key);}}
32
+ for (const p of group) {
33
+ const key = p.userId;
34
+ const back = !p.from && key && a.departed.has(key);
35
+ if (key) {a.departed.delete(key);}
36
+ a.visits.set(p.playerId, { at: now, userId: key });
37
+ if (back) {track(h, p.playerId, 'reconnect', { subject: h.manifest.house ? SUBJECTS.house : SUBJECTS.town });}
38
+ else if (h.firstVisit && !h.manifest.house) {a.visits.get(p.playerId).arrival = { subject: SUBJECTS.town, result: p.from ? 2 : 1 };}
39
+ else {track(h, p.playerId, h.manifest.house ? 'house_visit' : 'arrive', { subject: h.manifest.house ? SUBJECTS.house : SUBJECTS.town, result: p.from ? 2 : 1 });}
40
+ }
41
+ }
42
+ // Resolve the existing arrival once storage has answered, without duplicating it.
43
+ export function firstVisitArrived(h, playerId, flags) {
44
+ if (!Number.isInteger(flags) || flags < 0 || flags > 3) {return false;}
45
+ const visit = h.analytics?.visits.get(playerId);
46
+ if (!visit?.arrival) {return false;}
47
+ const accepted = track(h, playerId, 'arrive', { ...visit.arrival, flags });
48
+ if (accepted) {delete visit.arrival;}
49
+ return accepted;
50
+ }
51
+ export function leave(h, playerId) {
52
+ const a = h.analytics, visit = a.visits.get(playerId);
53
+ if (!visit) {return;}
54
+ if (visit.arrival) {firstVisitArrived(h, playerId, 0);}
55
+ const value = Math.max(0, Math.min(2147483647, Math.round(h.sim.timeMs - visit.at)));
56
+ track(h, playerId, 'session_end', { value, result: 0 });
57
+ if (h.manifest.house) {track(h, playerId, 'house_time', { subject: SUBJECTS.house, value });}
58
+ a.visits.delete(playerId);
59
+ if (visit.userId) {a.departed.set(visit.userId, h.sim.timeMs);}
60
+ }
61
+
62
+ // Browser measurements are untrusted numbers, never identities or event names.
63
+ export function fps(h, session, player, data) {
64
+ const entry = h.players.get(player?.playerId);
65
+ if (h.place?.analytics !== true || !h.place.fpsTelemetry || !entry?.arrived || !session.players.some((p) => p.playerId === player.playerId) ||
66
+ data.scene !== h.place.fpsTelemetry.scene || typeof data.final !== 'boolean' ||
67
+ Object.keys(data).some((key) => !['k', 'scene', 'median', 'p10', 'tier', 'avatars', 'final'].includes(key))) {return false;}
68
+ for (const [key, max] of [['median', 4095], ['p10', 4095], ['tier', 3], ['avatars', 255]]) {
69
+ if (!Number.isInteger(data[key]) || data[key] < 0 || data[key] > max) {return false;}
70
+ }
71
+ if (data.p10 > data.median) {return false;}
72
+ const now = h.sim.timeMs;
73
+ const field = data.final ? 'fpsFinalAt' : 'fpsAt';
74
+ if (entry[field] !== undefined && now - entry[field] < 60000) {return false;}
75
+ entry[field] = now;
76
+ try {
77
+ const pending = h.session?.hub?.track?.(player.playerId, {
78
+ kind: 26, subject: data.tier, value: data.median * 4096 + data.p10, result: data.avatars, flags: 0,
79
+ });
80
+ pending?.catch?.(() => {});
81
+ return pending !== undefined && pending !== false;
82
+ } catch { return false; }
83
+ }
@@ -0,0 +1,49 @@
1
+ // Layer-local sign-up continuity. Only the trusted roster can join a guest
2
+ // identity to an account. A different account never receives practice state.
3
+ export function makeAnonymousEntry({ ttlMs = 10 * 60_000, max = 500 } = {}) {
4
+ const states = new Map();
5
+ const guests = new Map();
6
+ function trim(now) {
7
+ for (const [key, state] of states) {
8
+ if (now > state.until) {
9
+ states.delete(key);
10
+ if (guests.get(state.userId) === key) {guests.delete(state.userId);}
11
+ }
12
+ }
13
+ while (states.size > max) {
14
+ const key = states.keys().next().value;
15
+ const state = states.get(key);
16
+ states.delete(key);
17
+ if (guests.get(state.userId) === key) {guests.delete(state.userId);}
18
+ }
19
+ }
20
+ return {
21
+ remember(player, pose, avatar, color, now) {
22
+ trim(now);
23
+ if (!player?.isAnonymous || !/^\d{1,20}$/.test(String(player.userId ?? '')) || !pose) {return;}
24
+ const key = `g:${player.playerId}`;
25
+ const previous = guests.get(String(player.userId));
26
+ if (previous && previous !== key) {states.delete(previous);}
27
+ states.delete(key);
28
+ states.set(key, { userId: String(player.userId), playerId: player.playerId, pose: { ...pose }, avatar, color, until: now + ttlMs });
29
+ guests.set(String(player.userId), key);
30
+ trim(now);
31
+ },
32
+ take(player, now) {
33
+ trim(now);
34
+ if (!player || player.isAnonymous || !/^\d{1,20}$/.test(String(player.userId ?? ''))) {return null;}
35
+ const userId = String(player.userId);
36
+ const guestKey = guests.get(userId);
37
+ const guest = states.get(guestKey);
38
+ if (!guest) {return null;}
39
+ states.delete(guestKey);
40
+ guests.delete(userId);
41
+ // Copy only the allowed visit state, never wallets, jobs, fish or plots.
42
+ const userKey = `u:${userId}`;
43
+ states.set(userKey, { ...guest, pose: { ...guest.pose } });
44
+ const copy = states.get(userKey);
45
+ states.delete(userKey);
46
+ return { ...copy, guestKey, userKey };
47
+ },
48
+ };
49
+ }
@@ -0,0 +1,36 @@
1
+ // Session-local pose copies only. Authored visits always leave and arrive.
2
+ export const TTL_MS = 60000;
3
+ const MAX_POSES = 128;
4
+ const valid = pose => pose?.at && [pose.at.x, pose.at.y, pose.at.z, pose.facing].every(Number.isFinite);
5
+ export function create() {
6
+ const poses = new Map();
7
+ const prune = now => {
8
+ for (const [id, pose] of poses) {
9
+ if (now < pose.seenAt || now - (pose.awayAt ?? pose.seenAt) >= TTL_MS) {poses.delete(id);}
10
+ }
11
+ while (poses.size > MAX_POSES) {poses.delete(poses.keys().next().value);}
12
+ };
13
+ return {
14
+ remember(id, userId, body, now = Date.now()) {
15
+ prune(now);
16
+ if (!userId || !valid(body)) {poses.delete(id); return;}
17
+ poses.set(id, { userId, at: { ...body.at }, facing: body.facing, seenAt: now });
18
+ prune(now);
19
+ },
20
+ leave(id, userId, eligible, now = Date.now()) {
21
+ prune(now);
22
+ const pose = poses.get(id);
23
+ if (!eligible || !userId || pose?.userId !== userId) {poses.delete(id); return;}
24
+ pose.awayAt ??= now;
25
+ },
26
+ take(id, userId, now = Date.now()) {
27
+ prune(now);
28
+ const pose = poses.get(id);
29
+ poses.delete(id);
30
+ return userId && pose?.userId === userId && pose.awayAt !== undefined
31
+ ? { at: { ...pose.at }, facing: pose.facing } : null;
32
+ },
33
+ clear(id) {poses.delete(id);},
34
+ shutdown() {poses.clear();},
35
+ };
36
+ }
@@ -0,0 +1,155 @@
1
+ // Private text prompts (contract v1.75). Only the place hook receives text;
2
+ // no answer is retained, echoed, included in state or used in an error line.
3
+ import { validPrivateText as textOk } from '../privateText.js';
4
+
5
+ const ID = /^[a-z][a-z0-9_-]{0,23}$/;
6
+ const SEND_EVERY_MS = 250;
7
+ const object = (value) => value !== null && typeof value === 'object' && [Object.prototype, null].includes(Object.getPrototypeOf(value));
8
+ const id = (value) => typeof value === 'string' && ID.exec(value)?.[0] === value;
9
+
10
+ function need(condition, message) {
11
+ if (!condition) {
12
+ throw new TypeError(`hub.ask: ${message}`);
13
+ }
14
+ }
15
+ function check(spec) {
16
+ if (spec === null) {
17
+ return null;
18
+ }
19
+ need(object(spec), 'spec must be a plain object or null');
20
+ need(Reflect.ownKeys(spec).length === 3 && ['id', 'title', 'max'].every((key) => Object.hasOwn(spec, key)), 'spec must have exactly own id, title and max');
21
+ const promptId = spec.id, title = spec.title, max = spec.max;
22
+ need(id(promptId), 'id must be a short id');
23
+ need(textOk(title, 32), 'title must be 1..32 code points, no control, direction or zero-width characters');
24
+ need(Number.isSafeInteger(max) && max >= 1 && max <= 32, 'max must be an integer in 1..32');
25
+ return { id: promptId, title, max };
26
+ }
27
+ function present(h, playerId) {
28
+ return h.session?.players.some((p) => p.playerId === playerId) && h.sim?.players.has(playerId);
29
+ }
30
+ function arrived(h, playerId) {
31
+ const entry = h.players.get(playerId);
32
+ return present(h, playerId) && entry?.arrived && !entry.ended;
33
+ }
34
+ function current(h, playerId) {
35
+ return h.askMe?.get(playerId) ?? { spec: null, n: 0, json: 'null', sentJson: 'null', sentN: 0, sentId: null, sentAt: -Infinity };
36
+ }
37
+ function version(h) {
38
+ const n = (h.askSeq ?? 0) + 1;
39
+ need(Number.isSafeInteger(n), 'version counter exhausted');
40
+ h.askSeq = n;
41
+ return n;
42
+ }
43
+ function send(h, playerId, state) {
44
+ h.session?.send(playerId, state.spec ? { k: 'hub-ask', ...state.spec, n: state.n } : { k: 'hub-ask', id: null, n: state.n });
45
+ state.sentN = state.n;
46
+ state.sentId = state.spec?.id ?? null;
47
+ state.sentJson = state.json;
48
+ state.sentAt = h.sim?.timeMs ?? 0;
49
+ }
50
+ export function set(h, playerId, spec) {
51
+ need(h.place.ask === true, 'this place does not declare ask');
52
+ need(typeof playerId === 'string', 'playerId must be a string');
53
+ const checked = check(spec);
54
+ if (!arrived(h, playerId)) {
55
+ return false;
56
+ }
57
+ const state = current(h, playerId), json = JSON.stringify(checked);
58
+ if (state.json !== json) {
59
+ // Every change invalidates the old version, even if it changes back
60
+ // before delivery. Delivery equality includes that new version.
61
+ const n = version(h);
62
+ (h.askMe ??= new Map()).set(playerId, { ...state, spec: checked, json, n });
63
+ }
64
+ return true;
65
+ }
66
+ // A separate scope: the rejection handler retains only the session, never
67
+ // the incoming message or answer while an async hook is pending.
68
+ function failureHandler(h) {
69
+ return () => {
70
+ if (!h.answerFailed) {
71
+ h.answerFailed = true;
72
+ // Even the hook's error message could contain the answer. Never log it.
73
+ console.warn('[hub] answer hook failed');
74
+ }
75
+ };
76
+ }
77
+ const ANSWER_KEYS = ['k', 'id', 'n', 'text'];
78
+ function answerKeys(data) {
79
+ // Parsed wire objects have enumerable string keys: stop at the fifth,
80
+ // without allocating an array of every key or reading any field values.
81
+ if (!object(data)) {
82
+ return false;
83
+ }
84
+ let count = 0;
85
+ for (const key in data) {
86
+ if (Object.hasOwn(data, key) && (++count > 4 || !ANSWER_KEYS.includes(key))) {
87
+ return false;
88
+ }
89
+ }
90
+ // Reflection is needed to catch hidden/symbol extras too. For ordinary
91
+ // JSON objects the bounded loop above has already limited this to four.
92
+ return Reflect.ownKeys(data).length === 4 && ANSWER_KEYS.every((key) => Object.hasOwn(data, key));
93
+ }
94
+ export function message(h, playerId, data) {
95
+ // A Proxy or getter is not ordinary wire data, but must still be contained.
96
+ // Validation failures are silent; only failures in the place hook log once.
97
+ try {
98
+ if (h.place.ask !== true || !present(h, playerId)) {
99
+ return;
100
+ }
101
+ // Every attempted answer spends a token, including malformed/oversized ones.
102
+ const now = h.sim.timeMs, budgets = (h.askBudget ??= new Map());
103
+ const b = budgets.get(playerId) ?? { tokens: 4, at: now };
104
+ b.tokens = Math.min(4, b.tokens + Math.max(0, now - b.at) * 0.002);
105
+ b.at = now;
106
+ budgets.set(playerId, b);
107
+ if (b.tokens < 1) {
108
+ return;
109
+ }
110
+ b.tokens -= 1;
111
+ if (!arrived(h, playerId) || !answerKeys(data) || data.k !== 'hub-answer') {
112
+ return;
113
+ }
114
+ const promptId = data.id, n = data.n, state = current(h, playerId);
115
+ if (!state.spec || !id(promptId) || promptId !== state.spec.id || promptId !== state.sentId ||
116
+ !Number.isSafeInteger(n) || n !== state.n || n !== state.sentN) {
117
+ return;
118
+ }
119
+ // Once the prompt's identity matches, refused text is a cancel. It never
120
+ // reaches content, and cannot strand a client that already closed its card.
121
+ const value = data.text, text = value === null || !textOk(value, state.spec.max) ? null : value;
122
+ set(h, playerId, null);
123
+ // The close shares the tick delivery budget. A hook may reopen the same
124
+ // spec before delivery; its advanced n still has to be sent.
125
+ const failed = failureHandler(h);
126
+ try {
127
+ Promise.resolve(h.hooks.answer?.(h.ctx, playerId, promptId, text)).catch(failed);
128
+ } catch {
129
+ failed();
130
+ }
131
+ } catch {
132
+ // Never log validation errors: a throwing getter may put the text in one.
133
+ }
134
+ }
135
+ export function joinedAfresh(h, playerId) {
136
+ const state = current(h, playerId);
137
+ (h.askMe ??= new Map()).set(playerId, state);
138
+ send(h, playerId, state);
139
+ }
140
+ export function forget(h, playerId) {
141
+ h.askMe?.delete(playerId);
142
+ h.askBudget?.delete(playerId);
143
+ }
144
+ export function prune(h) {
145
+ for (const playerId of new Set([...(h.askMe?.keys() ?? []), ...(h.askBudget?.keys() ?? [])])) {
146
+ if (!present(h, playerId)) {
147
+ forget(h, playerId);
148
+ continue;
149
+ }
150
+ const state = h.askMe?.get(playerId);
151
+ if (state && (state.json !== state.sentJson || state.n !== state.sentN) && h.sim.timeMs - state.sentAt >= SEND_EVERY_MS) {
152
+ send(h, playerId, state);
153
+ }
154
+ }
155
+ }