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
@@ -0,0 +1,148 @@
1
+ // v1.126: page-owned chrome, released only by a completed world draw.
2
+ export let loadingCover = null;
3
+ export function startLoadingCover(options) {
4
+ loadingCover?.dispose();
5
+ loadingCover = makeLoadingCover(options);
6
+ }
7
+
8
+ export function makeLoadingCover({ enabled, title, document: doc = globalThis.document }) {
9
+ if (enabled !== true || !doc) { return null; }
10
+ const css = doc.createElement('style');
11
+ css.textContent = `
12
+ html[data-hub-loading] [data-hub-loading-chrome],
13
+ html[data-hub-loading] [data-hub-loading-chrome] * { visibility: hidden !important; }
14
+ html[data-hub-loading] { background: #000; cursor: none; }
15
+ [data-hub-loading-cover] { position: fixed; inset: 0; z-index: 2147482000;
16
+ display: flex; flex-direction: column; align-items: center; justify-content: center;
17
+ box-sizing: border-box; padding: 24px; background: #000; color: #fff; cursor: none;
18
+ font: 700 18px/1.3 system-ui, sans-serif; text-align: center; }
19
+ [data-hub-loading-cover] span { margin-bottom: 16px; overflow-wrap: anywhere; }
20
+ [data-hub-loading-cover] i { width: 36px; height: 36px; box-sizing: border-box;
21
+ border: 3px solid #ffffff40; border-top-color: #fff; border-radius: 50%;
22
+ animation: hub-loading-spin .8s linear infinite; }
23
+ @keyframes hub-loading-spin { to { transform: rotate(360deg); } }
24
+ `;
25
+ doc.head.append(css);
26
+ const cover = doc.createElement('div');
27
+ cover.setAttribute('data-hub-loading-cover', '');
28
+ cover.setAttribute('data-layout-backdrop', '');
29
+ cover.setAttribute('role', 'progressbar');
30
+ cover.setAttribute('aria-label', `Loading ${title || 'deck'}`);
31
+ const text = doc.createElement('span');
32
+ text.textContent = title || 'Loading…';
33
+ cover.append(text, doc.createElement('i'));
34
+ let covered = false, failed = false, binding = null, sceneNow = null;
35
+ let hiddenAt = null;
36
+ const now = () => doc.defaultView?.performance?.now?.() ?? performance.now();
37
+ const connected = () => sceneNow?.multiplayer?.net?.status?.()?.state === 'connected';
38
+ // The default player catches update/sync errors before reaching the
39
+ // composer. Its existing recovery layer is added to the DOM in that case.
40
+ // Watch only while covering, including startup before a world can bind.
41
+ const Observer = doc.defaultView?.MutationObserver;
42
+ const recovery = Observer ? new Observer((changes) => {
43
+ if (changes.some((change) => [...change.addedNodes].some((node) => node.nodeType === 1 &&
44
+ (node.style?.zIndex === '2147483000' || node.querySelector?.('[style*="z-index: 2147483000"]'))))) { fail(); }
45
+ }) : null;
46
+ function show() {
47
+ covered = true;
48
+ doc.documentElement.setAttribute('data-hub-loading', '');
49
+ // Outside #root: either entry can replace its children during startup.
50
+ doc.body.append(cover);
51
+ recovery?.observe(doc.body, { childList: true, subtree: true });
52
+ }
53
+ function hide() {
54
+ covered = false;
55
+ cover.remove();
56
+ doc.documentElement.removeAttribute('data-hub-loading');
57
+ recovery?.disconnect();
58
+ }
59
+ function visibility() {
60
+ if (doc.hidden) {
61
+ hiddenAt = now();
62
+ // A short connected app switch needs no extra black hub cover. The
63
+ // engine's independent room-current gate still protects stale poses.
64
+ if (!connected()) {show();}
65
+ } else {
66
+ if (hiddenAt !== null && (now() - hiddenAt >= 30_000 || !connected())) {show();}
67
+ hiddenAt = null;
68
+ }
69
+ }
70
+ function fail() {
71
+ if (!covered) { return; }
72
+ // Engine errors live inside the SDK's transformed game root. Remove this
73
+ // body-level surface so their existing retry UI is reachable, while still
74
+ // suppressing hub chrome. A restarted runtime restores the loading cover.
75
+ covered = false;
76
+ failed = true;
77
+ cover.remove();
78
+ recovery?.disconnect();
79
+ }
80
+ function unbind() {
81
+ if (binding && binding.composer.render === binding.wrapper) { binding.composer.render = binding.original; }
82
+ binding?.canvas?.removeEventListener('webglcontextlost', binding.lost);
83
+ binding = null;
84
+ }
85
+ doc.addEventListener('visibilitychange', visibility);
86
+ doc.defaultView?.addEventListener('error', fail);
87
+ show();
88
+ return {
89
+ sync(scene) {
90
+ sceneNow = scene;
91
+ if (failed) { failed = false; show(); }
92
+ const mp = scene.multiplayer;
93
+ if (!mp?.joined && mp?.coverText) {
94
+ text.textContent = mp.coverText();
95
+ cover.setAttribute('aria-label', text.textContent);
96
+ }
97
+ const state = mp?.net?.status?.()?.state;
98
+ // A classic cabinet deliberately leaves its session and disables joining;
99
+ // neither that nor a terminal failure is a pending reconnect.
100
+ const waiting = !mp?.joinError && !mp?.joinFailed && (state === 'reconnecting' || state === 'connecting' || state === 'acquiring' ||
101
+ (!mp?.net && mp?.starting));
102
+ if (waiting && !covered) { show(); }
103
+ const composer = scene.three?.composer;
104
+ if (!composer || binding?.composer === composer) { return; }
105
+ unbind();
106
+ const original = composer.render;
107
+ const canvas = scene.three?.renderer?.domElement;
108
+ // Both engine entries put their initial HUD and view controls beside the
109
+ // canvas. Mark those at binding time, before any later error overlay is
110
+ // created, so recovery UI remains visible while all game chrome is hidden.
111
+ for (const node of canvas?.parentElement?.children ?? []) {
112
+ if (node !== canvas) { node.setAttribute('data-hub-loading-chrome', ''); }
113
+ }
114
+ const lost = () => { show(); };
115
+ canvas?.addEventListener('webglcontextlost', lost);
116
+ const wrapper = function (...args) {
117
+ const renderer = scene.three?.renderer;
118
+ const before = renderer?.info?.render?.frame;
119
+ let result;
120
+ try { result = original.apply(this, args); }
121
+ catch (error) { fail(); throw error; }
122
+ // The composer has finished its output pass. A failed draw never clears
123
+ // the cover; a reconnect also waits for current placement and connection.
124
+ const drawn = Number.isFinite(before) && renderer.info.render.frame > before &&
125
+ !renderer.getContext().isContextLost();
126
+ const mp = scene.multiplayer;
127
+ const settled = mp?.net?.status?.()?.state === 'connected' && mp?.placed?.();
128
+ const stopped = mp?.joinError || mp?.joinFailed || mp?.net?.status?.()?.state === 'closed';
129
+ // Placement also keeps initial acquisition under the cover: otherwise
130
+ // a pre-join draw would uncover, then the next joining frame re-cover.
131
+ if (covered && drawn && !doc.hidden && (settled || stopped)) { hide(); }
132
+ return result;
133
+ };
134
+ composer.render = wrapper;
135
+ binding = { composer, original, wrapper, canvas, lost };
136
+ },
137
+ detach() { unbind(); sceneNow = null; },
138
+ fail,
139
+ dispose() {
140
+ unbind();
141
+ sceneNow = null;
142
+ doc.removeEventListener('visibilitychange', visibility);
143
+ doc.defaultView?.removeEventListener('error', fail);
144
+ hide();
145
+ css.remove();
146
+ },
147
+ };
148
+ }
@@ -0,0 +1,8 @@
1
+ import { isEdit } from 'castle-web-sdk';
2
+ import { startLoadingCover } from './loadingCover.js';
3
+
4
+ const config = Object.values(import.meta.glob('/castle.json', { eager: true, import: 'default' }))[0] ?? {};
5
+ startLoadingCover({
6
+ enabled: config.hub?.loadingCover === true && !isEdit(),
7
+ title: typeof config.title === 'string' ? config.title : '',
8
+ });
@@ -0,0 +1,43 @@
1
+ // Optional text rows in the existing place menu; the legacy tile path is untouched.
2
+ export function drawMenuRows({ el, sheet, scroll, spec, signal, pick }) {
3
+ for (const section of spec.sections) {
4
+ el('div', { fontSize: '13px', margin: '4px 0', overflowWrap: 'anywhere' }, scroll).textContent = section.title;
5
+ for (const item of section.items) {
6
+ const readOnly = spec.readOnly === true || item.readOnly === true;
7
+ const row = el(readOnly ? 'div' : 'button', {
8
+ width: '100%', boxSizing: 'border-box', minHeight: '32px', padding: '6px 8px',
9
+ display: 'grid', gridTemplateColumns: item.columns ? 'minmax(0, 1fr) minmax(0, 4fr) minmax(0, 2fr)' : '1fr',
10
+ alignItems: 'center', gap: '8px', textAlign: 'left',
11
+ color: 'inherit', font: 'inherit', lineHeight: '20px', background: 'transparent',
12
+ border: '0', borderBottom: '1px solid var(--castle-border-2, rgba(255,255,255,.25))',
13
+ overflowWrap: 'anywhere', touchAction: 'pan-y',
14
+ }, scroll);
15
+ row.dataset.menuRow = '';
16
+ row.dataset.id = item.id;
17
+ for (const [index, text] of (item.columns ?? [item.label]).entries()) {
18
+ el('span', { minWidth: '0', whiteSpace: 'normal', ...(index === 2 ? { textAlign: 'right' } : {}) }, row).textContent = text;
19
+ }
20
+ if (!readOnly) {
21
+ row.type = 'button';
22
+ row.setAttribute('aria-label', (item.columns ?? [item.label]).join(' · '));
23
+ row.addEventListener('click', () => { row.blur(); pick(item.id); }, { signal });
24
+ }
25
+ }
26
+ }
27
+ if (spec.footer?.length) {
28
+ const footer = el('div', { display: 'flex', gap: '8px', flexShrink: '0', paddingTop: '6px' }, sheet);
29
+ footer.dataset.menuFooter = '';
30
+ for (const item of spec.footer) {
31
+ const button = el('button', {
32
+ flex: '1 1 0', minWidth: '0', minHeight: '44px', padding: '8px',
33
+ color: 'inherit', font: 'inherit', whiteSpace: 'normal', overflowWrap: 'anywhere', touchAction: 'manipulation',
34
+ }, footer);
35
+ button.className = 'hub-menu-tile';
36
+ button.type = 'button';
37
+ button.dataset.id = item.id;
38
+ button.disabled = spec.readOnly === true;
39
+ button.textContent = item.label;
40
+ if (!button.disabled) { button.addEventListener('click', () => { button.blur(); pick(item.id); }, { signal }); }
41
+ }
42
+ }
43
+ }
@@ -0,0 +1,7 @@
1
+ // Before cloning or measuring another actor's model: on a scene with
2
+ // physics-3d's engine.load, a model may still be waiting to be built. The
3
+ // world fills it on demand. Called through the world rather than imported, so
4
+ // a deck pinned to a physics-3d without engine.load bundles and runs as before.
5
+ export function ensureActorModel(world, actorId) {
6
+ world?.modelLoad?.ensureActor?.(actorId);
7
+ }
@@ -0,0 +1,23 @@
1
+ import * as Blueprints from '@imports/castle.physics-2d/engine/blueprint';
2
+ import { padArrivalPoint } from './padCues.js';
3
+
4
+ // Local arrival is read by hookLayer from its existing bundled castle.json.
5
+ // Mounted packs already carry the normalized server place manifest.
6
+ export function readPadArrival(scene, place, localArrival) {
7
+ const arrival = scene.content ? scene.content.places?.[place?.id]?.arrival : localArrival;
8
+ const path = scene.currentScenePath;
9
+ const text = scene.files?.[path];
10
+ // The engine's file map includes authored scenes, including mounted packs.
11
+ // Never substitute mutable runtime data if that source is unavailable.
12
+ if (typeof text !== 'string') {return null;}
13
+ // Runs inside the frame loop: a malformed source omits the locator.
14
+ try {
15
+ const data = JSON.parse(text);
16
+ if (!Array.isArray(data?.actors)) {return null;}
17
+ const actors = data.actors.filter((actor) => actor && typeof actor === 'object').map((actor) => ({ id: actor.id,
18
+ components: Blueprints.mergeComponents(actor.blueprint ? Blueprints.getBlueprintTemplate(scene.files, actor.blueprint, path)?.components : null, actor.components) }));
19
+ return padArrivalPoint(actors, arrival);
20
+ } catch {
21
+ return null;
22
+ }
23
+ }
@@ -0,0 +1,112 @@
1
+ // Local readability only. No cue is an actor, action, trigger or wire field.
2
+ export const padCuesEnabled = (engine) => engine?.hubPadContext === true || engine?.hubPadRing === true || engine?.hubSpawnRing === true;
3
+
4
+ export function validatePadCue(value) {
5
+ if (!value || !Number.isFinite(value.radius) || value.radius < 0.3 || value.radius > 6) {return null;}
6
+ const cue = { radius: value.radius };
7
+ if (typeof value.title === 'string' && !/[\p{Cc}]/u.test(value.title)) {
8
+ const title = value.title.trim();
9
+ if ([...title].length >= 1 && [...title].length <= 24) {cue.title = title;}
10
+ }
11
+ return cue;
12
+ }
13
+
14
+ export function collectPadCues(actors, hidden) {
15
+ const doors = new Map();
16
+ for (const actor of actors) {
17
+ const door = actor.components?.HubDoor;
18
+ if (door) {doors.set(door.id, door.title);}
19
+ }
20
+ const cues = [];
21
+ for (const actor of actors) {
22
+ const c = actor.components;
23
+ if (!c || hidden?.has(actor.id) || !Number.isFinite(c.Transform?.x) || !Number.isFinite(c.Transform?.z)) {continue;}
24
+ const explicit = Object.hasOwn(c, 'HubPadCue');
25
+ const spec = explicit ? validatePadCue(c.HubPadCue) : c.HubPad;
26
+ if (!spec || !Number.isFinite(spec.radius) || spec.radius <= 0) {continue;}
27
+ const shape = c.Shape;
28
+ cues.push({ id: actor.id, x: c.Transform.x, z: c.Transform.z, radius: spec.radius,
29
+ y: (c.Transform.y ?? 0) + (shape?.kind === 'cylinder' ? (shape.height ?? 1) / 2 : 0) + 0.03,
30
+ title: explicit ? spec.title : doors.get(spec.door), door: !explicit,
31
+ color: shape?.color ?? '#d9a441' });
32
+ }
33
+ return cues;
34
+ }
35
+
36
+ const edge = (cue, body) => Math.hypot(cue.x - body.x, cue.z - body.z) - cue.radius;
37
+ const byId = (a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
38
+
39
+ // Standing wins over proximity. Retain an incumbent in its valid class;
40
+ // near incumbents leave at 2 m, new ones enter at 1.5 m from the edge.
41
+ export function selectPadCue(cues, body, current = null) {
42
+ if (!body || !Number.isFinite(body.x) || !Number.isFinite(body.z)) {return null;}
43
+ let on = null, nearest = null, distance = Infinity, retained = null;
44
+ for (const cue of cues) {
45
+ const d = edge(cue, body);
46
+ if (d <= 0 && (!on || byId(cue, on) < 0)) {on = cue;}
47
+ if (cue.id === current?.cue.id && d <= 2) {retained = cue;}
48
+ if (d <= 1.5 && (d < distance || (d === distance && byId(cue, nearest) < 0))) {
49
+ nearest = cue; distance = d;
50
+ }
51
+ }
52
+ const cue = on ? retained && edge(retained, body) <= 0 ? retained : on : retained ?? nearest;
53
+ return cue ? { cue, on: edge(cue, body) <= 0 } : null;
54
+ }
55
+
56
+ export function padContextText(active) {
57
+ return active?.cue.title ? { id: active.cue.id, title: active.cue.title,
58
+ secondary: !active.on && active.cue.door ? 'Step on to join' : '' } : null;
59
+ }
60
+
61
+ // Called each frame, but unchanged inputs allocate nothing and do not select
62
+ // again. Compare primitive values so in-place data edits and private hides
63
+ // invalidate even when the engine retains the same Map/Set identities.
64
+ export function makePadCueTracker() {
65
+ let records = [], count = 0, dirty = true, hiddenNow = null;
66
+ let cues = [], active = null, x = Infinity, z = Infinity;
67
+ function inspect(actor) {
68
+ const c = actor.components;
69
+ if (!c) {return;}
70
+ if (!c.HubPad && !Object.hasOwn(c, 'HubPadCue') && !c.HubDoor) {return;}
71
+ let r = records[count];
72
+ const t = c.Transform, p = c.HubPad, q = c.HubPadCue, d = c.HubDoor, s = c.Shape;
73
+ const hidden = hiddenNow?.has(actor.id) === true;
74
+ if (!r || r.actor !== actor || !Object.is(r.x, t?.x) || !Object.is(r.y, t?.y) || !Object.is(r.z, t?.z) ||
75
+ !Object.is(r.radius, p?.radius) || r.door !== p?.door || r.explicit !== Object.hasOwn(c, 'HubPadCue') ||
76
+ !Object.is(r.cueRadius, q?.radius) || r.title !== q?.title || r.doorId !== d?.id || r.doorTitle !== d?.title ||
77
+ r.kind !== s?.kind || !Object.is(r.height, s?.height) || r.color !== s?.color || r.hidden !== hidden) {
78
+ r = { actor, x: t?.x, y: t?.y, z: t?.z, radius: p?.radius, door: p?.door,
79
+ explicit: Object.hasOwn(c, 'HubPadCue'), cueRadius: q?.radius, title: q?.title, doorId: d?.id,
80
+ doorTitle: d?.title, kind: s?.kind, height: s?.height, color: s?.color, hidden };
81
+ records[count] = r; dirty = true;
82
+ }
83
+ count += 1;
84
+ }
85
+ return {
86
+ frame(actors, hidden, body) {
87
+ count = 0; hiddenNow = hidden;
88
+ actors.forEach(inspect);
89
+ if (records.length !== count) {records.length = count; dirty = true;}
90
+ if (dirty) {cues = collectPadCues(records.map((r) => r.actor), hidden);}
91
+ const validBody = Number.isFinite(body?.x) && Number.isFinite(body?.z);
92
+ if (dirty || !validBody || Math.hypot(body.x - x, body.z - z) > 0.05) {
93
+ active = selectPadCue(cues, body, active);
94
+ x = validBody ? body.x : Infinity; z = validBody ? body.z : Infinity; dirty = false;
95
+ }
96
+ return active;
97
+ },
98
+ };
99
+ }
100
+
101
+ // Same §5 precedence as server/hub.js arrivalPoint, from authored, resolved
102
+ // components (never a Player's moving runtime Transform).
103
+ export function padArrivalPoint(actors, arrival) {
104
+ const actor = arrival?.actor ? actors.find((a) => a.id === arrival.actor) : actors.find((a) => a.components?.Player);
105
+ let t = actor?.components?.Transform;
106
+ if (!t) {
107
+ for (const a of actors) {
108
+ if (a.components?.Player && a.components.Transform && a.components.Shape) {t = a.components.Transform;}
109
+ }
110
+ }
111
+ return t ? { x: t.x ?? 0, y: t.y ?? 0, z: t.z ?? 0 } : { x: 0, y: 1, z: 0 };
112
+ }
@@ -0,0 +1,88 @@
1
+ // Pure geometry; the same final boxes are handed to chrome.setLabels.
2
+ const touches = (a, b) => a.left < b.right + 6 && b.left < a.right + 6 && a.top < b.bottom + 6 && b.top < a.bottom + 6;
3
+ // view.bounds, when given, replaces the plain 8px margin (safe-area insets).
4
+ const edges = (view) => view.bounds ?? { left: 8, top: 8, right: view.w - 8, bottom: view.h - 8 };
5
+ const fits = (b, view) => {
6
+ const e = edges(view);
7
+ return b.left >= e.left && b.top >= e.top && b.right <= e.right && b.bottom <= e.bottom;
8
+ };
9
+ const shift = (b, x, y) => ({ left: b.left + x, right: b.right + x, top: b.top + y, bottom: b.bottom + y });
10
+
11
+ export function bodyBox(at, height, radius, project, yOffset = 0) {
12
+ if (!at) {return null;}
13
+ const points = [];
14
+ for (const y of [at.y + yOffset, at.y + yOffset + height]) {
15
+ for (const x of [-radius, radius]) {
16
+ for (const z of [-radius, radius]) {
17
+ const p = project(at.x + x, y, at.z + z);
18
+ // A near-plane intersection is uncertain: clear the whole viewport.
19
+ if (!p) {return { left: -Infinity, right: Infinity, top: -Infinity, bottom: Infinity };}
20
+ points.push(p);
21
+ }
22
+ }
23
+ }
24
+ return { left: Math.min(...points.map((p) => p.x)) - 8, right: Math.max(...points.map((p) => p.x)) + 8, top: Math.min(...points.map((p) => p.y)) - 8, bottom: Math.max(...points.map((p) => p.y)) + 8 };
25
+ }
26
+
27
+ export function clearBox(box, obstacles, view, own) {
28
+ const candidates = [box];
29
+ if (own && Number.isFinite(own.left)) {
30
+ candidates.push(
31
+ shift(box, own.left - 8 - box.right, 0),
32
+ shift(box, own.right + 8 - box.left, 0),
33
+ shift(box, 0, own.top - 8 - box.bottom),
34
+ shift(box, 0, own.bottom + 8 - box.top),
35
+ );
36
+ }
37
+ const clear = (candidate) => fits(candidate, view) && !obstacles.some((o) => touches(candidate, o));
38
+ const direct = candidates.find(clear);
39
+ if (direct) {return direct;}
40
+ // HUD and context controls can block each cardinal direction while a
41
+ // nearby corner remains free. Try a bounded grid of their final edges.
42
+ const w = box.right - box.left;
43
+ const h = box.bottom - box.top;
44
+ const nearest = (values, at) => [...new Set(values)].filter(Number.isFinite).sort((a, b) => Math.abs(a - at) - Math.abs(b - at)).slice(0, 8);
45
+ const e = edges(view);
46
+ const xs = nearest([box.left, e.left, e.right - w, ...obstacles.flatMap((o) => [o.left - w - 8, o.right + 8])], box.left);
47
+ const ys = nearest([box.top, e.top, e.bottom - h, ...obstacles.flatMap((o) => [o.top - h - 8, o.bottom + 8])], box.top);
48
+ const corners = xs.flatMap((left) => ys.map((top) => ({ left, right: left + w, top, bottom: top + h })));
49
+ corners.sort((a, b) => Math.hypot(a.left - box.left, a.top - box.top) - Math.hypot(b.left - box.left, b.top - box.top));
50
+ return corners.find(clear) ?? null;
51
+ }
52
+
53
+ export function occupancyText(text) {
54
+ const line = String(text).split('\n').at(-1);
55
+ return /^(you \+ \d+ more|\d+ here|occupancy unavailable)$/.test(line) ? line : null;
56
+ }
57
+
58
+ // Pad context first, other labels afterwards. If only its supporting count
59
+ // fits, the duplicate station text yields. No new DOM label is needed.
60
+ export function placeLabels(items, own, controls, view, measure, stale = false) {
61
+ const taken = own ? [...controls, own] : [...controls];
62
+ const out = [];
63
+ const ordered = [...items].sort((a, b) => Number(Boolean(b.padOccupancy)) - Number(Boolean(a.padOccupancy)));
64
+ for (const item of ordered) {
65
+ if (!item.box) {continue;}
66
+ let text = item.text;
67
+ const occupancy = item.padOccupancy ? occupancyText(text) : null;
68
+ if (occupancy && stale) {
69
+ text = text.slice(0, Math.max(0, text.lastIndexOf('\n') + 1)) + 'occupancy unavailable';
70
+ }
71
+ let box = item.box;
72
+ if (text !== item.text) {
73
+ const size = measure(text, item.speech, item.npc, true);
74
+ box = { left: item.x - size.w / 2, right: item.x + size.w / 2, top: item.y - size.h, bottom: item.y };
75
+ }
76
+ let placed = clearBox(box, taken, view, own);
77
+ if (!placed && occupancy) {
78
+ text = stale ? 'occupancy unavailable' : occupancy;
79
+ const size = measure(text, false, false, true);
80
+ placed = clearBox({ left: item.x - size.w / 2, right: item.x + size.w / 2, top: item.y - size.h, bottom: item.y }, taken, view, own);
81
+ }
82
+ if (placed) {
83
+ taken.push(placed);
84
+ out.push({ ...item, text, box: placed, x: (placed.left + placed.right) / 2, y: placed.bottom });
85
+ }
86
+ }
87
+ return out;
88
+ }
@@ -0,0 +1,26 @@
1
+ import { makePadCueTracker, padContextText, padCuesEnabled } from './padCues.js';
2
+ import { makePadRings } from './padRings.js';
3
+
4
+ // The enable gate precedes all DOM, mesh, tracker and listener creation.
5
+ export function makePadReadability(engine, options) {
6
+ if (!padCuesEnabled(engine)) {return null;}
7
+ const { world, arrival, chrome } = options;
8
+ const tracker = engine.hubPadContext === true || engine.hubPadRing === true ? makePadCueTracker() : null;
9
+ const rings = engine.hubPadRing === true || engine.hubSpawnRing === true
10
+ ? makePadRings(world, { active: engine.hubPadRing === true, arrival: engine.hubSpawnRing === true ? arrival : null }) : null;
11
+ let previous = null, text = null;
12
+ return {
13
+ frame(actors, hidden, body, traveling, captionBlocked = false) {
14
+ const active = tracker?.frame(actors, hidden, body) ?? null;
15
+ rings?.frame(traveling ? null : active?.cue);
16
+ if (engine.hubPadContext === true) {
17
+ if (active !== previous) {text = padContextText(active); previous = active;}
18
+ chrome.setPadContext(traveling || captionBlocked ? null : text);
19
+ }
20
+ },
21
+ dispose() {
22
+ rings?.dispose();
23
+ if (engine.hubPadContext === true) {chrome.clearPadContext();}
24
+ },
25
+ };
26
+ }
@@ -0,0 +1,69 @@
1
+ import * as THREE from 'three';
2
+
3
+ export const spawnRingOverlaps = (cue, arrival) => Boolean(cue && arrival && Math.hypot(cue.x - arrival.x, cue.z - arrival.z) <= cue.radius + 1.2 + 1e-9);
4
+
5
+ // All sectors share one position buffer, geometry, material and draw call.
6
+ // Each segment has an 11.25-degree gap; the active annulus has none.
7
+ export function ringGeometry(radius, width, segments = 1) {
8
+ const positions = [];
9
+ const steps = segments === 1 ? 64 : 8;
10
+ for (let segment = 0; segment < segments; segment += 1) {
11
+ const start = segment * Math.PI * 2 / segments;
12
+ const arc = Math.PI * 2 / segments * (segments === 1 ? 1 : 0.75);
13
+ for (let step = 0; step < steps; step += 1) {
14
+ const a = start + arc * step / steps, b = start + arc * (step + 1) / steps;
15
+ for (const [r, angle] of [[radius, a], [radius + width, a], [radius, b], [radius, b], [radius + width, a], [radius + width, b]]) {
16
+ positions.push(Math.cos(angle) * r, 0, Math.sin(angle) * r);
17
+ }
18
+ }
19
+ }
20
+ const geometry = new THREE.BufferGeometry();
21
+ geometry.setAttribute('position', new THREE.Float32BufferAttribute(positions, 3));
22
+ return geometry;
23
+ }
24
+
25
+ export function makePadRings(world, { active: enabled, arrival }) {
26
+ let active = null, selected = null;
27
+ const make = (geometry, color) => {
28
+ const mesh = new THREE.Mesh(geometry, new THREE.MeshBasicMaterial({ color, side: THREE.DoubleSide }));
29
+ world.add(mesh);
30
+ return mesh;
31
+ };
32
+ const spawn = arrival ? make(ringGeometry(1.2, 0.12, 8), '#7fc9b8') : null;
33
+ spawn?.position.set(arrival.x, arrival.y + 0.03, arrival.z);
34
+ return {
35
+ frame(cue) {
36
+ if (!enabled) {return;}
37
+ if (!cue || spawnRingOverlaps(cue, arrival)) {
38
+ if (active) {active.visible = false;}
39
+ return;
40
+ }
41
+ if (!active) {active = make(ringGeometry(cue.radius + 0.05, 0.12), cue.color);}
42
+ else if (selected?.radius !== cue.radius) {
43
+ // The mesh and its buffer survive selection changes. Width stays
44
+ // 0.12 m rather than widening with uniform mesh scaling.
45
+ const position = active.geometry.attributes.position;
46
+ const inner = selected.radius + 0.05;
47
+ for (let i = 0; i < position.count; i += 1) {
48
+ const px = position.getX(i), pz = position.getZ(i);
49
+ const r = Math.hypot(px, pz);
50
+ const next = cue.radius + 0.05 + (Math.abs(r - inner) < 0.001 ? 0 : 0.12);
51
+ position.setXYZ(i, px * next / r, 0, pz * next / r);
52
+ }
53
+ position.needsUpdate = true;
54
+ active.geometry.computeBoundingSphere();
55
+ }
56
+ if (selected !== cue) {
57
+ active.position.set(cue.x, cue.y, cue.z);
58
+ active.material.color.set(cue.color);
59
+ selected = cue;
60
+ }
61
+ active.visible = true;
62
+ },
63
+ dispose() {
64
+ for (const mesh of [active, spawn]) {
65
+ if (mesh) {mesh.removeFromParent(); mesh.geometry.dispose(); mesh.material.dispose();}
66
+ }
67
+ },
68
+ };
69
+ }
@@ -0,0 +1,14 @@
1
+ // Facts only. No preferences, promise cache or queue reconciliation lives here.
2
+ export function reportPushVisit(net, place, mark, previous, now = Date.now(), timezone = () => Intl.DateTimeFormat().resolvedOptions().timeZone) {
3
+ if (place?.push?.version !== 1) {return previous;}
4
+ const self = net?.selfId?.(), userId = self && net.userId?.(self);
5
+ if (!self || !/^[1-9]\d*$/.test(String(userId ?? ''))) {return previous;}
6
+ if (previous?.net === net && previous.self === self && previous.userId === String(userId) &&
7
+ previous.again === mark.again && now - previous.at < 60000) {return previous;}
8
+ try {
9
+ const zone = timezone();
10
+ if (typeof zone !== 'string' || !zone) {return previous;}
11
+ net.send({ k: 'hub-push-visit', userId: String(userId), timezone: zone });
12
+ return { net, self, userId: String(userId), again: mark.again, at: now };
13
+ } catch { return previous; }
14
+ }