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,318 @@
1
+ // Different characters drawn from shared materials (code/client/avatarShare.js).
2
+ // Over the sixteen toon models built as a game builds them (the engine is the
3
+ // checkout's kits/physics-3d, or this kit's import of it): every mesh keeps a
4
+ // material that draws exactly as its own did, its geometry, its triangles and
5
+ // its draw calls; eleven different characters change material and program
6
+ // about as often as eleven copies of one; and with the opaque order the copies
7
+ // of one character still bind each geometry once. `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 path from 'node:path';
13
+ import { fileURLToPath } from 'node:url';
14
+
15
+ const KIT = fileURLToPath(new URL('..', import.meta.url));
16
+ const ENGINES = [
17
+ { engine: path.join(KIT, '..', 'physics-3d'), art: path.join(KIT, '..', 'physics-2d') },
18
+ { engine: path.join(KIT, 'imports', 'castle.physics-3d'), art: path.join(KIT, 'imports', 'castle.physics-2d') },
19
+ ];
20
+ const found = ENGINES.find(({ engine }) => fs.existsSync(path.join(engine, 'engine3d', 'pxmodel.js')));
21
+
22
+ // The engine's modules are written for the bundler: imports without
23
+ // extensions, and the 2d kit by its alias.
24
+ register(
25
+ 'data:text/javascript,' +
26
+ encodeURIComponent(`
27
+ import { existsSync } from 'node:fs';
28
+ import { fileURLToPath, pathToFileURL } from 'node:url';
29
+ const ART = ${JSON.stringify(found ? found.art : '')};
30
+ export async function resolve(specifier, context, next) {
31
+ const parent = context.parentURL ?? '';
32
+ if (specifier.startsWith('@imports/castle.physics-2d/')) {
33
+ specifier = pathToFileURL(ART + '/' + specifier.slice(27)).href;
34
+ }
35
+ if ((specifier.startsWith('.') || specifier.startsWith('file:')) && parent.startsWith('file:') && !/\\.(m?js|jsx|json)$/.test(specifier)) {
36
+ const base = new URL(specifier, parent).href;
37
+ for (const ext of ['.js', '.jsx']) {
38
+ if (existsSync(fileURLToPath(base + ext))) {
39
+ return next(base + ext, context);
40
+ }
41
+ }
42
+ }
43
+ return next(specifier, context);
44
+ }`),
45
+ );
46
+
47
+ const Share = await import('../code/client/avatarShare.js');
48
+ const THREE = await import('three');
49
+
50
+ let n = 0;
51
+ async function test(name, fn) {
52
+ try {
53
+ await fn();
54
+ } catch (error) {
55
+ console.error(`hub-game avatar share: FAILED ${name}`);
56
+ throw error;
57
+ }
58
+ n += 1;
59
+ }
60
+
61
+ await test('?hubAvShare=0 turns it off, sort adds the order, anything else is shared in three.js order', () => {
62
+ const modeFor = (search) => {
63
+ Share.setShareEnv({ location: { search } });
64
+ return Share.shareMode();
65
+ };
66
+ assert.equal(modeFor(''), 'nosort');
67
+ assert.equal(modeFor('?hubAvShare=1'), 'nosort');
68
+ assert.equal(modeFor('?hubAvShare=0'), 'off');
69
+ assert.equal(modeFor('?x=1&hubAvShare=sort'), 'on');
70
+ assert.equal(modeFor('?hubAvShare=nosort'), 'nosort');
71
+ Share.setShareEnv({ location: null });
72
+ assert.equal(Share.shareMode(), 'nosort');
73
+ Share.setShareEnv(null);
74
+ });
75
+
76
+ await test('only a visible, untextured material is shared, and one look is one material', () => {
77
+ const a = new THREE.MeshPhysicalMaterial({ color: '#ffffff', roughness: 1 });
78
+ const b = new THREE.MeshPhysicalMaterial({ color: '#ffffff', roughness: 1 });
79
+ const red = new THREE.MeshPhysicalMaterial({ color: '#ff0000', roughness: 1 });
80
+ const both = new THREE.MeshPhysicalMaterial({ color: '#ffffff', roughness: 1, side: THREE.DoubleSide });
81
+ assert.equal(Share.sharedFor(a), Share.sharedFor(b));
82
+ assert.notEqual(Share.sharedFor(a), a);
83
+ assert.notEqual(Share.sharedFor(red), Share.sharedFor(a));
84
+ assert.notEqual(Share.sharedFor(both), Share.sharedFor(a));
85
+ // A shared material is its own.
86
+ assert.equal(Share.sharedFor(Share.sharedFor(a)), Share.sharedFor(a));
87
+ const hidden = new THREE.MeshBasicMaterial({ color: '#241a2e' });
88
+ hidden.visible = false;
89
+ assert.equal(Share.sharedFor(hidden), null);
90
+ const textured = new THREE.MeshBasicMaterial({ map: new THREE.Texture() });
91
+ assert.equal(Share.sharedFor(textured), null);
92
+ // An outline whose width differs is another look, though its code is the same.
93
+ const outline = (width) => {
94
+ const material = new THREE.MeshBasicMaterial({ color: '#241a2e', side: THREE.BackSide });
95
+ const uniforms = { lookOutline: { value: width }, lookViewportHeight: { value: Math.random() } };
96
+ material.onBeforeCompile = (shader) => {
97
+ Object.assign(shader.uniforms, uniforms);
98
+ };
99
+ material.customProgramCacheKey = () => 'look-outline';
100
+ return material;
101
+ };
102
+ assert.equal(Share.sharedFor(outline(0.03)), Share.sharedFor(outline(0.03)));
103
+ assert.notEqual(Share.sharedFor(outline(0.03)), Share.sharedFor(outline(0.05)));
104
+ // An avatar waiting for its outline is left, and tried again later.
105
+ const rig = new THREE.Group();
106
+ const mesh = new THREE.Mesh(new THREE.BufferGeometry(), hidden);
107
+ rig.add(mesh);
108
+ assert.equal(Share.shareRig(rig), false);
109
+ assert.equal(mesh.material, hidden);
110
+ hidden.visible = true;
111
+ assert.equal(Share.shareRig(rig), true);
112
+ assert.notEqual(mesh.material, hidden);
113
+ });
114
+
115
+ await test('share() reads the rig under each node, and sets the opaque order once per renderer', () => {
116
+ const sorts = [];
117
+ const renderer = { setOpaqueSort: (fn) => sorts.push(fn) };
118
+ const rig = new THREE.Group();
119
+ rig.userData.modelParts = new Map();
120
+ const mine = new THREE.Mesh(new THREE.BufferGeometry(), new THREE.MeshLambertMaterial({ color: '#123456' }));
121
+ rig.add(mine);
122
+ const node = new THREE.Group();
123
+ // What is worn hangs beside the rig and is left alone.
124
+ const hat = new THREE.Mesh(new THREE.BufferGeometry(), new THREE.MeshLambertMaterial({ color: '#123456' }));
125
+ node.add(hat, rig);
126
+ const scene = { three: { renderer, nodes: new Map([['a', { node }]]) } };
127
+ const hatMaterial = hat.material;
128
+ Share.setShareEnv({ location: { search: '?hubAvShare=0' } });
129
+ Share.share(scene, ['a', undefined, 'gone']);
130
+ assert.equal(sorts.length, 0);
131
+ assert.equal(Share.rigOf(node), rig);
132
+ const before = mine.material;
133
+ Share.setShareEnv({ location: { search: '' } });
134
+ Share.share(scene, ['a']);
135
+ assert.equal(sorts.length, 0);
136
+ assert.notEqual(mine.material, before);
137
+ assert.equal(hat.material, hatMaterial);
138
+ Share.setShareEnv({ location: { search: '?hubAvShare=sort' } });
139
+ Share.share(scene, ['a']);
140
+ Share.share(scene, ['a']);
141
+ assert.deepEqual(sorts, [Share.opaqueOrder]);
142
+ Share.setShareEnv(null);
143
+ });
144
+
145
+ await test("only the kit's shared materials are grouped by geometry; every other draw keeps three.js's exact order", () => {
146
+ // three.js r180's painterSortStable, as WebGLRenderLists.js has it.
147
+ const painterSortStable = (a, b) => {
148
+ if (a.groupOrder !== b.groupOrder) return a.groupOrder - b.groupOrder;
149
+ if (a.renderOrder !== b.renderOrder) return a.renderOrder - b.renderOrder;
150
+ if (a.material.id !== b.material.id) return a.material.id - b.material.id;
151
+ if (a.z !== b.z) return a.z - b.z;
152
+ return a.id - b.id;
153
+ };
154
+ let seed = 7;
155
+ const random = () => {
156
+ seed = (seed * 1103515245 + 12345) % 2147483648;
157
+ return seed / 2147483648;
158
+ };
159
+ const pick = (list) => list[Math.floor(random() * list.length)];
160
+ const plain = [new THREE.MeshPhysicalMaterial({ vertexColors: true }), new THREE.MeshBasicMaterial(), new THREE.MeshLambertMaterial()];
161
+ const kit = [Share.sharedFor(new THREE.MeshPhysicalMaterial({ color: '#abcdef' })), Share.sharedFor(new THREE.MeshPhysicalMaterial({ color: '#fedcba' }))];
162
+ assert.ok(kit.every((material) => material && material.name === 'hub-avatar-shared'));
163
+ const geometries = Array.from({ length: 4 }, () => new THREE.BufferGeometry());
164
+ // Equal depths are common: coplanar meshes, and objects at one distance.
165
+ const item = (id, materials) => ({
166
+ id,
167
+ groupOrder: pick([0, 0, 0, 1]),
168
+ renderOrder: pick([0, 0, 0, 2]),
169
+ material: pick(materials),
170
+ geometry: pick(geometries),
171
+ z: pick([1, 1, 2, 3.5]),
172
+ });
173
+ // Without any of the kit's materials the order is three's, item for item,
174
+ // ties broken the same way.
175
+ for (let round = 0; round < 50; round += 1) {
176
+ const items = Array.from({ length: 40 }, (_, id) => item(id, plain));
177
+ const ours = [...items].sort(Share.opaqueOrder).map((each) => each.id);
178
+ const three = [...items].sort(painterSortStable).map((each) => each.id);
179
+ assert.deepEqual(ours, three);
180
+ for (const a of items) {
181
+ for (const b of items) {
182
+ assert.equal(Math.sign(Share.opaqueOrder(a, b)), Math.sign(painterSortStable(a, b)));
183
+ }
184
+ }
185
+ }
186
+ // Coplanar meshes of one plain material, two geometries, equal depth: the
187
+ // stable id decides, as in three, not the geometry.
188
+ const [g1, g2] = geometries[0].id < geometries[1].id ? [geometries[0], geometries[1]] : [geometries[1], geometries[0]];
189
+ const first = { id: 0, groupOrder: 0, renderOrder: 0, material: plain[0], geometry: g2, z: 5 };
190
+ const second = { id: 1, groupOrder: 0, renderOrder: 0, material: plain[0], geometry: g1, z: 5 };
191
+ assert.deepEqual([second, first].sort(Share.opaqueOrder), [first, second]);
192
+ // On a mixed set the order is consistent: antisymmetric and transitive.
193
+ const mixed = Array.from({ length: 30 }, (_, id) => item(id, [...plain, ...kit]));
194
+ const sign = (a, b) => Math.sign(Share.opaqueOrder(a, b));
195
+ for (const a of mixed) {
196
+ for (const b of mixed) {
197
+ assert.equal(sign(a, b), -sign(b, a) || 0);
198
+ for (const c of mixed) {
199
+ if (sign(a, b) <= 0 && sign(b, c) <= 0) {
200
+ assert.ok(sign(a, c) <= 0, 'not transitive');
201
+ }
202
+ }
203
+ }
204
+ }
205
+ // The kit's materials' runs are grouped by geometry; the others' are three's.
206
+ const sorted = [...mixed].sort(Share.opaqueOrder);
207
+ for (let i = 1; i < sorted.length; i += 1) {
208
+ const [a, b] = [sorted[i - 1], sorted[i]];
209
+ if (a.material === b.material && a.groupOrder === b.groupOrder && a.renderOrder === b.renderOrder) {
210
+ if (kit.includes(a.material)) {
211
+ assert.ok(a.geometry.id <= b.geometry.id);
212
+ } else {
213
+ assert.ok(painterSortStable(a, b) < 0);
214
+ }
215
+ }
216
+ }
217
+ });
218
+
219
+ if (!found) {
220
+ console.log('hub-game avatar share: models NOT CHECKED, no castle.physics-3d engine beside this kit or in its imports');
221
+ } else {
222
+ const { buildModelNode, parseModel } = await import(path.join(found.engine, 'engine3d', 'pxmodel.js'));
223
+ const { copyModel, modelCost } = await import(path.join(found.engine, 'engine3d', 'optimize.js'));
224
+ const templates = new Map();
225
+ const template = (i) => {
226
+ if (!templates.has(i)) {
227
+ const file = `models/avatar-${i}.pxmodel`;
228
+ const node = buildModelNode(parseModel(fs.readFileSync(path.join(KIT, file), 'utf8')), {}, {}, file, [file], { optimize: true });
229
+ node.updateMatrixWorld(true);
230
+ templates.set(i, node);
231
+ }
232
+ return templates.get(i);
233
+ };
234
+ const meshesOf = (rig) => {
235
+ const meshes = [];
236
+ rig.traverse((object) => object.isMesh && meshes.push(object));
237
+ return meshes;
238
+ };
239
+ // What decides how a material draws, read field by field rather than
240
+ // through the module's own look.
241
+ const drawn = (material) => {
242
+ const json = material.toJSON();
243
+ delete json.uuid;
244
+ delete json.name;
245
+ const shader = { uniforms: {}, vertexShader: 'V #include <begin_vertex> #include <project_vertex>', fragmentShader: 'F #include <color_fragment> #include <opaque_fragment> #include <roughnessmap_fragment> #include <metalnessmap_fragment>' };
246
+ material.onBeforeCompile(shader, null);
247
+ const uniforms = Object.fromEntries(Object.entries(shader.uniforms).filter(([k]) => k !== 'lookViewportHeight').map(([k, u]) => [k, u.value]));
248
+ return JSON.stringify([json, material.defines ?? null, material.customProgramCacheKey(), shader.vertexShader, shader.fragmentShader, uniforms, String(material.onBeforeRender), material.constructor.name]);
249
+ };
250
+
251
+ await test('every character draws as it did: the same look per mesh, geometry, triangles and draw calls', () => {
252
+ for (let i = 0; i < 16; i += 1) {
253
+ const rig = copyModel(template(i));
254
+ const before = meshesOf(rig).map((mesh) => ({ mesh, geometry: mesh.geometry, material: mesh.material, look: drawn(mesh.material) }));
255
+ const cost = modelCost(rig);
256
+ assert.equal(Share.shareRig(rig), true, `avatar-${i}`);
257
+ for (const { mesh, geometry, material, look } of before) {
258
+ assert.equal(mesh.geometry, geometry);
259
+ assert.notEqual(mesh.material, material, `avatar-${i}: a mesh kept its own material`);
260
+ assert.equal(drawn(mesh.material), look, `avatar-${i}: ${mesh.userData.partMesh} draws differently`);
261
+ }
262
+ const after = modelCost(rig);
263
+ assert.deepEqual({ ...after, materials: 0 }, { ...cost, materials: 0 }, `avatar-${i}`);
264
+ // The build the engine keeps (and disposes) keeps its own materials.
265
+ assert.ok(meshesOf(template(i)).every((mesh) => mesh.material.name !== 'hub-avatar-shared'), `avatar-${i}`);
266
+ }
267
+ });
268
+
269
+ // Draws in three.js's opaque order, counted as a renderer pays for them.
270
+ const frame = (indices, share, order) => {
271
+ const draws = [];
272
+ indices.forEach((i, r) => {
273
+ const rig = copyModel(template(i));
274
+ if (share) {
275
+ Share.shareRig(rig);
276
+ }
277
+ const z = ((r * 7919) % 13) + 1;
278
+ for (const mesh of meshesOf(rig)) {
279
+ draws.push({ groupOrder: 0, renderOrder: 0, material: mesh.material, geometry: mesh.geometry, z, id: draws.length });
280
+ }
281
+ });
282
+ draws.sort(order);
283
+ const programOf = (m) => [m.type, m.side, m.vertexColors, Object.keys(m.defines ?? {}).join('+'), m.customProgramCacheKey()].join('|');
284
+ const count = { draws: draws.length, programs: 0, materials: 0, geometries: 0 };
285
+ let last = {};
286
+ for (const d of draws) {
287
+ count.programs += programOf(d.material) !== last.program ? 1 : 0;
288
+ count.materials += d.material !== last.material ? 1 : 0;
289
+ count.geometries += d.geometry !== last.geometry ? 1 : 0;
290
+ last = { program: programOf(d.material), material: d.material, geometry: d.geometry };
291
+ }
292
+ return count;
293
+ };
294
+ // three.js's own `painterSortStable`.
295
+ const threeOrder = (a, b) => a.material.id - b.material.id || a.z - b.z || a.id - b.id;
296
+
297
+ await test('eleven different characters switch material and program about as often as eleven copies of one', () => {
298
+ const distinct = [0, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14];
299
+ const copies = [0, ...Array(11).fill(4)];
300
+ const oldFour = [0, 0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2];
301
+ const rows = {};
302
+ for (const [name, indices] of Object.entries({ distinct, copies, oldFour })) {
303
+ rows[name] = { before: frame(indices, false, threeOrder), after: frame(indices, true, Share.opaqueOrder) };
304
+ assert.equal(rows[name].after.draws, rows[name].before.draws, name);
305
+ }
306
+ // Before: a material run per character and batch.
307
+ assert.ok(rows.distinct.before.materials >= 90, JSON.stringify(rows.distinct));
308
+ assert.ok(rows.distinct.after.materials <= 12 && rows.distinct.after.programs <= 8, JSON.stringify(rows.distinct));
309
+ // No scene binds a geometry more often than it did.
310
+ for (const [name, row] of Object.entries(rows)) {
311
+ assert.ok(row.after.materials <= row.before.materials && row.after.programs <= row.before.programs, `${name} ${JSON.stringify(row)}`);
312
+ assert.ok(row.after.geometries <= row.before.geometries + 6, `${name} ${JSON.stringify(row)}`);
313
+ }
314
+ console.log(`hub-game avatar share: programs/materials/geometries ${Object.entries(rows).map(([name, { before, after }]) => `${name} ${before.programs}/${before.materials}/${before.geometries} -> ${after.programs}/${after.materials}/${after.geometries}`).join(', ')}`);
315
+ });
316
+ }
317
+
318
+ console.log(`hub-game avatar share: ${n} tests passed`);