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,406 @@
1
+ // Generated from ../../behaviors/Sprite.jsx; run npm run sync:play-behaviors.
2
+ import { resolveDeckFile } from 'castle-web-sdk';
3
+ import { artFrameCount, isImageArt, renderDisplayFrame } from '../../engine/art';
4
+ import { isVectorRenderer } from '../../engine/pxart';
5
+ import { spriteDestRect } from '../../engine/spriteGeometry';
6
+ import { parseTint, tintCanvas } from '../../behaviors/tint';
7
+ import { paintActorStyle, styleContentBox, styleOpacity } from './Style.js';
8
+
9
+ // Runtime behavior for a deck's 2D art: the pixel-art `.pxart` format, or an
10
+ // image file (png / jpg / gif / webp / svg) the deck uploaded. Both come out of
11
+ // the scene's sprite map the same way (see engine/art.js), so everything below
12
+ // -- draw modes, tint, tiling, the collider's auto-fit -- works on either.
13
+ //
14
+ // It looks up the art, composites the current animation frame into a cached
15
+ // offscreen canvas (tinted), and blits it into the actor's
16
+ // Layout box with smoothing disabled — unless the FILE itself opts into a
17
+ // non-default finish (vector renderer, or `cornerRadius` > 0 on a .pxart
18
+ // asset — not a Sprite prop), in which case the cached canvas holds a
19
+ // supersampled render and gets blitted with smoothing on.
20
+ //
21
+ // Animation plays in `update` and is stored on `this.state.anim` (per-actor,
22
+ // seeded from `static initialState`, kept for the cached instance's life), and
23
+ // mirrored to `actor.runtime.spriteAnim`, the older spelling. In edit-mode
24
+ // previews `update` never runs, so the actor holds frame 0.
25
+ const FALLBACK_FILE = 'drawings/cauldron.sprite';
26
+ class Sprite {
27
+ static behaviorName = 'Sprite';
28
+ static defaultProps = {
29
+ file: FALLBACK_FILE,
30
+ tint: '#ffffffff',
31
+ playing: true,
32
+ tag: '',
33
+ mode: 'cover',
34
+ tileSize: 50,
35
+ };
36
+ // The art's filename, without the folder -- `drawings/` is the same for
37
+ // nearly every sprite and the header has no room to spend on it.
38
+ static summary(props) {
39
+ const file = typeof props.file === 'string' ? props.file : '';
40
+ return file.split('/').pop() ?? '';
41
+ }
42
+ // Tile cell size in card units -- a floor of 1 (0 would divide by zero when
43
+ // laying out the repeat), no ceiling since a deck may tile larger than a card.
44
+ static propertyMeta = {
45
+ tileSize: { min: 1, step: 1 },
46
+ };
47
+ static initialState = { anim: null };
48
+ constructor(props) {
49
+ this.props = props;
50
+ }
51
+ resolveSprite(scene) {
52
+ // `drawings/x.pxart` is this deck's; `@imports/<alias>/drawings/x.pxart` is
53
+ // an import's. (A value inherited from an imported blueprint arrives already
54
+ // resolved against that blueprint's deck -- see engine/blueprint.js.)
55
+ const file = resolveDeckFile(this.props.file);
56
+ return scene.sprites?.[file] ?? scene.sprites?.[FALLBACK_FILE] ?? null;
57
+ }
58
+ update(actor, scene, dt) {
59
+ if (actor.runtime.collected)
60
+ return;
61
+ const sprite = this.resolveSprite(scene);
62
+ if (!sprite)
63
+ return;
64
+ const tag = resolveTag(sprite, this.props.tag);
65
+ const sequence = frameSequence(sprite, tag);
66
+ const anim = ensureAnimState(this.state, sprite, this.props, sequence);
67
+ // Kept as the older spelling -- `actor.runtime.spriteAnim` is where this
68
+ // lived before `this.state`, and a deck may still read the frame from it.
69
+ actor.runtime.spriteAnim = anim;
70
+ if (!this.props.playing) {
71
+ if (anim.done)
72
+ resetAnimState(anim);
73
+ return;
74
+ }
75
+ advanceAnim(anim, sprite, sequence, tag, dt);
76
+ }
77
+ draw(actor, scene, ctx) {
78
+ if (actor.runtime.collected)
79
+ return;
80
+ const layout = actor.components.Layout;
81
+ if (!layout)
82
+ return;
83
+ // Style chrome first so background/border sit behind the blit even when
84
+ // the Style key is after Sprite on the components object.
85
+ paintActorStyle(actor, ctx);
86
+ const sprite = this.resolveSprite(scene);
87
+ if (!sprite)
88
+ return;
89
+ const total = artFrameCount(sprite);
90
+ const frameIndex = Math.min(Math.max(this.state.anim?.frameIndex ?? 0, 0), total - 1);
91
+ const canvas = getSpriteCanvas(sprite, frameIndex, this.props.tint);
92
+ if (!canvas)
93
+ return;
94
+ // `canvas` is a <canvas> for pixel art and may be the <img> itself for an
95
+ // untinted image, so size comes from the art rather than the element.
96
+ const artSize = sprite.resolution;
97
+ const prevSmoothing = ctx.imageSmoothingEnabled;
98
+ // Sprites with a non-default finish are pre-rendered supersampled (see
99
+ // engine/pxartSmooth.js); blit those with smoothing on so downscaling to
100
+ // the Layout box stays antialiased. Plain pixel sprites (grid renderer at
101
+ // radius 0) keep nearest-neighbor blitting. Image files are resampled too
102
+ // -- nearest neighbour is right for pixel art and wrong for a photograph.
103
+ const smoothing = isVectorRenderer(sprite.renderer) || sprite.cornerRadius > 0 || isImageArt(sprite);
104
+ const box = styleContentBox(actor, layout);
105
+ // Snap the destination rect to whole device pixels so tiles that abut
106
+ // exactly in card units (e.g. adjacent 100-unit-wide tiles) land on the
107
+ // same device-pixel edge instead of each getting its own antialiased
108
+ // partial-coverage edge, which otherwise leaves faint hairline seams
109
+ // between them. Rounding each of the four device-space coordinates
110
+ // independently (rather than rounding position+size) is what makes two
111
+ // neighbors sharing a card-unit edge compute and round to the identical
112
+ // device pixel. Skipped when the ctx is rotated/skewed (nonzero b or c,
113
+ // set by the runtime for `Layout.rotation`), since a rotated rect has no
114
+ // axis-aligned device edges to snap to.
115
+ const transform = ctx.getTransform();
116
+ const tiling = this.props.mode === 'tile';
117
+ // `cover` scales the art to fill the box preserving aspect ratio, so `dest`
118
+ // overflows the Layout box and the overflow must be clipped to the box.
119
+ const covering = this.props.mode === 'cover';
120
+ // Everything downstream (snapping, tiling's clip box) works off `dest`: the
121
+ // Layout box itself for every mode except `fit`/`cover`, which resize to the
122
+ // art's own aspect ratio (see `spriteDestRect`).
123
+ const dest = spriteDestRect(this.props.mode, box, artSize);
124
+ ctx.save();
125
+ ctx.globalAlpha *= styleOpacity(actor);
126
+ if (transform.b === 0 && transform.c === 0) {
127
+ const x0 = dest.x * transform.a + transform.e;
128
+ const y0 = dest.y * transform.d + transform.f;
129
+ const x1 = (dest.x + dest.width) * transform.a + transform.e;
130
+ const y1 = (dest.y + dest.height) * transform.d + transform.f;
131
+ const rx0 = Math.round(x0);
132
+ const ry0 = Math.round(y0);
133
+ const rx1 = Math.round(x1);
134
+ const ry1 = Math.round(y1);
135
+ ctx.save();
136
+ ctx.setTransform(1, 0, 0, 1, 0, 0);
137
+ ctx.imageSmoothingEnabled = smoothing;
138
+ if (tiling) {
139
+ drawTilesSnapped(ctx, canvas, artSize, this.props.tileSize, dest, transform, x0, y0, rx0, ry0, rx1, ry1);
140
+ }
141
+ else {
142
+ // Clip cover's overflow to the snapped content box (undone by restore).
143
+ if (covering) {
144
+ const lx0 = Math.round(box.x * transform.a + transform.e);
145
+ const ly0 = Math.round(box.y * transform.d + transform.f);
146
+ const lx1 = Math.round((box.x + box.width) * transform.a + transform.e);
147
+ const ly1 = Math.round((box.y + box.height) * transform.d + transform.f);
148
+ ctx.beginPath();
149
+ ctx.rect(lx0, ly0, lx1 - lx0, ly1 - ly0);
150
+ ctx.clip();
151
+ }
152
+ ctx.drawImage(canvas, rx0, ry0, rx1 - rx0, ry1 - ry0);
153
+ }
154
+ ctx.restore();
155
+ }
156
+ else {
157
+ ctx.imageSmoothingEnabled = smoothing;
158
+ if (tiling) {
159
+ drawTilesUnsnapped(ctx, canvas, artSize, this.props.tileSize, dest);
160
+ }
161
+ else if (covering) {
162
+ // Rotated: clip cover's overflow to the content box in card units.
163
+ ctx.save();
164
+ ctx.beginPath();
165
+ ctx.rect(box.x, box.y, box.width, box.height);
166
+ ctx.clip();
167
+ ctx.drawImage(canvas, dest.x, dest.y, dest.width, dest.height);
168
+ ctx.restore();
169
+ }
170
+ else {
171
+ ctx.drawImage(canvas, dest.x, dest.y, dest.width, dest.height);
172
+ }
173
+ ctx.imageSmoothingEnabled = prevSmoothing;
174
+ }
175
+ ctx.restore();
176
+ }
177
+ }
178
+ // Guard against non-finite or non-positive tileSize props (e.g. cleared
179
+ // inspector fields), falling back to one 50-unit grid cell.
180
+ function validTileSize(value) {
181
+ return Number.isFinite(value) && value > 0 ? value : 50;
182
+ }
183
+ // Repeat the sprite in device space, clipped to the snapped box. Tile edges
184
+ // are rounded independently from the box's unrounded device origin (x0/y0)
185
+ // using the same per-edge-rounding discipline as the box snap in `draw`, so
186
+ // neighboring tiles within this actor land on identical device pixels with
187
+ // no hairline seams.
188
+ function drawTilesSnapped(ctx, canvas, artSize, tileSize, dest, transform, x0, y0, rx0, ry0, rx1, ry1) {
189
+ const cellHeight = validTileSize(tileSize);
190
+ const cellWidth = cellHeight * (artSize.width / artSize.height);
191
+ const cellDeviceWidth = cellWidth * transform.a;
192
+ const cellDeviceHeight = cellHeight * transform.d;
193
+ const cols = Math.ceil(dest.width / cellWidth);
194
+ const rows = Math.ceil(dest.height / cellHeight);
195
+ ctx.save();
196
+ ctx.beginPath();
197
+ ctx.rect(rx0, ry0, rx1 - rx0, ry1 - ry0);
198
+ ctx.clip();
199
+ for (let row = 0; row < rows; row++) {
200
+ const edgeY0 = Math.round(y0 + row * cellDeviceHeight);
201
+ const edgeY1 = Math.round(y0 + (row + 1) * cellDeviceHeight);
202
+ for (let col = 0; col < cols; col++) {
203
+ const edgeX0 = Math.round(x0 + col * cellDeviceWidth);
204
+ const edgeX1 = Math.round(x0 + (col + 1) * cellDeviceWidth);
205
+ ctx.drawImage(canvas, edgeX0, edgeY0, edgeX1 - edgeX0, edgeY1 - edgeY0);
206
+ }
207
+ }
208
+ ctx.restore();
209
+ }
210
+ // Rotated actors have no axis-aligned device edges to snap to, so tile
211
+ // unsnapped in card units, matching the unsnapped stretch fallback in `draw`.
212
+ function drawTilesUnsnapped(ctx, canvas, artSize, tileSize, dest) {
213
+ const cellHeight = validTileSize(tileSize);
214
+ const cellWidth = cellHeight * (artSize.width / artSize.height);
215
+ const cols = Math.ceil(dest.width / cellWidth);
216
+ const rows = Math.ceil(dest.height / cellHeight);
217
+ ctx.save();
218
+ ctx.beginPath();
219
+ ctx.rect(dest.x, dest.y, dest.width, dest.height);
220
+ ctx.clip();
221
+ for (let row = 0; row < rows; row++) {
222
+ const ty = dest.y + row * cellHeight;
223
+ for (let col = 0; col < cols; col++) {
224
+ const tx = dest.x + col * cellWidth;
225
+ ctx.drawImage(canvas, tx, ty, cellWidth, cellHeight);
226
+ }
227
+ }
228
+ ctx.restore();
229
+ }
230
+ // Cache of native-resolution offscreen canvases keyed by sprite, then by
231
+ // `${frameIndex}|${tint}`. A sprite edit produces a fresh Sprite object, so a
232
+ // new object naturally misses the WeakMap and rebuilds.
233
+ const spriteCanvasCache = new WeakMap();
234
+ // Ceiling on a cached sprite bitmap's long side. Nothing is ever rasterized
235
+ // larger than the card itself -- 500x700 card units, times the display's pixel
236
+ // ratio -- so this is roughly the card at 3x, and a copy bigger than it holds
237
+ // detail that no draw can show. It only ever bites uploaded photos: `.pxart`
238
+ // caps at 512 (RESOLUTION_MAX), and a 4000x3000 photo goes from a 46 MB cached
239
+ // canvas to 12 MB with nothing visibly different.
240
+ const MAX_CACHE_LONG_SIDE = 2048;
241
+ // The raster this frame is drawn from, at its own natural size: the decoded
242
+ // <img> for an image, a freshly rendered canvas for pixel art. Null while an
243
+ // image is still downloading.
244
+ function frameSource(sprite, frameIndex) {
245
+ if (isImageArt(sprite))
246
+ return sprite.ready ? sprite.image : null;
247
+ const canvas = document.createElement('canvas');
248
+ return renderDisplayFrame(sprite, frameIndex, canvas) ? canvas : null;
249
+ }
250
+ function sourceSize(source) {
251
+ return {
252
+ width: source.naturalWidth || source.width,
253
+ height: source.naturalHeight || source.height,
254
+ };
255
+ }
256
+ // `size` shrunk to fit MAX_CACHE_LONG_SIDE, keeping the aspect ratio. Returned
257
+ // unchanged when it already fits, which is the case for everything but a large
258
+ // uploaded image (so no pixel art is ever resampled by this).
259
+ function cappedSize({ width, height }) {
260
+ const longest = Math.max(width, height);
261
+ if (longest <= MAX_CACHE_LONG_SIDE)
262
+ return { width, height };
263
+ const scale = MAX_CACHE_LONG_SIDE / longest;
264
+ return {
265
+ width: Math.max(1, Math.round(width * scale)),
266
+ height: Math.max(1, Math.round(height * scale)),
267
+ };
268
+ }
269
+ // The drawable source for one frame: a cached offscreen canvas, or -- for an
270
+ // untinted image -- the decoded <img> itself, since copying it into a canvas
271
+ // would buy nothing and cost a full-resolution bitmap. Null while an image is
272
+ // still downloading; the caller skips the draw and picks it up next frame.
273
+ function getSpriteCanvas(sprite, frameIndex, tint) {
274
+ const tintRgba = parseTint(tint);
275
+ if (isImageArt(sprite)) {
276
+ if (!sprite.ready)
277
+ return null;
278
+ if (!tintRgba)
279
+ return sprite.image;
280
+ }
281
+ const key = `${frameIndex}|${tint ?? ''}`;
282
+ let byKey = spriteCanvasCache.get(sprite);
283
+ if (!byKey) {
284
+ byKey = new Map();
285
+ spriteCanvasCache.set(sprite, byKey);
286
+ }
287
+ const cached = byKey.get(key);
288
+ if (cached)
289
+ return cached;
290
+ const source = frameSource(sprite, frameIndex);
291
+ // Nothing to render yet -- don't cache the blank.
292
+ if (!source)
293
+ return null;
294
+ const natural = sourceSize(source);
295
+ const size = cappedSize(natural);
296
+ // A copy is only worth making when it changes something: a tint to apply, or
297
+ // a bitmap too big to keep at full size. Otherwise the render IS the cache.
298
+ if (!tintRgba && size.width === natural.width) {
299
+ byKey.set(key, source);
300
+ return source;
301
+ }
302
+ const canvas = document.createElement('canvas');
303
+ canvas.width = size.width;
304
+ canvas.height = size.height;
305
+ const ctx = canvas.getContext('2d');
306
+ if (!ctx)
307
+ return null;
308
+ ctx.drawImage(source, 0, 0, size.width, size.height);
309
+ if (tintRgba)
310
+ tintCanvas(canvas, source, tintRgba);
311
+ byKey.set(key, canvas);
312
+ return canvas;
313
+ }
314
+ // Resolve the active tag: the `tag` prop when it names an existing tag,
315
+ // otherwise the sprite's defaultTag, otherwise null (whole-timeline loop).
316
+ function resolveTag(sprite, tagProp) {
317
+ const name = tagProp || sprite.defaultTag;
318
+ if (!name)
319
+ return null;
320
+ return sprite.tags.find((candidate) => candidate.name === name) ?? null;
321
+ }
322
+ // The ordered list of frame indices to step through, honoring the tag range and
323
+ // direction. No tag => the whole timeline, forward.
324
+ function frameSequence(sprite, tag) {
325
+ const total = Math.max(artFrameCount(sprite), 1);
326
+ let from = 0;
327
+ let to = total - 1;
328
+ let direction = 'forward';
329
+ if (tag) {
330
+ from = clampIndex(tag.from, total);
331
+ to = clampIndex(tag.to, total);
332
+ if (from > to)
333
+ [from, to] = [to, from];
334
+ direction = tag.direction;
335
+ }
336
+ if (from === to)
337
+ return [from];
338
+ const forward = [];
339
+ for (let i = from; i <= to; i++)
340
+ forward.push(i);
341
+ if (direction === 'reverse')
342
+ return forward.slice().reverse();
343
+ if (direction === 'pingpong') {
344
+ const back = [];
345
+ for (let i = to - 1; i > from; i--)
346
+ back.push(i);
347
+ return [...forward, ...back];
348
+ }
349
+ return forward;
350
+ }
351
+ function clampIndex(value, total) {
352
+ if (!Number.isInteger(value))
353
+ return 0;
354
+ return Math.min(Math.max(value, 0), total - 1);
355
+ }
356
+ function animKey(props) {
357
+ return `${props.file}|${props.tag ?? ''}`;
358
+ }
359
+ // Reset playback state when the sprite identity or active tag changes.
360
+ function ensureAnimState(state, sprite, props, sequence) {
361
+ const key = animKey(props);
362
+ let anim = state.anim;
363
+ if (!anim || anim.sprite !== sprite || anim.key !== key) {
364
+ anim = { sprite, key, pos: 0, elapsedMs: 0, loops: 0, done: false, frameIndex: sequence[0] };
365
+ state.anim = anim;
366
+ }
367
+ return anim;
368
+ }
369
+ function resetAnimState(state) {
370
+ state.pos = 0;
371
+ state.elapsedMs = 0;
372
+ state.loops = 0;
373
+ state.done = false;
374
+ }
375
+ // Advance the playhead by `dt` seconds, stepping frames by their durationMs and
376
+ // honoring `repeat` (0 = loop forever; otherwise hold the last frame when done).
377
+ function advanceAnim(state, sprite, sequence, tag, dt) {
378
+ if (state.done) {
379
+ state.frameIndex = sequence[state.pos];
380
+ return;
381
+ }
382
+ const repeat = tag ? tag.repeat : 0;
383
+ state.elapsedMs += dt * 1000;
384
+ let guard = 0;
385
+ while (guard++ < 1000) {
386
+ const frame = sequence[state.pos];
387
+ const duration = sprite.frames[frame]?.durationMs ?? sprite.defaultDurationMs;
388
+ if (!(duration > 0) || state.elapsedMs < duration)
389
+ break;
390
+ state.elapsedMs -= duration;
391
+ state.pos += 1;
392
+ if (state.pos >= sequence.length) {
393
+ state.loops += 1;
394
+ if (repeat !== 0 && state.loops >= repeat) {
395
+ state.pos = sequence.length - 1;
396
+ state.done = true;
397
+ state.elapsedMs = 0;
398
+ break;
399
+ }
400
+ state.pos = 0;
401
+ }
402
+ }
403
+ state.frameIndex = sequence[state.pos];
404
+ }
405
+
406
+ export { Sprite };
@@ -0,0 +1,209 @@
1
+ // Generated from ../../behaviors/Style.jsx; run npm run sync:play-behaviors.
2
+ import { layoutRect } from '../../engine/layout';
3
+ import { UNIT } from '../../engine/propertyRanges';
4
+ import { inActorWorldSpace } from '../../engine/physics/controls';
5
+
6
+ // Shared chrome for Text and Sprite: fill, border, radius, padding, drop
7
+ // shadow, and opacity. Draws behind content. Sprite/Video paint this themselves
8
+ // before their blit so Style can't land on top when its key is after theirs in
9
+ // JSON; Text relies on forEachBehavior running Style first.
10
+ // Padding insets Text wrap / Sprite blit; opacity multiplies on Style and is
11
+ // also read by Text/Sprite so content fades with the chrome.
12
+ //
13
+ // Drop shadow mirrors CSS `filter: drop-shadow()`: offset X/Y, blur, color.
14
+ // `shadowColor: ''` means no shadow.
15
+ class Style {
16
+ static behaviorName = 'Style';
17
+ static defaultProps = {
18
+ background: '',
19
+ border: '',
20
+ borderWidth: 0,
21
+ borderRadius: 0,
22
+ padding: 0,
23
+ shadowX: 0,
24
+ shadowY: 0,
25
+ shadowBlur: 0,
26
+ shadowColor: '',
27
+ opacity: 1,
28
+ };
29
+ static propertyMeta = {
30
+ borderWidth: { min: 0, max: 24, step: 0.5 },
31
+ borderRadius: { min: 0, max: 200, step: 1 },
32
+ padding: { min: 0, step: 1 },
33
+ shadowX: { step: 1 },
34
+ shadowY: { step: 1 },
35
+ shadowBlur: { min: 0, max: 64, step: 1 },
36
+ opacity: UNIT,
37
+ };
38
+ constructor(props) {
39
+ this.props = props;
40
+ }
41
+ static summary(props) {
42
+ const bits = [];
43
+ if (props.background)
44
+ bits.push('fill');
45
+ if (props.border && props.borderWidth > 0)
46
+ bits.push('border');
47
+ if (props.borderRadius > 0)
48
+ bits.push(`r${Math.round(props.borderRadius)}`);
49
+ if (resolveShadow(props))
50
+ bits.push('shadow');
51
+ if (props.opacity != null && props.opacity < 1)
52
+ bits.push(`${Math.round(props.opacity * 100)}%`);
53
+ return bits.join(' · ');
54
+ }
55
+ paint(actor, ctx) {
56
+ paintStyleChrome(actor, ctx, this.props);
57
+ }
58
+ // Match Text's world/screen split so chrome stays on the selectable box in
59
+ // edit mode and on the HUD in play. An enabled Sprite/Video paints Style
60
+ // itself before its blit — skip here so we don't cover that blit when Style
61
+ // runs after in component order. A disabled Sprite still needs Style.draw.
62
+ draw(actor, scene, ctx, options) {
63
+ if (contentPaintsStyle(actor))
64
+ return;
65
+ if (actor.components.Text?.space === 'screen') {
66
+ if (!options?.editPlaceholders)
67
+ return;
68
+ inActorWorldSpace(ctx, actor.components.Layout, (g) => this.paint(actor, g));
69
+ return;
70
+ }
71
+ this.paint(actor, ctx);
72
+ }
73
+ drawUi(actor, scene, ctx, options) {
74
+ if (contentPaintsStyle(actor))
75
+ return;
76
+ if (actor.components.Text?.space !== 'screen')
77
+ return;
78
+ if (options?.editPlaceholders)
79
+ return;
80
+ this.paint(actor, ctx);
81
+ }
82
+ }
83
+ /** Paint sibling Style chrome behind content. No-op when Style is absent/off. */
84
+ function paintActorStyle(actor, ctx) {
85
+ const props = actor.components?.Style;
86
+ if (!props || props.$enabled === false)
87
+ return;
88
+ paintStyleChrome(actor, ctx, props);
89
+ }
90
+ function contentPaintsStyle(actor) {
91
+ const sprite = actor.components?.Sprite;
92
+ const video = actor.components?.Video;
93
+ return ((Boolean(sprite) && sprite.$enabled !== false) || (Boolean(video) && video.$enabled !== false));
94
+ }
95
+ function paintStyleChrome(actor, ctx, props) {
96
+ const box = layoutRect(actor.components.Layout);
97
+ if (!box || !props)
98
+ return;
99
+ const { background, border, borderWidth, borderRadius, opacity } = props;
100
+ const alpha = Number.isFinite(opacity) ? Math.min(1, Math.max(0, opacity)) : 1;
101
+ const bw = Math.max(0, Number(borderWidth) || 0);
102
+ const radius = clampRadius(borderRadius, box.width, box.height);
103
+ const shadow = resolveShadow(props);
104
+ const hasFill = Boolean(background);
105
+ const hasBorder = Boolean(border) && bw > 0;
106
+ if (!hasFill && !hasBorder && !shadow)
107
+ return;
108
+ ctx.save();
109
+ ctx.globalAlpha *= alpha;
110
+ if (shadow) {
111
+ ctx.shadowColor = shadow.color;
112
+ ctx.shadowBlur = shadow.blur;
113
+ ctx.shadowOffsetX = shadow.x;
114
+ ctx.shadowOffsetY = shadow.y;
115
+ }
116
+ if (hasFill) {
117
+ ctx.fillStyle = background;
118
+ fillRoundRect(ctx, box.x, box.y, box.width, box.height, radius);
119
+ }
120
+ else if (shadow) {
121
+ // Shadow needs a filled path; use a near-invisible fill when there's no
122
+ // background so the drop shadow still casts.
123
+ ctx.fillStyle = 'rgba(0, 0, 0, 0.01)';
124
+ fillRoundRect(ctx, box.x, box.y, box.width, box.height, radius);
125
+ }
126
+ if (shadow) {
127
+ ctx.shadowColor = 'transparent';
128
+ ctx.shadowBlur = 0;
129
+ ctx.shadowOffsetX = 0;
130
+ ctx.shadowOffsetY = 0;
131
+ }
132
+ if (hasBorder) {
133
+ ctx.strokeStyle = border;
134
+ ctx.lineWidth = bw;
135
+ const inset = bw / 2;
136
+ // Inset the stroke so it sits inside the fill edge; shrink the radius by
137
+ // the same amount so the outer curve still matches the fill's corner.
138
+ strokeRoundRect(ctx, box.x + inset, box.y + inset, Math.max(0, box.width - bw), Math.max(0, box.height - bw), Math.max(0, radius - inset));
139
+ }
140
+ ctx.restore();
141
+ }
142
+ // Non-empty shadowColor enables the drop shadow. Legacy `shadow: true` (pre
143
+ // drop-shadow props) keeps the old soft black defaults so existing decks
144
+ // don't go flat.
145
+ function resolveShadow(props) {
146
+ if (props.shadowColor) {
147
+ return {
148
+ color: props.shadowColor,
149
+ blur: Math.max(0, Number(props.shadowBlur) || 0),
150
+ x: Number(props.shadowX) || 0,
151
+ y: Number(props.shadowY) || 0,
152
+ };
153
+ }
154
+ if (props.shadow) {
155
+ return { color: 'rgba(0, 0, 0, 0.35)', blur: 14, x: 0, y: 5 };
156
+ }
157
+ return null;
158
+ }
159
+ function clampRadius(value, width, height) {
160
+ const r = Math.max(0, Number(value) || 0);
161
+ if (!(width > 0) || !(height > 0))
162
+ return 0;
163
+ return Math.min(r, width / 2, height / 2);
164
+ }
165
+ function roundRectPath(ctx, x, y, width, height, radius) {
166
+ ctx.beginPath();
167
+ if (radius > 0 && ctx.roundRect)
168
+ ctx.roundRect(x, y, width, height, radius);
169
+ else
170
+ ctx.rect(x, y, width, height);
171
+ }
172
+ function fillRoundRect(ctx, x, y, width, height, radius) {
173
+ roundRectPath(ctx, x, y, width, height, radius);
174
+ ctx.fill();
175
+ }
176
+ function strokeRoundRect(ctx, x, y, width, height, radius) {
177
+ roundRectPath(ctx, x, y, width, height, radius);
178
+ ctx.stroke();
179
+ }
180
+ /** Padding from a sibling Style, or 0. */
181
+ function stylePadding(actor) {
182
+ const pad = actor.components.Style?.padding;
183
+ return Number.isFinite(pad) ? Math.max(0, pad) : 0;
184
+ }
185
+ /**
186
+ * The world-space rect content draws into: the actor's Layout box (origin
187
+ * applied) inset by Style.padding. Always a real rect, never the `layout`
188
+ * component itself -- callers read `.x`/`.y` as a top-left, which a Layout with
189
+ * a non-zero origin is not.
190
+ */
191
+ function styleContentBox(actor, layout) {
192
+ const box = layoutRect(layout);
193
+ const pad = stylePadding(actor);
194
+ if (!box || !(pad > 0))
195
+ return box;
196
+ return {
197
+ x: box.x + pad,
198
+ y: box.y + pad,
199
+ width: Math.max(0, box.width - pad * 2),
200
+ height: Math.max(0, box.height - pad * 2),
201
+ };
202
+ }
203
+ /** Opacity from a sibling Style, or 1. */
204
+ function styleOpacity(actor) {
205
+ const opacity = actor.components.Style?.opacity;
206
+ return Number.isFinite(opacity) ? Math.min(1, Math.max(0, opacity)) : 1;
207
+ }
208
+
209
+ export { Style, paintActorStyle, styleContentBox, styleOpacity, stylePadding };