castle-web-cli 0.4.239 → 0.4.241
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 +163 -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 +6 -3
- package/dist/init.js +24 -2
- package/dist/multiplayerDoc.d.ts +1 -1
- package/dist/multiplayerDoc.js +2 -0
- package/dist/platformDoc.js +3 -2
- package/dist/playPagePolicy.js +5 -1
- package/dist/resetLeaderboards.d.ts +8 -1
- package/dist/resetLeaderboards.js +43 -8
- package/dist/roomLogs.d.ts +1 -0
- package/dist/roomLogs.js +30 -6
- package/dist/save-deck.d.ts +32 -2
- package/dist/save-deck.js +240 -39
- package/kits/base/CLAUDE.md +1 -1
- package/kits/base/castle.json +1 -1
- package/kits/base/sdk/README.md +174 -6
- package/kits/base/sdk/analytics.d.ts +8 -0
- package/kits/base/sdk/analytics.js +92 -0
- package/kits/base/sdk/castle.d.ts +5 -1
- package/kits/base/sdk/castle.js +2 -0
- package/kits/base/sdk/commands.d.ts +48 -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 +168 -26
- package/kits/base/sdk/reconnectBudget.d.ts +6 -0
- package/kits/base/sdk/reconnectBudget.js +41 -1
- 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/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/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 +481 -57
- 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/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/padCues.js +11 -7
- package/kits/hub-game/code/client/padReadability.js +3 -3
- 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 +72 -51
- 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 +205 -25
- 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 +35 -3
- 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/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 +991 -72
- 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/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 +14 -2
- package/kits/hub-game/code/server/replay.js +135 -0
- package/kits/hub-game/code/server/standing.js +7 -3
- 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/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 +429 -55
- package/kits/hub-game/docs/analytics.md +16 -2
- package/kits/hub-game/docs/contract.md +956 -101
- 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 +79 -0
- 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 +421 -4
- 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-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 +119 -0
- package/kits/hub-game/scripts/test-hub-trip.mjs +240 -4
- 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-loading-cover.mjs +67 -1
- package/kits/hub-game/scripts/test-manifest.mjs +27 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +54 -5
- 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-pad-cues.mjs +39 -0
- package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
- package/kits/hub-game/scripts/test-placeat-server.mjs +648 -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 +242 -3
- 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-role-client.mjs +2 -1
- 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-standing.mjs +135 -2
- package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
- package/kits/hub-game/scripts/test-stuck.mjs +36 -1
- 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-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 +68 -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 +340 -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 +36 -2
- package/kits/hub-game/tools/hubScene/validate-manifest.mjs +10 -2
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/resumeGate.js +66 -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 +108 -18
- 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 +417 -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-coaxial-escape.mjs +176 -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 +59 -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
|
@@ -0,0 +1,384 @@
|
|
|
1
|
+
// Focused real-runtime/template lifecycle checks, with no renderer or browser.
|
|
2
|
+
import assert from 'node:assert/strict';
|
|
3
|
+
import { register } from 'node:module';
|
|
4
|
+
import * as THREE from 'three';
|
|
5
|
+
const stubs = {
|
|
6
|
+
'castle-web-sdk': `export const resolveDeckFile = (name) => String(name).replace(/^\\.\\//, '');
|
|
7
|
+
export const deckPrefixOf = () => ''; export const IMPORTS_DIR = 'imports'; export const IMPORTS_PREFIX = 'imports/';`,
|
|
8
|
+
'./files': `export const initialFiles = {}; export const parseJsonFile = (path, text) => ({ value: JSON.parse(text) });
|
|
9
|
+
export const formatJson = (value) => JSON.stringify(value);`,
|
|
10
|
+
'./systemRegistry': `export const systemInstallers = [];`,
|
|
11
|
+
'./fonts': `export const deckFontFamily = 'sans-serif';`,
|
|
12
|
+
};
|
|
13
|
+
register(
|
|
14
|
+
'data:text/javascript,' +
|
|
15
|
+
encodeURIComponent(`
|
|
16
|
+
import { existsSync } from 'node:fs';
|
|
17
|
+
import { fileURLToPath } from 'node:url';
|
|
18
|
+
const stubs = ${JSON.stringify(stubs)};
|
|
19
|
+
export async function resolve(specifier, context, next) {
|
|
20
|
+
const parent = context.parentURL ?? '';
|
|
21
|
+
if (parent.includes('/physics-2d/engine/') && stubs[specifier]) {
|
|
22
|
+
return { url: 'data:text/javascript,' + encodeURIComponent(stubs[specifier]), shortCircuit: true };
|
|
23
|
+
}
|
|
24
|
+
if (specifier.startsWith('@imports/castle.physics-3d/')) { specifier = parent.replace(/\\/kits\\/.*/, '/kits/physics-3d/') + specifier.slice(27); }
|
|
25
|
+
if (specifier.startsWith('@imports/castle.physics-2d/')) {
|
|
26
|
+
specifier = parent.replace(/\\/kits\\/.*/, '/kits/physics-2d/') + specifier.slice(27);
|
|
27
|
+
}
|
|
28
|
+
if ((specifier.startsWith('.') || specifier.startsWith('file:')) && parent.includes('/kits/') && !/\\.(m?js|jsx|json)$/.test(specifier)) {
|
|
29
|
+
const base = new URL(specifier, parent).href;
|
|
30
|
+
if (existsSync(fileURLToPath(base + '.js'))) return next(base + '.js', context);
|
|
31
|
+
}
|
|
32
|
+
return next(specifier, context);
|
|
33
|
+
}
|
|
34
|
+
`),
|
|
35
|
+
);
|
|
36
|
+
|
|
37
|
+
const { SceneRuntime } = await import('../../physics-2d/engine/scene.js');
|
|
38
|
+
const { syncActors, disposeWorld, prewarmSleepingModels, needsSleepingModelPrewarm } = await import('../engine3d/world3d.js');
|
|
39
|
+
const { takeModel, releaseModel, disposeParkedModels } = await import('../engine3d/optimize.js');
|
|
40
|
+
const model = (color = '#8899aa') => JSON.stringify({ format: 'pxmodel', parts: [
|
|
41
|
+
{ id: 'box', kind: 'box', size: [1, 1, 1], color }, { id: 'empty', kind: 'model' },
|
|
42
|
+
] });
|
|
43
|
+
function fixture(engine = {}, instanceModels = false) {
|
|
44
|
+
const scene = new THREE.Scene();
|
|
45
|
+
const ground = new THREE.Mesh(new THREE.PlaneGeometry(1, 1), new THREE.MeshStandardMaterial());
|
|
46
|
+
const grid = new THREE.Object3D();
|
|
47
|
+
scene.add(ground, grid);
|
|
48
|
+
const world = { scene, camera: new THREE.PerspectiveCamera(), renderer: { dispose() {} },
|
|
49
|
+
nodes: new Map(), parked: new Map(), models: new Map(), skipping: { on: false },
|
|
50
|
+
modelSigs: new Map(), sigEpoch: 0, syncCount: 0, syncDepth: 0, generation: 0,
|
|
51
|
+
snapshots: new WeakMap(), instances: new Map(), instanceModels, ground, grid };
|
|
52
|
+
const actors = ['a', 'b', 'c'].map((id, i) => ({ id, static: true, components: {
|
|
53
|
+
Transform: { x: i * 10, y: 0, z: 0, rotationX: 0, rotationY: 0, rotationZ: 0 },
|
|
54
|
+
Model: { file: `${id}.pxmodel` },
|
|
55
|
+
} }));
|
|
56
|
+
const runtime = new SceneRuntime({ engine, actors }, [], {},
|
|
57
|
+
Object.fromEntries(actors.map(a => [a.components.Model.file, model()])));
|
|
58
|
+
runtime.scenePath = 'one';
|
|
59
|
+
const sync = () => syncActors(world, runtime, runtime.sprites, 0);
|
|
60
|
+
const sleep = (id, value = true) => runtime.setActorSleeping(id, value);
|
|
61
|
+
return { world, runtime, sync, sleep };
|
|
62
|
+
}
|
|
63
|
+
function onDispose(template) {
|
|
64
|
+
let calls = 0;
|
|
65
|
+
template.traverse(n => n.geometry?.addEventListener('dispose', () => calls++));
|
|
66
|
+
return () => calls;
|
|
67
|
+
}
|
|
68
|
+
// The cache primitive keeps the exact shared object and retains ordinary release.
|
|
69
|
+
{
|
|
70
|
+
const cache = new Map(); let builds = 0, disposed = 0;
|
|
71
|
+
const build = () => ({ build: ++builds });
|
|
72
|
+
const first = takeModel(cache, 'key', build);
|
|
73
|
+
releaseModel(cache, 'key', () => disposed++, true);
|
|
74
|
+
assert.equal(cache.get('key').users, 0);
|
|
75
|
+
assert.equal(takeModel(cache, 'key', build), first);
|
|
76
|
+
assert.equal(builds, 1);
|
|
77
|
+
releaseModel(cache, 'key', () => disposed++);
|
|
78
|
+
assert.equal(disposed, 1);
|
|
79
|
+
takeModel(cache, 'key', build);
|
|
80
|
+
releaseModel(cache, 'key', () => disposed++, true);
|
|
81
|
+
disposeParkedModels(cache, () => disposed++);
|
|
82
|
+
assert.equal(cache.size, 0);
|
|
83
|
+
assert.equal(disposed, 2);
|
|
84
|
+
}
|
|
85
|
+
// Full, skipping, still keeper and frozen-static removal paths, plus instances.
|
|
86
|
+
const full = { skipUnchangedActors: true };
|
|
87
|
+
for (const engine of [{}, full, { ...full, staticActors: true },
|
|
88
|
+
{ ...full, staticActors: true, frozenStatics: true }]) {
|
|
89
|
+
for (const instanced of [false, true]) {
|
|
90
|
+
const f = fixture(engine, instanced), { world, runtime, sync, sleep } = f;
|
|
91
|
+
for (let i = 0; i < 4; i++) sync();
|
|
92
|
+
const key = world.nodes.get('a').modelKey;
|
|
93
|
+
const template = world.models.get(key).template;
|
|
94
|
+
const disposed = onDispose(template);
|
|
95
|
+
assert.equal(world.instances.has(key), instanced, 'fixture actually exercises instances');
|
|
96
|
+
const version = runtime.sleepVersion;
|
|
97
|
+
sleep('a'); sleep('a');
|
|
98
|
+
assert.equal(runtime.sleepVersion, version + 1, 'idempotent sleep keeps the revision');
|
|
99
|
+
sync();
|
|
100
|
+
assert.equal(world.nodes.has('a'), false);
|
|
101
|
+
assert.equal(world.models.get(key).users, 0);
|
|
102
|
+
assert.equal(disposed(), 0, 'sleep parks the build');
|
|
103
|
+
assert.equal(world.instances.has(key), false, 'sleep removes instance bookkeeping');
|
|
104
|
+
sleep('a', false); sync();
|
|
105
|
+
assert.equal(world.models.get(key).template, template, 'wake reuses exact template');
|
|
106
|
+
assert.equal(world.models.get(key).users, 1);
|
|
107
|
+
runtime.despawnActor('a'); sync();
|
|
108
|
+
assert.equal(world.models.has(key), false, 'removal still disposes');
|
|
109
|
+
assert.ok(disposed() > 0);
|
|
110
|
+
const bKey = world.nodes.get('b').modelKey;
|
|
111
|
+
const bDisposed = onDispose(world.models.get(bKey).template);
|
|
112
|
+
sleep('b'); sync();
|
|
113
|
+
runtime.despawnActor('b'); sync();
|
|
114
|
+
assert.equal(runtime.sleepingActorCount, 0);
|
|
115
|
+
assert.equal(world.models.has(bKey), false, 'no sleepers clears parked builds');
|
|
116
|
+
assert.ok(bDisposed() > 0);
|
|
117
|
+
sleep('c'); sync();
|
|
118
|
+
const cTemplate = [...world.models.values()][0].template;
|
|
119
|
+
const cDisposed = onDispose(cTemplate);
|
|
120
|
+
disposeWorld(world);
|
|
121
|
+
assert.equal(world.models.size, 0, 'world disposal clears parked builds');
|
|
122
|
+
assert.ok(cDisposed() > 0);
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
console.log('sleeping models: full/skipping/keeper/frozen and instanced sleep/wake, removal, zero sleepers and disposal passed');
|
|
126
|
+
// Scene changes and same-path scene reloads clear parked builds too.
|
|
127
|
+
for (const reload of [false, true]) {
|
|
128
|
+
const { world, runtime, sync, sleep } = fixture();
|
|
129
|
+
sync(); sleep('a'); sync();
|
|
130
|
+
const key = [...world.models].find(([, e]) => e.users === 0)[0];
|
|
131
|
+
const disposed = onDispose(world.models.get(key).template);
|
|
132
|
+
if (reload) runtime.load({ actors: [] }); else runtime.scenePath = 'two';
|
|
133
|
+
sync();
|
|
134
|
+
assert.equal(world.models.has(key), false);
|
|
135
|
+
assert.ok(disposed() > 0);
|
|
136
|
+
disposeWorld(world);
|
|
137
|
+
}
|
|
138
|
+
// Template-only prewarming, bounded and idempotent, uses waking's exact key
|
|
139
|
+
// for both empty-part variants and both look bake modes.
|
|
140
|
+
for (const drops of [false, true]) for (const later of [false, true]) {
|
|
141
|
+
const { world, runtime, sync, sleep } = fixture();
|
|
142
|
+
Object.defineProperty(runtime, 'dropsEmptyParts', { value: drops });
|
|
143
|
+
Object.defineProperty(runtime, 'bakesLookLater', { value: later });
|
|
144
|
+
for (const id of ['a', 'b', 'c']) sleep(id);
|
|
145
|
+
sync();
|
|
146
|
+
let clock = 0;
|
|
147
|
+
const now = () => { const value = clock; clock += 5; return value; };
|
|
148
|
+
assert.equal(prewarmSleepingModels(world, runtime, { budgetMs: 4, now }), 1);
|
|
149
|
+
assert.equal(world.models.size, 1, 'one build crosses the budget');
|
|
150
|
+
assert.equal(world.nodes.size, 0, 'prewarming attaches no actor node');
|
|
151
|
+
assert.equal(world.instances.size, 0);
|
|
152
|
+
assert.equal(prewarmSleepingModels(world, runtime, { budgetMs: 9, now }), 2);
|
|
153
|
+
assert.equal(needsSleepingModelPrewarm(world, runtime), false);
|
|
154
|
+
const state = world.sleepingModelPrewarm;
|
|
155
|
+
assert.equal(prewarmSleepingModels(world, runtime), 0);
|
|
156
|
+
assert.equal(world.sleepingModelPrewarm, state, 'done state is retained');
|
|
157
|
+
assert.equal(world.models.size, 3);
|
|
158
|
+
assert.ok([...world.models.values()].every(e => e.users === 0));
|
|
159
|
+
const old = new Set([...world.models.values()].map(e => e.template));
|
|
160
|
+
sleep('a', false); sync();
|
|
161
|
+
assert.ok(old.has(world.models.get(world.nodes.get('a').modelKey).template));
|
|
162
|
+
runtime.files['b.pxmodel'] = model('#ff0000');
|
|
163
|
+
assert.equal(needsSleepingModelPrewarm(world, runtime), true, 'in-place file edits invalidate completion');
|
|
164
|
+
assert.equal(prewarmSleepingModels(world, runtime, { budgetMs: 100, now }), 1);
|
|
165
|
+
runtime.getActor('c').components.Model.file = 'new.pxmodel';
|
|
166
|
+
runtime.files['new.pxmodel'] = model();
|
|
167
|
+
assert.equal(needsSleepingModelPrewarm(world, runtime), true, 'sleeping model changes invalidate completion');
|
|
168
|
+
assert.equal(prewarmSleepingModels(world, runtime, { budgetMs: 100, now }), 1);
|
|
169
|
+
sleep('b', false); sleep('c', false); sync();
|
|
170
|
+
assert.equal([...world.models.values()].filter(e => e.users === 0).length, 0);
|
|
171
|
+
disposeWorld(world);
|
|
172
|
+
}
|
|
173
|
+
// Prewarming cannot compete with an unsettled engine.load pass.
|
|
174
|
+
{
|
|
175
|
+
const { world, runtime, sync, sleep } = fixture({ load: { first: [], sliceMs: 1 } });
|
|
176
|
+
sleep('a');
|
|
177
|
+
assert.equal(prewarmSleepingModels(world, runtime), 0, 'before first load sync');
|
|
178
|
+
world.modelLoad = { runtime, data: runtime.data, restMarked: false };
|
|
179
|
+
assert.equal(prewarmSleepingModels(world, runtime), 0, 'during load');
|
|
180
|
+
delete world.modelLoad;
|
|
181
|
+
sync();
|
|
182
|
+
assert.equal(prewarmSleepingModels(world, runtime), 0);
|
|
183
|
+
world.modelLoad.restMarked = true;
|
|
184
|
+
assert.equal(prewarmSleepingModels(world, runtime), 1, 'resumes once initial load settles');
|
|
185
|
+
disposeWorld(world);
|
|
186
|
+
}
|
|
187
|
+
console.log('sleeping models: scene/reload cleanup, budget, idempotence, exact keys/look variants, asset invalidation and load fence passed');
|
|
188
|
+
|
|
189
|
+
// Shared users can wake independently; an ordinary signature rebuild disposes
|
|
190
|
+
// its old owned template while unrelated sleepers still keep theirs parked.
|
|
191
|
+
{
|
|
192
|
+
const { world, runtime, sync, sleep } = fixture();
|
|
193
|
+
runtime.getActor('b').components.Model.file = 'a.pxmodel';
|
|
194
|
+
sync();
|
|
195
|
+
const key = world.nodes.get('a').modelKey;
|
|
196
|
+
const template = world.models.get(key).template;
|
|
197
|
+
sleep('a'); sync();
|
|
198
|
+
assert.equal(world.models.get(key).users, 1);
|
|
199
|
+
sleep('b'); sync();
|
|
200
|
+
assert.equal(world.models.get(key).users, 0);
|
|
201
|
+
sleep('a', false); sync();
|
|
202
|
+
assert.equal(world.models.get(key).template, template);
|
|
203
|
+
const disposed = onDispose(template);
|
|
204
|
+
runtime.getActor('a').components.Model.file = 'c.pxmodel';
|
|
205
|
+
sync();
|
|
206
|
+
assert.equal(world.models.has(key), false, 'signature rebuild disposes the last owned user');
|
|
207
|
+
assert.ok(disposed() > 0);
|
|
208
|
+
assert.equal(needsSleepingModelPrewarm(world, runtime), true);
|
|
209
|
+
assert.equal(prewarmSleepingModels(world, runtime), 1, 'sleeping shared user can prepare its build again');
|
|
210
|
+
const state = world.sleepingModelPrewarm;
|
|
211
|
+
runtime.spawnActor({ id: 'b', components: { Transform: { x: 10, y: 0, z: 0 } } });
|
|
212
|
+
assert.equal(runtime.sleepingActorCount, 0, 'replacement wakes the sleeping ID');
|
|
213
|
+
sync();
|
|
214
|
+
assert.notEqual(world.sleepingModelPrewarm, state);
|
|
215
|
+
assert.equal([...world.models.values()].some(e => e.users === 0), false);
|
|
216
|
+
disposeWorld(world);
|
|
217
|
+
}
|
|
218
|
+
// Referenced model edits must invalidate completion even when the root text
|
|
219
|
+
// and the files object have not changed.
|
|
220
|
+
{
|
|
221
|
+
const { world, runtime, sync, sleep } = fixture();
|
|
222
|
+
runtime.files['a.pxmodel'] = JSON.stringify({ format: 'pxmodel', parts: [
|
|
223
|
+
{ id: 'nested', kind: 'model', src: 'b.pxmodel' },
|
|
224
|
+
] });
|
|
225
|
+
sleep('a'); sync();
|
|
226
|
+
assert.equal(prewarmSleepingModels(world, runtime), 1);
|
|
227
|
+
assert.equal(needsSleepingModelPrewarm(world, runtime), false);
|
|
228
|
+
runtime.files['b.pxmodel'] = model('#00ff00');
|
|
229
|
+
assert.equal(needsSleepingModelPrewarm(world, runtime), true);
|
|
230
|
+
assert.equal(prewarmSleepingModels(world, runtime), 1);
|
|
231
|
+
disposeWorld(world);
|
|
232
|
+
}
|
|
233
|
+
console.log('sleeping models: shared users, ordinary signature disposal, ID replacement and referenced-file invalidation passed');
|
|
234
|
+
|
|
235
|
+
// Published older runtimes can reuse the completion queue without the new
|
|
236
|
+
// getters, while still discovering newly sleeping actors.
|
|
237
|
+
{
|
|
238
|
+
const { world, runtime, sync, sleep } = fixture();
|
|
239
|
+
Object.defineProperty(runtime, 'sleepVersion', { value: undefined });
|
|
240
|
+
Object.defineProperty(runtime, 'sleepingActorCount', { value: undefined });
|
|
241
|
+
sleep('a'); sync();
|
|
242
|
+
assert.equal(prewarmSleepingModels(world, runtime), 1);
|
|
243
|
+
const state = world.sleepingModelPrewarm;
|
|
244
|
+
assert.equal(prewarmSleepingModels(world, runtime), 0);
|
|
245
|
+
assert.equal(world.sleepingModelPrewarm, state);
|
|
246
|
+
sleep('b'); sync();
|
|
247
|
+
// b already had a live build, so it was parked rather than rebuilt.
|
|
248
|
+
assert.equal(prewarmSleepingModels(world, runtime), 0);
|
|
249
|
+
assert.notEqual(world.sleepingModelPrewarm, state);
|
|
250
|
+
assert.equal(needsSleepingModelPrewarm(world, runtime), false);
|
|
251
|
+
disposeWorld(world);
|
|
252
|
+
}
|
|
253
|
+
console.log('sleeping models: older-runtime completion and new-sleeper discovery passed');
|
|
254
|
+
|
|
255
|
+
// Queue rebuilds nominate obsolete templates; only the following renderer
|
|
256
|
+
// sync prunes unused templates no current sleeper can take.
|
|
257
|
+
// Retain valid keys even when their sleeper lies beyond this frame's slice.
|
|
258
|
+
for (const change of ['asset', 'model', 'reference', 'art', 'removed', 'replaced', 'awake']) {
|
|
259
|
+
const { world, runtime, sync, sleep } = fixture();
|
|
260
|
+
if (change === 'reference') {
|
|
261
|
+
runtime.files['a.pxmodel'] = JSON.stringify({ format: 'pxmodel', parts: [
|
|
262
|
+
{ id: 'nested', kind: 'model', src: 'detail.pxmodel' },
|
|
263
|
+
] });
|
|
264
|
+
runtime.files['detail.pxmodel'] = model();
|
|
265
|
+
}
|
|
266
|
+
if (change === 'art') {
|
|
267
|
+
const source = JSON.parse(model());
|
|
268
|
+
source.parts[1].art = 'texture.png'; // empty part: no browser texture needed
|
|
269
|
+
runtime.files['a.pxmodel'] = JSON.stringify(source);
|
|
270
|
+
runtime.sprites['texture.png'] = { kind: 'image', ready: false };
|
|
271
|
+
}
|
|
272
|
+
sync(); sleep('a'); sleep('b'); sync();
|
|
273
|
+
const aKey = [...world.models.keys()].find(k => k.startsWith('a.pxmodel|'));
|
|
274
|
+
const bKey = [...world.models.keys()].find(k => k.startsWith('b.pxmodel|'));
|
|
275
|
+
const cKey = world.nodes.get('c').modelKey;
|
|
276
|
+
const aTemplate = world.models.get(aKey).template;
|
|
277
|
+
const aDisposed = onDispose(aTemplate);
|
|
278
|
+
const bEntry = world.models.get(bKey), cEntry = world.models.get(cKey);
|
|
279
|
+
let materialDisposals = 0;
|
|
280
|
+
aTemplate.traverse(n => {
|
|
281
|
+
for (const material of [n.material].flat()) {
|
|
282
|
+
material?.addEventListener('dispose', () => materialDisposals++);
|
|
283
|
+
}
|
|
284
|
+
});
|
|
285
|
+
prewarmSleepingModels(world, runtime, { budgetMs: 100, now: () => 0 });
|
|
286
|
+
assert.equal(needsSleepingModelPrewarm(world, runtime), false);
|
|
287
|
+
if (change === 'asset') runtime.files['a.pxmodel'] = model('#ff0000');
|
|
288
|
+
if (change === 'model') runtime.getActor('a').components.Model.file = 'b.pxmodel';
|
|
289
|
+
if (change === 'reference') runtime.files['detail.pxmodel'] = model('#00ff00');
|
|
290
|
+
if (change === 'art') runtime.sprites['texture.png'].ready = true;
|
|
291
|
+
if (change === 'removed') runtime.despawnActor('a');
|
|
292
|
+
if (change === 'replaced') runtime.spawnActor({ id: 'a', components: {} });
|
|
293
|
+
if (change === 'awake') sleep('a', false);
|
|
294
|
+
assert.equal(needsSleepingModelPrewarm(world, runtime), true, change);
|
|
295
|
+
let clock = 0;
|
|
296
|
+
prewarmSleepingModels(world, runtime, { budgetMs: 4, now: () => clock += 5 });
|
|
297
|
+
assert.equal(world.models.get(aKey).template, aTemplate, `${change}: rebuild keeps candidates until sync`);
|
|
298
|
+
assert.equal(aDisposed(), 0, `${change}: no geometry disposal before sync`);
|
|
299
|
+
assert.equal(materialDisposals, 0, `${change}: no material disposal before sync`);
|
|
300
|
+
if (change === 'awake') {
|
|
301
|
+
world.emptyNodesOwned = world.emptyNodesBlocked = true;
|
|
302
|
+
sync();
|
|
303
|
+
assert.equal(aDisposed(), 0, 'a skipped renderer pass cannot prune the woken template');
|
|
304
|
+
assert.equal(world.nodes.has('a'), false, 'blocked pass has not acquired the woken actor yet');
|
|
305
|
+
delete world.emptyNodesOwned;
|
|
306
|
+
delete world.emptyNodesBlocked;
|
|
307
|
+
}
|
|
308
|
+
sync();
|
|
309
|
+
if (change === 'awake') {
|
|
310
|
+
assert.equal(world.nodes.get('a').modelKey, aKey);
|
|
311
|
+
assert.equal(world.models.get(aKey).template, aTemplate, 'woken actor reuses its parked template');
|
|
312
|
+
assert.equal(world.models.get(aKey).users, 1);
|
|
313
|
+
assert.equal(aDisposed(), 0, 'woken template geometry stays valid');
|
|
314
|
+
assert.equal(materialDisposals, 0, 'woken template materials stay valid');
|
|
315
|
+
} else {
|
|
316
|
+
assert.equal(world.models.has(aKey), false, `${change}: obsolete parked key pruned after sync`);
|
|
317
|
+
assert.ok(aDisposed() > 0, `${change}: geometry disposed after sync`);
|
|
318
|
+
assert.ok(materialDisposals > 0, `${change}: materials disposed after sync`);
|
|
319
|
+
}
|
|
320
|
+
assert.equal(world.models.get(bKey), bEntry, `${change}: remaining sleeper keeps its template`);
|
|
321
|
+
assert.equal(bEntry.users, 0);
|
|
322
|
+
assert.equal(world.models.get(cKey), cEntry, `${change}: live template preserved`);
|
|
323
|
+
assert.equal(cEntry.users, 1);
|
|
324
|
+
// Additional edits must replace parked builds rather than accumulate them.
|
|
325
|
+
runtime.files['b.pxmodel'] = model('#123456');
|
|
326
|
+
prewarmSleepingModels(world, runtime, { budgetMs: 100, now: () => 0 });
|
|
327
|
+
assert.equal(world.models.has(bKey), true, `${change}: next candidate also waits for sync`);
|
|
328
|
+
sync();
|
|
329
|
+
assert.equal(world.models.has(bKey), false, `${change}: next obsolete asset pruned after sync too`);
|
|
330
|
+
assert.ok(world.models.size <= 3, `${change}: bounded by current sleeper/live keys`);
|
|
331
|
+
disposeWorld(world);
|
|
332
|
+
}
|
|
333
|
+
// A build variant changes every sleeper's key; old keys with live users stay
|
|
334
|
+
// owned, even if no sleeper would take that version again.
|
|
335
|
+
{
|
|
336
|
+
const { world, runtime, sync, sleep } = fixture();
|
|
337
|
+
runtime.getActor('c').components.Model.file = 'a.pxmodel';
|
|
338
|
+
sync(); sleep('a'); sleep('b'); sync();
|
|
339
|
+
prewarmSleepingModels(world, runtime, { budgetMs: 100, now: () => 0 });
|
|
340
|
+
const liveKey = world.nodes.get('c').modelKey;
|
|
341
|
+
const live = world.models.get(liveKey);
|
|
342
|
+
const parkedKey = [...world.models.keys()].find(k => k.startsWith('b.pxmodel|'));
|
|
343
|
+
const disposed = onDispose(world.models.get(parkedKey).template);
|
|
344
|
+
Object.defineProperty(runtime, 'dropsEmptyParts', { value: true });
|
|
345
|
+
prewarmSleepingModels(world, runtime, { budgetMs: 100, now: () => 0 });
|
|
346
|
+
assert.equal(world.models.has(parkedKey), true, 'old build variant waits for sync');
|
|
347
|
+
assert.equal(world.models.get(liveKey), live, 'obsolete live variant retained before sync');
|
|
348
|
+
assert.equal(live.users, 1);
|
|
349
|
+
sync();
|
|
350
|
+
assert.equal(world.models.has(parkedKey), false, 'old build variant pruned after sync');
|
|
351
|
+
assert.ok(disposed() > 0);
|
|
352
|
+
assert.equal(world.models.get(world.nodes.get('c').modelKey).users, 1, 'live variant acquired during sync');
|
|
353
|
+
assert.equal(world.models.size, 2, 'two current variants remain after renderer sync');
|
|
354
|
+
disposeWorld(world);
|
|
355
|
+
}
|
|
356
|
+
console.log('sleeping models: deferred pruning disposes obsolete assets/art/variants and removed/replaced sleepers after sync, preserving woken templates and live users passed');
|
|
357
|
+
|
|
358
|
+
// Candidate membership can become stale between prewarm and renderer sync.
|
|
359
|
+
// Keep it until a fresh queue confirms what the sleepers currently need.
|
|
360
|
+
{
|
|
361
|
+
const { world, runtime, sync, sleep } = fixture();
|
|
362
|
+
sync(); sleep('a'); sleep('b'); sync();
|
|
363
|
+
prewarmSleepingModels(world, runtime, { budgetMs: 100, now: () => 0 });
|
|
364
|
+
const aKey = [...world.models.keys()].find(k => k.startsWith('a.pxmodel|'));
|
|
365
|
+
const bKey = [...world.models.keys()].find(k => k.startsWith('b.pxmodel|'));
|
|
366
|
+
const template = world.models.get(aKey).template;
|
|
367
|
+
const disposed = onDispose(template);
|
|
368
|
+
runtime.getActor('a').components.Model.file = 'c.pxmodel';
|
|
369
|
+
prewarmSleepingModels(world, runtime, { budgetMs: 100, now: () => 0 });
|
|
370
|
+
assert.ok(world.sleepingModelPrune.has(aKey));
|
|
371
|
+
runtime.getActor('b').components.Model.file = 'a.pxmodel';
|
|
372
|
+
sync();
|
|
373
|
+
assert.equal(world.models.get(aKey).template, template, 'a new sleeping consumer protects a stale candidate');
|
|
374
|
+
assert.equal(disposed(), 0);
|
|
375
|
+
prewarmSleepingModels(world, runtime, { budgetMs: 100, now: () => 0 });
|
|
376
|
+
sync();
|
|
377
|
+
assert.equal(world.models.get(aKey).template, template, 'fresh sleeper key set retains the needed candidate');
|
|
378
|
+
assert.equal(disposed(), 0);
|
|
379
|
+
assert.equal(world.models.has(bKey), false, 'truly obsolete candidate still pruned after sync');
|
|
380
|
+
sleep('b', false); sync();
|
|
381
|
+
assert.equal(world.models.get(world.nodes.get('b').modelKey).template, template, 'later wake reuses the retained build');
|
|
382
|
+
disposeWorld(world);
|
|
383
|
+
}
|
|
384
|
+
console.log('sleeping models: prune candidates recheck current sleepers after sync and survive blocked passes passed');
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
// A focused production-code bundle: Three, the builder and codec are minified
|
|
2
|
+
// together. Compare bytes with the unminified modules, including deferred work.
|
|
3
|
+
import assert from 'node:assert/strict';
|
|
4
|
+
import fs from 'node:fs';
|
|
5
|
+
import os from 'node:os';
|
|
6
|
+
import path from 'node:path';
|
|
7
|
+
import { fileURLToPath, pathToFileURL } from 'node:url';
|
|
8
|
+
import { rolldown } from 'rolldown';
|
|
9
|
+
import { files, freshModel } from './look-baseline.mjs';
|
|
10
|
+
|
|
11
|
+
const plain = await import('../engine3d/templatecache.js');
|
|
12
|
+
const { buildModelNode } = await import('../engine3d/pxmodel.js');
|
|
13
|
+
const { beginTemplateCapture, endTemplateCapture } = await import('../engine3d/kithooks.js');
|
|
14
|
+
const { bakingLater } = await import('../engine3d/look.js');
|
|
15
|
+
const { makeLookBake, stepLookBake } = await import('../engine3d/lookbake.js');
|
|
16
|
+
const { disposeNode } = await import('../engine3d/materials.js');
|
|
17
|
+
const entry = fileURLToPath(new URL('../engine3d/__template_cache_minified_test.js', import.meta.url));
|
|
18
|
+
const three = fileURLToPath(new URL('../node_modules/three/build/three.module.js', import.meta.url));
|
|
19
|
+
const physics2d = fileURLToPath(new URL('../../physics-2d/', import.meta.url));
|
|
20
|
+
const source = `
|
|
21
|
+
import * as THREE from 'three';
|
|
22
|
+
import { buildModelNode, parseModelCached } from './pxmodel';
|
|
23
|
+
import { beginTemplateCapture, endTemplateCapture } from './kithooks';
|
|
24
|
+
import { bakingLater } from './look';
|
|
25
|
+
import { makeLookBake, stepLookBake } from './lookbake';
|
|
26
|
+
export { serializeTemplate, deserializeTemplate } from './templatecache';
|
|
27
|
+
export { disposeNode } from './materials';
|
|
28
|
+
export const names = [THREE.Vector3.name, THREE.MeshPhysicalMaterial.name, THREE.BufferAttribute.name, THREE.BufferGeometry.name];
|
|
29
|
+
export function build(file, files, deferred) {
|
|
30
|
+
const model = parseModelCached(files[file]);
|
|
31
|
+
const queue = makeLookBake();
|
|
32
|
+
beginTemplateCapture();
|
|
33
|
+
try {
|
|
34
|
+
const make = () => buildModelNode(model, {}, files, file, [file], { optimize: true });
|
|
35
|
+
return { root: deferred ? bakingLater(queue, file, make) : make(), queue };
|
|
36
|
+
} finally { endTemplateCapture(); }
|
|
37
|
+
}
|
|
38
|
+
export function finish(queue) {
|
|
39
|
+
queue.now = () => 0;
|
|
40
|
+
while (queue.pending) stepLookBake(queue);
|
|
41
|
+
}
|
|
42
|
+
`;
|
|
43
|
+
const started = performance.now();
|
|
44
|
+
const bundle = await rolldown({ input: entry, platform: 'node', plugins: [{
|
|
45
|
+
name: 'template-cache-test-entry',
|
|
46
|
+
resolveId(specifier) {
|
|
47
|
+
if (specifier === entry) return entry;
|
|
48
|
+
if (specifier === 'three') return three;
|
|
49
|
+
if (specifier.startsWith('@imports/castle.physics-2d/')) {
|
|
50
|
+
const own = path.join(physics2d, specifier.slice(27));
|
|
51
|
+
for (const ext of ['', '.js', '.jsx']) if (fs.existsSync(own + ext)) return own + ext;
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
load(id) { if (id === entry) return source; },
|
|
55
|
+
}] });
|
|
56
|
+
const scratch = fs.mkdtempSync(path.join(os.tmpdir(), 'template-cache-minified-'));
|
|
57
|
+
const output = path.join(scratch, 'codec.mjs');
|
|
58
|
+
let models = 0, refusals = 0, roundTrips = 0;
|
|
59
|
+
try {
|
|
60
|
+
const { output: chunks } = await bundle.generate({ format: 'es', codeSplitting: false, minify: true, keepNames: false });
|
|
61
|
+
assert.equal(chunks.length, 1, 'codec and Three bundled into a single minified module');
|
|
62
|
+
fs.writeFileSync(output, chunks[0].code);
|
|
63
|
+
const minified = await import(pathToFileURL(output).href);
|
|
64
|
+
const originals = ['Vector3', 'MeshPhysicalMaterial', 'BufferAttribute', 'BufferGeometry'];
|
|
65
|
+
originals.forEach((name, index) => assert.notEqual(minified.names[index], name, `${name} is actually mangled`));
|
|
66
|
+
for (const file of Object.keys(files).sort()) for (const deferred of [false, true]) {
|
|
67
|
+
const model = freshModel(file);
|
|
68
|
+
const queue = makeLookBake();
|
|
69
|
+
const make = () => buildModelNode(model.parsed, {}, model.files, file, [file], { optimize: true });
|
|
70
|
+
let root;
|
|
71
|
+
beginTemplateCapture();
|
|
72
|
+
try { root = deferred ? bakingLater(queue, file, make) : make(); }
|
|
73
|
+
finally { endTemplateCapture(); }
|
|
74
|
+
const built = minified.build(file, model.files, deferred);
|
|
75
|
+
const expected = plain.serializeTemplate(root);
|
|
76
|
+
const actual = minified.serializeTemplate(built.root);
|
|
77
|
+
const label = `${file} (deferred=${deferred})`;
|
|
78
|
+
models++;
|
|
79
|
+
assert.equal(actual.reason, expected.reason, `${label}: refusal reasons stable under mangling`);
|
|
80
|
+
if (!expected.bytes) {
|
|
81
|
+
assert.ok(['art', 'metadata: unsupported class'].includes(actual.reason), `${label}: no name-based refusal`);
|
|
82
|
+
refusals++;
|
|
83
|
+
} else {
|
|
84
|
+
assert.ok(actual.bytes, `${label}: minified serialization succeeds`);
|
|
85
|
+
assert.deepEqual(Buffer.from(actual.bytes), Buffer.from(expected.bytes), `${label}: byte-identical construction encoding`);
|
|
86
|
+
const decoded = minified.deserializeTemplate(actual.bytes);
|
|
87
|
+
const cross = plain.deserializeTemplate(actual.bytes);
|
|
88
|
+
assert.ok(decoded && cross, `${label}: minified and unminified decoders accept the bytes`);
|
|
89
|
+
assert.deepEqual(Buffer.from(minified.serializeTemplate(decoded).bytes), Buffer.from(expected.bytes), `${label}: minified round trip`);
|
|
90
|
+
assert.deepEqual(Buffer.from(plain.serializeTemplate(cross).bytes), Buffer.from(expected.bytes), `${label}: unminified cross decode`);
|
|
91
|
+
minified.disposeNode(decoded); disposeNode(cross);
|
|
92
|
+
roundTrips++;
|
|
93
|
+
}
|
|
94
|
+
queue.now = () => 0;
|
|
95
|
+
while (queue.pending) stepLookBake(queue);
|
|
96
|
+
minified.finish(built.queue);
|
|
97
|
+
if (expected.bytes) assert.deepEqual(Buffer.from(minified.serializeTemplate(built.root).bytes), Buffer.from(plain.serializeTemplate(root).bytes), `${label}: baked bytes identical`);
|
|
98
|
+
disposeNode(root); minified.disposeNode(built.root);
|
|
99
|
+
}
|
|
100
|
+
assert.ok(refusals / models <= 0.1, 'at least 90% of fixtures remain representable under minification');
|
|
101
|
+
console.log(`minified template cache: ${models} kit/fixture builds, ${roundTrips} byte-identical round trips, ${refusals} expected refusals, 0 name-based refusals; Three class names ${originals.join('/')} -> ${minified.names.join('/')}; ${Buffer.byteLength(chunks[0].code)} bundled bytes; ${(performance.now() - started).toFixed(0)} ms`);
|
|
102
|
+
} finally {
|
|
103
|
+
await bundle.close();
|
|
104
|
+
if (fs.existsSync(output)) fs.unlinkSync(output);
|
|
105
|
+
fs.rmdirSync(scratch);
|
|
106
|
+
}
|