castle-web-cli 0.4.231 → 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 (368) 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/serverBundle.js +5 -3
  28. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  29. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  30. package/dist/shell/index.html +2 -2
  31. package/dist/taskSteer.d.ts +13 -0
  32. package/dist/taskSteer.js +22 -2
  33. package/kits/base/castle.json +1 -1
  34. package/kits/base/package-lock.json +1 -1
  35. package/kits/base/sdk/README.md +79 -2
  36. package/kits/base/sdk/avatar.d.ts +6 -2
  37. package/kits/base/sdk/avatar.js +12 -4
  38. package/kits/base/sdk/castle.d.ts +1 -1
  39. package/kits/base/sdk/commands.d.ts +14 -0
  40. package/kits/base/sdk/hub.d.ts +6 -2
  41. package/kits/base/sdk/hub.js +13 -0
  42. package/kits/base/sdk/multiplayer.js +17 -1
  43. package/kits/base/sdk/save.js +2 -1
  44. package/kits/base/sdk/server/hub.d.ts +87 -0
  45. package/kits/base/sdk/server/hub.js +70 -0
  46. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  47. package/kits/base/sdk/server/storage.d.ts +13 -0
  48. package/kits/base/sdk/server/storage.js +46 -0
  49. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  50. package/kits/base/sdk/server/wrapper.js +83 -8
  51. package/kits/hub-game/CLAUDE.md +352 -12
  52. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  63. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  64. package/kits/hub-game/code/client/actorBudget.js +47 -0
  65. package/kits/hub-game/code/client/attention.js +11 -2
  66. package/kits/hub-game/code/client/avatar.js +345 -32
  67. package/kits/hub-game/code/client/avatarCap.js +228 -0
  68. package/kits/hub-game/code/client/avatarColors.js +70 -0
  69. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  70. package/kits/hub-game/code/client/avatarShare.js +251 -0
  71. package/kits/hub-game/code/client/ballot.js +467 -0
  72. package/kits/hub-game/code/client/build.js +22 -0
  73. package/kits/hub-game/code/client/chat.js +12 -0
  74. package/kits/hub-game/code/client/chrome.js +1334 -50
  75. package/kits/hub-game/code/client/companion.js +716 -0
  76. package/kits/hub-game/code/client/companionDress.js +99 -0
  77. package/kits/hub-game/code/client/decor.js +509 -0
  78. package/kits/hub-game/code/client/earned.js +131 -0
  79. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  80. package/kits/hub-game/code/client/grab.js +363 -20
  81. package/kits/hub-game/code/client/hats.js +26 -0
  82. package/kits/hub-game/code/client/hookLayer.js +328 -15
  83. package/kits/hub-game/code/client/hudClear.js +126 -0
  84. package/kits/hub-game/code/client/idle.js +163 -22
  85. package/kits/hub-game/code/client/interestCap.js +81 -0
  86. package/kits/hub-game/code/client/keys.js +36 -0
  87. package/kits/hub-game/code/client/labelsNear.js +205 -0
  88. package/kits/hub-game/code/client/menuIcons.js +34 -0
  89. package/kits/hub-game/code/client/pack.js +6 -2
  90. package/kits/hub-game/code/client/packFormat.js +3 -3
  91. package/kits/hub-game/code/client/rehello.js +167 -0
  92. package/kits/hub-game/code/client/shot.js +92 -0
  93. package/kits/hub-game/code/client/sound.js +63 -8
  94. package/kits/hub-game/code/client/soundscape.js +1151 -0
  95. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  96. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  97. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  98. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  99. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  100. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  101. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  102. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  103. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  104. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  105. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  106. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  107. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  108. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  109. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  110. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  111. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  112. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  113. package/kits/hub-game/code/client/spin.js +101 -0
  114. package/kits/hub-game/code/client/state.js +131 -1
  115. package/kits/hub-game/code/client/stuck.js +259 -0
  116. package/kits/hub-game/code/client/talk.js +538 -47
  117. package/kits/hub-game/code/client/tiers.js +541 -27
  118. package/kits/hub-game/code/client/toastBand.js +37 -0
  119. package/kits/hub-game/code/client/together.js +98 -1
  120. package/kits/hub-game/code/client/visibility.js +43 -0
  121. package/kits/hub-game/code/client/wear.js +470 -97
  122. package/kits/hub-game/code/client/yours.js +199 -0
  123. package/kits/hub-game/code/companionSpec.js +45 -0
  124. package/kits/hub-game/code/privateText.js +7 -0
  125. package/kits/hub-game/code/server/actions.js +133 -0
  126. package/kits/hub-game/code/server/actors.js +14 -1
  127. package/kits/hub-game/code/server/ask.js +155 -0
  128. package/kits/hub-game/code/server/ballot.js +539 -0
  129. package/kits/hub-game/code/server/cells.js +100 -0
  130. package/kits/hub-game/code/server/companion.js +82 -0
  131. package/kits/hub-game/code/server/cues.js +70 -0
  132. package/kits/hub-game/code/server/decor.js +269 -0
  133. package/kits/hub-game/code/server/earned.js +461 -0
  134. package/kits/hub-game/code/server/friendBests.js +166 -0
  135. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  136. package/kits/hub-game/code/server/grab.js +296 -11
  137. package/kits/hub-game/code/server/history.js +5 -0
  138. package/kits/hub-game/code/server/hub.js +1317 -52
  139. package/kits/hub-game/code/server/idle.js +30 -11
  140. package/kits/hub-game/code/server/index.js +2 -2
  141. package/kits/hub-game/code/server/labels.js +28 -2
  142. package/kits/hub-game/code/server/manifest.js +424 -8
  143. package/kits/hub-game/code/server/menu.js +133 -0
  144. package/kits/hub-game/code/server/npcs.js +830 -80
  145. package/kits/hub-game/code/server/party.js +13 -2
  146. package/kits/hub-game/code/server/players.js +22 -0
  147. package/kits/hub-game/code/server/say.js +8 -2
  148. package/kits/hub-game/code/server/shot.js +110 -0
  149. package/kits/hub-game/code/server/standing.js +124 -0
  150. package/kits/hub-game/code/server/vis.js +113 -0
  151. package/kits/hub-game/code/server/wear.js +128 -11
  152. package/kits/hub-game/code/server/yours.js +59 -0
  153. package/kits/hub-game/code/shared/cues.js +9 -0
  154. package/kits/hub-game/code/shared/decor.js +41 -0
  155. package/kits/hub-game/code/shared/shot.js +19 -0
  156. package/kits/hub-game/code/shared/spin.js +57 -0
  157. package/kits/hub-game/code/systems/hub.js +1083 -85
  158. package/kits/hub-game/docs/content-pack.md +1 -1
  159. package/kits/hub-game/docs/contract.md +2440 -61
  160. package/kits/hub-game/docs/home-pieces.md +64 -0
  161. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  162. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  163. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  164. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  165. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  166. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  167. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  168. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  169. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  170. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  171. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  172. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  173. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  174. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  175. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  176. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  177. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  178. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  179. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  180. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  181. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  182. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  183. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  184. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  185. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  186. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  187. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  188. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  190. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  191. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  192. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  193. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  194. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  195. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  196. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  197. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  198. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  199. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  200. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  201. package/kits/hub-game/package-lock.json +2 -0
  202. package/kits/hub-game/package.json +2 -1
  203. package/kits/hub-game/scripts/check.mjs +78 -11
  204. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  205. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  206. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  207. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  208. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  209. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  210. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  211. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  212. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  213. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  214. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  215. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  216. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  217. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  218. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  219. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  220. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  221. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  222. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  223. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  224. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  225. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  226. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  227. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  228. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  229. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  230. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  231. package/kits/hub-game/scripts/test-build.mjs +31 -0
  232. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  233. package/kits/hub-game/scripts/test-chat.mjs +694 -0
  234. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  235. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  236. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  237. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  238. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  239. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  240. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  241. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  242. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  243. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  244. package/kits/hub-game/scripts/test-grab-client.mjs +186 -3
  245. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  246. package/kits/hub-game/scripts/test-grab.mjs +864 -3
  247. package/kits/hub-game/scripts/test-hats.mjs +483 -0
  248. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  249. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  250. package/kits/hub-game/scripts/test-hub-trip.mjs +1228 -1
  251. package/kits/hub-game/scripts/test-hud-clear.mjs +1000 -0
  252. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  253. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  254. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  255. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  256. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  257. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  258. package/kits/hub-game/scripts/test-manifest.mjs +282 -0
  259. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  260. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  261. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  262. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  263. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  264. package/kits/hub-game/scripts/test-party.mjs +22 -1
  265. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  266. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  267. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  268. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  269. package/kits/hub-game/scripts/test-say.mjs +59 -2
  270. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  271. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  272. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  273. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  274. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  275. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  276. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  277. package/kits/hub-game/scripts/test-tiers.mjs +666 -3
  278. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  279. package/kits/hub-game/scripts/test-try-on.mjs +940 -0
  280. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  281. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  282. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  283. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  284. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  285. package/kits/multiplayer-3d/castle.json +5 -5
  286. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  287. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  288. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  289. package/kits/multiplayer-3d/code/options.js +5 -0
  290. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  291. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  292. package/kits/multiplayer-3d/code/server/world.js +7 -0
  293. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  294. package/kits/multiplayer-3d/package.json +2 -1
  295. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  296. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  297. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  298. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  299. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  300. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  301. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  302. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  303. package/kits/physics-2d/CLAUDE.md +9 -0
  304. package/kits/physics-2d/castle.json +2 -2
  305. package/kits/physics-2d/engine/scene.js +288 -1
  306. package/kits/physics-2d/engine/skyKey.js +129 -0
  307. package/kits/physics-2d/engine/stillClock.js +106 -0
  308. package/kits/physics-2d/engine/updateBudget.js +21 -0
  309. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +370 -1
  310. package/kits/physics-3d/CLAUDE.md +1391 -0
  311. package/kits/physics-3d/behaviors/Player.jsx +921 -3
  312. package/kits/physics-3d/castle.json +3 -3
  313. package/kits/physics-3d/docs/pxmodel-format.md +12 -0
  314. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +98 -10
  315. package/kits/physics-3d/engine3d/actornode.js +86 -0
  316. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  317. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  318. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  319. package/kits/physics-3d/engine3d/framecap.js +96 -0
  320. package/kits/physics-3d/engine3d/gait.js +118 -0
  321. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  322. package/kits/physics-3d/engine3d/look.js +507 -48
  323. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  324. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  325. package/kits/physics-3d/engine3d/motion.js +39 -10
  326. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  327. package/kits/physics-3d/engine3d/optimize.js +58 -5
  328. package/kits/physics-3d/engine3d/orbitinput.js +755 -0
  329. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  330. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  331. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  332. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  333. package/kits/physics-3d/engine3d/sky.js +547 -0
  334. package/kits/physics-3d/engine3d/skylife.js +306 -0
  335. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  336. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  337. package/kits/physics-3d/engine3d/world3d.js +870 -87
  338. package/kits/physics-3d/main.jsx +5 -0
  339. package/kits/physics-3d/package.json +1 -1
  340. package/kits/physics-3d/scripts/Player.before-orbit.mjs +310 -0
  341. package/kits/physics-3d/scripts/Scene3DPlayer.before-orbit.jsx +337 -0
  342. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  343. package/kits/physics-3d/scripts/test-camera-follow.mjs +12 -2
  344. package/kits/physics-3d/scripts/test-camera-orbit.mjs +4588 -0
  345. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +787 -0
  346. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  347. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  348. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  349. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  350. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  351. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  352. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  353. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  354. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  355. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  356. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  357. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  358. package/kits/physics-3d/scripts/test-static-actors.mjs +13 -1
  359. package/kits/physics-3d/scripts/test-static-passes.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  361. package/kits/physics-3d/scripts/test-steady-hover.mjs +635 -0
  362. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  363. package/kits/physics-3d/systems/physics3d.js +474 -12
  364. package/kits/real-time/castle.json +2 -2
  365. package/kits/real-time/code/server/gameHooks.js +7 -0
  366. package/kits/real-time/code/server/session.js +97 -19
  367. package/package.json +2 -2
  368. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -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
@@ -35,7 +40,9 @@ const GRAB_LIMITS = { throwSpeed: [1, 14, 'm/s'], holdDistance: [0.8, 3, 'metres
35
40
  // top stays inside the server's GRAB_REACH (4 m, centre to centre), and the
36
41
  // client also never offers an object whose centre is past 3 m.
37
42
  export const GRAB_REACH_LIMITS = [1.6, 3, 'metres'];
38
- const GRAB_KEYS = [...Object.keys(GRAB_DEFAULTS), 'reach', 'steady'];
43
+ // v1.25 `keepHeld`: a held object stays its holder's (`code/server/grab.js`).
44
+ // Kept only when true, like `steady`.
45
+ const GRAB_KEYS = [...Object.keys(GRAB_DEFAULTS), 'reach', 'steady', 'keepHeld'];
39
46
  // Idle play (v1.6, §6): emotes, seats and the place's own sounds. Sounds are
40
47
  // files of the deck, listed so the server can refuse any other name.
41
48
  export const IDLE_KEYS = ['emotes', 'seats', 'sounds'];
@@ -43,6 +50,20 @@ export const SOUND_EXTS = ['.mp3', '.wav', '.m4a'];
43
50
  export const MAX_SOUND_FILES = 16;
44
51
  const SOUND_PATH = /^[A-Za-z0-9_@-][A-Za-z0-9_./@-]{0,199}$/;
45
52
 
53
+ // v1.26 `hud`: how a place's client lays the HUD out. `clear` keeps the HUD
54
+ // short and keeps what is drawn over the world out from under it
55
+ // (`code/client/hudClear.js`). The client's only; kept only when true, so a
56
+ // place without it is read and sent exactly as before.
57
+ const HUD_KEYS = ['clear'];
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
+
46
67
  const PLACE_KEYS = [
47
68
  'title',
48
69
  'scene',
@@ -59,10 +80,40 @@ const PLACE_KEYS = [
59
80
  'fallY',
60
81
  'grab',
61
82
  'idle',
83
+ 'hud',
84
+ 'decor',
85
+ 'actions',
86
+ 'companion',
87
+ 'ask',
88
+ 'menu',
89
+ 'ballot',
90
+ 'resume',
91
+ 'visibility',
62
92
  ];
63
93
  // `tiers` is the deck's, not a place's: the client's picture on a slow device
64
94
  // (v1.21, `code/client/tiers.js`). The server reads nothing of it.
65
- const TOP_KEYS = ['contract', 'places', 'tiers', ...PLACE_KEYS];
95
+ // `cues` is the deck's too (v1.23): a town that tells its players more about
96
+ // the friends and party they came with. Both halves read it, and a deck
97
+ // without it is sent and draws exactly what it did.
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];
66
117
 
67
118
  const DEFAULT_SCENE = 'scenes/main.scene';
68
119
 
@@ -80,9 +131,51 @@ export function readManifest(castleJson, sceneExists = () => true) {
80
131
  );
81
132
  }
82
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
+ }
83
143
  if (hub.tiers !== undefined && typeof hub.tiers !== 'boolean') {
84
144
  errors.push('hub.tiers must be true or false.');
85
145
  }
146
+ if (hub.cues !== undefined && typeof hub.cues !== 'boolean') {
147
+ errors.push('hub.cues must be true or false.');
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);
86
179
  const defaultScene =
87
180
  typeof castleJson?.editor?.defaultPlayFile === 'string' ? castleJson.editor.defaultPlayFile : DEFAULT_SCENE;
88
181
  const serverMax = Number.isInteger(castleJson?.server?.maxPlayers) ? castleJson.server.maxPlayers : MAX_PLAYERS_CAP;
@@ -90,7 +183,9 @@ export function readManifest(castleJson, sceneExists = () => true) {
90
183
  const bundle = castleJson?.characterBundle ?? null;
91
184
 
92
185
  const places = {};
93
- 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);
94
189
  if (hub.places !== undefined) {
95
190
  if (!isObject(hub.places)) {
96
191
  errors.push('hub.places must be an object of place id -> place.');
@@ -106,14 +201,124 @@ export function readManifest(castleJson, sceneExists = () => true) {
106
201
  continue;
107
202
  }
108
203
  unknownKeys(block, PLACE_KEYS, where, errors);
109
- 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);
110
206
  }
111
207
  }
112
208
  }
113
- return errors.length ? { errors, manifest: null } : { errors, manifest: { contract: CONTRACT_VERSION, places } };
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 } };
114
210
  }
115
211
 
116
- function readPlace(block, where, defaultScene, serverMax, sceneExists, errors, destinations, bundle) {
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.`);
262
+ }
263
+ if (components) {
264
+ component(id, `${where}.${id}`);
265
+ }
266
+ named(name, names, `${where}.${id}`);
267
+ }
268
+ };
269
+ if (value.zones !== undefined) {
270
+ component(value.zones, 'hub.soundscape.zones');
271
+ out.zones = value.zones;
272
+ }
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;
319
+ }
320
+
321
+ function readPlace(block, where, defaultScene, serverMax, sceneExists, errors, destinations, bundle, interest) {
117
322
  const place = {};
118
323
 
119
324
  place.title = typeof block.title === 'string' ? block.title.trim() : '';
@@ -154,12 +359,16 @@ function readPlace(block, where, defaultScene, serverMax, sceneExists, errors, d
154
359
 
155
360
  place.nearestPlayers = intIn(
156
361
  block.nearestPlayers,
157
- NEAREST_PLAYERS,
362
+ interest === 'cells' ? NEAREST_PLAYERS_CELLS : NEAREST_PLAYERS,
158
363
  1,
159
364
  NEAREST_PLAYERS_CAP,
160
365
  `${where}.nearestPlayers`,
161
366
  errors,
162
367
  );
368
+ if (interest === 'cells') {
369
+ place.interest = interest;
370
+ place.nearestPlayersFallback = block.nearestPlayers ?? NEAREST_PLAYERS;
371
+ }
163
372
  place.arrival = readArrival(block.arrival, `${where}.arrival`, errors);
164
373
  place.result = block.result === undefined ? null : readResult(block.result, `${where}.result`, errors);
165
374
  // A game has a longest visit; a place with no result (a town) has none
@@ -187,9 +396,181 @@ function readPlace(block, where, defaultScene, serverMax, sceneExists, errors, d
187
396
  if (idle) {
188
397
  place.idle = idle;
189
398
  }
399
+ // v1.26: the HUD's layout, likewise carried only by a place that asks.
400
+ const hud = readHud(block.hud, `${where}.hud`, errors);
401
+ if (hud) {
402
+ place.hud = hud;
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
+ }
190
491
  return place;
191
492
  }
192
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
+
556
+ // `hud`: absent is none; an object turns each option on by name. `clear:
557
+ // false` (and an empty object) is the same as leaving it out.
558
+ function readHud(value, where, errors) {
559
+ if (value === undefined) {
560
+ return null;
561
+ }
562
+ if (!isObject(value)) {
563
+ errors.push(`${where} must be an object.`);
564
+ return null;
565
+ }
566
+ unknownKeys(value, HUD_KEYS, where, errors);
567
+ if (value.clear !== undefined && typeof value.clear !== 'boolean') {
568
+ errors.push(`${where}.clear must be true or false.`);
569
+ return null;
570
+ }
571
+ return value.clear === true ? { clear: true } : null;
572
+ }
573
+
193
574
  // `grab`: absent or false is none; true is the defaults; an object sets any of
194
575
  // them, and may add `reach` and `steady` (v1.22), which are kept only when
195
576
  // set: `steady: false` is the same as leaving it out.
@@ -229,6 +610,11 @@ function readGrab(value, where, errors) {
229
610
  } else if (value.steady === true) {
230
611
  grab.steady = true;
231
612
  }
613
+ if (value.keepHeld !== undefined && typeof value.keepHeld !== 'boolean') {
614
+ errors.push(`${where}.keepHeld must be true or false.`);
615
+ } else if (value.keepHeld === true) {
616
+ grab.keepHeld = true;
617
+ }
232
618
  return grab;
233
619
  }
234
620
 
@@ -285,6 +671,19 @@ export function isSoundPath(path) {
285
671
  );
286
672
  }
287
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
+
288
687
  // Where a place's NPC minds live (§13): the place itself (every layer talks
289
688
  // to ghost's one place mind), optionally a destination route whose world an
290
689
  // older SDK joins instead, and how much conversation each character takes.
@@ -293,7 +692,7 @@ function readNpcs(value, destinations, bundle, where, errors) {
293
692
  errors.push(`${where} must be an object.`);
294
693
  return null;
295
694
  }
296
- unknownKeys(value, ['route', 'slot', 'turnsPerMinute', 'disclosure', 'followSec'], where, errors);
695
+ unknownKeys(value, ['route', 'slot', 'turnsPerMinute', 'turnsAtOnce', 'disclosure', 'followSec'], where, errors);
297
696
  const npcs = { route: null, slot: 'main', turnsPerMinute: 6, disclosure: 'participants', followSec: 120 };
298
697
  // A route is optional: without one the minds are the place's (ghost's place
299
698
  // mind, reached from every layer); with one, an SDK that cannot address the
@@ -323,6 +722,10 @@ function readNpcs(value, destinations, bundle, where, errors) {
323
722
  }
324
723
  }
325
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
+ }
326
729
  npcs.followSec = intIn(value.followSec, 120, 10, 600, `${where}.followSec`, errors);
327
730
  if (value.disclosure !== undefined) {
328
731
  // Read for decks that set it, and no longer acted on (v1.17): a player's
@@ -518,12 +921,25 @@ export function publicPlace(id, place) {
518
921
  title: place.title,
519
922
  scene: place.scene,
520
923
  controller: place.controller,
924
+ ...(place.interest ? { interest: place.interest, nearestPlayers: place.nearestPlayers } : {}),
521
925
  maxDurationSec: place.maxDurationSec,
522
926
  // v1.3: the hub chrome offers Grab only where this is set; a place
523
927
  // without it is sent exactly what it was.
524
928
  ...(place.grab ? { grab: { ...place.grab } } : {}),
525
929
  // v1.6: likewise idle play.
526
930
  ...(place.idle ? { idle: { emotes: place.idle.emotes, seats: place.idle.seats, sounds: [...place.idle.sounds] } } : {}),
931
+ // v1.26: likewise the HUD's layout.
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 })) } } : {}),
527
943
  result: place.result
528
944
  ? { score: place.result.score ? { unit: place.result.score.unit, better: place.result.score.better } : null }
529
945
  : null,