castle-web-cli 0.4.232 → 0.4.233

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 (355) 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/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -270,6 +270,58 @@ test('results are checked against the declared shape', () => {
270
270
  assert.match(checkResult(town, { outcome: 'win' }).error, /declares no result/);
271
271
  });
272
272
 
273
+ test('resume (v1.72): only true, only on a place with a result, carried only when set', () => {
274
+ const game = { result: { outcomes: ['win', 'lose'] } };
275
+ const ok = readManifest(base({ ...game, resume: true }), has);
276
+ assert.deepEqual(ok.errors, []);
277
+ assert.equal(ok.manifest.places.main.resume, true);
278
+ assert.equal(publicPlace('main', ok.manifest.places.main).resume, true);
279
+ const named = readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene', ...game, resume: true } } }), has);
280
+ assert.deepEqual(named.errors, []);
281
+ assert.equal(named.manifest.places.race.resume, true);
282
+ assert.match(readManifest(base({ resume: true }), has).errors.join(), /hub\.resume is only for a place with a result/);
283
+ 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/);
284
+ for (const value of [false, null, 0, 1, 'true', {}, []]) {
285
+ assert.match(readManifest(base({ ...game, resume: value }), has).errors.join(), /hub\.resume must be true or absent/, String(value));
286
+ }
287
+ const absent = readManifest(base(game), has).manifest.places.main;
288
+ assert(!Object.hasOwn(absent, 'resume'));
289
+ assert(!Object.hasOwn(publicPlace('main', absent), 'resume'));
290
+ assert.equal(JSON.stringify(publicPlace('main', absent)), JSON.stringify(publicPlace('main', readManifest(base(game), has).manifest.places.main)));
291
+ });
292
+
293
+ test('keep resume (v1.89): closed opt-in object, result only, existing wire field', () => {
294
+ const game = { result: { outcomes: ['win', 'lose'] } };
295
+ const ok = readManifest(base({ ...game, resume: { keep: true } }), has);
296
+ assert.deepEqual(ok.errors, []);
297
+ assert.equal(ok.manifest.places.main.resume, true);
298
+ assert.equal(ok.manifest.places.main.resumeKeep, true);
299
+ const legacy = readManifest(base({ ...game, resume: true }), has).manifest.places.main;
300
+ assert.equal(legacy.resumeKeep, undefined);
301
+ assert.deepEqual(
302
+ publicPlace('main', ok.manifest.places.main),
303
+ publicPlace('main', legacy),
304
+ 'no new wire keys',
305
+ );
306
+ for (const value of [{ keep: false }, { keep: 1 }, { keep: true, other: true }]) {
307
+ assert.ok(readManifest(base({ ...game, resume: value }), has).errors.length);
308
+ }
309
+ assert.match(
310
+ readManifest(base({ resume: { keep: true } }), has).errors.join(),
311
+ /only for a place with a result/,
312
+ );
313
+ const named = readManifest(
314
+ base({
315
+ places: {
316
+ race: { title: 'Race', scene: 'scenes/race.scene', ...game, resume: { keep: true } },
317
+ },
318
+ }),
319
+ has,
320
+ );
321
+ assert.deepEqual(named.errors, []);
322
+ assert.equal(named.manifest.places.race.resumeKeep, true);
323
+ });
324
+
273
325
  test('a session learns its place from the session, never a client', () => {
274
326
  const { manifest } = readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene' } } }), has);
275
327
  assert.deepEqual(resolvePlace({ sessionId: 'abc', place: 'race' }, manifest), { id: 'race', source: 'host' });
@@ -308,6 +360,22 @@ test('npcs name a shared-character route', () => {
308
360
  assert.match(readManifest(base({ npcs: { route: 'town' } }, { server, characterBundle: clientAuthority }), has).errors[0], /authority/);
309
361
  });
310
362
 
363
+ test('v1.83: turnsAtOnce is an integer 1-3, storing only multiple slots', () => {
364
+ const characterBundle = { characters: [{ id: 'greeter' }], conversation: { version: 1, authority: 'server', maxListeners: 0 } };
365
+ const parse = (turnsAtOnce) => readManifest(base({ npcs: { ...(turnsAtOnce !== undefined ? { turnsAtOnce } : {}) } }, { characterBundle }), has);
366
+ const absent = parse().manifest;
367
+ assert.equal(JSON.stringify(parse(1).manifest), JSON.stringify(absent));
368
+ assert.equal(JSON.stringify(publicPlace('main', parse(1).manifest.places.main)), JSON.stringify(publicPlace('main', absent.places.main)));
369
+ for (const value of [2, 3]) {
370
+ assert.deepEqual(parse(value).errors, []);
371
+ assert.equal(parse(value).manifest.places.main.npcs.turnsAtOnce, value);
372
+ }
373
+ for (const value of [null, 0, 4, -1, 1.5, '3', true, [], {}]) {
374
+ assert.match(parse(value).errors.join(), /turnsAtOnce must be an integer from 1 to 3/);
375
+ assert.equal(parse(value).manifest, null);
376
+ }
377
+ });
378
+
311
379
  test('a door to a local deck may not drift from that deck\'s castle.json', () => {
312
380
  return import('./check.mjs').then(async ({ default: check }) => {
313
381
  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'hub-door-check-'));
@@ -343,3 +411,142 @@ test('a door to a local deck may not drift from that deck\'s castle.json', () =>
343
411
  });
344
412
 
345
413
  console.log(`hub-game manifest: ${n} tests passed`);
414
+
415
+ // Your games is the deck's boolean, never a per-place option.
416
+ {
417
+ const before = readManifest(base(), has);
418
+ for (const yourGames of [undefined, false]) {
419
+ const read = readManifest(base(yourGames === undefined ? {} : { yourGames }), has);
420
+ assert.deepEqual(read, before);
421
+ assert.ok(!('yourGames' in read.manifest));
422
+ }
423
+ const on = readManifest(base({ yourGames: true }), has);
424
+ assert.deepEqual(on.errors, []);
425
+ assert.equal(on.manifest.yourGames, true);
426
+ assert.ok(!('yourGames' in publicPlace('main', on.manifest.places.main)));
427
+ for (const yourGames of [1, null, 'true', {}, []]) {
428
+ assert.match(readManifest(base({ yourGames }), has).errors.join(), /yourGames must be true or false/);
429
+ }
430
+ assert.match(readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene', yourGames: true } } }), has).errors.join(), /yourGames is not part/);
431
+ console.log('hub-game manifest yourGames: opt-in, false/absent parity, bad values, deck-only passed');
432
+ }
433
+
434
+ // Avatar colours are opt-in for the whole deck, like Your games.
435
+ {
436
+ const before = readManifest(base(), has);
437
+ for (const avatarColors of [undefined, false]) {
438
+ const read = readManifest(base(avatarColors === undefined ? {} : { avatarColors }), has);
439
+ assert.deepEqual(read, before);
440
+ assert.equal(JSON.stringify(read.manifest), JSON.stringify(before.manifest));
441
+ assert.ok(!('avatarColors' in read.manifest));
442
+ }
443
+ const on = readManifest(base({ avatarColors: true }), has);
444
+ assert.deepEqual(on.errors, []);
445
+ assert.equal(on.manifest.avatarColors, true);
446
+ assert.ok(!('avatarColors' in publicPlace('main', on.manifest.places.main)));
447
+ for (const avatarColors of [1, null, 'true', {}, []]) {
448
+ assert.match(readManifest(base({ avatarColors }), has).errors.join(), /avatarColors must be true or false/);
449
+ }
450
+ assert.match(readManifest(base({ places: { race: { title: 'Race', scene: 'scenes/race.scene', avatarColors: true } } }), has).errors.join(), /avatarColors is not part/);
451
+ console.log('hub-game manifest avatarColors: opt-in, false/absent byte parity, bad values, deck-only passed');
452
+ }
453
+
454
+ // Publish-time scene limits are separate from the content pack total budget.
455
+ {
456
+ const { default: check } = await import('./check.mjs');
457
+ const { default: pack } = await import('./pack.mjs');
458
+ const { validatePack } = await import('../code/client/packFormat.js');
459
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'hub-scene-budget-'));
460
+ try {
461
+ fs.mkdirSync(path.join(root, 'scenes'));
462
+ fs.writeFileSync(path.join(root, 'castle.json'), JSON.stringify({ server: { main: 'code/server/index.js' }, hub: { contract: 1, title: 'Town' } }));
463
+ const sceneFile = path.join(root, 'scenes/main.scene');
464
+ const outFile = path.join(root, 'pack.json');
465
+ const acceptsBoth = async (text) => {
466
+ fs.writeFileSync(sceneFile, text);
467
+ assert.deepEqual((await check({ deckDir: root, self: true })).errors, []);
468
+ assert.deepEqual((await pack({ deckDir: root, self: true, outFile })).errors, []);
469
+ const bytes = fs.readFileSync(outFile);
470
+ assert.deepEqual(validatePack(JSON.parse(bytes), { byteLength: bytes.length }).errors, []);
471
+ };
472
+ const refusesBoth = async (text, checkError, packError) => {
473
+ fs.writeFileSync(sceneFile, text);
474
+ assert.match((await check({ deckDir: root, self: true })).errors.join(), checkError);
475
+ assert.match((await pack({ deckDir: root, self: true })).errors.join(), packError);
476
+ };
477
+ const actors = Array.from({ length: 6000 }, (_, i) => ({ id: `a${i}`, components: i ? {} : { Player: {} } }));
478
+ await acceptsBoth(JSON.stringify({ actors: actors.slice(0, 1600) }));
479
+ await acceptsBoth(JSON.stringify({ actors }));
480
+ await refusesBoth(
481
+ JSON.stringify({ actors: [...actors, { id: 'overflow', components: {} }] }),
482
+ /6001 actors.*at most 6000/,
483
+ /6001 actors, over 6000/,
484
+ );
485
+ const text = JSON.stringify({ actors: actors.slice(0, 1) });
486
+ await acceptsBoth(text.padEnd(2 * 1024 * 1024, ' '));
487
+ await acceptsBoth(text.padEnd(3 * 1024 * 1024, ' '));
488
+ await refusesBoth(text.padEnd(3 * 1024 * 1024 + 1, ' '), /over 3072 KB/, /over 3145728 bytes/);
489
+ // UTF-8 bytes, rather than JS string length, hold the same boundary.
490
+ const unicode = JSON.stringify({ actors: actors.slice(0, 1), note: 'é' });
491
+ const atLimit = unicode + ' '.repeat(3 * 1024 * 1024 - Buffer.byteLength(unicode));
492
+ await acceptsBoth(atLimit);
493
+ await refusesBoth(atLimit + ' ', /over 3072 KB/, /over 3145728 bytes/);
494
+
495
+ // Each scene fits, but the exported document still has a 4 MiB total cap.
496
+ fs.mkdirSync(path.join(root, 'blueprints'));
497
+ fs.writeFileSync(path.join(root, 'blueprints/extra.scene'), '{"actors":[]}'.padEnd(2 * 1024 * 1024, ' '));
498
+ fs.writeFileSync(sceneFile, JSON.stringify({ actors: actors.slice(0, 1), asset: 'blueprints/extra.scene' }).padEnd(3 * 1024 * 1024, ' '));
499
+ assert.deepEqual((await check({ deckDir: root, self: true })).errors, []);
500
+ assert.match((await pack({ deckDir: root, self: true })).errors.join(), /the pack is .* bytes, over 4194304/);
501
+ } finally {
502
+ fs.rmSync(root, { recursive: true, force: true });
503
+ }
504
+ console.log('hub-game scene budgets: check and export accept 6000 actors and 3 MB, refuse overflow; 4 MB pack cap enforced');
505
+ }
506
+
507
+ // The publish-time scene check uses the same parser for per-body overrides,
508
+ // including properties inherited from a blueprint.
509
+ {
510
+ const { default: check } = await import('./check.mjs');
511
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'hub-npc-slots-'));
512
+ try {
513
+ fs.mkdirSync(path.join(root, 'scenes'));
514
+ fs.mkdirSync(path.join(root, 'blueprints'));
515
+ fs.writeFileSync(path.join(root, 'castle.json'), JSON.stringify(base({}, { server: { main: 'code/server/index.js' } })));
516
+ for (const blueprint of [false, true]) {
517
+ for (const value of [undefined, 1, 2, 3, null, 0, 4, 2.5, '3', true]) {
518
+ const npc = { turnsAtOnce: value };
519
+ const actor = { id: 'npc', components: { HubNpc: npc } };
520
+ if (blueprint) {
521
+ fs.writeFileSync(path.join(root, 'blueprints/npc.scene'), JSON.stringify({ actors: [{ components: actor.components }] }));
522
+ actor.components = {};
523
+ actor.blueprint = 'blueprints/npc.scene';
524
+ }
525
+ fs.writeFileSync(path.join(root, 'scenes/main.scene'), JSON.stringify({ actors: [{ id: 'player', components: { Player: {} } }, actor] }));
526
+ const errors = (await check({ deckDir: root, self: true })).errors;
527
+ if (value === undefined || [1, 2, 3].includes(value)) assert.deepEqual(errors, []);
528
+ else assert.match(errors.join(), /HubNpc.turnsAtOnce must be an integer from 1 to 3/);
529
+ }
530
+ }
531
+ } finally {
532
+ fs.rmSync(root, { recursive: true, force: true });
533
+ }
534
+ console.log('hub-game NPC slots: manifest and inherited body overrides validated');
535
+ }
536
+
537
+ test('companion idle is an optional client-only boolean', () => {
538
+ const keyless = readManifest(base(), has);
539
+ assert.deepEqual(readManifest(base({ companionIdle: true }), has), keyless);
540
+ assert.deepEqual(readManifest(base({ companionIdle: false }), has), keyless);
541
+ assert.match(readManifest(base({ companionIdle: 1 }), has).errors.join(), /companionIdle must be true or false/);
542
+ });
543
+
544
+ test('Low actor budget is an optional client-only boolean', () => {
545
+ assert.deepEqual(readManifest(base({ lowActorBudget: true }), has), readManifest(base(), has));
546
+ assert.match(readManifest(base({ lowActorBudget: 1 }), has).errors.join(), /lowActorBudget must be true or false/);
547
+ });
548
+
549
+ test('Low actor distance is an optional client-only boolean', () => {
550
+ assert.deepEqual(readManifest(base({ lowActorDistance: true }), has), readManifest(base(), has));
551
+ assert.match(readManifest(base({ lowActorDistance: 1 }), has).errors.join(), /lowActorDistance must be true or false/);
552
+ });