castle-web-cli 0.4.232 → 0.4.234

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 (587) 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/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,372 @@
1
+ // Shared imperative player used by React and the opt-in runtime-only entry.
2
+ import { makeScene } from '@imports/castle.physics-2d/engine/scene';
3
+ import {
4
+ makeWorld3D,
5
+ resizeWorld,
6
+ syncActors,
7
+ renderWorld,
8
+ disposeWorld,
9
+ updatePhysicsDebug,
10
+ } from './world3d';
11
+ import { prepareEmptyNodes, loadEmptyScene } from './emptynodes';
12
+ import { attachOrbitInput } from './orbitinput';
13
+ import { renderHidingOwnModel } from './ownmodel';
14
+ import { makeFrameClock, makeInputLatch, nextFrame, updateLending } from './framecap';
15
+ import { prepareModelConsumers } from './modelready.js';
16
+
17
+ export function mountScene3D({
18
+ canvas,
19
+ sceneData,
20
+ sprites,
21
+ files,
22
+ behaviorClasses,
23
+ scenePath,
24
+ onFirstFrame,
25
+ onLoopError,
26
+ hudRefs,
27
+ onStage,
28
+ }) {
29
+ onStage?.('runtime:start');
30
+ const runtime = makeScene(sceneData, behaviorClasses, sprites, files, scenePath);
31
+ onStage?.('runtime:built');
32
+ const world = makeWorld3D(canvas);
33
+ if (onStage) world.onStage = onStage;
34
+ onStage?.('world:built');
35
+ runtime.three = world;
36
+ if (runtime.skipsEmptyNodes) prepareEmptyNodes(world, runtime);
37
+ // The first load precedes world creation; later loads initialize at the latch.
38
+ if (runtime.cameraControl === 'orbit') world.ownModelWith ??= new Set();
39
+ runtime.hud = {};
40
+ // Scene-independent state: survives `loadFromFile` (the scene data is
41
+ // replaced, the runtime instance is not). Player score/inventory and the
42
+ // camera angle live here so they cross scene switches.
43
+ runtime.persistent = {};
44
+ runtime.currentScenePath = scenePath ?? 'scenes/main.scene';
45
+ // This loop applies `requestedContent` with `requestedScene` (another
46
+ // deck's content, mounted as data); a caller checks before asking.
47
+ runtime.mountsContent = true;
48
+
49
+ // What went down between capped frames, for the next one that runs.
50
+ const latch = makeInputLatch();
51
+ const detachInput = attachInput(canvas, runtime, world, latch);
52
+ const stopResize = attachResize(canvas, world);
53
+ const stopLoop = startLoop(
54
+ runtime,
55
+ world,
56
+ sprites,
57
+ hudRefs,
58
+ onFirstFrame,
59
+ onLoopError,
60
+ latch,
61
+ onStage
62
+ );
63
+ return () => {
64
+ stopLoop();
65
+ stopResize();
66
+ detachInput();
67
+ runtime.dispose();
68
+ disposeWorld(world);
69
+ };
70
+ }
71
+
72
+ function attachInput(canvas, runtime, world, latch) {
73
+ const onKeyDown = (event) => {
74
+ // Space is gameplay (jump); keep it from scrolling the page.
75
+ if (event.code === 'Space' && event.target === canvas) event.preventDefault();
76
+ if (event.code === 'KeyP' && !event.repeat) {
77
+ world.debugLines.visible = !world.debugLines.visible;
78
+ }
79
+ if (
80
+ runtime.cameraControl === 'orbit' &&
81
+ event.key === 'Shift' &&
82
+ !event.repeat &&
83
+ !event.isComposing && !event.altKey && !event.ctrlKey && !event.metaKey &&
84
+ !event.target?.isContentEditable &&
85
+ !event.target?.closest?.('input, textarea, select')
86
+ ) {
87
+ runtime.orbitInput().shiftLock.toggle();
88
+ }
89
+ runtime.keys.add(event.code);
90
+ runtime.keys.add(event.key);
91
+ // A key's auto-repeat is not a new press: it is held, and a frame that
92
+ // runs sees it held.
93
+ if (runtime.maxFps > 0 && !event.repeat) {
94
+ latch.keys.add(event.code);
95
+ latch.keys.add(event.key);
96
+ }
97
+ };
98
+ const onKeyUp = (event) => {
99
+ runtime.keys.delete(event.code);
100
+ runtime.keys.delete(event.key);
101
+ };
102
+ // Pointer (mouse or touch) input is multitouch, tracked per pointerId:
103
+ // - a DRAG is the virtual stick -- the offset from where the drag started
104
+ // maps to a walk direction (drag up = forward). The first pointer to
105
+ // travel past the tap slop owns the stick until it lifts.
106
+ // - a TAP (down and up quickly without moving much) is a jump, even while
107
+ // another finger is dragging. `moveInput.consumeJump()` hands the
108
+ // pending tap to the Player behavior exactly once.
109
+ // `runtime.moveInput` is what the Player behavior reads.
110
+ const STICK_RADIUS_PX = 56;
111
+ const TAP_SLOP_PX = 12;
112
+ const TAP_MS = 300;
113
+ const pointers = new Map();
114
+ let stickId = null;
115
+ let jumpPending = false;
116
+ const move = {
117
+ x: 0,
118
+ y: 0,
119
+ active: false,
120
+ consumeJump() {
121
+ const had = jumpPending;
122
+ jumpPending = false;
123
+ return had;
124
+ },
125
+ };
126
+ runtime.moveInput = move;
127
+ const clearStick = () => {
128
+ stickId = null;
129
+ move.active = false;
130
+ move.x = 0;
131
+ move.y = 0;
132
+ };
133
+ // A scene that set `"engine": { "camera": { "control": "orbit" } }` beside
134
+ // `"follow": "rigid"`: a pointer that goes down in it is orbitinput.js's
135
+ // from then until it lifts (or a scene loads). It is made the first time
136
+ // a pointer goes down under the key, Shift is pressed there, or a Player runs under it
137
+ // (`runtime.orbitInput()`), never in a runtime that does not meet the key.
138
+ // Without the key each handler below reads one property and goes on as it
139
+ // always did.
140
+ let orbit = null;
141
+ runtime.orbitInput = () =>
142
+ (orbit ??= attachOrbitInput(
143
+ canvas,
144
+ runtime,
145
+ move,
146
+ () => {
147
+ jumpPending = true;
148
+ },
149
+ { stickRadius: STICK_RADIUS_PX, tapSlop: TAP_SLOP_PX, tapMs: TAP_MS },
150
+ // A pointer that came up unseen while a lock of the orbit input's
151
+ // was on: a pointercancel for it, through the handler below.
152
+ (event) => onPointerUp(event)
153
+ ));
154
+ const onPointerDown = (event) => {
155
+ if (runtime.cameraControl === 'orbit') {
156
+ // Fingers that went down before the key (a scene without it was
157
+ // loaded then) are let go of here, so they and orbitinput.js never
158
+ // both write the stick: the handlers below ignore them from now on.
159
+ if (pointers.size > 0 || stickId !== null) {
160
+ pointers.clear();
161
+ clearStick();
162
+ }
163
+ return runtime.orbitInput().down(event);
164
+ }
165
+ canvas.focus();
166
+ pointers.set(event.pointerId, {
167
+ x: event.clientX,
168
+ y: event.clientY,
169
+ time: performance.now(),
170
+ moved: false,
171
+ });
172
+ // A runtime that has met the key: the orbit input gives this pointer
173
+ // its capture back if a lock of its own ends while it is down.
174
+ orbit?.pointer(event);
175
+ canvas.setPointerCapture(event.pointerId);
176
+ };
177
+ const onPointerMove = (event) => {
178
+ if (orbit?.active && orbit.move(event)) {
179
+ // The orbit input writes its stick into `move` too: under a cap it is
180
+ // lent like the stick below, so a drag that ends between two capped
181
+ // frames is still seen.
182
+ if (runtime.maxFps > 0 && move.active) latch.stick = { x: move.x, y: move.y };
183
+ return;
184
+ }
185
+ const p = pointers.get(event.pointerId);
186
+ if (!p) return;
187
+ const dx = event.clientX - p.x;
188
+ const dy = event.clientY - p.y;
189
+ if (!p.moved && Math.hypot(dx, dy) > TAP_SLOP_PX) p.moved = true;
190
+ // A pointer claims the stick once it is clearly a drag (and nothing else
191
+ // holds it) -- so a tapping finger never yanks the walk direction.
192
+ if (p.moved && stickId === null) stickId = event.pointerId;
193
+ if (stickId !== event.pointerId) return;
194
+ const nx = dx / STICK_RADIUS_PX;
195
+ const ny = dy / STICK_RADIUS_PX;
196
+ const len = Math.hypot(nx, ny);
197
+ const scale = len > 1 ? 1 / len : 1;
198
+ move.active = true;
199
+ move.x = nx * scale;
200
+ move.y = ny * scale;
201
+ if (runtime.maxFps > 0) latch.stick = { x: move.x, y: move.y };
202
+ };
203
+ const onPointerUp = (event) => {
204
+ if (orbit?.busy && orbit.up(event)) return;
205
+ orbit?.pointer(event);
206
+ const p = pointers.get(event.pointerId);
207
+ pointers.delete(event.pointerId);
208
+ if (stickId === event.pointerId) clearStick();
209
+ if (event.type === 'pointercancel' || !p) return;
210
+ if (!p.moved && performance.now() - p.time < TAP_MS) jumpPending = true;
211
+ };
212
+ window.addEventListener('keydown', onKeyDown);
213
+ window.addEventListener('keyup', onKeyUp);
214
+ canvas.addEventListener('pointerdown', onPointerDown);
215
+ canvas.addEventListener('pointermove', onPointerMove);
216
+ canvas.addEventListener('pointerup', onPointerUp);
217
+ canvas.addEventListener('pointercancel', onPointerUp);
218
+ if (document.hasFocus() || window.parent === window) canvas.focus();
219
+ return () => {
220
+ window.removeEventListener('keydown', onKeyDown);
221
+ window.removeEventListener('keyup', onKeyUp);
222
+ canvas.removeEventListener('pointerdown', onPointerDown);
223
+ canvas.removeEventListener('pointermove', onPointerMove);
224
+ canvas.removeEventListener('pointerup', onPointerUp);
225
+ canvas.removeEventListener('pointercancel', onPointerUp);
226
+ orbit?.detach();
227
+ };
228
+ }
229
+
230
+ function attachResize(canvas, world) {
231
+ const fit = () => resizeWorld(world, canvas.clientWidth, canvas.clientHeight);
232
+ const observer = new ResizeObserver(fit);
233
+ observer.observe(canvas);
234
+ fit();
235
+ return () => observer.disconnect();
236
+ }
237
+
238
+ function startLoop(runtime, world, sprites, hudRefs, onFirstFrame, onError, latch, onStage) {
239
+ let raf = 0;
240
+ const clock = makeFrameClock(performance.now());
241
+ let firstFrameSignaled = false;
242
+ const tick = (now) => {
243
+ // A scene that set `engine.maxFps` skips an animation frame that comes
244
+ // too soon after the last frame that ran (`framecap.js`); without it
245
+ // every animation frame runs, handed what it always was.
246
+ const maxFps = runtime.maxFps;
247
+ const dt = nextFrame(clock, now, maxFps);
248
+ if (dt === null) {
249
+ raf = requestAnimationFrame(tick);
250
+ return;
251
+ }
252
+ const stage = firstFrameSignaled ? undefined : onStage;
253
+ try {
254
+ stage?.('first-update:start');
255
+ // A capped frame also sees what went down while frames were skipped.
256
+ if (maxFps > 0) updateLending(runtime, latch, dt);
257
+ else {
258
+ // Nothing noted under a cap outlives it: a frame without one drops it.
259
+ if (latch.keys.size > 0 || latch.stick) {
260
+ latch.keys.clear();
261
+ latch.stick = null;
262
+ }
263
+ prepareModelConsumers(world, runtime);
264
+ runtime.update(dt);
265
+ }
266
+ stage?.('first-update:end');
267
+ // A behavior may have requested a scene switch; apply it here, between
268
+ // frames, never mid physics dispatch. The load resets
269
+ // registered systems -- the rapier world frees and lazily rebuilds --
270
+ // while `runtime.persistent` carries the player's cross-scene state.
271
+ if (runtime.requestedScene) {
272
+ const next = world.emptyNodesOwned
273
+ ? loadEmptyScene(world, runtime, loadRequestedScene)
274
+ : loadRequestedScene(runtime);
275
+ if (runtime.skipsEmptyNodes) prepareEmptyNodes(world, runtime);
276
+ runtime.currentScenePath = next;
277
+ runtime.persistent.sceneChangeGraceUntil = runtime.time + 1;
278
+ }
279
+ stage?.('scene-build:start');
280
+ syncActors(world, runtime, runtime.sprites ?? sprites, dt);
281
+ stage?.('scene-build:end');
282
+ if (world.debugLines.visible) updatePhysicsDebug(world, runtime.physics3d?.debugRender());
283
+ // Under the orbit camera key the Player names its actor for this
284
+ // frame's draw, which leaves that model out when the camera is inside
285
+ // it (ownmodel.js). Without the key the field is never set and this
286
+ // is the call it always was.
287
+ stage?.('first-render:start');
288
+ if (runtime.orbitOwnModel !== undefined) renderHidingOwnModel(world, runtime, renderWorld);
289
+ else renderWorld(world, runtime);
290
+ stage?.('first-render:end');
291
+ updateHud(runtime, hudRefs);
292
+ } catch (err) {
293
+ onError?.(err);
294
+ return;
295
+ }
296
+ if (!firstFrameSignaled) {
297
+ firstFrameSignaled = true;
298
+ requestAnimationFrame(() => {
299
+ onStage?.('first-frame');
300
+ onFirstFrame?.();
301
+ });
302
+ }
303
+ raf = requestAnimationFrame(tick);
304
+ };
305
+ raf = requestAnimationFrame(tick);
306
+ return () => cancelAnimationFrame(raf);
307
+ }
308
+
309
+ // Load the scene a behavior asked for, with the content it comes from when
310
+ // that is another deck's (a hub content pack; `null` puts this deck's own
311
+ // back). Content that fails to load puts the scene that was running back and
312
+ // leaves the error on `runtime.mountError` for the asker. Returns the path now
313
+ // loaded.
314
+ function loadRequestedScene(runtime) {
315
+ const next = runtime.requestedScene;
316
+ runtime.requestedScene = null;
317
+ if (runtime.requestedContent === undefined) {
318
+ runtime.loadFromFile(next);
319
+ return next;
320
+ }
321
+ const before = { content: runtime.content ?? null, path: runtime.currentScenePath };
322
+ runtime.setContent(runtime.requestedContent);
323
+ runtime.requestedContent = undefined;
324
+ try {
325
+ runtime.loadFromFile(next);
326
+ return next;
327
+ } catch (err) {
328
+ console.error('[engine] content failed to load; staying where we were', err);
329
+ runtime.setContent(before.content);
330
+ runtime.loadFromFile(before.path);
331
+ runtime.mountError = err;
332
+ return before.path;
333
+ }
334
+ }
335
+
336
+ // Behaviors write `scene.hud = { score, look }`; the loop pushes it into the
337
+ // overlay divs imperatively (no react re-render at frame rate).
338
+ function updateHud(runtime, hudRefs) {
339
+ const hud = runtime.hud ?? {};
340
+ const scoreText = hud.score ? String(hud.score) : '';
341
+ const lookText = hud.look ?? '';
342
+ if (hudRefs.score.current && hudRefs.score.current.textContent !== scoreText) {
343
+ hudRefs.score.current.textContent = scoreText;
344
+ }
345
+ if (hudRefs.look.current && hudRefs.look.current.textContent !== lookText) {
346
+ hudRefs.look.current.textContent = lookText;
347
+ }
348
+ }
349
+
350
+ export const hudStyles = {
351
+ score: {
352
+ position: 'absolute',
353
+ top: 14,
354
+ left: 16,
355
+ color: '#7bd9ed',
356
+ font: "16px/1.4 'SFMono-Regular', Consolas, monospace",
357
+ textShadow: '0 1px 2px rgba(0,0,0,0.8)',
358
+ pointerEvents: 'none',
359
+ },
360
+ look: {
361
+ position: 'absolute',
362
+ bottom: 22,
363
+ left: 0,
364
+ right: 0,
365
+ textAlign: 'center',
366
+ color: '#e6e6e2',
367
+ fontStyle: 'italic',
368
+ font: 'italic 15px/1.4 Georgia, serif',
369
+ textShadow: '0 1px 3px rgba(0,0,0,0.9)',
370
+ pointerEvents: 'none',
371
+ },
372
+ };
@@ -17,6 +17,7 @@ import { applyLook, lookIsEnabled } from './look';
17
17
  import { applyArtObjects, applyMaterialExtras, partArtRefs } from './artobjects';
18
18
  import { coarsenParts, detailFor, optimizeModel, referenceBudget } from './optimize';
19
19
  import { airSpeed, modelAnimation } from './motion';
20
+ import { modelWalk, takeWalkSpeedHint, takeWalkSpeedHintIfPresent, walkGait } from './gait.js';
20
21
 
21
22
  const DEG = Math.PI / 180;
22
23
 
@@ -258,16 +259,28 @@ export const STARTER_MODEL_TEXT = serializeModel({
258
259
  parts: [normalizePart({ id: 'body', size: [1, 1, 1], position: [0, 0.5, 0] }, 0)],
259
260
  });
260
261
 
261
- // Bounded parse cache -- model text is re-seen constantly by signatures and
262
- // rebuilds; parsing is cheap but not free.
262
+ // Model text is re-seen constantly by signatures and rebuilds. Keep a
263
+ // 400-model deck plus recent edits, evicting only the least recently used.
264
+ // The hub-world-preview's 314 distinct texts (315 files) averaged ~30 KiB
265
+ // retained per parse and 5.2 KiB of source: Node 22 --expose-gc heap deltas,
266
+ // 20 retained corpus copies, five runs. At 512 entries that is ~20 MiB for
267
+ // parsed data + text (allowing two bytes per source character), excluding
268
+ // renderer caches. Hits keep the same object, also used by look's WeakMap.
269
+ const PARSE_CACHE_LIMIT = 512;
263
270
  const parseCache = new Map();
264
271
  export function parseModelCached(text) {
265
272
  if (typeof text !== 'string') return null;
266
273
  const cached = parseCache.get(text);
267
- if (cached !== undefined) return cached;
268
- if (parseCache.size > 200) parseCache.clear();
274
+ if (cached !== undefined) {
275
+ parseCache.delete(text);
276
+ parseCache.set(text, cached);
277
+ return cached;
278
+ }
269
279
  const model = parseModel(text);
270
280
  parseCache.set(text, model);
281
+ if (parseCache.size > PARSE_CACHE_LIMIT) {
282
+ parseCache.delete(parseCache.keys().next().value);
283
+ }
271
284
  return model;
272
285
  }
273
286
 
@@ -630,7 +643,10 @@ export function modelArtSignature(model, sprites) {
630
643
  // Walk animation by part-id convention (legL/legR/armL/armR/torso), driven by
631
644
  // observed motion: speed from position deltas, air from vertical speed, lean
632
645
  // from yaw rate. dt of 0 (editor views) holds the neutral pose.
633
- export function animateModelParts(entry, dt) {
646
+ export function animateModelParts(entry, dt, world, skipEmptyHints = false) {
647
+ if (walkGait() === 'model') {
648
+ entry.walkFrameHint = (skipEmptyHints ? takeWalkSpeedHintIfPresent(entry.node) : takeWalkSpeedHint(entry.node));
649
+ }
634
650
  const partGroups = entry.node.userData.modelParts;
635
651
  if (!partGroups) return;
636
652
  const parts = {
@@ -643,12 +659,25 @@ export function animateModelParts(entry, dt) {
643
659
  if (!parts.legL && !parts.torso) return;
644
660
  const anim = (entry.modelAnim ??= { phase: 0, swing: 0, air: 0, lean: 0, last: null });
645
661
  const p = entry.node.position;
662
+ const gait = walkGait() === 'model'
663
+ ? modelWalk(entry.node, anim, ['legL', 'legR'], 0.8,
664
+ dt > 0 && anim.last ? Math.hypot(p.x - anim.last.x, p.z - anim.last.z) / dt : 0,
665
+ dt, entry.walkFrameHint) : null;
646
666
  if (dt > 0 && anim.last) {
647
- const speed = Math.hypot(p.x - anim.last.x, p.z - anim.last.z) / dt;
648
- const verticalSpeed = airSpeed(entry.node, p, anim.last, dt);
649
- anim.swing += (Math.min(1, speed / 5) - anim.swing) * Math.min(1, dt * 10);
650
- anim.air += ((Math.abs(verticalSpeed) > 1.2 ? 1 : 0) - anim.air) * Math.min(1, dt * 8);
651
- anim.phase += Math.min(speed, 8) * 2.4 * dt;
667
+ if (gait?.model) {
668
+ const verticalSpeed = airSpeed(entry.node, p, anim.last, dt, world);
669
+ anim.swing += (Math.min(1, gait.speed / gait.walkSpeed) - anim.swing) * Math.min(1, gait.dt * 10);
670
+ anim.air += ((Math.abs(verticalSpeed) > 1.2 ? 1 : 0) - anim.air) * Math.min(1, dt * 8);
671
+ anim.amplitudeScale ??= 1;
672
+ anim.amplitudeScale += (gait.amplitudeScale - anim.amplitudeScale) * Math.min(1, gait.dt * 10);
673
+ anim.phase += 2 * Math.PI * gait.cadence * gait.phaseDt;
674
+ } else {
675
+ const speed = Math.hypot(p.x - anim.last.x, p.z - anim.last.z) / dt;
676
+ const verticalSpeed = airSpeed(entry.node, p, anim.last, dt, world);
677
+ anim.swing += (Math.min(1, speed / 5) - anim.swing) * Math.min(1, dt * 10);
678
+ anim.air += ((Math.abs(verticalSpeed) > 1.2 ? 1 : 0) - anim.air) * Math.min(1, dt * 8);
679
+ anim.phase += Math.min(speed, 8) * 2.4 * dt;
680
+ }
652
681
  const yaw = entry.node.rotation.y;
653
682
  let yawDelta = yaw - (anim.lastYaw ?? yaw);
654
683
  yawDelta = Math.atan2(Math.sin(yawDelta), Math.cos(yawDelta));
@@ -658,7 +687,9 @@ export function animateModelParts(entry, dt) {
658
687
  }
659
688
  anim.last = { x: p.x, y: p.y, z: p.z };
660
689
 
661
- const swing = Math.sin(anim.phase) * 0.8 * anim.swing * (1 - anim.air);
690
+ const swing = gait?.model
691
+ ? Math.sin(anim.phase) * 0.8 * anim.swing * (1 - anim.air) * (anim.amplitudeScale ?? 1)
692
+ : Math.sin(anim.phase) * 0.8 * anim.swing * (1 - anim.air);
662
693
  if (parts.legL) parts.legL.rotation.x = swing + anim.air * -0.55;
663
694
  if (parts.legR) parts.legR.rotation.x = -swing + anim.air * -0.3;
664
695
  if (parts.armL) parts.armL.rotation.x = -swing * 0.75 + anim.air * -1.5;