castle-web-cli 0.4.233 → 0.4.235

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 (383) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +266 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +68 -5
  39. package/kits/base/sdk/hubRejoin.d.ts +4 -0
  40. package/kits/base/sdk/hubRejoin.js +15 -0
  41. package/kits/base/sdk/multiplayer.d.ts +7 -1
  42. package/kits/base/sdk/multiplayer.js +147 -40
  43. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  44. package/kits/base/sdk/party.d.ts +23 -0
  45. package/kits/base/sdk/party.js +91 -0
  46. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  47. package/kits/base/sdk/reconnectBudget.js +96 -0
  48. package/kits/base/sdk/save.d.ts +38 -1
  49. package/kits/base/sdk/save.js +79 -6
  50. package/kits/base/sdk/server/hub.d.ts +31 -1
  51. package/kits/base/sdk/server/hub.js +50 -3
  52. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  53. package/kits/base/sdk/server/storage.d.ts +4 -0
  54. package/kits/base/sdk/server/storage.js +19 -3
  55. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  56. package/kits/base/sdk/server/wrapper.js +10 -1
  57. package/kits/base/sdk/social.d.ts +9 -0
  58. package/kits/base/sdk/social.js +5 -0
  59. package/kits/hub-game/CLAUDE.md +123 -3
  60. package/kits/hub-game/README.md +63 -0
  61. package/kits/hub-game/castle.json +5 -5
  62. package/kits/hub-game/code/client/act.js +312 -0
  63. package/kits/hub-game/code/client/actionLayout.js +147 -0
  64. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  65. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  66. package/kits/hub-game/code/client/askSlot.js +117 -0
  67. package/kits/hub-game/code/client/avatar.js +4 -2
  68. package/kits/hub-game/code/client/avatarShare.js +2 -0
  69. package/kits/hub-game/code/client/backVisibility.js +13 -0
  70. package/kits/hub-game/code/client/ballot.js +15 -10
  71. package/kits/hub-game/code/client/build.js +16 -0
  72. package/kits/hub-game/code/client/chat.js +41 -5
  73. package/kits/hub-game/code/client/chatModeration.js +5 -0
  74. package/kits/hub-game/code/client/chrome.js +1148 -258
  75. package/kits/hub-game/code/client/crowdNames.js +241 -0
  76. package/kits/hub-game/code/client/decor.js +10 -4
  77. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  78. package/kits/hub-game/code/client/doorErrors.js +39 -0
  79. package/kits/hub-game/code/client/fall.js +18 -0
  80. package/kits/hub-game/code/client/farAvatars.js +233 -0
  81. package/kits/hub-game/code/client/firstJoin.js +9 -2
  82. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  83. package/kits/hub-game/code/client/frameBatch.js +5 -0
  84. package/kits/hub-game/code/client/grab.js +31 -11
  85. package/kits/hub-game/code/client/hookLayer.js +87 -8
  86. package/kits/hub-game/code/client/hudCopy.js +51 -0
  87. package/kits/hub-game/code/client/hudRate.js +20 -0
  88. package/kits/hub-game/code/client/idle.js +14 -2
  89. package/kits/hub-game/code/client/invites.js +231 -0
  90. package/kits/hub-game/code/client/joinError.js +9 -0
  91. package/kits/hub-game/code/client/labelsNear.js +31 -2
  92. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  93. package/kits/hub-game/code/client/layoutCache.js +264 -0
  94. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  95. package/kits/hub-game/code/client/loadingCover.js +148 -0
  96. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  97. package/kits/hub-game/code/client/menuRows.js +43 -0
  98. package/kits/hub-game/code/client/modelReady.js +7 -0
  99. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  100. package/kits/hub-game/code/client/padCues.js +112 -0
  101. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  102. package/kits/hub-game/code/client/padReadability.js +26 -0
  103. package/kits/hub-game/code/client/padRings.js +69 -0
  104. package/kits/hub-game/code/client/pushVisit.js +14 -0
  105. package/kits/hub-game/code/client/quality.js +205 -0
  106. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  107. package/kits/hub-game/code/client/safeLayout.js +338 -0
  108. package/kits/hub-game/code/client/safeStyle.js +42 -0
  109. package/kits/hub-game/code/client/say.js +12 -3
  110. package/kits/hub-game/code/client/shot.js +64 -10
  111. package/kits/hub-game/code/client/shotFit.js +56 -0
  112. package/kits/hub-game/code/client/signIn.js +28 -0
  113. package/kits/hub-game/code/client/state.js +53 -0
  114. package/kits/hub-game/code/client/talk.js +209 -45
  115. package/kits/hub-game/code/client/tiers.js +68 -66
  116. package/kits/hub-game/code/client/together.js +7 -2
  117. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  118. package/kits/hub-game/code/client/weakestTier.js +295 -0
  119. package/kits/hub-game/code/client/worldLabels.js +241 -0
  120. package/kits/hub-game/code/client/yours.js +10 -9
  121. package/kits/hub-game/code/npcDisplayText.js +55 -0
  122. package/kits/hub-game/code/server/act.js +124 -0
  123. package/kits/hub-game/code/server/actions.js +6 -1
  124. package/kits/hub-game/code/server/actors.js +2 -1
  125. package/kits/hub-game/code/server/analytics.js +83 -0
  126. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  127. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  128. package/kits/hub-game/code/server/companion.js +28 -3
  129. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  130. package/kits/hub-game/code/server/earned.js +22 -5
  131. package/kits/hub-game/code/server/frameBatch.js +183 -0
  132. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  133. package/kits/hub-game/code/server/history.js +2 -0
  134. package/kits/hub-game/code/server/hub.js +1306 -95
  135. package/kits/hub-game/code/server/idle.js +30 -1
  136. package/kits/hub-game/code/server/index.js +26 -4
  137. package/kits/hub-game/code/server/invites.js +19 -0
  138. package/kits/hub-game/code/server/labels.js +9 -1
  139. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  140. package/kits/hub-game/code/server/manifest.js +211 -3
  141. package/kits/hub-game/code/server/menu.js +31 -3
  142. package/kits/hub-game/code/server/npcs.js +226 -64
  143. package/kits/hub-game/code/server/observe.js +408 -0
  144. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  145. package/kits/hub-game/code/server/players.js +9 -1
  146. package/kits/hub-game/code/server/resumePose.js +152 -0
  147. package/kits/hub-game/code/server/say.js +1 -1
  148. package/kits/hub-game/code/server/standing.js +4 -5
  149. package/kits/hub-game/code/server/storageLimit.js +187 -0
  150. package/kits/hub-game/code/server/vis.js +67 -5
  151. package/kits/hub-game/code/shared/act.js +35 -0
  152. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  153. package/kits/hub-game/code/shared/loadStages.js +12 -0
  154. package/kits/hub-game/code/shared/quality.js +74 -0
  155. package/kits/hub-game/code/shared/say.js +2 -0
  156. package/kits/hub-game/code/shared/shot.js +35 -1
  157. package/kits/hub-game/code/systems/hub.js +970 -169
  158. package/kits/hub-game/docs/analytics.md +279 -0
  159. package/kits/hub-game/docs/contract.md +1259 -42
  160. package/kits/hub-game/docs/home-pieces.md +9 -2
  161. package/kits/hub-game/docs/observed-progress.md +252 -0
  162. package/kits/hub-game/main.jsx +2 -0
  163. package/kits/hub-game/package-lock.json +10 -3
  164. package/kits/hub-game/package.json +6 -3
  165. package/kits/hub-game/play/player.js +142 -0
  166. package/kits/hub-game/play/registry.js +47 -0
  167. package/kits/hub-game/play.jsx +37 -0
  168. package/kits/hub-game/scripts/check.mjs +39 -5
  169. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  170. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  171. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  172. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  173. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  174. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  175. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  176. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  177. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  178. package/kits/hub-game/scripts/test-act.mjs +171 -0
  179. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  180. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  181. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  182. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  183. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  184. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  185. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  186. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  187. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  188. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  189. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  190. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  191. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  192. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  193. package/kits/hub-game/scripts/test-build.mjs +20 -2
  194. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  195. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  196. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  197. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  198. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  199. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  200. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  201. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  202. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  203. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  204. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  205. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  206. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  207. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  208. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  209. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  210. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  211. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  212. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  213. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  214. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  215. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  216. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  217. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  218. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  219. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  220. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  221. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  222. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  223. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  224. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  225. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  226. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  227. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  228. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  229. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  230. package/kits/hub-game/scripts/test-npcs.mjs +917 -10
  231. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  232. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  233. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  234. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  235. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  236. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  237. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  238. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  239. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  240. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  241. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  242. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  243. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  244. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  245. package/kits/hub-game/scripts/test-say.mjs +1 -1
  246. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  247. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  248. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  249. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  250. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  251. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  252. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  253. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  254. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  255. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  256. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  257. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  258. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  259. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  260. package/kits/multiplayer-3d/castle.json +5 -5
  261. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  262. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  263. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  264. package/kits/multiplayer-3d/package-lock.json +8 -1
  265. package/kits/multiplayer-3d/package.json +2 -1
  266. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  267. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  268. package/kits/physics-2d/CLAUDE.md +10 -1
  269. package/kits/physics-2d/castle.json +2 -2
  270. package/kits/physics-2d/engine/frozenActors.js +233 -0
  271. package/kits/physics-2d/engine/scene.js +87 -5
  272. package/kits/physics-2d/eslint.config.js +1 -1
  273. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  274. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  275. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  276. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  277. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  278. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  279. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  280. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  281. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  282. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  283. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  284. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  285. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  286. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  287. package/kits/physics-3d/CLAUDE.md +25 -1651
  288. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  289. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  291. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  292. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  293. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  294. package/kits/physics-3d/castle.json +3 -3
  295. package/kits/physics-3d/docs/engine-camera.md +542 -0
  296. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  297. package/kits/physics-3d/docs/engine-load.md +149 -0
  298. package/kits/physics-3d/docs/engine-look.md +114 -0
  299. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  300. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  301. package/kits/physics-3d/docs/engine-sky.md +198 -0
  302. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  303. package/kits/physics-3d/docs/engine-view.md +37 -0
  304. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  305. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  306. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  307. package/kits/physics-3d/engine3d/actornode.js +1 -0
  308. package/kits/physics-3d/engine3d/branches.js +3 -13
  309. package/kits/physics-3d/engine3d/cage.js +2 -7
  310. package/kits/physics-3d/engine3d/cageops.js +2 -17
  311. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  312. package/kits/physics-3d/engine3d/framecap.js +4 -1
  313. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  314. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  315. package/kits/physics-3d/engine3d/gait.js +8 -0
  316. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  317. package/kits/physics-3d/engine3d/look.js +7 -0
  318. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  319. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  320. package/kits/physics-3d/engine3d/modelready.js +16 -0
  321. package/kits/physics-3d/engine3d/motion.js +3 -3
  322. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  323. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  324. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  325. package/kits/physics-3d/engine3d/paths.js +1 -9
  326. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  327. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  328. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  329. package/kits/physics-3d/engine3d/rapier.js +27 -0
  330. package/kits/physics-3d/engine3d/scatter.js +1 -11
  331. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  332. package/kits/physics-3d/engine3d/sky.js +1 -1
  333. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  334. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  335. package/kits/physics-3d/engine3d/sweep.js +1 -25
  336. package/kits/physics-3d/engine3d/world3d.js +468 -18
  337. package/kits/physics-3d/eslint.config.js +2 -1
  338. package/kits/physics-3d/main.jsx +6 -3
  339. package/kits/physics-3d/package-lock.json +7 -0
  340. package/kits/physics-3d/package.json +5 -1
  341. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  342. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  343. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  344. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  345. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  346. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  347. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  348. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  349. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  350. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  351. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  352. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  353. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  354. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  355. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  356. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  357. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  358. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  359. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  361. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  362. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  363. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  364. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  365. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  366. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  367. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  368. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  369. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  370. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  371. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  372. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  373. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  374. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  375. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  376. package/kits/physics-3d/systems/physics3d.js +37 -4
  377. package/kits/real-time/castle.json +2 -2
  378. package/kits/real-time/code/client/connection.js +33 -10
  379. package/kits/real-time/code/client/gameHooks.js +2 -0
  380. package/kits/real-time/code/client/joinOverlay.js +9 -4
  381. package/kits/real-time/code/server/session.js +6 -4
  382. package/kits/real-time/package-lock.json +1 -1
  383. package/package.json +2 -2
package/dist/bundle.js CHANGED
@@ -1,10 +1,14 @@
1
+ import * as fs from 'fs';
1
2
  import * as path from 'path';
2
- import { build } from 'vite';
3
+ import { createHash } from 'crypto';
4
+ import { build, parseAst } from 'vite';
3
5
  import { viteSingleFile } from 'vite-plugin-singlefile';
4
- import { sceneFilesPlugin, importsAliasPlugin, forksOverlayPlugin, sdkAliasPlugin, singleFileBuildCompatPlugin, } from './vitePlugins.js';
6
+ import { sceneFilesPlugin, importsAliasPlugin, forksOverlayPlugin, sdkAliasPlugin, singleFileBuildCompatPlugin, castleWorkerOptions, } from './vitePlugins.js';
7
+ import { castleChunkBoot } from './chunkLoader.js';
5
8
  export async function bundleProject(dir) {
6
9
  const result = await build({
7
10
  root: dir,
11
+ worker: castleWorkerOptions(),
8
12
  plugins: [
9
13
  forksOverlayPlugin(),
10
14
  importsAliasPlugin(),
@@ -31,3 +35,555 @@ export async function bundleProject(dir) {
31
35
  }
32
36
  throw new Error('No HTML output found from build');
33
37
  }
38
+ // ---------------------------------------------------------------------------
39
+ // Classic chunked bundle (castle.json `"bundle": { "chunks": "classic" }`).
40
+ //
41
+ // The same deck build as bundleProject, split into classic-script chunks that a
42
+ // host serves at content-addressed URLs, so Android WebView's code cache keeps
43
+ // their compiled code across launches (chunkLoader.ts says why only classic
44
+ // scripts get that). The page itself keeps everything else inline: CSS as
45
+ // <style>, every asset as a data: URI, and a small boot script with the chunk
46
+ // map. Opt-in only; bundleProject's single file stays the default.
47
+ //
48
+ // One asset is the exception to "everything inline": a Rapier compat package's
49
+ // WebAssembly, which the package ships as a base64 string decoded and compiled
50
+ // on every launch. In chunked mode it becomes a wasm chunk of its own, fetched
51
+ // and compiled by streaming, which gets Chromium's wasm code cache.
52
+ /** Above this a chunk risks being too big for WebView's code cache (~4-5 MB). */
53
+ export const CHUNK_WARN_BYTES = 3 * 1024 * 1024;
54
+ // Third-party code split out by package. Grouping modules into a chunk by
55
+ // path moves their side effects relative to the rest of the graph, and rolldown
56
+ // also hoists any shared chunk's require above the importer's own code; so the
57
+ // build sets `strictExecutionOrder`, which wraps each module's top level in an
58
+ // init function that runs in import order whatever chunk it lands in. That is
59
+ // what keeps `import "./setup.js"; import "vendor"` running setup first, as the
60
+ // single file does.
61
+ const CHUNK_GROUPS = [
62
+ { name: 'rapier', test: /[\\/]node_modules[\\/]@dimforge[\\/]/, priority: 3 },
63
+ { name: 'three', test: /[\\/]node_modules[\\/]three[\\/]/, priority: 2 },
64
+ { name: 'vendor', test: /[\\/]node_modules[\\/]/, priority: 1, maxSize: 2 * 1024 * 1024 },
65
+ ];
66
+ export function wrapChunk(name, code) {
67
+ return (`__castleDefine(${JSON.stringify(name)},function(require,module,exports,__castleImport,__castleUrl,__castleMeta){"use strict";\n` +
68
+ `${code}\n});\n`);
69
+ }
70
+ function walk(node, visit) {
71
+ if (Array.isArray(node)) {
72
+ for (const child of node)
73
+ walk(child, visit);
74
+ return;
75
+ }
76
+ if (!node || typeof node !== 'object' || typeof node.type !== 'string')
77
+ return;
78
+ // `false` skips the node's children (it was replaced whole).
79
+ if (visit(node) === false)
80
+ return;
81
+ for (const key of Object.keys(node)) {
82
+ const value = node[key];
83
+ if (value && typeof value === 'object')
84
+ walk(value, visit);
85
+ }
86
+ }
87
+ function unparen(node) {
88
+ let n = node;
89
+ while (n && n.type === 'ParenthesizedExpression')
90
+ n = n.expression;
91
+ return n;
92
+ }
93
+ // The value of a string literal or a template literal with no substitutions.
94
+ function staticString(node) {
95
+ const n = unparen(node);
96
+ if (!n)
97
+ return null;
98
+ if (n.type === 'Literal' && typeof n.value === 'string')
99
+ return n.value;
100
+ if (n.type === 'TemplateLiteral' && n.expressions.length === 0) {
101
+ const cooked = n.quasis[0]?.value.cooked;
102
+ return typeof cooked === 'string' ? cooked : null;
103
+ }
104
+ return null;
105
+ }
106
+ // `<callee>("<literal>")`: the literal, or null.
107
+ function callOf(node, callee) {
108
+ if (node.type !== 'CallExpression')
109
+ return null;
110
+ const fn = unparen(node.callee);
111
+ const args = node.arguments;
112
+ if (!fn || fn.type !== 'Identifier' || fn.name !== callee || args.length !== 1)
113
+ return null;
114
+ return staticString(args[0]);
115
+ }
116
+ // rolldown's CJS form of `import('./x.js')` between chunks:
117
+ // Promise.resolve().then(() => require('./x.js'))
118
+ // The sibling chunk's name, or null.
119
+ function dynamicChunkImport(node) {
120
+ if (node.type !== 'CallExpression' || node.arguments.length !== 1)
121
+ return null;
122
+ const then = unparen(node.callee);
123
+ if (!then || then.type !== 'MemberExpression' || then.computed)
124
+ return null;
125
+ if (then.property.type !== 'Identifier' ||
126
+ then.property.name !== 'then')
127
+ return null;
128
+ const resolved = unparen(then.object);
129
+ if (!resolved || resolved.type !== 'CallExpression' || resolved.arguments.length)
130
+ return null;
131
+ const resolve = unparen(resolved.callee);
132
+ if (!resolve || resolve.type !== 'MemberExpression' || resolve.computed)
133
+ return null;
134
+ const promise = unparen(resolve.object);
135
+ if (promise?.type !== 'Identifier' || promise.name !== 'Promise')
136
+ return null;
137
+ if (resolve.property.name !== 'resolve')
138
+ return null;
139
+ const arrow = unparen(node.arguments[0]);
140
+ if (!arrow || arrow.type !== 'ArrowFunctionExpression' || arrow.params.length)
141
+ return null;
142
+ let body = unparen(arrow.body);
143
+ if (body?.type === 'BlockStatement') {
144
+ const stmts = body.body;
145
+ if (stmts.length !== 1 || stmts[0].type !== 'ReturnStatement')
146
+ return null;
147
+ body = unparen(stmts[0].argument);
148
+ }
149
+ const target = body ? callOf(body, 'require') : null;
150
+ return target?.startsWith('./') ? target.slice(2) : null;
151
+ }
152
+ function parseChunk(name, code) {
153
+ try {
154
+ return parseAst(code);
155
+ }
156
+ catch (e) {
157
+ throw new Error(`Chunked bundle: could not parse ${name}: ${e.message}`);
158
+ }
159
+ }
160
+ const isIdentifier = (node, name) => node?.type === 'Identifier' &&
161
+ (name === undefined || node.name === name);
162
+ // `function () { return x; }`: a getter that only reads a binding.
163
+ function isBindingGetter(node) {
164
+ const fn = unparen(node);
165
+ if (fn?.type !== 'FunctionExpression' || fn.params.length)
166
+ return false;
167
+ const stmts = fn.body.body;
168
+ return (stmts.length === 1 && stmts[0].type === 'ReturnStatement' && isIdentifier(stmts[0].argument));
169
+ }
170
+ // One of rolldown's export definitions, as a getter to define up front:
171
+ // Object.defineProperty(exports, "x", { enumerable: !0, get: function () { return y; } })
172
+ // exports.x = y
173
+ // or null for anything else.
174
+ function exportDefinition(node, code) {
175
+ const n = unparen(node);
176
+ if (n?.type === 'CallExpression') {
177
+ const callee = unparen(n.callee);
178
+ const args = n.arguments.map(unparen);
179
+ const options = args[2];
180
+ if (callee?.type === 'MemberExpression' &&
181
+ !callee.computed &&
182
+ isIdentifier(unparen(callee.object), 'Object') &&
183
+ isIdentifier(callee.property, 'defineProperty') &&
184
+ args.length === 3 &&
185
+ isIdentifier(args[0], 'exports') &&
186
+ staticString(args[1]) !== null &&
187
+ options?.type === 'ObjectExpression' &&
188
+ options.properties.some((p) => isIdentifier(p.key, 'get')) &&
189
+ options.properties.every((p) => {
190
+ if (p.type !== 'Property' || p.computed || p.kind !== 'init')
191
+ return false;
192
+ const value = unparen(p.value);
193
+ if (isIdentifier(p.key, 'get'))
194
+ return isBindingGetter(value);
195
+ if (!isIdentifier(p.key, 'enumerable'))
196
+ return false;
197
+ return (value?.type === 'Literal' ||
198
+ (value?.type === 'UnaryExpression' && unparen(value.argument)?.type === 'Literal'));
199
+ })) {
200
+ return code.slice(n.start, n.end);
201
+ }
202
+ }
203
+ if (n?.type === 'AssignmentExpression' && n.operator === '=') {
204
+ const left = unparen(n.left);
205
+ const right = unparen(n.right);
206
+ if (left?.type === 'MemberExpression' &&
207
+ isIdentifier(unparen(left.object), 'exports') &&
208
+ isIdentifier(right)) {
209
+ const key = left.computed
210
+ ? staticString(left.property)
211
+ : isIdentifier(left.property)
212
+ ? left.property.name
213
+ : null;
214
+ if (key !== null) {
215
+ return `Object.defineProperty(exports,${JSON.stringify(key)},{enumerable:!0,get:function(){return ${right.name}}})`;
216
+ }
217
+ }
218
+ }
219
+ return null;
220
+ }
221
+ /**
222
+ * Turns a rolldown CJS chunk into one the chunk loader runs, working on the
223
+ * parsed chunk so code inside a string or comment is never touched:
224
+ *
225
+ * - `import()` of another chunk becomes a loader call that fetches it (and its
226
+ * static deps) as classic scripts. Throws when a require of a chunk outside
227
+ * `staticImports` is left over -- a dynamic import in a form this does not
228
+ * recognize, which would require a chunk nobody loaded.
229
+ * - The chunk's export definitions, which rolldown writes at its end, move to
230
+ * its start as getters. Chunks can require each other in a cycle (the entry
231
+ * and a chunk it shares code with), and under `strictExecutionOrder` a chunk
232
+ * runs its modules before reaching its end: a chunk in the cycle that calls
233
+ * back into this one must find the exports there already, as ES modules'
234
+ * live bindings would be.
235
+ *
236
+ * Also returns the `__castleUrl("<name>")` names the chunk uses.
237
+ */
238
+ export function rewriteChunkCalls(name, code, staticImports) {
239
+ const edits = [];
240
+ const urls = [];
241
+ const program = parseChunk(name, code);
242
+ const hoisted = [];
243
+ for (const stmt of program.body) {
244
+ if (stmt.type !== 'ExpressionStatement')
245
+ continue;
246
+ const expr = unparen(stmt.expression);
247
+ const parts = expr.type === 'SequenceExpression' ? expr.expressions : [expr];
248
+ for (const part of parts) {
249
+ const definition = exportDefinition(part, code);
250
+ if (definition === null)
251
+ continue;
252
+ hoisted.push(definition);
253
+ edits.push({ start: part.start, end: part.end, text: 'void 0' });
254
+ }
255
+ }
256
+ walk(program, (node) => {
257
+ const lazy = dynamicChunkImport(node);
258
+ if (lazy !== null) {
259
+ edits.push({
260
+ start: node.start,
261
+ end: node.end,
262
+ text: `__castleImport(${JSON.stringify(lazy)})`,
263
+ });
264
+ return false;
265
+ }
266
+ const required = callOf(node, 'require');
267
+ if (required?.startsWith('./') && !staticImports.includes(required.slice(2))) {
268
+ throw new Error(`Chunked bundle: ${name} requires ${required.slice(2)} in a form the chunk loader does not recognize.`);
269
+ }
270
+ const url = callOf(node, '__castleUrl');
271
+ if (url !== null)
272
+ urls.push(url);
273
+ });
274
+ let out = code;
275
+ for (const edit of edits.sort((a, b) => b.start - a.start))
276
+ out = out.slice(0, edit.start) + edit.text + out.slice(edit.end);
277
+ if (hoisted.length > 0)
278
+ out = `${hoisted.join(';')};\n${out}`;
279
+ return { code: out, urls };
280
+ }
281
+ // rolldown's CommonJS output turns `import.meta` into `{}`, so a module's
282
+ // `import.meta.url` would read undefined. Chunked mode only, after Vite's own
283
+ // transforms (so `new URL("./x.png", import.meta.url)` assets are resolved):
284
+ // every `import.meta` in a module becomes that module's own stand-in object,
285
+ // { url, resolve, env: import.meta.env, hot: import.meta.hot }
286
+ // whose url and resolve come from the loader's `__castleMeta` for the chunk it
287
+ // runs in -- the chunk's absolute URL, which is what a bundler gives a module's
288
+ // `import.meta.url` anyway -- and whose env and hot are left to Vite's define,
289
+ // which replaces those two expressions after this. So computed access
290
+ // (`import.meta["url"]`), destructuring and passing `import.meta` around all
291
+ // see the same object. Direct `import.meta.env` / `import.meta.hot` reads stay
292
+ // as they are, for define to replace in place.
293
+ const DEFINED_META_FIELDS = new Set(['env', 'hot']);
294
+ const IMPORT_META_HELPER = '__castleImportMeta';
295
+ // `import . meta` and `import /* x */ .meta` are the same MetaProperty, so the
296
+ // prefilter allows whitespace and comments around the dot.
297
+ const META_GAP = String.raw `(?:\s|\/\*[\s\S]*?\*\/|\/\/[^\n]*\n)*`;
298
+ const IMPORT_META_LOOSE = new RegExp(String.raw `\bimport${META_GAP}\.${META_GAP}meta\b`);
299
+ export function importMetaPlugin() {
300
+ return {
301
+ name: 'castle-chunk-import-meta',
302
+ enforce: 'post',
303
+ transform(code, id) {
304
+ if (!IMPORT_META_LOOSE.test(code))
305
+ return null;
306
+ let ast;
307
+ try {
308
+ ast = parseAst(code, { sourceType: 'module' });
309
+ }
310
+ catch (e) {
311
+ throw new Error(`Chunked bundle: could not read ${id} to give its import.meta a URL: ${e.message}`);
312
+ }
313
+ const isImportMeta = (node) => {
314
+ const n = unparen(node);
315
+ return (n?.type === 'MetaProperty' &&
316
+ isIdentifier(n.meta, 'import') &&
317
+ isIdentifier(n.property, 'meta'));
318
+ };
319
+ const leftForDefine = new Set();
320
+ const metas = [];
321
+ walk(ast, (node) => {
322
+ if (node.type === 'MemberExpression' &&
323
+ !node.computed &&
324
+ isImportMeta(node.object) &&
325
+ isIdentifier(node.property) &&
326
+ DEFINED_META_FIELDS.has(node.property.name)) {
327
+ leftForDefine.add(unparen(node.object).start);
328
+ }
329
+ if (isImportMeta(node))
330
+ metas.push(node);
331
+ });
332
+ const edits = metas.filter((m) => !leftForDefine.has(m.start));
333
+ if (edits.length === 0)
334
+ return null;
335
+ let out = code;
336
+ for (const edit of edits.sort((a, b) => b.start - a.start))
337
+ out = out.slice(0, edit.start) + `${IMPORT_META_HELPER}()` + out.slice(edit.end);
338
+ // A hoisted function, so a module whose functions run before its own top
339
+ // level (a cycle) still has one; built once, so it is one object.
340
+ const helper = `var ${IMPORT_META_HELPER}$value;` +
341
+ `function ${IMPORT_META_HELPER}(){return ${IMPORT_META_HELPER}$value||(${IMPORT_META_HELPER}$value=` +
342
+ `{url:__castleMeta.url,resolve:__castleMeta.resolve,env:import.meta.env,hot:import.meta.hot})}\n`;
343
+ const shebang = out.startsWith('#!') ? out.indexOf('\n') + 1 : 0;
344
+ out = out.slice(0, shebang) + helper + out.slice(shebang);
345
+ return { code: out, map: null };
346
+ },
347
+ };
348
+ }
349
+ // The compat packages (`@dimforge/rapier3d-compat`, `rapier2d-compat`, ...)
350
+ // initialize with their wasm decoded from an inline base64 string, through the
351
+ // wasm-bindgen init's deprecated positional form:
352
+ // init(base64.toByteArray("AGFzbQ...").buffer)
353
+ // Given `{ module_or_path: url }` instead, that same init fetches the URL and
354
+ // compiles it with WebAssembly.instantiateStreaming, falling back to
355
+ // arrayBuffer + instantiate when a server sends the wrong MIME type.
356
+ const RAPIER_COMPAT_MODULE = /[\\/]@dimforge[\\/](rapier[23]d(?:-simd)?-compat)[\\/][^\\/]+\.[cm]?js$/;
357
+ const RAPIER_INLINE_WASM = /\b([\w$]+)\(([\w$]+)\.toByteArray\((["'`])([A-Za-z0-9+/=]{1000,})\3\)(?:\.buffer)?\)/;
358
+ const WASM_MAGIC = Buffer.from([0x00, 0x61, 0x73, 0x6d]);
359
+ /**
360
+ * Chunked mode only: moves a Rapier compat package's inline wasm out of its JS
361
+ * into `wasm` (name -> bytes), and points the package's init at the loader's
362
+ * URL for it. A compat module with no inline wasm in the recognized form is
363
+ * left as it is and named in `missed`.
364
+ */
365
+ export function rapierWasmPlugin(wasm, missed) {
366
+ return {
367
+ name: 'castle-rapier-wasm-chunk',
368
+ transform(code, id) {
369
+ const pkg = id.split('?')[0].match(RAPIER_COMPAT_MODULE)?.[1];
370
+ if (!pkg)
371
+ return null;
372
+ const found = code.match(RAPIER_INLINE_WASM);
373
+ if (!found) {
374
+ // The module that carries the wasm is the megabytes-long one.
375
+ if (code.length > 500_000)
376
+ missed.push(pkg);
377
+ return null;
378
+ }
379
+ const bytes = Buffer.from(found[4], 'base64');
380
+ if (!bytes.subarray(0, 4).equals(WASM_MAGIC)) {
381
+ missed.push(pkg);
382
+ return null;
383
+ }
384
+ // Named by content: two copies of a package (different versions, say)
385
+ // must not share a name, or one would load the other's wasm.
386
+ const name = `${pkg}-${sha256Hex(bytes).slice(0, 12)}.wasm`;
387
+ wasm.set(name, bytes);
388
+ const init = `${found[1]}({module_or_path:__castleUrl(${JSON.stringify(name)})})`;
389
+ return { code: code.replace(found[0], () => init), map: null };
390
+ },
391
+ };
392
+ }
393
+ function escapeRegExp(text) {
394
+ return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
395
+ }
396
+ export function sha256Hex(bytes) {
397
+ return typeof bytes === 'string'
398
+ ? createHash('sha256').update(bytes, 'utf8').digest('hex')
399
+ : createHash('sha256').update(bytes).digest('hex');
400
+ }
401
+ // JSON safe to put inside an inline <script>.
402
+ function scriptJson(value) {
403
+ return JSON.stringify(value).replace(/</g, '\\u003c');
404
+ }
405
+ export async function bundleProjectChunked(dir) {
406
+ const wasm = new Map();
407
+ const missedWasm = [];
408
+ const result = await build({
409
+ root: dir,
410
+ base: './',
411
+ plugins: [
412
+ forksOverlayPlugin(),
413
+ importsAliasPlugin(),
414
+ sdkAliasPlugin(),
415
+ sceneFilesPlugin(),
416
+ rapierWasmPlugin(wasm, missedWasm),
417
+ importMetaPlugin(),
418
+ ],
419
+ build: {
420
+ write: false,
421
+ // Every asset stays a data: URI, as in the single file: the page fetches
422
+ // nothing but its chunks.
423
+ assetsInlineLimit: () => true,
424
+ cssCodeSplit: false,
425
+ modulePreload: false,
426
+ chunkSizeWarningLimit: 100_000_000,
427
+ rollupOptions: {
428
+ input: path.join(dir, 'index.html'),
429
+ output: {
430
+ format: 'cjs',
431
+ entryFileNames: '[name]-[hash].js',
432
+ chunkFileNames: '[name]-[hash].js',
433
+ codeSplitting: { groups: CHUNK_GROUPS },
434
+ strictExecutionOrder: true,
435
+ },
436
+ },
437
+ },
438
+ logLevel: 'silent',
439
+ });
440
+ const output = Array.isArray(result) ? result[0] : result;
441
+ if (!('output' in output))
442
+ throw new Error('Unexpected build result');
443
+ let html = null;
444
+ const css = [];
445
+ const built = [];
446
+ const stray = [];
447
+ for (const item of output.output) {
448
+ if (item.type === 'chunk') {
449
+ built.push({
450
+ name: item.fileName,
451
+ code: item.code,
452
+ imports: item.imports,
453
+ isEntry: item.isEntry,
454
+ });
455
+ }
456
+ else if (item.fileName.endsWith('.html')) {
457
+ html = String(item.source);
458
+ }
459
+ else if (item.fileName.endsWith('.css')) {
460
+ css.push({ fileName: item.fileName, source: String(item.source) });
461
+ }
462
+ else {
463
+ stray.push(item.fileName);
464
+ }
465
+ }
466
+ if (html === null)
467
+ throw new Error('No HTML output found from build');
468
+ if (stray.length > 0) {
469
+ throw new Error(`Chunked bundle: the build emitted files a published deck cannot serve: ${stray.join(', ')}. ` +
470
+ 'Only JS chunks and inline CSS are published; import the asset so it is inlined.');
471
+ }
472
+ const entries = built.filter((c) => c.isEntry);
473
+ if (entries.length !== 1)
474
+ throw new Error(`Chunked bundle: expected one entry chunk, got ${entries.length}.`);
475
+ const entry = entries[0].name;
476
+ for (const c of built) {
477
+ if (c.name.includes('/'))
478
+ throw new Error(`Chunked bundle: unexpected nested chunk path ${c.name}.`);
479
+ }
480
+ // The entry's static closure loads up front; every other chunk loads when
481
+ // imported. Tag order is only for readability (the entry last): defining a
482
+ // chunk runs nothing, and the entry starts once all of them have registered.
483
+ const byName = new Map(built.map((c) => [c.name, c]));
484
+ const initial = [];
485
+ const visit = (name) => {
486
+ if (initial.includes(name))
487
+ return;
488
+ initial.push(name);
489
+ for (const dep of byName.get(name)?.imports ?? [])
490
+ visit(dep);
491
+ };
492
+ visit(entry);
493
+ const chunks = built.map((c) => {
494
+ const { code: body, urls } = rewriteChunkCalls(c.name, c.code.replace(/"?__VITE_PRELOAD__"?/g, 'void 0'), c.imports);
495
+ for (const target of urls) {
496
+ if (!wasm.has(target))
497
+ throw new Error(`Chunked bundle: ${c.name} names an unknown asset ${target}.`);
498
+ }
499
+ const bytes = Buffer.from(wrapChunk(c.name, body), 'utf8');
500
+ const sha256 = sha256Hex(bytes);
501
+ return {
502
+ kind: 'js',
503
+ name: c.name,
504
+ sha256,
505
+ fileName: `${sha256}.js`,
506
+ bytes,
507
+ initial: initial.includes(c.name),
508
+ };
509
+ });
510
+ for (const [name, bytes] of wasm) {
511
+ const sha256 = sha256Hex(bytes);
512
+ chunks.push({ kind: 'wasm', name, sha256, fileName: `${sha256}.wasm`, bytes, initial: false });
513
+ }
514
+ const warnings = chunks
515
+ .filter((c) => c.kind === 'js' && c.bytes.byteLength > CHUNK_WARN_BYTES)
516
+ .map((c) => `Chunk ${c.name} is ${(c.bytes.byteLength / 1024 / 1024).toFixed(1)}MB; ` +
517
+ 'WebView skips caching compiled code for scripts above about 4MB.');
518
+ for (const pkg of new Set(missedWasm)) {
519
+ warnings.push(`${pkg}: its wasm is not in the inline form the chunked bundle splits out, so it stays ` +
520
+ 'inside the script (compiled on every launch).');
521
+ }
522
+ // The module script Vite wrote becomes the boot; its stylesheet becomes <style>.
523
+ let page = html;
524
+ for (const sheet of css) {
525
+ const link = new RegExp(`<link([^>]*?) href="(?:[^"]*?/)?${escapeRegExp(sheet.fileName)}"([^>]*)>`);
526
+ if (!link.test(page))
527
+ throw new Error(`Chunked bundle: no <link> for ${sheet.fileName} in the page.`);
528
+ const sheetCode = sheet.source
529
+ .replace('@charset "UTF-8";', '')
530
+ .trim()
531
+ .replace(/<\/style/gi, '<\\/style');
532
+ page = page.replace(link, () => `<style>${sheetCode}</style>`);
533
+ }
534
+ const moduleScript = /<script type="module"[^>]*\ssrc="[^"]*"[^>]*><\/script>/g;
535
+ const found = page.match(moduleScript) ?? [];
536
+ if (found.length !== 1 || !found[0].includes(entry)) {
537
+ throw new Error(`Chunked bundle: expected the page to load only ${entry}, found ${found.length} module scripts.`);
538
+ }
539
+ const named = new Map(chunks.map((c) => [c.name, c]));
540
+ const orderedInitial = [...initial].reverse();
541
+ const SLOT = '\u0000castle-chunks\u0000';
542
+ const template = page.replace(moduleScript, SLOT);
543
+ return {
544
+ chunks,
545
+ warnings,
546
+ renderHtml(baseUrl) {
547
+ const url = (name) => `${baseUrl}${named.get(name).fileName}`;
548
+ const map = {};
549
+ for (const c of built)
550
+ map[c.name] = [url(c.name), c.imports];
551
+ for (const name of wasm.keys())
552
+ map[name] = [url(name), []];
553
+ const boot = `<script>(${castleChunkBoot.toString()})(${scriptJson(map)},${scriptJson(entry)},${scriptJson(orderedInitial)});</script>`;
554
+ const tags = orderedInitial
555
+ .map((name) => `<script defer crossorigin="anonymous" src="${url(name)}"></script>`)
556
+ .join('');
557
+ return template.replace(SLOT, () => boot + tags);
558
+ },
559
+ };
560
+ }
561
+ /**
562
+ * `castle-web bundle-chunks`: the chunked page and its chunks written to
563
+ * `outDir` (`index.html` and `<sha256>.js` files), the page naming each chunk at
564
+ * `<baseUrl><sha256>.js`. The default `./` serves from the same directory, so
565
+ * any static file server on it can play the deck (a phone on the LAN, say).
566
+ */
567
+ export async function writeChunkedBundle(dir, outDir, baseUrl = './') {
568
+ const bundle = await bundleProjectChunked(dir);
569
+ fs.mkdirSync(outDir, { recursive: true });
570
+ for (const chunk of bundle.chunks)
571
+ fs.writeFileSync(path.join(outDir, chunk.fileName), chunk.bytes);
572
+ fs.writeFileSync(path.join(outDir, 'index.html'), bundle.renderHtml(baseUrl));
573
+ return bundle;
574
+ }
575
+ export async function bundleChunksCommand(dir, out, baseUrl) {
576
+ if (!out) {
577
+ console.error('bundle-chunks needs --out DIR.');
578
+ process.exit(1);
579
+ }
580
+ const outDir = path.resolve(out);
581
+ const bundle = await writeChunkedBundle(path.resolve(dir), outDir, baseUrl);
582
+ for (const chunk of bundle.chunks) {
583
+ const kb = (chunk.bytes.byteLength / 1024).toFixed(1);
584
+ console.log(`${chunk.fileName} ${kb.padStart(8)}KB ${chunk.kind === 'wasm' ? 'wasm ' : chunk.initial ? 'start' : 'lazy '} ${chunk.name}`);
585
+ }
586
+ for (const warning of bundle.warnings)
587
+ console.warn(`Warning: ${warning}`);
588
+ console.log(`Wrote ${bundle.chunks.length} chunks and index.html to ${outDir}`);
589
+ }
@@ -44,8 +44,16 @@ export type PlatformHandler = (
44
44
  ctx: HostContext,
45
45
  ) => Promise<unknown>;
46
46
 
47
+ export interface HubChatBlockTarget {
48
+ userId: string;
49
+ username: string | null;
50
+ }
51
+
52
+ export type HubChatBlockConfirmation = (target: HubChatBlockTarget, signal?: AbortSignal) => Promise<boolean>;
53
+
47
54
  export interface HostCapabilities {
48
55
  graphqlFetch: GraphqlFetch;
56
+ confirmHubChatBlock?: (target: HubChatBlockTarget, ctx: HostContext, signal?: AbortSignal) => Promise<boolean>;
49
57
  localHubHearts?: Map<string, string[]>;
50
58
  platformHandler?: PlatformHandler;
51
59
  oracleStream?: OracleStream;
@@ -176,6 +184,11 @@ export interface HubFriend {
176
184
  userId: string;
177
185
  username: string | null;
178
186
  here: boolean;
187
+ // Set for a friend inside the place behind one of this place's doors.
188
+ door: string | null;
189
+ // A friend at home in their House behind `door`: the owner Hub.go visits.
190
+ home?: true;
191
+ ownerUserId?: string;
179
192
  }
180
193
 
181
194
  export type HubFriendsResult =
@@ -184,6 +197,7 @@ export type HubFriendsResult =
184
197
 
185
198
  export interface HubReportResult {
186
199
  status: 'ok' | 'unavailable';
200
+ blocked?: true;
187
201
  }
188
202
 
189
203
  export interface HubChatMessage {
@@ -212,7 +226,8 @@ export interface HubCancelResult {
212
226
  }
213
227
 
214
228
  export interface HostHub {
215
- go(doorId: string, ctx: HostContext, signal?: AbortSignal): Promise<HubHandoffResult>;
229
+ // `ownerUserId`: a House door only, the friend whose House to visit.
230
+ go(doorId: string, ctx: HostContext, signal?: AbortSignal, ownerUserId?: string): Promise<HubHandoffResult>;
216
231
  back(ctx: HostContext, signal?: AbortSignal): Promise<HubHandoffResult>;
217
232
  doors(ctx: HostContext): Promise<HubDoorsResult>;
218
233
  friends?(ctx: HostContext): Promise<HubFriendsResult>;
@@ -220,7 +235,7 @@ export interface HostHub {
220
235
  report?(userId: string, reason: string | null, ctx: HostContext): Promise<HubReportResult>;
221
236
  chat?(after: string | null, ctx: HostContext): Promise<HubChatResult>;
222
237
  say?(text: string, ctx: HostContext): Promise<HubSayResult>;
223
- reportChat?(messageId: string, ctx: HostContext): Promise<HubReportResult>;
238
+ reportChat?(messageId: string, ctx: HostContext, block?: boolean, confirmBlock?: HubChatBlockConfirmation, signal?: AbortSignal): Promise<HubReportResult>;
224
239
  commit(sessionId: string, ctx: HostContext): Promise<HubCommitResult>;
225
240
  cancel(sessionId: string | null, ctx: HostContext): Promise<HubCancelResult>;
226
241
  sessionAcquired?(sessionId: string, ctx: HostContext): void;