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,70 @@
1
+ const USERS = {
2
+ alice: { userId: 'dev-alice', username: 'Alice' },
3
+ bob: { userId: 'dev-bob', username: 'Bob' },
4
+ cara: { userId: 'dev-cara', username: 'Cara' },
5
+ };
6
+ const FRIENDS = {
7
+ alice: ['bob', 'cara'],
8
+ bob: ['alice'],
9
+ cara: ['alice'],
10
+ };
11
+ const ONLINE_FRIEND = {
12
+ alice: 'bob',
13
+ bob: 'alice',
14
+ cara: 'alice',
15
+ };
16
+ export function devSocialFixtureKey(value) {
17
+ return value === 'alice' || value === 'bob' || value === 'cara' ? value : null;
18
+ }
19
+ export function devSocialUser(key, fallback) {
20
+ if (key)
21
+ return USERS[key];
22
+ return fallback;
23
+ }
24
+ export function devSocialUserForId(userId, ctx) {
25
+ const fixture = Object.values(USERS).find((user) => user.userId === userId);
26
+ if (fixture)
27
+ return fixture;
28
+ if (ctx?.userId === userId) {
29
+ return { userId, username: ctx.username ?? 'Developer' };
30
+ }
31
+ return { userId, username: userId };
32
+ }
33
+ /**
34
+ * Answers only Social's two GraphQL documents. A null answer means this is not
35
+ * a social fixture query. Unknown `?as=` values deliberately use the harmless
36
+ * developer fixture (no friends and no presence), never an arbitrary user id.
37
+ */
38
+ export function devSocialGraphql(key, deckId, query) {
39
+ if (query.includes('cauldronMutualFriends(')) {
40
+ return {
41
+ data: {
42
+ cauldronMutualFriends: key ? FRIENDS[key].map((friend) => USERS[friend]) : [],
43
+ },
44
+ };
45
+ }
46
+ if (query.includes('friendsPlaying')) {
47
+ if (!key || !deckId)
48
+ return { data: { deck: { friendsPlaying: [] } } };
49
+ const friend = USERS[ONLINE_FRIEND[key]];
50
+ return {
51
+ data: {
52
+ deck: {
53
+ friendsPlaying: [
54
+ {
55
+ ...friend,
56
+ nowPlaying: {
57
+ deckId,
58
+ sessionId: `dev:${friend.userId}`,
59
+ routeId: 'main',
60
+ slot: friend.userId,
61
+ updatedAt: '2026-01-01T00:00:00.000Z',
62
+ },
63
+ },
64
+ ],
65
+ },
66
+ },
67
+ };
68
+ }
69
+ return null;
70
+ }
package/dist/ide.d.ts CHANGED
@@ -61,4 +61,6 @@ export declare function createIdeServer(opts: {
61
61
  authorizeUpgrade?: (req: http.IncomingMessage, endpoint: 'pty') => boolean;
62
62
  /** Records which writes were only a tune, for the files_changed broadcast. */
63
63
  tuneLedger?: TuneLedger;
64
+ /** Appends one line (newline included) to the deck's log; best-effort. */
65
+ log?: (line: string) => void;
64
66
  }): IdeServer;
package/dist/ide.js CHANGED
@@ -241,6 +241,83 @@ const FILES_IGNORE_DIRS = new Set(['.git', '.castle', 'node_modules', 'dist', FO
241
241
  // read-only and unlocking around writes races with concurrent processes, gets
242
242
  // clobbered by tools, and still would not stop a raw shell write.
243
243
  const PROTECTED_WRITE_DIRS = new Set(['.castle']);
244
+ // Deck-root files the files API will not delete or rename away, nor let another
245
+ // file be moved over. Without `castle.json` a deck is not a deck: every cloud save
246
+ // is refused until it comes back. The bootstrap binding is what ties a cloud deck
247
+ // to its owner. Writing new contents into either stays an ordinary edit.
248
+ const DECK_ROOT_ANCHORS = new Map([
249
+ ['castle.json', "castle.json defines this deck and can't be deleted or renamed."],
250
+ [
251
+ '.castle-cloud-bootstrap-binding',
252
+ ".castle-cloud-bootstrap-binding ties this cloud deck to its owner and can't be deleted or renamed.",
253
+ ],
254
+ ]);
255
+ // Where a path lands on disk with every symlinked DIRECTORY on the way resolved,
256
+ // but not the last component: a delete or rename acts on that entry itself (a
257
+ // symlink is removed or moved, never followed). Parents that don't exist yet --
258
+ // a rename destination -- resolve through their nearest existing ancestor.
259
+ function physicalPath(abs) {
260
+ const tail = [path.basename(abs)];
261
+ let dir = path.dirname(abs);
262
+ for (;;) {
263
+ try {
264
+ return path.join(fs.realpathSync(dir), ...tail);
265
+ }
266
+ catch {
267
+ const parent = path.dirname(dir);
268
+ if (parent === dir)
269
+ return abs;
270
+ tail.unshift(path.basename(dir));
271
+ dir = parent;
272
+ }
273
+ }
274
+ }
275
+ function realOrSelf(abs) {
276
+ try {
277
+ return fs.realpathSync(abs);
278
+ }
279
+ catch {
280
+ return abs;
281
+ }
282
+ }
283
+ // The refusal for a resolved deck path that IS one of the anchors (or the deck
284
+ // root), or null. `rel` is already normalized by resolveDeckPath (`./castle.json`,
285
+ // `castle.json/` and `a/../castle.json` all arrive as `castle.json`), but it is
286
+ // lexical: `alias/castle.json` with `alias -> .` names the same file, so the
287
+ // comparison is made on the physical path. The inode check also catches another
288
+ // spelling of the name on a case-insensitive filesystem.
289
+ function deckRootAnchorRefusal(deckDir, target) {
290
+ const deckReal = realOrSelf(deckDir);
291
+ if (realOrSelf(target.abs) === deckReal) {
292
+ return `${target.rel} is the deck folder itself and can't be deleted or renamed.`;
293
+ }
294
+ const physical = physicalPath(target.abs);
295
+ const atRoot = path.dirname(physical) === deckReal;
296
+ const base = path.basename(physical);
297
+ for (const [name, refusal] of DECK_ROOT_ANCHORS) {
298
+ if (target.rel === name)
299
+ return refusal;
300
+ if (!atRoot)
301
+ continue;
302
+ if (base === name)
303
+ return refusal;
304
+ if (base.toLowerCase() === name && isSameFile(physical, path.join(deckReal, name))) {
305
+ return refusal;
306
+ }
307
+ }
308
+ return null;
309
+ }
310
+ // One `[files] ...` line in the deck's log per files API mutation, so a file that
311
+ // vanished can be traced to the editor. Best-effort: a failed log write never
312
+ // fails the request.
313
+ function logFilesMutation(log, line) {
314
+ try {
315
+ log?.(`[files] ${line}\n`);
316
+ }
317
+ catch {
318
+ // logging must never fail a files request
319
+ }
320
+ }
244
321
  // Ceiling on one uploaded file. A deck is saved whole (source tar + bundle), so
245
322
  // a huge asset is a problem for the deck long before it is a problem here --
246
323
  // refuse it at the door with a message rather than let it land and break `save`.
@@ -305,7 +382,9 @@ export function resolveDeckPath(deckDir, requestedPath, opts = {}) {
305
382
  }
306
383
  const abs = path.resolve(deckDir, normalized);
307
384
  const rel = path.relative(deckDir, abs);
308
- if (rel.startsWith('..') || path.isAbsolute(rel)) {
385
+ // `./` and `sub/../` normalize to `./`, not `.`, so the check above misses
386
+ // them; resolved, they are the deck root -- which a delete would remove whole.
387
+ if (rel === '' || rel.startsWith('..') || path.isAbsolute(rel)) {
309
388
  return { ok: false, error: `Path outside the deck: ${requestedPath}` };
310
389
  }
311
390
  const relPosix = rel.split(path.sep).join('/');
@@ -607,7 +686,7 @@ async function gitPanelAction(res, args, deckDir, onSuccess) {
607
686
  // over whatever landed in between, and the Parameters panel is the one that
608
687
  // needs it (it splices against its last read and ignores external changes while
609
688
  // its own write is in flight).
610
- function handleFilesWrite(deckDir, req, res, ledger) {
689
+ function handleFilesWrite(deckDir, req, res, ledger, log) {
611
690
  withMutationPath(deckDir, req, res, (target, body) => {
612
691
  if (typeof body.contents !== 'string') {
613
692
  return sendJson(res, 400, { error: 'File contents must be a string.' });
@@ -626,10 +705,14 @@ function handleFilesWrite(deckDir, req, res, ledger) {
626
705
  });
627
706
  }
628
707
  recordParamsWrite(deckDir, target.rel, body.tuned);
708
+ // A tune is a Parameters slider writing many times a second; the watcher's
709
+ // `[watch] ... tuned` line already covers it without flooding the log.
710
+ if (!body.tuned)
711
+ logFilesMutation(log, `write ${target.rel}`);
629
712
  sendJson(res, 200, { ok: true, path: target.rel });
630
713
  });
631
714
  }
632
- function handleFilesMkdir(deckDir, req, res) {
715
+ function handleFilesMkdir(deckDir, req, res, log) {
633
716
  withMutationPath(deckDir, req, res, (target) => {
634
717
  try {
635
718
  fs.mkdirSync(target.abs, { recursive: true });
@@ -637,6 +720,7 @@ function handleFilesMkdir(deckDir, req, res) {
637
720
  catch (err) {
638
721
  return sendFailure(res, 'create folder', target.rel, err);
639
722
  }
723
+ logFilesMutation(log, `mkdir ${target.rel}`);
640
724
  sendJson(res, 200, { ok: true, path: target.rel });
641
725
  });
642
726
  }
@@ -671,7 +755,7 @@ function handleCoverApi(deckDir, req, res) {
671
755
  });
672
756
  return true;
673
757
  }
674
- function handleFilesUpload(deckDir, req, res) {
758
+ function handleFilesUpload(deckDir, req, res, log) {
675
759
  const url = new URL(req.url ?? '/', 'http://localhost');
676
760
  const target = resolveDeckPath(deckDir, url.searchParams.get('path'), {
677
761
  mutation: true,
@@ -698,6 +782,7 @@ function handleFilesUpload(deckDir, req, res) {
698
782
  catch (err) {
699
783
  return sendFailure(res, 'upload', target.rel, err);
700
784
  }
785
+ logFilesMutation(log, `upload ${target.rel}`);
701
786
  sendJson(res, 200, { ok: true, path: target.rel });
702
787
  }, (err) => {
703
788
  if (err instanceof RangeError)
@@ -769,7 +854,7 @@ function isBinary(bytes) {
769
854
  }
770
855
  // Copy a file byte-for-byte. The Files panel's Duplicate goes through this
771
856
  // rather than read-then-write, which would corrupt anything binary.
772
- function handleFilesCopy(deckDir, req, res) {
857
+ function handleFilesCopy(deckDir, req, res, log) {
773
858
  withJsonBody(req, res, (body) => {
774
859
  const from = resolveDeckPath(deckDir, body.from);
775
860
  if (!from.ok)
@@ -786,6 +871,7 @@ function handleFilesCopy(deckDir, req, res) {
786
871
  try {
787
872
  fs.mkdirSync(path.dirname(to.abs), { recursive: true });
788
873
  fs.copyFileSync(from.abs, to.abs);
874
+ logFilesMutation(log, `copy ${from.rel} -> ${to.rel}`);
789
875
  sendJson(res, 200, { ok: true, path: to.rel });
790
876
  }
791
877
  catch (err) {
@@ -805,7 +891,7 @@ function isSameFile(a, b) {
805
891
  return false;
806
892
  }
807
893
  }
808
- function handleFilesRename(deckDir, req, res) {
894
+ function handleFilesRename(deckDir, req, res, log) {
809
895
  withJsonBody(req, res, (body) => {
810
896
  const from = resolveDeckPath(deckDir, body.from, { mutation: true });
811
897
  if (!from.ok)
@@ -813,6 +899,15 @@ function handleFilesRename(deckDir, req, res) {
813
899
  const to = resolveDeckPath(deckDir, body.to, { mutation: true });
814
900
  if (!to.ok)
815
901
  return sendJson(res, 400, { error: to.error });
902
+ // Renaming an anchor away loses it as surely as deleting it; moving another
903
+ // file over one replaces it. Moving a file INTO an anchor's empty slot is
904
+ // allowed -- that is how a lost castle.json comes back.
905
+ const anchorRefusal = deckRootAnchorRefusal(deckDir, from) ??
906
+ (fs.existsSync(to.abs) ? deckRootAnchorRefusal(deckDir, to) : null);
907
+ if (anchorRefusal) {
908
+ logFilesMutation(log, `refused rename ${from.rel} -> ${to.rel}`);
909
+ return sendJson(res, 400, { error: anchorRefusal });
910
+ }
816
911
  if (!fs.existsSync(from.abs)) {
817
912
  return sendJson(res, 404, { error: `Not found: ${from.rel}` });
818
913
  }
@@ -826,6 +921,7 @@ function handleFilesRename(deckDir, req, res) {
826
921
  try {
827
922
  fs.mkdirSync(path.dirname(to.abs), { recursive: true });
828
923
  fs.renameSync(from.abs, to.abs);
924
+ logFilesMutation(log, `rename ${from.rel} -> ${to.rel}`);
829
925
  sendJson(res, 200, { ok: true, path: to.rel });
830
926
  }
831
927
  catch (err) {
@@ -833,13 +929,21 @@ function handleFilesRename(deckDir, req, res) {
833
929
  }
834
930
  });
835
931
  }
836
- function handleFilesDelete(deckDir, req, res) {
932
+ function handleFilesDelete(deckDir, req, res, log) {
837
933
  withMutationPath(deckDir, req, res, (target) => {
934
+ // resolveDeckPath refuses the deck root by name; a symlink into it (to the
935
+ // root itself, or to a folder that holds an anchor) is caught here.
936
+ const anchorRefusal = deckRootAnchorRefusal(deckDir, target);
937
+ if (anchorRefusal) {
938
+ logFilesMutation(log, `refused delete ${target.rel}`);
939
+ return sendJson(res, 400, { error: anchorRefusal });
940
+ }
838
941
  if (!fs.existsSync(target.abs)) {
839
942
  return sendJson(res, 404, { error: `Not found: ${target.rel}` });
840
943
  }
841
944
  try {
842
945
  fs.rmSync(target.abs, { recursive: true, force: true });
946
+ logFilesMutation(log, `delete ${target.rel}`);
843
947
  sendJson(res, 200, { ok: true, path: target.rel });
844
948
  }
845
949
  catch (err) {
@@ -856,7 +960,7 @@ function playSnapEnabled() {
856
960
  // The builtin Files + code-editor backend: list / read / write deck files and
857
961
  // report kit-owned editor extensions. Paths are deck-relative; resolveDeckPath
858
962
  // rejects traversal and protected dirs.
859
- function handleFilesApi(deckDir, req, res, reqPath, restart, invalidate, tuneLedger) {
963
+ function handleFilesApi(deckDir, req, res, reqPath, restart, invalidate, tuneLedger, log) {
860
964
  const action = reqPath.slice(FILES_API_PREFIX.length);
861
965
  if (action === 'info') {
862
966
  const config = readEditorConfig(deckDir);
@@ -1023,27 +1127,27 @@ function handleFilesApi(deckDir, req, res, reqPath, restart, invalidate, tuneLed
1023
1127
  return true;
1024
1128
  }
1025
1129
  if (action === 'copy') {
1026
- handleFilesCopy(deckDir, req, res);
1130
+ handleFilesCopy(deckDir, req, res, log);
1027
1131
  return true;
1028
1132
  }
1029
1133
  if (action === 'write') {
1030
- handleFilesWrite(deckDir, req, res, tuneLedger);
1134
+ handleFilesWrite(deckDir, req, res, tuneLedger, log);
1031
1135
  return true;
1032
1136
  }
1033
1137
  if (action === 'rename') {
1034
- handleFilesRename(deckDir, req, res);
1138
+ handleFilesRename(deckDir, req, res, log);
1035
1139
  return true;
1036
1140
  }
1037
1141
  if (action === 'delete') {
1038
- handleFilesDelete(deckDir, req, res);
1142
+ handleFilesDelete(deckDir, req, res, log);
1039
1143
  return true;
1040
1144
  }
1041
1145
  if (action === 'mkdir') {
1042
- handleFilesMkdir(deckDir, req, res);
1146
+ handleFilesMkdir(deckDir, req, res, log);
1043
1147
  return true;
1044
1148
  }
1045
1149
  if (action === 'upload') {
1046
- handleFilesUpload(deckDir, req, res);
1150
+ handleFilesUpload(deckDir, req, res, log);
1047
1151
  return true;
1048
1152
  }
1049
1153
  if (action === 'raw') {
@@ -1281,7 +1385,7 @@ export function createIdeServer(opts) {
1281
1385
  return handleCoverApi(deckDir, req, res);
1282
1386
  }
1283
1387
  if (reqPath.startsWith(FILES_API_PREFIX)) {
1284
- return handleFilesApi(deckDir, req, res, reqPath, opts.restart, opts.invalidate, opts.tuneLedger);
1388
+ return handleFilesApi(deckDir, req, res, reqPath, opts.restart, opts.invalidate, opts.tuneLedger, opts.log);
1285
1389
  }
1286
1390
  if (reqPath.startsWith(IMPORT_API_PREFIX)) {
1287
1391
  return handleImportApi(deckDir, req, res, reqPath, opts.restart);
@@ -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[]>;