castle-web-cli 0.4.231 → 0.4.233

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (368) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/serverBundle.js +5 -3
  28. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  29. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  30. package/dist/shell/index.html +2 -2
  31. package/dist/taskSteer.d.ts +13 -0
  32. package/dist/taskSteer.js +22 -2
  33. package/kits/base/castle.json +1 -1
  34. package/kits/base/package-lock.json +1 -1
  35. package/kits/base/sdk/README.md +79 -2
  36. package/kits/base/sdk/avatar.d.ts +6 -2
  37. package/kits/base/sdk/avatar.js +12 -4
  38. package/kits/base/sdk/castle.d.ts +1 -1
  39. package/kits/base/sdk/commands.d.ts +14 -0
  40. package/kits/base/sdk/hub.d.ts +6 -2
  41. package/kits/base/sdk/hub.js +13 -0
  42. package/kits/base/sdk/multiplayer.js +17 -1
  43. package/kits/base/sdk/save.js +2 -1
  44. package/kits/base/sdk/server/hub.d.ts +87 -0
  45. package/kits/base/sdk/server/hub.js +70 -0
  46. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  47. package/kits/base/sdk/server/storage.d.ts +13 -0
  48. package/kits/base/sdk/server/storage.js +46 -0
  49. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  50. package/kits/base/sdk/server/wrapper.js +83 -8
  51. package/kits/hub-game/CLAUDE.md +352 -12
  52. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  63. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  64. package/kits/hub-game/code/client/actorBudget.js +47 -0
  65. package/kits/hub-game/code/client/attention.js +11 -2
  66. package/kits/hub-game/code/client/avatar.js +345 -32
  67. package/kits/hub-game/code/client/avatarCap.js +228 -0
  68. package/kits/hub-game/code/client/avatarColors.js +70 -0
  69. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  70. package/kits/hub-game/code/client/avatarShare.js +251 -0
  71. package/kits/hub-game/code/client/ballot.js +467 -0
  72. package/kits/hub-game/code/client/build.js +22 -0
  73. package/kits/hub-game/code/client/chat.js +12 -0
  74. package/kits/hub-game/code/client/chrome.js +1334 -50
  75. package/kits/hub-game/code/client/companion.js +716 -0
  76. package/kits/hub-game/code/client/companionDress.js +99 -0
  77. package/kits/hub-game/code/client/decor.js +509 -0
  78. package/kits/hub-game/code/client/earned.js +131 -0
  79. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  80. package/kits/hub-game/code/client/grab.js +363 -20
  81. package/kits/hub-game/code/client/hats.js +26 -0
  82. package/kits/hub-game/code/client/hookLayer.js +328 -15
  83. package/kits/hub-game/code/client/hudClear.js +126 -0
  84. package/kits/hub-game/code/client/idle.js +163 -22
  85. package/kits/hub-game/code/client/interestCap.js +81 -0
  86. package/kits/hub-game/code/client/keys.js +36 -0
  87. package/kits/hub-game/code/client/labelsNear.js +205 -0
  88. package/kits/hub-game/code/client/menuIcons.js +34 -0
  89. package/kits/hub-game/code/client/pack.js +6 -2
  90. package/kits/hub-game/code/client/packFormat.js +3 -3
  91. package/kits/hub-game/code/client/rehello.js +167 -0
  92. package/kits/hub-game/code/client/shot.js +92 -0
  93. package/kits/hub-game/code/client/sound.js +63 -8
  94. package/kits/hub-game/code/client/soundscape.js +1151 -0
  95. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  96. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  97. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  98. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  99. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  100. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  101. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  102. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  103. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  104. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  105. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  106. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  107. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  108. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  109. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  110. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  111. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  112. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  113. package/kits/hub-game/code/client/spin.js +101 -0
  114. package/kits/hub-game/code/client/state.js +131 -1
  115. package/kits/hub-game/code/client/stuck.js +259 -0
  116. package/kits/hub-game/code/client/talk.js +538 -47
  117. package/kits/hub-game/code/client/tiers.js +541 -27
  118. package/kits/hub-game/code/client/toastBand.js +37 -0
  119. package/kits/hub-game/code/client/together.js +98 -1
  120. package/kits/hub-game/code/client/visibility.js +43 -0
  121. package/kits/hub-game/code/client/wear.js +470 -97
  122. package/kits/hub-game/code/client/yours.js +199 -0
  123. package/kits/hub-game/code/companionSpec.js +45 -0
  124. package/kits/hub-game/code/privateText.js +7 -0
  125. package/kits/hub-game/code/server/actions.js +133 -0
  126. package/kits/hub-game/code/server/actors.js +14 -1
  127. package/kits/hub-game/code/server/ask.js +155 -0
  128. package/kits/hub-game/code/server/ballot.js +539 -0
  129. package/kits/hub-game/code/server/cells.js +100 -0
  130. package/kits/hub-game/code/server/companion.js +82 -0
  131. package/kits/hub-game/code/server/cues.js +70 -0
  132. package/kits/hub-game/code/server/decor.js +269 -0
  133. package/kits/hub-game/code/server/earned.js +461 -0
  134. package/kits/hub-game/code/server/friendBests.js +166 -0
  135. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  136. package/kits/hub-game/code/server/grab.js +296 -11
  137. package/kits/hub-game/code/server/history.js +5 -0
  138. package/kits/hub-game/code/server/hub.js +1317 -52
  139. package/kits/hub-game/code/server/idle.js +30 -11
  140. package/kits/hub-game/code/server/index.js +2 -2
  141. package/kits/hub-game/code/server/labels.js +28 -2
  142. package/kits/hub-game/code/server/manifest.js +424 -8
  143. package/kits/hub-game/code/server/menu.js +133 -0
  144. package/kits/hub-game/code/server/npcs.js +830 -80
  145. package/kits/hub-game/code/server/party.js +13 -2
  146. package/kits/hub-game/code/server/players.js +22 -0
  147. package/kits/hub-game/code/server/say.js +8 -2
  148. package/kits/hub-game/code/server/shot.js +110 -0
  149. package/kits/hub-game/code/server/standing.js +124 -0
  150. package/kits/hub-game/code/server/vis.js +113 -0
  151. package/kits/hub-game/code/server/wear.js +128 -11
  152. package/kits/hub-game/code/server/yours.js +59 -0
  153. package/kits/hub-game/code/shared/cues.js +9 -0
  154. package/kits/hub-game/code/shared/decor.js +41 -0
  155. package/kits/hub-game/code/shared/shot.js +19 -0
  156. package/kits/hub-game/code/shared/spin.js +57 -0
  157. package/kits/hub-game/code/systems/hub.js +1083 -85
  158. package/kits/hub-game/docs/content-pack.md +1 -1
  159. package/kits/hub-game/docs/contract.md +2440 -61
  160. package/kits/hub-game/docs/home-pieces.md +64 -0
  161. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  162. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  163. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  164. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  165. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  166. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  167. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  168. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  169. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  170. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  171. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  172. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  173. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  174. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  175. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  176. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  177. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  178. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  179. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  180. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  181. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  182. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  183. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  184. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  185. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  186. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  187. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  188. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  190. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  191. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  192. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  193. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  194. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  195. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  196. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  197. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  198. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  199. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  200. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  201. package/kits/hub-game/package-lock.json +2 -0
  202. package/kits/hub-game/package.json +2 -1
  203. package/kits/hub-game/scripts/check.mjs +78 -11
  204. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  205. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  206. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  207. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  208. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  209. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  210. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  211. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  212. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  213. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  214. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  215. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  216. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  217. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  218. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  219. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  220. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  221. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  222. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  223. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  224. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  225. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  226. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  227. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  228. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  229. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  230. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  231. package/kits/hub-game/scripts/test-build.mjs +31 -0
  232. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  233. package/kits/hub-game/scripts/test-chat.mjs +694 -0
  234. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  235. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  236. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  237. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  238. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  239. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  240. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  241. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  242. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  243. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  244. package/kits/hub-game/scripts/test-grab-client.mjs +186 -3
  245. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  246. package/kits/hub-game/scripts/test-grab.mjs +864 -3
  247. package/kits/hub-game/scripts/test-hats.mjs +483 -0
  248. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  249. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  250. package/kits/hub-game/scripts/test-hub-trip.mjs +1228 -1
  251. package/kits/hub-game/scripts/test-hud-clear.mjs +1000 -0
  252. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  253. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  254. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  255. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  256. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  257. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  258. package/kits/hub-game/scripts/test-manifest.mjs +282 -0
  259. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  260. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  261. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  262. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  263. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  264. package/kits/hub-game/scripts/test-party.mjs +22 -1
  265. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  266. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  267. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  268. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  269. package/kits/hub-game/scripts/test-say.mjs +59 -2
  270. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  271. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  272. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  273. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  274. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  275. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  276. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  277. package/kits/hub-game/scripts/test-tiers.mjs +666 -3
  278. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  279. package/kits/hub-game/scripts/test-try-on.mjs +940 -0
  280. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  281. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  282. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  283. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  284. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  285. package/kits/multiplayer-3d/castle.json +5 -5
  286. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  287. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  288. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  289. package/kits/multiplayer-3d/code/options.js +5 -0
  290. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  291. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  292. package/kits/multiplayer-3d/code/server/world.js +7 -0
  293. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  294. package/kits/multiplayer-3d/package.json +2 -1
  295. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  296. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  297. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  298. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  299. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  300. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  301. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  302. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  303. package/kits/physics-2d/CLAUDE.md +9 -0
  304. package/kits/physics-2d/castle.json +2 -2
  305. package/kits/physics-2d/engine/scene.js +288 -1
  306. package/kits/physics-2d/engine/skyKey.js +129 -0
  307. package/kits/physics-2d/engine/stillClock.js +106 -0
  308. package/kits/physics-2d/engine/updateBudget.js +21 -0
  309. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +370 -1
  310. package/kits/physics-3d/CLAUDE.md +1391 -0
  311. package/kits/physics-3d/behaviors/Player.jsx +921 -3
  312. package/kits/physics-3d/castle.json +3 -3
  313. package/kits/physics-3d/docs/pxmodel-format.md +12 -0
  314. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +98 -10
  315. package/kits/physics-3d/engine3d/actornode.js +86 -0
  316. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  317. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  318. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  319. package/kits/physics-3d/engine3d/framecap.js +96 -0
  320. package/kits/physics-3d/engine3d/gait.js +118 -0
  321. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  322. package/kits/physics-3d/engine3d/look.js +507 -48
  323. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  324. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  325. package/kits/physics-3d/engine3d/motion.js +39 -10
  326. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  327. package/kits/physics-3d/engine3d/optimize.js +58 -5
  328. package/kits/physics-3d/engine3d/orbitinput.js +755 -0
  329. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  330. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  331. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  332. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  333. package/kits/physics-3d/engine3d/sky.js +547 -0
  334. package/kits/physics-3d/engine3d/skylife.js +306 -0
  335. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  336. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  337. package/kits/physics-3d/engine3d/world3d.js +870 -87
  338. package/kits/physics-3d/main.jsx +5 -0
  339. package/kits/physics-3d/package.json +1 -1
  340. package/kits/physics-3d/scripts/Player.before-orbit.mjs +310 -0
  341. package/kits/physics-3d/scripts/Scene3DPlayer.before-orbit.jsx +337 -0
  342. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  343. package/kits/physics-3d/scripts/test-camera-follow.mjs +12 -2
  344. package/kits/physics-3d/scripts/test-camera-orbit.mjs +4588 -0
  345. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +787 -0
  346. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  347. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  348. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  349. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  350. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  351. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  352. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  353. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  354. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  355. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  356. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  357. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  358. package/kits/physics-3d/scripts/test-static-actors.mjs +13 -1
  359. package/kits/physics-3d/scripts/test-static-passes.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  361. package/kits/physics-3d/scripts/test-steady-hover.mjs +635 -0
  362. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  363. package/kits/physics-3d/systems/physics3d.js +474 -12
  364. package/kits/real-time/castle.json +2 -2
  365. package/kits/real-time/code/server/gameHooks.js +7 -0
  366. package/kits/real-time/code/server/session.js +97 -19
  367. package/package.json +2 -2
  368. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -11,8 +11,13 @@
11
11
  // rim and the occlusion are patched into the part's own material. Occlusion
12
12
  // is baked once per model into a vertex attribute, by marching rays through
13
13
  // a coarse grid of the model's surfaces.
14
+ //
15
+ // A scene can ask for the baking to be done after the model is first drawn
16
+ // (Baking later, at the end of this file, and lookbake.js).
14
17
 
15
18
  import * as THREE from 'three';
19
+ import { queueLookBake } from './lookbake';
20
+ import { markKitHooks } from './kithooks';
16
21
 
17
22
  export const LOOK_DEFAULTS = {
18
23
  outline: 0.012,
@@ -92,6 +97,20 @@ export function lookIsEnabled() {
92
97
  }
93
98
 
94
99
  export function applyLook(root, model) {
100
+ if (!later) {
101
+ lookNow(root, model);
102
+ return;
103
+ }
104
+ // What `lookNow` leaves to bake later, with what merging the model's parts
105
+ // left (optimize.js).
106
+ const waiting = { occlusion: null, outlines: later.merged };
107
+ later.waiting = waiting;
108
+ later.merged = [];
109
+ lookNow(root, model);
110
+ queueWaiting(waiting);
111
+ }
112
+
113
+ function lookNow(root, model) {
95
114
  const settings = lookEnabled ? partLooks(model) : null;
96
115
  const meshes = [];
97
116
  root.traverse((object) => {
@@ -185,6 +204,7 @@ function patchMaterial(material, look, geometry) {
185
204
  );
186
205
  };
187
206
  material.customProgramCacheKey = () => `look|${previousKey.call(material)}`;
207
+ markKitHooks(material, previous, previousKey);
188
208
  material.needsUpdate = true;
189
209
  }
190
210
 
@@ -246,7 +266,10 @@ gl_Position = projectionMatrix * mvPosition;
246
266
  const viewport = new THREE.Vector4();
247
267
 
248
268
  function makeOutline(geometry, look, partMaterial) {
249
- addOutlineAttributes(geometry);
269
+ const waits = later !== null && !geometry.getAttribute('lookOutlineNormal');
270
+ if (!waits) {
271
+ addOutlineAttributes(geometry);
272
+ }
250
273
  const material = new THREE.MeshBasicMaterial({
251
274
  color: new THREE.Color(look.outlineColor),
252
275
  side: THREE.BackSide,
@@ -275,6 +298,9 @@ function makeOutline(geometry, look, partMaterial) {
275
298
  renderer.getCurrentViewport(viewport);
276
299
  uniforms.lookViewportHeight.value = Math.max(1, viewport.w / renderer.getPixelRatio());
277
300
  };
301
+ if (waits) {
302
+ waitForOutline(geometry, material);
303
+ }
278
304
  const outline = new OutlineMesh(geometry, material);
279
305
  outline.userData.lookOutline = true;
280
306
  outline.castShadow = false;
@@ -293,13 +319,41 @@ export function addOutlineAttributes(geometry) {
293
319
  if (geometry.getAttribute('lookOutlineNormal')) {
294
320
  return;
295
321
  }
322
+ const work = outlineWork(geometry);
323
+ sumNormalsByPosition(work, 0, work.positions.count);
324
+ smoothNormals(work);
325
+ curvatureRadii(work, 0, work.count);
326
+ for (let pass = 0; pass < UNEVEN_PASSES; pass++) {
327
+ evenOutFolds(work, 0, work.count);
328
+ }
329
+ setOutlineAttributes(geometry, work);
330
+ }
331
+
332
+ // What `addOutlineAttributes` works on. Each of its loops takes the stretch
333
+ // to do, of vertices or of triangle corners, so that baking later can do a
334
+ // geometry a stretch at a time (`outlineSteps`). Vertices at the same
335
+ // position (to 0.1 mm) share a slot; `sums` holds each slot's summed normal,
336
+ // `smooth` each vertex's averaged normal and `bySlot` each slot's reach.
337
+ function outlineWork(geometry) {
296
338
  if (!geometry.getAttribute('normal')) {
297
339
  geometry.computeVertexNormals();
298
340
  }
299
341
  const positions = geometry.getAttribute('position');
300
- const normals = geometry.getAttribute('normal');
301
- const { slots, sums } = sumNormalsByPosition(positions, normals);
302
- const smooth = new Float32Array(positions.count * 3);
342
+ const index = geometry.getIndex();
343
+ return {
344
+ positions,
345
+ normals: geometry.getAttribute('normal'),
346
+ slotOf: new Map(),
347
+ slots: new Uint32Array(positions.count),
348
+ sums: [],
349
+ smooth: new Float32Array(positions.count * 3),
350
+ bySlot: new Float32Array(positions.count).fill(1e6),
351
+ count: index ? index.count : positions.count,
352
+ corner: (n) => (index ? index.getX(n) : n),
353
+ };
354
+ }
355
+
356
+ function smoothNormals({ positions, normals, slots, sums, smooth }) {
303
357
  for (let i = 0; i < positions.count; i++) {
304
358
  const at = slots[i] * 3;
305
359
  const length = Math.hypot(sums[at], sums[at + 1], sums[at + 2]);
@@ -312,18 +366,42 @@ export function addOutlineAttributes(geometry) {
312
366
  smooth.set([sums[at] / length, sums[at + 1] / length, sums[at + 2] / length], i * 3);
313
367
  }
314
368
  }
315
- const reach = curvatureRadii(geometry, positions, smooth, slots);
369
+ }
370
+
371
+ function setOutlineAttributes(geometry, { positions, slots, smooth, bySlot }) {
372
+ const reach = new Float32Array(positions.count);
373
+ for (let i = 0; i < positions.count; i++) {
374
+ reach[i] = bySlot[slots[i]];
375
+ }
316
376
  geometry.setAttribute('lookOutlineNormal', new THREE.BufferAttribute(smooth, 3));
317
377
  geometry.setAttribute('lookOutlineReach', new THREE.BufferAttribute(reach, 1));
318
378
  }
319
379
 
320
- // Vertices at the same position (to 0.1 mm) share a slot; `sums` holds each
321
- // slot's summed normal.
322
- function sumNormalsByPosition(positions, normals) {
323
- const slotOf = new Map();
324
- const slots = new Uint32Array(positions.count);
325
- const sums = [];
326
- for (let i = 0; i < positions.count; i++) {
380
+ // The outline attributes of geometries about to be merged into one
381
+ // (optimize.js): each is given its own, so parts that touch keep an outline
382
+ // between them. When the baking is done later nothing is added, and what is
383
+ // returned says where each part will lie in the merged geometry
384
+ // (`outlineMergedLater`).
385
+ export function outlinePartByPart(geometries) {
386
+ if (!later) {
387
+ geometries.forEach(addOutlineAttributes);
388
+ return null;
389
+ }
390
+ const parts = [];
391
+ let vertex = 0;
392
+ let corner = 0;
393
+ for (const geometry of geometries) {
394
+ const vertices = geometry.getAttribute('position').count;
395
+ const corners = geometry.getIndex().count;
396
+ parts.push({ vertex, vertices, corner, corners });
397
+ vertex += vertices;
398
+ corner += corners;
399
+ }
400
+ return parts;
401
+ }
402
+
403
+ function sumNormalsByPosition({ positions, normals, slotOf, slots, sums }, from, to) {
404
+ for (let i = from; i < to; i++) {
327
405
  const key = `${Math.round(positions.getX(i) * 1e4)},${Math.round(positions.getY(i) * 1e4)},${Math.round(positions.getZ(i) * 1e4)}`;
328
406
  let slot = slotOf.get(key);
329
407
  if (slot === undefined) {
@@ -336,14 +414,9 @@ function sumNormalsByPosition(positions, normals) {
336
414
  sums[slot * 3 + 1] += normals.getY(i);
337
415
  sums[slot * 3 + 2] += normals.getZ(i);
338
416
  }
339
- return { slots, sums };
340
417
  }
341
418
 
342
- function curvatureRadii(geometry, positions, smooth, slots) {
343
- const index = geometry.getIndex();
344
- const count = index ? index.count : positions.count;
345
- const corner = (n) => (index ? index.getX(n) : n);
346
- const bySlot = new Float32Array(slots.length).fill(1e6);
419
+ function curvatureRadii({ positions, smooth, slots, bySlot, corner }, from, to) {
347
420
  const edge = (a, b) => {
348
421
  const dx = positions.getX(b) - positions.getX(a);
349
422
  const dy = positions.getY(b) - positions.getY(a);
@@ -361,7 +434,7 @@ function curvatureRadii(geometry, positions, smooth, slots) {
361
434
  bySlot[slots[a]] = Math.min(bySlot[slots[a]], radius);
362
435
  bySlot[slots[b]] = Math.min(bySlot[slots[b]], radius);
363
436
  };
364
- for (let n = 0; n + 2 < count; n += 3) {
437
+ for (let n = from; n + 2 < to; n += 3) {
365
438
  const a = corner(n);
366
439
  const b = corner(n + 1);
367
440
  const c = corner(n + 2);
@@ -374,14 +447,6 @@ function curvatureRadii(geometry, positions, smooth, slots) {
374
447
  bySlot[slots[at]] = Math.min(bySlot[slots[at]], fold);
375
448
  }
376
449
  }
377
- for (let pass = 0; pass < UNEVEN_PASSES; pass++) {
378
- evenOutFolds(positions, smooth, slots, bySlot, count, corner);
379
- }
380
- const reach = new Float32Array(positions.count);
381
- for (let i = 0; i < positions.count; i++) {
382
- reach[i] = bySlot[slots[i]];
383
- }
384
- return reach;
385
450
  }
386
451
 
387
452
  // A hull triangle pushed too far turns over. Its back then faces the camera
@@ -441,8 +506,8 @@ const UNEVEN_PASSES = 3;
441
506
 
442
507
  const pushed = [new THREE.Vector3(), new THREE.Vector3(), new THREE.Vector3()];
443
508
 
444
- function evenOutFolds(positions, smooth, slots, bySlot, count, corner) {
445
- for (let n = 0; n + 2 < count; n += 3) {
509
+ function evenOutFolds({ positions, smooth, slots, bySlot, corner }, from, to) {
510
+ for (let n = from; n + 2 < to; n += 3) {
446
511
  const corners = [corner(n), corner(n + 1), corner(n + 2)];
447
512
  const reaches = corners.map((at) => bySlot[slots[at]]);
448
513
  const least = Math.min(...reaches);
@@ -516,10 +581,12 @@ function bakeOcclusion(root, model, meshes) {
516
581
  const shape = geometries.map((geometry) => geometry.getAttribute('position').count).join(',');
517
582
  let cached = occlusionCache.get(model);
518
583
  if (!cached || cached.shape !== shape) {
584
+ const firsts = geometries.map((geometry) => firstMesh.get(geometry));
585
+ if (later && waitForOcclusion(root, model, shape, firsts)) {
586
+ return;
587
+ }
519
588
  const grid = buildGrid(root);
520
- const values = geometries.map((geometry) =>
521
- grid ? occlusionOf(firstMesh.get(geometry), grid) : null
522
- );
589
+ const values = firsts.map((mesh) => (grid ? occlusionOf(mesh, grid) : null));
523
590
  cached = { shape, values };
524
591
  occlusionCache.set(model, cached);
525
592
  }
@@ -535,24 +602,46 @@ function bakeOcclusion(root, model, meshes) {
535
602
  // grid of cells. Only surfaces are marked; rays step less than a cell at a
536
603
  // time, so none passes through a marked cell unseen.
537
604
  function buildGrid(root) {
538
- const surfaces = [];
539
- const bounds = new THREE.Box3();
605
+ const opened = openGrid(surfacesOf(root));
606
+ if (!opened) {
607
+ return null;
608
+ }
609
+ for (const surface of opened.surfaces) {
610
+ markTriangles(opened.grid, surface);
611
+ }
612
+ return opened.grid;
613
+ }
614
+
615
+ // The meshes whose surfaces block rays.
616
+ function surfacesOf(root) {
617
+ const meshes = [];
540
618
  root.traverseVisible((object) => {
541
- if (!object.isMesh || object.userData.lookOutline) {
542
- return;
619
+ if (object.isMesh && !object.userData.lookOutline) {
620
+ meshes.push(object);
543
621
  }
544
- const positions = object.geometry.getAttribute('position');
545
- const index = object.geometry.getIndex();
622
+ });
623
+ return meshes;
624
+ }
625
+
626
+ // An empty grid around `meshes` (each a geometry and the matrix that places
627
+ // it), with each one's surface ready to be marked into it, or null when
628
+ // there is nothing to mark.
629
+ function openGrid(meshes) {
630
+ const surfaces = [];
631
+ const bounds = new THREE.Box3();
632
+ const point = new THREE.Vector3();
633
+ for (const { geometry, matrixWorld } of meshes) {
634
+ const positions = geometry.getAttribute('position');
635
+ const index = geometry.getIndex();
546
636
  const count = index ? index.count : positions.count;
547
637
  const world = new Float32Array(positions.count * 3);
548
- const point = new THREE.Vector3();
549
638
  for (let i = 0; i < positions.count; i++) {
550
- point.fromBufferAttribute(positions, i).applyMatrix4(object.matrixWorld);
639
+ point.fromBufferAttribute(positions, i).applyMatrix4(matrixWorld);
551
640
  world.set([point.x, point.y, point.z], i * 3);
552
641
  bounds.expandByPoint(point);
553
642
  }
554
643
  surfaces.push({ world, index, count });
555
- });
644
+ }
556
645
  if (bounds.isEmpty()) {
557
646
  return null;
558
647
  }
@@ -562,10 +651,7 @@ function buildGrid(root) {
562
651
  const origin = bounds.min.clone().subScalar(cell * padding);
563
652
  const dims = [size.x, size.y, size.z].map((extent) => Math.ceil(extent / cell) + padding * 2);
564
653
  const grid = { origin, cell, dims, filled: new Uint8Array(dims[0] * dims[1] * dims[2]) };
565
- for (const surface of surfaces) {
566
- markTriangles(grid, surface);
567
- }
568
- return grid;
654
+ return { grid, surfaces };
569
655
  }
570
656
 
571
657
  // The cell at a point given in cell units from the grid's origin, or -1
@@ -627,8 +713,16 @@ function markTriangles(grid, { world, index, count }) {
627
713
  // For each vertex, the share of its outward rays that reach open air, with
628
714
  // near hits counting more than far ones. Rays start two cells out along the
629
715
  // normal, clear of the cells the vertex's own surface fills, and step 0.7 of
630
- // a cell at a time, in cell units.
716
+ // a cell at a time, in cell units. `mesh` is a mesh, or its geometry and the
717
+ // matrix that placed it.
631
718
  function occlusionOf(mesh, grid) {
719
+ const count = mesh.geometry.getAttribute('position').count;
720
+ return castRays(mesh, grid, new Float32Array(count), 0, count);
721
+ }
722
+
723
+ // `occlusionOf` for the vertices `from` one up to another, written into
724
+ // `out`: baking later does a few at a time.
725
+ function castRays(mesh, grid, out, from, to) {
632
726
  const positions = mesh.geometry.getAttribute('position');
633
727
  let normals = mesh.geometry.getAttribute('normal');
634
728
  if (!normals) {
@@ -639,8 +733,7 @@ function occlusionOf(mesh, grid) {
639
733
  const reach = GRID_CELLS * RAY_REACH;
640
734
  const point = new THREE.Vector3();
641
735
  const normal = new THREE.Vector3();
642
- const out = new Float32Array(positions.count);
643
- for (let i = 0; i < positions.count; i++) {
736
+ for (let i = from; i < to; i++) {
644
737
  point.fromBufferAttribute(positions, i).applyMatrix4(mesh.matrixWorld);
645
738
  point.sub(grid.origin).divideScalar(grid.cell);
646
739
  normal.fromBufferAttribute(normals, i).applyMatrix3(normalMatrix).normalize();
@@ -673,3 +766,369 @@ function occlusionOf(mesh, grid) {
673
766
  }
674
767
  return out;
675
768
  }
769
+
770
+ //
771
+ // Baking later
772
+ //
773
+ // For a scene that set `"engine": { "look": { "bake": "deferred" } }`
774
+ // (lookbake.js). A model built under `bakingLater` comes out as it does
775
+ // otherwise, in the same shape, with the same meshes, materials and shader
776
+ // programs, but for two things that are filled in when its task runs:
777
+ // - `lookOcclusion` is there, all 1, which is a vertex nothing occludes;
778
+ // - an outline hull is there, its material not `visible`, on a geometry that
779
+ // has no outline attributes yet.
780
+ // So nothing that copies, merges or instances the model afterwards
781
+ // (pxmodel.js, optimize.js, world3d.js) has anything to catch up on: copies
782
+ // share the geometry and the hull's material. Once the task has run, the
783
+ // attributes hold what baking at once would have put there.
784
+ //
785
+ // What the task bakes from is written down when the model is built: each
786
+ // surface's geometry and where it stood then. The model is moved afterwards,
787
+ // under a model that references it and by its own animation.
788
+
789
+ // The queue and the owner of the model being built, what its look is waiting
790
+ // for, and the merged geometries met since the last look was applied; null
791
+ // when baking is done at once.
792
+ let later = null;
793
+
794
+ // Runs `build`, which builds a model; the baking its look needs is queued on
795
+ // `queue` (lookbake.js) as `owner`'s instead of being done.
796
+ export function bakingLater(queue, owner, build) {
797
+ const outer = later;
798
+ later = { queue, owner, waiting: null, merged: [] };
799
+ try {
800
+ return build();
801
+ } finally {
802
+ later = outer;
803
+ }
804
+ }
805
+
806
+ // Geometries with an outline whose attributes are still to bake, each with
807
+ // the materials of the hulls drawn from it; and, for a geometry merged from
808
+ // parts, where each part lies in it.
809
+ const outlinesWaiting = new WeakMap();
810
+ const mergedParts = new WeakMap();
811
+
812
+ // `parts` is what `outlinePartByPart` returned for the geometries `geometry`
813
+ // was merged from. Its attributes are baked whether or not a hull is drawn
814
+ // from it, as they are when baking at once.
815
+ export function outlineMergedLater(geometry, parts) {
816
+ mergedParts.set(geometry, parts);
817
+ outlinesWaiting.set(geometry, []);
818
+ later.merged.push(geometry);
819
+ }
820
+
821
+ const placedAsNow = (mesh) => ({ geometry: mesh.geometry, matrixWorld: mesh.matrixWorld.clone() });
822
+
823
+ // Leaves the occlusion of `firsts`, one mesh per geometry, to be baked later.
824
+ // False when the model has no surface to bake against, which takes no time
825
+ // to find out at once.
826
+ function waitForOcclusion(root, model, shape, firsts) {
827
+ const surfaces = surfacesOf(root).map(placedAsNow);
828
+ if (!surfaces.some(({ geometry }) => geometry.getAttribute('position').count > 0)) {
829
+ return false;
830
+ }
831
+ const targets = firsts.map(placedAsNow);
832
+ for (const { geometry } of targets) {
833
+ if (!geometry.getAttribute('normal')) {
834
+ geometry.computeVertexNormals();
835
+ }
836
+ const open = new Float32Array(geometry.getAttribute('position').count).fill(1);
837
+ geometry.setAttribute('lookOcclusion', new THREE.BufferAttribute(open, 1));
838
+ }
839
+ later.waiting.occlusion = { model, shape, surfaces, targets };
840
+ return true;
841
+ }
842
+
843
+ function waitForOutline(geometry, material) {
844
+ let hidden = outlinesWaiting.get(geometry);
845
+ if (!hidden) {
846
+ if (!geometry.getAttribute('normal')) {
847
+ geometry.computeVertexNormals();
848
+ }
849
+ hidden = [];
850
+ outlinesWaiting.set(geometry, hidden);
851
+ later.waiting.outlines.push(geometry);
852
+ }
853
+ hideUntilBaked(material, hidden);
854
+ }
855
+
856
+ // A copy made of the material meanwhile (pxmodel.js gives a recolored copy
857
+ // of a part its own) waits with it.
858
+ function hideUntilBaked(material, hidden) {
859
+ material.visible = false;
860
+ hidden.push(material);
861
+ material.clone = function () {
862
+ const own = THREE.Material.prototype.clone.call(this);
863
+ hideUntilBaked(own, hidden);
864
+ return own;
865
+ };
866
+ }
867
+
868
+ function queueWaiting(waiting) {
869
+ const { queue, owner } = later;
870
+ later.waiting = null;
871
+ const geometries = new Set(waiting.outlines);
872
+ for (const { geometry } of waiting.occlusion?.targets ?? []) {
873
+ geometries.add(geometry);
874
+ }
875
+ if (geometries.size === 0) {
876
+ return;
877
+ }
878
+ const bake = {
879
+ waiting,
880
+ gone: null,
881
+ vertices: new Map([...geometries].map((geometry) => [geometry, geometry.getAttribute('position').count])),
882
+ copies: new Map(),
883
+ results: new Map(),
884
+ given: new WeakMap(),
885
+ };
886
+ const steps = (gone) => {
887
+ bake.gone = gone;
888
+ return bakeLater(bake);
889
+ };
890
+ queueLookBake(queue, owner, [...geometries], steps, (copy, geometry, source) => copied(bake, copy, geometry, source));
891
+ }
892
+
893
+ // One task's baking (lookbake.js states what it keeps to). Of each geometry
894
+ // the task was queued with:
895
+ // - `vertices`: how many vertices it had then;
896
+ // - `copies`: the copies made of it since, and of its copies;
897
+ // - `results`: what each stage that has finished for it gives a geometry,
898
+ // by the stage's name, `occlusion` or `outline`. A result is held here and
899
+ // not read back from a geometry, which may have been disposed unwritten.
900
+ // And of every geometry, copies included, `given`: the stages it holds. So a
901
+ // stage is given to a geometry once, whenever the two meet: when the stage
902
+ // finishes (`finish`) or when the copy is made (`copied`).
903
+
904
+ // The geometries the baking of `geometry` is given to: itself and its
905
+ // copies, in that order, leaving out every one disposed (`gone`) and any
906
+ // that no longer has the vertices it was built with.
907
+ function writtenNow(bake, geometry) {
908
+ const count = bake.vertices.get(geometry);
909
+ const held = [geometry, ...(bake.copies.get(geometry) ?? [])];
910
+ return held.filter((one) => !bake.gone.has(one) && one.getAttribute('position')?.count === count);
911
+ }
912
+
913
+ // Gives each of them every finished stage it does not hold. A hull is shown
914
+ // once something it can be drawn from has its outline attributes; while the
915
+ // geometry and all its copies are gone its material stays as it is, not drawn.
916
+ function settle(bake, geometry) {
917
+ const results = bake.results.get(geometry);
918
+ const written = results ? writtenNow(bake, geometry) : [];
919
+ for (const held of written) {
920
+ const given = bake.given.get(held) ?? new Set();
921
+ bake.given.set(held, given);
922
+ for (const [stage, give] of results) {
923
+ if (!given.has(stage)) {
924
+ give(held, held === geometry);
925
+ given.add(stage);
926
+ }
927
+ }
928
+ }
929
+ const hidden = outlinesWaiting.get(geometry);
930
+ if (hidden && written.length > 0 && results.has('outline')) {
931
+ for (const material of hidden) {
932
+ material.visible = true;
933
+ delete material.clone;
934
+ }
935
+ outlinesWaiting.delete(geometry);
936
+ }
937
+ }
938
+
939
+ // A stage has finished for `geometry`: `give(held, own)` puts its result into
940
+ // one geometry, `own` when that is `geometry` itself.
941
+ function finish(bake, geometry, stage, give) {
942
+ const results = bake.results.get(geometry) ?? new Map();
943
+ bake.results.set(geometry, results);
944
+ results.set(stage, give);
945
+ settle(bake, geometry);
946
+ }
947
+
948
+ // `copy` was made of `source`, which is `geometry` or a copy of it
949
+ // (lookbake.js): it holds what `source` held, and is given the rest.
950
+ function copied(bake, copy, geometry, source) {
951
+ const copies = bake.copies.get(geometry) ?? [];
952
+ bake.copies.set(geometry, copies);
953
+ copies.push(copy);
954
+ bake.given.set(copy, new Set(bake.given.get(source)));
955
+ settle(bake, geometry);
956
+ }
957
+
958
+ // Whether an outline is still to be worked out for `geometry`: nothing has
959
+ // been, something is left to give it to, and the geometry it is worked out
960
+ // from is as it was built.
961
+ function outlineStillWanted(bake, geometry) {
962
+ const asBuilt = geometry.getAttribute('position')?.count === bake.vertices.get(geometry);
963
+ return asBuilt && !bake.results.get(geometry)?.has('outline') && writtenNow(bake, geometry).length > 0;
964
+ }
965
+
966
+ // One model's baking, a step at a time. The outlines are gone over until
967
+ // none is wanted, since a copy can be made of a geometry passed over because
968
+ // it and its copies were gone. Returns whether every geometry of the task
969
+ // that is not disposed, copies included, holds every stage: false when one
970
+ // was left because its vertices were replaced.
971
+ function* bakeLater(bake) {
972
+ const { occlusion, outlines } = bake.waiting;
973
+ if (occlusion) {
974
+ yield* occlusionLater(occlusion, bake);
975
+ }
976
+ for (let wanted = true; wanted; ) {
977
+ wanted = false;
978
+ for (const geometry of outlines) {
979
+ if (outlineStillWanted(bake, geometry)) {
980
+ wanted = true;
981
+ yield* outlineLater(geometry, bake);
982
+ yield;
983
+ }
984
+ }
985
+ }
986
+ return everyStageGiven(bake);
987
+ }
988
+
989
+ // Whether every geometry of the task that is not disposed holds every stage
990
+ // of the geometry it is, or is a copy of: those finished, and an outline
991
+ // that was waited for and never worked out.
992
+ function everyStageGiven(bake) {
993
+ const waited = new Set(bake.waiting.outlines);
994
+ for (const [geometry] of bake.vertices) {
995
+ const results = bake.results.get(geometry);
996
+ const stages = (results?.size ?? 0) + (waited.has(geometry) && !results?.has('outline') ? 1 : 0);
997
+ const held = [geometry, ...(bake.copies.get(geometry) ?? [])];
998
+ if (held.some((one) => !bake.gone.has(one) && (bake.given.get(one)?.size ?? 0) < stages)) {
999
+ return false;
1000
+ }
1001
+ }
1002
+ return true;
1003
+ }
1004
+
1005
+ // How many vertices cast their rays in one step: small beside the budget
1006
+ // (lookbake.js), so a long geometry does not hold a frame up.
1007
+ const VERTICES_A_STEP = 128;
1008
+
1009
+ // `bakeOcclusion`, from what was written down. Another build of the model
1010
+ // may have baked it since. The values take the place of the 1s in the
1011
+ // attribute that is already there, and already on the GPU, rather than in a
1012
+ // new one; a copy of the geometry gets values of its own, as a copy of a
1013
+ // baked geometry has.
1014
+ function* occlusionLater({ model, shape, surfaces, targets }, bake) {
1015
+ let cached = occlusionCache.get(model);
1016
+ if (!cached || cached.shape !== shape) {
1017
+ const opened = openGrid(surfaces);
1018
+ yield;
1019
+ for (const surface of opened?.surfaces ?? []) {
1020
+ markTriangles(opened.grid, surface);
1021
+ yield;
1022
+ }
1023
+ const values = [];
1024
+ for (const target of targets) {
1025
+ const count = target.geometry.getAttribute('position').count;
1026
+ const out = opened ? new Float32Array(count) : null;
1027
+ for (let from = 0; opened && from < count; from += VERTICES_A_STEP) {
1028
+ castRays(target, opened.grid, out, from, Math.min(count, from + VERTICES_A_STEP));
1029
+ yield;
1030
+ }
1031
+ values.push(out);
1032
+ }
1033
+ cached = { shape, values };
1034
+ occlusionCache.set(model, cached);
1035
+ }
1036
+ targets.forEach(({ geometry }, index) => {
1037
+ const values = cached.values[index];
1038
+ if (!values) {
1039
+ return;
1040
+ }
1041
+ finish(bake, geometry, 'occlusion', (held, own) => {
1042
+ const attribute = held.getAttribute('lookOcclusion');
1043
+ if (attribute) {
1044
+ attribute.array = own ? values : values.slice();
1045
+ attribute.needsUpdate = true;
1046
+ }
1047
+ });
1048
+ });
1049
+ }
1050
+
1051
+ // How many vertices, or triangle corners, of a geometry's outline are done
1052
+ // in one step. A multiple of 3, so a stretch of corners is whole triangles.
1053
+ const OUTLINE_STEP = 384;
1054
+
1055
+ function* stretches(total) {
1056
+ for (let from = 0; from < total; from += OUTLINE_STEP) {
1057
+ yield [from, Math.min(total, from + OUTLINE_STEP)];
1058
+ }
1059
+ }
1060
+
1061
+ // `addOutlineAttributes`, a stretch at a time, in the same order, up to
1062
+ // setting the attributes: it returns what `setOutlineAttributes` takes.
1063
+ function* outlineSteps(geometry) {
1064
+ const work = outlineWork(geometry);
1065
+ for (const [from, to] of stretches(work.positions.count)) {
1066
+ sumNormalsByPosition(work, from, to);
1067
+ yield;
1068
+ }
1069
+ smoothNormals(work);
1070
+ for (const [from, to] of stretches(work.count)) {
1071
+ curvatureRadii(work, from, to);
1072
+ yield;
1073
+ }
1074
+ for (let pass = 0; pass < UNEVEN_PASSES; pass++) {
1075
+ for (const [from, to] of stretches(work.count)) {
1076
+ evenOutFolds(work, from, to);
1077
+ yield;
1078
+ }
1079
+ }
1080
+ return work;
1081
+ }
1082
+
1083
+ // The outline attributes of a waiting geometry, worked out from it as
1084
+ // `addOutlineAttributes` does, or for one merged from parts, part by part, as
1085
+ // `outlinePartByPart` does it before the merge; then given to it and its
1086
+ // copies (`finish`), a copy in arrays of its own. A geometry that has them
1087
+ // already, baked at once by another build, gives its copies those.
1088
+ function* outlineLater(geometry, bake) {
1089
+ let from = geometry;
1090
+ if (!geometry.getAttribute('lookOutlineNormal')) {
1091
+ const parts = mergedParts.get(geometry);
1092
+ from = yield* parts ? mergedOutline(geometry, parts) : wholeOutline(geometry);
1093
+ mergedParts.delete(geometry);
1094
+ } else if (!bake.gone.has(geometry)) {
1095
+ bake.given.set(geometry, new Set(bake.given.get(geometry)).add('outline'));
1096
+ }
1097
+ const normal = from.getAttribute('lookOutlineNormal').array;
1098
+ const reach = from.getAttribute('lookOutlineReach').array;
1099
+ finish(bake, geometry, 'outline', (held, own) => {
1100
+ held.setAttribute('lookOutlineNormal', new THREE.BufferAttribute(own ? normal : normal.slice(), 3));
1101
+ held.setAttribute('lookOutlineReach', new THREE.BufferAttribute(own ? reach : reach.slice(), 1));
1102
+ });
1103
+ }
1104
+
1105
+ // Each returns a geometry of its own that holds the two attributes, whatever
1106
+ // has become of `geometry` meanwhile.
1107
+ function* wholeOutline(geometry) {
1108
+ const made = new THREE.BufferGeometry();
1109
+ setOutlineAttributes(made, yield* outlineSteps(geometry));
1110
+ return made;
1111
+ }
1112
+
1113
+ function* mergedOutline(geometry, parts) {
1114
+ const positions = geometry.getAttribute('position');
1115
+ const normals = geometry.getAttribute('normal');
1116
+ const index = geometry.getIndex();
1117
+ const smooth = new Float32Array(positions.count * 3);
1118
+ const reach = new Float32Array(positions.count);
1119
+ for (const { vertex, vertices, corner, corners } of parts) {
1120
+ const part = new THREE.BufferGeometry();
1121
+ for (const [name, attribute] of [['position', positions], ['normal', normals]]) {
1122
+ const own = attribute.array.subarray(vertex * 3, (vertex + vertices) * 3);
1123
+ part.setAttribute(name, new THREE.BufferAttribute(own, 3));
1124
+ }
1125
+ part.setIndex(Array.from(index.array.subarray(corner, corner + corners), (at) => at - vertex));
1126
+ setOutlineAttributes(part, yield* outlineSteps(part));
1127
+ smooth.set(part.getAttribute('lookOutlineNormal').array, vertex * 3);
1128
+ reach.set(part.getAttribute('lookOutlineReach').array, vertex);
1129
+ }
1130
+ const made = new THREE.BufferGeometry();
1131
+ made.setAttribute('lookOutlineNormal', new THREE.BufferAttribute(smooth, 3));
1132
+ made.setAttribute('lookOutlineReach', new THREE.BufferAttribute(reach, 1));
1133
+ return made;
1134
+ }