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
@@ -0,0 +1,314 @@
1
+ // Tests over turning displays (contract v1.55, a scene actor's `HubSpin`):
2
+ // the rule (`code/shared/spin.js`) and the publish check that holds it, the
3
+ // client's turn (`code/client/spin.js`: rate x dt, frame-rate independent,
4
+ // within one turn, hidden actors left, gone ones dropped, nothing allocated),
5
+ // and the hub system: a scene with no `HubSpin` turns, touches and keeps
6
+ // nothing, and a copy the place spawns from a turning template turns too.
7
+ // `npm run check` runs this.
8
+
9
+ import assert from 'node:assert/strict';
10
+ import fs from 'node:fs';
11
+ import { register } from 'node:module';
12
+ import os from 'node:os';
13
+ import path from 'node:path';
14
+ import { SPIN_COMPONENT, SPIN_RATE_MAX, spinProblem, spinRate } from '../code/shared/spin.js';
15
+ import { addSpinner, findSpinners, spinFrame } from '../code/client/spin.js';
16
+
17
+ let n = 0;
18
+ async function test(name, fn) {
19
+ try {
20
+ await fn();
21
+ } catch (err) {
22
+ console.error(`not ok: ${name}`);
23
+ throw err;
24
+ }
25
+ n += 1;
26
+ }
27
+
28
+ const shape = { kind: 'cylinder', radius: 0.3, height: 0.4 };
29
+ const spinner = (id, rate, more = {}) => ({ id, components: { Transform: { x: 0, y: 1, z: 0, rotationY: 0 }, Shape: shape, HubSpin: { rate }, ...more } });
30
+
31
+ // A scene runtime as spin.js sees it: actors by id, and the engine's touch.
32
+ function fakeScene(actors) {
33
+ const byId = new Map(actors.map((a) => [a.id, a]));
34
+ const scene = {
35
+ data: { actors },
36
+ touched: 0,
37
+ looked: 0,
38
+ getActor(id) {
39
+ scene.looked += 1;
40
+ return byId.get(id) ?? null;
41
+ },
42
+ touch() {
43
+ scene.touched += 1;
44
+ },
45
+ byId,
46
+ };
47
+ return scene;
48
+ }
49
+
50
+ // --- the rule ----------------------------------------------------------------
51
+
52
+ await test('a HubSpin of { rate } on a non-solid actor with no moving body turns', () => {
53
+ assert.equal(SPIN_COMPONENT, 'HubSpin');
54
+ for (const rate of [45, -45, 0.5, SPIN_RATE_MAX, -SPIN_RATE_MAX]) {
55
+ assert.equal(spinProblem({ Shape: shape, HubSpin: { rate } }), null, String(rate));
56
+ assert.equal(spinRate({ Shape: shape, HubSpin: { rate } }), rate);
57
+ }
58
+ // A Model riding on it and a fixed Body change nothing.
59
+ assert.equal(spinProblem({ Shape: shape, Model: { file: 'models/hats/crown.pxmodel' }, Body: { type: 'fixed' }, HubSpin: { rate: 30 } }), null);
60
+ assert.equal(spinRate({ Shape: shape }), 0, 'no HubSpin: no turn');
61
+ assert.equal(spinRate(undefined), 0);
62
+ });
63
+
64
+ await test('a rate that is not a number, 0, or over two turns a second is refused', () => {
65
+ for (const rate of [0, SPIN_RATE_MAX + 1, -SPIN_RATE_MAX - 1, NaN, Infinity, '45', null, undefined]) {
66
+ assert.match(spinProblem({ HubSpin: { rate } }), /rate must be a number/, String(rate));
67
+ assert.equal(spinRate({ HubSpin: { rate } }), 0);
68
+ }
69
+ assert.match(spinProblem({ HubSpin: 45 }), /is \{ rate \}/);
70
+ assert.match(spinProblem({ HubSpin: [45] }), /is \{ rate \}/);
71
+ });
72
+
73
+ await test('unknown keys are refused', () => {
74
+ assert.match(spinProblem({ HubSpin: { rate: 45, axis: 'x' } }), /HubSpin\.axis is not part of the hub contract/);
75
+ assert.match(spinProblem({ HubSpin: { rate: 45, rpm: 1 } }), /rpm/);
76
+ });
77
+
78
+ await test('a moving body, a solid collider or a facing the kit owns is refused', () => {
79
+ assert.match(spinProblem({ Body: { type: 'dynamic' }, HubSpin: { rate: 45 } }), /dynamic Body/);
80
+ assert.match(spinProblem({ Body: { type: 'kinematic' }, HubSpin: { rate: 45 } }), /kinematic Body/);
81
+ assert.match(spinProblem({ Solid: {}, HubSpin: { rate: 45 } }), /solid actor/);
82
+ assert.match(spinProblem({ Shape: { ...shape, solid: true }, HubSpin: { rate: 45 } }), /solid actor/);
83
+ for (const owner of ['Player', 'HubDoor', 'HubNpc', 'HubSeat', 'Pickup']) {
84
+ assert.match(spinProblem({ [owner]: {}, HubSpin: { rate: 45 } }), new RegExp(`with ${owner}`), owner);
85
+ assert.equal(spinRate({ [owner]: {}, HubSpin: { rate: 45 } }), 0, 'the client turns none of it either');
86
+ }
87
+ });
88
+
89
+ // --- the publish check ---------------------------------------------------------
90
+
91
+ await test('the check accepts a turning display and refuses a bad one, blueprints merged', async () => {
92
+ const { default: check } = await import('./check.mjs');
93
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'hub-spin-check-'));
94
+ try {
95
+ fs.mkdirSync(path.join(root, 'scenes'));
96
+ fs.mkdirSync(path.join(root, 'blueprints'));
97
+ fs.writeFileSync(path.join(root, 'castle.json'), JSON.stringify({ server: { main: 'code/server/index.js' }, hub: { contract: 1, title: 'Hat Shop' } }));
98
+ const write = (...actors) =>
99
+ fs.writeFileSync(path.join(root, 'scenes', 'main.scene'), JSON.stringify({ actors: [{ id: 'player', components: { Player: {} } }, ...actors] }));
100
+ const errors = async () => (await check({ deckDir: root, self: true })).errors;
101
+
102
+ write(spinner('hat', 45), spinner('sign', -20));
103
+ assert.deepEqual(await errors(), []);
104
+ write();
105
+ assert.deepEqual(await errors(), [], 'a scene with no HubSpin is checked as before');
106
+
107
+ write(spinner('hat', 900));
108
+ assert.match((await errors()).join(), /scenes\/main\.scene: actor "hat": HubSpin\.rate must be/);
109
+ write(spinner('hat', 45, { Body: { type: 'kinematic' } }));
110
+ assert.match((await errors()).join(), /actor "hat": a kinematic Body/);
111
+ write({ id: 'hat', components: { Shape: { ...shape, solid: true }, HubSpin: { rate: 45 } } });
112
+ assert.match((await errors()).join(), /actor "hat": a solid actor/);
113
+ write({ id: 'hat', components: { Shape: shape, HubSpin: { rate: 45, speed: 2 } } });
114
+ assert.match((await errors()).join(), /HubSpin\.speed is not part of the hub contract/);
115
+
116
+ // A display whose HubSpin, or whose Solid, comes from its blueprint.
117
+ fs.writeFileSync(path.join(root, 'blueprints', 'stand.scene'), JSON.stringify({ actors: [{ components: { Shape: shape, HubSpin: { rate: 30 } } }] }));
118
+ write({ id: 'hat', blueprint: 'blueprints/stand.scene', components: {} });
119
+ assert.deepEqual(await errors(), []);
120
+ write({ id: 'hat', blueprint: 'blueprints/stand.scene', components: { HubSpin: { rate: 0 } } });
121
+ assert.match((await errors()).join(), /actor "hat": HubSpin\.rate/, 'the scene overrides the blueprint field by field');
122
+ fs.writeFileSync(path.join(root, 'blueprints', 'solid.scene'), JSON.stringify({ actors: [{ components: { Shape: shape, Solid: {} } }] }));
123
+ write({ id: 'hat', blueprint: 'blueprints/solid.scene', components: { HubSpin: { rate: 30 } } });
124
+ assert.match((await errors()).join(), /actor "hat": a solid actor/);
125
+ } finally {
126
+ fs.rmSync(root, { recursive: true, force: true });
127
+ }
128
+ });
129
+
130
+ // --- the turn ------------------------------------------------------------------
131
+
132
+ await test('a frame turns each display by rate x dt', () => {
133
+ const scene = fakeScene([spinner('a', 90), spinner('b', -30), { id: 'plain', components: { Transform: { rotationY: 10 }, Shape: shape } }]);
134
+ const spin = findSpinners(scene.data.actors);
135
+ assert.deepEqual(spin.ids, ['a', 'b']);
136
+ spinFrame(spin, scene, 0.5, new Set());
137
+ assert.equal(scene.byId.get('a').components.Transform.rotationY, 45);
138
+ assert.equal(scene.byId.get('b').components.Transform.rotationY, -15);
139
+ assert.equal(scene.byId.get('plain').components.Transform.rotationY, 10, 'an actor without HubSpin is never written');
140
+ assert.equal(scene.touched, 2, 'the engine is told before each write (staticActors)');
141
+ });
142
+
143
+ await test('frame-rate independent: 60 frames of 1/60 s turn as far as 10 of 1/10 s', () => {
144
+ const fast = fakeScene([spinner('a', 45)]);
145
+ const slow = fakeScene([spinner('a', 45)]);
146
+ const fs60 = findSpinners(fast.data.actors);
147
+ const fs10 = findSpinners(slow.data.actors);
148
+ for (let i = 0; i < 60; i += 1) {
149
+ spinFrame(fs60, fast, 1 / 60, null);
150
+ }
151
+ for (let i = 0; i < 10; i += 1) {
152
+ spinFrame(fs10, slow, 1 / 10, null);
153
+ }
154
+ assert.ok(Math.abs(fast.byId.get('a').components.Transform.rotationY - 45) < 1e-9);
155
+ assert.ok(Math.abs(slow.byId.get('a').components.Transform.rotationY - 45) < 1e-9);
156
+ });
157
+
158
+ await test('the turn stays within one turn; a missing rotationY starts at 0; a bad dt does nothing', () => {
159
+ const scene = fakeScene([spinner('a', 720), { id: 'b', components: { Transform: { x: 0 }, Shape: shape, HubSpin: { rate: 90 } } }]);
160
+ const spin = findSpinners(scene.data.actors);
161
+ for (let i = 0; i < 1000; i += 1) {
162
+ spinFrame(spin, scene, 0.1, null);
163
+ }
164
+ const r = scene.byId.get('a').components.Transform.rotationY;
165
+ assert.ok(r > -360 && r < 360, String(r));
166
+ assert.ok(Math.abs(scene.byId.get('b').components.Transform.rotationY) < 360);
167
+ const before = scene.byId.get('a').components.Transform.rotationY;
168
+ for (const dt of [0, -1, NaN, Infinity, undefined]) {
169
+ spinFrame(spin, scene, dt, null);
170
+ }
171
+ assert.equal(scene.byId.get('a').components.Transform.rotationY, before);
172
+ });
173
+
174
+ await test('a hidden display waits unturned and turns again when shown', () => {
175
+ const scene = fakeScene([spinner('a', 90)]);
176
+ const spin = findSpinners(scene.data.actors);
177
+ const hidden = new Set(['a']);
178
+ spinFrame(spin, scene, 1, hidden);
179
+ assert.equal(scene.byId.get('a').components.Transform.rotationY, 0);
180
+ assert.equal(scene.touched, 0, 'a hidden one is not even touched');
181
+ hidden.clear();
182
+ spinFrame(spin, scene, 1, hidden);
183
+ assert.equal(scene.byId.get('a').components.Transform.rotationY, 90);
184
+ });
185
+
186
+ await test('a display that is gone is dropped from the list', () => {
187
+ const scene = fakeScene([spinner('a', 90), spinner('b', 90), spinner('c', 90)]);
188
+ const spin = findSpinners(scene.data.actors);
189
+ scene.byId.delete('a');
190
+ spinFrame(spin, scene, 1, null);
191
+ assert.deepEqual([...spin.ids].sort(), ['b', 'c']);
192
+ assert.equal(spin.rates.length, 2);
193
+ assert.equal(scene.byId.get('b').components.Transform.rotationY, 90);
194
+ assert.equal(scene.byId.get('c').components.Transform.rotationY, 90);
195
+ });
196
+
197
+ await test('a copy of a turning template turns; addSpinner adds once and ignores a plain one', () => {
198
+ let spin = addSpinner(null, 'plain~1', { Shape: shape });
199
+ assert.equal(spin, null);
200
+ spin = addSpinner(spin, 'hat~1', spinner('x', 60).components);
201
+ spin = addSpinner(spin, 'hat~1', spinner('x', 60).components);
202
+ assert.deepEqual(spin.ids, ['hat~1']);
203
+ assert.equal(addSpinner(spin, 'bad~1', { HubSpin: { rate: 9999 } }), spin);
204
+ assert.deepEqual(spin.ids, ['hat~1']);
205
+ });
206
+
207
+ await test('no HubSpin anywhere: findSpinners is null and nothing is turned', () => {
208
+ assert.equal(findSpinners([]), null);
209
+ assert.equal(findSpinners(undefined), null);
210
+ assert.equal(findSpinners([{ id: 'x', components: { Shape: shape } }, { id: 'y', components: {} }, null]), null);
211
+ spinFrame(null, { getActor: () => assert.fail('never asked') }, 1 / 60, null);
212
+ });
213
+
214
+ // --- the hub system --------------------------------------------------------------
215
+
216
+ const sdkStub = 'export const Hub = undefined;';
217
+ const packStub = 'export const loadPack = () => Promise.reject(new Error("no")); export const cachedPacks = () => []; export const matchesOwn = () => false; export const resolveDeckDoor = () => Promise.reject(new Error("no"));';
218
+ const mediaStub = 'export const initialMedia = {}; export const playMedia = () => {}; export const stopMedia = () => {};';
219
+ const url = (src) => 'data:text/javascript,' + encodeURIComponent(src);
220
+ register(
221
+ url(`
222
+ export async function resolve(specifier, context, next) {
223
+ if (['pxmodel', 'optimize', 'look', 'lookbake'].some((m) => specifier === '@imports/castle.physics-3d/engine3d/' + m)) return { url: ${JSON.stringify(new URL('./fixtures/engine-models-stub.mjs', import.meta.url).href)}, shortCircuit: true };
224
+ if (specifier === '@imports/castle.physics-3d/engine3d/orbitlens.js') return { url: ${JSON.stringify(new URL('../../physics-3d/engine3d/orbitlens.js', import.meta.url).href)}, shortCircuit: true };
225
+ if (specifier === 'castle-web-sdk') return { url: ${JSON.stringify(url(sdkStub))}, shortCircuit: true };
226
+ if (specifier.startsWith('@imports/castle.physics-2d/engine/')) return { url: ${JSON.stringify(url(mediaStub))}, shortCircuit: true };
227
+ if (specifier === '../client/pack.js') return { url: ${JSON.stringify(url(packStub))}, shortCircuit: true };
228
+ return next(specifier, context);
229
+ }`),
230
+ );
231
+ const { installSystem } = await import('../code/systems/hub.js');
232
+ const { hub } = await import('../code/client/state.js');
233
+ let system;
234
+ installSystem({ registerSystem: (s) => (system = s) });
235
+
236
+ await test('hub system, a scene with no HubSpin: nothing kept, asked, touched or written, frame after frame', () => {
237
+ const actors = [{ id: 'player', components: { Transform: { rotationY: 5 }, Player: {} } }, { id: 'stall', components: { Transform: { rotationY: 7 }, Shape: shape } }];
238
+ const scene = fakeScene(actors);
239
+ for (let i = 0; i < 30; i += 1) {
240
+ system.turnSpinners(scene, 1 / 60);
241
+ }
242
+ assert.equal(system.spin, null);
243
+ assert.equal(scene.looked, 0, 'no actor looked up');
244
+ assert.equal(scene.touched, 0);
245
+ assert.deepEqual(actors.map((a) => a.components.Transform.rotationY), [5, 7]);
246
+ });
247
+
248
+ await test('hub system: a scene load finds the displays once; a copy spawned from one turns; a reload starts over', () => {
249
+ const scene = fakeScene([{ id: 'player', components: { Transform: {}, Player: {} } }, spinner('hat', 90), spinner('proto', 45)]);
250
+ system.turnSpinners(scene, 1);
251
+ assert.deepEqual(system.spin.ids, ['hat', 'proto']);
252
+ assert.equal(scene.byId.get('hat').components.Transform.rotationY, 90);
253
+
254
+ // The place hid its prototype and spawned a copy of it.
255
+ hub.hidden.add('proto');
256
+ hub.spawnTemplates = { proto: spinner('proto', 45).components };
257
+ hub.spawned = { 'proto~1': { from: 'proto', x: 3, y: 1, z: 0, rotationY: 10 } };
258
+ scene.spawnActor = ({ id, components }) => scene.byId.set(id, { id, components });
259
+ scene.multiplayer = null;
260
+ system.applySpawns(scene);
261
+ assert.deepEqual(system.spin.ids, ['hat', 'proto', 'proto~1']);
262
+ system.turnSpinners(scene, 1);
263
+ assert.equal(scene.byId.get('proto~1').components.Transform.rotationY, 55, 'the copy turns from where it was put');
264
+ assert.equal(scene.byId.get('proto').components.Transform.rotationY, 45, 'the hidden prototype waits where it was');
265
+ assert.equal(scene.byId.get('hat').components.Transform.rotationY, 180);
266
+
267
+ // Despawned: the copy is dropped on the next frame.
268
+ hub.spawned = {};
269
+ scene.despawnActor = (id) => scene.byId.delete(id);
270
+ system.applySpawns(scene);
271
+ system.turnSpinners(scene, 1);
272
+ assert.deepEqual(system.spin.ids.sort(), ['hat', 'proto']);
273
+
274
+ // Another scene with none: the list is let go.
275
+ const plain = fakeScene([{ id: 'player', components: { Transform: {}, Player: {} } }]);
276
+ system.turnSpinners(plain, 1);
277
+ assert.equal(system.spin, null);
278
+ hub.hidden.clear();
279
+ hub.spawnTemplates = {};
280
+ });
281
+
282
+ await test('hub.js: the turn is one call in the frame, and nothing else of spin.js is reached', () => {
283
+ const src = fs.readFileSync(new URL('../code/systems/hub.js', import.meta.url), 'utf8');
284
+ assert.equal(src.match(/spinFrame\(/g)?.length, 1);
285
+ assert.equal(src.match(/findSpinners\(/g)?.length, 1);
286
+ assert.equal(src.match(/this\.turnSpinners\(/g)?.length, 1);
287
+ assert.doesNotMatch(src, /registerSystem\([^)]*[Ss]pin/, 'no system of its own');
288
+ });
289
+
290
+ console.log(`hub-game spin: ${n} tests passed`);
291
+
292
+ await test('opted distant displays budget writes, preserve elapsed rotation and wake near/High', () => {
293
+ const scene = fakeScene([spinner('a', 45)]);
294
+ const actor = scene.getActor('a');
295
+ actor.runtime = { updateEvery: 0.1 };
296
+ const spin = findSpinners(scene.data.actors);
297
+ for (let i = 0; i < 11; i++) spinFrame(spin, scene, 0.02);
298
+ assert.equal(scene.touched, 3);
299
+ assert.ok(Math.abs(actor.components.Transform.rotationY - 45 * 0.22) < 1e-9);
300
+ delete actor.runtime.updateEvery;
301
+ spinFrame(spin, scene, 0.02);
302
+ assert.equal(scene.touched, 4);
303
+ });
304
+
305
+ await test('display cadence restores pending elapsed rotation on High', () => {
306
+ const scene = fakeScene([spinner('a', 45)]);
307
+ const a = scene.getActor('a');
308
+ a.runtime = { updateEvery: 0.1 };
309
+ const spin = findSpinners(scene.data.actors);
310
+ for (let i = 0; i < 5; i++) spinFrame(spin, scene, 0.02);
311
+ delete a.runtime.updateEvery;
312
+ spinFrame(spin, scene, 0.02);
313
+ assert.ok(Math.abs(a.components.Transform.rotationY - 45 * 0.12) < 1e-9);
314
+ });