castle-web-cli 0.4.233 → 0.4.234

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (381) 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 +260 -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 +50 -4
  39. package/kits/base/sdk/multiplayer.d.ts +7 -1
  40. package/kits/base/sdk/multiplayer.js +140 -40
  41. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  42. package/kits/base/sdk/party.d.ts +23 -0
  43. package/kits/base/sdk/party.js +91 -0
  44. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  45. package/kits/base/sdk/reconnectBudget.js +96 -0
  46. package/kits/base/sdk/save.d.ts +38 -1
  47. package/kits/base/sdk/save.js +79 -6
  48. package/kits/base/sdk/server/hub.d.ts +31 -1
  49. package/kits/base/sdk/server/hub.js +50 -3
  50. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  51. package/kits/base/sdk/server/storage.d.ts +4 -0
  52. package/kits/base/sdk/server/storage.js +19 -3
  53. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  54. package/kits/base/sdk/server/wrapper.js +10 -1
  55. package/kits/base/sdk/social.d.ts +9 -0
  56. package/kits/base/sdk/social.js +5 -0
  57. package/kits/hub-game/CLAUDE.md +123 -3
  58. package/kits/hub-game/README.md +63 -0
  59. package/kits/hub-game/castle.json +5 -5
  60. package/kits/hub-game/code/client/act.js +312 -0
  61. package/kits/hub-game/code/client/actionLayout.js +147 -0
  62. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  63. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  64. package/kits/hub-game/code/client/askSlot.js +117 -0
  65. package/kits/hub-game/code/client/avatar.js +4 -2
  66. package/kits/hub-game/code/client/avatarShare.js +2 -0
  67. package/kits/hub-game/code/client/backVisibility.js +13 -0
  68. package/kits/hub-game/code/client/ballot.js +15 -10
  69. package/kits/hub-game/code/client/build.js +16 -0
  70. package/kits/hub-game/code/client/chat.js +41 -5
  71. package/kits/hub-game/code/client/chatModeration.js +5 -0
  72. package/kits/hub-game/code/client/chrome.js +1148 -258
  73. package/kits/hub-game/code/client/crowdNames.js +241 -0
  74. package/kits/hub-game/code/client/decor.js +10 -4
  75. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  76. package/kits/hub-game/code/client/doorErrors.js +39 -0
  77. package/kits/hub-game/code/client/fall.js +18 -0
  78. package/kits/hub-game/code/client/farAvatars.js +233 -0
  79. package/kits/hub-game/code/client/firstJoin.js +9 -2
  80. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  81. package/kits/hub-game/code/client/frameBatch.js +5 -0
  82. package/kits/hub-game/code/client/grab.js +31 -11
  83. package/kits/hub-game/code/client/hookLayer.js +87 -8
  84. package/kits/hub-game/code/client/hudCopy.js +51 -0
  85. package/kits/hub-game/code/client/hudRate.js +20 -0
  86. package/kits/hub-game/code/client/idle.js +14 -2
  87. package/kits/hub-game/code/client/invites.js +231 -0
  88. package/kits/hub-game/code/client/joinError.js +9 -0
  89. package/kits/hub-game/code/client/labelsNear.js +31 -2
  90. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  91. package/kits/hub-game/code/client/layoutCache.js +264 -0
  92. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  93. package/kits/hub-game/code/client/loadingCover.js +148 -0
  94. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  95. package/kits/hub-game/code/client/menuRows.js +43 -0
  96. package/kits/hub-game/code/client/modelReady.js +7 -0
  97. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  98. package/kits/hub-game/code/client/padCues.js +112 -0
  99. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  100. package/kits/hub-game/code/client/padReadability.js +26 -0
  101. package/kits/hub-game/code/client/padRings.js +69 -0
  102. package/kits/hub-game/code/client/pushVisit.js +14 -0
  103. package/kits/hub-game/code/client/quality.js +205 -0
  104. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  105. package/kits/hub-game/code/client/safeLayout.js +338 -0
  106. package/kits/hub-game/code/client/safeStyle.js +42 -0
  107. package/kits/hub-game/code/client/say.js +12 -3
  108. package/kits/hub-game/code/client/shot.js +64 -10
  109. package/kits/hub-game/code/client/shotFit.js +56 -0
  110. package/kits/hub-game/code/client/signIn.js +28 -0
  111. package/kits/hub-game/code/client/state.js +53 -0
  112. package/kits/hub-game/code/client/talk.js +209 -45
  113. package/kits/hub-game/code/client/tiers.js +68 -66
  114. package/kits/hub-game/code/client/together.js +7 -2
  115. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  116. package/kits/hub-game/code/client/weakestTier.js +295 -0
  117. package/kits/hub-game/code/client/worldLabels.js +241 -0
  118. package/kits/hub-game/code/client/yours.js +10 -9
  119. package/kits/hub-game/code/npcDisplayText.js +55 -0
  120. package/kits/hub-game/code/server/act.js +124 -0
  121. package/kits/hub-game/code/server/actions.js +6 -1
  122. package/kits/hub-game/code/server/actors.js +2 -1
  123. package/kits/hub-game/code/server/analytics.js +83 -0
  124. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  125. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  126. package/kits/hub-game/code/server/companion.js +28 -3
  127. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  128. package/kits/hub-game/code/server/earned.js +22 -5
  129. package/kits/hub-game/code/server/frameBatch.js +183 -0
  130. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  131. package/kits/hub-game/code/server/history.js +2 -0
  132. package/kits/hub-game/code/server/hub.js +1306 -95
  133. package/kits/hub-game/code/server/idle.js +30 -1
  134. package/kits/hub-game/code/server/index.js +26 -4
  135. package/kits/hub-game/code/server/invites.js +19 -0
  136. package/kits/hub-game/code/server/labels.js +9 -1
  137. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  138. package/kits/hub-game/code/server/manifest.js +211 -3
  139. package/kits/hub-game/code/server/menu.js +31 -3
  140. package/kits/hub-game/code/server/npcs.js +226 -64
  141. package/kits/hub-game/code/server/observe.js +408 -0
  142. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  143. package/kits/hub-game/code/server/players.js +9 -1
  144. package/kits/hub-game/code/server/resumePose.js +152 -0
  145. package/kits/hub-game/code/server/say.js +1 -1
  146. package/kits/hub-game/code/server/standing.js +4 -5
  147. package/kits/hub-game/code/server/storageLimit.js +187 -0
  148. package/kits/hub-game/code/server/vis.js +67 -5
  149. package/kits/hub-game/code/shared/act.js +35 -0
  150. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  151. package/kits/hub-game/code/shared/loadStages.js +12 -0
  152. package/kits/hub-game/code/shared/quality.js +74 -0
  153. package/kits/hub-game/code/shared/say.js +2 -0
  154. package/kits/hub-game/code/shared/shot.js +35 -1
  155. package/kits/hub-game/code/systems/hub.js +970 -169
  156. package/kits/hub-game/docs/analytics.md +279 -0
  157. package/kits/hub-game/docs/contract.md +1257 -42
  158. package/kits/hub-game/docs/home-pieces.md +9 -2
  159. package/kits/hub-game/docs/observed-progress.md +252 -0
  160. package/kits/hub-game/main.jsx +2 -0
  161. package/kits/hub-game/package-lock.json +10 -3
  162. package/kits/hub-game/package.json +6 -3
  163. package/kits/hub-game/play/player.js +142 -0
  164. package/kits/hub-game/play/registry.js +47 -0
  165. package/kits/hub-game/play.jsx +37 -0
  166. package/kits/hub-game/scripts/check.mjs +39 -5
  167. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  168. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  169. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  170. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  171. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  172. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  173. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  174. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  175. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  176. package/kits/hub-game/scripts/test-act.mjs +171 -0
  177. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  178. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  179. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  180. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  181. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  182. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  183. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  184. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  185. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  186. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  187. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  188. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  189. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  190. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  191. package/kits/hub-game/scripts/test-build.mjs +20 -2
  192. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  193. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  194. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  195. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  196. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  197. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  198. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  199. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  200. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  201. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  202. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  203. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  204. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  205. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  206. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  207. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  208. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  209. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  210. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  211. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  212. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  213. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  214. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  215. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  216. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  217. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  218. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  219. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  220. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  221. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  222. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  223. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  224. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  225. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  226. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  227. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  228. package/kits/hub-game/scripts/test-npcs.mjs +819 -10
  229. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  230. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  231. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  232. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  233. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  234. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  235. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  236. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  237. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  238. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  239. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  240. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  241. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  242. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  243. package/kits/hub-game/scripts/test-say.mjs +1 -1
  244. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  245. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  246. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  247. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  248. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  249. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  250. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  251. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  252. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  253. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  254. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  255. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  256. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  257. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  258. package/kits/multiplayer-3d/castle.json +5 -5
  259. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  260. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  261. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  262. package/kits/multiplayer-3d/package-lock.json +8 -1
  263. package/kits/multiplayer-3d/package.json +2 -1
  264. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  265. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  266. package/kits/physics-2d/CLAUDE.md +10 -1
  267. package/kits/physics-2d/castle.json +2 -2
  268. package/kits/physics-2d/engine/frozenActors.js +233 -0
  269. package/kits/physics-2d/engine/scene.js +87 -5
  270. package/kits/physics-2d/eslint.config.js +1 -1
  271. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  272. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  273. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  274. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  275. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  276. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  277. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  278. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  279. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  280. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  281. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  282. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  283. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  284. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  285. package/kits/physics-3d/CLAUDE.md +25 -1651
  286. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  287. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  288. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  289. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  291. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  292. package/kits/physics-3d/castle.json +3 -3
  293. package/kits/physics-3d/docs/engine-camera.md +542 -0
  294. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  295. package/kits/physics-3d/docs/engine-load.md +149 -0
  296. package/kits/physics-3d/docs/engine-look.md +114 -0
  297. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  298. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  299. package/kits/physics-3d/docs/engine-sky.md +198 -0
  300. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  301. package/kits/physics-3d/docs/engine-view.md +37 -0
  302. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  303. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  304. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  305. package/kits/physics-3d/engine3d/actornode.js +1 -0
  306. package/kits/physics-3d/engine3d/branches.js +3 -13
  307. package/kits/physics-3d/engine3d/cage.js +2 -7
  308. package/kits/physics-3d/engine3d/cageops.js +2 -17
  309. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  310. package/kits/physics-3d/engine3d/framecap.js +4 -1
  311. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  312. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  313. package/kits/physics-3d/engine3d/gait.js +8 -0
  314. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  315. package/kits/physics-3d/engine3d/look.js +7 -0
  316. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  317. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  318. package/kits/physics-3d/engine3d/modelready.js +16 -0
  319. package/kits/physics-3d/engine3d/motion.js +3 -3
  320. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  321. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  322. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  323. package/kits/physics-3d/engine3d/paths.js +1 -9
  324. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  325. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  326. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  327. package/kits/physics-3d/engine3d/rapier.js +27 -0
  328. package/kits/physics-3d/engine3d/scatter.js +1 -11
  329. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  330. package/kits/physics-3d/engine3d/sky.js +1 -1
  331. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  332. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  333. package/kits/physics-3d/engine3d/sweep.js +1 -25
  334. package/kits/physics-3d/engine3d/world3d.js +468 -18
  335. package/kits/physics-3d/eslint.config.js +2 -1
  336. package/kits/physics-3d/main.jsx +6 -3
  337. package/kits/physics-3d/package-lock.json +7 -0
  338. package/kits/physics-3d/package.json +5 -1
  339. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  340. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  341. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  342. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  343. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  344. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  345. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  346. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  347. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  348. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  349. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  350. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  351. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  352. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  353. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  354. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  355. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  356. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  357. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  358. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  359. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  360. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  361. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  362. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  363. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  364. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  365. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  366. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  367. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  368. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  369. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  370. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  371. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  372. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  373. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  374. package/kits/physics-3d/systems/physics3d.js +37 -4
  375. package/kits/real-time/castle.json +2 -2
  376. package/kits/real-time/code/client/connection.js +33 -10
  377. package/kits/real-time/code/client/gameHooks.js +2 -0
  378. package/kits/real-time/code/client/joinOverlay.js +9 -4
  379. package/kits/real-time/code/server/session.js +6 -4
  380. package/kits/real-time/package-lock.json +1 -1
  381. package/package.json +2 -2
@@ -1,6 +1,5 @@
1
1
  // The kit's default heights may only come down to a clear standing spot
2
- // (v1.48). This proof is private: friend placement keeps its original
3
- // clearance rules. Read each solid body's current pose without querying or
2
+ // (v1.48). Read each solid body's current pose without querying or
4
3
  // stepping physics; authored Transforms are only for actors without bodies.
5
4
  export function standingY(h, at) {
6
5
  const size = bodySize(h);
@@ -54,9 +53,9 @@ export function standingY(h, at) {
54
53
  return y;
55
54
  }
56
55
 
57
- // The private proof uses the scene player's standing envelope, not the
58
- // larger clearance envelope used to find a spot beside a friend.
59
- function bodySize(h) {
56
+ // Trusted scene template bounds, also used by opted-in friend placement on
57
+ // authored floors. Legacy friend placement keeps its larger envelope.
58
+ export function bodySize(h) {
60
59
  const shape = h?.sim?.template?.shape ?? { kind: 'capsule', radius: 0.35, height: 1.4 };
61
60
  const halfHeight = shape.kind === 'sphere' ? shape.radius : shape.height / 2;
62
61
  const radius = shape.kind === 'box' ? Math.hypot(shape.width, shape.depth) / 2 : shape.radius;
@@ -0,0 +1,187 @@
1
+ // v1.144: the host broker answers at most 8 storage and hub requests in flight
2
+ // per session and refuses the rest with CAULDRON_STORAGE_RATE_LIMITED before
3
+ // forwarding them. A Town arrival alone sends a dozen in one tick, so every
4
+ // handle the kit, real-time and a place reach through the session goes through
5
+ // one queue here, and a refusal that still gets through (a burst from outside
6
+ // the kit's handles) is sent again after a short wait -- but only for a call
7
+ // that is one request, since the refusal says only that its own frame was not
8
+ // forwarded.
9
+
10
+ export const MAX_IN_FLIGHT = 6;
11
+ export const RETRY_MS = [100, 250, 500, 1000, 2000];
12
+ const RATE_LIMITED = 'CAULDRON_STORAGE_RATE_LIMITED';
13
+ // The handles that send storage, hub and character requests. `world.characters`
14
+ // is the same object as `characters` on a world session, and stays one handle.
15
+ const LIMITED = new Set(['storage', 'hub', 'characters', 'world']);
16
+ // Passed through unqueued: the broker gives analytics (`track`) a pool of its
17
+ // own, and `catchUp` awaits the author's `apply` between its requests, so a slot
18
+ // held across it could wait on the queue it is holding.
19
+ const PASS = new Set(['track', 'catchUp']);
20
+ // A save bucket's verbs are plain functions returning the save API's promise.
21
+ const SAVE_VERBS = new Set(['snapshot', 'transaction', 'claim', 'initialize', 'operation']);
22
+ // The SDK splits writes into requests sent one after another past 32 keys or a
23
+ // 316 KiB frame; a retry replays only a write that fits one request (a read may
24
+ // always be read again).
25
+ const CHUNKED = new Set(['set', 'remove']);
26
+ const MAX_KEYS_PER_CALL = 32;
27
+ const MAX_ONE_REQUEST_BYTES = 256 * 1024;
28
+
29
+ const sessions = new WeakMap();
30
+ const encoder = new TextEncoder();
31
+
32
+ function gate(max) {
33
+ let active = 0;
34
+ const waiting = [];
35
+ return {
36
+ acquire() {
37
+ if (active < max) {
38
+ active += 1;
39
+ return Promise.resolve();
40
+ }
41
+ return new Promise((resolve) => waiting.push(resolve));
42
+ },
43
+ release() {
44
+ const next = waiting.shift();
45
+ if (next) {
46
+ next();
47
+ } else {
48
+ active -= 1;
49
+ }
50
+ },
51
+ };
52
+ }
53
+
54
+ const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
55
+
56
+ function oneRequest(key, args) {
57
+ if (!CHUNKED.has(key)) {
58
+ return true;
59
+ }
60
+ const [arg] = args;
61
+ if (Array.isArray(arg)) {
62
+ return arg.length <= MAX_KEYS_PER_CALL;
63
+ }
64
+ if (!arg || typeof arg !== 'object' || Object.keys(arg).length > MAX_KEYS_PER_CALL) {
65
+ return false;
66
+ }
67
+ try {
68
+ // Measured as the SDK sends it: each value JSON-encoded, then the entries
69
+ // encoded again in the request, which escapes every quote a second time.
70
+ const entries = Object.entries(arg).map(([key, value]) => ({ key, value: JSON.stringify(value) }));
71
+ return encoder.encode(JSON.stringify(entries)).length <= MAX_ONE_REQUEST_BYTES;
72
+ } catch {
73
+ return false;
74
+ }
75
+ }
76
+
77
+ async function run(limit, key, fn, self, args) {
78
+ const retry = oneRequest(key, args);
79
+ for (let attempt = 0; ; attempt += 1) {
80
+ await limit.gate.acquire();
81
+ try {
82
+ return await fn.apply(self, args);
83
+ } catch (error) {
84
+ if (!retry || error?.code !== RATE_LIMITED || attempt >= RETRY_MS.length) {
85
+ throw error;
86
+ }
87
+ } finally {
88
+ limit.gate.release();
89
+ }
90
+ if (!limit.warned) {
91
+ limit.warned = true;
92
+ console.warn(`[hub] storage busy (${RATE_LIMITED}); retrying`);
93
+ }
94
+ await wait(RETRY_MS[attempt] * (0.75 + Math.random() / 2));
95
+ }
96
+ }
97
+
98
+ // An object with methods of its own, or (one level down) a namespace of handles
99
+ // such as `{ deck }`; data (and a promise) passes through as is.
100
+ function isHandle(value, depth = 1) {
101
+ if (!value || typeof value !== 'object' || Array.isArray(value) || typeof value.then === 'function') {
102
+ return false;
103
+ }
104
+ return Reflect.ownKeys(value).some((key) => {
105
+ const v = Object.getOwnPropertyDescriptor(value, key).value;
106
+ return typeof v === 'function' || (depth > 0 && isHandle(v, depth - 1));
107
+ });
108
+ }
109
+
110
+ function wrapFn(limit, key, fn, self) {
111
+ if (PASS.has(key)) {
112
+ return (...args) => fn.apply(self, args);
113
+ }
114
+ // An async method or a save verb is a request; any other plain method builds
115
+ // a handle locally (`user`, `town`, `board`, `target`) or reads a value.
116
+ if (fn.constructor?.name === 'AsyncFunction' || SAVE_VERBS.has(key)) {
117
+ return (...args) => run(limit, key, fn, self, args).then((result) => wrap(limit, result));
118
+ }
119
+ return (...args) => wrap(limit, fn.apply(self, args));
120
+ }
121
+
122
+ // A copy of the handle whose requests queue, memoized so code comparing or
123
+ // keying on a handle (`storage.js`, `npcMemory.js`) sees one object.
124
+ function wrap(limit, value) {
125
+ if (!isHandle(value)) {
126
+ return value;
127
+ }
128
+ const known = limit.handles.get(value);
129
+ if (known) {
130
+ return known;
131
+ }
132
+ const out = Object.create(Object.getPrototypeOf(value));
133
+ limit.handles.set(value, out);
134
+ for (const key of Reflect.ownKeys(value)) {
135
+ const desc = Object.getOwnPropertyDescriptor(value, key);
136
+ if ('value' in desc) {
137
+ const v = desc.value;
138
+ desc.value = typeof v === 'function' ? wrapFn(limit, key, v, value) : wrap(limit, v);
139
+ } else {
140
+ const { get, set } = desc;
141
+ desc.get = get && (() => wrap(limit, get.call(value)));
142
+ desc.set = set && ((v) => set.call(value, v));
143
+ }
144
+ Object.defineProperty(out, key, desc);
145
+ }
146
+ if (Object.isFrozen(value)) {
147
+ Object.freeze(out);
148
+ }
149
+ return out;
150
+ }
151
+
152
+ // The session every callback is handed, with its request handles queued. One per
153
+ // session, so every callback and every module that keeps it shares one queue.
154
+ export function limitSession(session, max = MAX_IN_FLIGHT) {
155
+ if (!session || typeof session !== 'object') {
156
+ return session;
157
+ }
158
+ let limited = sessions.get(session);
159
+ if (limited) {
160
+ return limited;
161
+ }
162
+ const limit = { gate: gate(max), handles: new WeakMap(), warned: false };
163
+ limited = new Proxy(session, {
164
+ get(target, key) {
165
+ const value = Reflect.get(target, key, target);
166
+ return LIMITED.has(key) ? wrap(limit, value) : value;
167
+ },
168
+ });
169
+ sessions.set(session, limited);
170
+ sessions.set(limited, limited);
171
+ return limited;
172
+ }
173
+
174
+ const isSession = (arg) => Boolean(arg && typeof arg === 'object' && 'storage' in arg && 'sessionId' in arg);
175
+
176
+ // Every session callback, with the session argument (first, or second for
177
+ // `onWorldCharacterTool`) replaced by its limited one.
178
+ export function limitCallbacks(callbacks) {
179
+ const out = {};
180
+ for (const [name, fn] of Object.entries(callbacks)) {
181
+ out[name] =
182
+ typeof fn === 'function'
183
+ ? (...args) => fn(...args.map((arg) => (isSession(arg) ? limitSession(arg) : arg)))
184
+ : fn;
185
+ }
186
+ return out;
187
+ }
@@ -5,6 +5,30 @@ import { isActor, warnOnce } from './actors.js';
5
5
  const MAX_OVERRIDES = 256;
6
6
  const connected = (h, id) => h.session?.players.some((p) => p.playerId === id) === true;
7
7
 
8
+ // A resumeVisibility place may keep an authenticated viewer's overrides only
9
+ // while resumeKeep is holding that visit through an observed absence. The
10
+ // trusted identity is captured with the retained visit in hub.js; a guest or
11
+ // an entry without one is deliberately handled like an ordinary departure.
12
+ function retainedAway(h, playerId) {
13
+ const kept = h.resumeKept?.get(playerId);
14
+ return h.place?.resumeVisibility === true && kept?.awayAt !== undefined &&
15
+ typeof kept.identityUserId === 'string';
16
+ }
17
+
18
+ // v1.145: a resumePose place (the Town) has no resume preparation, so its
19
+ // arrival masks would otherwise go with the dropped socket and never return:
20
+ // the arrive hook does not run again for a retained visit. While the retained
21
+ // visit is held for an authenticated viewer, their overrides stay, calls made
22
+ // meanwhile still land, and the same identity's return replays the whole map.
23
+ // Expiry and a real leave forget them through hub.js `forget`.
24
+ export function heldAway(h, playerId) {
25
+ const kept = h.resumeKept?.get(playerId);
26
+ return h.place?.resumePose === true && h.place.resumeVisibility !== true &&
27
+ kept !== undefined && typeof kept.identityUserId === 'string' &&
28
+ h.players?.get(playerId)?.arrived === true && !connected(h, playerId);
29
+ }
30
+ const holds = (h, id) => connected(h, id) || retainedAway(h, id) || heldAway(h, id);
31
+
8
32
  export function set(h, actorId, options, hidden) {
9
33
  const op = hidden ? 'hide' : 'show';
10
34
  if (!isActor(h, actorId)) {
@@ -25,7 +49,7 @@ export function set(h, actorId, options, hidden) {
25
49
  if (ids.some((id) => typeof id !== 'string')) {
26
50
  throw Error('invalid targets');
27
51
  }
28
- targets = [...new Set(ids)].filter((id) => connected(h, id));
52
+ targets = [...new Set(ids)].filter((id) => connected(h, id) || heldAway(h, id));
29
53
  clear = drop === true;
30
54
  } catch {
31
55
  warnOnce(h, `vis:${op}:options`, `hub.${op}: visibility options need { to: [playerIds], clear?: boolean }`);
@@ -86,19 +110,57 @@ export function send(h) {
86
110
  }
87
111
  for (const id of new Set([...(h.visMe?.keys() ?? []), ...(h.sentVisMe?.keys() ?? [])])) {
88
112
  if (connected(h, id)) {
89
- sendOne(h, id);
90
- } else {
113
+ if (h.resumeKept?.get(id)?.visibilityResumePending !== true) {
114
+ sendOne(h, id);
115
+ }
116
+ } else if (!retainedAway(h, id) && !heldAway(h, id)) {
91
117
  forget(h, id);
92
118
  }
93
119
  }
94
120
  }
95
121
 
96
- export function joinedAfresh(h, playerId) {
122
+ export function joinedAfresh(h, playerId, identityUserId = null) {
123
+ // A retained player id is not an identity. Refuse to replay its cache unless
124
+ // the connected roster still names the authenticated account that owned the
125
+ // retained visit. Deleting here also prevents a later switch back from
126
+ // recovering another identity's overrides.
127
+ const kept = h.resumeKept?.get(playerId);
128
+ if (h.place?.resumeVisibility === true && kept &&
129
+ (typeof kept.identityUserId !== 'string' || kept.identityUserId !== identityUserId)) {
130
+ clearRetained(h, playerId);
131
+ return;
132
+ }
133
+ // v1.145: a held map is only ever replayed to the account that owned it.
134
+ if (h.place?.resumePose === true && typeof kept?.identityUserId === 'string' &&
135
+ kept.identityUserId !== identityUserId) {
136
+ clearRetained(h, playerId);
137
+ return;
138
+ }
139
+ // The opted-in retained return first lets the authored resume hook
140
+ // synchronously recompute CURRENT masks. Vis.send emits the resulting whole
141
+ // map later in that step; replaying the old cache here would expose an
142
+ // actor that became private while this viewer was away.
143
+ if (kept?.visibilityResumePending === true) {
144
+ // This hello names a client that must receive a complete map after
145
+ // preparation even when the rebuilt map equals the retained one.
146
+ h.sentVisMe?.delete(playerId);
147
+ return;
148
+ }
97
149
  if (h.visMe?.has(playerId) && connected(h, playerId)) {
98
150
  sendOne(h, playerId, true);
99
151
  }
100
152
  }
101
153
 
154
+ // The returning client may still hold the prior identity's merged view. Drop
155
+ // the server cache and clear that client without naming any actor from it.
156
+ export function clearRetained(h, playerId) {
157
+ const hadOverride = h.visMe?.has(playerId) || h.sentVisMe?.has(playerId);
158
+ forget(h, playerId);
159
+ if (hadOverride && connected(h, playerId)) {
160
+ h.session.send(playerId, { k: 'hub-vis', hide: [], show: [] });
161
+ }
162
+ }
163
+
102
164
  export function forget(h, playerId) {
103
165
  h.visMe?.delete(playerId);
104
166
  h.sentVisMe?.delete(playerId);
@@ -106,7 +168,7 @@ export function forget(h, playerId) {
106
168
 
107
169
  export function prune(h) {
108
170
  for (const id of h.visMe?.keys() ?? []) {
109
- if (!connected(h, id)) {
171
+ if (!holds(h, id)) {
110
172
  forget(h, id);
111
173
  }
112
174
  }
@@ -0,0 +1,35 @@
1
+ // The authored v1.127 interaction shape, shared by publishing and runtime.
2
+ import { REFUSED_TEXT } from '../privateText.js';
3
+ export function actProblem(value) {
4
+ if (!value || typeof value !== 'object' || Array.isArray(value) ||
5
+ Object.keys(value).some(key => !['verb', 'reach', 'hold', 'id'].includes(key))) {
6
+ return 'HubAct must be { verb, reach, hold, id }';
7
+ }
8
+ if (typeof value.verb !== 'string' || !value.verb.trim() || Array.from(value.verb).length > 16 || REFUSED_TEXT.test(value.verb)) {
9
+ return 'HubAct.verb must be 1..16 characters without control or direction characters';
10
+ }
11
+ if (!Number.isFinite(value.reach) || value.reach < 0.8 || value.reach > 4) {
12
+ return 'HubAct.reach must be 0.8..4 metres';
13
+ }
14
+ if (typeof value.hold !== 'boolean') {return 'HubAct.hold must be boolean';}
15
+ if (typeof value.id !== 'string' || !/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(value.id)) {
16
+ return 'HubAct.id must be a bounded identifier';
17
+ }
18
+ return null;
19
+ }
20
+ export function interaction(actor, place, spawned = false) {
21
+ const c = actor.components ?? {};
22
+ if (Object.hasOwn(c, 'HubAct')) {
23
+ return actProblem(c.HubAct) ? null : { ...c.HubAct, ...(spawned ? { id: actor.id } : {}), actor: actor.id, op: 'custom' };
24
+ }
25
+ if (c.HubSeat) {return { id: actor.id, actor: actor.id, verb: 'Sit', reach: 1.6, hold: false, op: 'sit' };}
26
+ if (c.HubNpc) {
27
+ const name = typeof c.HubNpc.name === 'string' && c.HubNpc.name ? c.HubNpc.name.slice(0, 40) : actor.id;
28
+ const reach = c.HubNpc.talkRange > 0 ? Math.min(c.HubNpc.talkRange, 8) : 3.5;
29
+ return { id: actor.id, actor: actor.id, verb: `Talk to ${name}`, reach, hold: false, op: 'talk' };
30
+ }
31
+ if (place.grab && c.Body?.type === 'dynamic' && !c.Player) {
32
+ return { id: actor.id, actor: actor.id, verb: 'Grab', reach: 1.2, hold: false, op: 'grab' };
33
+ }
34
+ return null;
35
+ }
@@ -0,0 +1,28 @@
1
+ // v1.109: a song clock and axis-aligned floor footprints. This state never
2
+ // starts an emote or changes a player's simulation pose or answer cooldown.
3
+ export function danceFloors(floors) {
4
+ if (!Array.isArray(floors) || !floors.length || floors.length > 16) {return null;}
5
+ if (!floors.every((f) => f && [f.x, f.z, f.halfX, f.halfZ].every(Number.isFinite)
6
+ && Math.abs(f.x) <= 1e6 && Math.abs(f.z) <= 1e6
7
+ && f.halfX > 0 && f.halfX <= 100 && f.halfZ > 0 && f.halfZ <= 100)) {return null;}
8
+ return floors.map(({ x, z, halfX, halfZ }) => ({ x, z, halfX, halfZ }));
9
+ }
10
+
11
+ export function readDanceIdle(spec) {
12
+ const floors = danceFloors(spec?.floors);
13
+ return floors && typeof spec.actor === 'string' && typeof spec.file === 'string'
14
+ && Number.isFinite(spec.bpm) && spec.bpm >= 30 && spec.bpm <= 300
15
+ && Number.isFinite(spec.beatAt) && spec.beatAt >= 0
16
+ ? { actor: spec.actor, file: spec.file, bpm: spec.bpm, beatAt: spec.beatAt, floors } : null;
17
+ }
18
+
19
+ export function danceIdlePose(spec, sounds, at, now) {
20
+ const song = sounds?.[spec?.actor];
21
+ if (!spec || !at || !Number.isFinite(now) || now < spec.beatAt
22
+ || song?.file !== spec.file || song.since !== spec.beatAt
23
+ || !spec.floors.some((f) => Math.abs(at.x - f.x) <= f.halfX && Math.abs(at.z - f.z) <= f.halfZ)) {return null;}
24
+ const beat = (now - spec.beatAt) * spec.bpm / 60000;
25
+ // One hop each beat, alternating sway over two beats, turn over four.
26
+ return { y: (1 - Math.cos(beat * Math.PI * 2)) * 0.12,
27
+ rx: 0, ry: Math.sin(beat * Math.PI / 2) * 0.8, rz: Math.sin(beat * Math.PI) * 0.22 };
28
+ }
@@ -0,0 +1,12 @@
1
+ // v1.138 load-abandoned telemetry vocabulary, shared by the browser and the server.
2
+ // Stage is the furthest milestone a connection reached before it was abandoned;
3
+ // it travels as kind 27's subject. Reasons travel as its result.
4
+ export const LOAD_STAGES = Object.freeze({
5
+ connected: 1, // the server saw the connection; no hello yet
6
+ hello: 2, // the server received hub-hello
7
+ body: 3, // the server has the player's body and is waiting to place them
8
+ placed: 4, // the browser reported its own body placed, still waiting for hub-arrived
9
+ });
10
+ // The only stages a browser may claim. Everything else is the server's observation.
11
+ export const CLIENT_LOAD_STAGES = Object.freeze([LOAD_STAGES.placed]);
12
+ export const LOAD_REASONS = Object.freeze({ closed: 1, timeout: 2 });
@@ -0,0 +1,74 @@
1
+ // Shared by the build filter and the publish check. No browser dependencies.
2
+ const GAMEPLAY = /^Hub|^Town|^Body$|^Ball$|^Player$/;
3
+ const DECOR = new Set(['Transform', 'Shape', 'Model']);
4
+ const SCENERY = new Set(['Transform', 'Shape', 'Model', 'Solid', 'Lookable']);
5
+
6
+ export function classify(components) {
7
+ const names = Object.keys(components ?? {});
8
+ // physics-3d makes an actor's collider block when it has `Solid` or its
9
+ // Shape says `solid` (physics3d.js `isSolid`); either way it is scenery that
10
+ // stops a player, never decor.
11
+ const solid = names.includes('Solid') || Boolean(components?.Shape?.solid);
12
+ if (names.includes('HubNpc')) {
13
+ return 'npc';
14
+ }
15
+ if (names.some((name) => GAMEPLAY.test(name))) {
16
+ return 'game';
17
+ }
18
+ if (!solid && names.every((name) => DECOR.has(name))) {
19
+ return 'decor';
20
+ }
21
+ return names.every((name) => SCENERY.has(name)) ? 'static' : 'game';
22
+ }
23
+
24
+
25
+ export function skippableDecor(actor, components = actor.components) {
26
+ return !['keep', 'near', 'low'].includes(actor.tier) && actor.decor !== true &&
27
+ actor.spawnTemplate !== true && actor.scriptedTarget !== true && classify(components) === 'decor';
28
+ }
29
+
30
+ export const QUALITY_DEFAULTS = Object.freeze({ decor: 'skip', players: 8, labels: 8, spawned: 8, farMindsHz: 4 });
31
+ export const QUALITY_RANGES = Object.freeze({ players: [1, 30], labels: [0, 30], spawned: [0, 64], farMindsHz: [1, 60], physicsHz: [10, 60] });
32
+
33
+ export function readQuality(value, tiers, errors) {
34
+ if (value === undefined) {return null;}
35
+ if (tiers !== true) {errors.push('hub.quality requires hub.tiers: true.');}
36
+ const object = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
37
+ if (!object(value)) { errors.push('hub.quality must be an object.'); return null; }
38
+ for (const key of Object.keys(value)) {
39
+ if (key !== 'low') {errors.push(`hub.quality.${key} is unknown; allowed key: low.`);}
40
+ }
41
+ if (value.low !== undefined && !object(value.low)) { errors.push('hub.quality.low must be an object.'); return null; }
42
+ const low = value.low ?? {};
43
+ for (const key of Object.keys(low)) {
44
+ if (key !== 'decor' && !Object.hasOwn(QUALITY_RANGES, key)) {errors.push(`hub.quality.low.${key} is unknown.`);}
45
+ }
46
+ if (low.decor !== undefined && !['skip', 'hide'].includes(low.decor)) {errors.push('hub.quality.low.decor must be "skip" or "hide".');}
47
+ for (const [key, [min, max]] of Object.entries(QUALITY_RANGES)) {
48
+ if (low[key] !== undefined && (!Number.isInteger(low[key]) || low[key] < min || low[key] > max)) {
49
+ errors.push(`hub.quality.low.${key} must be a whole number from ${min} to ${max}.`);
50
+ }
51
+ }
52
+ return { low: { ...QUALITY_DEFAULTS, ...low } };
53
+ }
54
+
55
+ // Literal ids in known actor APIs are cheaply checkable. Computed ids and
56
+ // arbitrary deck functions are deliberately outside this static check.
57
+ export function actorReferences(sources) {
58
+ const ids = new Set();
59
+ const templates = new Set();
60
+ const calls = new Set(['spawn', 'hide', 'show', 'move', 'tint', 'label', 'reset', 'pose', 'sound', 'danceIdle', 'keepFor', 'despawn', 'npc', 'actor', 'getActor', 'despawnActor']);
61
+ for (const source of sources) {
62
+ // Tokenizing strings/comments avoids mistaking prose or a commented-out
63
+ // example for an actor API call. Computed arguments stay unclassified.
64
+ const tokens = (source.match(/\/\*[\s\S]*?\*\/|\/\/[^\n]*|"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|`(?:\\.|[^`\\])*`|[A-Za-z_$][\w$]*|[^\s]/g) ?? [])
65
+ .filter((token) => !token.startsWith('//') && !token.startsWith('/*'));
66
+ for (let i = 0; i < tokens.length - 3; i++) {
67
+ if (tokens[i] !== '.' || !calls.has(tokens[i + 1]) || tokens[i + 2] !== '(') {continue;}
68
+ const literal = tokens[i + 3];
69
+ if (!['"', "'", '`'].includes(literal[0]) || literal.includes('\\') || literal.includes('${')) {continue;}
70
+ (tokens[i + 1] === 'spawn' ? templates : ids).add(literal.slice(1, -1));
71
+ }
72
+ }
73
+ return { ids, templates };
74
+ }
@@ -0,0 +1,2 @@
1
+ // Door naming and nearby stranger play cards use the same x/z distance.
2
+ export const PLAY_NEAR_M = 12;
@@ -12,7 +12,41 @@ export function shotValue(shot) {
12
12
  if (![x, y, z, distance, pitch, yaw].every(Number.isFinite) || distance <= 0) {
13
13
  return null;
14
14
  }
15
- return { look: { x, y, z }, distance, pitch: Math.max(-89, Math.min(89, pitch)), yaw };
15
+ const fit = shot.fit;
16
+ let bounded;
17
+ if (fit !== undefined) {
18
+ const min = fit?.min,
19
+ max = fit?.max,
20
+ minDistance = fit?.minDistance;
21
+ if (
22
+ !Number.isFinite(minDistance) ||
23
+ minDistance <= 0 ||
24
+ minDistance > 1000 ||
25
+ !['x', 'y', 'z'].every(
26
+ (k) =>
27
+ Number.isFinite(min?.[k]) &&
28
+ Number.isFinite(max?.[k]) &&
29
+ Math.abs(min[k]) <= 10000 &&
30
+ Math.abs(max[k]) <= 10000 &&
31
+ min[k] <= max[k] &&
32
+ max[k] - min[k] <= 1000,
33
+ )
34
+ ) {
35
+ return null;
36
+ }
37
+ bounded = {
38
+ min: { x: min.x, y: min.y, z: min.z },
39
+ max: { x: max.x, y: max.y, z: max.z },
40
+ minDistance,
41
+ };
42
+ }
43
+ return {
44
+ ...(bounded ? { fit: bounded } : {}),
45
+ look: { x, y, z },
46
+ distance,
47
+ pitch: Math.max(-89, Math.min(89, pitch)),
48
+ yaw,
49
+ };
16
50
  } catch {
17
51
  return null;
18
52
  }