castle-web-cli 0.4.232 → 0.4.234
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/agent-failures.d.ts +8 -0
- package/dist/agent-failures.js +19 -2
- package/dist/agent-prompts.d.ts +1 -1
- package/dist/agent-prompts.js +10 -3
- package/dist/agent.d.ts +64 -3
- package/dist/agent.js +170 -81
- package/dist/api.d.ts +11 -0
- package/dist/api.js +43 -0
- package/dist/bundle.d.ts +64 -0
- package/dist/bundle.js +558 -2
- package/dist/castle-host/host.d.ts +18 -2
- package/dist/castle-host/host.js +844 -39
- package/dist/castleJson.d.ts +23 -2
- package/dist/castleJson.js +46 -2
- package/dist/check.d.ts +3 -1
- package/dist/check.js +20 -3
- package/dist/chunkLoader.d.ts +3 -0
- package/dist/chunkLoader.js +111 -0
- package/dist/devParty.d.ts +26 -0
- package/dist/devParty.js +231 -0
- package/dist/devSaveStorage.js +4 -0
- package/dist/devSessionStorage.js +50 -2
- package/dist/devSocial.d.ts +24 -0
- package/dist/devSocial.js +70 -0
- package/dist/ide.d.ts +2 -0
- package/dist/ide.js +119 -15
- package/dist/importPinMismatch.d.ts +22 -0
- package/dist/importPinMismatch.js +77 -0
- package/dist/importRegression.js +3 -15
- package/dist/imports.d.ts +10 -3
- package/dist/imports.js +88 -20
- package/dist/index.js +11 -4
- package/dist/init.js +1 -1
- package/dist/platformDoc.js +22 -0
- package/dist/routerFences.d.ts +5 -0
- package/dist/routerFences.js +12 -2
- package/dist/save-deck.d.ts +25 -1
- package/dist/save-deck.js +178 -9
- package/dist/serve.js +32 -11
- package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
- package/dist/shell/assets/index-MVLfNYd9.css +1 -0
- package/dist/shell/index.html +2 -2
- package/dist/taskSteer.d.ts +13 -0
- package/dist/taskSteer.js +22 -2
- package/dist/vitePlugins.d.ts +2 -1
- package/dist/vitePlugins.js +13 -0
- package/kits/base/castle.json +1 -1
- package/kits/base/package-lock.json +1 -1
- package/kits/base/sdk/README.md +339 -5
- package/kits/base/sdk/avatar.d.ts +6 -2
- package/kits/base/sdk/avatar.js +12 -4
- package/kits/base/sdk/castle.d.ts +7 -3
- package/kits/base/sdk/castle.js +2 -0
- package/kits/base/sdk/commands.d.ts +176 -1
- package/kits/base/sdk/commands.js +3 -0
- package/kits/base/sdk/display.d.ts +3 -0
- package/kits/base/sdk/display.js +9 -3
- package/kits/base/sdk/hub.d.ts +37 -6
- package/kits/base/sdk/hub.js +63 -4
- package/kits/base/sdk/multiplayer.d.ts +7 -1
- package/kits/base/sdk/multiplayer.js +148 -32
- package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
- package/kits/base/sdk/party.d.ts +23 -0
- package/kits/base/sdk/party.js +91 -0
- package/kits/base/sdk/reconnectBudget.d.ts +23 -0
- package/kits/base/sdk/reconnectBudget.js +96 -0
- package/kits/base/sdk/save.d.ts +38 -1
- package/kits/base/sdk/save.js +81 -7
- package/kits/base/sdk/server/hub.d.ts +117 -0
- package/kits/base/sdk/server/hub.js +119 -2
- package/kits/base/sdk/server/platformHandle.d.ts +43 -1
- package/kits/base/sdk/server/storage.d.ts +17 -0
- package/kits/base/sdk/server/storage.js +65 -3
- package/kits/base/sdk/server/wrapper.d.ts +43 -6
- package/kits/base/sdk/server/wrapper.js +93 -9
- package/kits/base/sdk/social.d.ts +9 -0
- package/kits/base/sdk/social.js +5 -0
- package/kits/hub-game/CLAUDE.md +451 -13
- package/kits/hub-game/README.md +63 -0
- package/kits/hub-game/blueprints/avatar-10.scene +28 -0
- package/kits/hub-game/blueprints/avatar-11.scene +28 -0
- package/kits/hub-game/blueprints/avatar-12.scene +28 -0
- package/kits/hub-game/blueprints/avatar-13.scene +28 -0
- package/kits/hub-game/blueprints/avatar-14.scene +28 -0
- package/kits/hub-game/blueprints/avatar-15.scene +28 -0
- package/kits/hub-game/blueprints/avatar-4.scene +28 -0
- package/kits/hub-game/blueprints/avatar-5.scene +28 -0
- package/kits/hub-game/blueprints/avatar-6.scene +28 -0
- package/kits/hub-game/blueprints/avatar-7.scene +28 -0
- package/kits/hub-game/blueprints/avatar-8.scene +28 -0
- package/kits/hub-game/blueprints/avatar-9.scene +28 -0
- package/kits/hub-game/castle.json +5 -5
- package/kits/hub-game/code/client/act.js +312 -0
- package/kits/hub-game/code/client/actionLayout.js +147 -0
- package/kits/hub-game/code/client/actionOverflow.js +556 -0
- package/kits/hub-game/code/client/actorBudget.js +47 -0
- package/kits/hub-game/code/client/arrivalCamera.js +50 -0
- package/kits/hub-game/code/client/askSlot.js +117 -0
- package/kits/hub-game/code/client/attention.js +11 -2
- package/kits/hub-game/code/client/avatar.js +311 -35
- package/kits/hub-game/code/client/avatarCap.js +228 -0
- package/kits/hub-game/code/client/avatarColors.js +70 -0
- package/kits/hub-game/code/client/avatarFaces.js +21 -0
- package/kits/hub-game/code/client/avatarShare.js +253 -0
- package/kits/hub-game/code/client/backVisibility.js +13 -0
- package/kits/hub-game/code/client/ballot.js +472 -0
- package/kits/hub-game/code/client/build.js +38 -0
- package/kits/hub-game/code/client/chat.js +41 -5
- package/kits/hub-game/code/client/chatModeration.js +5 -0
- package/kits/hub-game/code/client/chrome.js +2144 -160
- package/kits/hub-game/code/client/companion.js +716 -0
- package/kits/hub-game/code/client/companionDress.js +99 -0
- package/kits/hub-game/code/client/crowdNames.js +241 -0
- package/kits/hub-game/code/client/decor.js +515 -0
- package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
- package/kits/hub-game/code/client/doorErrors.js +39 -0
- package/kits/hub-game/code/client/earned.js +131 -0
- package/kits/hub-game/code/client/emoteBubble.js +75 -0
- package/kits/hub-game/code/client/fall.js +18 -0
- package/kits/hub-game/code/client/farAvatars.js +233 -0
- package/kits/hub-game/code/client/firstJoin.js +9 -2
- package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
- package/kits/hub-game/code/client/frameBatch.js +5 -0
- package/kits/hub-game/code/client/grab.js +368 -29
- package/kits/hub-game/code/client/hookLayer.js +385 -20
- package/kits/hub-game/code/client/hudCopy.js +51 -0
- package/kits/hub-game/code/client/hudRate.js +20 -0
- package/kits/hub-game/code/client/idle.js +177 -24
- package/kits/hub-game/code/client/interestCap.js +81 -0
- package/kits/hub-game/code/client/invites.js +231 -0
- package/kits/hub-game/code/client/joinError.js +9 -0
- package/kits/hub-game/code/client/keys.js +36 -0
- package/kits/hub-game/code/client/labelsNear.js +234 -0
- package/kits/hub-game/code/client/landscapeLayout.js +17 -0
- package/kits/hub-game/code/client/layoutCache.js +264 -0
- package/kits/hub-game/code/client/loadTelemetry.js +20 -0
- package/kits/hub-game/code/client/loadingCover.js +148 -0
- package/kits/hub-game/code/client/loadingEntry.js +8 -0
- package/kits/hub-game/code/client/menuIcons.js +34 -0
- package/kits/hub-game/code/client/menuRows.js +43 -0
- package/kits/hub-game/code/client/modelReady.js +7 -0
- package/kits/hub-game/code/client/pack.js +6 -2
- package/kits/hub-game/code/client/packFormat.js +3 -3
- package/kits/hub-game/code/client/padCueArrival.js +23 -0
- package/kits/hub-game/code/client/padCues.js +112 -0
- package/kits/hub-game/code/client/padOccupancy.js +88 -0
- package/kits/hub-game/code/client/padReadability.js +26 -0
- package/kits/hub-game/code/client/padRings.js +69 -0
- package/kits/hub-game/code/client/pushVisit.js +14 -0
- package/kits/hub-game/code/client/quality.js +205 -0
- package/kits/hub-game/code/client/qualityEntry.js +55 -0
- package/kits/hub-game/code/client/rehello.js +167 -0
- package/kits/hub-game/code/client/safeLayout.js +338 -0
- package/kits/hub-game/code/client/safeStyle.js +42 -0
- package/kits/hub-game/code/client/say.js +12 -3
- package/kits/hub-game/code/client/shot.js +146 -0
- package/kits/hub-game/code/client/shotFit.js +56 -0
- package/kits/hub-game/code/client/signIn.js +28 -0
- package/kits/hub-game/code/client/sound.js +63 -8
- package/kits/hub-game/code/client/soundscape.js +1151 -0
- package/kits/hub-game/code/client/soundscapeActions.js +99 -0
- package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
- package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
- package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
- package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
- package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
- package/kits/hub-game/code/client/soundscapeCues.js +362 -0
- package/kits/hub-game/code/client/soundscapeMap.js +181 -0
- package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
- package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
- package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
- package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
- package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
- package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
- package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
- package/kits/hub-game/code/client/soundscapeUi.js +211 -0
- package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
- package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
- package/kits/hub-game/code/client/spin.js +101 -0
- package/kits/hub-game/code/client/state.js +162 -1
- package/kits/hub-game/code/client/stuck.js +259 -0
- package/kits/hub-game/code/client/talk.js +714 -59
- package/kits/hub-game/code/client/tiers.js +543 -52
- package/kits/hub-game/code/client/toastBand.js +37 -0
- package/kits/hub-game/code/client/together.js +39 -2
- package/kits/hub-game/code/client/visibility.js +43 -0
- package/kits/hub-game/code/client/weakestLookBake.js +92 -0
- package/kits/hub-game/code/client/weakestTier.js +295 -0
- package/kits/hub-game/code/client/wear.js +461 -170
- package/kits/hub-game/code/client/worldLabels.js +241 -0
- package/kits/hub-game/code/client/yours.js +200 -0
- package/kits/hub-game/code/companionSpec.js +45 -0
- package/kits/hub-game/code/npcDisplayText.js +55 -0
- package/kits/hub-game/code/privateText.js +7 -0
- package/kits/hub-game/code/server/act.js +124 -0
- package/kits/hub-game/code/server/actions.js +138 -0
- package/kits/hub-game/code/server/actors.js +11 -2
- package/kits/hub-game/code/server/analytics.js +83 -0
- package/kits/hub-game/code/server/anonymousEntry.js +49 -0
- package/kits/hub-game/code/server/arrivalPose.js +36 -0
- package/kits/hub-game/code/server/ask.js +155 -0
- package/kits/hub-game/code/server/ballot.js +539 -0
- package/kits/hub-game/code/server/cells.js +100 -0
- package/kits/hub-game/code/server/companion.js +107 -0
- package/kits/hub-game/code/server/cues.js +70 -0
- package/kits/hub-game/code/server/decor.js +269 -0
- package/kits/hub-game/code/server/doorAnalytics.js +52 -0
- package/kits/hub-game/code/server/earned.js +478 -0
- package/kits/hub-game/code/server/frameBatch.js +183 -0
- package/kits/hub-game/code/server/friendBests.js +166 -0
- package/kits/hub-game/code/server/friendsAmong.js +272 -0
- package/kits/hub-game/code/server/history.js +7 -0
- package/kits/hub-game/code/server/hub.js +2510 -95
- package/kits/hub-game/code/server/idle.js +60 -12
- package/kits/hub-game/code/server/index.js +28 -6
- package/kits/hub-game/code/server/invites.js +19 -0
- package/kits/hub-game/code/server/labels.js +36 -2
- package/kits/hub-game/code/server/loadAbandon.js +106 -0
- package/kits/hub-game/code/server/manifest.js +586 -7
- package/kits/hub-game/code/server/menu.js +161 -0
- package/kits/hub-game/code/server/npcs.js +1025 -113
- package/kits/hub-game/code/server/observe.js +408 -0
- package/kits/hub-game/code/server/padOccupancy.js +85 -0
- package/kits/hub-game/code/server/party.js +2 -2
- package/kits/hub-game/code/server/players.js +30 -0
- package/kits/hub-game/code/server/resumePose.js +152 -0
- package/kits/hub-game/code/server/say.js +1 -1
- package/kits/hub-game/code/server/shot.js +110 -0
- package/kits/hub-game/code/server/standing.js +123 -0
- package/kits/hub-game/code/server/storageLimit.js +187 -0
- package/kits/hub-game/code/server/vis.js +175 -0
- package/kits/hub-game/code/server/wear.js +12 -0
- package/kits/hub-game/code/server/yours.js +59 -0
- package/kits/hub-game/code/shared/act.js +35 -0
- package/kits/hub-game/code/shared/cues.js +9 -0
- package/kits/hub-game/code/shared/danceIdle.js +28 -0
- package/kits/hub-game/code/shared/decor.js +41 -0
- package/kits/hub-game/code/shared/loadStages.js +12 -0
- package/kits/hub-game/code/shared/quality.js +74 -0
- package/kits/hub-game/code/shared/say.js +2 -0
- package/kits/hub-game/code/shared/shot.js +53 -0
- package/kits/hub-game/code/shared/spin.js +57 -0
- package/kits/hub-game/code/systems/hub.js +1753 -202
- package/kits/hub-game/docs/analytics.md +279 -0
- package/kits/hub-game/docs/content-pack.md +1 -1
- package/kits/hub-game/docs/contract.md +3475 -77
- package/kits/hub-game/docs/home-pieces.md +71 -0
- package/kits/hub-game/docs/observed-progress.md +252 -0
- package/kits/hub-game/main.jsx +2 -0
- package/kits/hub-game/models/avatar-10.pxmodel +28 -0
- package/kits/hub-game/models/avatar-11.pxmodel +28 -0
- package/kits/hub-game/models/avatar-12.pxmodel +27 -0
- package/kits/hub-game/models/avatar-13.pxmodel +24 -0
- package/kits/hub-game/models/avatar-14.pxmodel +29 -0
- package/kits/hub-game/models/avatar-15.pxmodel +24 -0
- package/kits/hub-game/models/avatar-4.pxmodel +29 -0
- package/kits/hub-game/models/avatar-5.pxmodel +27 -0
- package/kits/hub-game/models/avatar-6.pxmodel +26 -0
- package/kits/hub-game/models/avatar-7.pxmodel +25 -0
- package/kits/hub-game/models/avatar-8.pxmodel +24 -0
- package/kits/hub-game/models/avatar-9.pxmodel +30 -0
- package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
- package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
- package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
- package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
- package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
- package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
- package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
- package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
- package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
- package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
- package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
- package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
- package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
- package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
- package/kits/hub-game/models/hats/cap.pxmodel +162 -0
- package/kits/hub-game/models/hats/captain.pxmodel +178 -0
- package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
- package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
- package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
- package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
- package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
- package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
- package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
- package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
- package/kits/hub-game/models/hats/straw.pxmodel +139 -0
- package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
- package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
- package/kits/hub-game/models/hats/witch.pxmodel +147 -0
- package/kits/hub-game/package-lock.json +10 -1
- package/kits/hub-game/package.json +6 -2
- package/kits/hub-game/play/player.js +142 -0
- package/kits/hub-game/play/registry.js +47 -0
- package/kits/hub-game/play.jsx +37 -0
- package/kits/hub-game/scripts/check.mjs +117 -16
- package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
- package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
- package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
- package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
- package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
- package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
- package/kits/hub-game/scripts/gen-earned.mjs +285 -0
- package/kits/hub-game/scripts/gen-hats.mjs +827 -0
- package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
- package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
- package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
- package/kits/hub-game/scripts/test-act-client.mjs +186 -0
- package/kits/hub-game/scripts/test-act.mjs +171 -0
- package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
- package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
- package/kits/hub-game/scripts/test-actions.mjs +298 -0
- package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
- package/kits/hub-game/scripts/test-actors.mjs +38 -23
- package/kits/hub-game/scripts/test-analytics.mjs +76 -0
- package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
- package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
- package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
- package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
- package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
- package/kits/hub-game/scripts/test-ask.mjs +269 -0
- package/kits/hub-game/scripts/test-attention.mjs +10 -1
- package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
- package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
- package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
- package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
- package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
- package/kits/hub-game/scripts/test-avatar.mjs +584 -7
- package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
- package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
- package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
- package/kits/hub-game/scripts/test-build.mjs +49 -0
- package/kits/hub-game/scripts/test-cells.mjs +71 -0
- package/kits/hub-game/scripts/test-chat.mjs +863 -0
- package/kits/hub-game/scripts/test-classic.mjs +2 -0
- package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
- package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
- package/kits/hub-game/scripts/test-companion.mjs +259 -0
- package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
- package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
- package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
- package/kits/hub-game/scripts/test-decor.mjs +464 -0
- package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
- package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
- package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
- package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
- package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
- package/kits/hub-game/scripts/test-earned.mjs +1224 -0
- package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
- package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
- package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
- package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
- package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
- package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
- package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
- package/kits/hub-game/scripts/test-grab.mjs +7 -0
- package/kits/hub-game/scripts/test-hats.mjs +422 -168
- package/kits/hub-game/scripts/test-high-only.mjs +170 -0
- package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
- package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
- package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
- package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
- package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
- package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
- package/kits/hub-game/scripts/test-idle.mjs +427 -1
- package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
- package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
- package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
- package/kits/hub-game/scripts/test-interest.mjs +15 -0
- package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
- package/kits/hub-game/scripts/test-invites.mjs +109 -0
- package/kits/hub-game/scripts/test-keys.mjs +46 -1
- package/kits/hub-game/scripts/test-labels.mjs +664 -0
- package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
- package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
- package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
- package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
- package/kits/hub-game/scripts/test-manifest.mjs +472 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
- package/kits/hub-game/scripts/test-menu.mjs +319 -0
- package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
- package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
- package/kits/hub-game/scripts/test-observed.mjs +745 -0
- package/kits/hub-game/scripts/test-pack.mjs +7 -0
- package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
- package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
- package/kits/hub-game/scripts/test-picker.mjs +541 -0
- package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
- package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
- package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
- package/kits/hub-game/scripts/test-quality.mjs +385 -0
- package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
- package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
- package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
- package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
- package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
- package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
- package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
- package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
- package/kits/hub-game/scripts/test-say.mjs +1 -1
- package/kits/hub-game/scripts/test-shot.mjs +901 -0
- package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
- package/kits/hub-game/scripts/test-spin.mjs +314 -0
- package/kits/hub-game/scripts/test-standing.mjs +449 -0
- package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
- package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
- package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
- package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
- package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
- package/kits/hub-game/scripts/test-tiers.mjs +476 -2
- package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
- package/kits/hub-game/scripts/test-try-on.mjs +22 -22
- package/kits/hub-game/scripts/test-vis.mjs +770 -0
- package/kits/hub-game/scripts/test-visibility.mjs +134 -0
- package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
- package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
- package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
- package/kits/hub-game/scripts/test-yours.mjs +403 -0
- package/kits/multiplayer-3d/CLAUDE.md +50 -0
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/avatars.js +7 -0
- package/kits/multiplayer-3d/code/client/gait.js +65 -0
- package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
- package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
- package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
- package/kits/multiplayer-3d/code/options.js +5 -0
- package/kits/multiplayer-3d/code/server/ownership.js +10 -2
- package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
- package/kits/multiplayer-3d/code/server/world.js +7 -0
- package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
- package/kits/multiplayer-3d/package-lock.json +8 -1
- package/kits/multiplayer-3d/package.json +3 -1
- package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
- package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
- package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
- package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
- package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
- package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
- package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
- package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
- package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
- package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
- package/kits/physics-2d/CLAUDE.md +19 -1
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/frozenActors.js +233 -0
- package/kits/physics-2d/engine/scene.js +337 -3
- package/kits/physics-2d/engine/skyKey.js +129 -0
- package/kits/physics-2d/engine/stillClock.js +106 -0
- package/kits/physics-2d/engine/updateBudget.js +21 -0
- package/kits/physics-2d/eslint.config.js +1 -1
- package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
- package/kits/physics-2d/play/behaviors/Camera.js +40 -0
- package/kits/physics-2d/play/behaviors/Collider.js +122 -0
- package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
- package/kits/physics-2d/play/behaviors/Goal.js +46 -0
- package/kits/physics-2d/play/behaviors/Joints.js +126 -0
- package/kits/physics-2d/play/behaviors/Layout.js +71 -0
- package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
- package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
- package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
- package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
- package/kits/physics-2d/play/behaviors/Style.js +209 -0
- package/kits/physics-2d/play/behaviors/Text.js +85 -0
- package/kits/physics-2d/play/behaviors/Video.js +93 -0
- package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
- package/kits/physics-3d/CLAUDE.md +42 -529
- package/kits/physics-3d/behaviors/Body.jsx +3 -0
- package/kits/physics-3d/behaviors/Model.jsx +3 -0
- package/kits/physics-3d/behaviors/Player.jsx +661 -87
- package/kits/physics-3d/behaviors/Shape.jsx +3 -0
- package/kits/physics-3d/behaviors/Solid.jsx +3 -0
- package/kits/physics-3d/behaviors/Transform.jsx +3 -0
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/engine-camera.md +542 -0
- package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
- package/kits/physics-3d/docs/engine-load.md +149 -0
- package/kits/physics-3d/docs/engine-look.md +114 -0
- package/kits/physics-3d/docs/engine-shadows.md +372 -0
- package/kits/physics-3d/docs/engine-skip-work.md +187 -0
- package/kits/physics-3d/docs/engine-sky.md +198 -0
- package/kits/physics-3d/docs/engine-static-actors.md +226 -0
- package/kits/physics-3d/docs/engine-view.md +37 -0
- package/kits/physics-3d/docs/pxmodel-format.md +9 -1
- package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
- package/kits/physics-3d/engine3d/actornode.js +87 -0
- package/kits/physics-3d/engine3d/animationBudget.js +23 -0
- package/kits/physics-3d/engine3d/branches.js +3 -13
- package/kits/physics-3d/engine3d/cage.js +2 -7
- package/kits/physics-3d/engine3d/cageops.js +2 -17
- package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
- package/kits/physics-3d/engine3d/editorWorld.js +6 -0
- package/kits/physics-3d/engine3d/emptynodes.js +232 -0
- package/kits/physics-3d/engine3d/framecap.js +99 -0
- package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
- package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
- package/kits/physics-3d/engine3d/gait.js +126 -0
- package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
- package/kits/physics-3d/engine3d/kithooks.js +47 -0
- package/kits/physics-3d/engine3d/look.js +514 -48
- package/kits/physics-3d/engine3d/lookbake.js +208 -0
- package/kits/physics-3d/engine3d/materialpresets.js +2 -0
- package/kits/physics-3d/engine3d/modelFiles.js +3 -17
- package/kits/physics-3d/engine3d/modelMath.js +49 -0
- package/kits/physics-3d/engine3d/modelready.js +16 -0
- package/kits/physics-3d/engine3d/motion.js +39 -10
- package/kits/physics-3d/engine3d/nearshadows.js +106 -21
- package/kits/physics-3d/engine3d/optimize.js +9 -5
- package/kits/physics-3d/engine3d/orbitinput.js +522 -10
- package/kits/physics-3d/engine3d/orbitlens.js +48 -0
- package/kits/physics-3d/engine3d/ownmodel.js +213 -0
- package/kits/physics-3d/engine3d/partgeometry.js +1 -16
- package/kits/physics-3d/engine3d/paths.js +1 -9
- package/kits/physics-3d/engine3d/playTimings.js +50 -0
- package/kits/physics-3d/engine3d/playerRun.js +372 -0
- package/kits/physics-3d/engine3d/pxmodel.js +42 -11
- package/kits/physics-3d/engine3d/rapier.js +27 -0
- package/kits/physics-3d/engine3d/scatter.js +1 -11
- package/kits/physics-3d/engine3d/shadowfade.js +890 -0
- package/kits/physics-3d/engine3d/sky.js +547 -0
- package/kits/physics-3d/engine3d/skylife.js +306 -0
- package/kits/physics-3d/engine3d/squarefirst.js +177 -0
- package/kits/physics-3d/engine3d/stillshadows.js +399 -0
- package/kits/physics-3d/engine3d/sweep.js +1 -25
- package/kits/physics-3d/engine3d/unchanged.js +11 -0
- package/kits/physics-3d/engine3d/viewrange.js +52 -0
- package/kits/physics-3d/engine3d/world3d.js +1253 -76
- package/kits/physics-3d/eslint.config.js +2 -1
- package/kits/physics-3d/main.jsx +10 -2
- package/kits/physics-3d/package-lock.json +7 -0
- package/kits/physics-3d/package.json +5 -1
- package/kits/physics-3d/play/behaviors/Body.js +31 -0
- package/kits/physics-3d/play/behaviors/Door.js +37 -0
- package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
- package/kits/physics-3d/play/behaviors/Model.js +23 -0
- package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
- package/kits/physics-3d/play/behaviors/Player.js +1204 -0
- package/kits/physics-3d/play/behaviors/Shape.js +47 -0
- package/kits/physics-3d/play/behaviors/Solid.js +16 -0
- package/kits/physics-3d/play/behaviors/Transform.js +29 -0
- package/kits/physics-3d/pnpm-lock.yaml +8 -0
- package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
- package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
- package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
- package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
- package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
- package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
- package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
- package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
- package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
- package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
- package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
- package/kits/physics-3d/scripts/test-gait.mjs +387 -0
- package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
- package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
- package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
- package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
- package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
- package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
- package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
- package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
- package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
- package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
- package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
- package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
- package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
- package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
- package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
- package/kits/physics-3d/systems/physics3d.js +419 -9
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/client/connection.js +33 -10
- package/kits/real-time/code/client/gameHooks.js +2 -0
- package/kits/real-time/code/client/joinOverlay.js +9 -4
- package/kits/real-time/code/server/gameHooks.js +7 -0
- package/kits/real-time/code/server/session.js +102 -22
- package/kits/real-time/package-lock.json +1 -1
- package/package.json +2 -2
- package/dist/shell/assets/index-Cf61cNfT.css +0 -1
package/dist/imports.js
CHANGED
|
@@ -55,8 +55,14 @@ export function readImportVersion(deckDir, alias) {
|
|
|
55
55
|
// version string does, so a deck's copy is stamped with a digest of the kit's
|
|
56
56
|
// files, and a CLI of the same version whose own copy differs replaces it
|
|
57
57
|
// (`refreshStaleBuiltinImports`) before the deck is installed, served or saved
|
|
58
|
-
// -- otherwise a save ships whatever kit the deck happened to copy first.
|
|
59
|
-
//
|
|
58
|
+
// -- otherwise a save ships whatever kit the deck happened to copy first.
|
|
59
|
+
//
|
|
60
|
+
// A copy from another CLI version is left alone while installing and serving:
|
|
61
|
+
// what the editor shows does not change under anyone. Saving is different. A
|
|
62
|
+
// pin OLDER than this CLI is moved forward on save -- the copy replaced with
|
|
63
|
+
// this CLI's kit and the pin rewritten to this CLI's version, said out loud --
|
|
64
|
+
// because otherwise every save after a CLI update ships the old kit and nothing
|
|
65
|
+
// says so. A pin NEWER than this CLI is never moved: that would be a move back.
|
|
60
66
|
const BUILTIN_COPY_EXCLUDE = new Set(['node_modules', '.castle', 'dist', '.git']);
|
|
61
67
|
function builtinCopyFilter(kitDir) {
|
|
62
68
|
// The kit's own `imports/` is derived state, re-placed at the deck root.
|
|
@@ -106,11 +112,56 @@ export function copyBuiltinKit(kitDir, destDir, kit, version) {
|
|
|
106
112
|
fs.cpSync(kitDir, destDir, { recursive: true, verbatimSymlinks: true, filter: builtinCopyFilter(kitDir) });
|
|
107
113
|
writeBuiltinStamp(destDir, { source: 'builtin', kit, version, digest: builtinKitDigest(kitDir) });
|
|
108
114
|
}
|
|
115
|
+
const errorText = (e) => (e instanceof Error ? e.message : String(e));
|
|
116
|
+
// The `onUpdate` a builtin kit declares -- this CLI's copy or the deck's -- when
|
|
117
|
+
// it has one. Moving such a pin without running it would leave the deck's data
|
|
118
|
+
// unmigrated under new code.
|
|
119
|
+
function builtinUpdateHook(kitDir, destDir) {
|
|
120
|
+
for (const dir of [kitDir, destDir]) {
|
|
121
|
+
const declared = tryReadCastleJson(dir)?.onUpdate;
|
|
122
|
+
if (typeof declared === 'string' && declared.trim())
|
|
123
|
+
return declared.trim();
|
|
124
|
+
}
|
|
125
|
+
return null;
|
|
126
|
+
}
|
|
127
|
+
// Staged beside the old copy and swapped in whole, so a failed copy leaves the
|
|
128
|
+
// deck's import as it was, and no half-copied stage behind.
|
|
129
|
+
function swapInBuiltinKit(kitDir, destDir, kit, version) {
|
|
130
|
+
const staged = `${destDir}.refresh-${process.pid}`;
|
|
131
|
+
fs.rmSync(staged, { recursive: true, force: true });
|
|
132
|
+
try {
|
|
133
|
+
copyBuiltinKit(kitDir, staged, kit, version);
|
|
134
|
+
}
|
|
135
|
+
catch (e) {
|
|
136
|
+
if (fs.existsSync(staged))
|
|
137
|
+
unlockImportTree(staged);
|
|
138
|
+
fs.rmSync(staged, { recursive: true, force: true });
|
|
139
|
+
throw e;
|
|
140
|
+
}
|
|
141
|
+
unlockImportTree(destDir);
|
|
142
|
+
fs.rmSync(destDir, { recursive: true, force: true });
|
|
143
|
+
fs.renameSync(staged, destDir);
|
|
144
|
+
lockImportTree(destDir);
|
|
145
|
+
}
|
|
146
|
+
/** Whether x.y.z version `a` is older than `b`; false when either is not one. */
|
|
147
|
+
export function versionOlder(a, b) {
|
|
148
|
+
const parts = (version) => /^(\d+)\.(\d+)\.(\d+)/.exec(version)?.slice(1, 4).map(Number) ?? null;
|
|
149
|
+
const x = parts(a);
|
|
150
|
+
const y = parts(b);
|
|
151
|
+
if (!x || !y)
|
|
152
|
+
return false;
|
|
153
|
+
for (let i = 0; i < 3; i += 1)
|
|
154
|
+
if (x[i] !== y[i])
|
|
155
|
+
return x[i] < y[i];
|
|
156
|
+
return false;
|
|
157
|
+
}
|
|
109
158
|
/**
|
|
110
159
|
* Builtin imports whose copy differs from this CLI's kit of the same version,
|
|
111
|
-
* replaced with this CLI's.
|
|
160
|
+
* replaced with this CLI's. With `olderPins` (save-deck only), a builtin pinned
|
|
161
|
+
* at an older CLI version is replaced too and its pin moved to this CLI's
|
|
162
|
+
* version. Returns the aliases replaced.
|
|
112
163
|
*/
|
|
113
|
-
export async function refreshStaleBuiltinImports(deckDir, log = (message) => console.log(message)) {
|
|
164
|
+
export async function refreshStaleBuiltinImports(deckDir, log = (message) => console.log(message), options = {}) {
|
|
114
165
|
const pins = tryReadCastleJson(deckDir)?.imports ?? {};
|
|
115
166
|
const { getCliVersion } = await import('./init.js');
|
|
116
167
|
const cliVersion = getCliVersion();
|
|
@@ -118,38 +169,51 @@ export async function refreshStaleBuiltinImports(deckDir, log = (message) => con
|
|
|
118
169
|
// Never throws: a kit that cannot be refreshed is left as it is and named,
|
|
119
170
|
// and the ones that were are still returned (serve invalidates on them).
|
|
120
171
|
for (const [alias, pin] of Object.entries(pins)) {
|
|
121
|
-
if (pin?.source !== 'builtin'
|
|
172
|
+
if (pin?.source !== 'builtin')
|
|
173
|
+
continue;
|
|
174
|
+
const movePin = pin.version !== cliVersion;
|
|
175
|
+
if (movePin && !(options.olderPins && versionOlder(pin.version, cliVersion)))
|
|
122
176
|
continue;
|
|
123
177
|
const destDir = path.join(deckDir, IMPORTS_DIR, alias);
|
|
124
178
|
const kitDir = path.join(getKitsDir(), pin.kit ?? alias);
|
|
125
179
|
try {
|
|
126
180
|
if (!fs.existsSync(destDir) || !fs.existsSync(kitDir))
|
|
127
181
|
continue;
|
|
182
|
+
const hook = movePin ? builtinUpdateHook(kitDir, destDir) : null;
|
|
183
|
+
if (hook) {
|
|
184
|
+
log(`Left ${alias} at ${pin.version}, older than this CLI (${cliVersion}): the kit migrates a deck when its pin moves ` +
|
|
185
|
+
`(onUpdate: ${hook}), and no castle-web command runs that for a kit the CLI ships. Move it deliberately: run ` +
|
|
186
|
+
`imports/${alias}/${hook} on this deck (its header names the arguments it needs), then set the pin's version in castle.json to ${cliVersion}; the next save copies this CLI's kit.`);
|
|
187
|
+
continue;
|
|
188
|
+
}
|
|
128
189
|
const digest = builtinKitDigest(kitDir);
|
|
129
190
|
const stamp = readBuiltinStamp(destDir);
|
|
130
|
-
if (stamp?.digest === digest)
|
|
191
|
+
if (!movePin && stamp?.digest === digest)
|
|
131
192
|
continue;
|
|
132
|
-
if (!stamp && builtinKitDigest(destDir) === digest) {
|
|
193
|
+
if (!movePin && !stamp && builtinKitDigest(destDir) === digest) {
|
|
133
194
|
// A copy from before stamps, already this kit: stamp it and move on.
|
|
134
195
|
unlockImportTree(destDir);
|
|
135
196
|
writeBuiltinStamp(destDir, { source: 'builtin', kit: pin.kit ?? alias, version: cliVersion, digest });
|
|
136
197
|
lockImportTree(destDir);
|
|
137
198
|
continue;
|
|
138
199
|
}
|
|
139
|
-
|
|
140
|
-
// leaves the deck's import as it was.
|
|
141
|
-
const staged = `${destDir}.refresh-${process.pid}`;
|
|
142
|
-
fs.rmSync(staged, { recursive: true, force: true });
|
|
143
|
-
copyBuiltinKit(kitDir, staged, pin.kit ?? alias, cliVersion);
|
|
144
|
-
unlockImportTree(destDir);
|
|
145
|
-
fs.rmSync(destDir, { recursive: true, force: true });
|
|
146
|
-
fs.renameSync(staged, destDir);
|
|
147
|
-
lockImportTree(destDir);
|
|
200
|
+
swapInBuiltinKit(kitDir, destDir, pin.kit ?? alias, cliVersion);
|
|
148
201
|
refreshed.push(alias);
|
|
149
|
-
|
|
202
|
+
if (!movePin) {
|
|
203
|
+
log(`Refreshed ${alias}: this deck's copy differed from the ${pin.kit ?? alias} kit this CLI (${cliVersion}) ships.`);
|
|
204
|
+
continue;
|
|
205
|
+
}
|
|
206
|
+
try {
|
|
207
|
+
writeImportPin(deckDir, alias, { ...pin, version: cliVersion });
|
|
208
|
+
}
|
|
209
|
+
catch (e) {
|
|
210
|
+
log(`Replaced ${alias}'s files with this CLI's kit (${cliVersion}), but its pin was NOT moved from ${pin.version}: ${errorText(e)}`);
|
|
211
|
+
continue;
|
|
212
|
+
}
|
|
213
|
+
log(`Refreshed ${alias}: pinned at ${pin.version}, older than this CLI (${cliVersion}); now this CLI's kit, pin moved to ${cliVersion}.`);
|
|
150
214
|
}
|
|
151
215
|
catch (e) {
|
|
152
|
-
log(`Left ${alias} as it is: ${
|
|
216
|
+
log(`Left ${alias} as it is: ${errorText(e)}`);
|
|
153
217
|
}
|
|
154
218
|
}
|
|
155
219
|
if (refreshed.length) {
|
|
@@ -266,7 +330,7 @@ export async function resolveDeckRef(raw) {
|
|
|
266
330
|
}
|
|
267
331
|
// Only the `imports` key is ours; everything else in castle.json (deck identity,
|
|
268
332
|
// editor config) is preserved as-is.
|
|
269
|
-
function writeImportPin(dir, alias, pin) {
|
|
333
|
+
export function writeImportPin(dir, alias, pin) {
|
|
270
334
|
const existing = readCastleJson(dir) ?? {};
|
|
271
335
|
// Forks belong to the DECK, not to the pin: the files live in its own forks/
|
|
272
336
|
// and an import update or restore doesn't touch them. Writing a fresh pin over
|
|
@@ -477,6 +541,10 @@ export async function restoreMissingImports(deckDir) {
|
|
|
477
541
|
// truth: the pin stays as committed, and publish-kits compares the two
|
|
478
542
|
// to refuse bundling against files no pin describes.
|
|
479
543
|
writeImportVersion(destDir, { deckId: pin.deckId, version: source.updatedAt });
|
|
544
|
+
if (source.updatedAt !== pin.version) {
|
|
545
|
+
console.warn(`Import "${alias}" is pinned at ${pin.version}, but the server only has ${source.updatedAt}, so that is what was placed. ` +
|
|
546
|
+
'`castle-web check` and `save-deck` refuse until the two agree (see `--pin-installed-imports`).');
|
|
547
|
+
}
|
|
480
548
|
}
|
|
481
549
|
else if (pin?.source === 'builtin') {
|
|
482
550
|
// Scaffolded from the kit shipped with the CLI: the same copy is still
|
|
@@ -1077,7 +1145,7 @@ export async function updateImport(dir, options = {}) {
|
|
|
1077
1145
|
if (!pin.deckId) {
|
|
1078
1146
|
// A kit copied from the CLI updates with the CLI, not from the server.
|
|
1079
1147
|
if (options.alias)
|
|
1080
|
-
console.log(`"${alias}" came with this CLI; it
|
|
1148
|
+
console.log(`"${alias}" came with this CLI; it moves to a newer CLI's kit when the deck is saved with that CLI.`);
|
|
1081
1149
|
continue;
|
|
1082
1150
|
}
|
|
1083
1151
|
const source = await api.webDeckSource(pin.deckId).catch(() => null);
|
package/dist/index.js
CHANGED
|
@@ -38,6 +38,7 @@ const FLAGS_WITH_VALUES = new Set([
|
|
|
38
38
|
'-m',
|
|
39
39
|
'--reason',
|
|
40
40
|
'--remote',
|
|
41
|
+
'--base-url',
|
|
41
42
|
]);
|
|
42
43
|
// `--foo` is always a flag; a single dash only when it is one we know (`-m`).
|
|
43
44
|
// Anything else starting with `-` is a positional -- a path can begin with one,
|
|
@@ -184,7 +185,7 @@ function usage() {
|
|
|
184
185
|
castle-web serve [dir] [--port PORT] [--host HOST] [--open] [--detach]
|
|
185
186
|
castle-web restart [--port PORT]
|
|
186
187
|
castle-web screenshot [--out FILE] [--port PORT]
|
|
187
|
-
castle-web save-deck [dir] [--title TITLE] [--caption TEXT] [--visibility unlisted|private] [--force] (--force: save over a newer saved copy)
|
|
188
|
+
castle-web save-deck [dir] [--title TITLE] [--caption TEXT] [--visibility unlisted|private] [--force] [--pin-installed-imports] [--chunked-bundle] (--force: save over a newer saved copy; --pin-installed-imports: move import pins to the versions imports/ holds instead of refusing; --chunked-bundle: publish the JS as cacheable classic-script chunks, as castle.json "bundle": { "chunks": "classic" } does)
|
|
188
189
|
castle-web get-deck [dir] [--deck-id ID] [--force] (replaces the source if the deck is already there)
|
|
189
190
|
castle-web get-deck <dir> --side [--deck-id ID] [--json] (fetches the saved copy into <dir>/.castle/agent/saved-source/<stamp>/, touching nothing else)
|
|
190
191
|
castle-web source-status <dir> [--adopt] [--notify] [--json] (whether the deck's saved copy is newer than this folder)
|
|
@@ -195,7 +196,8 @@ function usage() {
|
|
|
195
196
|
castle-web revert-import-file <imports/...> [dir]
|
|
196
197
|
castle-web update-import [alias] [dir] [--check] [--revert] (re-fetches imports; no alias means all)
|
|
197
198
|
castle-web install [dir]
|
|
198
|
-
castle-web check [dir] (bundles the deck and its server, then runs each import's onCheck -- the same gates save-deck runs)
|
|
199
|
+
castle-web check [dir] [--pin-installed-imports] (bundles the deck and its server, then runs each import's onCheck -- the same gates save-deck runs)
|
|
200
|
+
castle-web bundle-chunks [dir] --out DIR [--base-url URL] (writes the classic chunked bundle: index.html plus <sha256>.js chunks named at URL, default ./)
|
|
199
201
|
castle-web save-version [-m MESSAGE] [paths...] [--dir DIR] (no paths saves the whole deck)
|
|
200
202
|
castle-web list-versions [version] [--dir DIR] (defaults to the latest version)
|
|
201
203
|
castle-web show-version <version> [--dir DIR] (diffs of the files that version changed)
|
|
@@ -555,7 +557,9 @@ async function main() {
|
|
|
555
557
|
const title = getFlagValue('--title');
|
|
556
558
|
const caption = getFlagValue('--caption');
|
|
557
559
|
const visibility = getFlagValue('--visibility');
|
|
558
|
-
|
|
560
|
+
const pinInstalledImports = hasFlag('--pin-installed-imports');
|
|
561
|
+
const chunkedBundle = hasFlag('--chunked-bundle');
|
|
562
|
+
await saveDeck(dir, { title, caption, visibility, force: hasFlag('--force'), pinInstalledImports, chunkedBundle });
|
|
559
563
|
break;
|
|
560
564
|
}
|
|
561
565
|
case 'get-deck': {
|
|
@@ -633,9 +637,12 @@ async function main() {
|
|
|
633
637
|
break;
|
|
634
638
|
}
|
|
635
639
|
case 'check': {
|
|
636
|
-
await check(findPositionalDir());
|
|
640
|
+
await check(findPositionalDir(), { pinInstalledImports: hasFlag('--pin-installed-imports') });
|
|
637
641
|
break;
|
|
638
642
|
}
|
|
643
|
+
case 'bundle-chunks':
|
|
644
|
+
await (await import('./bundle.js')).bundleChunksCommand(findPositionalDir(), getFlagValue('--out'), getFlagValue('--base-url'));
|
|
645
|
+
break;
|
|
639
646
|
// The version commands spend their positionals on their own arguments --
|
|
640
647
|
// paths to save, a version to list from or restore to -- so the deck dir is
|
|
641
648
|
// `--dir`, defaulting to the cwd.
|
package/dist/init.js
CHANGED
|
@@ -64,7 +64,7 @@ const BARE_SCAFFOLDS = [
|
|
|
64
64
|
// Registry version of castle-web-sdk to inject when scaffolding from a
|
|
65
65
|
// globally-installed castle-web (not from inside the workspace). Bumped
|
|
66
66
|
// alongside cli/sdk version bumps.
|
|
67
|
-
const PUBLISHED_SDK_VERSION = '0.4.
|
|
67
|
+
const PUBLISHED_SDK_VERSION = '0.4.49';
|
|
68
68
|
// Range, not a pin: `castle-web-fonts` is its own package precisely so a tenth
|
|
69
69
|
// face can ship without a cli release, and a caret range means an existing
|
|
70
70
|
// deck's next install picks it up. Nothing here has to move when it does.
|
package/dist/platformDoc.js
CHANGED
|
@@ -239,6 +239,28 @@ const COMMON_SECTIONS = `## Imports are read-only
|
|
|
239
239
|
- Exception: deliberate pixel art wants a fixed low-resolution backing store with \`image-rendering: pixelated\` CSS instead — don't DPR-scale that; the crisp chunky look is the point.
|
|
240
240
|
- **A WebGL canvas must be created with \`preserveDrawingBuffer: true\`, or every in-page capture of the deck comes back blank** — the Play panel's Snap and \`npm run screenshot\` both read the canvas after the frame has been shown, and by then the browser has cleared it, so the image is just the card's background. Pass it through whatever library makes the canvas: \`new THREE.WebGLRenderer({ preserveDrawingBuffer: true })\`, PixiJS \`app.init({ preserveDrawingBuffer: true })\`, or \`canvas.getContext('webgl2', { preserveDrawingBuffer: true })\`. A 2D canvas needs nothing, and kit decks already set it.
|
|
241
241
|
|
|
242
|
+
## Game clock
|
|
243
|
+
|
|
244
|
+
- **The deck is hidden and resumed in place, and the clock keeps running while it is hidden.** When the player leaves the feed, Castle keeps the deck alive but stops its \`requestAnimationFrame\` callbacks; \`Date.now()\` and \`performance.now()\` keep advancing, so on return the first frame and every clock reading jump by the whole absence -- minutes, or longer.
|
|
245
|
+
- **Drive simulation from the rAF timestamp with a clamped dt; the cap is the point.** A fixed-timestep accumulator needs the same cap on the time it accumulates. When a kit runs the loop and hands your code a \`dt\`, use that \`dt\` rather than reading a clock.
|
|
246
|
+
|
|
247
|
+
\`\`\`js
|
|
248
|
+
let last = performance.now();
|
|
249
|
+
function frame(now) {
|
|
250
|
+
const dt = Math.min(0.05, (now - last) / 1000);
|
|
251
|
+
last = now;
|
|
252
|
+
update(dt); // roundTime -= dt; cooldown = Math.max(0, cooldown - dt);
|
|
253
|
+
requestAnimationFrame(frame);
|
|
254
|
+
}
|
|
255
|
+
requestAnimationFrame(frame);
|
|
256
|
+
document.addEventListener('visibilitychange', () => {
|
|
257
|
+
if (!document.hidden) last = performance.now();
|
|
258
|
+
});
|
|
259
|
+
\`\`\`
|
|
260
|
+
|
|
261
|
+
- **Game time -- round timers, countdowns, cooldowns, respawns, a survival score -- is accumulated from that clamped dt, never from \`Date.now()\` or \`performance.now()\` minus a stored stamp.** \`performance.now() - roundStart\` or \`Date.now() < endsAt\` ends the round or expires the cooldown while nobody is looking. \`Date.now()\` is still right for what should track real time: daily rewards, ids, logs. This is about time the deck keeps itself: a server-authoritative clock (a multiplayer match timer, the hub's server simulation time) comes from the server the way the kit guides describe, and the server keeps running for the other players.
|
|
262
|
+
- **Pause what should not run while hidden** (music, a spawner on its own \`setInterval\`) on \`visibilitychange\`, and resume it when \`document.hidden\` is false again.
|
|
263
|
+
|
|
242
264
|
## Multiplayer
|
|
243
265
|
|
|
244
266
|
- **Read \`${MULTIPLAYER_DOC_REL}\` before writing or changing a server entry or client netcode by hand.** It carries what this section leaves out: the outbound frame budget in practice, the snapshot pattern, self-healing events, and the reconnect and disconnect handling a hand-rolled session gets wrong. A deck built on the \`castle.multiplayer-2d\` / \`castle.multiplayer-3d\` (or \`castle.turn-based\`) kits already does all of that and normally writes nothing against the raw session API.
|
package/dist/routerFences.d.ts
CHANGED
|
@@ -6,6 +6,10 @@ export interface TaskDirective {
|
|
|
6
6
|
hold?: true;
|
|
7
7
|
prompt: string;
|
|
8
8
|
}
|
|
9
|
+
export interface AnswerDirective {
|
|
10
|
+
target: string;
|
|
11
|
+
answer: string;
|
|
12
|
+
}
|
|
9
13
|
export interface BoardTask {
|
|
10
14
|
id: string;
|
|
11
15
|
title: string;
|
|
@@ -21,6 +25,7 @@ export declare function extractDirectives(full: string, opts?: {
|
|
|
21
25
|
directives: TaskDirective[];
|
|
22
26
|
checkoffs: string[];
|
|
23
27
|
stops: string[];
|
|
28
|
+
answers: AnswerDirective[];
|
|
24
29
|
prefs: string[];
|
|
25
30
|
sends: SendDirective[];
|
|
26
31
|
plan?: string;
|
package/dist/routerFences.js
CHANGED
|
@@ -116,6 +116,7 @@ opts = {}) {
|
|
|
116
116
|
const sends = [];
|
|
117
117
|
const checkoffs = [];
|
|
118
118
|
const stops = [];
|
|
119
|
+
const answers = [];
|
|
119
120
|
const prefs = [];
|
|
120
121
|
const listFence = (source, name, into) => {
|
|
121
122
|
const re = new RegExp('```' + name + '[ \\t]*\\r?\\n([\\s\\S]*?)```', 'g');
|
|
@@ -130,14 +131,22 @@ opts = {}) {
|
|
|
130
131
|
};
|
|
131
132
|
const { plan, rest } = takePlanFence(full);
|
|
132
133
|
const withoutLists = listFence(listFence(listFence(rest, 'castle-done', checkoffs), 'castle-stop', stops), 'castle-pref', prefs);
|
|
134
|
+
const withoutAnswers = withoutLists.replace(/```castle-answer[ \t]*\r?\n([\s\S]*?)```/g, (_match, body) => {
|
|
135
|
+
const lines = body.replace(/\r/g, '').trim().split('\n');
|
|
136
|
+
const target = (lines.shift() ?? '').trim();
|
|
137
|
+
const answer = lines.join('\n').trim();
|
|
138
|
+
if (target && answer)
|
|
139
|
+
answers.push({ target, answer });
|
|
140
|
+
return '';
|
|
141
|
+
});
|
|
133
142
|
const withoutSends = opts.sends
|
|
134
|
-
?
|
|
143
|
+
? withoutAnswers.replace(sendFenceRegex(), (_match, body) => {
|
|
135
144
|
const send = parseSendFenceBody(String(body));
|
|
136
145
|
if (send)
|
|
137
146
|
sends.push(send);
|
|
138
147
|
return '';
|
|
139
148
|
})
|
|
140
|
-
:
|
|
149
|
+
: withoutAnswers;
|
|
141
150
|
const cleaned = withoutSends.replace(taskFenceRegex(), (_match, body) => {
|
|
142
151
|
const directive = parseTaskFenceBody(String(body));
|
|
143
152
|
if (directive)
|
|
@@ -149,6 +158,7 @@ opts = {}) {
|
|
|
149
158
|
directives,
|
|
150
159
|
checkoffs,
|
|
151
160
|
stops,
|
|
161
|
+
answers,
|
|
152
162
|
prefs,
|
|
153
163
|
sends,
|
|
154
164
|
plan,
|
package/dist/save-deck.d.ts
CHANGED
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
import * as api from './api.js';
|
|
2
|
+
import { type BundleChunk } from './bundle.js';
|
|
2
3
|
import { type ExperimentConfig } from './castleJson.js';
|
|
3
4
|
import { type SavePrecondition } from './webSourceSync.js';
|
|
4
5
|
export { DeckTooLargeError, MAX_SCENE_DATA_BYTES, MAX_SOURCE_ARCHIVE_BYTES, sceneTooLargeMessage, sourceTooLargeMessage, } from './saveFailure.js';
|
|
5
6
|
export declare const SOURCE_ARCHIVE_EXCLUDES: string[];
|
|
6
7
|
export declare const SAVE_STAGE_TELEMETRY_PREFIX = "CASTLE_SAVE_TELEMETRY ";
|
|
7
8
|
export declare const SAVE_COVER_SELECTION_TELEMETRY_PREFIX = "CASTLE_SAVE_COVER_SELECTION ";
|
|
8
|
-
export type SaveStage = 'bundle' | 'cover' | 'scene_upload_config' | 'scene_upload' | 'content_publish' | 'server_publish' | 'source_archive' | 'source_upload_config' | 'source_upload' | 'source_commit';
|
|
9
|
+
export type SaveStage = 'bundle' | 'cover' | 'chunk_upload' | 'scene_upload_config' | 'scene_upload' | 'content_publish' | 'server_publish' | 'source_archive' | 'source_upload_config' | 'source_upload' | 'source_commit';
|
|
9
10
|
export declare function runTar(args: string[], opts?: {
|
|
10
11
|
capture?: boolean;
|
|
11
12
|
}): Promise<string>;
|
|
@@ -33,6 +34,22 @@ export declare const EXPERIMENTS_CLEAR_SETTLE_MS = 2000;
|
|
|
33
34
|
export declare function startClearingExperiments(deckId: string): {
|
|
34
35
|
settle(capMs?: number): Promise<void>;
|
|
35
36
|
};
|
|
37
|
+
export declare const BUNDLE_CHUNK_BASE_URL: string;
|
|
38
|
+
export declare const MAX_BUNDLE_CHUNK_BYTES: number;
|
|
39
|
+
export declare const CHUNK_BUSY_RETRY_MS: number[];
|
|
40
|
+
/**
|
|
41
|
+
* Puts every chunk at its content-addressed URL: a chunk already there (HEAD
|
|
42
|
+
* 200) is skipped, any other is uploaded and stored. Throws on the first chunk
|
|
43
|
+
* that cannot be stored, so the page naming them is never published without
|
|
44
|
+
* them. Exported for the tests.
|
|
45
|
+
*/
|
|
46
|
+
export declare function uploadBundleChunks(deckId: string, chunks: BundleChunk[], baseUrl?: string, { busyRetryMs }?: {
|
|
47
|
+
busyRetryMs?: number[];
|
|
48
|
+
}): Promise<{
|
|
49
|
+
uploaded: number;
|
|
50
|
+
skipped: number;
|
|
51
|
+
bytesUploaded: number;
|
|
52
|
+
}>;
|
|
36
53
|
export type SaveVisibility = 'unlisted' | 'private';
|
|
37
54
|
export interface SaveDeckOptions {
|
|
38
55
|
title?: string;
|
|
@@ -40,5 +57,12 @@ export interface SaveDeckOptions {
|
|
|
40
57
|
visibility?: SaveVisibility;
|
|
41
58
|
/** Save even when the deck's saved copy is newer than this folder. */
|
|
42
59
|
force?: boolean;
|
|
60
|
+
/** Move import pins to the versions imports/ holds, rather than refuse. */
|
|
61
|
+
pinInstalledImports?: boolean;
|
|
62
|
+
/** Publish a classic chunked bundle, as castle.json `"bundle": { "chunks": "classic" }` does. */
|
|
63
|
+
chunkedBundle?: boolean;
|
|
43
64
|
}
|
|
44
65
|
export declare function saveDeck(dir: string, opts?: SaveDeckOptions): Promise<void>;
|
|
66
|
+
export declare function builtinRefreshOptions(env?: NodeJS.ProcessEnv): {
|
|
67
|
+
olderPins: boolean;
|
|
68
|
+
};
|
package/dist/save-deck.js
CHANGED
|
@@ -5,14 +5,16 @@ import { spawn } from 'child_process';
|
|
|
5
5
|
import { nanoid } from 'nanoid';
|
|
6
6
|
import * as api from './api.js';
|
|
7
7
|
import * as config from './config.js';
|
|
8
|
-
import { bundleProject } from './bundle.js';
|
|
9
|
-
import { resolveServerConfig, validateExperiments } from './castleJson.js';
|
|
8
|
+
import { bundleProject, bundleProjectChunked } from './bundle.js';
|
|
9
|
+
import { resolveBundleChunks, resolveServerConfig, validateExperiments, } from './castleJson.js';
|
|
10
10
|
import { importChecksFailedMessage, runImportChecks } from './importCheckHook.js';
|
|
11
11
|
import { selectSaveCover } from './saveCover.js';
|
|
12
12
|
import { COVER_FILE } from './localPaths.js';
|
|
13
13
|
import { buildServerBundle } from './serverBundle.js';
|
|
14
14
|
import { buildContentPack } from './contentPack.js';
|
|
15
15
|
import { importRegressionMessage, importRegressions, savedDeckImportPins } from './importRegression.js';
|
|
16
|
+
import { isSandboxEnv } from './cloudGit.js';
|
|
17
|
+
import { settleImportPins } from './importPinMismatch.js';
|
|
16
18
|
import { refreshStaleBuiltinImports } from './imports.js';
|
|
17
19
|
import { decideSavePrecondition, EXIT_IMPORTS_OLDER, EXIT_SAVED_DECK_NEWER, fetchServerSourceVersion, readSyncMarker, saveRefusedLine, saveRefusedMessage, WEB_DECK_SOURCE_STALE_CODE, writeSyncMarker, } from './webSourceSync.js';
|
|
18
20
|
import { DeckTooLargeError, MAX_SCENE_DATA_BYTES, MAX_SOURCE_ARCHIVE_BYTES, SAVE_FAILURE_ENV, classifySaveFailure, saveFailedLine, sceneTooLargeMessage, sourceTooLargeMessage, } from './saveFailure.js';
|
|
@@ -378,6 +380,127 @@ async function uploadContentPack(deckId, pack) {
|
|
|
378
380
|
await uploadPresignedFile(config, new Blob([new Uint8Array(pack.bytes)], { type: 'application/json' }), 'application/json', LARGE_UPLOAD_TIMEOUT_MS, 'Content pack upload');
|
|
379
381
|
return config.uploadId;
|
|
380
382
|
}
|
|
383
|
+
// Where a chunked bundle's chunks are served from (ghost-server stores them
|
|
384
|
+
// there, at `<sha256>.js`). The override is for tests against a fake API.
|
|
385
|
+
export const BUNDLE_CHUNK_BASE_URL = process.env.CASTLE_BUNDLE_CHUNK_BASE_URL || 'https://hosted.castle.games/cauldron-chunks/';
|
|
386
|
+
// Ghost's per-chunk cap, uncompressed.
|
|
387
|
+
export const MAX_BUNDLE_CHUNK_BYTES = 8 * 1024 * 1024;
|
|
388
|
+
// Ghost stores at most two chunks at once per app process (Amendment 2 of the
|
|
389
|
+
// chunk contract); more in flight only buys CAULDRON_BUNDLE_CHUNK_BUSY retries.
|
|
390
|
+
const CHUNK_UPLOAD_CONCURRENCY = 2;
|
|
391
|
+
async function chunkAlreadyStored(url) {
|
|
392
|
+
try {
|
|
393
|
+
const res = await fetch(url, { method: 'HEAD', signal: AbortSignal.timeout(15_000) });
|
|
394
|
+
return res.status === 200;
|
|
395
|
+
}
|
|
396
|
+
catch {
|
|
397
|
+
// Unknown is "not there": uploading again is harmless, the bytes are the same.
|
|
398
|
+
return false;
|
|
399
|
+
}
|
|
400
|
+
}
|
|
401
|
+
// Ghost spends an upload grant before it reads the upload, so a grant that
|
|
402
|
+
// turned out invalid can only be retried from a new upload config.
|
|
403
|
+
const UPLOAD_GRANT_INVALID = 'CAULDRON_SERVER_BUNDLE_UPLOAD_GRANT_INVALID';
|
|
404
|
+
// Ghost is storing as many chunks as it will at once. Nothing was spent: the
|
|
405
|
+
// same upload is stored again after a wait, these waits, then the save fails.
|
|
406
|
+
const CHUNK_BUSY = 'CAULDRON_BUNDLE_CHUNK_BUSY';
|
|
407
|
+
export const CHUNK_BUSY_RETRY_MS = [500, 1000, 2000, 4000];
|
|
408
|
+
const errorCode = (e) => e?.extensions?.code;
|
|
409
|
+
async function storeWhenNotBusy(store, retryMs) {
|
|
410
|
+
for (let attempt = 0;; attempt++) {
|
|
411
|
+
try {
|
|
412
|
+
return await store();
|
|
413
|
+
}
|
|
414
|
+
catch (e) {
|
|
415
|
+
if (errorCode(e) !== CHUNK_BUSY || attempt >= retryMs.length)
|
|
416
|
+
throw e;
|
|
417
|
+
await new Promise((resolve) => setTimeout(resolve, retryMs[attempt]));
|
|
418
|
+
}
|
|
419
|
+
}
|
|
420
|
+
}
|
|
421
|
+
async function storeBundleChunk(deckId, chunk, busyRetryMs) {
|
|
422
|
+
const contentType = chunk.kind === 'wasm' ? 'application/wasm' : 'application/javascript';
|
|
423
|
+
const attempt = async () => {
|
|
424
|
+
const config = await api.createCauldronBundleChunkUploadConfig(deckId);
|
|
425
|
+
// FormData wants a Blob; copy so it does not share the Buffer's pool.
|
|
426
|
+
const view = new Uint8Array(chunk.bytes.byteLength);
|
|
427
|
+
view.set(chunk.bytes);
|
|
428
|
+
await uploadPresignedFile(config, new Blob([view], { type: contentType }), contentType, LARGE_UPLOAD_TIMEOUT_MS, `Chunk upload (${chunk.name})`);
|
|
429
|
+
const kind = chunk.kind === 'wasm' ? 'WASM' : 'JS';
|
|
430
|
+
return storeWhenNotBusy(() => api.storeCauldronBundleChunk(deckId, config.uploadId, chunk.sha256, kind), busyRetryMs);
|
|
431
|
+
};
|
|
432
|
+
try {
|
|
433
|
+
return await attempt();
|
|
434
|
+
}
|
|
435
|
+
catch (e) {
|
|
436
|
+
if (errorCode(e) !== UPLOAD_GRANT_INVALID)
|
|
437
|
+
throw e;
|
|
438
|
+
return attempt();
|
|
439
|
+
}
|
|
440
|
+
}
|
|
441
|
+
/**
|
|
442
|
+
* Puts every chunk at its content-addressed URL: a chunk already there (HEAD
|
|
443
|
+
* 200) is skipped, any other is uploaded and stored. Throws on the first chunk
|
|
444
|
+
* that cannot be stored, so the page naming them is never published without
|
|
445
|
+
* them. Exported for the tests.
|
|
446
|
+
*/
|
|
447
|
+
export async function uploadBundleChunks(deckId, chunks, baseUrl = BUNDLE_CHUNK_BASE_URL, { busyRetryMs = CHUNK_BUSY_RETRY_MS } = {}) {
|
|
448
|
+
for (const chunk of chunks) {
|
|
449
|
+
const bytes = chunk.bytes.byteLength;
|
|
450
|
+
if (bytes > MAX_BUNDLE_CHUNK_BYTES) {
|
|
451
|
+
throw new Error(`Chunk ${chunk.name} is ${(bytes / 1024 / 1024).toFixed(1)}MB; Castle stores chunks of at most ` +
|
|
452
|
+
`${MAX_BUNDLE_CHUNK_BYTES / 1024 / 1024}MB. Nothing was published.`);
|
|
453
|
+
}
|
|
454
|
+
}
|
|
455
|
+
const result = { uploaded: 0, skipped: 0, bytesUploaded: 0 };
|
|
456
|
+
const queue = [...chunks];
|
|
457
|
+
// The first failure fails the save: the other workers take no new chunk.
|
|
458
|
+
let failed = false;
|
|
459
|
+
const worker = async () => {
|
|
460
|
+
for (let chunk = queue.shift(); chunk && !failed; chunk = queue.shift()) {
|
|
461
|
+
const url = `${baseUrl}${chunk.fileName}`;
|
|
462
|
+
if (await chunkAlreadyStored(url)) {
|
|
463
|
+
result.skipped++;
|
|
464
|
+
continue;
|
|
465
|
+
}
|
|
466
|
+
const stored = await storeBundleChunk(deckId, chunk, busyRetryMs);
|
|
467
|
+
if (stored?.sha256 !== chunk.sha256 || stored.url !== url) {
|
|
468
|
+
throw new Error(`Chunk ${chunk.name} was stored as ${stored?.url ?? 'nothing'} (sha256 ${stored?.sha256 ?? 'none'}), ` +
|
|
469
|
+
`not ${url}. Nothing was published.`);
|
|
470
|
+
}
|
|
471
|
+
result.uploaded++;
|
|
472
|
+
result.bytesUploaded += chunk.bytes.byteLength;
|
|
473
|
+
}
|
|
474
|
+
};
|
|
475
|
+
const guarded = () => worker().catch((e) => {
|
|
476
|
+
failed = true;
|
|
477
|
+
throw e;
|
|
478
|
+
});
|
|
479
|
+
await Promise.all(Array.from({ length: Math.min(CHUNK_UPLOAD_CONCURRENCY, chunks.length) }, guarded));
|
|
480
|
+
return result;
|
|
481
|
+
}
|
|
482
|
+
function reportChunks(page) {
|
|
483
|
+
const chunkBytes = page.chunks.reduce((sum, c) => sum + c.bytes.byteLength, 0);
|
|
484
|
+
const initial = page.chunks.filter((c) => c.initial).length;
|
|
485
|
+
const wasm = page.chunks.filter((c) => c.kind === 'wasm').length;
|
|
486
|
+
console.log(`Chunks: ${page.chunks.length} (${initial} loaded at start${wasm ? `, ${wasm} wasm` : ''}), ` +
|
|
487
|
+
`${(chunkBytes / 1024).toFixed(1)}KB.`);
|
|
488
|
+
for (const warning of page.warnings)
|
|
489
|
+
console.warn(`Warning: ${warning}`);
|
|
490
|
+
}
|
|
491
|
+
async function storeChunks(deckId, chunks) {
|
|
492
|
+
const stored = await traceSaveStage('chunk_upload', () => uploadBundleChunks(deckId, chunks), (value) => ({ bytes: value.bytesUploaded }));
|
|
493
|
+
console.log(`Chunks stored: ${stored.uploaded} uploaded, ${stored.skipped} already there.`);
|
|
494
|
+
}
|
|
495
|
+
// Checked before anything is bundled or published, like the experiments block.
|
|
496
|
+
function checkedBundleChunks(castleJson, opts) {
|
|
497
|
+
try {
|
|
498
|
+
return resolveBundleChunks(castleJson, opts.chunkedBundle === true);
|
|
499
|
+
}
|
|
500
|
+
catch (e) {
|
|
501
|
+
throw new Error(`${e instanceof Error ? e.message : String(e)} Nothing was saved.`);
|
|
502
|
+
}
|
|
503
|
+
}
|
|
381
504
|
async function uploadLocalCover(projectDir) {
|
|
382
505
|
try {
|
|
383
506
|
const selected = await selectSaveCover(projectDir, { onProgress: (message) => console.log(message) });
|
|
@@ -463,14 +586,52 @@ export async function saveDeck(dir, opts = {}) {
|
|
|
463
586
|
throw error;
|
|
464
587
|
}
|
|
465
588
|
}
|
|
589
|
+
// A save from castle-www or from inside a cloud sandbox: decks there save
|
|
590
|
+
// exactly as they did, with these checks only warning.
|
|
591
|
+
function cloudSave(env) {
|
|
592
|
+
return env[SAVE_FAILURE_ENV] === '1' || isSandboxEnv(env);
|
|
593
|
+
}
|
|
594
|
+
// How save-deck refreshes builtin kits: a pin older than this CLI moves to its
|
|
595
|
+
// kit -- except in a cloud save, where decks save exactly as they did.
|
|
596
|
+
export function builtinRefreshOptions(env = process.env) {
|
|
597
|
+
return { olderPins: !cloudSave(env) };
|
|
598
|
+
}
|
|
599
|
+
// False (exit code set) when save-deck must stop because imports/ holds other
|
|
600
|
+
// versions than castle.json pins. castle-www's cloud save understands only its
|
|
601
|
+
// own refusal and cannot pass the flag, so in a cloud save this is a warning, as
|
|
602
|
+
// an import regression is (and as `check` in a sandbox does).
|
|
603
|
+
function importPinsSettled(dir, projectDir, opts) {
|
|
604
|
+
if (settleImportPins(projectDir, dir, 'save-deck', opts.pinInstalledImports === true))
|
|
605
|
+
return true;
|
|
606
|
+
if (cloudSave(process.env)) {
|
|
607
|
+
console.error('Saving anyway (cloud save).');
|
|
608
|
+
return true;
|
|
609
|
+
}
|
|
610
|
+
process.exitCode = 1;
|
|
611
|
+
return false;
|
|
612
|
+
}
|
|
466
613
|
async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
|
|
467
|
-
//
|
|
468
|
-
//
|
|
469
|
-
|
|
470
|
-
|
|
614
|
+
// First, before anything is changed or the network touched: imports/ holding
|
|
615
|
+
// other versions than the pins is a deck no pin describes.
|
|
616
|
+
if (!importPinsSettled(dir, projectDir, opts))
|
|
617
|
+
return;
|
|
618
|
+
// A builtin kit that changed under the same CLI version, or is pinned at an
|
|
619
|
+
// older CLI, is this CLI's again before anything is read, packed or bundled: a
|
|
620
|
+
// save never ships a stale copy, and the pins a refreshed kit adds are read here.
|
|
621
|
+
const refreshed = await refreshStaleBuiltinImports(projectDir, undefined, builtinRefreshOptions());
|
|
622
|
+
// A refresh can restore a kit's new imports, at whatever the server has now.
|
|
623
|
+
if (refreshed.length > 0 && !importPinsSettled(dir, projectDir, opts))
|
|
624
|
+
return;
|
|
471
625
|
const castleJson = readCastleJson(projectDir);
|
|
472
626
|
const existingDeckId = typeof castleJson?.deckId === 'string' && castleJson.deckId ? castleJson.deckId : null;
|
|
473
627
|
const experiments = checkedExperiments(castleJson);
|
|
628
|
+
const chunked = checkedBundleChunks(castleJson, opts);
|
|
629
|
+
if (chunked && !existingDeckId) {
|
|
630
|
+
// Ghost grants chunk uploads for a deck that exists; a new one is created
|
|
631
|
+
// by the publish itself, after the chunks must already be stored.
|
|
632
|
+
throw new Error('A chunked bundle can only be saved to a deck that already exists. Save once without ' +
|
|
633
|
+
'--chunked-bundle (or "bundle.chunks" in castle.json) first. Nothing was saved.');
|
|
634
|
+
}
|
|
474
635
|
// A deck without an id is new: the source commit sends no precondition, as before.
|
|
475
636
|
let expectedS3Key;
|
|
476
637
|
let markerVia = 'save-deck';
|
|
@@ -514,17 +675,22 @@ async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
|
|
|
514
675
|
// build, as far as publishing is concerned (and as castle-www's failed_at
|
|
515
676
|
// reports it).
|
|
516
677
|
const built = await traceSaveStage('bundle', async () => {
|
|
517
|
-
const
|
|
678
|
+
const page = chunked ? await bundleProjectChunked(projectDir) : null;
|
|
679
|
+
const html = page ? page.renderHtml(BUNDLE_CHUNK_BASE_URL) : await bundleProject(projectDir);
|
|
518
680
|
const { errors } = await runImportChecks(projectDir);
|
|
519
681
|
if (errors.length > 0)
|
|
520
682
|
throw new Error(importChecksFailedMessage(errors));
|
|
521
|
-
return { html
|
|
683
|
+
return { html, page, pack: await buildContentPack(projectDir) };
|
|
522
684
|
}, (value) => ({ bytes: Buffer.byteLength(value.html) }));
|
|
523
|
-
const { html: bundle, pack } = built;
|
|
685
|
+
const { html: bundle, page: chunkedPage, pack } = built;
|
|
524
686
|
if (pack)
|
|
525
687
|
console.log(`Content pack: ${pack.summary ?? `${pack.bytes.byteLength} bytes`} (${pack.sha256.slice(0, 12)}).`);
|
|
688
|
+
// In chunked mode this is the page alone: the chunks load as separate,
|
|
689
|
+
// cacheable scripts and are reported on their own line.
|
|
526
690
|
const sizeKB = bundle.length / 1024;
|
|
527
691
|
console.log(`Bundle size: ${sizeKB.toFixed(1)}KB`);
|
|
692
|
+
if (chunkedPage)
|
|
693
|
+
reportChunks(chunkedPage);
|
|
528
694
|
if (sizeKB > 1024) {
|
|
529
695
|
console.warn(`Warning: Bundle is ${(sizeKB / 1024).toFixed(1)}MB. Large bundles may load slowly.`);
|
|
530
696
|
}
|
|
@@ -548,6 +714,9 @@ async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
|
|
|
548
714
|
// transferred. The promise is deliberately non-throwing: a thumbnail must never make the
|
|
549
715
|
// content upload fail or create an unhandled rejection if that upload exits early.
|
|
550
716
|
const backgroundImageFileIdPromise = traceSaveStage('cover', () => uploadLocalCover(projectDir), (value) => ({ coverUploaded: value !== null }));
|
|
717
|
+
// Every chunk the page names is stored before the page itself is uploaded.
|
|
718
|
+
if (chunkedPage)
|
|
719
|
+
await storeChunks(deckId, chunkedPage.chunks);
|
|
551
720
|
// Upload scene data to S3
|
|
552
721
|
const configs = await traceSaveStage('scene_upload_config', async () => {
|
|
553
722
|
const result = await api.createSceneDataUploadConfig([cardId]);
|