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
@@ -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
+ });