castle-web-cli 0.4.232 → 0.4.233

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (355) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -407,6 +407,46 @@ const OPERATIONS = {
407
407
  },
408
408
  };
409
409
  export async function runDevStorageOperation(deckId, op, args, connectedUserIds = []) {
410
+ if (args.place !== undefined && args.place !== 'town') {
411
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'unknown storage place');
412
+ }
413
+ const town = args.place === 'town';
414
+ if (town) {
415
+ if (!['get', 'set', 'delete', 'increment'].includes(op) || args.scope !== 'DECK') {
416
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires a plain deck-scope operation');
417
+ }
418
+ if (typeof args.subject !== 'string' || !args.subject || Buffer.byteLength(args.subject) > 256) {
419
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires a user id of at most 256 bytes');
420
+ }
421
+ const entries = args.entries;
422
+ if (op === 'set' && !Array.isArray(entries)) {
423
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires entries');
424
+ }
425
+ const keys = op === 'increment' ? [args.key]
426
+ : op === 'set' && Array.isArray(entries) ? entries.map((entry) => entry?.key)
427
+ : args.keys;
428
+ if (!Array.isArray(keys)) {
429
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires keys');
430
+ }
431
+ for (const key of keys) {
432
+ const segments = typeof key === 'string' ? key.split(':') : [];
433
+ // The same namespaces ghost allows (tokens, spent, own, hat, chirp).
434
+ if (!['tokens', 'spent', 'own', 'hat', 'chirp'].includes(segments[0]) || segments[1] !== args.subject) {
435
+ return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', `invalid town storage key ${JSON.stringify(key)}`);
436
+ }
437
+ }
438
+ // Dev has no trusted door-to-town binding. Isolate these rows in the DEV
439
+ // deck's own scope so an author testing a door never edits a real town.
440
+ const plain = { ...args };
441
+ delete plain.place;
442
+ args = { ...plain, scope: 'DECK', subject: null };
443
+ if (op === 'increment')
444
+ args.key = `town/${keys[0]}`;
445
+ else if (op === 'set')
446
+ args.entries = entries.map((entry) => ({ ...entry, key: `town/${String(entry.key)}` }));
447
+ else
448
+ args.keys = keys.map((key) => `town/${String(key)}`);
449
+ }
410
450
  const operation = OPERATIONS[op];
411
451
  if (!operation) {
412
452
  return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', `unknown storage operation ${op}`);
@@ -469,7 +509,13 @@ export async function runDevStorageOperation(deckId, op, args, connectedUserIds
469
509
  },
470
510
  };
471
511
  }
472
- return { ok: true, value: response.data?.[operation.field] ?? null };
512
+ const value = response.data?.[operation.field] ?? null;
513
+ return {
514
+ ok: true,
515
+ value: town && op === 'get' && Array.isArray(value)
516
+ ? value.map((entry) => ({ ...entry, key: entry.key.slice('town/'.length) }))
517
+ : value,
518
+ };
473
519
  }
474
520
  catch (error) {
475
521
  return failure('CAULDRON_STORAGE_UNAVAILABLE', error instanceof Error ? error.message : 'storage request failed');
@@ -0,0 +1,22 @@
1
+ import { type ImportVersion } from './imports.js';
2
+ export interface ImportPinMismatch {
3
+ alias: string;
4
+ pinned: ImportVersion;
5
+ installed: ImportVersion;
6
+ /**
7
+ * Whether `--pin-installed-imports` may move this pin: only forward, within
8
+ * the same deck. Pinning older files, or another deck's, would quietly roll
9
+ * the deck back or swap what it imports; those go through update-import.
10
+ */
11
+ pinnable: boolean;
12
+ }
13
+ export declare function importPinMismatches(deckDir: string): ImportPinMismatch[];
14
+ export declare function importPinMismatchMessage(dir: string, command: 'check' | 'save-deck', mismatches: ImportPinMismatch[], pinInstalled?: boolean): string;
15
+ /**
16
+ * Whether `command` may go on to build: true when every fetched import's files
17
+ * match its pin, or when `pinInstalled` moved the pins that did not (each move
18
+ * logged; only when every one of them moves forward). Otherwise the refusal is
19
+ * printed and false returned, with nothing written. Silent, and castle.json
20
+ * untouched, when nothing differs.
21
+ */
22
+ export declare function settleImportPins(deckDir: string, dir: string, command: 'check' | 'save-deck', pinInstalled: boolean): boolean;
@@ -0,0 +1,77 @@
1
+ import { readCastleJson } from './castleJson.js';
2
+ import { readImportVersion, writeImportPin } from './imports.js';
3
+ function movesForward(pinned, installed) {
4
+ if (pinned.deckId !== installed.deckId)
5
+ return false;
6
+ const from = Date.parse(pinned.version);
7
+ const to = Date.parse(installed.version);
8
+ return Number.isFinite(from) && Number.isFinite(to) && to > from;
9
+ }
10
+ export function importPinMismatches(deckDir) {
11
+ const pins = readCastleJson(deckDir)?.imports ?? {};
12
+ const out = [];
13
+ for (const [alias, pin] of Object.entries(pins)) {
14
+ if (!pin?.deckId || typeof pin.version !== 'string')
15
+ continue;
16
+ const installed = readImportVersion(deckDir, alias);
17
+ if (!installed)
18
+ continue;
19
+ if (installed.deckId === pin.deckId && installed.version === pin.version)
20
+ continue;
21
+ const pinned = { deckId: pin.deckId, version: pin.version };
22
+ out.push({ alias, pinned, installed, pinnable: movesForward(pinned, installed) });
23
+ }
24
+ return out;
25
+ }
26
+ function describe(from, to) {
27
+ return from.deckId === to.deckId
28
+ ? [from.version, to.version]
29
+ : [`deck ${from.deckId} ${from.version}`, `deck ${to.deckId} ${to.version}`];
30
+ }
31
+ export function importPinMismatchMessage(dir, command, mismatches, pinInstalled = false) {
32
+ const remedy = (m) => {
33
+ if (m.pinnable)
34
+ return 'installed is newer: `--pin-installed-imports` pins it';
35
+ const why = m.installed.deckId !== m.pinned.deckId ? 'installed is another deck' : 'installed is not newer';
36
+ return `${why}: run \`castle-web update-import ${m.alias} ${dir}\``;
37
+ };
38
+ const lines = [
39
+ `${command === 'save-deck' ? 'Not saved' : 'Check failed'}: imports/ holds other versions than castle.json pins:`,
40
+ ...mismatches.map((m) => {
41
+ const [pinned, installed] = describe(m.pinned, m.installed);
42
+ return ` ${m.alias}: pinned ${pinned}, installed ${installed} -- ${remedy(m)}`;
43
+ }),
44
+ ];
45
+ if (pinInstalled) {
46
+ lines.push('--pin-installed-imports only moves a pin forward within the same deck, so nothing was moved.');
47
+ }
48
+ lines.push('The server keeps only the latest version of a deck, so `castle-web install` cannot put a pinned one back.');
49
+ if (mismatches.some((m) => m.pinnable)) {
50
+ lines.push(` castle-web ${command} ${dir} --pin-installed-imports move the newer ones' pins to what is installed`);
51
+ }
52
+ lines.push(` castle-web update-import <alias> ${dir} fetch the latest version and pin it, then play the deck to check it`);
53
+ return lines.join('\n');
54
+ }
55
+ /**
56
+ * Whether `command` may go on to build: true when every fetched import's files
57
+ * match its pin, or when `pinInstalled` moved the pins that did not (each move
58
+ * logged; only when every one of them moves forward). Otherwise the refusal is
59
+ * printed and false returned, with nothing written. Silent, and castle.json
60
+ * untouched, when nothing differs.
61
+ */
62
+ export function settleImportPins(deckDir, dir, command, pinInstalled) {
63
+ const mismatches = importPinMismatches(deckDir);
64
+ if (mismatches.length === 0)
65
+ return true;
66
+ if (!pinInstalled || mismatches.some((m) => !m.pinnable)) {
67
+ console.error(importPinMismatchMessage(dir, command, mismatches, pinInstalled));
68
+ return false;
69
+ }
70
+ const pins = readCastleJson(deckDir)?.imports ?? {};
71
+ for (const m of mismatches) {
72
+ writeImportPin(deckDir, m.alias, { ...pins[m.alias], ...m.installed });
73
+ const [pinned, installed] = describe(m.pinned, m.installed);
74
+ console.log(`${m.alias}: pin moved ${pinned} -> ${installed}`);
75
+ }
76
+ return true;
77
+ }
@@ -1,6 +1,6 @@
1
1
  import * as zlib from 'zlib';
2
2
  import * as api from './api.js';
3
- import { readImportVersion } from './imports.js';
3
+ import { readImportVersion, versionOlder } from './imports.js';
4
4
  /** The import pins in the saved deck's castle.json, or null when it can't be read. */
5
5
  export async function savedDeckImportPins(deckId, fetchArchive = fetchBytes) {
6
6
  const source = await api.webDeckSource(deckId);
@@ -49,22 +49,10 @@ export function tarFileText(tar, want) {
49
49
  }
50
50
  return null;
51
51
  }
52
- function semverParts(version) {
53
- const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version);
54
- return match ? match.slice(1, 4).map(Number) : null;
55
- }
56
52
  /** Whether `a` is an older version than `b` of the same kind of pin; false when unsure. */
57
53
  function older(a, aVersion, b) {
58
- if (a.source === 'builtin' && b.source === 'builtin') {
59
- const x = semverParts(aVersion);
60
- const y = semverParts(b.version);
61
- if (!x || !y)
62
- return false;
63
- for (let i = 0; i < 3; i += 1)
64
- if (x[i] !== y[i])
65
- return x[i] < y[i];
66
- return false;
67
- }
54
+ if (a.source === 'builtin' && b.source === 'builtin')
55
+ return versionOlder(aVersion, b.version);
68
56
  if (a.deckId && a.deckId === b.deckId) {
69
57
  const x = Date.parse(aVersion);
70
58
  const y = Date.parse(b.version);
package/dist/imports.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { IMPORTS_DIR, IMPORT_VERSION_FILE } from './castleJson.js';
1
+ import { IMPORTS_DIR, IMPORT_VERSION_FILE, type DeckImport } from './castleJson.js';
2
2
  export { IMPORTS_DIR, IMPORT_VERSION_FILE };
3
3
  export interface ImportVersion {
4
4
  deckId: string;
@@ -17,11 +17,17 @@ export declare function builtinKitDigest(kitDir: string): string;
17
17
  export declare function writeBuiltinStamp(importDir: string, stamp: BuiltinImportStamp): void;
18
18
  /** A builtin kit copied into a deck, stamped. `destDir` must not exist. */
19
19
  export declare function copyBuiltinKit(kitDir: string, destDir: string, kit: string, version: string): void;
20
+ /** Whether x.y.z version `a` is older than `b`; false when either is not one. */
21
+ export declare function versionOlder(a: string, b: string): boolean;
20
22
  /**
21
23
  * Builtin imports whose copy differs from this CLI's kit of the same version,
22
- * replaced with this CLI's. Returns the aliases replaced.
24
+ * replaced with this CLI's. With `olderPins` (save-deck only), a builtin pinned
25
+ * at an older CLI version is replaced too and its pin moved to this CLI's
26
+ * version. Returns the aliases replaced.
23
27
  */
24
- export declare function refreshStaleBuiltinImports(deckDir: string, log?: (message: string) => void): Promise<string[]>;
28
+ export declare function refreshStaleBuiltinImports(deckDir: string, log?: (message: string) => void, options?: {
29
+ olderPins?: boolean;
30
+ }): Promise<string[]>;
25
31
  export type ImportErrorCode = 'no-deck-ref' | 'bad-deck-ref' | 'not-a-deck-link' | 'link-unreachable' | 'no-such-dir' | 'self-import' | 'classic-deck' | 'no-source' | 'bad-alias' | 'already-imported';
26
32
  export declare class ImportError extends Error {
27
33
  code: ImportErrorCode;
@@ -29,6 +35,7 @@ export declare class ImportError extends Error {
29
35
  }
30
36
  export declare function parseDeckRef(raw: string): string | null;
31
37
  export declare function resolveDeckRef(raw: string): Promise<string | null>;
38
+ export declare function writeImportPin(dir: string, alias: string, pin: DeckImport): void;
32
39
  export declare function lockImportTree(dir: string): void;
33
40
  export declare function syncImportDependencies(deckDir: string): string[];
34
41
  export declare function restoreMissingImports(deckDir: string): Promise<string[]>;
package/dist/imports.js CHANGED
@@ -55,8 +55,14 @@ export function readImportVersion(deckDir, alias) {
55
55
  // version string does, so a deck's copy is stamped with a digest of the kit's
56
56
  // files, and a CLI of the same version whose own copy differs replaces it
57
57
  // (`refreshStaleBuiltinImports`) before the deck is installed, served or saved
58
- // -- otherwise a save ships whatever kit the deck happened to copy first. A copy
59
- // from another CLI version is left alone: that is never a move to make silently.
58
+ // -- otherwise a save ships whatever kit the deck happened to copy first.
59
+ //
60
+ // A copy from another CLI version is left alone while installing and serving:
61
+ // what the editor shows does not change under anyone. Saving is different. A
62
+ // pin OLDER than this CLI is moved forward on save -- the copy replaced with
63
+ // this CLI's kit and the pin rewritten to this CLI's version, said out loud --
64
+ // because otherwise every save after a CLI update ships the old kit and nothing
65
+ // says so. A pin NEWER than this CLI is never moved: that would be a move back.
60
66
  const BUILTIN_COPY_EXCLUDE = new Set(['node_modules', '.castle', 'dist', '.git']);
61
67
  function builtinCopyFilter(kitDir) {
62
68
  // The kit's own `imports/` is derived state, re-placed at the deck root.
@@ -106,11 +112,56 @@ export function copyBuiltinKit(kitDir, destDir, kit, version) {
106
112
  fs.cpSync(kitDir, destDir, { recursive: true, verbatimSymlinks: true, filter: builtinCopyFilter(kitDir) });
107
113
  writeBuiltinStamp(destDir, { source: 'builtin', kit, version, digest: builtinKitDigest(kitDir) });
108
114
  }
115
+ const errorText = (e) => (e instanceof Error ? e.message : String(e));
116
+ // The `onUpdate` a builtin kit declares -- this CLI's copy or the deck's -- when
117
+ // it has one. Moving such a pin without running it would leave the deck's data
118
+ // unmigrated under new code.
119
+ function builtinUpdateHook(kitDir, destDir) {
120
+ for (const dir of [kitDir, destDir]) {
121
+ const declared = tryReadCastleJson(dir)?.onUpdate;
122
+ if (typeof declared === 'string' && declared.trim())
123
+ return declared.trim();
124
+ }
125
+ return null;
126
+ }
127
+ // Staged beside the old copy and swapped in whole, so a failed copy leaves the
128
+ // deck's import as it was, and no half-copied stage behind.
129
+ function swapInBuiltinKit(kitDir, destDir, kit, version) {
130
+ const staged = `${destDir}.refresh-${process.pid}`;
131
+ fs.rmSync(staged, { recursive: true, force: true });
132
+ try {
133
+ copyBuiltinKit(kitDir, staged, kit, version);
134
+ }
135
+ catch (e) {
136
+ if (fs.existsSync(staged))
137
+ unlockImportTree(staged);
138
+ fs.rmSync(staged, { recursive: true, force: true });
139
+ throw e;
140
+ }
141
+ unlockImportTree(destDir);
142
+ fs.rmSync(destDir, { recursive: true, force: true });
143
+ fs.renameSync(staged, destDir);
144
+ lockImportTree(destDir);
145
+ }
146
+ /** Whether x.y.z version `a` is older than `b`; false when either is not one. */
147
+ export function versionOlder(a, b) {
148
+ const parts = (version) => /^(\d+)\.(\d+)\.(\d+)/.exec(version)?.slice(1, 4).map(Number) ?? null;
149
+ const x = parts(a);
150
+ const y = parts(b);
151
+ if (!x || !y)
152
+ return false;
153
+ for (let i = 0; i < 3; i += 1)
154
+ if (x[i] !== y[i])
155
+ return x[i] < y[i];
156
+ return false;
157
+ }
109
158
  /**
110
159
  * Builtin imports whose copy differs from this CLI's kit of the same version,
111
- * replaced with this CLI's. Returns the aliases replaced.
160
+ * replaced with this CLI's. With `olderPins` (save-deck only), a builtin pinned
161
+ * at an older CLI version is replaced too and its pin moved to this CLI's
162
+ * version. Returns the aliases replaced.
112
163
  */
113
- export async function refreshStaleBuiltinImports(deckDir, log = (message) => console.log(message)) {
164
+ export async function refreshStaleBuiltinImports(deckDir, log = (message) => console.log(message), options = {}) {
114
165
  const pins = tryReadCastleJson(deckDir)?.imports ?? {};
115
166
  const { getCliVersion } = await import('./init.js');
116
167
  const cliVersion = getCliVersion();
@@ -118,38 +169,51 @@ export async function refreshStaleBuiltinImports(deckDir, log = (message) => con
118
169
  // Never throws: a kit that cannot be refreshed is left as it is and named,
119
170
  // and the ones that were are still returned (serve invalidates on them).
120
171
  for (const [alias, pin] of Object.entries(pins)) {
121
- if (pin?.source !== 'builtin' || pin.version !== cliVersion)
172
+ if (pin?.source !== 'builtin')
173
+ continue;
174
+ const movePin = pin.version !== cliVersion;
175
+ if (movePin && !(options.olderPins && versionOlder(pin.version, cliVersion)))
122
176
  continue;
123
177
  const destDir = path.join(deckDir, IMPORTS_DIR, alias);
124
178
  const kitDir = path.join(getKitsDir(), pin.kit ?? alias);
125
179
  try {
126
180
  if (!fs.existsSync(destDir) || !fs.existsSync(kitDir))
127
181
  continue;
182
+ const hook = movePin ? builtinUpdateHook(kitDir, destDir) : null;
183
+ if (hook) {
184
+ log(`Left ${alias} at ${pin.version}, older than this CLI (${cliVersion}): the kit migrates a deck when its pin moves ` +
185
+ `(onUpdate: ${hook}), and no castle-web command runs that for a kit the CLI ships. Move it deliberately: run ` +
186
+ `imports/${alias}/${hook} on this deck (its header names the arguments it needs), then set the pin's version in castle.json to ${cliVersion}; the next save copies this CLI's kit.`);
187
+ continue;
188
+ }
128
189
  const digest = builtinKitDigest(kitDir);
129
190
  const stamp = readBuiltinStamp(destDir);
130
- if (stamp?.digest === digest)
191
+ if (!movePin && stamp?.digest === digest)
131
192
  continue;
132
- if (!stamp && builtinKitDigest(destDir) === digest) {
193
+ if (!movePin && !stamp && builtinKitDigest(destDir) === digest) {
133
194
  // A copy from before stamps, already this kit: stamp it and move on.
134
195
  unlockImportTree(destDir);
135
196
  writeBuiltinStamp(destDir, { source: 'builtin', kit: pin.kit ?? alias, version: cliVersion, digest });
136
197
  lockImportTree(destDir);
137
198
  continue;
138
199
  }
139
- // Staged beside the old copy and swapped in whole, so a failed copy
140
- // leaves the deck's import as it was.
141
- const staged = `${destDir}.refresh-${process.pid}`;
142
- fs.rmSync(staged, { recursive: true, force: true });
143
- copyBuiltinKit(kitDir, staged, pin.kit ?? alias, cliVersion);
144
- unlockImportTree(destDir);
145
- fs.rmSync(destDir, { recursive: true, force: true });
146
- fs.renameSync(staged, destDir);
147
- lockImportTree(destDir);
200
+ swapInBuiltinKit(kitDir, destDir, pin.kit ?? alias, cliVersion);
148
201
  refreshed.push(alias);
149
- log(`Refreshed ${alias}: this deck's copy differed from the ${pin.kit ?? alias} kit this CLI (${cliVersion}) ships.`);
202
+ if (!movePin) {
203
+ log(`Refreshed ${alias}: this deck's copy differed from the ${pin.kit ?? alias} kit this CLI (${cliVersion}) ships.`);
204
+ continue;
205
+ }
206
+ try {
207
+ writeImportPin(deckDir, alias, { ...pin, version: cliVersion });
208
+ }
209
+ catch (e) {
210
+ log(`Replaced ${alias}'s files with this CLI's kit (${cliVersion}), but its pin was NOT moved from ${pin.version}: ${errorText(e)}`);
211
+ continue;
212
+ }
213
+ log(`Refreshed ${alias}: pinned at ${pin.version}, older than this CLI (${cliVersion}); now this CLI's kit, pin moved to ${cliVersion}.`);
150
214
  }
151
215
  catch (e) {
152
- log(`Left ${alias} as it is: ${e instanceof Error ? e.message : String(e)}`);
216
+ log(`Left ${alias} as it is: ${errorText(e)}`);
153
217
  }
154
218
  }
155
219
  if (refreshed.length) {
@@ -266,7 +330,7 @@ export async function resolveDeckRef(raw) {
266
330
  }
267
331
  // Only the `imports` key is ours; everything else in castle.json (deck identity,
268
332
  // editor config) is preserved as-is.
269
- function writeImportPin(dir, alias, pin) {
333
+ export function writeImportPin(dir, alias, pin) {
270
334
  const existing = readCastleJson(dir) ?? {};
271
335
  // Forks belong to the DECK, not to the pin: the files live in its own forks/
272
336
  // and an import update or restore doesn't touch them. Writing a fresh pin over
@@ -477,6 +541,10 @@ export async function restoreMissingImports(deckDir) {
477
541
  // truth: the pin stays as committed, and publish-kits compares the two
478
542
  // to refuse bundling against files no pin describes.
479
543
  writeImportVersion(destDir, { deckId: pin.deckId, version: source.updatedAt });
544
+ if (source.updatedAt !== pin.version) {
545
+ console.warn(`Import "${alias}" is pinned at ${pin.version}, but the server only has ${source.updatedAt}, so that is what was placed. ` +
546
+ '`castle-web check` and `save-deck` refuse until the two agree (see `--pin-installed-imports`).');
547
+ }
480
548
  }
481
549
  else if (pin?.source === 'builtin') {
482
550
  // Scaffolded from the kit shipped with the CLI: the same copy is still
@@ -1077,7 +1145,7 @@ export async function updateImport(dir, options = {}) {
1077
1145
  if (!pin.deckId) {
1078
1146
  // A kit copied from the CLI updates with the CLI, not from the server.
1079
1147
  if (options.alias)
1080
- console.log(`"${alias}" came with this CLI; it updates when the CLI does.`);
1148
+ console.log(`"${alias}" came with this CLI; it moves to a newer CLI's kit when the deck is saved with that CLI.`);
1081
1149
  continue;
1082
1150
  }
1083
1151
  const source = await api.webDeckSource(pin.deckId).catch(() => null);
package/dist/index.js CHANGED
@@ -184,7 +184,7 @@ function usage() {
184
184
  castle-web serve [dir] [--port PORT] [--host HOST] [--open] [--detach]
185
185
  castle-web restart [--port PORT]
186
186
  castle-web screenshot [--out FILE] [--port PORT]
187
- castle-web save-deck [dir] [--title TITLE] [--caption TEXT] [--visibility unlisted|private] [--force] (--force: save over a newer saved copy)
187
+ castle-web save-deck [dir] [--title TITLE] [--caption TEXT] [--visibility unlisted|private] [--force] [--pin-installed-imports] (--force: save over a newer saved copy; --pin-installed-imports: move import pins to the versions imports/ holds instead of refusing)
188
188
  castle-web get-deck [dir] [--deck-id ID] [--force] (replaces the source if the deck is already there)
189
189
  castle-web get-deck <dir> --side [--deck-id ID] [--json] (fetches the saved copy into <dir>/.castle/agent/saved-source/<stamp>/, touching nothing else)
190
190
  castle-web source-status <dir> [--adopt] [--notify] [--json] (whether the deck's saved copy is newer than this folder)
@@ -195,7 +195,7 @@ function usage() {
195
195
  castle-web revert-import-file <imports/...> [dir]
196
196
  castle-web update-import [alias] [dir] [--check] [--revert] (re-fetches imports; no alias means all)
197
197
  castle-web install [dir]
198
- castle-web check [dir] (bundles the deck and its server, then runs each import's onCheck -- the same gates save-deck runs)
198
+ castle-web check [dir] [--pin-installed-imports] (bundles the deck and its server, then runs each import's onCheck -- the same gates save-deck runs)
199
199
  castle-web save-version [-m MESSAGE] [paths...] [--dir DIR] (no paths saves the whole deck)
200
200
  castle-web list-versions [version] [--dir DIR] (defaults to the latest version)
201
201
  castle-web show-version <version> [--dir DIR] (diffs of the files that version changed)
@@ -555,7 +555,8 @@ async function main() {
555
555
  const title = getFlagValue('--title');
556
556
  const caption = getFlagValue('--caption');
557
557
  const visibility = getFlagValue('--visibility');
558
- await saveDeck(dir, { title, caption, visibility, force: hasFlag('--force') });
558
+ const pinInstalledImports = hasFlag('--pin-installed-imports');
559
+ await saveDeck(dir, { title, caption, visibility, force: hasFlag('--force'), pinInstalledImports });
559
560
  break;
560
561
  }
561
562
  case 'get-deck': {
@@ -633,7 +634,7 @@ async function main() {
633
634
  break;
634
635
  }
635
636
  case 'check': {
636
- await check(findPositionalDir());
637
+ await check(findPositionalDir(), { pinInstalledImports: hasFlag('--pin-installed-imports') });
637
638
  break;
638
639
  }
639
640
  // The version commands spend their positionals on their own arguments --
package/dist/init.js CHANGED
@@ -64,7 +64,7 @@ const BARE_SCAFFOLDS = [
64
64
  // Registry version of castle-web-sdk to inject when scaffolding from a
65
65
  // globally-installed castle-web (not from inside the workspace). Bumped
66
66
  // alongside cli/sdk version bumps.
67
- const PUBLISHED_SDK_VERSION = '0.4.46';
67
+ const PUBLISHED_SDK_VERSION = '0.4.47';
68
68
  // Range, not a pin: `castle-web-fonts` is its own package precisely so a tenth
69
69
  // face can ship without a cli release, and a caret range means an existing
70
70
  // deck's next install picks it up. Nothing here has to move when it does.
@@ -239,6 +239,28 @@ const COMMON_SECTIONS = `## Imports are read-only
239
239
  - Exception: deliberate pixel art wants a fixed low-resolution backing store with \`image-rendering: pixelated\` CSS instead — don't DPR-scale that; the crisp chunky look is the point.
240
240
  - **A WebGL canvas must be created with \`preserveDrawingBuffer: true\`, or every in-page capture of the deck comes back blank** — the Play panel's Snap and \`npm run screenshot\` both read the canvas after the frame has been shown, and by then the browser has cleared it, so the image is just the card's background. Pass it through whatever library makes the canvas: \`new THREE.WebGLRenderer({ preserveDrawingBuffer: true })\`, PixiJS \`app.init({ preserveDrawingBuffer: true })\`, or \`canvas.getContext('webgl2', { preserveDrawingBuffer: true })\`. A 2D canvas needs nothing, and kit decks already set it.
241
241
 
242
+ ## Game clock
243
+
244
+ - **The deck is hidden and resumed in place, and the clock keeps running while it is hidden.** When the player leaves the feed, Castle keeps the deck alive but stops its \`requestAnimationFrame\` callbacks; \`Date.now()\` and \`performance.now()\` keep advancing, so on return the first frame and every clock reading jump by the whole absence -- minutes, or longer.
245
+ - **Drive simulation from the rAF timestamp with a clamped dt; the cap is the point.** A fixed-timestep accumulator needs the same cap on the time it accumulates. When a kit runs the loop and hands your code a \`dt\`, use that \`dt\` rather than reading a clock.
246
+
247
+ \`\`\`js
248
+ let last = performance.now();
249
+ function frame(now) {
250
+ const dt = Math.min(0.05, (now - last) / 1000);
251
+ last = now;
252
+ update(dt); // roundTime -= dt; cooldown = Math.max(0, cooldown - dt);
253
+ requestAnimationFrame(frame);
254
+ }
255
+ requestAnimationFrame(frame);
256
+ document.addEventListener('visibilitychange', () => {
257
+ if (!document.hidden) last = performance.now();
258
+ });
259
+ \`\`\`
260
+
261
+ - **Game time -- round timers, countdowns, cooldowns, respawns, a survival score -- is accumulated from that clamped dt, never from \`Date.now()\` or \`performance.now()\` minus a stored stamp.** \`performance.now() - roundStart\` or \`Date.now() < endsAt\` ends the round or expires the cooldown while nobody is looking. \`Date.now()\` is still right for what should track real time: daily rewards, ids, logs. This is about time the deck keeps itself: a server-authoritative clock (a multiplayer match timer, the hub's server simulation time) comes from the server the way the kit guides describe, and the server keeps running for the other players.
262
+ - **Pause what should not run while hidden** (music, a spawner on its own \`setInterval\`) on \`visibilitychange\`, and resume it when \`document.hidden\` is false again.
263
+
242
264
  ## Multiplayer
243
265
 
244
266
  - **Read \`${MULTIPLAYER_DOC_REL}\` before writing or changing a server entry or client netcode by hand.** It carries what this section leaves out: the outbound frame budget in practice, the snapshot pattern, self-healing events, and the reconnect and disconnect handling a hand-rolled session gets wrong. A deck built on the \`castle.multiplayer-2d\` / \`castle.multiplayer-3d\` (or \`castle.turn-based\`) kits already does all of that and normally writes nothing against the raw session API.
@@ -6,6 +6,10 @@ export interface TaskDirective {
6
6
  hold?: true;
7
7
  prompt: string;
8
8
  }
9
+ export interface AnswerDirective {
10
+ target: string;
11
+ answer: string;
12
+ }
9
13
  export interface BoardTask {
10
14
  id: string;
11
15
  title: string;
@@ -21,6 +25,7 @@ export declare function extractDirectives(full: string, opts?: {
21
25
  directives: TaskDirective[];
22
26
  checkoffs: string[];
23
27
  stops: string[];
28
+ answers: AnswerDirective[];
24
29
  prefs: string[];
25
30
  sends: SendDirective[];
26
31
  plan?: string;
@@ -116,6 +116,7 @@ opts = {}) {
116
116
  const sends = [];
117
117
  const checkoffs = [];
118
118
  const stops = [];
119
+ const answers = [];
119
120
  const prefs = [];
120
121
  const listFence = (source, name, into) => {
121
122
  const re = new RegExp('```' + name + '[ \\t]*\\r?\\n([\\s\\S]*?)```', 'g');
@@ -130,14 +131,22 @@ opts = {}) {
130
131
  };
131
132
  const { plan, rest } = takePlanFence(full);
132
133
  const withoutLists = listFence(listFence(listFence(rest, 'castle-done', checkoffs), 'castle-stop', stops), 'castle-pref', prefs);
134
+ const withoutAnswers = withoutLists.replace(/```castle-answer[ \t]*\r?\n([\s\S]*?)```/g, (_match, body) => {
135
+ const lines = body.replace(/\r/g, '').trim().split('\n');
136
+ const target = (lines.shift() ?? '').trim();
137
+ const answer = lines.join('\n').trim();
138
+ if (target && answer)
139
+ answers.push({ target, answer });
140
+ return '';
141
+ });
133
142
  const withoutSends = opts.sends
134
- ? withoutLists.replace(sendFenceRegex(), (_match, body) => {
143
+ ? withoutAnswers.replace(sendFenceRegex(), (_match, body) => {
135
144
  const send = parseSendFenceBody(String(body));
136
145
  if (send)
137
146
  sends.push(send);
138
147
  return '';
139
148
  })
140
- : withoutLists;
149
+ : withoutAnswers;
141
150
  const cleaned = withoutSends.replace(taskFenceRegex(), (_match, body) => {
142
151
  const directive = parseTaskFenceBody(String(body));
143
152
  if (directive)
@@ -149,6 +158,7 @@ opts = {}) {
149
158
  directives,
150
159
  checkoffs,
151
160
  stops,
161
+ answers,
152
162
  prefs,
153
163
  sends,
154
164
  plan,
@@ -40,5 +40,10 @@ export interface SaveDeckOptions {
40
40
  visibility?: SaveVisibility;
41
41
  /** Save even when the deck's saved copy is newer than this folder. */
42
42
  force?: boolean;
43
+ /** Move import pins to the versions imports/ holds, rather than refuse. */
44
+ pinInstalledImports?: boolean;
43
45
  }
44
46
  export declare function saveDeck(dir: string, opts?: SaveDeckOptions): Promise<void>;
47
+ export declare function builtinRefreshOptions(env?: NodeJS.ProcessEnv): {
48
+ olderPins: boolean;
49
+ };
package/dist/save-deck.js CHANGED
@@ -13,6 +13,8 @@ import { COVER_FILE } from './localPaths.js';
13
13
  import { buildServerBundle } from './serverBundle.js';
14
14
  import { buildContentPack } from './contentPack.js';
15
15
  import { importRegressionMessage, importRegressions, savedDeckImportPins } from './importRegression.js';
16
+ import { isSandboxEnv } from './cloudGit.js';
17
+ import { settleImportPins } from './importPinMismatch.js';
16
18
  import { refreshStaleBuiltinImports } from './imports.js';
17
19
  import { decideSavePrecondition, EXIT_IMPORTS_OLDER, EXIT_SAVED_DECK_NEWER, fetchServerSourceVersion, readSyncMarker, saveRefusedLine, saveRefusedMessage, WEB_DECK_SOURCE_STALE_CODE, writeSyncMarker, } from './webSourceSync.js';
18
20
  import { DeckTooLargeError, MAX_SCENE_DATA_BYTES, MAX_SOURCE_ARCHIVE_BYTES, SAVE_FAILURE_ENV, classifySaveFailure, saveFailedLine, sceneTooLargeMessage, sourceTooLargeMessage, } from './saveFailure.js';
@@ -463,11 +465,42 @@ export async function saveDeck(dir, opts = {}) {
463
465
  throw error;
464
466
  }
465
467
  }
468
+ // A save from castle-www or from inside a cloud sandbox: decks there save
469
+ // exactly as they did, with these checks only warning.
470
+ function cloudSave(env) {
471
+ return env[SAVE_FAILURE_ENV] === '1' || isSandboxEnv(env);
472
+ }
473
+ // How save-deck refreshes builtin kits: a pin older than this CLI moves to its
474
+ // kit -- except in a cloud save, where decks save exactly as they did.
475
+ export function builtinRefreshOptions(env = process.env) {
476
+ return { olderPins: !cloudSave(env) };
477
+ }
478
+ // False (exit code set) when save-deck must stop because imports/ holds other
479
+ // versions than castle.json pins. castle-www's cloud save understands only its
480
+ // own refusal and cannot pass the flag, so in a cloud save this is a warning, as
481
+ // an import regression is (and as `check` in a sandbox does).
482
+ function importPinsSettled(dir, projectDir, opts) {
483
+ if (settleImportPins(projectDir, dir, 'save-deck', opts.pinInstalledImports === true))
484
+ return true;
485
+ if (cloudSave(process.env)) {
486
+ console.error('Saving anyway (cloud save).');
487
+ return true;
488
+ }
489
+ process.exitCode = 1;
490
+ return false;
491
+ }
466
492
  async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
467
- // A builtin kit that changed under the same CLI version is this CLI's again
468
- // before anything is read, packed or bundled: a save never ships a stale copy
469
- // of it, and the pins a refreshed kit adds are in the castle.json read here.
470
- await refreshStaleBuiltinImports(projectDir);
493
+ // First, before anything is changed or the network touched: imports/ holding
494
+ // other versions than the pins is a deck no pin describes.
495
+ if (!importPinsSettled(dir, projectDir, opts))
496
+ return;
497
+ // A builtin kit that changed under the same CLI version, or is pinned at an
498
+ // older CLI, is this CLI's again before anything is read, packed or bundled: a
499
+ // save never ships a stale copy, and the pins a refreshed kit adds are read here.
500
+ const refreshed = await refreshStaleBuiltinImports(projectDir, undefined, builtinRefreshOptions());
501
+ // A refresh can restore a kit's new imports, at whatever the server has now.
502
+ if (refreshed.length > 0 && !importPinsSettled(dir, projectDir, opts))
503
+ return;
471
504
  const castleJson = readCastleJson(projectDir);
472
505
  const existingDeckId = typeof castleJson?.deckId === 'string' && castleJson.deckId ? castleJson.deckId : null;
473
506
  const experiments = checkedExperiments(castleJson);
package/dist/serve.js CHANGED
@@ -856,6 +856,8 @@ function devHubVisit(ws, playSessionSlot, projectDir, multiplayer, multiplayerUr
856
856
  entry.mp.url = multiplayerUrl;
857
857
  return entry.visit;
858
858
  }
859
+ // Account hearts shared across the dev serve's panels, never persisted.
860
+ const localHubHearts = new Map();
859
861
  // Commands in flight on each socket, so a deck's cancel or a closed socket can
860
862
  // abort a streaming one.
861
863
  const commandAborts = new WeakMap();
@@ -891,6 +893,7 @@ async function handleCastleCommand(ws, projectDir, broadcast, multiplayer, multi
891
893
  const save = devSaveGraphql(projectDir, ctx.userId, query, variables);
892
894
  return save ? Promise.resolve(save) : castleGraphql(query, variables);
893
895
  },
896
+ localHubHearts,
894
897
  oracleStream,
895
898
  showLeaderboard: (payload) => broadcast({ type: 'castle_leaderboard_show', payload }),
896
899
  hub: devHubVisit(ws, playSessionSlot, projectDir, multiplayer, multiplayerUrl),