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,624 @@
|
|
|
1
|
+
// Run with: node kits/multiplayer-3d/scripts/test-resume-gate.mjs
|
|
2
|
+
//
|
|
3
|
+
// A player who went away (an app switch, a short drop) and came back to the
|
|
4
|
+
// same session must never see the room as it was, nor anything easing from it
|
|
5
|
+
// to where it is now. This drives the real client system, interpolation,
|
|
6
|
+
// clock, smoothing and pose codec frame by frame through such returns and
|
|
7
|
+
// checks every frame the page would show: either the cover is up, or every
|
|
8
|
+
// object and player is drawn at its current pose.
|
|
9
|
+
//
|
|
10
|
+
// `RESUME_BASELINE=<path to an older multiplayer.js>` runs the same returns
|
|
11
|
+
// against that file and prints how many wrong frames it shows instead of
|
|
12
|
+
// failing (the old file has no gate to check).
|
|
13
|
+
import assert from 'node:assert/strict';
|
|
14
|
+
import { register } from 'node:module';
|
|
15
|
+
import { pathToFileURL } from 'node:url';
|
|
16
|
+
|
|
17
|
+
const kits = new URL('../../', import.meta.url).href;
|
|
18
|
+
const baseline = process.env.RESUME_BASELINE ? pathToFileURL(process.env.RESUME_BASELINE).href : null;
|
|
19
|
+
const stubs = {
|
|
20
|
+
'../client/avatars.js': `
|
|
21
|
+
export const makeAvatars = () => ({ actors: new Map(), leaving: new Map(), retired: new Set() });
|
|
22
|
+
export const showPlayer = (avatars, scene, id, name, pose) => {
|
|
23
|
+
(globalThis.__drawnPlayers ??= new Map()).set(id, pose.slice());
|
|
24
|
+
return { id: 'avatar-' + id };
|
|
25
|
+
};
|
|
26
|
+
export const showSelf = () => {}; export const enter = () => {}; export const retire = () => {};
|
|
27
|
+
export const dropMissing = () => {}; export const animate = () => {}; export const clearAvatars = () => {};`,
|
|
28
|
+
'../client/steer.js': 'export const makeState = () => ({}); export const LIVE_RADIUS = 3;',
|
|
29
|
+
'@imports/castle.real-time/code/client/connection.js':
|
|
30
|
+
'export const connectSession = async (options) => { globalThis.__connect = options; return globalThis.__net; };',
|
|
31
|
+
'@imports/castle.real-time/code/client/soloBadge.js': 'export const showSoloBadge = () => {}; export const updateSoloBadge = () => {};',
|
|
32
|
+
'@imports/castle.real-time/code/client/joinOverlay.js':
|
|
33
|
+
'export const showJoinOverlay = (visible, text) => { globalThis.__cover = visible ? (text ?? "Joining…") : null; };',
|
|
34
|
+
'@imports/castle.real-time/code/client/gameHooks.js': 'export const game = {};',
|
|
35
|
+
};
|
|
36
|
+
register(
|
|
37
|
+
`data:text/javascript,${encodeURIComponent(`
|
|
38
|
+
import { readFile } from 'node:fs/promises';
|
|
39
|
+
const stubs = ${JSON.stringify(stubs)};
|
|
40
|
+
const kits = ${JSON.stringify(kits)};
|
|
41
|
+
const baseline = ${JSON.stringify(baseline)};
|
|
42
|
+
export async function resolve(s, c, next) {
|
|
43
|
+
if (c.parentURL?.endsWith('/systems/multiplayer.js') && stubs[s]) {
|
|
44
|
+
return { url: 'data:text/javascript,' + encodeURIComponent(stubs[s]), shortCircuit: true };
|
|
45
|
+
}
|
|
46
|
+
if (s.startsWith('@imports/castle.real-time/')) {
|
|
47
|
+
return next(kits + 'real-time/' + s.slice('@imports/castle.real-time/'.length), c);
|
|
48
|
+
}
|
|
49
|
+
// A baseline file elsewhere still imports the kit's own client modules.
|
|
50
|
+
if (baseline && c.parentURL === baseline && s.startsWith('../')) {
|
|
51
|
+
return next(new URL(s, kits + 'multiplayer-3d/code/systems/multiplayer.js').href, c);
|
|
52
|
+
}
|
|
53
|
+
return next(s, c);
|
|
54
|
+
}
|
|
55
|
+
export async function load(u, c, next) {
|
|
56
|
+
if (u.endsWith('/systems/multiplayer.js') || u === baseline) {
|
|
57
|
+
const file = new URL(baseline && u.endsWith('/systems/multiplayer.js') ? baseline : u);
|
|
58
|
+
const source = (await readFile(file, 'utf8')).replace(/import.meta.glob\\([^)]*\\)/g, '({})');
|
|
59
|
+
return { format: 'module', source, shortCircuit: true };
|
|
60
|
+
}
|
|
61
|
+
return next(u, c);
|
|
62
|
+
}
|
|
63
|
+
`)}`,
|
|
64
|
+
);
|
|
65
|
+
|
|
66
|
+
// The page clock and document the system reads.
|
|
67
|
+
let pageMs = 0;
|
|
68
|
+
Object.defineProperty(globalThis, 'performance', { value: { now: () => pageMs }, configurable: true, writable: true });
|
|
69
|
+
const listeners = new Map();
|
|
70
|
+
globalThis.document = {
|
|
71
|
+
hidden: false,
|
|
72
|
+
addEventListener: (type, fn) => listeners.set(type, fn),
|
|
73
|
+
removeEventListener: (type) => listeners.delete(type),
|
|
74
|
+
};
|
|
75
|
+
const quiet = console.log;
|
|
76
|
+
console.log = (...args) => (String(args[0]).startsWith('[multiplayer]') ? undefined : quiet(...args));
|
|
77
|
+
console.warn = (...args) => (String(args[0]).startsWith('[multiplayer]') ? undefined : quiet(...args));
|
|
78
|
+
|
|
79
|
+
const { installSystem } = await import('../code/systems/multiplayer.js');
|
|
80
|
+
|
|
81
|
+
// Prism Post's beam that a partner turned while this player was away: the
|
|
82
|
+
// pose drawn before the away, and the one the session has now
|
|
83
|
+
// (dot-build-prism-post render-smoothing-proof.json).
|
|
84
|
+
const Q = [0, 0.7071067811865476, 0, 0.7071067811865476];
|
|
85
|
+
const BEAM_OLD = [-10.2, 0.08, 2.7, ...Q];
|
|
86
|
+
const BEAM_NOW = [-10.2, 0.08, 0.9, ...Q];
|
|
87
|
+
// Prism's own tolerance for a drawn pose against the current one.
|
|
88
|
+
const TOLERANCE = 0.035;
|
|
89
|
+
|
|
90
|
+
const FRAME_MS = 1000 / 60;
|
|
91
|
+
const TICK_MS = 1000 / 30;
|
|
92
|
+
// Simulation time is page time less this; each message spends TRANSIT_MS in transit.
|
|
93
|
+
const OFFSET_MS = 5000;
|
|
94
|
+
const TRANSIT_MS = 20;
|
|
95
|
+
|
|
96
|
+
// One client in a room. `objects` and `players` are the session's current
|
|
97
|
+
// poses; `send` decides what reaches the client and when.
|
|
98
|
+
async function makeRoom({ objects, players = {} }) {
|
|
99
|
+
pageMs = 10000;
|
|
100
|
+
document.hidden = false;
|
|
101
|
+
listeners.clear();
|
|
102
|
+
globalThis.__cover = null;
|
|
103
|
+
globalThis.__drawnPlayers = new Map();
|
|
104
|
+
const system = installSystem({ registerSystem() {} });
|
|
105
|
+
const room = {
|
|
106
|
+
system,
|
|
107
|
+
objects: { ...objects },
|
|
108
|
+
players: { ...players },
|
|
109
|
+
state: 'connected',
|
|
110
|
+
inbox: [],
|
|
111
|
+
// Whether the transport delivers broadcasts as they are sent.
|
|
112
|
+
socket: true,
|
|
113
|
+
// Each changed object since the last broadcast this client received.
|
|
114
|
+
sentObjects: new Map(),
|
|
115
|
+
sentPlayers: new Map(),
|
|
116
|
+
nextTick: pageMs,
|
|
117
|
+
actors: new Map(),
|
|
118
|
+
frames: [],
|
|
119
|
+
};
|
|
120
|
+
for (const id of Object.keys(objects)) {
|
|
121
|
+
room.actors.set(id, { id, components: { Transform: { x: 0, y: 0, z: 0 } } });
|
|
122
|
+
}
|
|
123
|
+
globalThis.__net = {
|
|
124
|
+
selfId: () => 'self',
|
|
125
|
+
drain: () => room.inbox.splice(0),
|
|
126
|
+
status: () => ({ state: room.state, solo: false, others: Object.keys(room.players).length, you: 'me' }),
|
|
127
|
+
others: () => new Map(Object.keys(room.players).map((id) => [id, id])),
|
|
128
|
+
roster: () => new Map(),
|
|
129
|
+
userId: () => null,
|
|
130
|
+
sendMove: () => false,
|
|
131
|
+
send: () => {},
|
|
132
|
+
closed: () => false,
|
|
133
|
+
close() {},
|
|
134
|
+
};
|
|
135
|
+
// This player, whose body the session's WORLD placement moves.
|
|
136
|
+
const local = { id: 'local', components: { Transform: { x: 0, y: 0, z: 0 } } };
|
|
137
|
+
let at = { x: 0, y: 0, z: 0 };
|
|
138
|
+
const body = {
|
|
139
|
+
setTranslation: (p) => (at = { ...p }),
|
|
140
|
+
translation: () => at,
|
|
141
|
+
rotation: () => ({ x: 0, y: 0, z: 0, w: 1 }),
|
|
142
|
+
setLinvel() {},
|
|
143
|
+
linvel: () => ({ x: 0, y: 0, z: 0 }),
|
|
144
|
+
angvel: () => ({ x: 0, y: 0, z: 0 }),
|
|
145
|
+
};
|
|
146
|
+
room.scene = {
|
|
147
|
+
actorWith: () => local,
|
|
148
|
+
physics3d: { bodyOf: (actor) => (actor === local ? body : null) },
|
|
149
|
+
data: {},
|
|
150
|
+
getActor: (id) => room.actors.get(id),
|
|
151
|
+
actors: room.actors,
|
|
152
|
+
systems: [],
|
|
153
|
+
touch() {},
|
|
154
|
+
despawnActor() {},
|
|
155
|
+
hud: {},
|
|
156
|
+
};
|
|
157
|
+
await system.start(room.scene);
|
|
158
|
+
assert.equal(system.net, globalThis.__net);
|
|
159
|
+
return room;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
// The transport's own report that the connection is back.
|
|
163
|
+
function reconnect(room, { event = true } = {}) {
|
|
164
|
+
room.state = 'connected';
|
|
165
|
+
room.socket = true;
|
|
166
|
+
if (event) {
|
|
167
|
+
globalThis.__connect.onConnected();
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
function simNow() {
|
|
172
|
+
return pageMs - OFFSET_MS;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
// One message as the client queues it, `localMs` its arrival.
|
|
176
|
+
function deliver(room, msg, arriveAt = pageMs + TRANSIT_MS) {
|
|
177
|
+
room.inbox.push({ ...msg, localMs: arriveAt });
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
// What a session broadcasts each tick: the poses that changed since the last
|
|
181
|
+
// broadcast, which a client that missed a tick never gets again.
|
|
182
|
+
function broadcast(room) {
|
|
183
|
+
const os = [];
|
|
184
|
+
for (const [id, pose] of Object.entries(room.objects)) {
|
|
185
|
+
if (room.sentObjects.get(id) !== pose.join()) {
|
|
186
|
+
room.sentObjects.set(id, pose.join());
|
|
187
|
+
os.push([id, ...pose, 0]);
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
const ps = [];
|
|
191
|
+
for (const [id, pose] of Object.entries(room.players)) {
|
|
192
|
+
if (room.sentPlayers.get(id) !== pose.join()) {
|
|
193
|
+
room.sentPlayers.set(id, pose.join());
|
|
194
|
+
ps.push([id, ...pose]);
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
return { k: 's', t: simNow(), os, ps, own: [] };
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
function world(room) {
|
|
201
|
+
return {
|
|
202
|
+
k: 'w',
|
|
203
|
+
t: simNow(),
|
|
204
|
+
os: Object.entries(room.objects).map(([id, pose]) => [id, ...pose, 0]),
|
|
205
|
+
ps: [...Object.entries(room.players).map(([id, pose]) => [id, ...pose]), ['self', 0, 0, 0, 0]],
|
|
206
|
+
own: [],
|
|
207
|
+
};
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
// Advance the page to `until`, ticking the session and drawing frames while
|
|
211
|
+
// the page is shown. `deliverTicks` says whether broadcasts reach the client.
|
|
212
|
+
function run(room, until) {
|
|
213
|
+
while (pageMs < until) {
|
|
214
|
+
pageMs = Math.min(until, pageMs + FRAME_MS / 4);
|
|
215
|
+
if (pageMs >= room.nextTick) {
|
|
216
|
+
room.nextTick += TICK_MS;
|
|
217
|
+
const msg = broadcast(room);
|
|
218
|
+
if (room.socket) {
|
|
219
|
+
deliver(room, msg);
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
if (!document.hidden && pageMs >= (room.lastFrame ?? 0) + FRAME_MS) {
|
|
223
|
+
frame(room);
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
// One drawn frame, and what the page shows of it.
|
|
229
|
+
function frame(room) {
|
|
230
|
+
room.lastFrame = pageMs;
|
|
231
|
+
room.system.afterBehaviors(room.scene, FRAME_MS / 1000);
|
|
232
|
+
const drawn = {};
|
|
233
|
+
for (const [id, actor] of room.actors) {
|
|
234
|
+
const t = actor.components.Transform;
|
|
235
|
+
drawn[id] = [t.x, t.y, t.z];
|
|
236
|
+
}
|
|
237
|
+
for (const [id, pose] of globalThis.__drawnPlayers) {
|
|
238
|
+
drawn[id] = pose.slice(0, 3);
|
|
239
|
+
}
|
|
240
|
+
room.frames.push({ at: pageMs, cover: globalThis.__cover, drawn, armed: room.system.resume?.armed });
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
function hide(room) {
|
|
244
|
+
document.hidden = true;
|
|
245
|
+
listeners.get('visibilitychange')?.();
|
|
246
|
+
room.hiddenAt = pageMs;
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
// The page shown again: the first thing composited is whatever the DOM holds
|
|
250
|
+
// now, before any frame runs.
|
|
251
|
+
function show(room) {
|
|
252
|
+
document.hidden = false;
|
|
253
|
+
listeners.get('visibilitychange')?.();
|
|
254
|
+
room.shownAt = pageMs;
|
|
255
|
+
room.frames.push({ at: pageMs, cover: globalThis.__cover, drawn: null, composited: true });
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
function offBy(drawn, current) {
|
|
259
|
+
return Math.hypot(drawn[0] - current[0], drawn[1] - current[1], drawn[2] - current[2]);
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
// Every shown frame from the return on: covered, or every pose current. The
|
|
263
|
+
// uncovered frames before the away are not judged.
|
|
264
|
+
function wrongFrames(room) {
|
|
265
|
+
const wrong = [];
|
|
266
|
+
for (const f of room.frames) {
|
|
267
|
+
if ((f.at <= room.shownAt && !f.composited) || f.cover) {
|
|
268
|
+
continue;
|
|
269
|
+
}
|
|
270
|
+
if (!f.drawn) {
|
|
271
|
+
wrong.push({ at: f.at - room.shownAt, why: 'composited the old canvas' });
|
|
272
|
+
continue;
|
|
273
|
+
}
|
|
274
|
+
const current = { ...room.objects, ...room.players };
|
|
275
|
+
for (const [id, pose] of Object.entries(current)) {
|
|
276
|
+
const off = offBy(f.drawn[id] ?? [Infinity, 0, 0], pose);
|
|
277
|
+
if (off > TOLERANCE) {
|
|
278
|
+
wrong.push({ at: Math.round(f.at - room.shownAt), id, off: Number(off.toFixed(3)) });
|
|
279
|
+
}
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
return wrong;
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
function uncoveredAt(room) {
|
|
286
|
+
return room.frames.find((f) => f.at > room.shownAt && !f.cover && f.drawn)?.at - room.shownAt;
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
const results = [];
|
|
290
|
+
function check(name, room, { uncoverBy } = {}) {
|
|
291
|
+
const wrong = wrongFrames(room);
|
|
292
|
+
const uncover = uncoveredAt(room);
|
|
293
|
+
results.push({ name, wrong: wrong.length, uncoveredMs: Math.round(uncover), first: wrong[0] ?? null });
|
|
294
|
+
if (baseline) {
|
|
295
|
+
return;
|
|
296
|
+
}
|
|
297
|
+
assert.deepEqual(wrong, [], `${name}: no frame shows the old room or a path from it`);
|
|
298
|
+
assert.ok(Number.isFinite(uncover), `${name}: the room is shown again`);
|
|
299
|
+
if (uncoverBy !== undefined) {
|
|
300
|
+
assert.ok(uncover <= uncoverBy, `${name}: uncovered ${uncover} ms after the return, by ${uncoverBy}`);
|
|
301
|
+
}
|
|
302
|
+
assert.equal(room.system.resume.armed, false, `${name}: the gate released`);
|
|
303
|
+
// A live body placed on release reaches its Transform at the next physics
|
|
304
|
+
// step, so the frame that releases is still covered.
|
|
305
|
+
room.frames.forEach((f, i) => {
|
|
306
|
+
if (i > 0 && room.frames[i - 1].armed && f.armed === false) {
|
|
307
|
+
assert.ok(f.cover, `${name}: the releasing frame stays covered`);
|
|
308
|
+
}
|
|
309
|
+
});
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
// Prism's return: the app goes to the background, its socket closes, a
|
|
313
|
+
// partner turns the beam, and the app comes back after `awayMs`. The
|
|
314
|
+
// connection reconnects to the same identity, ordinary broadcasts start
|
|
315
|
+
// reaching it, and the session's WORLD arrives 914 ms after the page shows.
|
|
316
|
+
async function prismReturn(awayMs, { reconnectEvent = true } = {}) {
|
|
317
|
+
const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
318
|
+
deliver(room, world(room), pageMs);
|
|
319
|
+
run(room, pageMs + 2000);
|
|
320
|
+
const before = room.frames.at(-1);
|
|
321
|
+
assert.ok(offBy(before.drawn['b0-beam-3'], BEAM_OLD) < 1e-9 && !before.cover, 'the old route is drawn before the away');
|
|
322
|
+
|
|
323
|
+
hide(room);
|
|
324
|
+
if (!baseline) {
|
|
325
|
+
assert.equal(globalThis.__cover, 'Reconnecting…', 'the cover is up before the page goes');
|
|
326
|
+
}
|
|
327
|
+
run(room, pageMs + 500);
|
|
328
|
+
room.socket = false;
|
|
329
|
+
room.state = 'reconnecting';
|
|
330
|
+
run(room, pageMs + awayMs / 2);
|
|
331
|
+
room.objects['b0-beam-3'] = BEAM_NOW;
|
|
332
|
+
run(room, room.hiddenAt + awayMs);
|
|
333
|
+
|
|
334
|
+
show(room);
|
|
335
|
+
run(room, pageMs + 400);
|
|
336
|
+
reconnect(room, { event: reconnectEvent });
|
|
337
|
+
run(room, room.shownAt + 914);
|
|
338
|
+
deliver(room, world(room));
|
|
339
|
+
run(room, pageMs + 1500);
|
|
340
|
+
return room;
|
|
341
|
+
}
|
|
342
|
+
|
|
343
|
+
// 30 s and 3 min, with and without the transport's reconnect event.
|
|
344
|
+
check('prism 30s return', await prismReturn(30000), { uncoverBy: 914 + 3 * FRAME_MS + TRANSIT_MS });
|
|
345
|
+
check('prism 3min return', await prismReturn(180000), { uncoverBy: 914 + 3 * FRAME_MS + TRANSIT_MS });
|
|
346
|
+
check('prism 30s return, drop seen only by frames', await prismReturn(30000, { reconnectEvent: false }), {
|
|
347
|
+
uncoverBy: 914 + 3 * FRAME_MS + TRANSIT_MS,
|
|
348
|
+
});
|
|
349
|
+
|
|
350
|
+
// A desktop tab hidden 30 s whose socket stays up: broadcasts keep arriving
|
|
351
|
+
// while it is hidden, including the turned beam. The room is current on the
|
|
352
|
+
// first frame back.
|
|
353
|
+
{
|
|
354
|
+
const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
355
|
+
deliver(room, world(room), pageMs);
|
|
356
|
+
run(room, pageMs + 2000);
|
|
357
|
+
hide(room);
|
|
358
|
+
run(room, pageMs + 10000);
|
|
359
|
+
room.objects['b0-beam-3'] = BEAM_NOW;
|
|
360
|
+
run(room, room.hiddenAt + 30000);
|
|
361
|
+
show(room);
|
|
362
|
+
run(room, pageMs + 1000);
|
|
363
|
+
check('socket kept, hidden 30s', room, { uncoverBy: 2 * FRAME_MS });
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
// A socket that died at the suspension with frames still in its buffer: they
|
|
367
|
+
// arrive in a burst on the return, a moment old by their simulation time, and
|
|
368
|
+
// say nothing of the beam turned since. They must not release the cover; the
|
|
369
|
+
// drop is then seen and the WORLD after the reconnect does.
|
|
370
|
+
{
|
|
371
|
+
const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
372
|
+
deliver(room, world(room), pageMs);
|
|
373
|
+
run(room, pageMs + 2000);
|
|
374
|
+
hide(room);
|
|
375
|
+
const stale = [];
|
|
376
|
+
room.socket = false;
|
|
377
|
+
for (let i = 0; i < 6; i += 1) {
|
|
378
|
+
run(room, pageMs + TICK_MS);
|
|
379
|
+
stale.push(broadcast(room));
|
|
380
|
+
}
|
|
381
|
+
run(room, pageMs + 10000);
|
|
382
|
+
room.objects['b0-beam-3'] = BEAM_NOW;
|
|
383
|
+
run(room, room.hiddenAt + 30000);
|
|
384
|
+
show(room);
|
|
385
|
+
for (const msg of stale) {
|
|
386
|
+
deliver(room, msg, pageMs);
|
|
387
|
+
}
|
|
388
|
+
run(room, pageMs + 300);
|
|
389
|
+
if (!baseline) {
|
|
390
|
+
assert.equal(room.system.resume.armed, true, 'a stale buffered burst keeps the cover');
|
|
391
|
+
}
|
|
392
|
+
room.state = 'reconnecting';
|
|
393
|
+
run(room, pageMs + 300);
|
|
394
|
+
reconnect(room);
|
|
395
|
+
run(room, pageMs + 200);
|
|
396
|
+
deliver(room, world(room));
|
|
397
|
+
run(room, pageMs + 1000);
|
|
398
|
+
check('stale buffer, then reconnect', room, { uncoverBy: 1000 });
|
|
399
|
+
}
|
|
400
|
+
|
|
401
|
+
// An ordinary hub door: several objects and another player. The connection
|
|
402
|
+
// drops for 2 s with the page shown; meanwhile the other player walks off
|
|
403
|
+
// and a crate is pushed. Ordinary broadcasts arrive before the WORLD the
|
|
404
|
+
// filtering session sends to a body it kept.
|
|
405
|
+
{
|
|
406
|
+
const crate = [3, 0.5, 3, 0, 0, 0, 1];
|
|
407
|
+
const ball = [-4, 0.5, 1, 0, 0, 0, 1];
|
|
408
|
+
const room = await makeRoom({ objects: { crate, ball }, players: { partner: [1, 0, 1, 0] } });
|
|
409
|
+
deliver(room, world(room), pageMs);
|
|
410
|
+
run(room, pageMs + 2000);
|
|
411
|
+
room.socket = false;
|
|
412
|
+
room.state = 'reconnecting';
|
|
413
|
+
room.shownAt = pageMs;
|
|
414
|
+
run(room, pageMs + 1000);
|
|
415
|
+
room.objects.crate = [4.2, 0.5, 2.1, 0, 0, 0, 1];
|
|
416
|
+
room.players.partner = [2.5, 0, -0.5, 1.2];
|
|
417
|
+
run(room, pageMs + 1000);
|
|
418
|
+
reconnect(room);
|
|
419
|
+
run(room, pageMs + 120);
|
|
420
|
+
deliver(room, world(room));
|
|
421
|
+
run(room, pageMs + 1500);
|
|
422
|
+
check('hub door, 2s drop while shown', room, { uncoverBy: 2000 + 120 + 3 * FRAME_MS + TRANSIT_MS });
|
|
423
|
+
}
|
|
424
|
+
|
|
425
|
+
if (baseline) {
|
|
426
|
+
console.table(results);
|
|
427
|
+
console.log('test-resume-gate: baseline run; wrong frames are reported, not asserted');
|
|
428
|
+
process.exit(0);
|
|
429
|
+
}
|
|
430
|
+
|
|
431
|
+
// A session that never answers after the return gives up after the wait, so
|
|
432
|
+
// the deck is not hidden for good.
|
|
433
|
+
{
|
|
434
|
+
const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
435
|
+
deliver(room, world(room), pageMs);
|
|
436
|
+
run(room, pageMs + 2000);
|
|
437
|
+
hide(room);
|
|
438
|
+
room.socket = false;
|
|
439
|
+
run(room, pageMs + 30000);
|
|
440
|
+
show(room);
|
|
441
|
+
run(room, pageMs + 9000);
|
|
442
|
+
assert.equal(room.system.resume.armed, true, 'still waiting before the give-up');
|
|
443
|
+
assert.equal(room.system.placed(), false, 'not placed while the gate holds');
|
|
444
|
+
run(room, pageMs + 1100);
|
|
445
|
+
assert.equal(room.system.resume.armed, false, 'gives up after the wait');
|
|
446
|
+
assert.equal(globalThis.__cover, null);
|
|
447
|
+
assert.equal(room.system.placed(), true, 'placed again once released');
|
|
448
|
+
}
|
|
449
|
+
|
|
450
|
+
// A frame gap with no hidden event (a suspended webview, a debugger pause)
|
|
451
|
+
// arms the gate on the first frame back; the next current broadcast releases it.
|
|
452
|
+
// The beam turned during the 1.1 s gap is drawn where it is, not part way along
|
|
453
|
+
// an interpolation from the pose before the gap.
|
|
454
|
+
{
|
|
455
|
+
const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
456
|
+
deliver(room, world(room), pageMs);
|
|
457
|
+
run(room, pageMs + 2000);
|
|
458
|
+
// The last pose before the gap arrives on the very tick of the last frame,
|
|
459
|
+
// so its simulation time is exactly where the away begins.
|
|
460
|
+
room.objects['b0-beam-3'] = [-10.2, 0.08, 2.6, ...Q];
|
|
461
|
+
deliver(room, broadcast(room), pageMs);
|
|
462
|
+
room.lastFrame = pageMs - FRAME_MS;
|
|
463
|
+
frame(room);
|
|
464
|
+
assert.equal(room.system.clock.offset, OFFSET_MS, 'that arrival set the clock offset');
|
|
465
|
+
room.socket = false;
|
|
466
|
+
pageMs += 1100;
|
|
467
|
+
room.nextTick = pageMs;
|
|
468
|
+
room.objects['b0-beam-3'] = BEAM_NOW;
|
|
469
|
+
room.socket = true;
|
|
470
|
+
room.shownAt = pageMs;
|
|
471
|
+
run(room, pageMs + 600);
|
|
472
|
+
check('1.1 s frame stall', room, { uncoverBy: 200 });
|
|
473
|
+
}
|
|
474
|
+
|
|
475
|
+
// A dropped connection that comes back with ordinary broadcasts and no WORLD
|
|
476
|
+
// (a session from before the kept-body WORLD) is never uncovered on them, since
|
|
477
|
+
// they say nothing of what moved while it was gone; the wait gives up instead.
|
|
478
|
+
{
|
|
479
|
+
const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
480
|
+
deliver(room, world(room), pageMs);
|
|
481
|
+
run(room, pageMs + 2000);
|
|
482
|
+
room.socket = false;
|
|
483
|
+
room.state = 'reconnecting';
|
|
484
|
+
run(room, pageMs + 1000);
|
|
485
|
+
room.objects['b0-beam-3'] = BEAM_NOW;
|
|
486
|
+
run(room, pageMs + 1000);
|
|
487
|
+
reconnect(room);
|
|
488
|
+
run(room, pageMs + 6000);
|
|
489
|
+
assert.equal(room.system.resume.armed, true, 'broadcasts after a drop do not release the cover');
|
|
490
|
+
assert.ok(room.frames.slice(-300).every((f) => f.cover), 'covered throughout');
|
|
491
|
+
}
|
|
492
|
+
|
|
493
|
+
// A give-up during a long disconnect stays given up until the connection is
|
|
494
|
+
// back, rather than covering again on the next frame; the return then arms
|
|
495
|
+
// the gate afresh and its WORLD releases it.
|
|
496
|
+
{
|
|
497
|
+
const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
498
|
+
deliver(room, world(room), pageMs);
|
|
499
|
+
run(room, pageMs + 2000);
|
|
500
|
+
room.socket = false;
|
|
501
|
+
room.state = 'reconnecting';
|
|
502
|
+
run(room, pageMs + 10500);
|
|
503
|
+
assert.equal(room.system.resume.armed, false, 'gave up');
|
|
504
|
+
run(room, pageMs + 3000);
|
|
505
|
+
assert.equal(room.system.resume.armed, false, 'and does not cover again while still disconnected');
|
|
506
|
+
assert.ok(room.frames.slice(-60).every((f) => !f.cover));
|
|
507
|
+
room.objects['b0-beam-3'] = BEAM_NOW;
|
|
508
|
+
reconnect(room);
|
|
509
|
+
room.shownAt = pageMs;
|
|
510
|
+
assert.equal(room.system.resume.armed, true, 'the return arms the gate');
|
|
511
|
+
run(room, pageMs + 200);
|
|
512
|
+
deliver(room, world(room));
|
|
513
|
+
run(room, pageMs + 800);
|
|
514
|
+
check('give-up, then reconnect', room, { uncoverBy: 200 + 3 * FRAME_MS + TRANSIT_MS });
|
|
515
|
+
}
|
|
516
|
+
|
|
517
|
+
// A WORLD from a reconnect while the page was hidden, followed by another drop,
|
|
518
|
+
// does not release the return after the later reconnect: only a WORLD since it does.
|
|
519
|
+
{
|
|
520
|
+
const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
521
|
+
deliver(room, world(room), pageMs);
|
|
522
|
+
run(room, pageMs + 2000);
|
|
523
|
+
hide(room);
|
|
524
|
+
room.socket = false;
|
|
525
|
+
room.state = 'reconnecting';
|
|
526
|
+
run(room, pageMs + 5000);
|
|
527
|
+
reconnect(room);
|
|
528
|
+
deliver(room, world(room));
|
|
529
|
+
run(room, pageMs + 100);
|
|
530
|
+
room.socket = false;
|
|
531
|
+
room.state = 'reconnecting';
|
|
532
|
+
run(room, pageMs + 5000);
|
|
533
|
+
room.objects['b0-beam-3'] = BEAM_NOW;
|
|
534
|
+
run(room, pageMs + 5000);
|
|
535
|
+
show(room);
|
|
536
|
+
run(room, pageMs + 300);
|
|
537
|
+
reconnect(room);
|
|
538
|
+
run(room, pageMs + 400);
|
|
539
|
+
assert.equal(room.system.resume.armed, true, 'the earlier WORLD does not count');
|
|
540
|
+
deliver(room, world(room));
|
|
541
|
+
run(room, pageMs + 800);
|
|
542
|
+
check('WORLD from an earlier hidden reconnect', room, { uncoverBy: 700 + 3 * FRAME_MS + TRANSIT_MS });
|
|
543
|
+
}
|
|
544
|
+
|
|
545
|
+
{
|
|
546
|
+
const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
547
|
+
deliver(room, world(room), pageMs);
|
|
548
|
+
run(room, pageMs + 2000);
|
|
549
|
+
const paused = pageMs;
|
|
550
|
+
room.socket = false;
|
|
551
|
+
room.objects['b0-beam-3'] = BEAM_NOW;
|
|
552
|
+
pageMs += 5000;
|
|
553
|
+
room.nextTick = pageMs;
|
|
554
|
+
room.socket = true;
|
|
555
|
+
room.lastFrame = pageMs - FRAME_MS;
|
|
556
|
+
frame(room);
|
|
557
|
+
assert.equal(room.system.resume.armed, true, 'a long frame gap arms the gate');
|
|
558
|
+
assert.equal(globalThis.__cover, 'Reconnecting…');
|
|
559
|
+
assert.equal(room.system.resume.since, paused);
|
|
560
|
+
room.sentObjects.clear();
|
|
561
|
+
run(room, pageMs + 200);
|
|
562
|
+
assert.equal(room.system.resume.armed, false, 'a current broadcast releases it');
|
|
563
|
+
}
|
|
564
|
+
|
|
565
|
+
// An expired return: the session the player left ended while they were away,
|
|
566
|
+
// and closes under the cover. The caller leaving the place reads `returning`
|
|
567
|
+
// to go straight under its own cover, whichever of the two systems sees the
|
|
568
|
+
// close first; it stops counting a moment after the cover comes off, and at
|
|
569
|
+
// the next session.
|
|
570
|
+
{
|
|
571
|
+
const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
572
|
+
deliver(room, world(room), pageMs);
|
|
573
|
+
run(room, pageMs + 2000);
|
|
574
|
+
assert.equal(room.system.returning(), false, 'an ordinary frame is not a return');
|
|
575
|
+
hide(room);
|
|
576
|
+
room.socket = false;
|
|
577
|
+
room.state = 'reconnecting';
|
|
578
|
+
run(room, pageMs + 180000);
|
|
579
|
+
show(room);
|
|
580
|
+
run(room, pageMs + 1100);
|
|
581
|
+
assert.equal(room.system.returning(), true, 'behind the cover');
|
|
582
|
+
room.system.net.closed = () => true;
|
|
583
|
+
assert.equal(room.system.returning(), true, 'a close not yet seen by the system');
|
|
584
|
+
frame(room);
|
|
585
|
+
assert.equal(room.system.net, null, 'the system saw the close');
|
|
586
|
+
assert.equal(room.system.returning(), true, 'a close under the cover still counts');
|
|
587
|
+
pageMs += 1900;
|
|
588
|
+
assert.equal(room.system.returning(), true);
|
|
589
|
+
pageMs += 200;
|
|
590
|
+
assert.equal(room.system.returning(), false, 'not after the moment has passed');
|
|
591
|
+
pageMs -= 2000;
|
|
592
|
+
room.system.switchSession(room.scene, { mode: 'public' }, { quiet: true });
|
|
593
|
+
assert.equal(room.system.returning(), false, 'not in the next session');
|
|
594
|
+
|
|
595
|
+
// Released by a snapshot just before the close: still a return.
|
|
596
|
+
const again = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
597
|
+
deliver(again, world(again), pageMs);
|
|
598
|
+
run(again, pageMs + 2000);
|
|
599
|
+
hide(again);
|
|
600
|
+
run(again, pageMs + 30000);
|
|
601
|
+
show(again);
|
|
602
|
+
run(again, pageMs + 500);
|
|
603
|
+
assert.equal(again.system.resume.armed, false, 'released');
|
|
604
|
+
assert.equal(again.system.returning(), true, 'just released');
|
|
605
|
+
run(again, pageMs + 2100);
|
|
606
|
+
assert.equal(again.system.returning(), false);
|
|
607
|
+
}
|
|
608
|
+
|
|
609
|
+
{
|
|
610
|
+
const room = await makeRoom({ objects: { 'b0-beam-3': BEAM_OLD } });
|
|
611
|
+
hide(room);
|
|
612
|
+
assert.equal(room.system.resume.armed, false, 'an unplaced player is covered by the join overlay instead');
|
|
613
|
+
show(room);
|
|
614
|
+
// An unplaced public join is refreshed on return before its WORLD arrives.
|
|
615
|
+
await Promise.resolve();
|
|
616
|
+
deliver(room, world(room), pageMs);
|
|
617
|
+
run(room, pageMs + 500);
|
|
618
|
+
room.system.net.status = () => ({ state: 'connected', solo: true, others: 0, you: 'me' });
|
|
619
|
+
hide(room);
|
|
620
|
+
assert.equal(room.system.resume.armed, false, 'solo play has nothing to wait for');
|
|
621
|
+
}
|
|
622
|
+
|
|
623
|
+
console.table(results);
|
|
624
|
+
console.log('test-resume-gate: every return covered until current, then drawn at current poses with no easing');
|
|
@@ -30,7 +30,16 @@ Do you already know what you want to make, or do you want to figure it out toget
|
|
|
30
30
|
- Two render hooks: `draw(ctx)` is world space and scrolls with `Camera`; `drawUi(ctx)` is screen space (card units, camera-free). On-screen controls, gauges and HUD go in `drawUi`, never `draw`. The React `ui()` hook is deprecated — prefer `drawUi`.
|
|
31
31
|
- Do not read `engine/`, `editors/`, or built-in behaviors (`Layout.jsx`, `Sprite.jsx`, `Text.jsx`, `Style.jsx`, `Collider.jsx`, `Camera.jsx`, and the physics ones — `RigidBody.jsx`, `Joints.jsx`, `Draggable.jsx`, `Slingshot.jsx`, `AnalogStick.jsx`) to build a game. Their public API is documented below. Forking is the exception: when you're deliberately copying a kit file into the deck to change it — an editor (see `## Editors`) or a behavior you're shadowing — read the original. `engine/` stays off-limits either way.
|
|
32
32
|
- An editor is for content FILES the creator keeps coming back to (catalogs, dialogue, level tables) that nothing already opens. Scenes, sprites and themes have editors; per-actor settings belong on behavior props in the inspector — not in a new editor.
|
|
33
|
-
- Details below: `## Behavior shape`, `## Scene file`, `## Blueprints`, `## Built-in behaviors`, `## Creating pixel art`, `## SceneRuntime API
|
|
33
|
+
- Details below: `## Behavior shape`, `## Scene file`, `## Blueprints`, `## Built-in behaviors`, `## Creating pixel art`, `## SceneRuntime API
|
|
34
|
+
|
|
35
|
+
`scene.setActorSleeping(actorOrId, sleeping)` is an optional streaming primitive:
|
|
36
|
+
`true` pauses an actor's behavior/draw passes and omits it from `getActors()`
|
|
37
|
+
(and systems that reconcile that list, including colliders). Components, behavior
|
|
38
|
+
instances, runtime state, ID lookup and serialized source remain intact.
|
|
39
|
+
`false` wakes the same object. Spawning an ID wakes its replacement; despawn
|
|
40
|
+
removes it and scene load clears the sleep set. No sleep map exists until used.
|
|
41
|
+
`actorWith` still searches the full scene; `actorsWith` uses the live list.
|
|
42
|
+
`, and `## Input shortcuts`.
|
|
34
43
|
|
|
35
44
|
## Editors
|
|
36
45
|
|
|
@@ -1002,3 +1011,12 @@ For HUD text prefer a `Text` actor with `space: 'screen'` (or `drawUi` for custo
|
|
|
1002
1011
|
- Don't try to import from `editors/`; behaviors run in the play runtime too.
|
|
1003
1012
|
- Don't add types or `.ts`/`.tsx` files. This kit is JavaScript.
|
|
1004
1013
|
- Don't add a build step or change `vite.config.js` for a game — it's configured for you.
|
|
1014
|
+
|
|
1015
|
+
Client update budgeting: a controller may set `actor.runtime.updateEvery` to
|
|
1016
|
+
a positive finite number of seconds for an actor whose behavior can tolerate
|
|
1017
|
+
a lower cadence. The first update runs immediately; later updates receive
|
|
1018
|
+
the accumulated dt. Removing the field restores full cadence on the next
|
|
1019
|
+
frame. Only behavior update and its enabled-state polling are budgeted;
|
|
1020
|
+
systems, physics, input dispatch and event hooks continue every frame. Use
|
|
1021
|
+
this only for presentation actors, never a player or a force-driven body.
|
|
1022
|
+
The hub town's opt-in Low budget uses this for distant NPC/display actors.
|
|
@@ -68,11 +68,11 @@
|
|
|
68
68
|
"onUpdate": "scripts/onUpdate.mjs",
|
|
69
69
|
"title": "physics-2d",
|
|
70
70
|
"description": "Scene Editor. Works like classic Castle: actors, blueprints, behaviors and drawing tools, with physics built in.",
|
|
71
|
-
"publishedVersion": "2026-10-
|
|
71
|
+
"publishedVersion": "2026-10-17T06:02:29.713Z",
|
|
72
72
|
"imports": {
|
|
73
73
|
"castle.base": {
|
|
74
74
|
"deckId": "yRcmH4_aYllE",
|
|
75
|
-
"version": "2026-10-
|
|
75
|
+
"version": "2026-10-16T11:44:02.771Z"
|
|
76
76
|
}
|
|
77
77
|
}
|
|
78
78
|
}
|