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,85 @@
1
+ // Generated from ../../behaviors/Text.jsx; run npm run sync:play-behaviors.
2
+ import { layoutRect } from '../../engine/layout';
3
+ import { drawTextBlock } from '../../engine/text';
4
+ import { resolveTextFont } from '../../engine/fonts';
5
+ import { inActorWorldSpace } from '../../engine/physics/controls';
6
+ import { styleOpacity, stylePadding } from './Style.js';
7
+
8
+ // In-scene (or screen-fixed) text drawn into the Layout box. Word-wraps to the
9
+ // box minus Style.padding; lines may overflow vertically with no clipping.
10
+ // Colors are opaque deck-palette hexes. Chrome (fill/border/shadow/opacity)
11
+ // lives on the sibling Style behavior. Dynamic text is
12
+ // `actor.components.Text.text = …` from deck code — no $var interpolation.
13
+ class Text {
14
+ static behaviorName = 'Text';
15
+ static defaultProps = {
16
+ text: 'Your text goes here',
17
+ font: '',
18
+ size: 24,
19
+ color: '#131313',
20
+ align: 'left',
21
+ verticalAlign: 'top',
22
+ lineHeight: 1.25,
23
+ space: 'world',
24
+ outlineWidth: 0,
25
+ outlineColor: '#ffffff',
26
+ };
27
+ static propertyMeta = {
28
+ size: { min: 4, max: 160, step: 1 },
29
+ lineHeight: { min: 0.8, max: 3, step: 0.05 },
30
+ outlineWidth: { min: 0, max: 12, step: 0.5 },
31
+ };
32
+ constructor(props) {
33
+ this.props = props;
34
+ }
35
+ static summary(props) {
36
+ const first = String(props?.text ?? '').split(/\r?\n/)[0] ?? '';
37
+ return first;
38
+ }
39
+ paint(actor, scene, ctx) {
40
+ const box = layoutRect(actor.components.Layout);
41
+ if (!box)
42
+ return;
43
+ const { text, font, size, color, align, verticalAlign, lineHeight, outlineWidth, outlineColor, } = this.props;
44
+ ctx.save();
45
+ ctx.globalAlpha *= styleOpacity(actor);
46
+ drawTextBlock(ctx, {
47
+ x: box.x,
48
+ y: box.y,
49
+ width: box.width,
50
+ height: box.height,
51
+ text,
52
+ size,
53
+ font: resolveTextFont(font),
54
+ color,
55
+ align,
56
+ verticalAlign,
57
+ padding: stylePadding(actor),
58
+ lineHeight,
59
+ outlineWidth,
60
+ outlineColor,
61
+ });
62
+ ctx.restore();
63
+ }
64
+ // World-space: paint in the camera+rotation pass. Screen-space in edit mode
65
+ // also paints here (on the selectable Layout box) so pan/zoom don't detach
66
+ // the glyph from its handles — see drawUi for play-mode screen paint.
67
+ draw(actor, scene, ctx, options) {
68
+ if (this.props.space === 'screen') {
69
+ if (!options?.editPlaceholders)
70
+ return;
71
+ inActorWorldSpace(ctx, actor.components.Layout, (g) => this.paint(actor, scene, g));
72
+ return;
73
+ }
74
+ this.paint(actor, scene, ctx);
75
+ }
76
+ drawUi(actor, scene, ctx, options) {
77
+ if (this.props.space !== 'screen')
78
+ return;
79
+ if (options?.editPlaceholders)
80
+ return;
81
+ this.paint(actor, scene, ctx);
82
+ }
83
+ }
84
+
85
+ export { Text };
@@ -0,0 +1,93 @@
1
+ // Generated from ../../behaviors/Video.jsx; run npm run sync:play-behaviors.
2
+ import { resolveDeckFile } from 'castle-web-sdk';
3
+ import { mediaElement, playMedia, stopMedia } from '../../engine/media';
4
+ import { spriteDestRect } from '../../engine/spriteGeometry';
5
+ import { UNIT } from '../../engine/propertyRanges';
6
+ import { paintActorStyle, styleContentBox, styleOpacity } from './Style.js';
7
+
8
+ // Plays a video file (.mp4 / .webm / .mov / .m4v) inside the actor's Layout box.
9
+ //
10
+ // The video is decoded by the browser and blitted into the scene canvas every
11
+ // frame, so it sits in the scene like any other actor: it moves with Layout,
12
+ // rotates, draws in `z` order, and can have a Collider. `mode` frames it in the
13
+ // box the same way a Sprite does (cover / fit / stretch).
14
+ //
15
+ // In the editor it holds its first frame -- `update` is what starts playback and
16
+ // only play mode runs it -- so you can position it against the real picture.
17
+ // Sound is muted by default: an autoplaying video with sound is blocked by
18
+ // browsers, and a muted one isn't.
19
+ class Video {
20
+ static behaviorName = 'Video';
21
+ static defaultProps = {
22
+ file: '',
23
+ mode: 'cover',
24
+ playing: true,
25
+ loop: true,
26
+ muted: true,
27
+ volume: 1,
28
+ };
29
+ static propertyMeta = {
30
+ volume: UNIT,
31
+ };
32
+ constructor(props) {
33
+ this.props = props;
34
+ }
35
+ element(actor) {
36
+ return mediaElement(actor.id, 'video', resolveDeckFile(this.props.file));
37
+ }
38
+ update(actor) {
39
+ if (!actor.runtime || actor.runtime.collected)
40
+ return;
41
+ const element = this.element(actor);
42
+ if (!element)
43
+ return;
44
+ element.loop = Boolean(this.props.loop);
45
+ element.muted = Boolean(this.props.muted);
46
+ element.volume = Number.isFinite(this.props.volume)
47
+ ? Math.min(1, Math.max(0, this.props.volume))
48
+ : 1;
49
+ if (this.props.playing)
50
+ playMedia(element);
51
+ else if (!element.paused)
52
+ element.pause();
53
+ }
54
+ draw(actor, scene, ctx) {
55
+ if (actor.runtime?.collected)
56
+ return;
57
+ const layout = actor.components.Layout;
58
+ if (!layout)
59
+ return;
60
+ paintActorStyle(actor, ctx);
61
+ const element = this.element(actor);
62
+ // HAVE_CURRENT_DATA: there is a frame to draw. Below it the element has
63
+ // nothing decoded yet and drawImage would throw.
64
+ if (!element || element.readyState < 2)
65
+ return;
66
+ const size = { width: element.videoWidth, height: element.videoHeight };
67
+ if (!size.width || !size.height)
68
+ return;
69
+ const box = styleContentBox(actor, layout);
70
+ const dest = spriteDestRect(this.props.mode, box, size);
71
+ const covering = this.props.mode === 'cover';
72
+ ctx.save();
73
+ ctx.globalAlpha *= styleOpacity(actor);
74
+ if (covering) {
75
+ // `cover` fills the box by overflowing it; the overflow is cropped.
76
+ ctx.beginPath();
77
+ ctx.rect(box.x, box.y, box.width, box.height);
78
+ ctx.clip();
79
+ }
80
+ ctx.drawImage(element, dest.x, dest.y, dest.width, dest.height);
81
+ ctx.restore();
82
+ }
83
+ // Used by the inspector's "stop" affordance and by game code that wants the
84
+ // element itself (`scene.getActor('clip').components.Video` is props; this is
85
+ // the live element).
86
+ static stop(actor) {
87
+ const element = mediaElement(actor.id, 'video', actor.components?.Video?.file);
88
+ if (element)
89
+ stopMedia(element);
90
+ }
91
+ }
92
+
93
+ export { Video };
@@ -293,6 +293,331 @@ if (!Other && !process.env.ONLY) {
293
293
  assert.equal(scene.cameraControl, 'orbit', 'on again for a scene that says so');
294
294
  scene.load(data);
295
295
  assert.equal(scene.cameraControl, null, 'and off again for a scene without it');
296
+ // `engine.look.bake`, which the 3d kit reads: latched the same way.
297
+ const later = (engine) => new SceneRuntime({ ...data, engine }, classes, {}, {}).bakesLookLater;
298
+ assert.equal(scene.bakesLookLater, false, 'off unless the scene says so');
299
+ assert.equal(later({ skipUnchangedActors: true, shadows: { distance: 40 }, camera: { follow: 'rigid' } }), false);
300
+ assert.equal(later({ look: { bake: 'deferred' } }), true);
301
+ for (const not of [true, 'deferred', {}, { bake: true }, { bake: 'Deferred' }, { bake: 'sync' }, { bake: null }, null]) {
302
+ assert.equal(later({ look: not }), false, JSON.stringify(not));
303
+ }
304
+ scene.load({ ...data, engine: { look: { bake: 'deferred' } } });
305
+ assert.equal(scene.clone().bakesLookLater, true, 'and by a clone');
306
+ scene.data.engine.look.bake = 'sync';
307
+ assert.equal(scene.bakesLookLater, true, 'read when the scene loads');
308
+ assert.equal(scene.skipsUnchangedActors, false, 'and the one key does not set the others');
309
+ assert.equal(scene.cameraFollowsRigidly, false);
310
+ scene.load(data);
311
+ assert.equal(scene.bakesLookLater, false, 'and is off again for a scene without it');
312
+ // `engine.maxFps`, which the 3d kit's player reads: latched the same way.
313
+ const cap = (engine) => new SceneRuntime({ ...data, engine }, classes, {}, {}).maxFps;
314
+ assert.equal(scene.maxFps, 0, 'off unless the scene says so');
315
+ assert.equal(cap({ skipUnchangedActors: true, shadows: { distance: 40 } }), 0);
316
+ for (const fps of [30, 60, 72.5, 144, 240]) assert.equal(cap({ maxFps: fps }), fps);
317
+ for (const not of ['60', 0, -60, 15, 24, 29.9, 241, 1000, Infinity, NaN, null, true, [60], { fps: 60 }]) {
318
+ assert.equal(cap({ maxFps: not }), 0, JSON.stringify(not));
319
+ }
320
+ scene.load({ ...data, engine: { maxFps: 60, skipUnchangedActors: true } });
321
+ assert.equal(scene.clone().maxFps, 60, 'kept by a clone');
322
+ scene.data.engine.maxFps = 30;
323
+ assert.equal(scene.maxFps, 60, 'read when the scene loads');
324
+ assert.equal(scene.nearShadowDistance, 0, 'and the one key does not set the others');
325
+ assert.equal(scene.skipsUnchangedActors, true);
326
+ scene.load(data);
327
+ assert.equal(scene.maxFps, 0, 'and is off again for a scene without it');
328
+ }
329
+
330
+ // `engine.staticActors`, which the 3d kit reads: latched the same way, on only
331
+ // with `skipUnchangedActors`, and the actors it holds still. `update` calls
332
+ // what it calls without the key.
333
+ let stillChecks = 0;
334
+ if (!Other && !process.env.ONLY) {
335
+ const calls = [];
336
+ const quiet = (name) => class { static behaviorName = name; static defaultProps = {}; };
337
+ const acting = (name, hook = 'update') => {
338
+ const Behavior = quiet(name);
339
+ Behavior.prototype[hook] = function (actor, scene) {
340
+ calls.push(`${scene.tag} ${name}.${hook} ${actor.id}`);
341
+ };
342
+ return Behavior;
343
+ };
344
+ const classes = (quietActs = false) => [quietActs ? acting('Quiet') : quiet('Quiet'), acting('Acts'), acting('Told', 'onEnable'), quiet('Body')];
345
+ const actors = () => [
346
+ { id: 'a', static: true, components: { Quiet: {} } },
347
+ { id: 'b', static: true, components: { Quiet: {}, Acts: {} } },
348
+ { id: 'c', static: true, components: { Quiet: {}, Body: {} } },
349
+ { id: 'd', components: { Quiet: {} } },
350
+ { id: 'e', static: true, components: { Told: {} } },
351
+ { id: 'f', static: false, components: { Quiet: {} } },
352
+ { id: 'g', static: 'true', components: { Quiet: {} } },
353
+ { id: 'h', static: true, components: { Quiet: {}, Unknown: { x: 1 } } },
354
+ ];
355
+ const make = (engine, tag) => {
356
+ const scene = new SceneRuntime({ actors: actors(), engine }, classes(), {}, {});
357
+ scene.tag = tag;
358
+ return scene;
359
+ };
360
+ const still = (scene) => [...(scene.stillActors ?? [])].map((actor) => actor.id).join();
361
+ const both = { skipUnchangedActors: true, staticActors: true };
362
+ for (const not of [{ staticActors: true }, { skipUnchangedActors: true }, { skipUnchangedActors: true, staticActors: 1 }, { skipUnchangedActors: true, staticActors: 'true' }, { skipUnchangedActors: true, staticActors: {} }, {}, undefined]) {
363
+ const scene = make(not, 'off');
364
+ assert.equal(scene.keepsStaticActors, false, JSON.stringify(not));
365
+ assert.equal(scene.stillActors, null, 'and no actor is still');
366
+ scene.touch('a');
367
+ scene.releaseStill();
368
+ assert.equal(scene.stillActors, null, 'a touch does nothing there');
369
+ stillChecks += 3;
370
+ }
371
+ const on = make(both, 'on');
372
+ const off = make({ skipUnchangedActors: true }, 'off');
373
+ assert.equal(on.keepsStaticActors, true);
374
+ assert.equal(still(on), 'a,h', 'marked, no Body, no class that acts: still');
375
+ assert.equal(on.clone().keepsStaticActors, true, 'and by a clone, with a set of its own');
376
+ assert.notEqual(on.clone().stillActors, on.stillActors);
377
+ on.data.engine.staticActors = false;
378
+ assert.equal(on.keepsStaticActors, true, 'read when the scene loads');
379
+ // The same calls, frame for frame, through a touch, a despawn and a change of classes.
380
+ const same = (what) => {
381
+ for (const scene of [off, on]) scene.update(1 / 60);
382
+ const of = (tag) => calls.filter((line) => line.startsWith(`${tag} `)).map((line) => line.slice(tag.length));
383
+ assert.deepEqual(of('on'), of('off'), what);
384
+ stillChecks += 1;
385
+ };
386
+ for (let i = 0; i < 3; i++) same(`frame ${i}`);
387
+ assert.ok(calls.length > 0);
388
+ let version = on.stillVersion;
389
+ on.touch('d');
390
+ on.touch('nobody');
391
+ assert.equal(on.stillVersion, version, 'touching an actor that is not still changes nothing');
392
+ on.touch(on.getActor('a'));
393
+ assert.ok(still(on) === 'h' && on.stillVersion > version, 'a touched actor is not still');
394
+ same('after a touch');
395
+ version = on.stillVersion;
396
+ for (const scene of [off, on]) scene.despawnActor('h');
397
+ assert.ok(still(on) === '' && on.stillVersion > version, 'nor a despawned one');
398
+ for (const scene of [off, on]) scene.spawnActor({ id: 'i', static: true, components: { Quiet: {} } });
399
+ assert.equal(still(on), '', 'a spawned actor is never still');
400
+ same('after a despawn and a spawn');
401
+ for (const scene of [off, on]) scene.setBehaviors(classes(true));
402
+ for (let i = 0; i < 2; i++) same('a class gains an update');
403
+ assert.ok(calls.some((line) => line === 'on Quiet.update a'));
404
+ for (const scene of [off, on]) scene.setBehaviors(classes(false));
405
+ assert.equal(still(on), '', 'what was touched stays so when the classes change back');
406
+ // A load starts again; a scene without the key has none.
407
+ on.load({ actors: actors(), engine: both });
408
+ assert.equal(still(on), 'a,h', 'a load reckons afresh');
409
+ version = on.stillVersion;
410
+ on.releaseStill();
411
+ assert.ok(still(on) === '' && on.stillVersion > version, 'releaseStill touches every one');
412
+ on.setBehaviors(classes(false));
413
+ assert.equal(still(on), '', 'for good');
414
+ on.load({ actors: actors(), engine: { skipUnchangedActors: true } });
415
+ assert.ok(on.stillActors === null && on.keepsStaticActors === false, 'and is off again for a scene without it');
416
+ stillChecks += 16;
417
+
418
+ // The rule (engine/stillClock.js): the still set is adopted only after an
419
+ // ordinary update has completed, behaviours and systems, without throwing;
420
+ // while one is running, or anything it calls back into, nothing is left
421
+ // out; any interruption leaves the next update ordinary. Every way an
422
+ // update can be interrupted, in one that began ordinary (the first after a
423
+ // load) and one that began settled: the update after it visits every
424
+ // actor, the still ones included, and with the key everything is called
425
+ // that is called without it.
426
+ const played = [];
427
+ const say = (scene, text) => played.push(`${scene.tag} ${text}`);
428
+ let plan = {};
429
+ let frame = 0;
430
+ class Made {
431
+ static behaviorName = 'Made';
432
+ static defaultProps = {};
433
+ constructor() {
434
+ played.push(`${Made.tag} Made constructed`);
435
+ }
436
+ }
437
+ const inside = (scene, act) => {
438
+ if (scene.inside) return;
439
+ scene.inside = true;
440
+ try {
441
+ act();
442
+ } finally {
443
+ scene.inside = false;
444
+ }
445
+ };
446
+ class Live {
447
+ static behaviorName = 'Live';
448
+ static defaultProps = {};
449
+ update(actor, scene) {
450
+ say(scene, `Live.update ${actor.id} frame ${frame}`);
451
+ if (scene.inner) {
452
+ if (scene.throwsInside) throw new Error('from the update inside');
453
+ return;
454
+ }
455
+ if (actor.id !== 'first' || frame !== plan.at) return;
456
+ if (plan.touches) scene.touch('z-still');
457
+ if (plan.loads) scene.load(structuredClone(scene.authored));
458
+ if (plan.classes) scene.setBehaviors([Made, Live]);
459
+ if (plan.reenters) {
460
+ inside(scene, () => {
461
+ scene.inner = true;
462
+ scene.throwsInside = plan.reenters === 'throws, caught';
463
+ try {
464
+ scene.update(1 / 60);
465
+ } catch (error) {
466
+ say(scene, `caught ${error.message}`);
467
+ } finally {
468
+ scene.inner = false;
469
+ }
470
+ });
471
+ }
472
+ if (plan.other) scene.other.update(1 / 60);
473
+ if (plan.throws === 'in the loop') throw new Error('from a behaviour');
474
+ }
475
+ }
476
+ const authored = (engine) => ({
477
+ engine,
478
+ actors: [
479
+ { id: 'first', components: { Live: {} } },
480
+ { id: 'a-still', static: true, components: { Made: {} } },
481
+ { id: 'mid', components: { Live: {} } },
482
+ { id: 'z-still', static: true, components: { Made: {} } },
483
+ { id: 'last', components: { Live: {} } },
484
+ ],
485
+ });
486
+ const interruptions = {
487
+ 'a behaviour throws in the loop': { throws: 'in the loop' },
488
+ 'a system throws after the loop': { throws: 'in a system' },
489
+ 'a behaviour updates the scene from inside, which returns': { reenters: 'returns' },
490
+ 'a behaviour updates the scene from inside, which throws and is caught': { reenters: 'throws, caught' },
491
+ "a behaviour updates another runtime from inside (not this runtime's update: it may stay adopted)": { other: true, mayStayAdopted: true },
492
+ 'a behaviour touches a still actor later in the list': { touches: true },
493
+ 'a behaviour touches one and throws': { touches: true, throws: 'in the loop' },
494
+ 'a behaviour loads the scene from inside': { loads: true },
495
+ 'a behaviour changes the classes from inside': { classes: true },
496
+ };
497
+ const table = [];
498
+ for (const [began, at] of [['ordinary', 0], ['settled', 3]]) {
499
+ for (const [what, how] of Object.entries(interruptions)) {
500
+ plan = { ...how, at };
501
+ played.length = 0;
502
+ const visited = { on: [], off: [] };
503
+ // (also what an update entered from inside this one visits)
504
+ for (const tag of ['off', 'on']) {
505
+ const data = authored(tag === 'on' ? both : { skipUnchangedActors: true });
506
+ Made.tag = tag;
507
+ const scene = new SceneRuntime(data, [Made, Live], {}, {});
508
+ scene.tag = tag;
509
+ scene.authored = data;
510
+ scene.other = new SceneRuntime(authored(both), [], {}, {});
511
+ scene.registerSystem({
512
+ afterBehaviors(runtime) {
513
+ say(runtime, `system frame ${frame}`);
514
+ if (frame === plan.at && plan.throws === 'in a system' && !runtime.inner) throw new Error('from a system');
515
+ },
516
+ });
517
+ const each = scene.forEachBehavior.bind(scene);
518
+ scene.forEachBehavior = (actor, callback) => {
519
+ if (frame === at + 1) visited[tag].push(actor.id);
520
+ // An update entered from inside another leaves nobody out.
521
+ if (scene.inner) visited[tag].push(`inside ${actor.id}`);
522
+ return each(actor, callback);
523
+ };
524
+ for (frame = 0; frame < 7; frame++) {
525
+ try {
526
+ scene.update(1 / 60);
527
+ } catch (error) {
528
+ say(scene, `threw ${error.message}`);
529
+ }
530
+ }
531
+ }
532
+ const of = (tag) => played.filter((line) => line.startsWith(`${tag} `)).map((line) => line.slice(tag.length));
533
+ const name = `an update that began ${began}: ${what}`;
534
+ assert.deepEqual(of('on'), of('off'), name);
535
+ assert.ok(of('on').filter((line) => line.includes('constructed')).length >= 2, `${name}: both still actors' instances were made`);
536
+ if (!how.mayStayAdopted) assert.deepEqual(visited.on, visited.off, `${name}: the next update visits every actor`);
537
+ table.push(`${name}: next update visits ${visited.on.length} of ${visited.off.length}`);
538
+ stillChecks += how.mayStayAdopted ? 2 : 3;
539
+ }
540
+ }
541
+ if (process.env.STILL_TABLE) console.log(table.join('\n'));
542
+
543
+ // `update` has no keeper until a scene that asks is loaded, and an update
544
+ // of a scene that does not ask is not seen by one. A behaviour of such a
545
+ // scene loads one that asks, from inside its update, and updates it there:
546
+ // the still set's keeper is the loaded scene's own, the update around it is
547
+ // walking the actors of the scene that was left, and everything is called
548
+ // that is called without the key.
549
+ {
550
+ played.length = 0;
551
+ for (const tag of ['off', 'on']) {
552
+ const next = authored(tag === 'on' ? both : { skipUnchangedActors: true });
553
+ let loaded = false;
554
+ class Loader {
555
+ static behaviorName = 'Loader';
556
+ static defaultProps = {};
557
+ update(actor, scene) {
558
+ say(scene, `Loader.update ${actor.id} frame ${frame}`);
559
+ if (loaded) return;
560
+ loaded = true;
561
+ scene.load(structuredClone(next));
562
+ for (let i = 0; i < 3; i++) scene.update(1 / 60);
563
+ }
564
+ }
565
+ Made.tag = tag;
566
+ plan = {};
567
+ const scene = new SceneRuntime({ engine: { skipUnchangedActors: true }, actors: [{ id: 'loader', components: { Loader: {} } }, { id: 'after', components: { Loader: {} } }] }, [Made, Live, Loader], {}, {});
568
+ scene.tag = tag;
569
+ for (frame = 0; frame < 5; frame++) scene.update(1 / 60);
570
+ }
571
+ const of = (tag) => played.filter((line) => line.startsWith(`${tag} `)).map((line) => line.slice(tag.length));
572
+ assert.deepEqual(of('on'), of('off'), 'a scene that asks, loaded and updated from inside an update of one that does not');
573
+ assert.ok(of('on').filter((line) => line.includes('constructed')).length >= 2);
574
+ stillChecks += 2;
575
+ }
576
+
577
+ // The two repros of a review, as given. (a) A SETTLED loop throws: the next
578
+ // update must not visit only the live actor and skip the marked one. (b) An
579
+ // ordinary loop completes and a registered SYSTEM then throws: the same.
580
+ for (const which of ['a settled loop throws', 'a system throws after an ordinary loop']) {
581
+ const seen = [];
582
+ let throwNow = false;
583
+ class Thrower {
584
+ static behaviorName = 'Thrower';
585
+ static defaultProps = {};
586
+ update() {
587
+ if (throwNow && which === 'a settled loop throws') throw new Error('once');
588
+ }
589
+ }
590
+ class Marked {
591
+ static behaviorName = 'Marked';
592
+ static defaultProps = {};
593
+ }
594
+ const scene = new SceneRuntime({ engine: both, actors: [{ id: 'live', components: { Thrower: {} } }, { id: 'marked', static: true, components: { Marked: {} } }] }, [Thrower, Marked], {}, {});
595
+ scene.registerSystem({
596
+ afterBehaviors() {
597
+ if (throwNow && which !== 'a settled loop throws') throw new Error('once');
598
+ },
599
+ });
600
+ const each = scene.forEachBehavior.bind(scene);
601
+ scene.forEachBehavior = (actor, callback) => {
602
+ seen.push(actor.id);
603
+ return each(actor, callback);
604
+ };
605
+ const update = () => {
606
+ seen.length = 0;
607
+ scene.update(1 / 60);
608
+ return seen.join();
609
+ };
610
+ if (which === 'a settled loop throws') {
611
+ assert.equal(update(), 'live,marked', 'the first update visits both');
612
+ assert.equal(update(), 'live', 'the second is settled');
613
+ }
614
+ throwNow = true;
615
+ assert.throws(update, /once/);
616
+ throwNow = false;
617
+ assert.equal(update(), 'live,marked', `${which}: the next update visits the marked actor too`);
618
+ assert.equal(update(), 'live', 'and the one after that is settled again');
619
+ stillChecks += 3;
620
+ }
296
621
  }
297
622
 
298
- console.log(`skip unchanged: ${scenarios} scenarios call the same hooks with and without the key`);
623
+ console.log(`skip unchanged: ${scenarios} scenarios call the same hooks with and without the key; ${stillChecks} checks of staticActors`);