castle-web-cli 0.4.232 → 0.4.234
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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/api.d.ts +11 -0
- package/dist/api.js +43 -0
- package/dist/bundle.d.ts +64 -0
- package/dist/bundle.js +558 -2
- package/dist/castle-host/host.d.ts +18 -2
- package/dist/castle-host/host.js +844 -39
- package/dist/castleJson.d.ts +23 -2
- package/dist/castleJson.js +46 -2
- package/dist/check.d.ts +3 -1
- package/dist/check.js +20 -3
- package/dist/chunkLoader.d.ts +3 -0
- package/dist/chunkLoader.js +111 -0
- package/dist/devParty.d.ts +26 -0
- package/dist/devParty.js +231 -0
- package/dist/devSaveStorage.js +4 -0
- package/dist/devSessionStorage.js +50 -2
- package/dist/devSocial.d.ts +24 -0
- package/dist/devSocial.js +70 -0
- package/dist/ide.d.ts +2 -0
- package/dist/ide.js +119 -15
- 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 +11 -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 +25 -1
- package/dist/save-deck.js +178 -9
- package/dist/serve.js +32 -11
- package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
- 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/dist/vitePlugins.d.ts +2 -1
- package/dist/vitePlugins.js +13 -0
- package/kits/base/castle.json +1 -1
- package/kits/base/package-lock.json +1 -1
- package/kits/base/sdk/README.md +339 -5
- package/kits/base/sdk/avatar.d.ts +6 -2
- package/kits/base/sdk/avatar.js +12 -4
- package/kits/base/sdk/castle.d.ts +7 -3
- package/kits/base/sdk/castle.js +2 -0
- package/kits/base/sdk/commands.d.ts +176 -1
- package/kits/base/sdk/commands.js +3 -0
- package/kits/base/sdk/display.d.ts +3 -0
- package/kits/base/sdk/display.js +9 -3
- package/kits/base/sdk/hub.d.ts +37 -6
- package/kits/base/sdk/hub.js +63 -4
- package/kits/base/sdk/multiplayer.d.ts +7 -1
- package/kits/base/sdk/multiplayer.js +148 -32
- package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
- package/kits/base/sdk/party.d.ts +23 -0
- package/kits/base/sdk/party.js +91 -0
- package/kits/base/sdk/reconnectBudget.d.ts +23 -0
- package/kits/base/sdk/reconnectBudget.js +96 -0
- package/kits/base/sdk/save.d.ts +38 -1
- package/kits/base/sdk/save.js +81 -7
- package/kits/base/sdk/server/hub.d.ts +117 -0
- package/kits/base/sdk/server/hub.js +119 -2
- package/kits/base/sdk/server/platformHandle.d.ts +43 -1
- package/kits/base/sdk/server/storage.d.ts +17 -0
- package/kits/base/sdk/server/storage.js +65 -3
- package/kits/base/sdk/server/wrapper.d.ts +43 -6
- package/kits/base/sdk/server/wrapper.js +93 -9
- package/kits/base/sdk/social.d.ts +9 -0
- package/kits/base/sdk/social.js +5 -0
- package/kits/hub-game/CLAUDE.md +451 -13
- package/kits/hub-game/README.md +63 -0
- 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/castle.json +5 -5
- package/kits/hub-game/code/client/act.js +312 -0
- package/kits/hub-game/code/client/actionLayout.js +147 -0
- package/kits/hub-game/code/client/actionOverflow.js +556 -0
- package/kits/hub-game/code/client/actorBudget.js +47 -0
- package/kits/hub-game/code/client/arrivalCamera.js +50 -0
- package/kits/hub-game/code/client/askSlot.js +117 -0
- package/kits/hub-game/code/client/attention.js +11 -2
- package/kits/hub-game/code/client/avatar.js +311 -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 +253 -0
- package/kits/hub-game/code/client/backVisibility.js +13 -0
- package/kits/hub-game/code/client/ballot.js +472 -0
- package/kits/hub-game/code/client/build.js +38 -0
- package/kits/hub-game/code/client/chat.js +41 -5
- package/kits/hub-game/code/client/chatModeration.js +5 -0
- package/kits/hub-game/code/client/chrome.js +2144 -160
- 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/crowdNames.js +241 -0
- package/kits/hub-game/code/client/decor.js +515 -0
- package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
- package/kits/hub-game/code/client/doorErrors.js +39 -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/fall.js +18 -0
- package/kits/hub-game/code/client/farAvatars.js +233 -0
- package/kits/hub-game/code/client/firstJoin.js +9 -2
- package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
- package/kits/hub-game/code/client/frameBatch.js +5 -0
- package/kits/hub-game/code/client/grab.js +368 -29
- package/kits/hub-game/code/client/hookLayer.js +385 -20
- package/kits/hub-game/code/client/hudCopy.js +51 -0
- package/kits/hub-game/code/client/hudRate.js +20 -0
- package/kits/hub-game/code/client/idle.js +177 -24
- package/kits/hub-game/code/client/interestCap.js +81 -0
- package/kits/hub-game/code/client/invites.js +231 -0
- package/kits/hub-game/code/client/joinError.js +9 -0
- package/kits/hub-game/code/client/keys.js +36 -0
- package/kits/hub-game/code/client/labelsNear.js +234 -0
- package/kits/hub-game/code/client/landscapeLayout.js +17 -0
- package/kits/hub-game/code/client/layoutCache.js +264 -0
- package/kits/hub-game/code/client/loadTelemetry.js +20 -0
- package/kits/hub-game/code/client/loadingCover.js +148 -0
- package/kits/hub-game/code/client/loadingEntry.js +8 -0
- package/kits/hub-game/code/client/menuIcons.js +34 -0
- package/kits/hub-game/code/client/menuRows.js +43 -0
- package/kits/hub-game/code/client/modelReady.js +7 -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/padCueArrival.js +23 -0
- package/kits/hub-game/code/client/padCues.js +112 -0
- package/kits/hub-game/code/client/padOccupancy.js +88 -0
- package/kits/hub-game/code/client/padReadability.js +26 -0
- package/kits/hub-game/code/client/padRings.js +69 -0
- package/kits/hub-game/code/client/pushVisit.js +14 -0
- package/kits/hub-game/code/client/quality.js +205 -0
- package/kits/hub-game/code/client/qualityEntry.js +55 -0
- package/kits/hub-game/code/client/rehello.js +167 -0
- package/kits/hub-game/code/client/safeLayout.js +338 -0
- package/kits/hub-game/code/client/safeStyle.js +42 -0
- package/kits/hub-game/code/client/say.js +12 -3
- package/kits/hub-game/code/client/shot.js +146 -0
- package/kits/hub-game/code/client/shotFit.js +56 -0
- package/kits/hub-game/code/client/signIn.js +28 -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 +162 -1
- package/kits/hub-game/code/client/stuck.js +259 -0
- package/kits/hub-game/code/client/talk.js +714 -59
- package/kits/hub-game/code/client/tiers.js +543 -52
- package/kits/hub-game/code/client/toastBand.js +37 -0
- package/kits/hub-game/code/client/together.js +39 -2
- package/kits/hub-game/code/client/visibility.js +43 -0
- package/kits/hub-game/code/client/weakestLookBake.js +92 -0
- package/kits/hub-game/code/client/weakestTier.js +295 -0
- package/kits/hub-game/code/client/wear.js +461 -170
- package/kits/hub-game/code/client/worldLabels.js +241 -0
- package/kits/hub-game/code/client/yours.js +200 -0
- package/kits/hub-game/code/companionSpec.js +45 -0
- package/kits/hub-game/code/npcDisplayText.js +55 -0
- package/kits/hub-game/code/privateText.js +7 -0
- package/kits/hub-game/code/server/act.js +124 -0
- package/kits/hub-game/code/server/actions.js +138 -0
- package/kits/hub-game/code/server/actors.js +11 -2
- package/kits/hub-game/code/server/analytics.js +83 -0
- package/kits/hub-game/code/server/anonymousEntry.js +49 -0
- package/kits/hub-game/code/server/arrivalPose.js +36 -0
- 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 +107 -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/doorAnalytics.js +52 -0
- package/kits/hub-game/code/server/earned.js +478 -0
- package/kits/hub-game/code/server/frameBatch.js +183 -0
- package/kits/hub-game/code/server/friendBests.js +166 -0
- package/kits/hub-game/code/server/friendsAmong.js +272 -0
- package/kits/hub-game/code/server/history.js +7 -0
- package/kits/hub-game/code/server/hub.js +2510 -95
- package/kits/hub-game/code/server/idle.js +60 -12
- package/kits/hub-game/code/server/index.js +28 -6
- package/kits/hub-game/code/server/invites.js +19 -0
- package/kits/hub-game/code/server/labels.js +36 -2
- package/kits/hub-game/code/server/loadAbandon.js +106 -0
- package/kits/hub-game/code/server/manifest.js +586 -7
- package/kits/hub-game/code/server/menu.js +161 -0
- package/kits/hub-game/code/server/npcs.js +1025 -113
- package/kits/hub-game/code/server/observe.js +408 -0
- package/kits/hub-game/code/server/padOccupancy.js +85 -0
- package/kits/hub-game/code/server/party.js +2 -2
- package/kits/hub-game/code/server/players.js +30 -0
- package/kits/hub-game/code/server/resumePose.js +152 -0
- package/kits/hub-game/code/server/say.js +1 -1
- package/kits/hub-game/code/server/shot.js +110 -0
- package/kits/hub-game/code/server/standing.js +123 -0
- package/kits/hub-game/code/server/storageLimit.js +187 -0
- package/kits/hub-game/code/server/vis.js +175 -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/act.js +35 -0
- package/kits/hub-game/code/shared/cues.js +9 -0
- package/kits/hub-game/code/shared/danceIdle.js +28 -0
- package/kits/hub-game/code/shared/decor.js +41 -0
- package/kits/hub-game/code/shared/loadStages.js +12 -0
- package/kits/hub-game/code/shared/quality.js +74 -0
- package/kits/hub-game/code/shared/say.js +2 -0
- package/kits/hub-game/code/shared/shot.js +53 -0
- package/kits/hub-game/code/shared/spin.js +57 -0
- package/kits/hub-game/code/systems/hub.js +1753 -202
- package/kits/hub-game/docs/analytics.md +279 -0
- package/kits/hub-game/docs/content-pack.md +1 -1
- package/kits/hub-game/docs/contract.md +3475 -77
- package/kits/hub-game/docs/home-pieces.md +71 -0
- package/kits/hub-game/docs/observed-progress.md +252 -0
- package/kits/hub-game/main.jsx +2 -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 +10 -1
- package/kits/hub-game/package.json +6 -2
- package/kits/hub-game/play/player.js +142 -0
- package/kits/hub-game/play/registry.js +47 -0
- package/kits/hub-game/play.jsx +37 -0
- package/kits/hub-game/scripts/check.mjs +117 -16
- package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
- package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -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/pose-storage-fixture.mjs +46 -0
- package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
- package/kits/hub-game/scripts/test-act-client.mjs +186 -0
- package/kits/hub-game/scripts/test-act.mjs +171 -0
- package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
- package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +853 -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 +38 -23
- package/kits/hub-game/scripts/test-analytics.mjs +76 -0
- package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
- package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
- package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
- package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
- package/kits/hub-game/scripts/test-ask-slot.mjs +85 -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 +792 -0
- package/kits/hub-game/scripts/test-avatar.mjs +584 -7
- package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
- package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
- package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
- package/kits/hub-game/scripts/test-build.mjs +49 -0
- package/kits/hub-game/scripts/test-cells.mjs +71 -0
- package/kits/hub-game/scripts/test-chat.mjs +863 -0
- package/kits/hub-game/scripts/test-classic.mjs +2 -0
- package/kits/hub-game/scripts/test-companion-chat.mjs +216 -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-control-layout-dom.mjs +120 -0
- package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
- package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
- package/kits/hub-game/scripts/test-decor.mjs +464 -0
- package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
- package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
- package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
- package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
- package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
- package/kits/hub-game/scripts/test-earned.mjs +1224 -0
- package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
- package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
- package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
- package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
- package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
- package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
- package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -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-high-only.mjs +170 -0
- package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
- package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
- package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
- package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
- package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
- package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
- package/kits/hub-game/scripts/test-idle.mjs +427 -1
- package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
- package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
- package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
- package/kits/hub-game/scripts/test-interest.mjs +15 -0
- package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
- package/kits/hub-game/scripts/test-invites.mjs +109 -0
- package/kits/hub-game/scripts/test-keys.mjs +46 -1
- package/kits/hub-game/scripts/test-labels.mjs +664 -0
- package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
- package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
- package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
- package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
- package/kits/hub-game/scripts/test-manifest.mjs +472 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
- package/kits/hub-game/scripts/test-menu.mjs +319 -0
- package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
- package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
- package/kits/hub-game/scripts/test-observed.mjs +745 -0
- package/kits/hub-game/scripts/test-pack.mjs +7 -0
- package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
- package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
- package/kits/hub-game/scripts/test-picker.mjs +541 -0
- package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
- package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
- package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
- package/kits/hub-game/scripts/test-quality.mjs +385 -0
- package/kits/hub-game/scripts/test-rehello.mjs +1733 -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-resume-action-order.mjs +598 -0
- package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
- package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
- package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
- package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
- package/kits/hub-game/scripts/test-say.mjs +1 -1
- package/kits/hub-game/scripts/test-shot.mjs +901 -0
- package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
- package/kits/hub-game/scripts/test-spin.mjs +314 -0
- package/kits/hub-game/scripts/test-standing.mjs +449 -0
- package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
- package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
- package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
- package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
- package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
- package/kits/hub-game/scripts/test-tiers.mjs +476 -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 +770 -0
- package/kits/hub-game/scripts/test-visibility.mjs +134 -0
- package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
- package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
- package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
- package/kits/hub-game/scripts/test-yours.mjs +403 -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/joinFailure.js +27 -0
- package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
- package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
- 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 +443 -34
- package/kits/multiplayer-3d/package-lock.json +8 -1
- package/kits/multiplayer-3d/package.json +3 -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-join-watchdog.mjs +436 -0
- package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
- package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
- package/kits/physics-2d/CLAUDE.md +19 -1
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/frozenActors.js +233 -0
- package/kits/physics-2d/engine/scene.js +337 -3
- 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/eslint.config.js +1 -1
- package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
- package/kits/physics-2d/play/behaviors/Camera.js +40 -0
- package/kits/physics-2d/play/behaviors/Collider.js +122 -0
- package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
- package/kits/physics-2d/play/behaviors/Goal.js +46 -0
- package/kits/physics-2d/play/behaviors/Joints.js +126 -0
- package/kits/physics-2d/play/behaviors/Layout.js +71 -0
- package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
- package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
- package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
- package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
- package/kits/physics-2d/play/behaviors/Style.js +209 -0
- package/kits/physics-2d/play/behaviors/Text.js +85 -0
- package/kits/physics-2d/play/behaviors/Video.js +93 -0
- package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
- package/kits/physics-3d/CLAUDE.md +42 -529
- package/kits/physics-3d/behaviors/Body.jsx +3 -0
- package/kits/physics-3d/behaviors/Model.jsx +3 -0
- package/kits/physics-3d/behaviors/Player.jsx +661 -87
- package/kits/physics-3d/behaviors/Shape.jsx +3 -0
- package/kits/physics-3d/behaviors/Solid.jsx +3 -0
- package/kits/physics-3d/behaviors/Transform.jsx +3 -0
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/engine-camera.md +542 -0
- package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
- package/kits/physics-3d/docs/engine-load.md +149 -0
- package/kits/physics-3d/docs/engine-look.md +114 -0
- package/kits/physics-3d/docs/engine-shadows.md +372 -0
- package/kits/physics-3d/docs/engine-skip-work.md +187 -0
- package/kits/physics-3d/docs/engine-sky.md +198 -0
- package/kits/physics-3d/docs/engine-static-actors.md +226 -0
- package/kits/physics-3d/docs/engine-view.md +37 -0
- package/kits/physics-3d/docs/pxmodel-format.md +9 -1
- package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
- package/kits/physics-3d/engine3d/actornode.js +87 -0
- package/kits/physics-3d/engine3d/animationBudget.js +23 -0
- package/kits/physics-3d/engine3d/branches.js +3 -13
- package/kits/physics-3d/engine3d/cage.js +2 -7
- package/kits/physics-3d/engine3d/cageops.js +2 -17
- package/kits/physics-3d/engine3d/dataBehaviors.js +12 -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 +99 -0
- package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
- package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
- package/kits/physics-3d/engine3d/gait.js +126 -0
- package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
- package/kits/physics-3d/engine3d/kithooks.js +47 -0
- package/kits/physics-3d/engine3d/look.js +514 -48
- package/kits/physics-3d/engine3d/lookbake.js +208 -0
- package/kits/physics-3d/engine3d/materialpresets.js +2 -0
- package/kits/physics-3d/engine3d/modelFiles.js +3 -17
- package/kits/physics-3d/engine3d/modelMath.js +49 -0
- package/kits/physics-3d/engine3d/modelready.js +16 -0
- package/kits/physics-3d/engine3d/motion.js +39 -10
- package/kits/physics-3d/engine3d/nearshadows.js +106 -21
- package/kits/physics-3d/engine3d/optimize.js +9 -5
- package/kits/physics-3d/engine3d/orbitinput.js +522 -10
- package/kits/physics-3d/engine3d/orbitlens.js +48 -0
- package/kits/physics-3d/engine3d/ownmodel.js +213 -0
- package/kits/physics-3d/engine3d/partgeometry.js +1 -16
- package/kits/physics-3d/engine3d/paths.js +1 -9
- package/kits/physics-3d/engine3d/playTimings.js +50 -0
- package/kits/physics-3d/engine3d/playerRun.js +372 -0
- package/kits/physics-3d/engine3d/pxmodel.js +42 -11
- package/kits/physics-3d/engine3d/rapier.js +27 -0
- package/kits/physics-3d/engine3d/scatter.js +1 -11
- package/kits/physics-3d/engine3d/shadowfade.js +890 -0
- package/kits/physics-3d/engine3d/sky.js +547 -0
- package/kits/physics-3d/engine3d/skylife.js +306 -0
- package/kits/physics-3d/engine3d/squarefirst.js +177 -0
- package/kits/physics-3d/engine3d/stillshadows.js +399 -0
- package/kits/physics-3d/engine3d/sweep.js +1 -25
- 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 +1253 -76
- package/kits/physics-3d/eslint.config.js +2 -1
- package/kits/physics-3d/main.jsx +10 -2
- package/kits/physics-3d/package-lock.json +7 -0
- package/kits/physics-3d/package.json +5 -1
- package/kits/physics-3d/play/behaviors/Body.js +31 -0
- package/kits/physics-3d/play/behaviors/Door.js +37 -0
- package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
- package/kits/physics-3d/play/behaviors/Model.js +23 -0
- package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
- package/kits/physics-3d/play/behaviors/Player.js +1204 -0
- package/kits/physics-3d/play/behaviors/Shape.js +47 -0
- package/kits/physics-3d/play/behaviors/Solid.js +16 -0
- package/kits/physics-3d/play/behaviors/Transform.js +29 -0
- package/kits/physics-3d/pnpm-lock.yaml +8 -0
- package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
- package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
- package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
- package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
- package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
- package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
- package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
- package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
- package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
- package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
- package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -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 +5 -2
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
- package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
- package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
- package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
- package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -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-square-first.mjs +921 -0
- package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
- package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
- package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
- package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
- package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
- package/kits/physics-3d/systems/physics3d.js +419 -9
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/client/connection.js +33 -10
- package/kits/real-time/code/client/gameHooks.js +2 -0
- package/kits/real-time/code/client/joinOverlay.js +9 -4
- package/kits/real-time/code/server/gameHooks.js +7 -0
- package/kits/real-time/code/server/session.js +102 -22
- package/kits/real-time/package-lock.json +1 -1
- 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
|
+
}
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
// The dormant engine.load key. Invalid settings leave the old path alone.
|
|
2
|
+
import { parseModelCached } from './pxmodel';
|
|
3
|
+
import { modelAnimation } from './motion';
|
|
4
|
+
import { resolveModelRef, MAX_MODEL_DEPTH } from './modelrefs';
|
|
5
|
+
import { isDataBehavior } from './dataBehaviors.js';
|
|
6
|
+
import { Vector3 } from 'three';
|
|
7
|
+
|
|
8
|
+
export function readLoadKey(data) {
|
|
9
|
+
const load = data?.engine?.load;
|
|
10
|
+
if (!load || typeof load !== 'object' || Array.isArray(load) ||
|
|
11
|
+
Object.keys(load).some(key => !['first', 'sliceMs', 'inert', 'horizon'].includes(key))) return null;
|
|
12
|
+
if (load.inert !== undefined && (!Array.isArray(load.inert) ||
|
|
13
|
+
!load.inert.every(name => typeof name === 'string' && name.length > 0))) return null;
|
|
14
|
+
const inert = load.inert === undefined ? {} : { inert: [...load.inert] };
|
|
15
|
+
const sliceMs = load.sliceMs === undefined ? 8 : load.sliceMs;
|
|
16
|
+
if (!Number.isFinite(sliceMs) || sliceMs < 1 || sliceMs > 50) return null;
|
|
17
|
+
const horizon = load.horizon === undefined ? 45 : load.horizon;
|
|
18
|
+
if (!Number.isFinite(horizon) || horizon < 0) return null;
|
|
19
|
+
const first = load.first;
|
|
20
|
+
if (Array.isArray(first)) {
|
|
21
|
+
return first.every(id => typeof id === 'string' && id.length > 0) ? { first: [...first], sliceMs, horizon, ...inert } : null;
|
|
22
|
+
}
|
|
23
|
+
if (!first || typeof first !== 'object' || Object.keys(first).length !== 1 ||
|
|
24
|
+
!Number.isFinite(first.radius) || first.radius <= 0) return null;
|
|
25
|
+
return { first: { radius: first.radius }, sliceMs, horizon, ...inert };
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
const BIPED_PARTS = new Set(['legL', 'legR', 'armL', 'armR', 'torso']);
|
|
29
|
+
|
|
30
|
+
function modelMayWait(model, files, path, chain = [path]) {
|
|
31
|
+
if (modelAnimation(model)) return false;
|
|
32
|
+
for (const part of model.parts) {
|
|
33
|
+
if (BIPED_PARTS.has(part.id) || part.keep || part.tint || part.id.startsWith('slot-')) return false;
|
|
34
|
+
if (part.kind !== 'model') continue;
|
|
35
|
+
const ref = resolveModelRef(part.src, path);
|
|
36
|
+
if (chain.includes(ref) || chain.length > MAX_MODEL_DEPTH) continue;
|
|
37
|
+
const inner = parseModelCached(files?.[ref]);
|
|
38
|
+
if (inner && !modelMayWait(inner, files, ref, [...chain, ref])) return false;
|
|
39
|
+
}
|
|
40
|
+
return true;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function componentsMayWait(runtime, actor, inert, names) {
|
|
44
|
+
if (!actor.components.Transform || 'Player' in actor.components ||
|
|
45
|
+
actor.id === runtime.orbitOwnModel || actor.id === runtime.followCamera?.id || actor.runtime?.modelClip) return false;
|
|
46
|
+
for (const name of names) {
|
|
47
|
+
const Behavior = runtime.behaviors?.get(name);
|
|
48
|
+
// SceneRuntime skips an unregistered component entirely. Registered
|
|
49
|
+
// custom classes block even if disabled or constructor-only, unless the
|
|
50
|
+
// deck explicitly promises they never consume this actor's visual.
|
|
51
|
+
if (!Behavior || inert.includes(name)) continue;
|
|
52
|
+
if (!isDataBehavior(name, Behavior)) return false;
|
|
53
|
+
}
|
|
54
|
+
return true;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
export function actorMayWait(world, runtime, actor, inert = []) {
|
|
58
|
+
if (!componentsMayWait(runtime, actor, inert, Object.keys(actor.components))) return false;
|
|
59
|
+
const file = actor.components.Model?.file;
|
|
60
|
+
const model = file && parseModelCached(runtime.files?.[file]);
|
|
61
|
+
if (!model || !modelMayWait(model, runtime.files, file)) return false;
|
|
62
|
+
for (const object of world.ownModelWith ?? []) {
|
|
63
|
+
for (let node = object; node; node = node.parent) if (node.userData?.actorId === actor.id) return false;
|
|
64
|
+
}
|
|
65
|
+
return true;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
// Track broad registry changes as well as each waiter's own class identities:
|
|
69
|
+
// a remove+add can change registrations without changing Map identity or size.
|
|
70
|
+
// A revision lets pair checks update one waiter independently of the others.
|
|
71
|
+
export function consumerRegistryVersion(load) {
|
|
72
|
+
const registry = load.runtime.behaviors;
|
|
73
|
+
if (registry !== load.consumerRegistry || registry?.size !== load.consumerRegistrySize) {
|
|
74
|
+
load.consumerRegistry = registry;
|
|
75
|
+
load.consumerRegistrySize = registry?.size;
|
|
76
|
+
load.consumerRevision++;
|
|
77
|
+
}
|
|
78
|
+
return load.consumerRevision;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
export function rememberModelConsumer(load, actor) {
|
|
82
|
+
const names = Object.keys(actor.components);
|
|
83
|
+
return { names, classes: names.map(name => load.runtime.behaviors?.get(name)),
|
|
84
|
+
count: names.length, revision: consumerRegistryVersion(load) };
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
// This dispatch fence reads component membership, never model contents or
|
|
88
|
+
// render signatures. Unchanged frames allocate no arrays; class identity costs
|
|
89
|
+
// only one Map lookup per captured component, including unregistered names.
|
|
90
|
+
export function modelConsumerChanged(load, wait, revision) {
|
|
91
|
+
const { actor, consumer } = wait;
|
|
92
|
+
const c = actor.components, runtime = load.runtime;
|
|
93
|
+
if (!c.Transform || 'Player' in c || actor.id === runtime.orbitOwnModel ||
|
|
94
|
+
actor.id === runtime.followCamera?.id || actor.runtime?.modelClip) return true;
|
|
95
|
+
let count = 0;
|
|
96
|
+
for (const name in c) if (Object.hasOwn(c, name)) count++;
|
|
97
|
+
// A remove+add can preserve the count. Promote conservatively if an old key
|
|
98
|
+
// vanished, without allocating a new list just to discover its replacement.
|
|
99
|
+
if (count === consumer.count) for (const name of consumer.names) if (!Object.hasOwn(c, name)) return true;
|
|
100
|
+
let classesChanged = false;
|
|
101
|
+
for (let i = 0; i < consumer.names.length; i++) {
|
|
102
|
+
if (runtime.behaviors?.get(consumer.names[i]) !== consumer.classes[i]) classesChanged = true;
|
|
103
|
+
}
|
|
104
|
+
if (count === consumer.count && revision === consumer.revision && !classesChanged) return false;
|
|
105
|
+
const names = Object.keys(c);
|
|
106
|
+
consumer.names = names; consumer.classes = names.map(name => runtime.behaviors?.get(name));
|
|
107
|
+
consumer.count = count; consumer.revision = revision;
|
|
108
|
+
return !componentsMayWait(runtime, actor, load.inert ?? [], names);
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
const playerTransform = actors => actors.find(actor => 'Player' in actor.components)?.components.Transform;
|
|
112
|
+
|
|
113
|
+
// Cache eligibility until the focus moves over 1 m or pending membership /
|
|
114
|
+
// placement changes. Dynamic and tier-detached moves invalidate during sync.
|
|
115
|
+
export function nearModelKeys(world, load) {
|
|
116
|
+
const previous = load.nearCache;
|
|
117
|
+
if (load.horizon === 0 || !load.pending.size) {
|
|
118
|
+
if (previous?.revision === load.pendingRevision) return previous.near;
|
|
119
|
+
const near = new Set(load.pending.keys());
|
|
120
|
+
load.nearCache = { near, revision: load.pendingRevision };
|
|
121
|
+
return near;
|
|
122
|
+
}
|
|
123
|
+
const actors = load.runtime.actors;
|
|
124
|
+
let player = previous?.player;
|
|
125
|
+
if (!player || !previous || previous.revision !== load.pendingRevision || previous.actors !== actors ||
|
|
126
|
+
previous.actorCount !== actors?.size || (player &&
|
|
127
|
+
(load.runtime.getActor(player.id) !== player || !('Player' in player.components)))) {
|
|
128
|
+
player = load.runtime.getActors().find(actor => 'Player' in actor.components);
|
|
129
|
+
}
|
|
130
|
+
const centre = player?.components.Transform ?? world.camera.getWorldPosition(load.horizonCamera ??= new Vector3());
|
|
131
|
+
if (previous && previous.revision === load.pendingRevision && previous.player === player &&
|
|
132
|
+
Math.hypot(centre.x - previous.x, centre.z - previous.z) <= 1) {
|
|
133
|
+
previous.actors = actors; previous.actorCount = actors?.size;
|
|
134
|
+
return previous.near;
|
|
135
|
+
}
|
|
136
|
+
const near = new Set();
|
|
137
|
+
for (const [key, waits] of load.pending) {
|
|
138
|
+
for (const wait of waits) {
|
|
139
|
+
const t = wait.actor.components.Transform;
|
|
140
|
+
if (t && Math.hypot(t.x - centre.x, t.z - centre.z) <= load.horizon) {
|
|
141
|
+
near.add(key);
|
|
142
|
+
break;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
load.nearCache = { near, revision: load.pendingRevision, player, actors, actorCount: actors?.size, x: centre.x, z: centre.z };
|
|
147
|
+
return near;
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
export function makeModelLoad(world, runtime, setting) {
|
|
151
|
+
const actors = runtime.getActors();
|
|
152
|
+
// Player is a component/behaviour, as in Door/Pickup and the Player itself.
|
|
153
|
+
const centre = playerTransform(actors) ?? { x: 0, z: 0 };
|
|
154
|
+
const ids = Array.isArray(setting.first) ? new Set(setting.first) : null;
|
|
155
|
+
const firstFiles = new Set();
|
|
156
|
+
for (const actor of actors) {
|
|
157
|
+
const t = actor.components.Transform;
|
|
158
|
+
if (!t) continue;
|
|
159
|
+
const selected = ids ? ids.has(actor.id) : Math.hypot(t.x - centre.x, t.z - centre.z) <= setting.first.radius;
|
|
160
|
+
if (selected || world.instanceModels || !actorMayWait(world, runtime, actor, setting.inert)) firstFiles.add(actor.components.Model?.file);
|
|
161
|
+
}
|
|
162
|
+
return {
|
|
163
|
+
runtime, data: runtime.data, sceneKey: runtime.sceneKey ?? runtime.scenePath,
|
|
164
|
+
setting: JSON.stringify(setting), sliceMs: setting.sliceMs, horizon: setting.horizon, inert: setting.inert, firstFiles,
|
|
165
|
+
pending: new Map(), built: new Set(), firstKeys: new Set(), deferredKeys: new Set(),
|
|
166
|
+
pendingRevision: 0, nearCache: null,
|
|
167
|
+
consumerRegistry: runtime.behaviors, consumerRegistrySize: runtime.behaviors?.size, consumerRevision: 0,
|
|
168
|
+
synced: false, drawn: false, restMarked: false, draining: false,
|
|
169
|
+
drawnAt: null, frameIntervals: [], skippedFrames: 0,
|
|
170
|
+
now: () => performance.now(),
|
|
171
|
+
};
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
export function loadSummary(load, world) {
|
|
175
|
+
return Object.freeze({ pending: load.pending.size, near: nearModelKeys(world, load).size, built: load.built.size,
|
|
176
|
+
firstKeys: load.firstKeys.size, deferredKeys: load.deferredKeys.size });
|
|
177
|
+
}
|