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
@@ -22,6 +22,71 @@ function test(name, fn) {
22
22
  n += 1;
23
23
  }
24
24
 
25
+ test('push capability is explicit and survives the public place boundary', () => {
26
+ const absent = readManifest(base(), has);
27
+ assert(!Object.hasOwn(publicPlace('main', absent.manifest.places.main), 'push'));
28
+ const enabled = readManifest(base({ push: { version: 1 } }), has);
29
+ assert.deepEqual(enabled.errors, []);
30
+ assert.deepEqual(publicPlace('main', enabled.manifest.places.main).push, { version: 1 });
31
+ for (const push of [true, null, {}, { version: 2 }, { version: 1, extra: true }]) {
32
+ assert(readManifest(base({ push }), has).errors.length > 0, JSON.stringify(push));
33
+ }
34
+ });
35
+
36
+ test('v1.142: published childAsks limits and private manifest boundary', () => {
37
+ const copy = Object.fromEntries(JSON.parse(fs.readFileSync(new URL('../../../experiments/hub-town/castle.json', import.meta.url), 'utf8')).characterBundle.characters.filter((c) => c.childAsks).map((c) => [c.id, c.childAsks]));
38
+ const parse = (childAsks) => readManifest(base({ npcs: {} }, { characterBundle: {
39
+ characters: [{ id: 'greeter', childAsks }], conversation: { version: 1, authority: 'server', maxListeners: 0 },
40
+ } }), has);
41
+ for (const asks of Object.values(copy)) {
42
+ for (const count of [3, 4]) {
43
+ const result = parse(asks.slice(0, count));
44
+ assert.deepEqual(result.errors, []);
45
+ assert(!JSON.stringify(result.manifest).includes('childAsks'), 'bundle prompts never enter the manifest');
46
+ assert(!JSON.stringify(publicPlace('main', result.manifest.places.main)).includes('childAsks'));
47
+ }
48
+ }
49
+ const asks = copy.greeter;
50
+ assert.deepEqual(parse([{ ...asks[0], label: 'l'.repeat(40), prompt: 'p'.repeat(300) }, ...asks.slice(1)]).errors, []);
51
+ assert.deepEqual(parse(undefined).errors, []);
52
+ for (const invalid of [null, {}, [], asks.slice(0, 2), [...asks, { ...asks[0], id: 'fifth' }],
53
+ [{ ...asks[0], label: 'l'.repeat(41) }, ...asks.slice(1)],
54
+ [{ ...asks[0], prompt: 'p'.repeat(301) }, ...asks.slice(1)],
55
+ ...['id', 'label', 'prompt'].flatMap((key) => ['', ' ', null, 42].map((value) => [{ ...asks[0], [key]: value }, ...asks.slice(1)])),
56
+ [asks[0], asks[0], ...asks.slice(2)], [null, ...asks.slice(1)]]) {
57
+ assert(parse(invalid).errors.some((e) => e.includes('childAsks')), JSON.stringify(invalid));
58
+ }
59
+ });
60
+
61
+ test('arrival pose is strict, server-only, and keeps result resume explicit', () => {
62
+ const absent = readManifest(base(), has).manifest.places.main;
63
+ const enabled = readManifest(base({ resumeArrivalPose: true }), has);
64
+ assert.deepEqual(enabled.errors, []);
65
+ assert.equal(enabled.manifest.places.main.resumeArrivalPose, true);
66
+ assert.equal(Object.hasOwn(absent, 'resumeArrivalPose'), false);
67
+ assert.equal(JSON.stringify(publicPlace('main', absent)), JSON.stringify(publicPlace('main', enabled.manifest.places.main)));
68
+ for (const resumeArrivalPose of [false, 1, null, {}]) {
69
+ assert.ok(readManifest(base({ resumeArrivalPose }), has).errors.length);
70
+ }
71
+ for (const keys of [{ resumePose: true }, { houseResume: true }, { result: {}, resume: { keep: true } }, { result: {} }]) {
72
+ assert.ok(readManifest(base({ ...keys, resumeArrivalPose: true }), has).errors.length);
73
+ }
74
+ assert.deepEqual(readManifest(base({ result: {}, resume: true, resumeArrivalPose: true }), has).errors, []);
75
+ });
76
+
77
+ test('house resume is strict, server-only and absent manifests stay unchanged', () => {
78
+ const absent = readManifest(base(), has).manifest;
79
+ assert.equal(Object.hasOwn(absent.places.main, 'houseResume'), false);
80
+ const enabled = readManifest(base({ houseResume: true }), has);
81
+ assert.deepEqual(enabled.errors, []);
82
+ assert.equal(enabled.manifest.places.main.houseResume, true);
83
+ assert.deepEqual(publicPlace('main', enabled.manifest.places.main), publicPlace('main', absent.places.main));
84
+ for (const houseResume of [false, 1, null, {}]) {
85
+ assert(readManifest(base({ houseResume }), has).errors.length);
86
+ }
87
+ assert(readManifest(base({ houseResume: true, result: {} }), has).errors.length);
88
+ });
89
+
25
90
  test("the kit's own manifest is valid", () => {
26
91
  const { errors, manifest } = readManifest(kit, has);
27
92
  assert.deepEqual(errors, []);
@@ -29,6 +94,16 @@ test("the kit's own manifest is valid", () => {
29
94
  assert.deepEqual(kit.starterConfig.hub, kit.hub);
30
95
  });
31
96
 
97
+ test('weekly Cup is a strict optional server opt-in and false keeps the legacy manifest', () => {
98
+ const legacy = readManifest(base()).manifest;
99
+ assert.equal(Object.hasOwn(legacy, 'weeklyCup'), false);
100
+ assert.deepEqual(readManifest(base({ weeklyCup: false })).manifest, legacy);
101
+ assert.equal(readManifest(base({ weeklyCup: true })).manifest.weeklyCup, true);
102
+ for (const weeklyCup of [null, 0, 'true', {}, []]) {
103
+ assert.deepEqual(readManifest(base({ weeklyCup })).errors, ['hub.weeklyCup must be true or false.']);
104
+ }
105
+ });
106
+
32
107
  test('defaults fill in', () => {
33
108
  const { manifest } = readManifest(base(), has);
34
109
  const main = manifest.places.main;
@@ -270,6 +345,110 @@ test('results are checked against the declared shape', () => {
270
345
  assert.match(checkResult(town, { outcome: 'win' }).error, /declares no result/);
271
346
  });
272
347
 
348
+ test('resume (v1.72): only true, only on a place with a result, carried only when set', () => {
349
+ const game = { result: { outcomes: ['win', 'lose'] } };
350
+ const ok = readManifest(base({ ...game, resume: true }), has);
351
+ assert.deepEqual(ok.errors, []);
352
+ assert.equal(ok.manifest.places.main.resume, true);
353
+ assert.equal(publicPlace('main', ok.manifest.places.main).resume, true);
354
+ const named = readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene', ...game, resume: true } } }), has);
355
+ assert.deepEqual(named.errors, []);
356
+ assert.equal(named.manifest.places.race.resume, true);
357
+ assert.match(readManifest(base({ resume: true }), has).errors.join(), /hub\.resume is only for a place with a result/);
358
+ assert.match(readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene', resume: true } } }), has).errors.join(), /hub\.places\.race\.resume is only for a place with a result/);
359
+ for (const value of [false, null, 0, 1, 'true', {}, []]) {
360
+ assert.match(readManifest(base({ ...game, resume: value }), has).errors.join(), /hub\.resume must be true or absent/, String(value));
361
+ }
362
+ const absent = readManifest(base(game), has).manifest.places.main;
363
+ assert(!Object.hasOwn(absent, 'resume'));
364
+ assert(!Object.hasOwn(publicPlace('main', absent), 'resume'));
365
+ assert.equal(JSON.stringify(publicPlace('main', absent)), JSON.stringify(publicPlace('main', readManifest(base(game), has).manifest.places.main)));
366
+ });
367
+
368
+ test('keep resume (v1.89): closed opt-in object, result only, existing wire field', () => {
369
+ const game = { result: { outcomes: ['win', 'lose'] } };
370
+ const ok = readManifest(base({ ...game, resume: { keep: true } }), has);
371
+ assert.deepEqual(ok.errors, []);
372
+ assert.equal(ok.manifest.places.main.resume, true);
373
+ assert.equal(ok.manifest.places.main.resumeKeep, true);
374
+ const legacy = readManifest(base({ ...game, resume: true }), has).manifest.places.main;
375
+ assert.equal(legacy.resumeKeep, undefined);
376
+ assert.deepEqual(
377
+ publicPlace('main', ok.manifest.places.main),
378
+ publicPlace('main', legacy),
379
+ 'no new wire keys',
380
+ );
381
+ for (const value of [{ keep: false }, { keep: 1 }, { keep: true, other: true }]) {
382
+ assert.ok(readManifest(base({ ...game, resume: value }), has).errors.length);
383
+ }
384
+ assert.match(
385
+ readManifest(base({ resume: { keep: true } }), has).errors.join(),
386
+ /only for a place with a result/,
387
+ );
388
+ const named = readManifest(
389
+ base({
390
+ places: {
391
+ race: { title: 'Race', scene: 'scenes/race.scene', ...game, resume: { keep: true } },
392
+ },
393
+ }),
394
+ has,
395
+ );
396
+ assert.deepEqual(named.errors, []);
397
+ assert.equal(named.manifest.places.race.resumeKeep, true);
398
+ });
399
+
400
+ test('retained private visibility: strict server-only opt-in on bounded keep visits', () => {
401
+ const game = { result: { outcomes: ['win', 'lose'] }, resume: { keep: true } };
402
+ const plain = readManifest(base(game), has).manifest.places.main;
403
+ const enabled = readManifest(base({ ...game, resumeVisibility: true }), has);
404
+ assert.deepEqual(enabled.errors, []);
405
+ assert.equal(enabled.manifest.places.main.resumeVisibility, true);
406
+ assert.equal(Object.hasOwn(plain, 'resumeVisibility'), false);
407
+ assert.deepEqual(
408
+ publicPlace('main', enabled.manifest.places.main),
409
+ publicPlace('main', plain),
410
+ 'server opt-in adds no public place or wire field',
411
+ );
412
+ for (const resumeVisibility of [false, null, 0, 1, 'true', {}, []]) {
413
+ assert.match(
414
+ readManifest(base({ ...game, resumeVisibility }), has).errors.join(),
415
+ /resumeVisibility must be true or absent/,
416
+ );
417
+ }
418
+ for (const hub of [
419
+ { result: { outcomes: ['win'] }, resumeVisibility: true },
420
+ { result: { outcomes: ['win'] }, resume: true, resumeVisibility: true },
421
+ { resumePose: true, resumeVisibility: true },
422
+ { houseResume: true, resumeVisibility: true },
423
+ ]) {
424
+ assert.match(
425
+ readManifest(base(hub), has).errors.join(),
426
+ /resumeVisibility requires resume: \{ keep: true \}/,
427
+ );
428
+ }
429
+ const named = readManifest(base({ places: {
430
+ race: { title: 'Race', scene: 'scenes/race.scene', ...game, resumeVisibility: true },
431
+ } }), has);
432
+ assert.deepEqual(named.errors, []);
433
+ assert.equal(named.manifest.places.race.resumeVisibility, true);
434
+ });
435
+
436
+ test('town resumePose (v1.98): strict town-only opt-in with no new wire field', () => {
437
+ const plain = readManifest(base(), has).manifest.places.main;
438
+ const town = readManifest(base({ resumePose: true }), has);
439
+ assert.deepEqual(town.errors, []);
440
+ assert.equal(town.manifest.places.main.resumePose, true);
441
+ assert.equal(plain.resumePose, undefined);
442
+ assert.deepEqual(publicPlace('main', town.manifest.places.main), publicPlace('main', plain));
443
+ for (const resumePose of [false, null, 0, 1, 'true', {}, []]) {
444
+ assert.match(readManifest(base({ resumePose }), has).errors.join(), /resumePose must be true or absent/);
445
+ }
446
+ assert.match(readManifest(base({ resumePose: true, result: { outcomes: ['win'] } }), has).errors.join(), /without a result/);
447
+ const named = readManifest(base({ places: { square: { title: 'Square', scene: 'scenes/main.scene', resumePose: true } } }), has);
448
+ assert.deepEqual(named.errors, []);
449
+ assert.equal(named.manifest.places.square.resumePose, true);
450
+ });
451
+
273
452
  test('a session learns its place from the session, never a client', () => {
274
453
  const { manifest } = readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene' } } }), has);
275
454
  assert.deepEqual(resolvePlace({ sessionId: 'abc', place: 'race' }, manifest), { id: 'race', source: 'host' });
@@ -308,6 +487,22 @@ test('npcs name a shared-character route', () => {
308
487
  assert.match(readManifest(base({ npcs: { route: 'town' } }, { server, characterBundle: clientAuthority }), has).errors[0], /authority/);
309
488
  });
310
489
 
490
+ test('v1.83: turnsAtOnce is an integer 1-3, storing only multiple slots', () => {
491
+ const characterBundle = { characters: [{ id: 'greeter' }], conversation: { version: 1, authority: 'server', maxListeners: 0 } };
492
+ const parse = (turnsAtOnce) => readManifest(base({ npcs: { ...(turnsAtOnce !== undefined ? { turnsAtOnce } : {}) } }, { characterBundle }), has);
493
+ const absent = parse().manifest;
494
+ assert.equal(JSON.stringify(parse(1).manifest), JSON.stringify(absent));
495
+ assert.equal(JSON.stringify(publicPlace('main', parse(1).manifest.places.main)), JSON.stringify(publicPlace('main', absent.places.main)));
496
+ for (const value of [2, 3]) {
497
+ assert.deepEqual(parse(value).errors, []);
498
+ assert.equal(parse(value).manifest.places.main.npcs.turnsAtOnce, value);
499
+ }
500
+ for (const value of [null, 0, 4, -1, 1.5, '3', true, [], {}]) {
501
+ assert.match(parse(value).errors.join(), /turnsAtOnce must be an integer from 1 to 3/);
502
+ assert.equal(parse(value).manifest, null);
503
+ }
504
+ });
505
+
311
506
  test('a door to a local deck may not drift from that deck\'s castle.json', () => {
312
507
  return import('./check.mjs').then(async ({ default: check }) => {
313
508
  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'hub-door-check-'));
@@ -343,3 +538,280 @@ test('a door to a local deck may not drift from that deck\'s castle.json', () =>
343
538
  });
344
539
 
345
540
  console.log(`hub-game manifest: ${n} tests passed`);
541
+
542
+ // Your games is the deck's boolean, never a per-place option.
543
+ {
544
+ const before = readManifest(base(), has);
545
+ for (const yourGames of [undefined, false]) {
546
+ const read = readManifest(base(yourGames === undefined ? {} : { yourGames }), has);
547
+ assert.deepEqual(read, before);
548
+ assert.ok(!('yourGames' in read.manifest));
549
+ }
550
+ const on = readManifest(base({ yourGames: true }), has);
551
+ assert.deepEqual(on.errors, []);
552
+ assert.equal(on.manifest.yourGames, true);
553
+ assert.ok(!('yourGames' in publicPlace('main', on.manifest.places.main)));
554
+ for (const yourGames of [1, null, 'true', {}, []]) {
555
+ assert.match(readManifest(base({ yourGames }), has).errors.join(), /yourGames must be true or false/);
556
+ }
557
+ assert.match(readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene', yourGames: true } } }), has).errors.join(), /yourGames is not part/);
558
+ console.log('hub-game manifest yourGames: opt-in, false/absent parity, bad values, deck-only passed');
559
+ }
560
+
561
+ // Avatar colours are opt-in for the whole deck, like Your games.
562
+ {
563
+ const before = readManifest(base(), has);
564
+ for (const avatarColors of [undefined, false]) {
565
+ const read = readManifest(base(avatarColors === undefined ? {} : { avatarColors }), has);
566
+ assert.deepEqual(read, before);
567
+ assert.equal(JSON.stringify(read.manifest), JSON.stringify(before.manifest));
568
+ assert.ok(!('avatarColors' in read.manifest));
569
+ }
570
+ const on = readManifest(base({ avatarColors: true }), has);
571
+ assert.deepEqual(on.errors, []);
572
+ assert.equal(on.manifest.avatarColors, true);
573
+ assert.ok(!('avatarColors' in publicPlace('main', on.manifest.places.main)));
574
+ for (const avatarColors of [1, null, 'true', {}, []]) {
575
+ assert.match(readManifest(base({ avatarColors }), has).errors.join(), /avatarColors must be true or false/);
576
+ }
577
+ assert.match(readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene', avatarColors: true } } }), has).errors.join(), /avatarColors is not part/);
578
+ console.log('hub-game manifest avatarColors: opt-in, false/absent byte parity, bad values, deck-only passed');
579
+ }
580
+
581
+ // Publish-time scene limits are separate from the content pack total budget.
582
+ {
583
+ const { default: check } = await import('./check.mjs');
584
+ const { default: pack } = await import('./pack.mjs');
585
+ const { validatePack } = await import('../code/client/packFormat.js');
586
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'hub-scene-budget-'));
587
+ try {
588
+ fs.mkdirSync(path.join(root, 'scenes'));
589
+ fs.writeFileSync(path.join(root, 'castle.json'), JSON.stringify({ server: { main: 'code/server/index.js' }, hub: { contract: 1, title: 'Town' } }));
590
+ const sceneFile = path.join(root, 'scenes/main.scene');
591
+ const outFile = path.join(root, 'pack.json');
592
+ const acceptsBoth = async (text) => {
593
+ fs.writeFileSync(sceneFile, text);
594
+ assert.deepEqual((await check({ deckDir: root, self: true })).errors, []);
595
+ assert.deepEqual((await pack({ deckDir: root, self: true, outFile })).errors, []);
596
+ const bytes = fs.readFileSync(outFile);
597
+ assert.deepEqual(validatePack(JSON.parse(bytes), { byteLength: bytes.length }).errors, []);
598
+ };
599
+ const refusesBoth = async (text, checkError, packError) => {
600
+ fs.writeFileSync(sceneFile, text);
601
+ assert.match((await check({ deckDir: root, self: true })).errors.join(), checkError);
602
+ assert.match((await pack({ deckDir: root, self: true })).errors.join(), packError);
603
+ };
604
+ const actors = Array.from({ length: 6000 }, (_, i) => ({ id: `a${i}`, components: i ? {} : { Player: {} } }));
605
+ await acceptsBoth(JSON.stringify({ actors: actors.slice(0, 1600) }));
606
+ await acceptsBoth(JSON.stringify({ actors }));
607
+ await refusesBoth(
608
+ JSON.stringify({ actors: [...actors, { id: 'overflow', components: {} }] }),
609
+ /6001 actors.*at most 6000/,
610
+ /6001 actors, over 6000/,
611
+ );
612
+ const text = JSON.stringify({ actors: actors.slice(0, 1) });
613
+ await acceptsBoth(text.padEnd(2 * 1024 * 1024, ' '));
614
+ await acceptsBoth(text.padEnd(3 * 1024 * 1024, ' '));
615
+ await refusesBoth(text.padEnd(3 * 1024 * 1024 + 1, ' '), /over 3072 KB/, /over 3145728 bytes/);
616
+ // UTF-8 bytes, rather than JS string length, hold the same boundary.
617
+ const unicode = JSON.stringify({ actors: actors.slice(0, 1), note: 'é' });
618
+ const atLimit = unicode + ' '.repeat(3 * 1024 * 1024 - Buffer.byteLength(unicode));
619
+ await acceptsBoth(atLimit);
620
+ await refusesBoth(atLimit + ' ', /over 3072 KB/, /over 3145728 bytes/);
621
+
622
+ // Each scene fits, but the exported document still has a 4 MiB total cap.
623
+ fs.mkdirSync(path.join(root, 'blueprints'));
624
+ fs.writeFileSync(path.join(root, 'blueprints/extra.scene'), '{"actors":[]}'.padEnd(2 * 1024 * 1024, ' '));
625
+ fs.writeFileSync(sceneFile, JSON.stringify({ actors: actors.slice(0, 1), asset: 'blueprints/extra.scene' }).padEnd(3 * 1024 * 1024, ' '));
626
+ assert.deepEqual((await check({ deckDir: root, self: true })).errors, []);
627
+ assert.match((await pack({ deckDir: root, self: true })).errors.join(), /the pack is .* bytes, over 4194304/);
628
+ } finally {
629
+ fs.rmSync(root, { recursive: true, force: true });
630
+ }
631
+ console.log('hub-game scene budgets: check and export accept 6000 actors and 3 MB, refuse overflow; 4 MB pack cap enforced');
632
+ }
633
+
634
+ // The publish-time scene check uses the same parser for per-body overrides,
635
+ // including properties inherited from a blueprint.
636
+ {
637
+ const { default: check } = await import('./check.mjs');
638
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'hub-npc-slots-'));
639
+ try {
640
+ fs.mkdirSync(path.join(root, 'scenes'));
641
+ fs.mkdirSync(path.join(root, 'blueprints'));
642
+ fs.writeFileSync(path.join(root, 'castle.json'), JSON.stringify(base({}, { server: { main: 'code/server/index.js' } })));
643
+ for (const blueprint of [false, true]) {
644
+ for (const value of [undefined, 1, 2, 3, null, 0, 4, 2.5, '3', true]) {
645
+ const npc = { turnsAtOnce: value };
646
+ const actor = { id: 'npc', components: { HubNpc: npc } };
647
+ if (blueprint) {
648
+ fs.writeFileSync(path.join(root, 'blueprints/npc.scene'), JSON.stringify({ actors: [{ components: actor.components }] }));
649
+ actor.components = {};
650
+ actor.blueprint = 'blueprints/npc.scene';
651
+ }
652
+ fs.writeFileSync(path.join(root, 'scenes/main.scene'), JSON.stringify({ actors: [{ id: 'player', components: { Player: {} } }, actor] }));
653
+ const errors = (await check({ deckDir: root, self: true })).errors;
654
+ if (value === undefined || [1, 2, 3].includes(value)) assert.deepEqual(errors, []);
655
+ else assert.match(errors.join(), /HubNpc.turnsAtOnce must be an integer from 1 to 3/);
656
+ }
657
+ }
658
+ } finally {
659
+ fs.rmSync(root, { recursive: true, force: true });
660
+ }
661
+ console.log('hub-game NPC slots: manifest and inherited body overrides validated');
662
+ }
663
+
664
+ test('companion idle is an optional client-only boolean', () => {
665
+ const keyless = readManifest(base(), has);
666
+ assert.deepEqual(readManifest(base({ companionIdle: true }), has), keyless);
667
+ assert.deepEqual(readManifest(base({ companionIdle: false }), has), keyless);
668
+ assert.match(readManifest(base({ companionIdle: 1 }), has).errors.join(), /companionIdle must be true or false/);
669
+ });
670
+
671
+ test('Low actor budget is an optional client-only boolean', () => {
672
+ assert.deepEqual(readManifest(base({ lowActorBudget: true }), has), readManifest(base(), has));
673
+ assert.match(readManifest(base({ lowActorBudget: 1 }), has).errors.join(), /lowActorBudget must be true or false/);
674
+ });
675
+
676
+ test('rendering and timing flags are optional client-only booleans with identical server manifests', () => {
677
+ const keyless = readManifest(base(), has);
678
+ for (const key of ['weakestTier', 'weakestLookBake', 'mergeFarAvatars', 'playOnlyEntry', 'loadTimings']) {
679
+ for (const value of [undefined, true, false]) assert.deepEqual(readManifest(base({ [key]: value }), has), keyless);
680
+ for (const value of [1, null, 'true']) assert.match(readManifest(base({ [key]: value }), has).errors.join(), new RegExp(key + ' must be true or false'));
681
+ }
682
+ assert.deepEqual(readManifest(base({ mergeFarAvatars: true, playOnlyEntry: true, loadTimings: true }), has), keyless);
683
+ });
684
+
685
+ test('the default environment switch is a root-only client boolean with wire parity', () => {
686
+ const keyless = readManifest(base(), has);
687
+ for (const defaultEnvironment of [undefined, true, false]) {
688
+ const read = readManifest(base(defaultEnvironment === undefined ? {} : { defaultEnvironment }), has);
689
+ assert.deepEqual(read, keyless);
690
+ }
691
+ for (const defaultEnvironment of [1, null, 'false', {}, []]) {
692
+ assert.match(readManifest(base({ defaultEnvironment }), has).errors.join(), /defaultEnvironment must be true or false/);
693
+ }
694
+ assert.match(
695
+ readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene', defaultEnvironment: false } } }), has).errors.join(),
696
+ /defaultEnvironment is not part/,
697
+ );
698
+ });
699
+
700
+ test('Low actor distance is an optional client-only boolean', () => {
701
+ assert.deepEqual(readManifest(base({ lowActorDistance: true }), has), readManifest(base(), has));
702
+ assert.match(readManifest(base({ lowActorDistance: 1 }), has).errors.join(), /lowActorDistance must be true or false/);
703
+ });
704
+
705
+ test('pong deadline is a client-only deck option with server byte parity', () => {
706
+ const keyless = readManifest(base(), has);
707
+ for (const pongTimeoutMs of [0, 45000, 2147483647]) assert.deepEqual(readManifest(base({ pongTimeoutMs }), has), keyless);
708
+ for (const pongTimeoutMs of [-1, 0.5, Infinity, 2147483648, '45000', null]) assert.match(readManifest(base({ pongTimeoutMs }), has).errors.join(), /hub.pongTimeoutMs must be an integer/);
709
+ assert.match(readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene', pongTimeoutMs: 45000 } } }), has).errors.join(), /pongTimeoutMs is not part/);
710
+ });
711
+ console.log('hub-game pong deadline manifest: validation and client-only byte parity passed');
712
+
713
+ for (const value of [false, 1, 'true', null]) {
714
+ assert.ok(readManifest(base({ under13Choices: value }), has).errors.some((e) => e.includes('under13Choices')));
715
+ }
716
+ {
717
+ const plain = readManifest(base(), has).manifest.places.main;
718
+ const opted = readManifest(base({ under13Choices: true }), has).manifest.places.main;
719
+ assert.equal(Object.hasOwn(plain, 'under13Choices'), false);
720
+ assert.equal(opted.under13Choices, true);
721
+ assert.deepEqual(publicPlace('main', opted), publicPlace('main', plain), 'age policy stays server-only');
722
+ }
723
+
724
+ for (const value of [false, 1, 'true', null]) assert.ok(readManifest(base({ talkLog: value }), has).errors.some((e) => e.includes('talkLog')));
725
+ {
726
+ const plain = readManifest(base(), has).manifest.places.main;
727
+ const opted = readManifest(base({ talkLog: true }), has).manifest.places.main;
728
+ assert.equal(Object.hasOwn(plain, 'talkLog'), false);
729
+ assert.equal(opted.talkLog, true);
730
+ assert.deepEqual(publicPlace('main', opted), publicPlace('main', plain), 'archive policy stays server-only');
731
+ }
732
+
733
+ // v1.120: the optional play entry never relaxes the Tier 0 HTML restrictions.
734
+ {
735
+ const { default: check } = await import('./check.mjs');
736
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'hub-play-entry-'));
737
+ try {
738
+ fs.mkdirSync(path.join(root, 'scenes'));
739
+ fs.writeFileSync(path.join(root, 'scenes/main.scene'), JSON.stringify({ actors: [] }));
740
+ const run = async (flag, html) => {
741
+ const hub = { contract: 1, title: 'Game', ...(flag === undefined ? {} : { playOnlyEntry: flag }) };
742
+ fs.writeFileSync(path.join(root, 'castle.json'), JSON.stringify({ server: { main: 'imports/castle.hub-game/code/server/index.js' }, hub }));
743
+ fs.writeFileSync(path.join(root, 'index.html'), html);
744
+ return check({ deckDir: root });
745
+ };
746
+ const script = (src) => `<script type="module" src="${src}"></script>`;
747
+ for (const prefix of ['/', './', '']) {
748
+ const main = script(`${prefix}imports/castle.hub-game/main.jsx`);
749
+ const play = script(`${prefix}imports/castle.hub-game/play.jsx`);
750
+ for (const flag of [undefined, false, true]) assert.deepEqual((await run(flag, main)).errors, []);
751
+ assert.deepEqual((await run(true, play)).errors, []);
752
+ for (const flag of [undefined, false, 1, 'true', null]) {
753
+ assert.match((await run(flag, play)).errors.join(), /index.html must load/);
754
+ }
755
+ }
756
+ const main = script('/imports/castle.hub-game/main.jsx');
757
+ const play = script('/imports/castle.hub-game/play.jsx');
758
+ const oldError = "index.html must load the kit's entry (/imports/castle.hub-game/main.jsx) and nothing else that runs.";
759
+ assert.deepEqual((await run(undefined, play)).errors, [oldError]);
760
+ assert.deepEqual(await run(undefined, main), await run(false, main));
761
+ for (const html of [
762
+ `${play}${main}`, `${play}<script>alert(1)</script>`,
763
+ play.replace('</script>', 'alert(1)</script>'), `${play}<body onload="alert(1)">`,
764
+ `${play}<iframe src="/other"></iframe>`, `${play}<link rel="modulepreload" href="/other.js">`,
765
+ script('/imports/castle.hub-game/play.jsx?other=1'), script('https://example.com/play.jsx'),
766
+ ]) assert.match((await run(true, html)).errors.join(), /index.html must load/);
767
+ console.log('hub-game play entry: explicit opt-in, legacy parity and Tier 0 restrictions passed');
768
+ } finally {
769
+ fs.rmSync(root, { recursive: true, force: true });
770
+ }
771
+ }
772
+
773
+ // Client-only opt-in: accepted only on the deck, never added to wire state.
774
+ for (const playCards of [undefined, false, true]) {
775
+ const read = readManifest(base(playCards === undefined ? {} : { playCards }), has);
776
+ assert.deepEqual(read.errors, []);
777
+ assert.deepEqual(read.manifest, readManifest(base(), has).manifest);
778
+ }
779
+ for (const playCards of [1, null, 'true', {}, []]) {
780
+ assert.match(readManifest(base({ playCards }), has).errors.join(), /playCards must be true or false/);
781
+ }
782
+ assert.match(readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene', playCards: true } } }), has).errors.join(), /playCards is not part/);
783
+ console.log('hub-game manifest playCards: deck-only boolean, wire parity passed');
784
+
785
+ // Client-only opt-in: accepted only on the deck, never added to wire state.
786
+ for (const loadingCover of [undefined, false, true]) {
787
+ const read = readManifest(base(loadingCover === undefined ? {} : { loadingCover }), has);
788
+ assert.deepEqual(read.errors, []);
789
+ assert.deepEqual(read.manifest, readManifest(base(), has).manifest);
790
+ }
791
+ for (const loadingCover of [1, null, 'true', {}, []]) {
792
+ assert.match(readManifest(base({ loadingCover }), has).errors.join(), /loadingCover must be true or false/);
793
+ }
794
+ assert.match(readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene', loadingCover: true } } }), has).errors.join(), /loadingCover is not part/);
795
+ console.log('hub-game manifest loadingCover: deck-only boolean, wire parity passed');
796
+
797
+ // v1.123 safe edges are client-only and add no server or wire field.
798
+ {
799
+ const legacy = readManifest(base(), has).manifest;
800
+ for (const safeInsets of [false, true]) {
801
+ assert.deepEqual(readManifest(base({ safeInsets }), has), { errors: [], manifest: legacy });
802
+ }
803
+ for (const safeInsets of [null, 0, 'true', {}, []]) {
804
+ assert.deepEqual(readManifest(base({ safeInsets }), has).errors, ['hub.safeInsets must be true or false.']);
805
+ }
806
+ assert(readManifest(base({ places: { arena: { title: 'Arena', scene: 'scenes/arena.scene', safeInsets: true } } }), has).errors.length);
807
+ console.log('safeInsets: deck-only boolean, false/true server and wire parity passed');
808
+ }
809
+
810
+ for (const firstVisit of [{ live: ['home', 'door'] }, { live: ['npc'] }]) {
811
+ const enabled = readManifest(base({ firstVisit }), has);
812
+ assert.deepEqual(enabled.errors, []);
813
+ assert.deepEqual(enabled.manifest, readManifest(base(), has).manifest, 'firstVisit stays server-only');
814
+ }
815
+ for (const firstVisit of [null, true, {}, { live: [] }, { live: ['home', 'home'] }, { live: ['other'] }, { live: ['home'], extra: true }]) {
816
+ assert(readManifest(base({ firstVisit }), has).errors.some(e => e.includes('firstVisit')));
817
+ }