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,452 @@
|
|
|
1
|
+
// The player's frame cap (`engine3d/framecap.js`, `"engine": { "maxFps": n }`)
|
|
2
|
+
// driven with made-up requestAnimationFrame timestamps, as Scene3DPlayer's
|
|
3
|
+
// tick drives it: displays at 60 Hz (timestamps up to 1.5 ms early or late),
|
|
4
|
+
// 75, 90, 120, 144, 165, 180 and 240 Hz, and a 120 Hz display that misses
|
|
5
|
+
// frames. Without a cap every timestamp runs and is handed exactly what the
|
|
6
|
+
// loop computed before the cap existed. With one, no frame runs sooner than
|
|
7
|
+
// the threshold after the last, a display at the cap never skips, a faster one
|
|
8
|
+
// runs a whole number of refreshes per frame with one dt throughout, a
|
|
9
|
+
// missed refresh is not made up with a burst, and dt is the time since the
|
|
10
|
+
// last frame that ran -- never more than physics can step, so physics keeps
|
|
11
|
+
// the behaviours' time -- and a key pressed and let go, or a drag begun and
|
|
12
|
+
// ended (the orbit input's stick under the orbit camera key too), while frames
|
|
13
|
+
// were skipped is seen by the next frame that runs.
|
|
14
|
+
// Run by test-static-actors.mjs.
|
|
15
|
+
import assert from 'node:assert/strict';
|
|
16
|
+
import fs from 'node:fs';
|
|
17
|
+
import {
|
|
18
|
+
makeFrameClock,
|
|
19
|
+
makeInputLatch,
|
|
20
|
+
nextFrame,
|
|
21
|
+
updateLending,
|
|
22
|
+
MAX_CAPPED_DT,
|
|
23
|
+
RUN_SHARE,
|
|
24
|
+
} from '../engine3d/framecap.js';
|
|
25
|
+
import { attachOrbitInput, stickFrom } from '../engine3d/orbitinput.js';
|
|
26
|
+
|
|
27
|
+
let seed = 20261004;
|
|
28
|
+
function random() {
|
|
29
|
+
seed = (seed + 0x6d2b79f5) | 0;
|
|
30
|
+
let t = Math.imul(seed ^ (seed >>> 15), 1 | seed);
|
|
31
|
+
t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
|
|
32
|
+
return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
// Timestamps of a display at `hz`, each moved by up to `jitter` ms either way,
|
|
36
|
+
// and with each refresh missed with chance `miss`.
|
|
37
|
+
function display(hz, { frames = 2000, jitter = 0, miss = 0, start = 1000 } = {}) {
|
|
38
|
+
const out = [];
|
|
39
|
+
for (let i = 1; i <= frames; i++) {
|
|
40
|
+
if (miss && random() < miss) continue;
|
|
41
|
+
out.push(start + (i * 1000) / hz + (random() * 2 - 1) * jitter);
|
|
42
|
+
}
|
|
43
|
+
return out;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// The tick's clock over `stamps` with the cap `maxFps` (a number, or a
|
|
47
|
+
// function of the frame's index). Returns every frame's dt or null.
|
|
48
|
+
function drive(stamps, maxFps, start = 1000) {
|
|
49
|
+
const clock = makeFrameClock(start);
|
|
50
|
+
return stamps.map((now, i) => nextFrame(clock, now, typeof maxFps === 'function' ? maxFps(i) : maxFps));
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
// The frames that ran: their timestamp, the gap since the one before, dt.
|
|
54
|
+
function runs(stamps, dts, start = 1000) {
|
|
55
|
+
const out = [];
|
|
56
|
+
let last = start;
|
|
57
|
+
stamps.forEach((now, i) => {
|
|
58
|
+
if (dts[i] === null) return;
|
|
59
|
+
out.push({ i, now, gap: now - last, dt: dts[i] });
|
|
60
|
+
last = now;
|
|
61
|
+
});
|
|
62
|
+
return out;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
// What every frame with a cap must satisfy: none runs within the threshold of
|
|
66
|
+
// the last (the first a clock sees excepted), every one that comes later
|
|
67
|
+
// runs, and dt is the time since the last that ran.
|
|
68
|
+
function holds(stamps, dts, maxFps, what) {
|
|
69
|
+
const threshold = (RUN_SHARE * 1000) / maxFps;
|
|
70
|
+
let last = 1000;
|
|
71
|
+
stamps.forEach((now, i) => {
|
|
72
|
+
const gap = now - last;
|
|
73
|
+
if (i > 0) assert.equal(dts[i] !== null, gap >= threshold, `${what}: frame ${i} at ${gap.toFixed(3)} ms`);
|
|
74
|
+
if (dts[i] === null) return;
|
|
75
|
+
assert.equal(dts[i], Math.min(MAX_CAPPED_DT, gap / 1000), `${what}: dt of frame ${i}`);
|
|
76
|
+
last = now;
|
|
77
|
+
});
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
// The gaps of the frames that ran after the first, rounded to 0.01 ms.
|
|
81
|
+
const gaps = (list) => [...new Set(list.slice(1).map((r) => r.gap.toFixed(2)))];
|
|
82
|
+
|
|
83
|
+
export function run() {
|
|
84
|
+
let cases = 0;
|
|
85
|
+
|
|
86
|
+
// No cap: every timestamp runs, handed main's dt bit for bit -- uneven,
|
|
87
|
+
// missed, early (a timestamp before the clock started) and long-paused.
|
|
88
|
+
for (const maxFps of [0, undefined, null]) {
|
|
89
|
+
const stamps = [999.2, ...display(120, { jitter: 3, miss: 0.2 }), 90000, 90001.5, ...display(60, { start: 90001.5 })];
|
|
90
|
+
const dts = drive(stamps, maxFps);
|
|
91
|
+
let previousTime = 1000;
|
|
92
|
+
stamps.forEach((now, i) => {
|
|
93
|
+
const main = Math.min(0.033, (now - previousTime) / 1000);
|
|
94
|
+
previousTime = now;
|
|
95
|
+
assert.ok(Object.is(dts[i], main), `no cap: frame ${i} ${dts[i]} vs ${main}`);
|
|
96
|
+
});
|
|
97
|
+
cases += 1;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
// A 60 Hz display under a 60 cap never skips, its timestamps up to 1.5 ms
|
|
101
|
+
// early or late at random and alternately as early and as late as that.
|
|
102
|
+
const sixty = display(60, { frames: 20000, jitter: 1.5 });
|
|
103
|
+
const worst = display(60, { frames: 2000 }).map((t, i) => t + (i % 2 ? 1.5 : -1.5));
|
|
104
|
+
for (const stamps of [sixty, worst, display(59.94), display(60.5)]) {
|
|
105
|
+
const dts = drive(stamps, 60);
|
|
106
|
+
assert.ok(dts.every((dt) => dt !== null), '60 Hz runs every refresh');
|
|
107
|
+
holds(stamps, dts, 60, '60 Hz');
|
|
108
|
+
cases += 1;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
// Faster displays: a whole number of refreshes per frame, one gap.
|
|
112
|
+
const cadence = {};
|
|
113
|
+
for (const [hz, every, jitter] of [
|
|
114
|
+
[75, 1, 0.15],
|
|
115
|
+
[90, 2, 0.5],
|
|
116
|
+
[120, 2, 1.5],
|
|
117
|
+
[144, 2, 0.4],
|
|
118
|
+
[165, 3, 0.3],
|
|
119
|
+
[180, 3, 0.5],
|
|
120
|
+
[240, 4, 0.15],
|
|
121
|
+
]) {
|
|
122
|
+
for (const j of [0, jitter]) {
|
|
123
|
+
const stamps = display(hz, { jitter: j });
|
|
124
|
+
const dts = drive(stamps, 60);
|
|
125
|
+
holds(stamps, dts, 60, `${hz} Hz`);
|
|
126
|
+
const ran = runs(stamps, dts);
|
|
127
|
+
ran.slice(1).forEach((r, k) => assert.equal(r.i - ran[k].i, every, `${hz} Hz runs every ${every} refreshes`));
|
|
128
|
+
if (!j) {
|
|
129
|
+
assert.equal(gaps(ran).length, 1, `${hz} Hz has one gap: ${gaps(ran)}`);
|
|
130
|
+
cadence[hz] = Math.round((1000 * every) / hz);
|
|
131
|
+
}
|
|
132
|
+
cases += 1;
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
assert.deepEqual(cadence, { 75: 13, 90: 22, 120: 17, 144: 14, 165: 18, 180: 17, 240: 17 });
|
|
136
|
+
const steady = runs(display(120), drive(display(120), 60));
|
|
137
|
+
assert.ok(steady.slice(1).every((r) => Math.abs(r.dt - 1 / 60) < 1e-9), '120 Hz: every dt is 16.7 ms');
|
|
138
|
+
|
|
139
|
+
// A 120 Hz display that misses refreshes: no frame within the threshold of
|
|
140
|
+
// the last, so the frame after a long gap is not followed by a short one.
|
|
141
|
+
const missing = display(120, { frames: 20000, miss: 0.15, jitter: 0.5 });
|
|
142
|
+
const missed = drive(missing, 60);
|
|
143
|
+
holds(missing, missed, 60, '120 Hz missing');
|
|
144
|
+
const ran = runs(missing, missed);
|
|
145
|
+
assert.ok(ran.slice(1).every((r) => r.gap >= 13), 'no burst after a miss');
|
|
146
|
+
assert.ok(
|
|
147
|
+
ran.some((r) => r.gap > 20),
|
|
148
|
+
'some frames cover a missed refresh',
|
|
149
|
+
);
|
|
150
|
+
cases += 1;
|
|
151
|
+
|
|
152
|
+
// Every cap in range, on every display: the rule holds.
|
|
153
|
+
for (const maxFps of [30, 45, 60, 72, 90, 120, 144, 240]) {
|
|
154
|
+
for (const hz of [30, 60, 90, 120, 144, 240]) {
|
|
155
|
+
const stamps = display(hz, { frames: 600, jitter: 0.5, miss: 0.05 });
|
|
156
|
+
holds(stamps, drive(stamps, maxFps), maxFps, `${maxFps} cap at ${hz} Hz`);
|
|
157
|
+
cases += 1;
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
// The cap goes off with the scene that asked: from that frame on, every
|
|
162
|
+
// timestamp runs with main's dt; and on again with the next scene that asks.
|
|
163
|
+
const stamps = display(120, { frames: 300 });
|
|
164
|
+
const dts = drive(stamps, (i) => (i < 100 || i >= 200 ? 60 : 0));
|
|
165
|
+
assert.ok(dts.slice(100, 200).every((dt) => dt !== null), 'off at once');
|
|
166
|
+
// (The first of them is handed the time since the last frame that ran.)
|
|
167
|
+
const lastRan = dts[99] === null ? 98 : 99;
|
|
168
|
+
assert.equal(dts[100], Math.min(0.033, (stamps[100] - stamps[lastRan]) / 1000));
|
|
169
|
+
assert.ok(dts.slice(101, 200).every((dt, k) => dt === Math.min(0.033, (stamps[101 + k] - stamps[100 + k]) / 1000)));
|
|
170
|
+
assert.equal(dts.slice(200).filter((dt) => dt === null).length, 50, 'on again');
|
|
171
|
+
cases += 1;
|
|
172
|
+
|
|
173
|
+
// The first frame a clock sees runs, however soon.
|
|
174
|
+
assert.notEqual(drive([1000.5], 60)[0], null);
|
|
175
|
+
// The lowest cap is handed its whole interval, not cut at 0.033 s.
|
|
176
|
+
assert.ok(Math.abs(drive(display(60, { frames: 8 }), 30)[2] - 1 / 30) < 1e-9);
|
|
177
|
+
cases += 2;
|
|
178
|
+
cases += physicsKeepsTime();
|
|
179
|
+
cases += inputIsLent();
|
|
180
|
+
cases += orbitStickIsLent();
|
|
181
|
+
return cases;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
// Physics steps what it is handed in fixed steps, at most so many a frame,
|
|
185
|
+
// dropping what is left after the last (`systems/physics3d.js`, read here so
|
|
186
|
+
// a change there is seen). Behaviour time and physics time must stay within
|
|
187
|
+
// the one step physics carries, whatever the frames are, at the lowest cap.
|
|
188
|
+
function physicsKeepsTime() {
|
|
189
|
+
const source = fs.readFileSync(new URL('../systems/physics3d.js', import.meta.url), 'utf8');
|
|
190
|
+
assert.match(source, /const FIXED_STEP = 1 \/ 60;/);
|
|
191
|
+
assert.match(source, /const MAX_STEPS_PER_FRAME = 4;/);
|
|
192
|
+
assert.match(source, /if \(steps === MAX_STEPS_PER_FRAME\) this\.acc = 0;/);
|
|
193
|
+
const FIXED_STEP = 1 / 60;
|
|
194
|
+
const step = (sim, dt) => {
|
|
195
|
+
sim.acc += dt;
|
|
196
|
+
let steps = 0;
|
|
197
|
+
while (sim.acc >= FIXED_STEP && steps < 4) {
|
|
198
|
+
sim.acc -= FIXED_STEP;
|
|
199
|
+
steps += 1;
|
|
200
|
+
}
|
|
201
|
+
if (steps === 4) sim.acc = 0;
|
|
202
|
+
sim.physics += steps * FIXED_STEP;
|
|
203
|
+
sim.behaviour += dt;
|
|
204
|
+
};
|
|
205
|
+
let cases = 0;
|
|
206
|
+
const slow = [display(20), display(24), display(30, { jitter: 4 }), display(60, { miss: 0.7 })];
|
|
207
|
+
const ragged = [];
|
|
208
|
+
for (let t = 1000, i = 0; i < 3000; i++) ragged.push((t += 15 + random() * 235));
|
|
209
|
+
for (const stamps of [...slow, ragged]) {
|
|
210
|
+
for (const maxFps of [30, 0]) {
|
|
211
|
+
const sim = { acc: 0, physics: 0, behaviour: 0 };
|
|
212
|
+
for (const dt of drive(stamps, maxFps)) {
|
|
213
|
+
if (dt === null) continue;
|
|
214
|
+
step(sim, dt);
|
|
215
|
+
const behind = sim.behaviour - sim.physics;
|
|
216
|
+
assert.ok(behind > -1e-9 && behind < FIXED_STEP + 1e-9, `physics keeps time (cap ${maxFps}): ${behind}`);
|
|
217
|
+
}
|
|
218
|
+
assert.ok(sim.behaviour > 10, 'the run is long');
|
|
219
|
+
cases += 1;
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
return cases;
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
// Input under the cap, as Scene3DPlayer's handlers and tick do it: a key
|
|
226
|
+
// handler keeps `runtime.keys` (held) and, under a cap only, the latch; the
|
|
227
|
+
// tick runs a capped frame with `updateLending`, an uncapped one with
|
|
228
|
+
// `runtime.update`. Events are given as [ms, kind, value].
|
|
229
|
+
function play(stamps, events, maxFps, { throwAt = -1 } = {}) {
|
|
230
|
+
const move = { x: 0, y: 0, active: false };
|
|
231
|
+
const seen = [];
|
|
232
|
+
const runtime = {
|
|
233
|
+
maxFps,
|
|
234
|
+
keys: new Set(),
|
|
235
|
+
moveInput: move,
|
|
236
|
+
update(dt) {
|
|
237
|
+
seen.push({ keys: [...this.keys].sort(), stick: move.active ? [move.x, move.y] : null, dt });
|
|
238
|
+
if (seen.length - 1 === throwAt) throw new Error('update threw');
|
|
239
|
+
},
|
|
240
|
+
};
|
|
241
|
+
const latch = makeInputLatch();
|
|
242
|
+
const clock = makeFrameClock(stamps[0] - 1);
|
|
243
|
+
const queue = [...events].sort((a, b) => a[0] - b[0]);
|
|
244
|
+
const after = [];
|
|
245
|
+
for (const now of stamps) {
|
|
246
|
+
while (queue.length && queue[0][0] < now) {
|
|
247
|
+
const [, kind, value] = queue.shift();
|
|
248
|
+
if (kind === 'down' || kind === 'repeat') {
|
|
249
|
+
// As Scene3DPlayer's handler: an auto-repeat keydown is held, not noted.
|
|
250
|
+
runtime.keys.add(value);
|
|
251
|
+
if (runtime.maxFps > 0 && kind === 'down') latch.keys.add(value);
|
|
252
|
+
} else if (kind === 'up') {
|
|
253
|
+
runtime.keys.delete(value);
|
|
254
|
+
} else if (kind === 'drag') {
|
|
255
|
+
move.active = true;
|
|
256
|
+
[move.x, move.y] = value;
|
|
257
|
+
if (runtime.maxFps > 0) latch.stick = { x: move.x, y: move.y };
|
|
258
|
+
} else if (kind === 'lift') {
|
|
259
|
+
move.active = false;
|
|
260
|
+
move.x = 0;
|
|
261
|
+
move.y = 0;
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
if (runtime.maxFps === 0) assert.ok(latch.keys.size === 0 && latch.stick === null, 'nothing is latched without a cap');
|
|
265
|
+
const dt = nextFrame(clock, now, runtime.maxFps);
|
|
266
|
+
if (dt === null) continue;
|
|
267
|
+
try {
|
|
268
|
+
if (runtime.maxFps > 0) updateLending(runtime, latch, dt);
|
|
269
|
+
else runtime.update(dt);
|
|
270
|
+
} catch {
|
|
271
|
+
// the loop stops on a throw; what matters is what it left behind
|
|
272
|
+
}
|
|
273
|
+
after.push({ keys: [...runtime.keys].sort(), stick: move.active ? [move.x, move.y] : null });
|
|
274
|
+
}
|
|
275
|
+
return { seen, after };
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
function inputIsLent() {
|
|
279
|
+
let cases = 0;
|
|
280
|
+
const hz120 = Array.from({ length: 40 }, (_, i) => 1000 + (i * 1000) / 120);
|
|
281
|
+
const at = (ms) => 1000 + ms;
|
|
282
|
+
// Space down at 4 ms, up at 12 ms: the 8.3 ms frame sees it without the
|
|
283
|
+
// cap; with it, that frame is skipped and the 16.7 ms frame sees it, once.
|
|
284
|
+
const tap = [[at(4), 'down', 'Space'], [at(12), 'up', 'Space']];
|
|
285
|
+
const plain = play(hz120, tap, 0);
|
|
286
|
+
assert.deepEqual(plain.seen.map((f) => f.keys.join()).slice(0, 3), ['', 'Space', '']);
|
|
287
|
+
const capped = play(hz120, tap, 60);
|
|
288
|
+
assert.deepEqual(capped.seen.map((f) => f.keys.join()).slice(0, 3), ['', 'Space', ''], 'seen by the next frame that runs');
|
|
289
|
+
assert.ok(capped.after.every((f) => f.keys.length === 0), 'and taken back after it');
|
|
290
|
+
cases += 1;
|
|
291
|
+
// Held across skipped frames: held in every frame, never taken out.
|
|
292
|
+
const held = play(hz120, [[at(4), 'down', 'KeyW'], [at(200), 'up', 'KeyW']], 60);
|
|
293
|
+
assert.ok(held.seen.slice(1, 12).every((f) => f.keys.join() === 'KeyW'));
|
|
294
|
+
assert.ok(held.after.slice(1, 12).every((f) => f.keys.join() === 'KeyW'), 'a held key stays held');
|
|
295
|
+
cases += 1;
|
|
296
|
+
// A drag begun and ended between two frames that run: its last direction,
|
|
297
|
+
// for one frame, then the stick at rest. One still held is its own.
|
|
298
|
+
const flick = play(hz120, [[at(2), 'drag', [0.1, -0.5]], [at(6), 'drag', [0.2, -0.9]], [at(12), 'lift']], 60);
|
|
299
|
+
assert.deepEqual(flick.seen.slice(0, 3).map((f) => f.stick), [null, [0.2, -0.9], null]);
|
|
300
|
+
assert.ok(flick.after.every((f) => f.stick === null));
|
|
301
|
+
const drag = play(hz120, [[at(2), 'drag', [0.1, -0.5]], [at(20), 'drag', [0.3, 0.3]]], 60);
|
|
302
|
+
assert.deepEqual(drag.seen.slice(1, 3).map((f) => f.stick), [[0.1, -0.5], [0.3, 0.3]]);
|
|
303
|
+
cases += 1;
|
|
304
|
+
// Auto-repeat after a frame has seen the press is not a new press: released
|
|
305
|
+
// before the next frame that runs, it is not lent back.
|
|
306
|
+
const repeat = play(hz120, [[at(4), 'down', 'Space'], [at(20), 'repeat', 'Space'], [at(24), 'up', 'Space']], 60);
|
|
307
|
+
assert.deepEqual(repeat.seen.slice(0, 3).map((f) => f.keys.join()), ['', 'Space', ''], 'a repeat does not replay the press');
|
|
308
|
+
cases += 1;
|
|
309
|
+
// An update that throws still gives back what it was lent.
|
|
310
|
+
const threw = play(hz120, tap, 60, { throwAt: 1 });
|
|
311
|
+
assert.deepEqual(threw.after[1].keys, []);
|
|
312
|
+
cases += 1;
|
|
313
|
+
// Random presses on a 120 Hz display that misses frames: every press is
|
|
314
|
+
// seen by a frame that runs, and a key is in a frame only if it is held
|
|
315
|
+
// then or went down since the frame before.
|
|
316
|
+
const stamps = display(120, { frames: 6000, miss: 0.1, jitter: 0.5 });
|
|
317
|
+
const presses = [];
|
|
318
|
+
for (let i = 0; i < 400; i++) {
|
|
319
|
+
const from = 1000 + random() * 48000;
|
|
320
|
+
const code = `Key${'ABCDEFGH'[i % 8]}${i}`;
|
|
321
|
+
presses.push({ code, from, to: from + 0.5 + random() * 30 });
|
|
322
|
+
}
|
|
323
|
+
const events = presses.flatMap((p) => [[p.from, 'down', p.code], [p.to, 'up', p.code]]);
|
|
324
|
+
const fuzz = play(stamps, events, 60);
|
|
325
|
+
const ranAt = [];
|
|
326
|
+
{
|
|
327
|
+
const clock = makeFrameClock(stamps[0] - 1);
|
|
328
|
+
for (const now of stamps) if (nextFrame(clock, now, 60) !== null) ranAt.push(now);
|
|
329
|
+
}
|
|
330
|
+
presses.forEach((p) => {
|
|
331
|
+
const frames = ranAt.map((now, k) => (fuzz.seen[k].keys.includes(p.code) ? k : -1)).filter((k) => k >= 0);
|
|
332
|
+
if (p.from >= ranAt[ranAt.length - 1]) return;
|
|
333
|
+
assert.ok(frames.length > 0, `press ${p.code} is seen`);
|
|
334
|
+
for (const k of frames) {
|
|
335
|
+
const heldThen = p.from < ranAt[k] && p.to >= ranAt[k];
|
|
336
|
+
const sinceLast = p.from < ranAt[k] && (k === 0 || p.from >= ranAt[k - 1]);
|
|
337
|
+
assert.ok(heldThen || sinceLast, `press ${p.code} only where it belongs`);
|
|
338
|
+
}
|
|
339
|
+
});
|
|
340
|
+
assert.ok(fuzz.after.every((f) => f.keys.every((code) => presses.some((p) => p.code === code))));
|
|
341
|
+
cases += 1;
|
|
342
|
+
return cases;
|
|
343
|
+
}
|
|
344
|
+
|
|
345
|
+
// Scene3DPlayer's own `attachInput`, cut out of the .jsx (it holds no JSX) as
|
|
346
|
+
// test-camera-orbit.mjs cuts it, run with the real orbit input, a stand-in
|
|
347
|
+
// canvas, window, document and clock.
|
|
348
|
+
function attachInputFromPlayer(clock) {
|
|
349
|
+
const source = fs.readFileSync(new URL('../engine3d/playerRun.js', import.meta.url), 'utf8');
|
|
350
|
+
const cut = source.slice(source.indexOf('function attachInput('), source.indexOf('\nfunction attachResize('));
|
|
351
|
+
assert.ok(cut.length > 1000 && cut.trimEnd().endsWith('\n}') && !/<[A-Za-z]/.test(cut), 'attachInput is cut out whole');
|
|
352
|
+
const target = () => {
|
|
353
|
+
const on = [];
|
|
354
|
+
return {
|
|
355
|
+
addEventListener: (type, fn) => on.push([type, fn]),
|
|
356
|
+
removeEventListener: (type, fn) => {
|
|
357
|
+
const i = on.findIndex(([t, f]) => t === type && f === fn);
|
|
358
|
+
if (i >= 0) on.splice(i, 1);
|
|
359
|
+
},
|
|
360
|
+
focus() {},
|
|
361
|
+
setPointerCapture() {},
|
|
362
|
+
getBoundingClientRect: () => ({ left: 100, top: 0, width: 800, height: 600 }),
|
|
363
|
+
fire(type, event) {
|
|
364
|
+
const e = { type, preventDefault() {}, stopPropagation() {}, ...event };
|
|
365
|
+
for (const [t, fn] of [...on]) if (t === type) fn(e);
|
|
366
|
+
},
|
|
367
|
+
};
|
|
368
|
+
};
|
|
369
|
+
const window = target();
|
|
370
|
+
window.parent = window;
|
|
371
|
+
const attachInput = new Function('attachOrbitInput', 'window', 'document', 'performance', `${cut}\nreturn attachInput;`)(
|
|
372
|
+
attachOrbitInput,
|
|
373
|
+
window,
|
|
374
|
+
{ hasFocus: () => true },
|
|
375
|
+
clock
|
|
376
|
+
);
|
|
377
|
+
return { canvas: target(), attachInput };
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
// The stick under the orbit camera key, which the orbit input writes: the
|
|
381
|
+
// real handlers and orbit input, frames run as the tick runs them. Events are
|
|
382
|
+
// [ms, type, x, y], fired as touch pointer 1.
|
|
383
|
+
function playOrbit(stamps, events, maxFps) {
|
|
384
|
+
const clock = { t: 0, now: () => clock.t };
|
|
385
|
+
const { canvas, attachInput } = attachInputFromPlayer(clock);
|
|
386
|
+
const seen = [];
|
|
387
|
+
const runtime = {
|
|
388
|
+
maxFps,
|
|
389
|
+
cameraControl: 'orbit',
|
|
390
|
+
keys: new Set(),
|
|
391
|
+
update(dt) {
|
|
392
|
+
const move = this.moveInput;
|
|
393
|
+
seen.push({ stick: move.active ? [move.x, move.y] : null, dt });
|
|
394
|
+
},
|
|
395
|
+
};
|
|
396
|
+
const latch = makeInputLatch();
|
|
397
|
+
const detach = attachInput(canvas, runtime, { debugLines: { visible: false } }, latch);
|
|
398
|
+
const frameClock = makeFrameClock(stamps[0] - 1);
|
|
399
|
+
const queue = [...events].sort((a, b) => a[0] - b[0]);
|
|
400
|
+
const after = [];
|
|
401
|
+
for (const now of stamps) {
|
|
402
|
+
while (queue.length && queue[0][0] < now) {
|
|
403
|
+
const [at, type, x, y] = queue.shift();
|
|
404
|
+
clock.t = at;
|
|
405
|
+
canvas.fire(type, { pointerId: 1, clientX: x, clientY: y, pointerType: 'touch', button: 0 });
|
|
406
|
+
}
|
|
407
|
+
if (!(runtime.maxFps > 0)) assert.ok(latch.keys.size === 0 && latch.stick === null, 'nothing is latched without a cap');
|
|
408
|
+
clock.t = now;
|
|
409
|
+
const dt = nextFrame(frameClock, now, runtime.maxFps);
|
|
410
|
+
if (dt === null) continue;
|
|
411
|
+
if (runtime.maxFps > 0) updateLending(runtime, latch, dt);
|
|
412
|
+
else runtime.update(dt);
|
|
413
|
+
const move = runtime.moveInput;
|
|
414
|
+
after.push({ stick: move.active ? [move.x, move.y] : null });
|
|
415
|
+
}
|
|
416
|
+
detach();
|
|
417
|
+
return { seen, after };
|
|
418
|
+
}
|
|
419
|
+
|
|
420
|
+
function orbitStickIsLent() {
|
|
421
|
+
let cases = 0;
|
|
422
|
+
const hz120 = Array.from({ length: 40 }, (_, i) => 1000 + (i * 1000) / 120);
|
|
423
|
+
const at = (ms) => 1000 + ms;
|
|
424
|
+
// A finger down on the left half (the stick's), past the tap slop and on,
|
|
425
|
+
// and up again, all before the 16.7 ms frame: under a cap of 60 the 8.3 ms
|
|
426
|
+
// frame that would have seen it is skipped.
|
|
427
|
+
const flick = [
|
|
428
|
+
[at(2), 'pointerdown', 200, 300],
|
|
429
|
+
[at(4), 'pointermove', 200, 250],
|
|
430
|
+
[at(6), 'pointermove', 230, 200],
|
|
431
|
+
[at(12), 'pointerup', 230, 200],
|
|
432
|
+
];
|
|
433
|
+
const last = stickFrom(30, -100, 56);
|
|
434
|
+
const capped = playOrbit(hz120, flick, 60);
|
|
435
|
+
assert.deepEqual(capped.seen.slice(0, 3).map((f) => f.stick), [null, [last.x, last.y], null], 'the orbit stick is lent to the next frame that runs');
|
|
436
|
+
assert.ok(capped.after.every((f) => f.stick === null), 'and is at rest after it');
|
|
437
|
+
cases += 1;
|
|
438
|
+
// Without a cap (0, or a runtime that never read the key) nothing is
|
|
439
|
+
// latched, and the 8.3 ms frame sees the drag held, as always.
|
|
440
|
+
for (const maxFps of [0, undefined]) {
|
|
441
|
+
const plain = playOrbit(hz120, flick, maxFps);
|
|
442
|
+
assert.deepEqual(plain.seen.slice(0, 3).map((f) => f.stick), [null, [last.x, last.y], null], `uncapped (${maxFps})`);
|
|
443
|
+
}
|
|
444
|
+
cases += 1;
|
|
445
|
+
// A drag held across frames under the cap is its own, never lent over.
|
|
446
|
+
const held = playOrbit(hz120, [[at(2), 'pointerdown', 200, 300], [at(4), 'pointermove', 200, 250], [at(30), 'pointermove', 230, 200]], 60);
|
|
447
|
+
const first = stickFrom(0, -50, 56);
|
|
448
|
+
assert.deepEqual(held.seen.slice(1, 3).map((f) => f.stick), [[first.x, first.y], [last.x, last.y]]);
|
|
449
|
+
assert.deepEqual(held.after.at(-1).stick, [last.x, last.y]);
|
|
450
|
+
cases += 1;
|
|
451
|
+
return cases;
|
|
452
|
+
}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
// Static actors under a parent that cannot freeze stay on the live walk.
|
|
2
|
+
// Their watches must survive unchanged frames: re-walking every child each
|
|
3
|
+
// frame cost a Town about 29% of a phone's main thread.
|
|
4
|
+
import assert from 'node:assert/strict';
|
|
5
|
+
import { side, frame, actor, frozen, node } from './frozen-statics-fixture.mjs';
|
|
6
|
+
import { FrozenStatics } from '../engine3d/frozenstatics.js';
|
|
7
|
+
|
|
8
|
+
let watches = 0;
|
|
9
|
+
const watch = FrozenStatics.prototype.watch;
|
|
10
|
+
FrozenStatics.prototype.watch = function (...args) { watches += 1; return watch.apply(this, args); };
|
|
11
|
+
|
|
12
|
+
const actors = [actor('holder', 0)];
|
|
13
|
+
for (let i = 0; i < 20; i++) actors.push(actor(`c${i}`, i));
|
|
14
|
+
const s = await side(frozen, false, { engine: frozen, ground: { none: true }, actors });
|
|
15
|
+
frame(s);
|
|
16
|
+
for (let i = 0; i < 20; i++) node(s, 'holder').add(node(s, `c${i}`));
|
|
17
|
+
for (let i = 0; i < 5; i++) frame(s);
|
|
18
|
+
const state = s.world.frozenStatics;
|
|
19
|
+
assert.ok(state.live.has(s.runtime.getActor('c0')), 'a child under an unfreezable parent stays live');
|
|
20
|
+
|
|
21
|
+
watches = 0;
|
|
22
|
+
for (let i = 0; i < 30; i++) frame(s);
|
|
23
|
+
assert.equal(watches, 0, 'unchanged live children keep their watches');
|
|
24
|
+
|
|
25
|
+
// A change still rewatches, and the change reaches the node.
|
|
26
|
+
s.runtime.getActor('c3').components.Transform.y = 4;
|
|
27
|
+
watches = 0;
|
|
28
|
+
frame(s); frame(s);
|
|
29
|
+
assert.ok(watches >= 1, 'a changed child is watched again');
|
|
30
|
+
assert.equal(node(s, 'c3').position.y, 4, 'the change is drawn');
|
|
31
|
+
|
|
32
|
+
// A descendant added under a live child is covered: its watch is rebuilt.
|
|
33
|
+
const marker = node(s, 'c5').clone(false);
|
|
34
|
+
marker.userData = {};
|
|
35
|
+
watches = 0;
|
|
36
|
+
node(s, 'c5').add(marker);
|
|
37
|
+
frame(s);
|
|
38
|
+
assert.ok(watches >= 1, 'a new descendant rewatches its actor');
|
|
39
|
+
assert.ok(state.records.get(s.runtime.getActor('c5')).objects.includes(marker), 'the new descendant is watched');
|
|
40
|
+
// A change noticed after this sync's take(), before the actor's own freeze:
|
|
41
|
+
// the stale watch must not be reused.
|
|
42
|
+
state.take();
|
|
43
|
+
const late = node(s, 'c7').clone(false);
|
|
44
|
+
late.userData = {};
|
|
45
|
+
node(s, 'c7').add(late);
|
|
46
|
+
state.freeze(s.runtime.getActor('c7'), s.world.nodes.get('c7'));
|
|
47
|
+
assert.ok(state.records.get(s.runtime.getActor('c7')).objects.includes(late), 'a change after take() rewatches');
|
|
48
|
+
frame(s);
|
|
49
|
+
console.log('frozen nested: live children keep watches; changes and new descendants rewatch');
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
// An old physics-2d must ignore the new scene key, including through public
|
|
2
|
+
// physics APIs. Keep the actual fixture's sibling modules when supplied.
|
|
3
|
+
import assert from 'node:assert/strict';
|
|
4
|
+
import { register } from 'node:module';
|
|
5
|
+
import { isAbsolute } from 'node:path';
|
|
6
|
+
import { pathToFileURL } from 'node:url';
|
|
7
|
+
import { DT, side, frame, same, close, frozen, writeFrame } from './frozen-statics-fixture.mjs';
|
|
8
|
+
const { SceneRuntime } = await import('../../physics-2d/engine/scene.js');
|
|
9
|
+
const { setLookEnabled } = await import('../engine3d/look.js');
|
|
10
|
+
|
|
11
|
+
class MaskedRuntime extends SceneRuntime {
|
|
12
|
+
load(sceneData) {
|
|
13
|
+
// Masking getters alone leaves the modern runtime's private observer and
|
|
14
|
+
// update queue active. Load without that implementation, then retain the
|
|
15
|
+
// original key so physics-3d still sees precisely the legacy scene data.
|
|
16
|
+
const engine = { ...sceneData.engine };
|
|
17
|
+
const legacyEngine = { ...engine };
|
|
18
|
+
delete legacyEngine.frozenStatics;
|
|
19
|
+
const result = super.load({ ...sceneData, engine: legacyEngine });
|
|
20
|
+
this.data.engine = engine;
|
|
21
|
+
return result;
|
|
22
|
+
}
|
|
23
|
+
get freezesStatics() { return undefined; }
|
|
24
|
+
get frozenActors() { return undefined; }
|
|
25
|
+
}
|
|
26
|
+
let Runtime = MaskedRuntime;
|
|
27
|
+
if (process.env.PHYSICS2D_SCENE) {
|
|
28
|
+
assert.ok(isAbsolute(process.env.PHYSICS2D_SCENE), 'PHYSICS2D_SCENE must be absolute');
|
|
29
|
+
const sceneURL = pathToFileURL(process.env.PHYSICS2D_SCENE).href;
|
|
30
|
+
// Published kit modules use extensionless relative imports too. Scope this
|
|
31
|
+
// resolver to the supplied kit, sharing only the existing bundler stubs.
|
|
32
|
+
register(`data:text/javascript,${encodeURIComponent(`
|
|
33
|
+
import { existsSync } from 'node:fs';
|
|
34
|
+
import { fileURLToPath } from 'node:url';
|
|
35
|
+
const repoEngine = ${JSON.stringify(new URL('../../physics-2d/engine/', import.meta.url).href)};
|
|
36
|
+
const root = ${JSON.stringify(new URL('../', sceneURL).href)};
|
|
37
|
+
export async function resolve(specifier, context, next) {
|
|
38
|
+
if (context.parentURL?.startsWith(root) && specifier.startsWith('.')) {
|
|
39
|
+
const stub = /^(?:\\.\\/)(files|systemRegistry|fonts)(?:\\.js)?$/.exec(specifier);
|
|
40
|
+
if (stub) return next(new URL(stub[1] + '.js', repoEngine).href, context);
|
|
41
|
+
|
|
42
|
+
const url = new URL(specifier, context.parentURL);
|
|
43
|
+
if (!/\\.(m?js|jsx|json)$/.test(url.pathname)) {
|
|
44
|
+
for (const ext of ['.js', '.jsx']) {
|
|
45
|
+
if (existsSync(fileURLToPath(url.href + ext))) return next(url.href + ext, context);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
return next(specifier, context);
|
|
50
|
+
}
|
|
51
|
+
`)}`);
|
|
52
|
+
({ SceneRuntime: Runtime } = await import(sceneURL));
|
|
53
|
+
}
|
|
54
|
+
const RAPIER = await import('../engine3d/rapier.js');
|
|
55
|
+
await RAPIER.init();
|
|
56
|
+
const withoutKey = { ...frozen };
|
|
57
|
+
delete withoutKey.frozenStatics;
|
|
58
|
+
let frames = 0;
|
|
59
|
+
function inert(s) {
|
|
60
|
+
assert.equal(s.runtime.freezesStatics, undefined);
|
|
61
|
+
assert.equal(s.runtime.frozenActors, undefined);
|
|
62
|
+
assert.equal(s.world.frozenStatics, undefined);
|
|
63
|
+
assert.equal(s.system.frozenPhysics, undefined);
|
|
64
|
+
assert.equal(Object.hasOwn(s.world, 'frozenStatics'), false);
|
|
65
|
+
assert.equal(Object.hasOwn(s.system, 'frozenPhysics'), false);
|
|
66
|
+
}
|
|
67
|
+
function compare(a, b, label) {
|
|
68
|
+
for (const s of [a, b]) assert.ok(s.runtime.physics3d.ready(), 'real Rapier initialized');
|
|
69
|
+
same(a, b, label);
|
|
70
|
+
assert.deepEqual(a.runtime.getActors().map(actor => actor.components.Transform),
|
|
71
|
+
b.runtime.getActors().map(actor => actor.components.Transform), `${label}: actor transforms`);
|
|
72
|
+
const physics = s => [...s.system.bodies].map(([id, entry]) => ({
|
|
73
|
+
id, velocity: { ...entry.body.linvel() }, angular: { ...entry.body.angvel() },
|
|
74
|
+
colliders: entry.body.numColliders(), enabled: entry.body.isEnabled(),
|
|
75
|
+
}));
|
|
76
|
+
assert.deepEqual(physics(a), physics(b), `${label}: physics state`);
|
|
77
|
+
inert(a); inert(b);
|
|
78
|
+
frames++;
|
|
79
|
+
}
|
|
80
|
+
// The complete writer sequence from test-frozen-statics, with the audit flag
|
|
81
|
+
// both off and on, and the editor/static opt-out world as well.
|
|
82
|
+
for (const mode of ['normal', 'audit', 'editor']) {
|
|
83
|
+
const a = await side(frozen, mode === 'audit', undefined, Runtime);
|
|
84
|
+
const b = await side(withoutKey, mode === 'audit', undefined, Runtime);
|
|
85
|
+
try {
|
|
86
|
+
for (const s of [a, b]) {
|
|
87
|
+
inert(s);
|
|
88
|
+
if (mode === 'editor') s.world.staticActorsOff = true;
|
|
89
|
+
}
|
|
90
|
+
for (let i = 0; i < 100; i++) {
|
|
91
|
+
for (const s of [a, b]) { writeFrame(s, i); frame(s, i % 3 === 0 ? DT / 2 : DT); }
|
|
92
|
+
compare(a, b, `${mode} writer frame ${i}`);
|
|
93
|
+
}
|
|
94
|
+
// bodyOf is the other entry point that can dereference frozenActors.
|
|
95
|
+
for (const s of [a, b]) {
|
|
96
|
+
const body = s.runtime.physics3d.bodyOf('dynamic');
|
|
97
|
+
assert.ok(body && typeof body.sleep === 'function', 'real Rapier body');
|
|
98
|
+
s.runtime.physics3d.setVelocity('dynamic', { x: 1, y: 0, z: 0 });
|
|
99
|
+
}
|
|
100
|
+
for (let i = 0; i < 5; i++) { frame(a); frame(b); compare(a, b, `${mode} velocity ${i}`); }
|
|
101
|
+
for (const s of [a, b]) s.runtime.physics3d.bodyOf('dynamic').sleep();
|
|
102
|
+
for (let i = 0; i < 20; i++) {
|
|
103
|
+
const dt = [DT / 2, DT / 4, DT * 2.5][i % 3];
|
|
104
|
+
frame(a, dt); frame(b, dt); compare(a, b, `${mode} sleep ${i}`);
|
|
105
|
+
}
|
|
106
|
+
for (const s of [a, b]) s.runtime.physics3d.applyImpulse('dynamic', { x: 1, y: 0, z: 0 });
|
|
107
|
+
for (let i = 0; i < 10; i++) { frame(a); frame(b); compare(a, b, `${mode} wake ${i}`); }
|
|
108
|
+
// Reload with the key still present, then remove it in the same world.
|
|
109
|
+
for (const removeKey of [false, true]) {
|
|
110
|
+
for (const s of [a, b]) {
|
|
111
|
+
const saved = s.runtime.serialize();
|
|
112
|
+
if (removeKey) delete saved.engine.frozenStatics;
|
|
113
|
+
s.runtime.load(saved);
|
|
114
|
+
}
|
|
115
|
+
for (let i = 0; i < 3; i++) { frame(a); frame(b); compare(a, b, `${mode} reload ${removeKey} ${i}`); }
|
|
116
|
+
}
|
|
117
|
+
} finally {
|
|
118
|
+
close(a); close(b);
|
|
119
|
+
inert(a); inert(b);
|
|
120
|
+
setLookEnabled(true);
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
console.log(`frozen statics legacy physics-2d (${process.env.PHYSICS2D_SCENE ? 'external' : 'masked'}): ${frames}-frame transform/sync/physics parity, writers, bodyOf, sleep/wake, reload, no frozen state passed`);
|