castle-web-cli 0.4.232 → 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.
- package/dist/agent-failures.d.ts +8 -0
- package/dist/agent-failures.js +19 -2
- package/dist/agent-prompts.d.ts +1 -1
- package/dist/agent-prompts.js +10 -3
- package/dist/agent.d.ts +64 -3
- package/dist/agent.js +170 -81
- package/dist/castle-host/host.d.ts +1 -0
- package/dist/castle-host/host.js +51 -3
- package/dist/castleJson.d.ts +4 -2
- package/dist/castleJson.js +2 -0
- package/dist/check.d.ts +3 -1
- package/dist/check.js +11 -1
- package/dist/devSessionStorage.js +47 -1
- package/dist/importPinMismatch.d.ts +22 -0
- package/dist/importPinMismatch.js +77 -0
- package/dist/importRegression.js +3 -15
- package/dist/imports.d.ts +10 -3
- package/dist/imports.js +88 -20
- package/dist/index.js +5 -4
- package/dist/init.js +1 -1
- package/dist/platformDoc.js +22 -0
- package/dist/routerFences.d.ts +5 -0
- package/dist/routerFences.js +12 -2
- package/dist/save-deck.d.ts +5 -0
- package/dist/save-deck.js +37 -4
- package/dist/serve.js +3 -0
- package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
- package/dist/shell/assets/index-MVLfNYd9.css +1 -0
- package/dist/shell/index.html +2 -2
- package/dist/taskSteer.d.ts +13 -0
- package/dist/taskSteer.js +22 -2
- package/kits/base/castle.json +1 -1
- package/kits/base/package-lock.json +1 -1
- package/kits/base/sdk/README.md +79 -2
- package/kits/base/sdk/avatar.d.ts +6 -2
- package/kits/base/sdk/avatar.js +12 -4
- package/kits/base/sdk/castle.d.ts +1 -1
- package/kits/base/sdk/commands.d.ts +14 -0
- package/kits/base/sdk/hub.d.ts +6 -2
- package/kits/base/sdk/hub.js +13 -0
- package/kits/base/sdk/multiplayer.js +17 -1
- package/kits/base/sdk/save.js +2 -1
- package/kits/base/sdk/server/hub.d.ts +87 -0
- package/kits/base/sdk/server/hub.js +70 -0
- package/kits/base/sdk/server/platformHandle.d.ts +31 -1
- package/kits/base/sdk/server/storage.d.ts +13 -0
- package/kits/base/sdk/server/storage.js +46 -0
- package/kits/base/sdk/server/wrapper.d.ts +36 -5
- package/kits/base/sdk/server/wrapper.js +83 -8
- package/kits/hub-game/CLAUDE.md +329 -11
- package/kits/hub-game/blueprints/avatar-10.scene +28 -0
- package/kits/hub-game/blueprints/avatar-11.scene +28 -0
- package/kits/hub-game/blueprints/avatar-12.scene +28 -0
- package/kits/hub-game/blueprints/avatar-13.scene +28 -0
- package/kits/hub-game/blueprints/avatar-14.scene +28 -0
- package/kits/hub-game/blueprints/avatar-15.scene +28 -0
- package/kits/hub-game/blueprints/avatar-4.scene +28 -0
- package/kits/hub-game/blueprints/avatar-5.scene +28 -0
- package/kits/hub-game/blueprints/avatar-6.scene +28 -0
- package/kits/hub-game/blueprints/avatar-7.scene +28 -0
- package/kits/hub-game/blueprints/avatar-8.scene +28 -0
- package/kits/hub-game/blueprints/avatar-9.scene +28 -0
- package/kits/hub-game/code/client/actorBudget.js +47 -0
- package/kits/hub-game/code/client/attention.js +11 -2
- package/kits/hub-game/code/client/avatar.js +309 -35
- package/kits/hub-game/code/client/avatarCap.js +228 -0
- package/kits/hub-game/code/client/avatarColors.js +70 -0
- package/kits/hub-game/code/client/avatarFaces.js +21 -0
- package/kits/hub-game/code/client/avatarShare.js +251 -0
- package/kits/hub-game/code/client/ballot.js +467 -0
- package/kits/hub-game/code/client/build.js +22 -0
- package/kits/hub-game/code/client/chrome.js +1144 -50
- package/kits/hub-game/code/client/companion.js +716 -0
- package/kits/hub-game/code/client/companionDress.js +99 -0
- package/kits/hub-game/code/client/decor.js +509 -0
- package/kits/hub-game/code/client/earned.js +131 -0
- package/kits/hub-game/code/client/emoteBubble.js +75 -0
- package/kits/hub-game/code/client/grab.js +339 -20
- package/kits/hub-game/code/client/hookLayer.js +299 -13
- package/kits/hub-game/code/client/idle.js +163 -22
- package/kits/hub-game/code/client/interestCap.js +81 -0
- package/kits/hub-game/code/client/keys.js +36 -0
- package/kits/hub-game/code/client/labelsNear.js +205 -0
- package/kits/hub-game/code/client/menuIcons.js +34 -0
- package/kits/hub-game/code/client/pack.js +6 -2
- package/kits/hub-game/code/client/packFormat.js +3 -3
- package/kits/hub-game/code/client/rehello.js +167 -0
- package/kits/hub-game/code/client/shot.js +92 -0
- package/kits/hub-game/code/client/sound.js +63 -8
- package/kits/hub-game/code/client/soundscape.js +1151 -0
- package/kits/hub-game/code/client/soundscapeActions.js +99 -0
- package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
- package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
- package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
- package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
- package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
- package/kits/hub-game/code/client/soundscapeCues.js +362 -0
- package/kits/hub-game/code/client/soundscapeMap.js +181 -0
- package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
- package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
- package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
- package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
- package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
- package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
- package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
- package/kits/hub-game/code/client/soundscapeUi.js +211 -0
- package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
- package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
- package/kits/hub-game/code/client/spin.js +101 -0
- package/kits/hub-game/code/client/state.js +109 -1
- package/kits/hub-game/code/client/stuck.js +259 -0
- package/kits/hub-game/code/client/talk.js +538 -47
- package/kits/hub-game/code/client/tiers.js +516 -27
- package/kits/hub-game/code/client/toastBand.js +37 -0
- package/kits/hub-game/code/client/together.js +32 -0
- package/kits/hub-game/code/client/visibility.js +43 -0
- package/kits/hub-game/code/client/wear.js +461 -170
- package/kits/hub-game/code/client/yours.js +199 -0
- package/kits/hub-game/code/companionSpec.js +45 -0
- package/kits/hub-game/code/privateText.js +7 -0
- package/kits/hub-game/code/server/actions.js +133 -0
- package/kits/hub-game/code/server/actors.js +9 -1
- package/kits/hub-game/code/server/ask.js +155 -0
- package/kits/hub-game/code/server/ballot.js +539 -0
- package/kits/hub-game/code/server/cells.js +100 -0
- package/kits/hub-game/code/server/companion.js +82 -0
- package/kits/hub-game/code/server/cues.js +70 -0
- package/kits/hub-game/code/server/decor.js +269 -0
- package/kits/hub-game/code/server/earned.js +461 -0
- package/kits/hub-game/code/server/friendBests.js +166 -0
- package/kits/hub-game/code/server/friendsAmong.js +232 -0
- package/kits/hub-game/code/server/history.js +5 -0
- package/kits/hub-game/code/server/hub.js +1254 -50
- package/kits/hub-game/code/server/idle.js +30 -11
- package/kits/hub-game/code/server/index.js +2 -2
- package/kits/hub-game/code/server/labels.js +28 -2
- package/kits/hub-game/code/server/manifest.js +378 -7
- package/kits/hub-game/code/server/menu.js +133 -0
- package/kits/hub-game/code/server/npcs.js +830 -80
- package/kits/hub-game/code/server/party.js +2 -2
- package/kits/hub-game/code/server/players.js +22 -0
- package/kits/hub-game/code/server/shot.js +110 -0
- package/kits/hub-game/code/server/standing.js +124 -0
- package/kits/hub-game/code/server/vis.js +113 -0
- package/kits/hub-game/code/server/wear.js +12 -0
- package/kits/hub-game/code/server/yours.js +59 -0
- package/kits/hub-game/code/shared/cues.js +9 -0
- package/kits/hub-game/code/shared/decor.js +41 -0
- package/kits/hub-game/code/shared/shot.js +19 -0
- package/kits/hub-game/code/shared/spin.js +57 -0
- package/kits/hub-game/code/systems/hub.js +845 -95
- package/kits/hub-game/docs/content-pack.md +1 -1
- package/kits/hub-game/docs/contract.md +2244 -61
- package/kits/hub-game/docs/home-pieces.md +64 -0
- package/kits/hub-game/models/avatar-10.pxmodel +28 -0
- package/kits/hub-game/models/avatar-11.pxmodel +28 -0
- package/kits/hub-game/models/avatar-12.pxmodel +27 -0
- package/kits/hub-game/models/avatar-13.pxmodel +24 -0
- package/kits/hub-game/models/avatar-14.pxmodel +29 -0
- package/kits/hub-game/models/avatar-15.pxmodel +24 -0
- package/kits/hub-game/models/avatar-4.pxmodel +29 -0
- package/kits/hub-game/models/avatar-5.pxmodel +27 -0
- package/kits/hub-game/models/avatar-6.pxmodel +26 -0
- package/kits/hub-game/models/avatar-7.pxmodel +25 -0
- package/kits/hub-game/models/avatar-8.pxmodel +24 -0
- package/kits/hub-game/models/avatar-9.pxmodel +30 -0
- package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
- package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
- package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
- package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
- package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
- package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
- package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
- package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
- package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
- package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
- package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
- package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
- package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
- package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
- package/kits/hub-game/models/hats/cap.pxmodel +162 -0
- package/kits/hub-game/models/hats/captain.pxmodel +178 -0
- package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
- package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
- package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
- package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
- package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
- package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
- package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
- package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
- package/kits/hub-game/models/hats/straw.pxmodel +139 -0
- package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
- package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
- package/kits/hub-game/models/hats/witch.pxmodel +147 -0
- package/kits/hub-game/package-lock.json +2 -0
- package/kits/hub-game/package.json +2 -1
- package/kits/hub-game/scripts/check.mjs +78 -11
- package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
- package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
- package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
- package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
- package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
- package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
- package/kits/hub-game/scripts/gen-earned.mjs +285 -0
- package/kits/hub-game/scripts/gen-hats.mjs +827 -0
- package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
- package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
- package/kits/hub-game/scripts/test-actions.mjs +298 -0
- package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
- package/kits/hub-game/scripts/test-actors.mjs +19 -17
- package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
- package/kits/hub-game/scripts/test-ask.mjs +269 -0
- package/kits/hub-game/scripts/test-attention.mjs +10 -1
- package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
- package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
- package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
- package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
- package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
- package/kits/hub-game/scripts/test-avatar.mjs +540 -7
- package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
- package/kits/hub-game/scripts/test-build.mjs +31 -0
- package/kits/hub-game/scripts/test-cells.mjs +71 -0
- package/kits/hub-game/scripts/test-chat.mjs +662 -0
- package/kits/hub-game/scripts/test-classic.mjs +2 -0
- package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
- package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
- package/kits/hub-game/scripts/test-companion.mjs +259 -0
- package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
- package/kits/hub-game/scripts/test-decor.mjs +457 -0
- package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
- package/kits/hub-game/scripts/test-earned.mjs +1194 -0
- package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
- package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
- package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
- package/kits/hub-game/scripts/test-grab.mjs +7 -0
- package/kits/hub-game/scripts/test-hats.mjs +422 -168
- package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
- package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
- package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
- package/kits/hub-game/scripts/test-idle.mjs +361 -1
- package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
- package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
- package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
- package/kits/hub-game/scripts/test-keys.mjs +46 -1
- package/kits/hub-game/scripts/test-labels.mjs +596 -0
- package/kits/hub-game/scripts/test-manifest.mjs +207 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
- package/kits/hub-game/scripts/test-menu.mjs +296 -0
- package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
- package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
- package/kits/hub-game/scripts/test-pack.mjs +7 -0
- package/kits/hub-game/scripts/test-picker.mjs +314 -0
- package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
- package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
- package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
- package/kits/hub-game/scripts/test-shot.mjs +756 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
- package/kits/hub-game/scripts/test-spin.mjs +314 -0
- package/kits/hub-game/scripts/test-standing.mjs +416 -0
- package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
- package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
- package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
- package/kits/hub-game/scripts/test-tiers.mjs +477 -2
- package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
- package/kits/hub-game/scripts/test-try-on.mjs +22 -22
- package/kits/hub-game/scripts/test-vis.mjs +343 -0
- package/kits/hub-game/scripts/test-visibility.mjs +134 -0
- package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
- package/kits/hub-game/scripts/test-yours.mjs +372 -0
- package/kits/multiplayer-3d/CLAUDE.md +50 -0
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/avatars.js +7 -0
- package/kits/multiplayer-3d/code/client/gait.js +65 -0
- package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
- package/kits/multiplayer-3d/code/options.js +5 -0
- package/kits/multiplayer-3d/code/server/ownership.js +10 -2
- package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
- package/kits/multiplayer-3d/code/server/world.js +7 -0
- package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
- package/kits/multiplayer-3d/package.json +2 -1
- package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
- package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
- package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
- package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
- package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
- package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
- package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
- package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
- package/kits/physics-2d/CLAUDE.md +9 -0
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/scene.js +253 -1
- package/kits/physics-2d/engine/skyKey.js +129 -0
- package/kits/physics-2d/engine/stillClock.js +106 -0
- package/kits/physics-2d/engine/updateBudget.js +21 -0
- package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
- package/kits/physics-3d/CLAUDE.md +1169 -30
- package/kits/physics-3d/behaviors/Player.jsx +629 -72
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/pxmodel-format.md +8 -0
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
- package/kits/physics-3d/engine3d/actornode.js +86 -0
- package/kits/physics-3d/engine3d/animationBudget.js +23 -0
- package/kits/physics-3d/engine3d/editorWorld.js +6 -0
- package/kits/physics-3d/engine3d/emptynodes.js +232 -0
- package/kits/physics-3d/engine3d/framecap.js +96 -0
- package/kits/physics-3d/engine3d/gait.js +118 -0
- package/kits/physics-3d/engine3d/kithooks.js +47 -0
- package/kits/physics-3d/engine3d/look.js +507 -48
- package/kits/physics-3d/engine3d/lookbake.js +208 -0
- package/kits/physics-3d/engine3d/materialpresets.js +2 -0
- package/kits/physics-3d/engine3d/motion.js +39 -10
- package/kits/physics-3d/engine3d/nearshadows.js +37 -19
- package/kits/physics-3d/engine3d/optimize.js +9 -5
- package/kits/physics-3d/engine3d/orbitinput.js +487 -9
- package/kits/physics-3d/engine3d/orbitlens.js +48 -0
- package/kits/physics-3d/engine3d/ownmodel.js +213 -0
- package/kits/physics-3d/engine3d/pxmodel.js +42 -11
- package/kits/physics-3d/engine3d/shadowfade.js +882 -0
- package/kits/physics-3d/engine3d/sky.js +547 -0
- package/kits/physics-3d/engine3d/skylife.js +306 -0
- package/kits/physics-3d/engine3d/unchanged.js +11 -0
- package/kits/physics-3d/engine3d/viewrange.js +52 -0
- package/kits/physics-3d/engine3d/world3d.js +796 -69
- package/kits/physics-3d/main.jsx +5 -0
- package/kits/physics-3d/package.json +1 -1
- package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
- package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
- package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
- package/kits/physics-3d/scripts/test-gait.mjs +387 -0
- package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
- package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
- package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
- package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
- package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
- package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
- package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
- package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
- package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
- package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
- package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
- package/kits/physics-3d/systems/physics3d.js +383 -6
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/server/gameHooks.js +7 -0
- package/kits/real-time/code/server/session.js +97 -19
- package/package.json +2 -2
- package/dist/shell/assets/index-Cf61cNfT.css +0 -1
|
@@ -0,0 +1,306 @@
|
|
|
1
|
+
// The life of the sky a world draws for a scene that set
|
|
2
|
+
// `"engine": { "sky": { ... } }`: when its dome is in the scene graph, and
|
|
3
|
+
// when what it owns on the GPU is let go. sky.js makes the dome and decides
|
|
4
|
+
// what it shows; everything about how long any of it lasts is here, in one
|
|
5
|
+
// place.
|
|
6
|
+
//
|
|
7
|
+
// The invariant:
|
|
8
|
+
//
|
|
9
|
+
// The dome and its resources are attached, detached and disposed only by
|
|
10
|
+
// the outermost render of their world, or with no render of that world in
|
|
11
|
+
// progress. Nothing a callback does (re-enter, throw, load, dispose) can
|
|
12
|
+
// leave a dome in the scene graph, a disposed resource in a render list,
|
|
13
|
+
// or a sky record alive past its key.
|
|
14
|
+
//
|
|
15
|
+
// It does not depend on which way a frame went, because every frame goes
|
|
16
|
+
// the same way. `skyFrame` is: count the frame in, prepare, draw, count it
|
|
17
|
+
// out, and if it was the outermost, `settle`. With or without a record, with
|
|
18
|
+
// or without an error, returned or thrown: the same five steps.
|
|
19
|
+
//
|
|
20
|
+
// The postcondition, which `settle` alone enforces, from what it reads at
|
|
21
|
+
// that moment and nothing a frame remembered:
|
|
22
|
+
//
|
|
23
|
+
// After the outermost frame of a world returns or throws, EITHER
|
|
24
|
+
// `world.sky` is null, OR it is a record whose key is the key the frame's
|
|
25
|
+
// runtime has NOW for THIS world, with its dome out of the scene graph,
|
|
26
|
+
// and neither that frame nor any frame drawn from inside it threw.
|
|
27
|
+
//
|
|
28
|
+
// "The key a runtime has for a world" (`skyKeyFor`) is its `sky`, unless the
|
|
29
|
+
// world is disposed or the runtime draws in another world (its `three` is
|
|
30
|
+
// set and is not this one): then it has none. So a runtime handed to
|
|
31
|
+
// `renderWorld` for a world it does not belong to never gets a sky there.
|
|
32
|
+
//
|
|
33
|
+
// The pieces, each acting only on what it reads when it acts:
|
|
34
|
+
//
|
|
35
|
+
// - `world.skyDepth` counts the frames of this world in progress that came
|
|
36
|
+
// through `skyFrame`, and a disposal in progress counts as one. Only at
|
|
37
|
+
// depth 1 (the outermost frame, with nothing being disposed) does
|
|
38
|
+
// `prepare` run, and only at depth 0 do `settle` and `leaveSky` release.
|
|
39
|
+
// - `prepare` (the outermost frame, before its draw): a record not of the
|
|
40
|
+
// runtime's key goes; if there is none and the runtime has a key, one is
|
|
41
|
+
// made; the record is stepped, and what the step let go is disposed;
|
|
42
|
+
// and a record of the runtime's key is attached. Each of those four reads
|
|
43
|
+
// `world.sky` again first, and the key wherever a deck's code may have
|
|
44
|
+
// run since it was last read (a `dispose` listener in the first, a getter
|
|
45
|
+
// on the Player's Transform or the deck's art in the third).
|
|
46
|
+
// - A frame from inside another, or from inside a disposal (depth above 1),
|
|
47
|
+
// never makes, steps, attaches, detaches or disposes. If a dome is in the
|
|
48
|
+
// scene graph and is not of that frame's runtime's key, it is hidden for
|
|
49
|
+
// that draw and shown again after, which dispatches nothing.
|
|
50
|
+
// - `settle` (after the outermost frame, at depth 0): the dome is taken out
|
|
51
|
+
// of the scene graph; then the record stays only if its key is the
|
|
52
|
+
// runtime's key now and nothing threw. Otherwise it is released.
|
|
53
|
+
// - `release` is the one place anything a record owns is disposed. It takes
|
|
54
|
+
// the record off the world first, so nothing can reach it again, leaves
|
|
55
|
+
// RELEASING in its place and counts itself into `skyDepth` while the
|
|
56
|
+
// `dispose` listeners run: a frame one of them draws, of any scene or of
|
|
57
|
+
// none, comes through `skyFrame` as a frame from inside, makes nothing,
|
|
58
|
+
// and is heard if it throws; a load or a dispose one of them causes
|
|
59
|
+
// releases nothing. Every listener on every resource is called, each in a
|
|
60
|
+
// guard of its own (`disposed`). So it runs once a record, calls every
|
|
61
|
+
// listener once, and leaves `world.sky` null: `settle` has nothing to
|
|
62
|
+
// loop on. RELEASING is never a record: `prepare` and `settle` run only
|
|
63
|
+
// when no disposal is going, so they never meet it.
|
|
64
|
+
// - Each record keeps the world's optional call-out hook, acquired only
|
|
65
|
+
// when it is made. It brackets the whole resource release, and the whole
|
|
66
|
+
// shed-texture disposal after a step, so disposal listeners see no adopted
|
|
67
|
+
// or frozen scenery and nested actor passes cannot adopt. It adds no sky
|
|
68
|
+
// depth and handles no errors: `disposed` still keeps them as data. Without
|
|
69
|
+
// a hook those same blocks run directly; without textures shed the hook
|
|
70
|
+
// is neither tested nor called.
|
|
71
|
+
// - A scene load (systems/physics3d.js `reset`, at the start of
|
|
72
|
+
// `SceneRuntime.load`) and `disposeWorld` call `leaveSky`: with no frame
|
|
73
|
+
// in progress the record is released there and then (a load releases only
|
|
74
|
+
// the record of the key it is replacing); with one in progress nothing is
|
|
75
|
+
// done, and `settle` finds the key gone.
|
|
76
|
+
// - Attaching and detaching write `parent` and `children` directly: no
|
|
77
|
+
// `added`, `removed`, `childadded` or `childremoved` is dispatched, so no
|
|
78
|
+
// listener runs and neither can throw.
|
|
79
|
+
//
|
|
80
|
+
// Errors are data. A step or a disposal that throws does not stop the frame:
|
|
81
|
+
// the first such error is kept, the frame is drawn (without a sky), every
|
|
82
|
+
// release that is due still runs, and the error is thrown at the frame's one
|
|
83
|
+
// exit, after `settle`. A frame's own error (its draw's) is thrown over a
|
|
84
|
+
// kept one. Any error at all, the frame's or one from a frame inside it that
|
|
85
|
+
// its caller caught, and `settle` keeps no record.
|
|
86
|
+
//
|
|
87
|
+
// No imports: systems/physics3d.js and the tests load it alone.
|
|
88
|
+
|
|
89
|
+
// Into the scene graph and out of it, without three.js's events.
|
|
90
|
+
function attach(record, scene) {
|
|
91
|
+
detach(record);
|
|
92
|
+
scene.children.push(record.mesh);
|
|
93
|
+
record.mesh.parent = scene;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
function detach(record) {
|
|
97
|
+
const mesh = record.mesh;
|
|
98
|
+
const parent = mesh.parent;
|
|
99
|
+
if (!parent) return;
|
|
100
|
+
const at = parent.children.indexOf(mesh);
|
|
101
|
+
if (at !== -1) parent.children.splice(at, 1);
|
|
102
|
+
mesh.parent = null;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
// The key a runtime has for a world, now; or null.
|
|
106
|
+
export function skyKeyFor(world, runtime) {
|
|
107
|
+
if (!runtime || world.disposed === true) return null;
|
|
108
|
+
const drawsIn = runtime.three;
|
|
109
|
+
if (drawsIn !== undefined && drawsIn !== null && drawsIn !== world) return null;
|
|
110
|
+
return runtime.sky ?? null;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
// What `world.sky` is while a record's resources are being disposed: not a
|
|
114
|
+
// record, and it owns nothing. It is there so that every `renderWorld` of
|
|
115
|
+
// the world during a disposal, a scene's without the key and an editor's
|
|
116
|
+
// included, comes through `skyFrame` (world3d.js sends a frame here when the
|
|
117
|
+
// runtime has a key or `world.sky` is set) and is a frame from inside: it
|
|
118
|
+
// makes nothing, and if it throws the frame round the disposal hears of it.
|
|
119
|
+
const RELEASING = Object.freeze({ releasing: true });
|
|
120
|
+
|
|
121
|
+
// The world's record, off the world and everything it owns disposed.
|
|
122
|
+
// Returns the first error a `dispose` listener threw, or null. Called only
|
|
123
|
+
// with no frame in progress but the outermost one preparing (`prepare`,
|
|
124
|
+
// `settle`, `leaveSky`), and so never with the dome in the scene graph
|
|
125
|
+
// (`prepare` releases before it attaches, `settle` detaches first, and
|
|
126
|
+
// between frames no dome is attached) and never while another release is
|
|
127
|
+
// going (a disposal counts as a frame in progress).
|
|
128
|
+
function release(world) {
|
|
129
|
+
const record = world.sky;
|
|
130
|
+
if (!record) return null;
|
|
131
|
+
world.sky = RELEASING;
|
|
132
|
+
record.forget();
|
|
133
|
+
let failed = null;
|
|
134
|
+
world.skyDepth = (world.skyDepth ?? 0) + 1;
|
|
135
|
+
try {
|
|
136
|
+
const dispose = () => {
|
|
137
|
+
for (const item of record.owned()) failed = disposed(item, failed);
|
|
138
|
+
};
|
|
139
|
+
if (record.onCallout) record.onCallout(dispose);
|
|
140
|
+
else dispose();
|
|
141
|
+
} finally {
|
|
142
|
+
world.skyDepth -= 1;
|
|
143
|
+
world.sky = null;
|
|
144
|
+
}
|
|
145
|
+
return failed;
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
// One of the sky's own resources (a texture, the geometry, the material)
|
|
149
|
+
// disposed: every `dispose` listener on it called, each in a guard of its
|
|
150
|
+
// own. Returns the first error kept so far.
|
|
151
|
+
//
|
|
152
|
+
// Not `item.dispose()`. For these three classes three.js's `dispose()` is
|
|
153
|
+
// `this.dispatchEvent({ type: 'dispose' })` and nothing else (r180:
|
|
154
|
+
// Texture.js, Material.js, BufferGeometry.js; ShaderMaterial does not
|
|
155
|
+
// override it), and `dispatchEvent` stops at the first listener that
|
|
156
|
+
// throws. The renderer's own cleanup is such a listener (WebGLTextures,
|
|
157
|
+
// WebGLGeometries, the material's programs), added when the resource was
|
|
158
|
+
// first drawn, so after any listener a deck added before that. One deck
|
|
159
|
+
// listener that throws would leave the GPU's copy allocated for good. So
|
|
160
|
+
// the listeners are called here, as `dispatchEvent` calls them (a copy of
|
|
161
|
+
// the list, `this` the resource, one event with `target` set and cleared
|
|
162
|
+
// after), but each in its own try.
|
|
163
|
+
//
|
|
164
|
+
// That reads three.js's EventDispatcher's own storage, `_listeners.dispose`
|
|
165
|
+
// (an array, made by `addEventListener`). If it is not there in that shape
|
|
166
|
+
// (no listener was ever added, or another three.js keeps them otherwise),
|
|
167
|
+
// `item.dispose()` is called instead, in a guard: all or nothing, as three.js
|
|
168
|
+
// does it. test-sky.mjs fails if either the storage or what `dispose()` does
|
|
169
|
+
// changes, so an upgrade of three.js is noticed.
|
|
170
|
+
function disposed(item, failed) {
|
|
171
|
+
const keep = (err) => {
|
|
172
|
+
failed ??= err ?? new Error('a dispose listener threw nothing');
|
|
173
|
+
};
|
|
174
|
+
let listeners = null;
|
|
175
|
+
try {
|
|
176
|
+
const held = item._listeners;
|
|
177
|
+
if (held !== null && typeof held === 'object' && Array.isArray(held.dispose)) listeners = held.dispose.slice(0);
|
|
178
|
+
} catch (err) {
|
|
179
|
+
keep(err);
|
|
180
|
+
}
|
|
181
|
+
if (listeners === null) {
|
|
182
|
+
try {
|
|
183
|
+
item.dispose();
|
|
184
|
+
} catch (err) {
|
|
185
|
+
keep(err);
|
|
186
|
+
}
|
|
187
|
+
return failed;
|
|
188
|
+
}
|
|
189
|
+
const event = { type: 'dispose', target: item };
|
|
190
|
+
for (const listener of listeners) {
|
|
191
|
+
try {
|
|
192
|
+
listener.call(item, event);
|
|
193
|
+
} catch (err) {
|
|
194
|
+
keep(err);
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
event.target = null;
|
|
198
|
+
return failed;
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
// The scene a record was made for is going: `key` is the key a load is
|
|
202
|
+
// replacing (the record of another is not that load's to end), or absent for
|
|
203
|
+
// a dispose. With no frame in progress the record is released here; with one,
|
|
204
|
+
// `settle` ends it. Returns what `release` does.
|
|
205
|
+
export function leaveSky(world, key) {
|
|
206
|
+
const record = world?.sky;
|
|
207
|
+
if (!record || (world.skyDepth ?? 0) > 0) return null;
|
|
208
|
+
if (key !== undefined && record.key !== key) return null;
|
|
209
|
+
return release(world);
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
// The outermost frame, before its draw. Returns the first error of a
|
|
213
|
+
// disposal or the step, or null.
|
|
214
|
+
function prepare(world, runtime, make, step, calloutFor) {
|
|
215
|
+
let failed = null;
|
|
216
|
+
// A record of another key goes.
|
|
217
|
+
if (world.sky && world.sky.key !== skyKeyFor(world, runtime)) failed = release(world);
|
|
218
|
+
// None, and the runtime has a key: one is made -- unless this frame is
|
|
219
|
+
// already going to throw, when it would only be let go again.
|
|
220
|
+
if (!world.sky && failed === null) {
|
|
221
|
+
const key = skyKeyFor(world, runtime);
|
|
222
|
+
if (key !== null) {
|
|
223
|
+
world.sky = make(key, world);
|
|
224
|
+
world.sky.onCallout = calloutFor?.(world);
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
// The record is stepped, and what the step let go is disposed, each
|
|
228
|
+
// texture in its own guard. (A record here is of the runtime's key: one
|
|
229
|
+
// of another was released above, and nothing has run since.)
|
|
230
|
+
if (world.sky) {
|
|
231
|
+
const record = world.sky;
|
|
232
|
+
try {
|
|
233
|
+
step(record);
|
|
234
|
+
} catch (err) {
|
|
235
|
+
failed ??= err ?? new Error('the step threw nothing');
|
|
236
|
+
}
|
|
237
|
+
if (record.shed.length > 0) {
|
|
238
|
+
const dispose = () => {
|
|
239
|
+
for (const item of record.shed.splice(0)) failed = disposed(item, failed);
|
|
240
|
+
};
|
|
241
|
+
if (record.onCallout) record.onCallout(dispose);
|
|
242
|
+
else dispose();
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
// And a record of the runtime's key, in a frame that is not going to
|
|
246
|
+
// throw, is attached.
|
|
247
|
+
if (world.sky && failed === null && world.sky.key === skyKeyFor(world, runtime)) attach(world.sky, world.scene);
|
|
248
|
+
return failed;
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
// A frame from inside another: a dome in the scene graph that is not of this
|
|
252
|
+
// frame's runtime's key is hidden for the draw. Returns what to show again.
|
|
253
|
+
function hideAnothers(world, runtime) {
|
|
254
|
+
const record = world.sky;
|
|
255
|
+
if (!record || record === RELEASING || !record.mesh.parent || record.key === skyKeyFor(world, runtime)) return null;
|
|
256
|
+
const mesh = record.mesh;
|
|
257
|
+
const shown = mesh.visible;
|
|
258
|
+
mesh.visible = false;
|
|
259
|
+
return () => {
|
|
260
|
+
mesh.visible = shown;
|
|
261
|
+
};
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
// After the outermost frame: the postcondition, from what is true now.
|
|
265
|
+
// `threw` is whether that frame, or any frame drawn from inside it, did.
|
|
266
|
+
// Returns what `release` does.
|
|
267
|
+
function settle(world, runtime, threw) {
|
|
268
|
+
const record = world.sky;
|
|
269
|
+
if (!record) return null;
|
|
270
|
+
detach(record);
|
|
271
|
+
if (!threw && record.key === skyKeyFor(world, runtime)) return null;
|
|
272
|
+
return release(world);
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
// One frame of a world that has a record, or whose scene has a key: `draw()`
|
|
276
|
+
// is the frame, `make(key, world)` a record's dome and what it owns (`{ key, mesh,
|
|
277
|
+
// shed, owned(), forget() }`), and `step(record)` what makes it show what
|
|
278
|
+
// this frame should. Optional `calloutFor(world)` supplies that record's
|
|
279
|
+
// disposal hook; the engine makes it once per world, only for an actual record.
|
|
280
|
+
export function skyFrame(world, runtime, draw, make, step, calloutFor) {
|
|
281
|
+
world.skyDepth = (world.skyDepth ?? 0) + 1;
|
|
282
|
+
// The outermost frame starts with nothing heard from a frame inside it.
|
|
283
|
+
if (world.skyDepth === 1) world.skyThrew = false;
|
|
284
|
+
let kept = null;
|
|
285
|
+
let own = null;
|
|
286
|
+
let show = null;
|
|
287
|
+
try {
|
|
288
|
+
if (world.skyDepth === 1) kept = prepare(world, runtime, make, step, calloutFor);
|
|
289
|
+
else show = hideAnothers(world, runtime);
|
|
290
|
+
draw();
|
|
291
|
+
} catch (err) {
|
|
292
|
+
own = { err };
|
|
293
|
+
// The frame this one is inside of, if any, hears of it.
|
|
294
|
+
world.skyThrew = true;
|
|
295
|
+
} finally {
|
|
296
|
+
if (show) show();
|
|
297
|
+
world.skyDepth -= 1;
|
|
298
|
+
if (world.skyDepth === 0) {
|
|
299
|
+
// Settled whatever has gone wrong; then the first error is the one kept.
|
|
300
|
+
const late = settle(world, runtime, world.skyThrew === true || kept !== null);
|
|
301
|
+
kept ??= late;
|
|
302
|
+
}
|
|
303
|
+
}
|
|
304
|
+
if (own !== null) throw own.err;
|
|
305
|
+
if (kept !== null) throw kept;
|
|
306
|
+
}
|
|
@@ -151,3 +151,14 @@ export function recordReads(target, reads) {
|
|
|
151
151
|
},
|
|
152
152
|
});
|
|
153
153
|
}
|
|
154
|
+
|
|
155
|
+
// For the audit of a scene that set `"engine": { "staticActors": true }`
|
|
156
|
+
// (`world.auditStatic`, QA only; world3d.js): writes down that a still actor
|
|
157
|
+
// was found changed with no `scene.touch`, and warns of each actor once.
|
|
158
|
+
export function noteChangedStill(world, id, what) {
|
|
159
|
+
const failures = (world.staticAuditFailures ??= []);
|
|
160
|
+
if (!failures.some((failure) => failure.id === id)) {
|
|
161
|
+
console.warn(`staticActors: "${id}" is marked static and ${what} changed without scene.touch`);
|
|
162
|
+
}
|
|
163
|
+
failures.push({ id, what });
|
|
164
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
// Opt-in engine.view.far (metres). Like orbitlens.js, keep the camera's
|
|
2
|
+
// original value on the first keyed frame, and return it before the next
|
|
3
|
+
// scene's code, when the key goes, on an editor frame, or on disposal.
|
|
4
|
+
// No imports: Fog and the optional sky colour reader come from the renderer.
|
|
5
|
+
// A keyless world allocates nothing and writes nothing, including on reset
|
|
6
|
+
// and disposal.
|
|
7
|
+
export function viewFar(data) {
|
|
8
|
+
const far = data?.engine?.view?.far;
|
|
9
|
+
return typeof far === 'number' && far >= 20 && far <= 1000 ? far : null;
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
const hexColor = (value) => typeof value === 'string' && /^#[\da-f]{6}$/i.test(value);
|
|
13
|
+
|
|
14
|
+
function backgroundColor(world, data) {
|
|
15
|
+
if (world.scene.background?.isColor) return world.scene.background;
|
|
16
|
+
return hexColor(data.background) ? data.background : 0x808080;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export function fitViewRange(world, runtime, Fog, skyColor) {
|
|
20
|
+
const far = viewFar(runtime?.data);
|
|
21
|
+
if (far === null) {
|
|
22
|
+
giveBackViewRange(world);
|
|
23
|
+
return;
|
|
24
|
+
}
|
|
25
|
+
if (world.disposed === true) return;
|
|
26
|
+
const camera = world.camera;
|
|
27
|
+
const range = (world.viewRange ??= { far: camera.far, fog: world.scene.fog, owned: new Fog(0x808080, 0, far) });
|
|
28
|
+
const view = runtime.data.engine.view;
|
|
29
|
+
const from = Number.isFinite(view.fogFrom) ? view.fogFrom : 0.75 * far;
|
|
30
|
+
range.owned.near = Math.max(0, Math.min(far * (1 - 1e-6), from));
|
|
31
|
+
range.owned.far = far;
|
|
32
|
+
const color = hexColor(view.fogColor) ? view.fogColor : skyColor?.(world, range) ?? backgroundColor(world, runtime.data);
|
|
33
|
+
// Color inputs already use three's linear working space; set copies them.
|
|
34
|
+
range.owned.color.set(color);
|
|
35
|
+
if (world.scene.fog !== range.owned) world.scene.fog = range.owned;
|
|
36
|
+
if (camera.far !== far) {
|
|
37
|
+
camera.far = far;
|
|
38
|
+
camera.updateProjectionMatrix();
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
export function giveBackViewRange(world) {
|
|
43
|
+
const range = world?.viewRange;
|
|
44
|
+
if (!range) return;
|
|
45
|
+
world.viewRange = null;
|
|
46
|
+
world.scene.fog = range.fog;
|
|
47
|
+
const camera = world.camera;
|
|
48
|
+
if (camera && camera.far !== range.far) {
|
|
49
|
+
camera.far = range.far;
|
|
50
|
+
camera.updateProjectionMatrix();
|
|
51
|
+
}
|
|
52
|
+
}
|