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
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
// The companion (v1.71): private follower, public shoulder glows; no actors.
|
|
2
|
+
import { disguiseBody } from './disguise.js';
|
|
2
3
|
import * as THREE from 'three';
|
|
3
4
|
import { check } from '../companionSpec.js';
|
|
4
|
-
import { paperSpecies, dressBird } from './companionDress.js';
|
|
5
|
+
import { paperSpecies, dressBird, TINTS } from './companionDress.js';
|
|
5
6
|
import { orbitFov } from '@imports/castle.physics-3d/engine3d/orbitlens.js';
|
|
6
7
|
|
|
7
8
|
// As wear.js: the avatar origin is the capsule centre, feet 0.7 m below it.
|
|
@@ -16,6 +17,17 @@ export function sanitise(c) {
|
|
|
16
17
|
return null;
|
|
17
18
|
}
|
|
18
19
|
}
|
|
20
|
+
// The public tuple has no speech, target or pose; reject malformed enum rows.
|
|
21
|
+
export function chirpMap(rows) {
|
|
22
|
+
const out = new Map();
|
|
23
|
+
for (const row of rows) {
|
|
24
|
+
if (!Array.isArray(row) || row.length !== 4 || typeof row[0] !== 'string') { continue; }
|
|
25
|
+
const dress = Object.fromEntries(['species', 'wear', 'tint'].flatMap((key, i) => row[i + 1] === null ? [] : [[key, row[i + 1]]]));
|
|
26
|
+
const c = sanitise({ look: 'bird', dress });
|
|
27
|
+
if (c) { out.set(row[0], c.dress ?? {}); }
|
|
28
|
+
}
|
|
29
|
+
return out;
|
|
30
|
+
}
|
|
19
31
|
// yaw and t are radians and seconds, respectively; facing is +z at yaw 0.
|
|
20
32
|
// Pure motion history: a target or speed >= 0.2 m/s resets the still timer.
|
|
21
33
|
export function restStep(previous, player, dt, pointing = false) {
|
|
@@ -46,12 +58,15 @@ export function frontTarget(player, camera, t, panel, view, project, reach = 1.3
|
|
|
46
58
|
const dx = length > 0.0001 ? (camera?.forward?.x ?? 0) / length : Math.sin(player.yaw ?? 0);
|
|
47
59
|
const dz = length > 0.0001 ? (camera?.forward?.z ?? 0) / length : Math.cos(player.yaw ?? 0);
|
|
48
60
|
const target = { x: player.x + reach * dx, y: player.y - 0.7 + 1.55 + 0.04 * Math.sin(t * Math.PI), z: player.z + reach * dz };
|
|
49
|
-
|
|
61
|
+
Object.assign(target, liftClear(target, camera, dx, dz, panel, view, project));
|
|
62
|
+
return { ...target, yaw: Math.atan2(player.x - target.x, player.z - target.z) };
|
|
63
|
+
}
|
|
64
|
+
function liftClear(start, camera, dx, dz, panel, view, project) {
|
|
50
65
|
// A far orbit or a tall panel can leave every lift covered: then the
|
|
51
66
|
// on-screen candidate highest above the panel wins, not the last one tried.
|
|
52
67
|
let best = null, bestY = Infinity;
|
|
53
68
|
for (let lift = 0; lift <= 10; lift++) {
|
|
54
|
-
const at = { x:
|
|
69
|
+
const at = { x: start.x, y: start.y + lift * 0.2, z: start.z };
|
|
55
70
|
// Recheck after lifting: a raised target can otherwise enter the camera.
|
|
56
71
|
if (camera?.position && Math.hypot(at.x - camera.position.x, at.y - camera.position.y, at.z - camera.position.z) < 0.9) {
|
|
57
72
|
at.x += dx * 1.8;
|
|
@@ -73,11 +88,34 @@ export function frontTarget(player, camera, t, panel, view, project, reach = 1.3
|
|
|
73
88
|
}
|
|
74
89
|
best ??= lift === 0 ? at : best;
|
|
75
90
|
}
|
|
76
|
-
|
|
77
|
-
return { ...target, yaw: Math.atan2(player.x - target.x, player.z - target.z) };
|
|
91
|
+
return best;
|
|
78
92
|
}
|
|
79
|
-
|
|
80
|
-
|
|
93
|
+
// Chat holds the bird on the sightline from the camera to the player's face,
|
|
94
|
+
// at the depth where its paper is CHAT_SHARE of view height (as showTarget
|
|
95
|
+
// sizes the show pose): a spot past the player only shrinks with the orbit.
|
|
96
|
+
// Without a camera position, assume the 6 m orbit behind the camera forward.
|
|
97
|
+
export const CHAT_SHARE = 0.09;
|
|
98
|
+
export function chatTarget(player, camera, t, panel, view, project, size = 0.2) {
|
|
99
|
+
const length = Math.hypot(camera?.forward?.x ?? 0, camera?.forward?.z ?? 0);
|
|
100
|
+
const dx = length > 0.0001 ? (camera?.forward?.x ?? 0) / length : Math.sin(player.yaw ?? 0);
|
|
101
|
+
const dz = length > 0.0001 ? (camera?.forward?.z ?? 0) / length : Math.cos(player.yaw ?? 0);
|
|
102
|
+
const face = { x: player.x, y: player.y - 0.7 + 1.55 + 0.04 * Math.sin(t * Math.PI), z: player.z };
|
|
103
|
+
const eye = camera?.position ?? { x: face.x - 6 * dx, y: face.y, z: face.z - 6 * dz };
|
|
104
|
+
const sight = { x: face.x - eye.x, y: face.y - eye.y, z: face.z - eye.z };
|
|
105
|
+
const reach = Math.hypot(sight.x, sight.y, sight.z), flat = Math.hypot(sight.x, sight.z);
|
|
106
|
+
const tan = Math.tan((Number.isFinite(camera?.fov) ? camera.fov : 70) * Math.PI / 360);
|
|
107
|
+
// 1 m leaves a margin over liftClear's 0.9 m camera check; stop 0.9 m short
|
|
108
|
+
// of the player across the ground.
|
|
109
|
+
const minimum = Math.max(1, (camera?.near ?? 0.1) + 0.3);
|
|
110
|
+
const maximum = flat > 0.0001 ? (flat - 0.9) * reach / flat : 0;
|
|
111
|
+
// A camera tight behind the player, or looking away from them, has no room
|
|
112
|
+
// between: there the bird is small on screen anyway, so keep the old spot.
|
|
113
|
+
if (maximum < minimum || sight.x * dx + sight.z * dz <= 0) { return frontTarget(player, camera, t, panel, view, project); }
|
|
114
|
+
const d = Math.max(minimum, Math.min(maximum, size / (2 * tan * CHAT_SHARE)));
|
|
115
|
+
const start = { x: eye.x + d * sight.x / reach, y: eye.y + d * sight.y / reach, z: eye.z + d * sight.z / reach };
|
|
116
|
+
const target = liftClear(start, camera, dx, dz, panel, view, project);
|
|
117
|
+
// Face the lens, as the old spot past the player did.
|
|
118
|
+
return { ...target, yaw: Math.atan2(eye.x - target.x, eye.z - target.z) };
|
|
81
119
|
}
|
|
82
120
|
function showAxes(camera) {
|
|
83
121
|
const forward = new THREE.Vector3(camera.forward.x, camera.forward.y ?? 0, camera.forward.z).normalize();
|
|
@@ -125,6 +163,21 @@ function showBounds(offsets, depth, side, lift, tan, aspect) {
|
|
|
125
163
|
}
|
|
126
164
|
return { left, right, bottom, top };
|
|
127
165
|
}
|
|
166
|
+
// Where a player's left side projects, in view units: its centre less a body
|
|
167
|
+
// half-width at its depth. Landscape keeps the show box left of this, so a
|
|
168
|
+
// close menu camera (the wardrobe) never puts Chirp over the player.
|
|
169
|
+
const PLAYER_HALF_WIDTH = 0.4;
|
|
170
|
+
function playerLeft(from, forward, right, tan, aspect) {
|
|
171
|
+
const depth = from.dot(forward);
|
|
172
|
+
return (from.dot(right) - PLAYER_HALF_WIDTH) / (depth * tan * aspect);
|
|
173
|
+
}
|
|
174
|
+
// The landscape box's right edge: `margin` left of the player's left side,
|
|
175
|
+
// unless that leaves under 5% of view width beside the left inset (the
|
|
176
|
+
// player at the left edge), when the box keeps the inset-only edge.
|
|
177
|
+
function landscapeEdge(left, inset, margin) {
|
|
178
|
+
const edge = Math.min(inset, left - margin);
|
|
179
|
+
return edge + inset < 0.1 ? inset : edge;
|
|
180
|
+
}
|
|
128
181
|
function showInside(pos, player, camera, view, vertices, t) {
|
|
129
182
|
const { forward, right, up } = showAxes(camera);
|
|
130
183
|
const offset = new THREE.Vector3(pos.x - camera.position.x, pos.y - camera.position.y, pos.z - camera.position.z);
|
|
@@ -135,7 +188,8 @@ function showInside(pos, player, camera, view, vertices, t) {
|
|
|
135
188
|
Math.tan(camera.fov * Math.PI / 360), view.w / view.h);
|
|
136
189
|
const playerOffset = new THREE.Vector3(player.x - camera.position.x, player.y - camera.position.y, player.z - camera.position.z);
|
|
137
190
|
const playerX = playerOffset.dot(right) / (playerOffset.dot(forward) * Math.tan(camera.fov * Math.PI / 360) * view.w / view.h);
|
|
138
|
-
const rightEdge = view.h > view.w ? Math.min(0.92, playerX - 0.04)
|
|
191
|
+
const rightEdge = view.h > view.w ? Math.min(0.92, playerX - 0.04)
|
|
192
|
+
: landscapeEdge(playerLeft(playerOffset, forward, right, Math.tan(camera.fov * Math.PI / 360), view.w / view.h), 0.92, 0.04);
|
|
139
193
|
return b.left >= -0.92 && b.right <= rightEdge && b.bottom >= -0.92 && b.top <= 0.92;
|
|
140
194
|
}
|
|
141
195
|
// Fit paper and wear, excluding glow. Centre the projected box, not its origin:
|
|
@@ -144,7 +198,7 @@ export function showTarget(player, camera, view, size, radius = 0, vertices = nu
|
|
|
144
198
|
const { forward, right, up } = showAxes(camera);
|
|
145
199
|
const tan = Math.tan(camera.fov * Math.PI / 360), aspect = view.w / view.h;
|
|
146
200
|
const portrait = view.h > view.w;
|
|
147
|
-
|
|
201
|
+
let centreX = portrait ? -0.46 : -0.3;
|
|
148
202
|
const centreY = portrait ? 0.2 : 0.1;
|
|
149
203
|
let side = centreX * tan * aspect, lift = centreY * tan;
|
|
150
204
|
const from = new THREE.Vector3(player.x - camera.position.x, player.y - camera.position.y, player.z - camera.position.z);
|
|
@@ -160,14 +214,22 @@ export function showTarget(player, camera, view, size, radius = 0, vertices = nu
|
|
|
160
214
|
const offsets = showOffsets(camera, vertices, t, side, lift);
|
|
161
215
|
const bounds = (depth) => showBounds(offsets, depth, side, lift, tan, aspect);
|
|
162
216
|
// Keep the whole box inside the inset and left of the player by 2%
|
|
163
|
-
// of view width in portrait
|
|
217
|
+
// of view width: of its centre in portrait, of its left side in
|
|
218
|
+
// landscape. Reduce height for a wider silhouette.
|
|
164
219
|
const playerX = from.dot(right) / (from.dot(forward) * tan * aspect);
|
|
165
|
-
const edge = view.h > view.w ? Math.min(0.919, playerX - 0.041) : 0.919;
|
|
166
|
-
|
|
220
|
+
const edge = view.h > view.w ? Math.min(0.919, playerX - 0.041) : landscapeEdge(playerLeft(from, forward, right, tan, aspect), 0.919, 0.041);
|
|
221
|
+
let width = 2 * Math.min(centreX + 0.919, edge - centreX);
|
|
167
222
|
const fits = (depth) => {
|
|
168
223
|
const b = bounds(depth);
|
|
169
224
|
return b.top - b.bottom <= 0.66 && b.right - b.left <= width;
|
|
170
225
|
};
|
|
226
|
+
// A close landscape shot leaves too little room right of the usual
|
|
227
|
+
// spot even at the farthest depth: centre the box in the strip left of
|
|
228
|
+
// the player instead.
|
|
229
|
+
if (!portrait && !fits(maximum) && centreX > (edge - 0.919) / 2) {
|
|
230
|
+
centreX = (edge - 0.919) / 2;
|
|
231
|
+
width = 2 * Math.min(centreX + 0.919, edge - centreX);
|
|
232
|
+
}
|
|
171
233
|
if (fits(minimum)) { d = minimum; }
|
|
172
234
|
else if (!fits(maximum)) { d = maximum; }
|
|
173
235
|
else {
|
|
@@ -212,8 +274,8 @@ function safeShow(pos, player, camera, radius) {
|
|
|
212
274
|
if (side.length() > room) { side.setLength(room); offset.copy(side).addScaledVector(forward, safeDepth); }
|
|
213
275
|
return { x: camera.position.x + offset.x, y: camera.position.y + offset.y, z: camera.position.z + offset.z };
|
|
214
276
|
}
|
|
215
|
-
export function motionTarget(player, pointAt, t, resting, chat) {
|
|
216
|
-
return chat ? chatTarget(player, chat.camera, t, chat.panel, chat.view, chat.project) : followTarget(player, pointAt, t, resting);
|
|
277
|
+
export function motionTarget(player, pointAt, t, resting, chat, size) {
|
|
278
|
+
return chat ? chatTarget(player, chat.camera, t, chat.panel, chat.view, chat.project, size) : followTarget(player, pointAt, t, resting);
|
|
217
279
|
}
|
|
218
280
|
export function leadTarget(player, pointAt, t) {
|
|
219
281
|
if (!pointAt || Math.hypot(pointAt.x - player.x, pointAt.z - player.z) > LEASH) { return null; }
|
|
@@ -473,7 +535,7 @@ export function makeCompanion({ idle = false } = {}) {
|
|
|
473
535
|
return {
|
|
474
536
|
clear,
|
|
475
537
|
dispose: clear,
|
|
476
|
-
frame(scene, local, hub, dt, now, visible, chat = null, busy = false, framing = null) {
|
|
538
|
+
frame(scene, local, hub, dt, now, visible, chat = null, busy = false, framing = null, low = false) {
|
|
477
539
|
if (world !== scene.three) {
|
|
478
540
|
clear();
|
|
479
541
|
world = scene.three;
|
|
@@ -562,7 +624,7 @@ export function makeCompanion({ idle = false } = {}) {
|
|
|
562
624
|
const nextLeading = route?.id ?? null;
|
|
563
625
|
if (nextLeading !== leading) { flightFrom = pos; leading = nextLeading; }
|
|
564
626
|
const view = framing?.view ?? chat?.view ?? { w: cam?.aspect ?? 1, h: 1 };
|
|
565
|
-
const target = show ? showTarget(player, camera, view, follower.userData.size, follower.userData.radius, follower.userData.showVertices, now / 1000) : route?.pos ?? motionTarget(player, pointAt, now / 1000, resting, talking);
|
|
627
|
+
const target = show ? showTarget(player, camera, view, follower.userData.size, follower.userData.radius, follower.userData.showVertices, now / 1000) : route?.pos ?? motionTarget(player, pointAt, now / 1000, resting, talking, follower.userData.size);
|
|
566
628
|
const flying = Boolean(route || flightFrom);
|
|
567
629
|
if (show && showHeld && showCamera && pos) { pos = carryShow(pos, showCamera, camera); }
|
|
568
630
|
if (show && !showHeld) {
|
|
@@ -615,7 +677,8 @@ export function makeCompanion({ idle = false } = {}) {
|
|
|
615
677
|
}
|
|
616
678
|
const dx = !flying && pointAt ? pointAt.x - pos.x : before ? pos.x - before.x : 0;
|
|
617
679
|
const dz = !flying && pointAt ? pointAt.z - pos.z : before ? pos.z - before.z : 0;
|
|
618
|
-
|
|
680
|
+
// Between the camera and the player, chat faces the lens (target.yaw).
|
|
681
|
+
if (talking) { ry = target.yaw ?? yawTo(pos, player); }
|
|
619
682
|
else if (route) { ry = route.yaw; }
|
|
620
683
|
else if (resting && !flying) { ry = player.yaw; }
|
|
621
684
|
else if (Math.hypot(dx, dz) > 0.0001) { ry = Math.atan2(dx, dz); }
|
|
@@ -679,28 +742,35 @@ export function makeCompanion({ idle = false } = {}) {
|
|
|
679
742
|
));}
|
|
680
743
|
}
|
|
681
744
|
}
|
|
745
|
+
const others = new Set([...(hub.glow ?? []), ...(hub.chirp?.keys() ?? [])]);
|
|
746
|
+
// The viewer's avatar map already applies the blocked-pair rule. Drop
|
|
747
|
+
// decorations immediately even if an old avatar node is still fading.
|
|
748
|
+
for (const id of others) { if ((hub.avatars && !hub.avatars.has(id)) || disguiseBody(self, id)) { others.delete(id); } }
|
|
749
|
+
const publicLook = (id) => JSON.stringify([low, hub.chirp?.get(id) ?? null]);
|
|
682
750
|
for (const [id, entry] of glows) {
|
|
683
751
|
const actorId = scene.multiplayer?.avatars?.actors?.get(id);
|
|
684
|
-
if (!
|
|
752
|
+
if (!others.has(id) || id === self || nodes?.get(actorId)?.node !== entry.parent || entry.look !== publicLook(id)) {
|
|
685
753
|
remove(entry.node);
|
|
686
754
|
glows.delete(id);
|
|
687
755
|
}
|
|
688
756
|
}
|
|
689
|
-
for (const id of
|
|
757
|
+
for (const id of others) {
|
|
690
758
|
const actorId = scene.multiplayer?.avatars?.actors?.get(id);
|
|
691
759
|
const parent = id !== self && actorId ? nodes?.get(actorId)?.node : null;
|
|
692
760
|
if (parent && !glows.has(id)) {
|
|
693
|
-
const
|
|
761
|
+
const dress = hub.chirp?.get(id);
|
|
762
|
+
const node = dress && !low ? build('bird', dress)
|
|
763
|
+
: mesh(new THREE.OctahedronGeometry(0.09), TINTS[dress?.tint] ?? '#ffd27a', true);
|
|
764
|
+
if (dress && !low) { node.scale.multiplyScalar(0.6); }
|
|
694
765
|
node.position.set(0.4, HEIGHT, 0);
|
|
695
766
|
parent.add(node);
|
|
696
|
-
glows.set(id, { node, parent });
|
|
767
|
+
glows.set(id, { node, parent, look: publicLook(id) });
|
|
697
768
|
}
|
|
698
769
|
}
|
|
699
770
|
for (const { node } of glows.values()) {
|
|
700
771
|
node.visible = visible && hub.place?.companion === true;
|
|
701
772
|
}
|
|
702
|
-
//
|
|
703
|
-
// counted nor culled on Low; glows still hide with their avatar parent.
|
|
773
|
+
// Child nodes inherit avatar hiding, block removal and quality culling.
|
|
704
774
|
},
|
|
705
775
|
screen(cam, view, project) {
|
|
706
776
|
return follower?.visible && pos ? project(cam, pos.x, pos.y, pos.z, view) : null;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// v1.78: folded paper additions; the undressed songbird stays in companion.js.
|
|
2
2
|
import * as THREE from 'three';
|
|
3
|
-
const TINTS = { rose: '#ee91ad', mint: '#87d8b0', midnight: '#39436b', gold: '#eab94e' };
|
|
3
|
+
export const TINTS = { rose: '#ee91ad', mint: '#87d8b0', midnight: '#39436b', gold: '#eab94e' };
|
|
4
4
|
const PAPER = { owl: '#98704b', parrot: '#4caf68', hummingbird: '#45bba1' };
|
|
5
5
|
|
|
6
6
|
export function paperSpecies(group, species, mesh, triangle) {
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
// The corner surface: the Grab button, the Horn, the invite button and the
|
|
2
|
+
// stats line (`cornerTree.js`) with the behaviour `chrome.js` gives them in
|
|
3
|
+
// the DOM (`onGrab`, `grabPrompt`, `hornPrompt`, `nearPrompt`, `setStats`,
|
|
4
|
+
// `setActMode`), published as the
|
|
5
|
+
// `corner` UI tree root. No DOM and no window: a native host says these as
|
|
6
|
+
// the hub system says them to the chrome, and its own handlers stay the
|
|
7
|
+
// senders -- the Horn's `{ k: 'hub-horn' }`, the invite button's
|
|
8
|
+
// `{ k: 'hub-party', op: 'invite', player }`. The web chrome does not use it.
|
|
9
|
+
//
|
|
10
|
+
// makeCornerSurface({ view, draw }):
|
|
11
|
+
// view() the stage: { landscape, safeInsets, lift };
|
|
12
|
+
// draw(tree) called with each root built (only when it changed).
|
|
13
|
+
import { publishUiRoot } from './uiTree.js';
|
|
14
|
+
import { buildCorner } from './cornerTree.js';
|
|
15
|
+
|
|
16
|
+
export function makeCornerSurface({ view = () => ({}), draw = null } = {}) {
|
|
17
|
+
let hornHandler = null;
|
|
18
|
+
let grabHandler = () => {};
|
|
19
|
+
let grab = null;
|
|
20
|
+
let actMode = false;
|
|
21
|
+
let nearHandler = () => {};
|
|
22
|
+
let near = null;
|
|
23
|
+
let stats = null;
|
|
24
|
+
let blocked = false;
|
|
25
|
+
let covered = false;
|
|
26
|
+
let key = '';
|
|
27
|
+
let disposed = false;
|
|
28
|
+
|
|
29
|
+
const on = {
|
|
30
|
+
grab: () => grabHandler(),
|
|
31
|
+
horn: () => hornHandler?.(),
|
|
32
|
+
near: () => nearHandler(),
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
function render() {
|
|
36
|
+
if (disposed) {return;}
|
|
37
|
+
const v = view() ?? {};
|
|
38
|
+
const state = {
|
|
39
|
+
view: { landscape: Boolean(v.landscape), safeInsets: Boolean(v.safeInsets), lift: Number(v.lift) || 0 },
|
|
40
|
+
grab: hornHandler ? null : grab, horn: Boolean(hornHandler), near: near && !blocked ? near : null, stats, covered,
|
|
41
|
+
};
|
|
42
|
+
const next = JSON.stringify(state);
|
|
43
|
+
if (next === key) {return;}
|
|
44
|
+
key = next;
|
|
45
|
+
const tree = buildCorner(state, on);
|
|
46
|
+
publishUiRoot('corner', tree);
|
|
47
|
+
draw?.(tree);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
render();
|
|
51
|
+
return {
|
|
52
|
+
// chrome `hornPrompt`: the Horn in the Grab button's place; a press
|
|
53
|
+
// calls `handler`. Any `grabPrompt` takes it away.
|
|
54
|
+
hornPrompt(handler) {
|
|
55
|
+
hornHandler = typeof handler === 'function' ? handler : null;
|
|
56
|
+
render();
|
|
57
|
+
},
|
|
58
|
+
// chrome `onGrab`: what a press of the Grab button calls (grab.js).
|
|
59
|
+
onGrab(handler) {
|
|
60
|
+
grabHandler = typeof handler === 'function' ? handler : () => {};
|
|
61
|
+
},
|
|
62
|
+
// chrome `grabPrompt`: the Grab button's words ("Grab" or "Throw"), or
|
|
63
|
+
// null to hide it; the Horn goes. Under Act (`setActMode`) the Act slot
|
|
64
|
+
// offers grabbing instead, and the button is never drawn.
|
|
65
|
+
grabPrompt(text) {
|
|
66
|
+
hornHandler = null;
|
|
67
|
+
grab = actMode || (text !== 'Grab' && text !== 'Throw') ? null : text;
|
|
68
|
+
render();
|
|
69
|
+
},
|
|
70
|
+
// chrome `setActMode`: a deck with `act` (v1.127) takes Grab off the corner.
|
|
71
|
+
setActMode(value) {
|
|
72
|
+
actMode = Boolean(value);
|
|
73
|
+
if (actMode) {grab = null;}
|
|
74
|
+
render();
|
|
75
|
+
},
|
|
76
|
+
// chrome `nearPrompt`: the invite button's words, or null to hide it; a
|
|
77
|
+
// press calls `handler`.
|
|
78
|
+
nearPrompt(text, handler) {
|
|
79
|
+
near = text ? String(text) : null;
|
|
80
|
+
if (text && typeof handler === 'function') {nearHandler = handler;}
|
|
81
|
+
render();
|
|
82
|
+
},
|
|
83
|
+
// chrome `setStats`: the stats text, or null / '' to hide it.
|
|
84
|
+
setStats(text) {
|
|
85
|
+
stats = text ? String(text) : null;
|
|
86
|
+
render();
|
|
87
|
+
},
|
|
88
|
+
// Quick chat, the emote row or wheel, or a People / Doors list is open:
|
|
89
|
+
// the invite button is not drawn over it.
|
|
90
|
+
setBlocked(value) {
|
|
91
|
+
blocked = Boolean(value);
|
|
92
|
+
render();
|
|
93
|
+
},
|
|
94
|
+
// The Character sheet is open over the rail.
|
|
95
|
+
setCovered(value) {
|
|
96
|
+
covered = Boolean(value);
|
|
97
|
+
render();
|
|
98
|
+
},
|
|
99
|
+
render,
|
|
100
|
+
dispose() {
|
|
101
|
+
if (disposed) {return;}
|
|
102
|
+
disposed = true;
|
|
103
|
+
publishUiRoot('corner', null);
|
|
104
|
+
},
|
|
105
|
+
};
|
|
106
|
+
}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
// The corner's context buttons and the stats line (`chrome.js`
|
|
2
|
+
// `grabPrompt`, `hornPrompt`, `nearPrompt`, `setStats`) as a UI tree
|
|
3
|
+
// (schema v0): the Grab button (v1.3, "Grab" or "Throw", in a place with
|
|
4
|
+
// `grab` and no `act`), the Horn in its place while this player drives a car
|
|
5
|
+
// with one (the vehicle preset), the invite button for the player stood
|
|
6
|
+
// beside ("+ Party · name"), and the debug stats line top right. The same
|
|
7
|
+
// words, sizes and states as the DOM. Sit / Stand is the emote surface's
|
|
8
|
+
// (`emoteTree.js`). Pure: no DOM, no window; the web chrome still draws its
|
|
9
|
+
// own.
|
|
10
|
+
//
|
|
11
|
+
// The buttons sit in the right-hand rail (`at.rail`, as the HUD's Act/Jump
|
|
12
|
+
// pair does), in the chrome's rail order: the Horn in Grab's place (order
|
|
13
|
+
// 1), the invite button last (order 6) and, upright, centred above the
|
|
14
|
+
// Talk button where the DOM puts it.
|
|
15
|
+
//
|
|
16
|
+
// state = {
|
|
17
|
+
// view: { landscape, safeInsets, lift } (`lift` the Shift lock's lift of
|
|
18
|
+
// the corner, 0 without one);
|
|
19
|
+
// grab: null, or the Grab button's words ("Grab" or "Throw"); the Horn,
|
|
20
|
+
// when offered, takes its place (chrome.js's one button);
|
|
21
|
+
// horn: the Horn is offered;
|
|
22
|
+
// near: null or the invite button's words;
|
|
23
|
+
// stats: null or the stats text (lines split on '\n');
|
|
24
|
+
// covered: the Character sheet is open over the rail (the Horn and the
|
|
25
|
+
// invite button are out of sight, as layPicker hides them);
|
|
26
|
+
// }
|
|
27
|
+
// on = { grab(), horn(), near() }.
|
|
28
|
+
import { h } from './uiTree.js';
|
|
29
|
+
|
|
30
|
+
const ROOT = { font: 'ui', size: 15, weight: 600, lh: 1.3, color: '#fff' };
|
|
31
|
+
const edge = (safeInsets, px) => (safeInsets ? [px, 0] : px);
|
|
32
|
+
export const RAIL = 'right';
|
|
33
|
+
export const RAIL_ORDER = { grab: 1, horn: 1, near: 6 };
|
|
34
|
+
// chrome.js grabPrompt's Throw colours; Grab is the Horn's.
|
|
35
|
+
const THROW = { bg: 'rgba(233,196,143,0.92)', color: '#2b2118' };
|
|
36
|
+
|
|
37
|
+
// The stats text as its lines: the DOM's `white-space: pre` keeps each
|
|
38
|
+
// '\n' a line break and no line wraps; each line is one unwrapped text.
|
|
39
|
+
export const statsLines = (text) => String(text ?? '').split('\n');
|
|
40
|
+
|
|
41
|
+
export function buildCorner(state, on = {}) {
|
|
42
|
+
const view = state.view ?? {};
|
|
43
|
+
const landscape = Boolean(view.landscape);
|
|
44
|
+
const lift = landscape ? 0 : Number(view.lift) || 0;
|
|
45
|
+
const covered = Boolean(state.covered);
|
|
46
|
+
const round = landscape ? 56 : 76;
|
|
47
|
+
const grab = state.horn ? null : state.grab === 'Grab' || state.grab === 'Throw' ? state.grab : null;
|
|
48
|
+
return h('stack', { key: 'corner', style: ROOT },
|
|
49
|
+
grab ? h('button', {
|
|
50
|
+
key: 'grab', fire: 'down',
|
|
51
|
+
at: { anchor: 'bottomRight', right: edge(view.safeInsets, 14), bottom: [60 + lift, 50 + lift], rail: { name: RAIL, order: RAIL_ORDER.grab } },
|
|
52
|
+
style: {
|
|
53
|
+
box: 'border', w: round, h: round, radius: round / 2, border: { w: 2, c: 'rgba(255,255,255,0.55)' }, bg: 'copy', color: '#fff',
|
|
54
|
+
font: 'ui', size: 16, weight: 800, lh: 'normal', ...(grab === 'Throw' ? THROW : {}), ...(covered ? { hidden: true } : {}),
|
|
55
|
+
},
|
|
56
|
+
on: { tap: on.grab },
|
|
57
|
+
}, grab) : null,
|
|
58
|
+
state.horn ? h('button', {
|
|
59
|
+
key: 'horn', fire: 'down',
|
|
60
|
+
at: { anchor: 'bottomRight', right: edge(view.safeInsets, 14), bottom: [60 + lift, 50 + lift], rail: { name: RAIL, order: RAIL_ORDER.horn } },
|
|
61
|
+
style: {
|
|
62
|
+
box: 'border', w: round, h: round, radius: round / 2, border: { w: 2, c: 'rgba(255,255,255,0.55)' }, bg: 'copy', color: '#fff',
|
|
63
|
+
font: 'ui', size: 16, weight: 800, lh: 'normal', ...(covered ? { hidden: true } : {}),
|
|
64
|
+
},
|
|
65
|
+
on: { tap: on.horn },
|
|
66
|
+
}, 'Horn') : null,
|
|
67
|
+
state.near ? h('button', {
|
|
68
|
+
key: 'near', fire: 'down',
|
|
69
|
+
at: landscape
|
|
70
|
+
? { anchor: 'bottomRight', right: edge(view.safeInsets, 12), bottom: [160, 150], rail: { name: RAIL, order: RAIL_ORDER.near } }
|
|
71
|
+
: { anchor: 'bottom', bottom: [160, 150] },
|
|
72
|
+
style: {
|
|
73
|
+
pad: [6, 14], radius: 16, border: { w: 1, c: 'line40' }, bg: 'copy', color: '#fff', font: 'ui', size: 13, weight: 600, lh: 'normal',
|
|
74
|
+
maxW: landscape ? [{ vw: 38 }, { px: 160 }] : [{ vw: 80 }], lines: 1, ...(covered ? { hidden: true } : {}),
|
|
75
|
+
},
|
|
76
|
+
on: { tap: on.near },
|
|
77
|
+
}, String(state.near)) : null,
|
|
78
|
+
state.stats ? h('column', {
|
|
79
|
+
key: 'stats',
|
|
80
|
+
at: { anchor: 'topRight', right: edge(view.safeInsets, 8), top: [8, 0] },
|
|
81
|
+
style: { font: 'mono', size: 11, weight: 400, lh: 1.3, opacity: 0.7, talign: 'end', align: 'end', hit: 'none' },
|
|
82
|
+
}, statsLines(state.stats).map((line, i) => h('text', { key: `l${i}`, text: line, style: { wrap: 'none' } }))) : null);
|
|
83
|
+
}
|
|
@@ -19,7 +19,9 @@ function el(tag, style, parent, text) {
|
|
|
19
19
|
return node;
|
|
20
20
|
}
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
// `refuse` (v1.204) is true, having said why, when an edit must wait on the
|
|
23
|
+
// server's progress read.
|
|
24
|
+
export function makeDecor(chrome, { renderer = () => new THREE.WebGLRenderer({ alpha: true, antialias: true, preserveDrawingBuffer: true }), refuse = () => false } = {}) {
|
|
23
25
|
const geometry = chrome.layoutGeometry?.();
|
|
24
26
|
const listeners = new AbortController();
|
|
25
27
|
function button(parent, label, action, style = {}) {
|
|
@@ -32,6 +34,7 @@ export function makeDecor(chrome, { renderer = () => new THREE.WebGLRenderer({ a
|
|
|
32
34
|
return node;
|
|
33
35
|
}
|
|
34
36
|
const root = el('div', { position: 'absolute', inset: '0', pointerEvents: 'none', zIndex: '3', display: 'none', color: '#fff', font: FONT }, chrome.decorRoot());
|
|
37
|
+
root.setAttribute('data-hub', 'decor');
|
|
35
38
|
const enter = button(root, '', () => send({ op: 'button' }), { position: 'absolute', right: '12px', bottom: 'max(76px, calc(env(safe-area-inset-bottom) + 66px))', background: PAINT.gold, pointerEvents: 'auto', fontSize: '16px', padding: '12px 20px' });
|
|
36
39
|
const header = el('div', { position: 'absolute', top: 'max(14px, env(safe-area-inset-top))', left: '50%', transform: 'translateX(-50%)', borderRadius: '24px', padding: '9px 14px', background: PAINT.panel, maxWidth: 'calc(100% - 28px)', boxSizing: 'border-box', textAlign: 'center', pointerEvents: 'auto' }, root);
|
|
37
40
|
el('div', { fontSize: '20px', fontWeight: '700', whiteSpace: 'nowrap' }, header, 'Decorating');
|
|
@@ -70,7 +73,7 @@ export function makeDecor(chrome, { renderer = () => new THREE.WebGLRenderer({ a
|
|
|
70
73
|
const plane = new THREE.Plane(new THREE.Vector3(0, 1, 0), 0);
|
|
71
74
|
|
|
72
75
|
function send(op) {
|
|
73
|
-
if (t.net) {
|
|
76
|
+
if (t.net && !refuse()) {
|
|
74
77
|
t.net.send({ k: 'decor', ...op });
|
|
75
78
|
}
|
|
76
79
|
}
|
|
@@ -302,10 +305,16 @@ export function makeDecor(chrome, { renderer = () => new THREE.WebGLRenderer({ a
|
|
|
302
305
|
node.setAttribute('aria-pressed', String(t.tab === tab.id));
|
|
303
306
|
}
|
|
304
307
|
button(tabRow, 'Done ✓', () => send({ op: 'close' }), { background: PAINT.green, flex: 'none', minHeight: '28px', padding: '5px 6px', fontSize: '11px', whiteSpace: 'nowrap', touchAction: 'pan-x' });
|
|
305
|
-
|
|
308
|
+
// 72 px tiles with two 11 px label lines fit every House piece's name and
|
|
309
|
+
// its unlock line ("Ship in a bottle", "Autumn post") without an ellipsis.
|
|
310
|
+
const tile = (label, action) => button(tiles, '', action, { position: 'relative', flex: '0 0 72px', width: '72px', height: '80px', boxSizing: 'border-box', padding: '0', overflow: 'hidden', borderRadius: '10px', background: PAINT.tile, color: '#fff', display: 'flex', flexDirection: 'column', alignItems: 'stretch', touchAction: 'pan-x', fontSize: '12px' });
|
|
306
311
|
for (const item of t.spec.items.filter((i) => i.tab === t.tab)) {
|
|
307
312
|
const node = tile(item.label, () => {
|
|
308
|
-
if (item.locked || item.count === 0) {
|
|
313
|
+
if (item.locked || (!item.action && item.count === 0)) {
|
|
314
|
+
return;
|
|
315
|
+
}
|
|
316
|
+
if (item.action) {
|
|
317
|
+
send({ op: 'pick', item: item.id });
|
|
309
318
|
return;
|
|
310
319
|
}
|
|
311
320
|
const at = t.scene.actorWith('Player')?.components.Transform ?? {};
|
|
@@ -314,21 +323,21 @@ export function makeDecor(chrome, { renderer = () => new THREE.WebGLRenderer({ a
|
|
|
314
323
|
// A full layer still lets the owner preview a red footprint.
|
|
315
324
|
lift({ item: item.id, x: cell?.x ?? 0, z: cell?.z ?? 0, rot: 0, layer: item.layer });
|
|
316
325
|
});
|
|
317
|
-
node.setAttribute('aria-label', `${item.label}${item.locked ? ` · Locked · ${item.locked.price}` : ` · ${item.count} spare`}`);
|
|
318
|
-
node.disabled = Boolean(item.locked || item.count === 0);
|
|
319
|
-
node.style.opacity =
|
|
320
|
-
const image = el('img', { width: '
|
|
326
|
+
node.setAttribute('aria-label', `${item.label}${item.locked ? ` · Locked · ${item.locked.price}` : item.action ? ' · Action' : ` · ${item.count} spare`}`);
|
|
327
|
+
node.disabled = Boolean(item.locked || (!item.action && item.count === 0));
|
|
328
|
+
node.style.opacity = node.disabled ? '0.65' : '1';
|
|
329
|
+
const image = el('img', { width: '72px', height: '54px', minHeight: '0', flex: '1 1 auto', objectFit: 'contain', pointerEvents: 'none' }, node);
|
|
321
330
|
image.alt = '';
|
|
322
331
|
t.images.set(image, item.template);
|
|
323
|
-
if (!item.locked && item.count >= 2) {
|
|
332
|
+
if (!item.action && !item.locked && item.count >= 2) {
|
|
324
333
|
el('span', { position: 'absolute', top: '4px', left: '4px', background: PAINT.green, color: '#17241b', borderRadius: '9px', padding: '1px 5px', fontSize: '11px' }, node, `×${item.count}`);
|
|
325
334
|
}
|
|
326
335
|
if (item.locked) {
|
|
327
336
|
el('span', { position: 'absolute', right: '4px', top: '4px', fontSize: '13px' }, node, '🔒');
|
|
328
337
|
}
|
|
329
|
-
el('div', { padding: item.locked ? '0 3px' : '
|
|
338
|
+
el('div', { padding: item.locked ? '0 3px' : '2px 3px', fontSize: '11px', lineHeight: '12px', flex: 'none', background: 'rgba(0,0,0,0.15)', overflow: 'hidden', display: '-webkit-box', WebkitBoxOrient: 'vertical', WebkitLineClamp: '2', overflowWrap: 'anywhere' }, node, item.label);
|
|
330
339
|
if (item.locked) {
|
|
331
|
-
el('div', { padding: '0 3px', flex: 'none', color: PAINT.gold, fontSize: '
|
|
340
|
+
el('div', { padding: '0 3px', flex: 'none', color: PAINT.gold, fontSize: '10px', lineHeight: '12px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }, node, item.locked.price);
|
|
332
341
|
}
|
|
333
342
|
}
|
|
334
343
|
for (const swatch of (t.spec.swatches ?? []).filter((s) => s.tab === t.tab)) {
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
// Where the kit keeps the little it remembers on a device (the tier mark, the
|
|
2
|
+
// Graphics pick, the sound settings). Normally that is the page's own
|
|
3
|
+
// localStorage, used exactly as before. On castle.xyz the deck runs in a
|
|
4
|
+
// sandboxed frame with no origin of its own, where localStorage throws on
|
|
5
|
+
// every access; there the values live in memory for the visit and are written
|
|
6
|
+
// through to the SDK's LocalCache, which the host page keeps in castle.xyz's
|
|
7
|
+
// origin for this deck. LocalCache is asynchronous and the readers are not, so
|
|
8
|
+
// a stored value only arrives once `prime` has fetched it: a reader that
|
|
9
|
+
// cannot wait adopts it when it comes (tiers.js, soundscape.js), and one that
|
|
10
|
+
// can waits for it, briefly (qualityEntry.js, before the first scene load).
|
|
11
|
+
//
|
|
12
|
+
// The SDK is imported only when the fallback first needs it, so a page with
|
|
13
|
+
// a working localStorage never loads LocalCache's path at all; an SDK without
|
|
14
|
+
// LocalCache (or one that cannot be loaded) leaves the fallback in memory
|
|
15
|
+
// only, for the visit.
|
|
16
|
+
const sdkCache = () => import('castle-web-sdk').then((sdk) => sdk.LocalCache);
|
|
17
|
+
|
|
18
|
+
// The fallback's LocalCache keys are the storage keys under this prefix.
|
|
19
|
+
export const CACHE_PREFIX = 'hub-storage/';
|
|
20
|
+
const PROBE_KEY = 'castle.hub.probe';
|
|
21
|
+
|
|
22
|
+
// The page's localStorage if it can really be written (a set and a remove
|
|
23
|
+
// that do not throw), else null. Reading the property alone is not enough: a
|
|
24
|
+
// private window may hand out a Storage whose writes throw.
|
|
25
|
+
export function usableLocalStorage(scope = globalThis) {
|
|
26
|
+
try {
|
|
27
|
+
const storage = scope.localStorage;
|
|
28
|
+
if (!storage) {
|
|
29
|
+
return null;
|
|
30
|
+
}
|
|
31
|
+
storage.setItem(PROBE_KEY, '1');
|
|
32
|
+
storage.removeItem(PROBE_KEY);
|
|
33
|
+
return storage;
|
|
34
|
+
} catch {
|
|
35
|
+
return null;
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
// A Storage-like object over memory that writes through to the LocalCache
|
|
40
|
+
// `loadCache` resolves to (called once, on first use). `prime(keys)`
|
|
41
|
+
// fetches those keys' stored values once and resolves to the set of keys it
|
|
42
|
+
// adopted: a key written or removed here before its value came back keeps what
|
|
43
|
+
// was written, since that is the newer word.
|
|
44
|
+
export function makeCachedStorage(loadCache = sdkCache) {
|
|
45
|
+
const values = new Map();
|
|
46
|
+
const written = new Set();
|
|
47
|
+
const fetched = new Map();
|
|
48
|
+
let loaded = null;
|
|
49
|
+
let writes = Promise.resolve();
|
|
50
|
+
const cache = () => (loaded ??= Promise.resolve().then(loadCache));
|
|
51
|
+
// Each write waits for the one before it to finish, since LocalCache's own
|
|
52
|
+
// writes do not land in the order they were called: two quick picks would
|
|
53
|
+
// otherwise leave the older one stored. A write that fails does not stop
|
|
54
|
+
// the next. No cache, or one that throws: the value is kept for this visit
|
|
55
|
+
// only.
|
|
56
|
+
const send = (call) => {
|
|
57
|
+
writes = writes.then(() => cache().then(call)).catch(() => {});
|
|
58
|
+
};
|
|
59
|
+
const fetchOne = (key) => {
|
|
60
|
+
let pending = fetched.get(key);
|
|
61
|
+
if (!pending) {
|
|
62
|
+
pending = (async () => {
|
|
63
|
+
try {
|
|
64
|
+
const text = await (await cache()).getText(CACHE_PREFIX + key);
|
|
65
|
+
if (typeof text === 'string' && !written.has(key)) {
|
|
66
|
+
values.set(key, text);
|
|
67
|
+
return true;
|
|
68
|
+
}
|
|
69
|
+
} catch {
|
|
70
|
+
// A miss.
|
|
71
|
+
}
|
|
72
|
+
return false;
|
|
73
|
+
})();
|
|
74
|
+
fetched.set(key, pending);
|
|
75
|
+
}
|
|
76
|
+
return pending;
|
|
77
|
+
};
|
|
78
|
+
return {
|
|
79
|
+
getItem: (key) => (values.has(key) ? values.get(key) : null),
|
|
80
|
+
setItem(key, value) {
|
|
81
|
+
const text = String(value);
|
|
82
|
+
values.set(key, text);
|
|
83
|
+
written.add(key);
|
|
84
|
+
send((c) => c.set(CACHE_PREFIX + key, text));
|
|
85
|
+
},
|
|
86
|
+
removeItem(key) {
|
|
87
|
+
values.delete(key);
|
|
88
|
+
written.add(key);
|
|
89
|
+
send((c) => c.remove(CACHE_PREFIX + key));
|
|
90
|
+
},
|
|
91
|
+
async prime(keys) {
|
|
92
|
+
const adopted = await Promise.all(keys.map(fetchOne));
|
|
93
|
+
// Asked again after the values came: a key written since is the
|
|
94
|
+
// player's, not the stored one.
|
|
95
|
+
return new Set(keys.filter((key, i) => adopted[i] && !written.has(key)));
|
|
96
|
+
},
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
// The page's localStorage where it works, looked for on each use as the
|
|
101
|
+
// readers always did (never as a module loads: a deck without tiers or a
|
|
102
|
+
// soundscape never touches storage at all); otherwise the kit's one fallback,
|
|
103
|
+
// so the tiers, the soundscape and the quality entry's wait share its values.
|
|
104
|
+
let fallback = null;
|
|
105
|
+
export function deviceStorage() {
|
|
106
|
+
return usableLocalStorage() ?? (fallback ??= makeCachedStorage());
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
// Fetches `keys` into a storage that needs it, waiting at most `waitMs`.
|
|
110
|
+
// Null when there is nothing to wait for (the page's own localStorage, or a
|
|
111
|
+
// storage without `prime`), so a caller that can skip the wait does.
|
|
112
|
+
export function primeDeviceStorage(keys, { storage = deviceStorage(), waitMs = 1000 } = {}) {
|
|
113
|
+
if (typeof storage?.prime !== 'function') {
|
|
114
|
+
return null;
|
|
115
|
+
}
|
|
116
|
+
let timer;
|
|
117
|
+
const late = new Promise((resolve) => {
|
|
118
|
+
timer = setTimeout(() => resolve(new Set()), waitMs);
|
|
119
|
+
});
|
|
120
|
+
return Promise.race([storage.prime(keys), late]).finally(() => clearTimeout(timer));
|
|
121
|
+
}
|