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
@@ -24,7 +24,7 @@ const DEG = Math.PI / 180;
24
24
 
25
25
  // The kit's emotes and how long each plays (ms). Drawn by the hub client
26
26
  // (`code/client/idle.js`) as a motion of the avatar plus an emoji over it.
27
- export const EMOTES = { wave: 2000, dance: 2400, cheer: 1600, bow: 1600, spin: 1200 };
27
+ export const EMOTES = { wave: 2800, dance: 3200, cheer: 2400, bow: 2400, spin: 2000 };
28
28
  // One emote a player may start every this many simulation ms.
29
29
  export const EMOTE_EVERY_MS = 2000;
30
30
  // How far (flat metres) from a seat's footprint a player may be when they ask
@@ -89,6 +89,10 @@ function startEmote(h, playerId, id) {
89
89
  const now = h.sim.timeMs;
90
90
  h.emotes.set(playerId, { id, at: now, until: now + EMOTES[id] });
91
91
  h.emoteAt.set(playerId, now);
92
+ // v1.47: only a player's emote can start nearby bodies reacting.
93
+ if (present(h, playerId)) {
94
+ h.npcs?.react(playerId, id);
95
+ }
92
96
  }
93
97
 
94
98
  // `{ k: 'hub-emote', id }` from a client: a kit emote, from a player who is
@@ -150,31 +154,37 @@ function emotesNow(h) {
150
154
 
151
155
  // --- seats ----------------------------------------------------------------
152
156
 
153
- // A seat of the place: a scene actor carrying `HubSeat` (`{ face, height }`),
154
- // not hidden. `at` is where its sitter's body is held, `facing` radians. A
155
- // seat stays where it was authored: an actor with a dynamic or kinematic
156
- // `Body` (one that can move) is not a seat, since its sitter would be held
157
- // where it no longer is.
157
+ // A shown HubSeat (`{ face, height }`): `at` holds the sitter's body,
158
+ // `facing` is radians. Authored moving bodies are not seats. In a decor
159
+ // place, spawned copies use their last pose; moving one stands its sitter.
158
160
  export function isMovable(actor) {
159
161
  const type = actor?.components?.Body?.type;
160
162
  return type === 'dynamic' || type === 'kinematic';
161
163
  }
162
164
 
165
+ function seatActor(h, seatId) {
166
+ return h.actors.find((a) => a.id === seatId) ?? (h.place?.decor ? h.spawned?.get(seatId)?.actor : null);
167
+ }
168
+
163
169
  export function seatOf(h, seatId) {
164
170
  if (typeof seatId !== 'string' || seatId.length > 128 || h.hidden.has(seatId)) {
165
171
  return null;
166
172
  }
167
- const actor = h.actors.find((a) => a.id === seatId);
173
+ const actor = seatActor(h, seatId);
168
174
  const props = actor?.components.HubSeat;
169
- if (!props || isMovable(actor)) {
175
+ const copy = h.place?.decor && h.spawned?.has(seatId);
176
+ if (!props || (isMovable(actor) && !(copy && actor.components.Body?.type === 'kinematic'))) {
170
177
  return null;
171
178
  }
172
179
  const seat = typeof props === 'object' ? props : {};
173
- const t = actor.components.Transform ?? {};
180
+ const t = copy ? (h.poses.get(seatId) ?? h.spawned.get(seatId).at) : actor.components.Transform ?? {};
174
181
  const shape = actor.components.Shape;
175
182
  const top = !shape ? 0 : shape.kind === 'sphere' ? (shape.radius ?? 0.5) : (shape.height ?? 1) / 2;
176
183
  const height = typeof seat.height === 'number' && Number.isFinite(seat.height) ? seat.height : top + SIT_BODY;
177
- const face = typeof seat.face === 'number' && Number.isFinite(seat.face) ? seat.face : (t.rotationY ?? 0);
184
+ const explicitFace = typeof seat.face === 'number' && Number.isFinite(seat.face);
185
+ const template = copy ? h.actors.find((a) => a.id === h.spawned.get(seatId).from) : null;
186
+ const turn = copy ? (t.rotationY ?? 0) - (template?.components.Transform?.rotationY ?? 0) : 0;
187
+ const face = explicitFace ? (copy ? seat.face + turn : seat.face) : (t.rotationY ?? 0);
178
188
  return {
179
189
  id: seatId,
180
190
  at: { x: t.x ?? 0, y: (t.y ?? 0) + height, z: t.z ?? 0 },
@@ -246,7 +256,9 @@ export function sitMessage(h, placeAt, playerId, data) {
246
256
  if (sitting(h, playerId) === seat.id || taken(h, seat.id, playerId)) {
247
257
  return;
248
258
  }
249
- const actor = h.actors.find((x) => x.id === seat.id);
259
+ const authored = seatActor(h, seat.id);
260
+ const pose = h.place?.decor && h.spawned?.has(seat.id) ? (h.poses.get(seat.id) ?? h.spawned.get(seat.id).at) : null;
261
+ const actor = pose ? { ...authored, components: { ...authored.components, Transform: pose } } : authored;
250
262
  if (!actor || footprintDistance(actor, body.at) > SIT_REACH || Math.abs(body.at.y - seat.at.y) > 3) {
251
263
  return;
252
264
  }
@@ -387,6 +399,12 @@ export function tick(h) {
387
399
  h.seated.delete(playerId);
388
400
  } else if (h.hidden.has(seatId)) {
389
401
  stand(h, playerId);
402
+ } else if (h.place?.decor) {
403
+ const seat = seatOf(h, seatId), hold = h.held.get(playerId);
404
+ const turn = seat ? seat.facing - hold.facing : 0;
405
+ if (!seat || Math.hypot(seat.at.x - hold.at.x, seat.at.y - hold.at.y, seat.at.z - hold.at.z) > 0.05 || Math.abs(Math.atan2(Math.sin(turn), Math.cos(turn))) > 0.01) {
406
+ stand(h, playerId);
407
+ }
390
408
  }
391
409
  }
392
410
  }
@@ -399,6 +417,7 @@ export function fields(h) {
399
417
  }
400
418
  return {
401
419
  ...(idle.emotes ? { hubEmotes: emotesNow(h) } : {}),
420
+ ...(idle.emotes ? h.npcs?.emoteFields() : {}),
402
421
  ...(idle.seats ? { hubSeated: seatedNow(h) } : {}),
403
422
  ...(idle.sounds.length ? { hubSounds: loopsNow(h) } : {}),
404
423
  };
@@ -7,7 +7,7 @@ import { makeSession } from '@imports/castle.real-time/code/server/session.js';
7
7
  import { game as deckGame } from '@imports/castle.real-time/code/server/gameHooks.js';
8
8
  import * as Poses from '@imports/castle.multiplayer-3d/code/client/poses.js';
9
9
  import * as Ownership from '@imports/castle.multiplayer-3d/code/server/ownership.js';
10
- import * as Players from '@imports/castle.multiplayer-3d/code/server/players.js';
10
+ import { hubPlayers } from './players.js';
11
11
  import * as World from '@imports/castle.multiplayer-3d/code/server/world.js';
12
12
  import * as Limits from '@imports/castle.multiplayer-3d/code/server/limits.js';
13
13
  import { resolveScenePath } from '@imports/castle.multiplayer-3d/code/server/sceneBodies.js';
@@ -53,7 +53,7 @@ export default {
53
53
  label: 'hub',
54
54
  poses: Poses,
55
55
  world: World,
56
- players: Players,
56
+ players: hubPlayers(hub),
57
57
  ownership: Ownership,
58
58
  game: hub,
59
59
  }),
@@ -11,13 +11,26 @@ const SPEECH_MAX = 240;
11
11
  // `hub.label` is drawn exactly as before NPCs existed.
12
12
  // `about` names the player the words concern (an NPC greeting them by name):
13
13
  // nobody a block hides from that player is ever sent it (`blocks.js`).
14
- export function setLabel(h, actorId, text, { style = 'tag', ttlMs, to, about } = {}, npc) {
14
+ // v1.39, a goal only: `distanceM` is the number of metres its pointer shows
15
+ // in place of the one the client measures to the actor (a pointer aimed at
16
+ // the next corner of a route, saying how far the walk to its end is), kept to
17
+ // the whole metre and only when finite and not negative; `distance: false`
18
+ // has it show none. Anything else, and any other style, is a label as before.
19
+ // v1.81: `edge: false` makes a goal a hint, drawn only over its actor.
20
+ export function setLabel(h, actorId, text, { style = 'tag', ttlMs, to, about, distanceM, distance, edge } = {}, npc) {
15
21
  if (!actorId) {
16
22
  return;
17
23
  }
18
24
  const targets = Array.isArray(to) ? to.filter((id) => typeof id === 'string') : null;
19
25
  const clear = text === null || text === undefined || text === '';
20
26
  const speech = style === 'speech';
27
+ const goal = !speech && style === 'goal' && Boolean(targets);
28
+ let shown = {};
29
+ if (goal && distance === false) {
30
+ shown = { distance: false };
31
+ } else if (goal && typeof distanceM === 'number' && Number.isFinite(distanceM) && distanceM >= 0) {
32
+ shown = { distanceM: Math.round(distanceM) };
33
+ }
21
34
  const label = clear
22
35
  ? null
23
36
  : {
@@ -30,6 +43,8 @@ export function setLabel(h, actorId, text, { style = 'tag', ttlMs, to, about } =
30
43
  until: ttlMs ? (h.sim?.timeMs ?? 0) + ttlMs : null,
31
44
  npc: Boolean(npc && speech),
32
45
  ...(typeof about === 'string' ? { about } : {}),
46
+ ...shown,
47
+ ...(goal && edge === false ? { edge: false } : {}),
33
48
  };
34
49
  if (!targets) {
35
50
  if (label) {
@@ -54,6 +69,17 @@ export function setLabel(h, actorId, text, { style = 'tag', ttlMs, to, about } =
54
69
  }
55
70
 
56
71
  export function wireLabel(label) {
57
- return label.npc ? { text: label.text, style: label.style, npc: true } : { text: label.text, style: label.style };
72
+ const wire = label.npc ? { text: label.text, style: label.style, npc: true } : { text: label.text, style: label.style };
73
+ // v1.39: only a goal that says which distance to show carries either key.
74
+ if (label.distance === false) {
75
+ wire.distance = false;
76
+ } else if (label.distanceM !== undefined) {
77
+ wire.distanceM = label.distanceM;
78
+ }
79
+ // v1.81: hints have no pointer at the screen's edge.
80
+ if (label.edge === false) {
81
+ wire.edge = false;
82
+ }
83
+ return wire;
58
84
  }
59
85
 
@@ -7,6 +7,10 @@
7
7
  // manifest is null when there are errors; otherwise every place has every
8
8
  // field filled with its default.
9
9
 
10
+ import { readUnlocks } from './earned.js';
11
+ import { readDecor } from './decor.js';
12
+
13
+ // Manifest/wire major stays 1; latest optional contract additions are v1.83.
10
14
  export const CONTRACT_VERSION = 1;
11
15
 
12
16
  export const CONTROLLERS = ['walk'];
@@ -22,6 +26,7 @@ export const PLACE_ID = /^[a-z][a-z0-9-]{0,23}$/;
22
26
  export const MAIN_PLACE = 'main';
23
27
  // How many other players each client of a place is sent (`nearestPlayers`).
24
28
  export const NEAREST_PLAYERS = 30;
29
+ export const NEAREST_PLAYERS_CELLS = 48;
25
30
  export const NEAREST_PLAYERS_CAP = 100;
26
31
  // Grabbing and throwing (v1.3, §6): what `grab: true` means, and the bounds of
27
32
  // each field. The fastest throw stays well under multiplayer-3d's limit on an
@@ -51,6 +56,14 @@ const SOUND_PATH = /^[A-Za-z0-9_@-][A-Za-z0-9_./@-]{0,199}$/;
51
56
  // place without it is read and sent exactly as before.
52
57
  const HUD_KEYS = ['clear'];
53
58
 
59
+ // v1.68 `ballot`: a tappable choice card (`ballot.js`). The deck's fixed
60
+ // lines are the only words a player can send through it, declared here so
61
+ // the server can refuse any other id and the client words them itself.
62
+ export const BALLOT_LINE_ID = /^[a-z0-9-]{1,24}$/;
63
+ export const BALLOT_MAX_LINES = 32;
64
+ export const BALLOT_LINE_MAX = 40;
65
+ export const BALLOT_ABOUT = ['face', 'self'];
66
+
54
67
  const PLACE_KEYS = [
55
68
  'title',
56
69
  'scene',
@@ -68,13 +81,39 @@ const PLACE_KEYS = [
68
81
  'grab',
69
82
  'idle',
70
83
  'hud',
84
+ 'decor',
85
+ 'actions',
86
+ 'companion',
87
+ 'ask',
88
+ 'menu',
89
+ 'ballot',
90
+ 'resume',
91
+ 'visibility',
71
92
  ];
72
93
  // `tiers` is the deck's, not a place's: the client's picture on a slow device
73
94
  // (v1.21, `code/client/tiers.js`). The server reads nothing of it.
74
95
  // `cues` is the deck's too (v1.23): a town that tells its players more about
75
96
  // the friends and party they came with. Both halves read it, and a deck
76
97
  // without it is sent and draws exactly what it did.
77
- const TOP_KEYS = ['contract', 'places', 'tiers', 'cues', ...PLACE_KEYS];
98
+ // `stuck` is the deck's as well (v1.33): a town offers a player who walks and
99
+ // gets nowhere the way back to its arrival. Both halves read it; the manifest
100
+ // carries the key only when it is true, so a deck without it reads as before.
101
+ // `labels` is the deck's and the client's alone, like `tiers` (v1.43): `"near"`
102
+ // keeps a town's labels near the player and apart (`code/client/labelsNear.js`).
103
+ // The server reads nothing of it and the manifest does not carry it.
104
+ // `soundscape` is the deck's (`code/client/soundscape.js` synthesises it):
105
+ // the sounds the kit makes itself -- NPC babble, footsteps -- and a sound
106
+ // control. `true` keeps babble and street steps; only new object fields ask
107
+ // for zone ambience, music, surface maps and UI cues (v1.49).
108
+ // Only the explicit cues part (v1.50) is read by the server. The manifest
109
+ // carries soundscape only when on, so a deck without it reads as before.
110
+ export const SOUNDSCAPE_KEYS = ['babble', 'steps', 'zones', 'ambience', 'ui', 'cues'];
111
+ export const SOUNDSCAPE_BEDS = ['square', 'meadow', 'night', 'harbour', 'crowd', 'market'];
112
+ export const SOUNDSCAPE_SURFACES = ['grass', 'street', 'wood', 'stone', 'sand', 'cobble'];
113
+ // `unlocks` is the deck's (v1.53): the earned items its places may give
114
+ // (`earned.js`). The manifest carries it only when declared, so a deck
115
+ // without it reads as before.
116
+ const TOP_KEYS = ['contract', 'places', 'interest', 'tiers', 'companionIdle', 'lowActorBudget', 'lowActorDistance', 'cues', 'stuck', 'yourGames', 'avatarColors', 'labels', 'soundscape', 'unlocks', 'house', ...PLACE_KEYS];
78
117
 
79
118
  const DEFAULT_SCENE = 'scenes/main.scene';
80
119
 
@@ -92,12 +131,51 @@ export function readManifest(castleJson, sceneExists = () => true) {
92
131
  );
93
132
  }
94
133
  unknownKeys(hub, TOP_KEYS, 'hub', errors);
134
+ if (hub.lowActorDistance !== undefined && typeof hub.lowActorDistance !== 'boolean') {
135
+ errors.push('hub.lowActorDistance must be true or false.');
136
+ }
137
+ if (hub.lowActorBudget !== undefined && typeof hub.lowActorBudget !== 'boolean') {
138
+ errors.push('hub.lowActorBudget must be true or false.');
139
+ }
140
+ if (hub.companionIdle !== undefined && typeof hub.companionIdle !== 'boolean') {
141
+ errors.push('hub.companionIdle must be true or false.');
142
+ }
95
143
  if (hub.tiers !== undefined && typeof hub.tiers !== 'boolean') {
96
144
  errors.push('hub.tiers must be true or false.');
97
145
  }
98
146
  if (hub.cues !== undefined && typeof hub.cues !== 'boolean') {
99
147
  errors.push('hub.cues must be true or false.');
100
148
  }
149
+ if (hub.yourGames !== undefined && typeof hub.yourGames !== 'boolean') {
150
+ errors.push('hub.yourGames must be true or false.');
151
+ }
152
+ if (hub.avatarColors !== undefined && typeof hub.avatarColors !== 'boolean') {
153
+ errors.push('hub.avatarColors must be true or false.');
154
+ }
155
+ if (hub.stuck !== undefined && typeof hub.stuck !== 'boolean') {
156
+ errors.push('hub.stuck must be true or false.');
157
+ }
158
+ if (hub.labels !== undefined && hub.labels !== 'near') {
159
+ errors.push('hub.labels must be "near" (or left out).');
160
+ }
161
+ if (hub.interest !== undefined && hub.interest !== 'cells') {
162
+ errors.push('hub.interest must be "cells" (or left out).');
163
+ }
164
+ let house = null;
165
+ if (hub.house !== undefined) {
166
+ if (!isObject(hub.house)) {
167
+ errors.push('hub.house must be an object of { devOwner: "first" }.');
168
+ } else {
169
+ unknownKeys(hub.house, ['devOwner'], 'hub.house', errors);
170
+ if (hub.house.devOwner !== 'first') {
171
+ errors.push('hub.house.devOwner must be "first".');
172
+ } else {
173
+ house = { devOwner: 'first' };
174
+ }
175
+ }
176
+ }
177
+ const soundscape = readSoundscape(hub.soundscape, errors);
178
+ const unlocks = readUnlocks(hub.unlocks, errors);
101
179
  const defaultScene =
102
180
  typeof castleJson?.editor?.defaultPlayFile === 'string' ? castleJson.editor.defaultPlayFile : DEFAULT_SCENE;
103
181
  const serverMax = Number.isInteger(castleJson?.server?.maxPlayers) ? castleJson.server.maxPlayers : MAX_PLAYERS_CAP;
@@ -105,7 +183,9 @@ export function readManifest(castleJson, sceneExists = () => true) {
105
183
  const bundle = castleJson?.characterBundle ?? null;
106
184
 
107
185
  const places = {};
108
- places[MAIN_PLACE] = readPlace(hub, 'hub', defaultScene, serverMax, sceneExists, errors, destinations, bundle);
186
+ places[MAIN_PLACE] = readPlace(hub, 'hub', defaultScene, serverMax, sceneExists, errors, destinations, bundle, hub.interest);
187
+ // v1.68: whether any place declares the choice card (only the key is read).
188
+ let ballot = Boolean(places[MAIN_PLACE].ballot);
109
189
  if (hub.places !== undefined) {
110
190
  if (!isObject(hub.places)) {
111
191
  errors.push('hub.places must be an object of place id -> place.');
@@ -121,14 +201,124 @@ export function readManifest(castleJson, sceneExists = () => true) {
121
201
  continue;
122
202
  }
123
203
  unknownKeys(block, PLACE_KEYS, where, errors);
124
- places[id] = readPlace(block, where, null, serverMax, sceneExists, errors, destinations, bundle);
204
+ places[id] = readPlace(block, where, null, serverMax, sceneExists, errors, destinations, bundle, hub.interest);
205
+ ballot ||= Boolean(places[id].ballot);
206
+ }
207
+ }
208
+ }
209
+ return errors.length ? { errors, manifest: null } : { errors, manifest: { contract: CONTRACT_VERSION, cues: hub.cues === true, ...(hub.yourGames === true ? { yourGames: true } : {}), ...(hub.avatarColors === true ? { avatarColors: true } : {}), ...(hub.stuck === true ? { stuck: true } : {}), ...(soundscape ? { soundscape } : {}), ...(unlocks ? { unlocks } : {}), ...(house ? { house } : {}), ...(ballot ? { ballot: true } : {}), places } };
210
+ }
211
+
212
+ // `hub.soundscape`: its parts where it is on, null where it is left out or
213
+ // false. New fields are never filled into a boolean deck's manifest.
214
+ function readSoundscape(value, errors) {
215
+ if (value === undefined || value === false) {
216
+ return null;
217
+ }
218
+ if (value === true) {
219
+ return { babble: true, steps: true };
220
+ }
221
+ if (!isObject(value)) {
222
+ errors.push('hub.soundscape must be true, false or an object of { babble, steps, zones, ambience, ui, cues }.');
223
+ return null;
224
+ }
225
+ unknownKeys(value, SOUNDSCAPE_KEYS, 'hub.soundscape', errors);
226
+ if (value.babble !== undefined && typeof value.babble !== 'boolean') {
227
+ errors.push('hub.soundscape.babble must be true or false.');
228
+ }
229
+ const out = { babble: value.babble !== false, steps: value.steps !== false };
230
+ if (value.cues !== undefined) {
231
+ if (typeof value.cues !== 'boolean') {
232
+ errors.push('hub.soundscape.cues must be true or false.');
233
+ } else {
234
+ out.cues = value.cues;
235
+ }
236
+ }
237
+ if (value.ui !== undefined) {
238
+ if (typeof value.ui !== 'boolean') {
239
+ errors.push('hub.soundscape.ui must be true or false.');
240
+ } else {
241
+ out.ui = value.ui;
242
+ }
243
+ }
244
+ const component = (name, where) => {
245
+ if (typeof name !== 'string' || !/^[A-Za-z][A-Za-z0-9_]*$/.test(name)) {
246
+ errors.push(`${where} must be a component name.`);
247
+ }
248
+ };
249
+ const named = (name, names, where) => {
250
+ if (!names.includes(name)) {
251
+ errors.push(`${where} must be one of ${names.join(', ')}.`);
252
+ }
253
+ };
254
+ const map = (entries, names, where, components = false) => {
255
+ if (!isObject(entries)) {
256
+ errors.push(`${where} must be an object.`);
257
+ return;
258
+ }
259
+ for (const [id, name] of Object.entries(entries)) {
260
+ if (!id.trim()) {
261
+ errors.push(`${where} needs a non-empty actor id.`);
125
262
  }
263
+ if (components) {
264
+ component(id, `${where}.${id}`);
265
+ }
266
+ named(name, names, `${where}.${id}`);
126
267
  }
268
+ };
269
+ if (value.zones !== undefined) {
270
+ component(value.zones, 'hub.soundscape.zones');
271
+ out.zones = value.zones;
127
272
  }
128
- return errors.length ? { errors, manifest: null } : { errors, manifest: { contract: CONTRACT_VERSION, cues: hub.cues === true, places } };
273
+ if (value.steps !== undefined && typeof value.steps !== 'boolean') {
274
+ if (!isObject(value.steps)) {
275
+ errors.push('hub.soundscape.steps must be true or false or an object.');
276
+ } else {
277
+ const steps = value.steps;
278
+ unknownKeys(steps, ['default', 'zones', 'paths'], 'hub.soundscape.steps', errors);
279
+ if (steps.default !== undefined) {
280
+ named(steps.default, SOUNDSCAPE_SURFACES, 'hub.soundscape.steps.default');
281
+ }
282
+ if (steps.zones !== undefined) {
283
+ map(steps.zones, SOUNDSCAPE_SURFACES, 'hub.soundscape.steps.zones');
284
+ if (value.zones === undefined) {
285
+ errors.push('hub.soundscape.steps.zones needs hub.soundscape.zones.');
286
+ }
287
+ }
288
+ if (steps.paths !== undefined) {
289
+ component(steps.paths, 'hub.soundscape.steps.paths');
290
+ }
291
+ out.steps = { ...steps };
292
+ }
293
+ }
294
+ if (value.ambience !== undefined) {
295
+ if (!isObject(value.ambience)) {
296
+ errors.push('hub.soundscape.ambience must be an object.');
297
+ } else {
298
+ const ambience = value.ambience;
299
+ unknownKeys(ambience, ['beds', 'default', 'spots', 'music'], 'hub.soundscape.ambience', errors);
300
+ if (ambience.default !== undefined) {
301
+ named(ambience.default, SOUNDSCAPE_BEDS, 'hub.soundscape.ambience.default');
302
+ }
303
+ if (ambience.beds !== undefined) {
304
+ map(ambience.beds, SOUNDSCAPE_BEDS, 'hub.soundscape.ambience.beds');
305
+ if (value.zones === undefined) {
306
+ errors.push('hub.soundscape.ambience.beds needs hub.soundscape.zones.');
307
+ }
308
+ }
309
+ if (ambience.spots !== undefined) {
310
+ map(ambience.spots, SOUNDSCAPE_BEDS, 'hub.soundscape.ambience.spots', true);
311
+ }
312
+ if (ambience.music !== undefined && typeof ambience.music !== 'boolean') {
313
+ errors.push('hub.soundscape.ambience.music must be true or false.');
314
+ }
315
+ out.ambience = { ...ambience };
316
+ }
317
+ }
318
+ return out;
129
319
  }
130
320
 
131
- function readPlace(block, where, defaultScene, serverMax, sceneExists, errors, destinations, bundle) {
321
+ function readPlace(block, where, defaultScene, serverMax, sceneExists, errors, destinations, bundle, interest) {
132
322
  const place = {};
133
323
 
134
324
  place.title = typeof block.title === 'string' ? block.title.trim() : '';
@@ -169,12 +359,16 @@ function readPlace(block, where, defaultScene, serverMax, sceneExists, errors, d
169
359
 
170
360
  place.nearestPlayers = intIn(
171
361
  block.nearestPlayers,
172
- NEAREST_PLAYERS,
362
+ interest === 'cells' ? NEAREST_PLAYERS_CELLS : NEAREST_PLAYERS,
173
363
  1,
174
364
  NEAREST_PLAYERS_CAP,
175
365
  `${where}.nearestPlayers`,
176
366
  errors,
177
367
  );
368
+ if (interest === 'cells') {
369
+ place.interest = interest;
370
+ place.nearestPlayersFallback = block.nearestPlayers ?? NEAREST_PLAYERS;
371
+ }
178
372
  place.arrival = readArrival(block.arrival, `${where}.arrival`, errors);
179
373
  place.result = block.result === undefined ? null : readResult(block.result, `${where}.result`, errors);
180
374
  // A game has a longest visit; a place with no result (a town) has none
@@ -207,9 +401,158 @@ function readPlace(block, where, defaultScene, serverMax, sceneExists, errors, d
207
401
  if (hud) {
208
402
  place.hud = hud;
209
403
  }
404
+ const decor = readDecor(block.decor, `${where}.decor`, errors);
405
+ if (decor) {
406
+ place.decor = decor;
407
+ }
408
+ if (Object.hasOwn(block, 'visibility')) {
409
+ if (block.visibility !== true) {
410
+ errors.push(`${where}.visibility must be true or absent.`);
411
+ } else {
412
+ place.visibility = true;
413
+ }
414
+ }
415
+ if (Object.hasOwn(block, 'actions')) {
416
+ if (block.actions !== true) {
417
+ errors.push(`${where}.actions must be true or absent.`);
418
+ } else {
419
+ place.actions = true;
420
+ }
421
+ }
422
+ if (Object.hasOwn(block, 'companion')) {
423
+ if (block.companion === true) {
424
+ place.companion = true;
425
+ } else if (isObject(block.companion)) {
426
+ const value = block.companion, chat = value.chat;
427
+ unknownKeys(value, ['chat'], `${where}.companion`, errors);
428
+ if (!isObject(chat)) {
429
+ errors.push(`${where}.companion.chat must be an object.`);
430
+ } else {
431
+ unknownKeys(chat, ['character', 'name'], `${where}.companion.chat`, errors);
432
+ // The character API accepts non-empty ids up to 100 characters / 128 bytes.
433
+ if (
434
+ typeof chat.character !== 'string' || !chat.character.trim() || chat.character.length > 100 || chat.character.includes('\0') ||
435
+ /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/.test(chat.character) ||
436
+ new TextEncoder().encode(chat.character).length > 128 ||
437
+ !Array.isArray(bundle?.characters) || !bundle.characters.some((c) => c?.id === chat.character)
438
+ ) {
439
+ errors.push(`${where}.companion.chat.character must name a character id in characterBundle (1..100 characters, at most 128 bytes).`);
440
+ }
441
+ if (typeof chat.name !== 'string' || !chat.name.trim() || Array.from(chat.name).length > 24 || /[\u0000-\u001f\u007f-\u009f]/.test(chat.name)) {
442
+ errors.push(`${where}.companion.chat.name must be 1..24 characters without control characters.`);
443
+ }
444
+ place.companion = true;
445
+ place.companionChat = { character: chat.character, name: chat.name };
446
+ }
447
+ if (!place.npcs) {
448
+ errors.push(`${where}.companion.chat needs npcs configured with a mind slot.`);
449
+ }
450
+ } else {
451
+ errors.push(`${where}.companion must be true, an object with chat, or absent.`);
452
+ }
453
+ }
454
+ // v1.72: a game that handles a player's return within a round asks to have
455
+ // them arrived again (`hello`, `greetLate`). Carried only when true.
456
+ if (Object.hasOwn(block, 'resume')) {
457
+ const keep = isObject(block.resume) && block.resume.keep === true;
458
+ if (block.resume !== true && !keep) {
459
+ errors.push(`${where}.resume must be true or absent, or { keep: true }.`);
460
+ } else if (!place.result) {
461
+ errors.push(`${where}.resume is only for a place with a result.`);
462
+ } else {
463
+ place.resume = true;
464
+ if (keep) {
465
+ unknownKeys(block.resume, ['keep'], `${where}.resume`, errors);
466
+ place.resumeKeep = true;
467
+ }
468
+ }
469
+ }
470
+ if (Object.hasOwn(block, 'ask')) {
471
+ if (block.ask !== true) {
472
+ errors.push(`${where}.ask must be true or absent.`);
473
+ } else {
474
+ place.ask = true;
475
+ }
476
+ }
477
+ if (Object.hasOwn(block, 'menu')) {
478
+ if (block.menu !== true) {
479
+ errors.push(`${where}.menu must be true or absent.`);
480
+ } else {
481
+ place.menu = true;
482
+ }
483
+ }
484
+ // v1.68: the choice card, likewise carried only by a place that declares it.
485
+ if (block.ballot !== undefined) {
486
+ const ballot = readBallot(block.ballot, `${where}.ballot`, errors);
487
+ if (ballot) {
488
+ place.ballot = ballot;
489
+ }
490
+ }
210
491
  return place;
211
492
  }
212
493
 
494
+ // Words of the deck's own on the card: trimmed, 1-`max` characters, one line
495
+ // (no control characters). The text, or null.
496
+ export function cardText(value, max) {
497
+ if (typeof value !== 'string') {
498
+ return null;
499
+ }
500
+ const text = value.trim();
501
+ if (!text || text.length > max || [...text].some((c) => c.charCodeAt(0) < 32 || c.charCodeAt(0) === 127)) {
502
+ return null;
503
+ }
504
+ return text;
505
+ }
506
+
507
+ // `ballot`: absent or false is none; true is the card with no lines (faces
508
+ // and options only); an object lists the deck's fixed lines, each
509
+ // `{ id, text, about }`, `about` "face" (said about a player whose face is
510
+ // tapped first) or "self".
511
+ function readBallot(value, where, errors) {
512
+ if (value === undefined || value === false) {
513
+ return null;
514
+ }
515
+ if (value === true) {
516
+ return { lines: [] };
517
+ }
518
+ if (!isObject(value)) {
519
+ errors.push(`${where} must be true, false or an object.`);
520
+ return null;
521
+ }
522
+ unknownKeys(value, ['lines'], where, errors);
523
+ if (value.lines === undefined) {
524
+ return { lines: [] };
525
+ }
526
+ if (!Array.isArray(value.lines) || value.lines.length > BALLOT_MAX_LINES) {
527
+ errors.push(`${where}.lines must be a list of at most ${BALLOT_MAX_LINES} lines.`);
528
+ return null;
529
+ }
530
+ const lines = [];
531
+ const seen = new Set();
532
+ value.lines.forEach((line, i) => {
533
+ const at = `${where}.lines[${i}]`;
534
+ if (!isObject(line)) {
535
+ errors.push(`${at} must be an object { id, text, about }.`);
536
+ return;
537
+ }
538
+ unknownKeys(line, ['id', 'text', 'about'], at, errors);
539
+ const text = cardText(line.text, BALLOT_LINE_MAX);
540
+ if (typeof line.id !== 'string' || !BALLOT_LINE_ID.test(line.id)) {
541
+ errors.push(`${at}.id must be [a-z0-9-], 1-24 characters.`);
542
+ } else if (seen.has(line.id)) {
543
+ errors.push(`${at}.id "${line.id}" is listed twice.`);
544
+ } else if (text === null) {
545
+ errors.push(`${at}.text must be 1-${BALLOT_LINE_MAX} characters on one line.`);
546
+ } else if (!BALLOT_ABOUT.includes(line.about)) {
547
+ errors.push(`${at}.about must be "face" or "self".`);
548
+ } else {
549
+ seen.add(line.id);
550
+ lines.push({ id: line.id, text, about: line.about });
551
+ }
552
+ });
553
+ return { lines };
554
+ }
555
+
213
556
  // `hud`: absent is none; an object turns each option on by name. `clear:
214
557
  // false` (and an empty object) is the same as leaving it out.
215
558
  function readHud(value, where, errors) {
@@ -328,6 +671,19 @@ export function isSoundPath(path) {
328
671
  );
329
672
  }
330
673
 
674
+ // Shared by manifest parsing, scene checks and body setup. One slot is the
675
+ // original contract and is never added to the stored manifest or the wire.
676
+ export function readNpcTurnsAtOnce(value, fallback = 1, where = 'HubNpc.turnsAtOnce', errors = []) {
677
+ if (value === undefined) {
678
+ return fallback;
679
+ }
680
+ if (!Number.isInteger(value) || value < 1 || value > 3) {
681
+ errors.push(`${where} must be an integer from 1 to 3.`);
682
+ return fallback;
683
+ }
684
+ return value;
685
+ }
686
+
331
687
  // Where a place's NPC minds live (§13): the place itself (every layer talks
332
688
  // to ghost's one place mind), optionally a destination route whose world an
333
689
  // older SDK joins instead, and how much conversation each character takes.
@@ -336,7 +692,7 @@ function readNpcs(value, destinations, bundle, where, errors) {
336
692
  errors.push(`${where} must be an object.`);
337
693
  return null;
338
694
  }
339
- unknownKeys(value, ['route', 'slot', 'turnsPerMinute', 'disclosure', 'followSec'], where, errors);
695
+ unknownKeys(value, ['route', 'slot', 'turnsPerMinute', 'turnsAtOnce', 'disclosure', 'followSec'], where, errors);
340
696
  const npcs = { route: null, slot: 'main', turnsPerMinute: 6, disclosure: 'participants', followSec: 120 };
341
697
  // A route is optional: without one the minds are the place's (ghost's place
342
698
  // mind, reached from every layer); with one, an SDK that cannot address the
@@ -366,6 +722,10 @@ function readNpcs(value, destinations, bundle, where, errors) {
366
722
  }
367
723
  }
368
724
  npcs.turnsPerMinute = intIn(value.turnsPerMinute, 6, 1, 30, `${where}.turnsPerMinute`, errors);
725
+ const turnsAtOnce = readNpcTurnsAtOnce(value.turnsAtOnce, 1, `${where}.turnsAtOnce`, errors);
726
+ if (turnsAtOnce > 1) {
727
+ npcs.turnsAtOnce = turnsAtOnce;
728
+ }
369
729
  npcs.followSec = intIn(value.followSec, 120, 10, 600, `${where}.followSec`, errors);
370
730
  if (value.disclosure !== undefined) {
371
731
  // Read for decks that set it, and no longer acted on (v1.17): a player's
@@ -561,6 +921,7 @@ export function publicPlace(id, place) {
561
921
  title: place.title,
562
922
  scene: place.scene,
563
923
  controller: place.controller,
924
+ ...(place.interest ? { interest: place.interest, nearestPlayers: place.nearestPlayers } : {}),
564
925
  maxDurationSec: place.maxDurationSec,
565
926
  // v1.3: the hub chrome offers Grab only where this is set; a place
566
927
  // without it is sent exactly what it was.
@@ -569,6 +930,16 @@ export function publicPlace(id, place) {
569
930
  ...(place.idle ? { idle: { emotes: place.idle.emotes, seats: place.idle.seats, sounds: [...place.idle.sounds] } } : {}),
570
931
  // v1.26: likewise the HUD's layout.
571
932
  ...(place.hud ? { hud: { ...place.hud } } : {}),
933
+ ...(place.decor ? { decor: place.decor } : {}),
934
+ ...(place.visibility === true ? { visibility: true } : {}),
935
+ ...(place.actions === true ? { actions: true } : {}),
936
+ ...(place.companion === true ? { companion: true } : {}),
937
+ ...(place.companionChat ? { companionChat: { name: place.companionChat.name } } : {}),
938
+ ...(place.resume === true ? { resume: true } : {}),
939
+ ...(place.ask === true ? { ask: true } : {}),
940
+ ...(place.menu === true ? { menu: true } : {}),
941
+ // v1.68: likewise the choice card's lines, worded by the client from ids.
942
+ ...(place.ballot ? { ballot: { lines: place.ballot.lines.map((line) => ({ ...line })) } } : {}),
572
943
  result: place.result
573
944
  ? { score: place.result.score ? { unit: place.result.score.unit, better: place.result.score.better } : null }
574
945
  : null,