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
@@ -3,16 +3,7 @@
3
3
  // Behaviors update, the physics3d system steps rapier, then Transforms sync to
4
4
  // three nodes and the composer renders. No game logic here.
5
5
  import React, { useCallback, useEffect, useRef, useState } from 'react';
6
- import { makeScene } from '@imports/castle.physics-2d/engine/scene';
7
- import {
8
- makeWorld3D,
9
- resizeWorld,
10
- syncActors,
11
- renderWorld,
12
- disposeWorld,
13
- updatePhysicsDebug,
14
- } from './world3d';
15
- import { attachOrbitInput } from './orbitinput';
6
+ import { mountScene3D, hudStyles } from './playerRun';
16
7
 
17
8
  export function Scene3DPlayer({
18
9
  sceneData,
@@ -21,6 +12,7 @@ export function Scene3DPlayer({
21
12
  behaviorClasses,
22
13
  scenePath,
23
14
  onFirstFrame,
15
+ onStage,
24
16
  }) {
25
17
  const canvasRef = useRef(null);
26
18
  const scoreRef = useRef(null);
@@ -31,34 +23,21 @@ export function Scene3DPlayer({
31
23
  useEffect(() => {
32
24
  const canvas = canvasRef.current;
33
25
  if (!canvas) return undefined;
34
- const runtime = makeScene(sceneData, behaviorClasses, sprites, files, scenePath);
35
- const world = makeWorld3D(canvas);
36
- runtime.three = world;
37
- runtime.hud = {};
38
- // Scene-independent state: survives `loadFromFile` (the scene data is
39
- // replaced, the runtime instance is not). Player score/inventory and the
40
- // camera angle live here so they cross scene switches.
41
- runtime.persistent = {};
42
- runtime.currentScenePath = scenePath ?? 'scenes/main.scene';
43
- // This loop applies `requestedContent` with `requestedScene` (another
44
- // deck's content, mounted as data); a caller checks before asking.
45
- runtime.mountsContent = true;
46
-
47
- const detachInput = attachInput(canvas, runtime, world);
48
- const stopResize = attachResize(canvas, world);
49
- const onLoopError = (err) => {
50
- console.error(err);
51
- setError(err);
52
- };
53
- const hudRefs = { score: scoreRef, look: lookRef };
54
- const stopLoop = startLoop(runtime, world, sprites, hudRefs, onFirstFrame, onLoopError);
55
- return () => {
56
- stopLoop();
57
- stopResize();
58
- detachInput();
59
- runtime.dispose();
60
- disposeWorld(world);
61
- };
26
+ return mountScene3D({
27
+ canvas,
28
+ sceneData,
29
+ sprites,
30
+ files,
31
+ behaviorClasses,
32
+ scenePath,
33
+ onFirstFrame,
34
+ onStage,
35
+ hudRefs: { score: scoreRef, look: lookRef },
36
+ onLoopError: (err) => {
37
+ console.error(err);
38
+ setError(err);
39
+ },
40
+ });
62
41
  // eslint-disable-next-line react-hooks/exhaustive-deps
63
42
  }, [runId]);
64
43
 
@@ -83,250 +62,13 @@ export function Scene3DPlayer({
83
62
  WebkitTouchCallout: 'none',
84
63
  }}
85
64
  />
86
- <div ref={scoreRef} style={hudStyles.score} />
87
- <div ref={lookRef} style={hudStyles.look} />
65
+ <div ref={scoreRef} data-engine-hud="score" style={hudStyles.score} />
66
+ <div ref={lookRef} data-engine-hud="look" style={hudStyles.look} />
88
67
  {error ? <LoopErrorOverlay error={error} onRestart={onRestart} /> : null}
89
68
  </div>
90
69
  );
91
70
  }
92
71
 
93
- function attachInput(canvas, runtime, world) {
94
- const onKeyDown = (event) => {
95
- // Space is gameplay (jump); keep it from scrolling the page.
96
- if (event.code === 'Space' && event.target === canvas) event.preventDefault();
97
- if (event.code === 'KeyP' && !event.repeat) {
98
- world.debugLines.visible = !world.debugLines.visible;
99
- }
100
- runtime.keys.add(event.code);
101
- runtime.keys.add(event.key);
102
- };
103
- const onKeyUp = (event) => {
104
- runtime.keys.delete(event.code);
105
- runtime.keys.delete(event.key);
106
- };
107
- // Pointer (mouse or touch) input is multitouch, tracked per pointerId:
108
- // - a DRAG is the virtual stick -- the offset from where the drag started
109
- // maps to a walk direction (drag up = forward). The first pointer to
110
- // travel past the tap slop owns the stick until it lifts.
111
- // - a TAP (down and up quickly without moving much) is a jump, even while
112
- // another finger is dragging. `moveInput.consumeJump()` hands the
113
- // pending tap to the Player behavior exactly once.
114
- // `runtime.moveInput` is what the Player behavior reads.
115
- const STICK_RADIUS_PX = 56;
116
- const TAP_SLOP_PX = 12;
117
- const TAP_MS = 300;
118
- const pointers = new Map();
119
- let stickId = null;
120
- let jumpPending = false;
121
- const move = {
122
- x: 0,
123
- y: 0,
124
- active: false,
125
- consumeJump() {
126
- const had = jumpPending;
127
- jumpPending = false;
128
- return had;
129
- },
130
- };
131
- runtime.moveInput = move;
132
- const clearStick = () => {
133
- stickId = null;
134
- move.active = false;
135
- move.x = 0;
136
- move.y = 0;
137
- };
138
- // A scene that set `"engine": { "camera": { "control": "orbit" } }` beside
139
- // `"follow": "rigid"`: a pointer that goes down in it is orbitinput.js's
140
- // from then until it lifts (or a scene loads). It is made the first time
141
- // a pointer goes down under the key or a Player runs under it
142
- // (`runtime.orbitInput()`), never in a runtime that does not meet the key.
143
- // Without the key each handler below reads one property and goes on as it
144
- // always did.
145
- let orbit = null;
146
- runtime.orbitInput = () =>
147
- (orbit ??= attachOrbitInput(
148
- canvas,
149
- runtime,
150
- move,
151
- () => {
152
- jumpPending = true;
153
- },
154
- { stickRadius: STICK_RADIUS_PX, tapSlop: TAP_SLOP_PX, tapMs: TAP_MS }
155
- ));
156
- const onPointerDown = (event) => {
157
- if (runtime.cameraControl === 'orbit') {
158
- // Fingers that went down before the key (a scene without it was
159
- // loaded then) are let go of here, so they and orbitinput.js never
160
- // both write the stick: the handlers below ignore them from now on.
161
- if (pointers.size > 0 || stickId !== null) {
162
- pointers.clear();
163
- clearStick();
164
- }
165
- return runtime.orbitInput().down(event);
166
- }
167
- canvas.focus();
168
- pointers.set(event.pointerId, {
169
- x: event.clientX,
170
- y: event.clientY,
171
- time: performance.now(),
172
- moved: false,
173
- });
174
- canvas.setPointerCapture(event.pointerId);
175
- };
176
- const onPointerMove = (event) => {
177
- if (orbit?.busy && orbit.move(event)) return;
178
- const p = pointers.get(event.pointerId);
179
- if (!p) return;
180
- const dx = event.clientX - p.x;
181
- const dy = event.clientY - p.y;
182
- if (!p.moved && Math.hypot(dx, dy) > TAP_SLOP_PX) p.moved = true;
183
- // A pointer claims the stick once it is clearly a drag (and nothing else
184
- // holds it) -- so a tapping finger never yanks the walk direction.
185
- if (p.moved && stickId === null) stickId = event.pointerId;
186
- if (stickId !== event.pointerId) return;
187
- const nx = dx / STICK_RADIUS_PX;
188
- const ny = dy / STICK_RADIUS_PX;
189
- const len = Math.hypot(nx, ny);
190
- const scale = len > 1 ? 1 / len : 1;
191
- move.active = true;
192
- move.x = nx * scale;
193
- move.y = ny * scale;
194
- };
195
- const onPointerUp = (event) => {
196
- if (orbit?.busy && orbit.up(event)) return;
197
- const p = pointers.get(event.pointerId);
198
- pointers.delete(event.pointerId);
199
- if (stickId === event.pointerId) clearStick();
200
- if (event.type === 'pointercancel' || !p) return;
201
- if (!p.moved && performance.now() - p.time < TAP_MS) jumpPending = true;
202
- };
203
- window.addEventListener('keydown', onKeyDown);
204
- window.addEventListener('keyup', onKeyUp);
205
- canvas.addEventListener('pointerdown', onPointerDown);
206
- canvas.addEventListener('pointermove', onPointerMove);
207
- canvas.addEventListener('pointerup', onPointerUp);
208
- canvas.addEventListener('pointercancel', onPointerUp);
209
- if (document.hasFocus() || window.parent === window) canvas.focus();
210
- return () => {
211
- window.removeEventListener('keydown', onKeyDown);
212
- window.removeEventListener('keyup', onKeyUp);
213
- canvas.removeEventListener('pointerdown', onPointerDown);
214
- canvas.removeEventListener('pointermove', onPointerMove);
215
- canvas.removeEventListener('pointerup', onPointerUp);
216
- canvas.removeEventListener('pointercancel', onPointerUp);
217
- orbit?.detach();
218
- };
219
- }
220
-
221
- function attachResize(canvas, world) {
222
- const fit = () => resizeWorld(world, canvas.clientWidth, canvas.clientHeight);
223
- const observer = new ResizeObserver(fit);
224
- observer.observe(canvas);
225
- fit();
226
- return () => observer.disconnect();
227
- }
228
-
229
- function startLoop(runtime, world, sprites, hudRefs, onFirstFrame, onError) {
230
- let raf = 0;
231
- let previousTime = performance.now();
232
- let firstFrameSignaled = false;
233
- const tick = (now) => {
234
- const dt = Math.min(0.033, (now - previousTime) / 1000);
235
- previousTime = now;
236
- try {
237
- runtime.update(dt);
238
- // A behavior may have requested a scene switch; apply it here, between
239
- // frames, never mid physics dispatch. The load resets
240
- // registered systems -- the rapier world frees and lazily rebuilds --
241
- // while `runtime.persistent` carries the player's cross-scene state.
242
- if (runtime.requestedScene) {
243
- const next = loadRequestedScene(runtime);
244
- runtime.currentScenePath = next;
245
- runtime.persistent.sceneChangeGraceUntil = runtime.time + 1;
246
- }
247
- syncActors(world, runtime, runtime.sprites ?? sprites, dt);
248
- if (world.debugLines.visible) updatePhysicsDebug(world, runtime.physics3d?.debugRender());
249
- renderWorld(world, runtime);
250
- updateHud(runtime, hudRefs);
251
- } catch (err) {
252
- onError?.(err);
253
- return;
254
- }
255
- if (!firstFrameSignaled) {
256
- firstFrameSignaled = true;
257
- requestAnimationFrame(() => onFirstFrame?.());
258
- }
259
- raf = requestAnimationFrame(tick);
260
- };
261
- raf = requestAnimationFrame(tick);
262
- return () => cancelAnimationFrame(raf);
263
- }
264
-
265
- // Load the scene a behavior asked for, with the content it comes from when
266
- // that is another deck's (a hub content pack; `null` puts this deck's own
267
- // back). Content that fails to load puts the scene that was running back and
268
- // leaves the error on `runtime.mountError` for the asker. Returns the path now
269
- // loaded.
270
- function loadRequestedScene(runtime) {
271
- const next = runtime.requestedScene;
272
- runtime.requestedScene = null;
273
- if (runtime.requestedContent === undefined) {
274
- runtime.loadFromFile(next);
275
- return next;
276
- }
277
- const before = { content: runtime.content ?? null, path: runtime.currentScenePath };
278
- runtime.setContent(runtime.requestedContent);
279
- runtime.requestedContent = undefined;
280
- try {
281
- runtime.loadFromFile(next);
282
- return next;
283
- } catch (err) {
284
- console.error('[engine] content failed to load; staying where we were', err);
285
- runtime.setContent(before.content);
286
- runtime.loadFromFile(before.path);
287
- runtime.mountError = err;
288
- return before.path;
289
- }
290
- }
291
-
292
- // Behaviors write `scene.hud = { score, look }`; the loop pushes it into the
293
- // overlay divs imperatively (no react re-render at frame rate).
294
- function updateHud(runtime, hudRefs) {
295
- const hud = runtime.hud ?? {};
296
- const scoreText = hud.score ? String(hud.score) : '';
297
- const lookText = hud.look ?? '';
298
- if (hudRefs.score.current && hudRefs.score.current.textContent !== scoreText) {
299
- hudRefs.score.current.textContent = scoreText;
300
- }
301
- if (hudRefs.look.current && hudRefs.look.current.textContent !== lookText) {
302
- hudRefs.look.current.textContent = lookText;
303
- }
304
- }
305
-
306
- const hudStyles = {
307
- score: {
308
- position: 'absolute',
309
- top: 14,
310
- left: 16,
311
- color: '#7bd9ed',
312
- font: "16px/1.4 'SFMono-Regular', Consolas, monospace",
313
- textShadow: '0 1px 2px rgba(0,0,0,0.8)',
314
- pointerEvents: 'none',
315
- },
316
- look: {
317
- position: 'absolute',
318
- bottom: 22,
319
- left: 0,
320
- right: 0,
321
- textAlign: 'center',
322
- color: '#e6e6e2',
323
- fontStyle: 'italic',
324
- font: 'italic 15px/1.4 Georgia, serif',
325
- textShadow: '0 1px 3px rgba(0,0,0,0.9)',
326
- pointerEvents: 'none',
327
- },
328
- };
329
-
330
72
  function LoopErrorOverlay({ error, onRestart }) {
331
73
  return (
332
74
  <div
@@ -59,6 +59,7 @@ export class ActorNode extends THREE.Group {
59
59
  }
60
60
 
61
61
  updateMatrixWorld(force) {
62
+ if (this.frozenStatic === true) return;
62
63
  // While the scene playing did not ask it is Group's method, after one
63
64
  // test; a record left from a scene that did is dropped on the way.
64
65
  if (!this.skipping.on) {
@@ -251,3 +252,89 @@ function write(object, record) {
251
252
  }
252
253
  record.sizes[index] = at - index;
253
254
  }
255
+
256
+ //
257
+ // Scenes that set `"engine": { "staticActors": true }`
258
+ //
259
+ // The node of an actor the scene's runtime holds still (world3d.js has the
260
+ // rule) stops asking, frame after frame, whether its subtree reads as it did:
261
+ // it is frozen. It gets there by its own check, never by being told: the world
262
+ // only says that a node may freeze (`freezeWhenUnchanged`), and the node
263
+ // freezes the next time the walk above finds it unchanged. From then on its
264
+ // `updateMatrixWorld` asks one thing and returns: is the node under the parent
265
+ // it was frozen under, and is that parent's world matrix, as three.js has
266
+ // just left it, the one the node's matrices were computed from? While that
267
+ // holds they stay as the walk left them, whether or not the node was out of
268
+ // the scene in between (hub-game takes far nodes out and puts them back under
269
+ // the same parent). The parent is asked on every walk, by whoever walks (a
270
+ // draw, or deck code calling `updateMatrixWorld`), because the scene can be
271
+ // moved by anything at any time and three.js computes a parent's world
272
+ // matrix before it walks the children: so the answer is about the very
273
+ // matrix this walk would multiply by, however it came to be (position,
274
+ // quaternion or scale set, the local or world matrix written by hand, the
275
+ // update flags, a parent of the scene's own). Nothing is predicted. When the
276
+ // parent or its matrix differs the node takes ActorNode's own check, which
277
+ // computes it again.
278
+ //
279
+ // What says a node is frozen is two numbers on it and one on the world's
280
+ // `skipping`: `freezes` and `frozenAt`, each the `skipping.epoch` it was
281
+ // written at. The world moves the epoch whenever anything a frozen node's
282
+ // matrices rest on may have changed, which thaws every node of the world at
283
+ // once, attached or not, with nothing to visit; a node thawed that way puts
284
+ // ActorNode's own method back the next time it is asked. And a frozen node is
285
+ // only frozen while no scene's still set has changed since the world adopted
286
+ // its own (`skipping.clock()`, the runtime's `stillClock`, against
287
+ // `skipping.clockAt`): `scene.touch` thaws at once, so an actor touched and
288
+ // then posed is followed by the very next walk, whoever makes it. Nothing here is
289
+ // reached unless a world calls `freezeWhenUnchanged`.
290
+
291
+ // `updateMatrixWorld` for a node that may freeze, set on the node itself over
292
+ // ActorNode's.
293
+ function updateMatrixWorldFreezing(force) {
294
+ const skipping = this.skipping;
295
+ if (skipping.on && this.frozenAt === skipping.epoch && skipping.clock() === skipping.clockAt && sameParent(this.parent, this.computedFrom)) {
296
+ return;
297
+ }
298
+ if (!skipping.on || this.freezes !== skipping.epoch) {
299
+ // The wish is of another epoch: an ActorNode again, and for good.
300
+ delete this.updateMatrixWorld;
301
+ delete this.freezes;
302
+ delete this.frozenAt;
303
+ this.updateMatrixWorld(force);
304
+ return;
305
+ }
306
+ const from = this.computedFrom;
307
+ if (from !== null && unchanged(this, from)) {
308
+ this.frozenAt = skipping.epoch;
309
+ return;
310
+ }
311
+ baseGroupUpdateMatrixWorld.call(this, force);
312
+ this.computedFrom = remember(this, from);
313
+ }
314
+
315
+ const baseGroupUpdateMatrixWorld = THREE.Group.prototype.updateMatrixWorld;
316
+
317
+ // Lets `node` freeze once its own check finds it unchanged, for as long as
318
+ // `node.skipping.epoch` stays what it is now.
319
+ export function freezeWhenUnchanged(node) {
320
+ if (node.freezes === node.skipping.epoch) return;
321
+ node.freezes = node.skipping.epoch;
322
+ node.frozenAt = undefined;
323
+ node.updateMatrixWorld = updateMatrixWorldFreezing;
324
+ }
325
+
326
+ // Whether `node` is frozen now (its parent aside, which it asks on each walk).
327
+ export function isFrozen(node) {
328
+ const skipping = node.skipping;
329
+ return skipping?.on === true && node.frozenAt !== undefined && node.frozenAt === skipping.epoch && skipping.clock() === skipping.clockAt;
330
+ }
331
+
332
+ // Whether the objects under `node`, and `node` itself, read as the last walk
333
+ // recorded them (its parent is not looked at: a node taken out of the scene is
334
+ // still itself). False for a node no walk has recorded. For an audit.
335
+ export function subtreeIsAsRecorded(node) {
336
+ const from = node.computedFrom;
337
+ if (!from) return false;
338
+ at = 0;
339
+ return sameSubtree(node, true, from) && at === from.ids.length;
340
+ }
@@ -0,0 +1,23 @@
1
+ // One cadence for the composed biped and authored-motion pose.
2
+ // A skipped frame must leave both passes untouched, and waking flushes time.
3
+ export function animationDt(entry, dt) {
4
+ const every = entry.node.userData.animationEvery;
5
+ const pending = entry.animationElapsed ?? 0;
6
+ if (!(Number.isFinite(every) && every > 0) || !(dt > 0)) {
7
+ if (entry.animationCadence !== undefined) {
8
+ delete entry.animationCadence;
9
+ delete entry.animationElapsed;
10
+ }
11
+ return dt > 0 ? dt + pending : dt;
12
+ }
13
+ if (entry.animationCadence !== every) {
14
+ entry.animationCadence = every;
15
+ entry.animationElapsed = 0;
16
+ return dt + pending;
17
+ }
18
+ entry.animationElapsed = pending + dt;
19
+ if (entry.animationElapsed + 1e-9 < every) return null;
20
+ const elapsed = entry.animationElapsed;
21
+ entry.animationElapsed = 0;
22
+ return elapsed;
23
+ }
@@ -6,6 +6,7 @@
6
6
  // Every random choice comes from a generator seeded by `seed`, so the same
7
7
  // fields always give the same shape.
8
8
 
9
+ import { seededRandom } from './modelMath';
9
10
  import * as THREE from 'three';
10
11
 
11
12
  const DEG = Math.PI / 180;
@@ -18,17 +19,6 @@ const CONTROL_SEGMENTS = 4;
18
19
  // A branch is `points` (its control points), `radiusStart` and `radiusEnd`,
19
20
  // its `level` (0 for the trunk) and `fork`, true when it splits at its end.
20
21
 
21
- // A small seeded random number generator (mulberry32) returning [0, 1).
22
- function seededRandom(seed) {
23
- let state = Math.round(seed * 9973 + 17) | 0;
24
- return () => {
25
- state = (state + 0x6d2b79f5) | 0;
26
- let t = Math.imul(state ^ (state >>> 15), 1 | state);
27
- t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
28
- return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
29
- };
30
- }
31
-
32
22
  function number(value, fallback, min, max) {
33
23
  if (!Number.isFinite(value)) {
34
24
  return fallback;
@@ -90,7 +80,7 @@ function turnAway(direction, angle, azimuth) {
90
80
  // last level, it forks into `split` children spread evenly around it at about
91
81
  // `spread` from its direction.
92
82
  export function growBranches(settings) {
93
- const random = seededRandom(settings.seed);
83
+ const random = seededRandom(settings.seed, 17);
94
84
  const branches = [];
95
85
  const queue = [
96
86
  {
@@ -273,7 +263,7 @@ export function placeTips(part, group, groups, copyOf) {
273
263
  return;
274
264
  }
275
265
  mesh.updateMatrix();
276
- const random = seededRandom((Number.isFinite(part.seed) ? part.seed : 1) + 101);
266
+ const random = seededRandom((Number.isFinite(part.seed) ? part.seed : 1) + 101, 17);
277
267
  const spin = new THREE.Quaternion();
278
268
  for (const tip of tips) {
279
269
  const holder = new THREE.Group();
@@ -9,6 +9,7 @@
9
9
  // Catmull-Clark rule that many times, and the result becomes an indexed
10
10
  // geometry with shared, smoothly shaded vertices.
11
11
 
12
+ import { average as averagePoints } from './modelMath';
12
13
  import * as THREE from 'three';
13
14
  import { SEAM, applyOps, boxCage, creaseEdges, edgeKey } from './cageops';
14
15
  import { subdivideSteps } from './optimize';
@@ -297,13 +298,7 @@ function mix(a, b, t) {
297
298
  }
298
299
 
299
300
  function average(points) {
300
- const sum = [0, 0, 0];
301
- for (const point of points) {
302
- sum[0] += point[0];
303
- sum[1] += point[1];
304
- sum[2] += point[2] ?? 0;
305
- }
306
- return sum.map((value) => value / Math.max(1, points.length));
301
+ return averagePoints(points, true);
307
302
  }
308
303
 
309
304
  //
@@ -7,6 +7,8 @@
7
7
  // nothing.
8
8
 
9
9
  // Points closer than this to x = 0 are on the mirror seam of a symmetric cage.
10
+ import { average, clampInt } from './modelMath';
11
+
10
12
  export const SEAM = 1e-4;
11
13
 
12
14
  // A hard crease stays sharp for this many subdivision steps, more than a part
@@ -466,16 +468,6 @@ function eachEdge(face, visit) {
466
468
  face.forEach((a, i) => visit(a, face[(i + 1) % face.length]));
467
469
  }
468
470
 
469
- function average(points) {
470
- const sum = [0, 0, 0];
471
- for (const point of points) {
472
- sum[0] += point[0];
473
- sum[1] += point[1];
474
- sum[2] += point[2];
475
- }
476
- return sum.map((value) => value / Math.max(1, points.length));
477
- }
478
-
479
471
  function normalize(v) {
480
472
  const length = Math.hypot(v[0], v[1], v[2]);
481
473
  return length > 0 ? v.map((value) => value / length) : [0, 0, 0];
@@ -507,10 +499,3 @@ function scaleVector(value) {
507
499
  }
508
500
  return vector3(value, [1, 1, 1]);
509
501
  }
510
-
511
- function clampInt(value, min, max, fallback) {
512
- if (!Number.isFinite(value)) {
513
- return fallback;
514
- }
515
- return Math.max(min, Math.min(max, Math.round(value)));
516
- }
@@ -0,0 +1,12 @@
1
+ // Canonical data behaviours and their generated play mirrors register their
2
+ // exact classes here. The mirror generator preserves module-level calls and
3
+ // relocates their imports to this same module, without importing inspectors.
4
+ const dataBehaviors = new WeakSet();
5
+
6
+ export function registerDataBehavior(Behavior) {
7
+ dataBehaviors.add(Behavior);
8
+ }
9
+
10
+ export function isDataBehavior(name, Behavior) {
11
+ return dataBehaviors.has(Behavior) && Behavior.behaviorName === name;
12
+ }
@@ -8,12 +8,17 @@ import * as THREE from 'three';
8
8
  import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
9
9
  import { TransformControls } from 'three/examples/jsm/controls/TransformControls.js';
10
10
  import { makeWorld3D, resizeWorld, syncActors, renderWorld, disposeWorld } from './world3d';
11
+ import { forgetEmptyNodes } from './emptynodes';
11
12
  import { makeScene } from '@imports/castle.physics-2d/engine/scene';
12
13
 
13
14
  const CLICK_SLOP_PX = 5;
14
15
 
15
16
  export function createEditorWorld(canvas, callbacks) {
16
17
  const world = makeWorld3D(canvas);
18
+ // The editor changes actors as it pleases: nothing is held still here,
19
+ // whatever the scene's `engine.staticActors` says (world3d.js).
20
+ world.staticActorsOff = true;
21
+ world.skipEmptyNodesOff = true;
17
22
  world.camera.position.set(11, 10, 11);
18
23
 
19
24
  const orbit = new OrbitControls(world.camera, canvas);
@@ -239,6 +244,7 @@ function startEditorLoop(ed) {
239
244
  ed.resizeObserver.observe(ed.canvas);
240
245
  fit();
241
246
  const tick = () => {
247
+ if (ed.world.emptyNodes) forgetEmptyNodes(ed.world, true);
242
248
  ed.orbit.update();
243
249
  if (ed.runtime) syncActors(ed.world, ed.runtime, ed.sprites);
244
250
  syncGizmo(ed);