castle-web-cli 0.4.238 → 0.4.240
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.js +5 -1
- package/dist/api.d.ts +20 -0
- package/dist/api.js +57 -0
- package/dist/bundle.d.ts +38 -1
- package/dist/bundle.js +309 -13
- package/dist/castle-host/host.js +218 -11
- package/dist/castleJson.d.ts +10 -0
- package/dist/castleJson.js +46 -2
- package/dist/check.js +5 -2
- package/dist/devSessionServer.js +4 -1
- package/dist/devSessionStorage.d.ts +1 -0
- package/dist/devSessionStorage.js +32 -7
- package/dist/importOrder.d.ts +2 -0
- package/dist/importOrder.js +29 -0
- package/dist/index.js +22 -3
- package/dist/init.js +24 -2
- package/dist/multiplayerDoc.d.ts +1 -1
- package/dist/multiplayerDoc.js +9 -0
- package/dist/platformDoc.js +4 -2
- package/dist/playPagePolicy.d.ts +1 -0
- package/dist/playPagePolicy.js +12 -3
- package/dist/resetLeaderboards.d.ts +8 -1
- package/dist/resetLeaderboards.js +43 -8
- package/dist/roomLogs.d.ts +39 -0
- package/dist/roomLogs.js +166 -0
- package/dist/save-deck.d.ts +32 -2
- package/dist/save-deck.js +240 -39
- package/kits/base/CLAUDE.md +2 -1
- package/kits/base/castle.json +1 -1
- package/kits/base/sdk/README.md +240 -8
- package/kits/base/sdk/analytics.d.ts +8 -0
- package/kits/base/sdk/analytics.js +92 -0
- package/kits/base/sdk/castle.d.ts +8 -2
- package/kits/base/sdk/castle.js +3 -0
- package/kits/base/sdk/commands.d.ts +79 -0
- package/kits/base/sdk/commands.js +1 -0
- package/kits/base/sdk/debugConsole.d.ts +17 -0
- package/kits/base/sdk/debugConsole.js +154 -0
- package/kits/base/sdk/experiments.js +24 -1
- package/kits/base/sdk/hostRetry.d.ts +7 -0
- package/kits/base/sdk/hostRetry.js +57 -0
- package/kits/base/sdk/hub.d.ts +20 -2
- package/kits/base/sdk/hub.js +99 -13
- package/kits/base/sdk/multiplayer.d.ts +2 -0
- package/kits/base/sdk/multiplayer.js +198 -26
- package/kits/base/sdk/reconnectBudget.d.ts +6 -0
- package/kits/base/sdk/reconnectBudget.js +41 -1
- package/kits/base/sdk/rooms.d.ts +11 -0
- package/kits/base/sdk/rooms.js +22 -0
- package/kits/base/sdk/runtime.js +36 -19
- package/kits/base/sdk/server/hub.d.ts +19 -0
- package/kits/base/sdk/server/hub.js +12 -0
- package/kits/base/sdk/server/platformHandle.d.ts +1 -0
- package/kits/base/sdk/server/wrapper.d.ts +1 -1
- package/kits/base/sdk/server/wrapper.js +26 -1
- package/kits/base/sdk/store.d.ts +8 -2
- package/kits/base/sdk/store.js +5 -1
- package/kits/base/sdk/transport.d.ts +2 -1
- package/kits/base/sdk/transport.js +35 -0
- package/kits/hub-game/CLAUDE.md +66 -19
- package/kits/hub-game/castle.json +4 -4
- package/kits/hub-game/code/client/act.js +9 -6
- package/kits/hub-game/code/client/actCore.js +26 -6
- package/kits/hub-game/code/client/actGateLog.js +36 -0
- package/kits/hub-game/code/client/actionOverflow.js +29 -8
- package/kits/hub-game/code/client/actionRailSurface.js +186 -0
- package/kits/hub-game/code/client/actionRailTree.js +173 -0
- package/kits/hub-game/code/client/askSurface.js +85 -0
- package/kits/hub-game/code/client/askTree.js +51 -0
- package/kits/hub-game/code/client/attention.js +31 -6
- package/kits/hub-game/code/client/ballot.js +42 -5
- package/kits/hub-game/code/client/ballotSurface.js +115 -0
- package/kits/hub-game/code/client/ballotTree.js +180 -0
- package/kits/hub-game/code/client/catchingUp.js +19 -0
- package/kits/hub-game/code/client/celebrate.js +66 -0
- package/kits/hub-game/code/client/chrome.js +474 -53
- package/kits/hub-game/code/client/companion.js +93 -23
- package/kits/hub-game/code/client/companionDress.js +1 -1
- package/kits/hub-game/code/client/cornerSurface.js +106 -0
- package/kits/hub-game/code/client/cornerTree.js +83 -0
- package/kits/hub-game/code/client/decor.js +20 -11
- package/kits/hub-game/code/client/deviceStorage.js +121 -0
- package/kits/hub-game/code/client/disguise.js +23 -0
- package/kits/hub-game/code/client/disguiseDraw.js +87 -0
- package/kits/hub-game/code/client/dockSurface.js +206 -0
- package/kits/hub-game/code/client/dockTree.js +232 -0
- package/kits/hub-game/code/client/earned.js +29 -0
- package/kits/hub-game/code/client/emoteSurface.js +188 -0
- package/kits/hub-game/code/client/emoteTree.js +264 -0
- package/kits/hub-game/code/client/farAvatars.js +4 -3
- package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
- package/kits/hub-game/code/client/grab.js +121 -50
- package/kits/hub-game/code/client/holdShow.js +19 -0
- package/kits/hub-game/code/client/hookLayer.js +96 -12
- package/kits/hub-game/code/client/hubControls.js +7 -1
- package/kits/hub-game/code/client/hudSurface.js +11 -3
- package/kits/hub-game/code/client/hudTree.js +7 -4
- package/kits/hub-game/code/client/idle.js +21 -3
- package/kits/hub-game/code/client/invites.js +24 -3
- package/kits/hub-game/code/client/keys.js +15 -0
- package/kits/hub-game/code/client/labelsNear.js +8 -1
- package/kits/hub-game/code/client/layoutCache.js +57 -8
- package/kits/hub-game/code/client/loadingCover.js +53 -4
- package/kits/hub-game/code/client/menuIcons.js +15 -0
- package/kits/hub-game/code/client/menuRows.js +8 -2
- package/kits/hub-game/code/client/menuSurface.js +102 -0
- package/kits/hub-game/code/client/menuTree.js +135 -0
- package/kits/hub-game/code/client/modelLook.js +41 -0
- package/kits/hub-game/code/client/pickerSurface.js +152 -0
- package/kits/hub-game/code/client/pickerTree.js +163 -0
- package/kits/hub-game/code/client/pushVisit.js +4 -2
- package/kits/hub-game/code/client/quality.js +188 -29
- package/kits/hub-game/code/client/qualityEntry.js +10 -1
- package/kits/hub-game/code/client/quickChatSurface.js +222 -0
- package/kits/hub-game/code/client/quickChatTree.js +201 -0
- package/kits/hub-game/code/client/rehello.js +75 -0
- package/kits/hub-game/code/client/renderVisibility.js +17 -0
- package/kits/hub-game/code/client/replay.js +118 -0
- package/kits/hub-game/code/client/role.js +3 -0
- package/kits/hub-game/code/client/safeLayout.js +441 -56
- package/kits/hub-game/code/client/safeStyle.js +13 -10
- package/kits/hub-game/code/client/say.js +2 -0
- package/kits/hub-game/code/client/soundSurface.js +77 -0
- package/kits/hub-game/code/client/soundTree.js +74 -0
- package/kits/hub-game/code/client/soundscape.js +12 -9
- package/kits/hub-game/code/client/soundscapeCues.js +1 -1
- package/kits/hub-game/code/client/state.js +67 -1
- package/kits/hub-game/code/client/stuckSurface.js +76 -0
- package/kits/hub-game/code/client/stuckTree.js +67 -0
- package/kits/hub-game/code/client/talk.js +42 -12
- package/kits/hub-game/code/client/talkTree.js +4 -2
- package/kits/hub-game/code/client/textAskSurface.js +147 -0
- package/kits/hub-game/code/client/textAskTree.js +67 -0
- package/kits/hub-game/code/client/tiers.js +252 -27
- package/kits/hub-game/code/client/together.js +4 -1
- package/kits/hub-game/code/client/uiDom.js +86 -8
- package/kits/hub-game/code/client/uiTree.js +33 -4
- package/kits/hub-game/code/client/vehicle.js +75 -52
- package/kits/hub-game/code/client/weakestTier.js +75 -31
- package/kits/hub-game/code/client/wear.js +159 -5
- package/kits/hub-game/code/client/worldLabels.js +215 -26
- package/kits/hub-game/code/companionSpec.js +4 -2
- package/kits/hub-game/code/server/act.js +3 -0
- package/kits/hub-game/code/server/actGate.js +83 -0
- package/kits/hub-game/code/server/actions.js +71 -15
- package/kits/hub-game/code/server/actors.js +20 -5
- package/kits/hub-game/code/server/analytics.js +40 -15
- package/kits/hub-game/code/server/ask.js +39 -3
- package/kits/hub-game/code/server/ballot.js +167 -4
- package/kits/hub-game/code/server/celebrate.js +64 -0
- package/kits/hub-game/code/server/companion.js +17 -2
- package/kits/hub-game/code/server/decor.js +11 -2
- package/kits/hub-game/code/server/disguise.js +63 -0
- package/kits/hub-game/code/server/doorAnalytics.js +2 -5
- package/kits/hub-game/code/server/earned.js +6 -2
- package/kits/hub-game/code/server/friendBests.js +13 -4
- package/kits/hub-game/code/server/friendsAmong.js +67 -8
- package/kits/hub-game/code/server/grab.js +12 -2
- package/kits/hub-game/code/server/heldOffers.js +142 -0
- package/kits/hub-game/code/server/holdShow.js +98 -0
- package/kits/hub-game/code/server/hub.js +854 -45
- package/kits/hub-game/code/server/idle.js +110 -9
- package/kits/hub-game/code/server/index.js +9 -0
- package/kits/hub-game/code/server/labels.js +13 -3
- package/kits/hub-game/code/server/loadAbandon.js +2 -5
- package/kits/hub-game/code/server/manifest.js +94 -6
- package/kits/hub-game/code/server/menu.js +26 -3
- package/kits/hub-game/code/server/npcs.js +55 -9
- package/kits/hub-game/code/server/observe.js +67 -6
- package/kits/hub-game/code/server/players.js +8 -1
- package/kits/hub-game/code/server/replay.js +135 -0
- package/kits/hub-game/code/server/storageLimit.js +4 -1
- package/kits/hub-game/code/server/townDay.js +74 -0
- package/kits/hub-game/code/server/trackQueue.js +29 -0
- package/kits/hub-game/code/server/vehicle.js +3 -0
- package/kits/hub-game/code/server/vis.js +26 -4
- package/kits/hub-game/code/server/wallet.js +677 -0
- package/kits/hub-game/code/server/wear.js +13 -3
- package/kits/hub-game/code/server/writerLease.js +191 -0
- package/kits/hub-game/code/shared/act.js +1 -1
- package/kits/hub-game/code/shared/expression.js +6 -0
- package/kits/hub-game/code/shared/replay.js +37 -0
- package/kits/hub-game/code/systems/hub.js +437 -57
- package/kits/hub-game/docs/analytics.md +20 -3
- package/kits/hub-game/docs/contract.md +942 -99
- package/kits/hub-game/docs/home-pieces.md +5 -6
- package/kits/hub-game/docs/observed-progress.md +49 -1
- package/kits/hub-game/docs/vehicle-preset.md +23 -0
- package/kits/hub-game/index.html +1 -0
- package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
- package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
- package/kits/hub-game/models/hats/cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/captain.pxmodel +3 -3
- package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
- package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
- package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
- package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
- package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
- package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
- package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
- package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
- package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
- package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
- package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
- package/kits/hub-game/models/hats/straw.pxmodel +3 -3
- package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
- package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
- package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
- package/kits/hub-game/models/hats/witch.pxmodel +3 -3
- package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
- package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
- package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
- package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
- package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
- package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
- package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
- package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
- package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
- package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
- package/kits/hub-game/package-lock.json +3 -3
- package/kits/hub-game/package.json +4 -3
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
- package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
- package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
- package/kits/hub-game/scripts/gen-hats.mjs +1 -1
- package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
- package/kits/hub-game/scripts/pack.mjs +89 -23
- package/kits/hub-game/scripts/test-act-client.mjs +5 -0
- package/kits/hub-game/scripts/test-act-core.mjs +32 -0
- package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
- package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
- package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
- package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
- package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
- package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
- package/kits/hub-game/scripts/test-actions.mjs +24 -0
- package/kits/hub-game/scripts/test-actors.mjs +19 -0
- package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
- package/kits/hub-game/scripts/test-analytics.mjs +80 -1
- package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
- package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
- package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
- package/kits/hub-game/scripts/test-attention.mjs +43 -1
- package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
- package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
- package/kits/hub-game/scripts/test-ballot.mjs +420 -3
- package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
- package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
- package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
- package/kits/hub-game/scripts/test-chat.mjs +73 -0
- package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
- package/kits/hub-game/scripts/test-companion.mjs +110 -3
- package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
- package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
- package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
- package/kits/hub-game/scripts/test-decor.mjs +27 -0
- package/kits/hub-game/scripts/test-device-class.mjs +4 -1
- package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
- package/kits/hub-game/scripts/test-disguise.mjs +176 -0
- package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
- package/kits/hub-game/scripts/test-door-analytics.mjs +1 -1
- package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
- package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
- package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
- package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
- package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
- package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
- package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
- package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
- package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
- package/kits/hub-game/scripts/test-grab.mjs +10 -1
- package/kits/hub-game/scripts/test-hats.mjs +28 -0
- package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
- package/kits/hub-game/scripts/test-high-only.mjs +3 -3
- package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
- package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
- package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
- package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
- package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +147 -0
- package/kits/hub-game/scripts/test-hub-trip.mjs +260 -5
- package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
- package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
- package/kits/hub-game/scripts/test-idle.mjs +160 -0
- package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
- package/kits/hub-game/scripts/test-labels.mjs +11 -0
- package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
- package/kits/hub-game/scripts/test-load-abandon.mjs +2 -2
- package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
- package/kits/hub-game/scripts/test-manifest.mjs +27 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +55 -6
- package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
- package/kits/hub-game/scripts/test-npcs.mjs +128 -0
- package/kits/hub-game/scripts/test-observed.mjs +171 -3
- package/kits/hub-game/scripts/test-pack.mjs +166 -0
- package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
- package/kits/hub-game/scripts/test-placeat-server.mjs +395 -0
- package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
- package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
- package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
- package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
- package/kits/hub-game/scripts/test-quality.mjs +312 -9
- package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
- package/kits/hub-game/scripts/test-rehello.mjs +237 -0
- package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
- package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
- package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
- package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
- package/kits/hub-game/scripts/test-replay.mjs +178 -0
- package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
- package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
- package/kits/hub-game/scripts/test-resync.mjs +13 -0
- package/kits/hub-game/scripts/test-role-client.mjs +10 -3
- package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
- package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
- package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
- package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
- package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
- package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
- package/kits/hub-game/scripts/test-stuck.mjs +31 -0
- package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
- package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
- package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
- package/kits/hub-game/scripts/test-tiers.mjs +453 -3
- package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
- package/kits/hub-game/scripts/test-together.mjs +11 -0
- package/kits/hub-game/scripts/test-town-day.mjs +90 -0
- package/kits/hub-game/scripts/test-track-queue.mjs +64 -0
- package/kits/hub-game/scripts/test-try-on.mjs +39 -0
- package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
- package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
- package/kits/hub-game/scripts/test-vehicle-client.mjs +77 -1
- package/kits/hub-game/scripts/test-vis.mjs +145 -0
- package/kits/hub-game/scripts/test-wallet.mjs +650 -0
- package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
- package/kits/hub-game/scripts/test-world-labels.mjs +380 -0
- package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
- package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
- package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
- package/kits/hub-game/tools/hubScene/export.mjs +6 -5
- package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
- package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +48 -2
- package/kits/hub-game/tools/hubScene/validate-manifest.mjs +21 -3
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/resumeGate.js +49 -2
- package/kits/multiplayer-3d/code/server/ownership.js +25 -6
- package/kits/multiplayer-3d/code/server/world.js +19 -4
- package/kits/multiplayer-3d/code/systems/multiplayer.js +67 -11
- package/kits/multiplayer-3d/package-lock.json +1 -1
- package/kits/multiplayer-3d/package.json +2 -1
- package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
- package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
- package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
- package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +191 -5
- package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/scene.js +10 -2
- package/kits/physics-3d/CLAUDE.md +14 -0
- package/kits/physics-3d/behaviors/Player.jsx +39 -3
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/engine-model-cache.md +109 -0
- package/kits/physics-3d/docs/engine-player.md +76 -0
- package/kits/physics-3d/docs/engine-skip-work.md +16 -0
- package/kits/physics-3d/docs/pxmodel-format.md +5 -1
- package/kits/physics-3d/engine3d/gait.js +16 -8
- package/kits/physics-3d/engine3d/groundsize.js +23 -0
- package/kits/physics-3d/engine3d/kithooks.js +50 -0
- package/kits/physics-3d/engine3d/look.js +110 -17
- package/kits/physics-3d/engine3d/lookbake.js +19 -1
- package/kits/physics-3d/engine3d/materialpresets.js +3 -2
- package/kits/physics-3d/engine3d/modelcache.js +280 -0
- package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
- package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
- package/kits/physics-3d/engine3d/modelrefs.js +13 -0
- package/kits/physics-3d/engine3d/optimize.js +20 -9
- package/kits/physics-3d/engine3d/playerRun.js +26 -1
- package/kits/physics-3d/engine3d/pxmodel.js +7 -3
- package/kits/physics-3d/engine3d/templatecache.js +722 -0
- package/kits/physics-3d/engine3d/world3d.js +211 -17
- package/kits/physics-3d/package-lock.json +1 -1
- package/kits/physics-3d/package.json +2 -1
- package/kits/physics-3d/play/behaviors/Player.js +43 -3
- package/kits/physics-3d/scripts/render.mjs +56 -8
- package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
- package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
- package/kits/physics-3d/scripts/test-gait.mjs +53 -9
- package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
- package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
- package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
- package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
- package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
- package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
- package/kits/physics-3d/systems/physics3d.js +51 -2
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/client/connection.js +3 -0
- package/package.json +2 -2
- package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
|
@@ -9,6 +9,7 @@
|
|
|
9
9
|
|
|
10
10
|
import * as THREE from 'three';
|
|
11
11
|
import { parseModelCached, buildModelNode, modelArtSignature } from './pxmodel';
|
|
12
|
+
import { partArtRefs } from './artobjects';
|
|
12
13
|
|
|
13
14
|
// References nest at most this deep: a model, a part of it, a part of that.
|
|
14
15
|
export const MAX_MODEL_DEPTH = 4;
|
|
@@ -118,3 +119,15 @@ export function modelRefSignature(model, sprites, models, path = '') {
|
|
|
118
119
|
}
|
|
119
120
|
return out.join('|');
|
|
120
121
|
}
|
|
122
|
+
|
|
123
|
+
// Capture-only: even unresolved art makes a template unsuitable for the byte
|
|
124
|
+
// cache. Use the builder's same path, cycle and depth rules for references.
|
|
125
|
+
export function modelRequestsArt(model, models, chain) {
|
|
126
|
+
if (model.parts.some((part) => partArtRefs(part).length > 0)) return true;
|
|
127
|
+
for (const part of model.parts) {
|
|
128
|
+
if (part.kind !== 'model') continue;
|
|
129
|
+
const found = referencedModel(part, models, chain);
|
|
130
|
+
if (found && modelRequestsArt(found.model, models, [...chain, found.path])) return true;
|
|
131
|
+
}
|
|
132
|
+
return false;
|
|
133
|
+
}
|
|
@@ -16,8 +16,8 @@
|
|
|
16
16
|
|
|
17
17
|
import * as THREE from 'three';
|
|
18
18
|
import { mergeGeometries } from 'three/examples/jsm/utils/BufferGeometryUtils.js';
|
|
19
|
-
import { outlinePartByPart, outlineMergedLater } from './look';
|
|
20
|
-
import { markKitHooks } from './kithooks';
|
|
19
|
+
import { outlinePartByPart, outlineMergedLater, OutlineMesh } from './look';
|
|
20
|
+
import { markKitHooks, recordTemplateHook, templateCaptureActive } from './kithooks';
|
|
21
21
|
|
|
22
22
|
// Meters per screen pixel under the third-person camera, and under the far
|
|
23
23
|
// overhead camera of the space decks.
|
|
@@ -610,7 +610,7 @@ function instancedCopy(anchor, copies) {
|
|
|
610
610
|
instanced.userData = { ...first.userData };
|
|
611
611
|
instanced.computeBoundingSphere();
|
|
612
612
|
if (first.userData.lookOutline) {
|
|
613
|
-
instanced.raycast =
|
|
613
|
+
instanced.raycast = OutlineMesh.prototype.raycast;
|
|
614
614
|
}
|
|
615
615
|
return instanced;
|
|
616
616
|
}
|
|
@@ -676,7 +676,7 @@ varying vec2 vPartFinish;
|
|
|
676
676
|
|
|
677
677
|
// The material reads roughness and metalness from each vertex, so parts
|
|
678
678
|
// that differ only in those draw in one call.
|
|
679
|
-
function finishFromVertices(material) {
|
|
679
|
+
export function finishFromVertices(material) {
|
|
680
680
|
const previous = material.onBeforeCompile;
|
|
681
681
|
const previousKey = material.customProgramCacheKey;
|
|
682
682
|
material.onBeforeCompile = (shader, renderer) => {
|
|
@@ -693,6 +693,7 @@ function finishFromVertices(material) {
|
|
|
693
693
|
};
|
|
694
694
|
material.customProgramCacheKey = () => `part-finish|${previousKey.call(material)}`;
|
|
695
695
|
markKitHooks(material, previous, previousKey);
|
|
696
|
+
if (templateCaptureActive) recordTemplateHook(material, { kind: 'finish' }, previous, previousKey);
|
|
696
697
|
}
|
|
697
698
|
|
|
698
699
|
//
|
|
@@ -896,16 +897,26 @@ export function takeModel(cache, key, build) {
|
|
|
896
897
|
return entry.template;
|
|
897
898
|
}
|
|
898
899
|
|
|
899
|
-
// Gives back one actor's use
|
|
900
|
-
|
|
900
|
+
// Gives back one actor's use. Sleeping actors park the last user's build at
|
|
901
|
+
// zero users; takeModel reuses it on wake. Other releases still dispose it.
|
|
902
|
+
export function releaseModel(cache, key, dispose, park = false) {
|
|
901
903
|
const entry = cache.get(key);
|
|
902
904
|
if (!entry) {
|
|
903
905
|
return;
|
|
904
906
|
}
|
|
905
|
-
entry.users
|
|
906
|
-
if (entry.users
|
|
907
|
+
entry.users = Math.max(0, entry.users - 1);
|
|
908
|
+
if (entry.users === 0 && !park) {
|
|
909
|
+
cache.delete(key);
|
|
907
910
|
dispose(entry.template);
|
|
911
|
+
}
|
|
912
|
+
}
|
|
913
|
+
|
|
914
|
+
// Clear only unowned templates: live and resident-scene users retain theirs.
|
|
915
|
+
export function disposeParkedModels(cache, dispose) {
|
|
916
|
+
for (const [key, entry] of cache) {
|
|
917
|
+
if (entry.users !== 0) continue;
|
|
908
918
|
cache.delete(key);
|
|
919
|
+
dispose(entry.template);
|
|
909
920
|
}
|
|
910
921
|
}
|
|
911
922
|
|
|
@@ -1086,7 +1097,7 @@ function replaceInstancedMesh(scene, part) {
|
|
|
1086
1097
|
mesh.receiveShadow = source.receiveShadow;
|
|
1087
1098
|
mesh.frustumCulled = false;
|
|
1088
1099
|
mesh.userData.lookOutline = source.userData.lookOutline;
|
|
1089
|
-
mesh.raycast =
|
|
1100
|
+
mesh.raycast = OutlineMesh.prototype.raycast;
|
|
1090
1101
|
part.mesh = mesh;
|
|
1091
1102
|
scene.add(mesh);
|
|
1092
1103
|
}
|
|
@@ -14,6 +14,7 @@ import { renderHidingOwnModel } from './ownmodel';
|
|
|
14
14
|
import { makeFrameClock, makeInputLatch, nextFrame, updateLending } from './framecap';
|
|
15
15
|
import { prepareModelConsumers } from './modelready.js';
|
|
16
16
|
import { lowMemoryDevice } from './memoryprofile.js';
|
|
17
|
+
import { readModelCacheKey, preloadModelCache, modelCacheVisitReady } from './modelcachegate';
|
|
17
18
|
|
|
18
19
|
export function mountScene3D({
|
|
19
20
|
canvas,
|
|
@@ -55,7 +56,7 @@ export function mountScene3D({
|
|
|
55
56
|
const latch = makeInputLatch();
|
|
56
57
|
const detachInput = attachInput(canvas, runtime, world, latch);
|
|
57
58
|
const stopResize = attachResize(canvas, world);
|
|
58
|
-
const stopLoop = startLoop(
|
|
59
|
+
const stopLoop = (readModelCacheKey(runtime.data) ? startLoopAfterModelCache : startLoop)(
|
|
59
60
|
runtime,
|
|
60
61
|
world,
|
|
61
62
|
sprites,
|
|
@@ -74,6 +75,19 @@ export function mountScene3D({
|
|
|
74
75
|
};
|
|
75
76
|
}
|
|
76
77
|
|
|
78
|
+
// The mount cleanup stays synchronous, but opted-in play cannot update or
|
|
79
|
+
// synchronize a model until the one scene blob has read (or timed out).
|
|
80
|
+
function startLoopAfterModelCache(runtime, world, ...args) {
|
|
81
|
+
let alive = true;
|
|
82
|
+
let stop;
|
|
83
|
+
const ready = preloadModelCache(world, runtime);
|
|
84
|
+
if (!ready) return startLoop(runtime, world, ...args);
|
|
85
|
+
ready.then(() => {
|
|
86
|
+
if (alive) stop = startLoop(runtime, world, ...args);
|
|
87
|
+
});
|
|
88
|
+
return () => { alive = false; stop?.(); };
|
|
89
|
+
}
|
|
90
|
+
|
|
77
91
|
function attachInput(canvas, runtime, world, latch) {
|
|
78
92
|
const onKeyDown = (event) => {
|
|
79
93
|
// Space is gameplay (jump); keep it from scrolling the page.
|
|
@@ -245,6 +259,10 @@ function startLoop(runtime, world, sprites, hudRefs, onFirstFrame, onError, latc
|
|
|
245
259
|
const clock = makeFrameClock(performance.now());
|
|
246
260
|
let firstFrameSignaled = false;
|
|
247
261
|
const tick = (now) => {
|
|
262
|
+
if ((world.modelCache || runtime.data?.engine?.modelCache) && !modelCacheVisitReady(world, runtime)) {
|
|
263
|
+
raf = requestAnimationFrame(tick);
|
|
264
|
+
return;
|
|
265
|
+
}
|
|
248
266
|
// A scene that set `engine.maxFps` skips an animation frame that comes
|
|
249
267
|
// too soon after the last frame that ran (`framecap.js`); without it
|
|
250
268
|
// every animation frame runs, handed what it always was.
|
|
@@ -281,6 +299,12 @@ function startLoop(runtime, world, sprites, hudRefs, onFirstFrame, onError, latc
|
|
|
281
299
|
runtime.currentScenePath = next;
|
|
282
300
|
runtime.persistent.sceneChangeGraceUntil = runtime.time + 1;
|
|
283
301
|
}
|
|
302
|
+
// A behavior can switch scenes during update, including a direct
|
|
303
|
+
// loadFromFile. Preload that visit before its first model sync as well.
|
|
304
|
+
if ((world.modelCache || runtime.data?.engine?.modelCache) && !modelCacheVisitReady(world, runtime)) {
|
|
305
|
+
raf = requestAnimationFrame(tick);
|
|
306
|
+
return;
|
|
307
|
+
}
|
|
284
308
|
stage?.('scene-build:start');
|
|
285
309
|
syncActors(world, runtime, runtime.sprites ?? sprites, dt);
|
|
286
310
|
stage?.('scene-build:end');
|
|
@@ -293,6 +317,7 @@ function startLoop(runtime, world, sprites, hudRefs, onFirstFrame, onError, latc
|
|
|
293
317
|
if (runtime.orbitOwnModel !== undefined) renderHidingOwnModel(world, runtime, renderWorld);
|
|
294
318
|
else renderWorld(world, runtime);
|
|
295
319
|
stage?.('first-render:end');
|
|
320
|
+
if (world.modelCache) world.modelCache.afterFrame();
|
|
296
321
|
updateHud(runtime, hudRefs);
|
|
297
322
|
} catch (err) {
|
|
298
323
|
onError?.(err);
|
|
@@ -12,7 +12,8 @@ import { repeatAlong } from './paths';
|
|
|
12
12
|
import { applySurfaceDetail, hasSurfaceDetail } from './surfacedetail';
|
|
13
13
|
import { applyPaint, hasPaint } from './paint';
|
|
14
14
|
import { applyMaterialPreset } from './materialpresets';
|
|
15
|
-
import { buildModelRef } from './modelrefs';
|
|
15
|
+
import { buildModelRef, modelRequestsArt } from './modelrefs';
|
|
16
|
+
import { templateCaptureActive, recordTemplateArt } from './kithooks';
|
|
16
17
|
import { applyLook, lookIsEnabled } from './look';
|
|
17
18
|
import { applyArtObjects, applyMaterialExtras, partArtRefs } from './artobjects';
|
|
18
19
|
import { coarsenParts, detailFor, optimizeModel, referenceBudget } from './optimize';
|
|
@@ -553,6 +554,7 @@ export function buildModelNode(
|
|
|
553
554
|
options = {}
|
|
554
555
|
) {
|
|
555
556
|
const root = new THREE.Group();
|
|
557
|
+
if (templateCaptureActive && modelRequestsArt(model, models, chain)) recordTemplateArt(root);
|
|
556
558
|
const groups = new Map();
|
|
557
559
|
const built = [];
|
|
558
560
|
const references = [];
|
|
@@ -602,7 +604,7 @@ export function buildModelNode(
|
|
|
602
604
|
if (options.optimize) {
|
|
603
605
|
optimizeModel(root, model, detail);
|
|
604
606
|
}
|
|
605
|
-
applyLook(root, model);
|
|
607
|
+
applyLook(root, model, path);
|
|
606
608
|
fitHeight(root, model);
|
|
607
609
|
root.userData.modelParts = groups;
|
|
608
610
|
return root;
|
|
@@ -675,6 +677,8 @@ export function animateModelParts(entry, dt, world, skipEmptyHints = false) {
|
|
|
675
677
|
anim.air += ((Math.abs(verticalSpeed) > 1.2 ? 1 : 0) - anim.air) * Math.min(1, dt * 8);
|
|
676
678
|
anim.amplitudeScale ??= 1;
|
|
677
679
|
anim.amplitudeScale += (gait.amplitudeScale - anim.amplitudeScale) * Math.min(1, gait.dt * 10);
|
|
680
|
+
anim.bobScale ??= 1;
|
|
681
|
+
anim.bobScale += (gait.bobScale - anim.bobScale) * Math.min(1, gait.dt * 10);
|
|
678
682
|
anim.phase += 2 * Math.PI * gait.cadence * gait.phaseDt;
|
|
679
683
|
} else {
|
|
680
684
|
const speed = Math.hypot(p.x - anim.last.x, p.z - anim.last.z) / dt;
|
|
@@ -704,7 +708,7 @@ export function animateModelParts(entry, dt, world, skipEmptyHints = false) {
|
|
|
704
708
|
parts.torso.userData.basePosition ??
|
|
705
709
|
(parts.torso.userData.basePosition = parts.torso.position.y);
|
|
706
710
|
parts.torso.position.y =
|
|
707
|
-
base + Math.abs(Math.sin(anim.phase)) * 0.05 * anim.swing * (1 - anim.air);
|
|
711
|
+
base + Math.abs(Math.sin(anim.phase)) * 0.05 * anim.swing * (1 - anim.air) * (gait?.model ? anim.bobScale ?? 1 : 1);
|
|
708
712
|
parts.torso.rotation.z = -anim.lean;
|
|
709
713
|
parts.torso.rotation.y = anim.lean * 0.4;
|
|
710
714
|
}
|