castle-web-cli 0.4.231 → 0.4.233
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/castle-host/host.d.ts +1 -0
- package/dist/castle-host/host.js +51 -3
- package/dist/castleJson.d.ts +4 -2
- package/dist/castleJson.js +2 -0
- package/dist/check.d.ts +3 -1
- package/dist/check.js +11 -1
- package/dist/devSessionStorage.js +47 -1
- 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 +5 -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 +5 -0
- package/dist/save-deck.js +37 -4
- package/dist/serve.js +3 -0
- package/dist/serverBundle.js +5 -3
- package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
- 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/kits/base/castle.json +1 -1
- package/kits/base/package-lock.json +1 -1
- package/kits/base/sdk/README.md +79 -2
- package/kits/base/sdk/avatar.d.ts +6 -2
- package/kits/base/sdk/avatar.js +12 -4
- package/kits/base/sdk/castle.d.ts +1 -1
- package/kits/base/sdk/commands.d.ts +14 -0
- package/kits/base/sdk/hub.d.ts +6 -2
- package/kits/base/sdk/hub.js +13 -0
- package/kits/base/sdk/multiplayer.js +17 -1
- package/kits/base/sdk/save.js +2 -1
- package/kits/base/sdk/server/hub.d.ts +87 -0
- package/kits/base/sdk/server/hub.js +70 -0
- package/kits/base/sdk/server/platformHandle.d.ts +31 -1
- package/kits/base/sdk/server/storage.d.ts +13 -0
- package/kits/base/sdk/server/storage.js +46 -0
- package/kits/base/sdk/server/wrapper.d.ts +36 -5
- package/kits/base/sdk/server/wrapper.js +83 -8
- package/kits/hub-game/CLAUDE.md +352 -12
- 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/code/client/actorBudget.js +47 -0
- package/kits/hub-game/code/client/attention.js +11 -2
- package/kits/hub-game/code/client/avatar.js +345 -32
- 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 +251 -0
- package/kits/hub-game/code/client/ballot.js +467 -0
- package/kits/hub-game/code/client/build.js +22 -0
- package/kits/hub-game/code/client/chat.js +12 -0
- package/kits/hub-game/code/client/chrome.js +1334 -50
- 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/decor.js +509 -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/grab.js +363 -20
- package/kits/hub-game/code/client/hats.js +26 -0
- package/kits/hub-game/code/client/hookLayer.js +328 -15
- package/kits/hub-game/code/client/hudClear.js +126 -0
- package/kits/hub-game/code/client/idle.js +163 -22
- package/kits/hub-game/code/client/interestCap.js +81 -0
- package/kits/hub-game/code/client/keys.js +36 -0
- package/kits/hub-game/code/client/labelsNear.js +205 -0
- package/kits/hub-game/code/client/menuIcons.js +34 -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/rehello.js +167 -0
- package/kits/hub-game/code/client/shot.js +92 -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 +131 -1
- package/kits/hub-game/code/client/stuck.js +259 -0
- package/kits/hub-game/code/client/talk.js +538 -47
- package/kits/hub-game/code/client/tiers.js +541 -27
- package/kits/hub-game/code/client/toastBand.js +37 -0
- package/kits/hub-game/code/client/together.js +98 -1
- package/kits/hub-game/code/client/visibility.js +43 -0
- package/kits/hub-game/code/client/wear.js +470 -97
- package/kits/hub-game/code/client/yours.js +199 -0
- package/kits/hub-game/code/companionSpec.js +45 -0
- package/kits/hub-game/code/privateText.js +7 -0
- package/kits/hub-game/code/server/actions.js +133 -0
- package/kits/hub-game/code/server/actors.js +14 -1
- 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 +82 -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/earned.js +461 -0
- package/kits/hub-game/code/server/friendBests.js +166 -0
- package/kits/hub-game/code/server/friendsAmong.js +232 -0
- package/kits/hub-game/code/server/grab.js +296 -11
- package/kits/hub-game/code/server/history.js +5 -0
- package/kits/hub-game/code/server/hub.js +1317 -52
- package/kits/hub-game/code/server/idle.js +30 -11
- package/kits/hub-game/code/server/index.js +2 -2
- package/kits/hub-game/code/server/labels.js +28 -2
- package/kits/hub-game/code/server/manifest.js +424 -8
- package/kits/hub-game/code/server/menu.js +133 -0
- package/kits/hub-game/code/server/npcs.js +830 -80
- package/kits/hub-game/code/server/party.js +13 -2
- package/kits/hub-game/code/server/players.js +22 -0
- package/kits/hub-game/code/server/say.js +8 -2
- package/kits/hub-game/code/server/shot.js +110 -0
- package/kits/hub-game/code/server/standing.js +124 -0
- package/kits/hub-game/code/server/vis.js +113 -0
- package/kits/hub-game/code/server/wear.js +128 -11
- package/kits/hub-game/code/server/yours.js +59 -0
- package/kits/hub-game/code/shared/cues.js +9 -0
- package/kits/hub-game/code/shared/decor.js +41 -0
- package/kits/hub-game/code/shared/shot.js +19 -0
- package/kits/hub-game/code/shared/spin.js +57 -0
- package/kits/hub-game/code/systems/hub.js +1083 -85
- package/kits/hub-game/docs/content-pack.md +1 -1
- package/kits/hub-game/docs/contract.md +2440 -61
- package/kits/hub-game/docs/home-pieces.md +64 -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 +2 -0
- package/kits/hub-game/package.json +2 -1
- package/kits/hub-game/scripts/check.mjs +78 -11
- package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
- package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -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/soundscape-wave-analysis.mjs +125 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +488 -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 +19 -17
- package/kits/hub-game/scripts/test-ask-client.mjs +358 -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 +753 -0
- package/kits/hub-game/scripts/test-avatar.mjs +540 -7
- package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
- package/kits/hub-game/scripts/test-build.mjs +31 -0
- package/kits/hub-game/scripts/test-cells.mjs +71 -0
- package/kits/hub-game/scripts/test-chat.mjs +694 -0
- package/kits/hub-game/scripts/test-classic.mjs +2 -0
- package/kits/hub-game/scripts/test-companion-chat.mjs +198 -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-decor-client.mjs +303 -0
- package/kits/hub-game/scripts/test-decor.mjs +457 -0
- package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
- package/kits/hub-game/scripts/test-earned.mjs +1194 -0
- package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
- package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
- package/kits/hub-game/scripts/test-grab-client.mjs +186 -3
- package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
- package/kits/hub-game/scripts/test-grab.mjs +864 -3
- package/kits/hub-game/scripts/test-hats.mjs +483 -0
- package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
- package/kits/hub-game/scripts/test-hub-trip.mjs +1228 -1
- package/kits/hub-game/scripts/test-hud-clear.mjs +1000 -0
- package/kits/hub-game/scripts/test-idle.mjs +361 -1
- package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
- package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
- package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
- package/kits/hub-game/scripts/test-keys.mjs +46 -1
- package/kits/hub-game/scripts/test-labels.mjs +596 -0
- package/kits/hub-game/scripts/test-manifest.mjs +282 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
- package/kits/hub-game/scripts/test-menu.mjs +296 -0
- package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
- package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
- package/kits/hub-game/scripts/test-pack.mjs +7 -0
- package/kits/hub-game/scripts/test-party.mjs +22 -1
- package/kits/hub-game/scripts/test-picker.mjs +314 -0
- package/kits/hub-game/scripts/test-rehello.mjs +1039 -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-say.mjs +59 -2
- package/kits/hub-game/scripts/test-shot.mjs +756 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
- package/kits/hub-game/scripts/test-spin.mjs +314 -0
- package/kits/hub-game/scripts/test-standing.mjs +416 -0
- package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
- package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
- package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
- package/kits/hub-game/scripts/test-tiers.mjs +666 -3
- package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
- package/kits/hub-game/scripts/test-try-on.mjs +940 -0
- package/kits/hub-game/scripts/test-vis.mjs +343 -0
- package/kits/hub-game/scripts/test-visibility.mjs +134 -0
- package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
- package/kits/hub-game/scripts/test-yours.mjs +372 -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/nameTags.js +59 -4
- 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 +74 -4
- package/kits/multiplayer-3d/package.json +2 -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-own-name-tag.mjs +247 -0
- package/kits/physics-2d/CLAUDE.md +9 -0
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/scene.js +288 -1
- 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/scripts/test-skip-unchanged.mjs +370 -1
- package/kits/physics-3d/CLAUDE.md +1391 -0
- package/kits/physics-3d/behaviors/Player.jsx +921 -3
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/pxmodel-format.md +12 -0
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +98 -10
- package/kits/physics-3d/engine3d/actornode.js +86 -0
- package/kits/physics-3d/engine3d/animationBudget.js +23 -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 +96 -0
- package/kits/physics-3d/engine3d/gait.js +118 -0
- package/kits/physics-3d/engine3d/kithooks.js +47 -0
- package/kits/physics-3d/engine3d/look.js +507 -48
- package/kits/physics-3d/engine3d/lookbake.js +208 -0
- package/kits/physics-3d/engine3d/materialpresets.js +2 -0
- package/kits/physics-3d/engine3d/motion.js +39 -10
- package/kits/physics-3d/engine3d/nearshadows.js +37 -19
- package/kits/physics-3d/engine3d/optimize.js +58 -5
- package/kits/physics-3d/engine3d/orbitinput.js +755 -0
- package/kits/physics-3d/engine3d/orbitlens.js +48 -0
- package/kits/physics-3d/engine3d/ownmodel.js +213 -0
- package/kits/physics-3d/engine3d/pxmodel.js +42 -11
- package/kits/physics-3d/engine3d/shadowfade.js +882 -0
- package/kits/physics-3d/engine3d/sky.js +547 -0
- package/kits/physics-3d/engine3d/skylife.js +306 -0
- 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 +870 -87
- package/kits/physics-3d/main.jsx +5 -0
- package/kits/physics-3d/package.json +1 -1
- package/kits/physics-3d/scripts/Player.before-orbit.mjs +310 -0
- package/kits/physics-3d/scripts/Scene3DPlayer.before-orbit.jsx +337 -0
- package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
- package/kits/physics-3d/scripts/test-camera-follow.mjs +12 -2
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +4588 -0
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +787 -0
- package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
- package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -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 +3 -0
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
- package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
- package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
- package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -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-static-actors.mjs +13 -1
- package/kits/physics-3d/scripts/test-static-passes.mjs +1 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
- package/kits/physics-3d/scripts/test-steady-hover.mjs +635 -0
- package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
- package/kits/physics-3d/systems/physics3d.js +474 -12
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/server/gameHooks.js +7 -0
- package/kits/real-time/code/server/session.js +97 -19
- package/package.json +2 -2
- package/dist/shell/assets/index-Cf61cNfT.css +0 -1
|
@@ -407,6 +407,46 @@ const OPERATIONS = {
|
|
|
407
407
|
},
|
|
408
408
|
};
|
|
409
409
|
export async function runDevStorageOperation(deckId, op, args, connectedUserIds = []) {
|
|
410
|
+
if (args.place !== undefined && args.place !== 'town') {
|
|
411
|
+
return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'unknown storage place');
|
|
412
|
+
}
|
|
413
|
+
const town = args.place === 'town';
|
|
414
|
+
if (town) {
|
|
415
|
+
if (!['get', 'set', 'delete', 'increment'].includes(op) || args.scope !== 'DECK') {
|
|
416
|
+
return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires a plain deck-scope operation');
|
|
417
|
+
}
|
|
418
|
+
if (typeof args.subject !== 'string' || !args.subject || Buffer.byteLength(args.subject) > 256) {
|
|
419
|
+
return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires a user id of at most 256 bytes');
|
|
420
|
+
}
|
|
421
|
+
const entries = args.entries;
|
|
422
|
+
if (op === 'set' && !Array.isArray(entries)) {
|
|
423
|
+
return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires entries');
|
|
424
|
+
}
|
|
425
|
+
const keys = op === 'increment' ? [args.key]
|
|
426
|
+
: op === 'set' && Array.isArray(entries) ? entries.map((entry) => entry?.key)
|
|
427
|
+
: args.keys;
|
|
428
|
+
if (!Array.isArray(keys)) {
|
|
429
|
+
return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', 'town storage requires keys');
|
|
430
|
+
}
|
|
431
|
+
for (const key of keys) {
|
|
432
|
+
const segments = typeof key === 'string' ? key.split(':') : [];
|
|
433
|
+
// The same namespaces ghost allows (tokens, spent, own, hat, chirp).
|
|
434
|
+
if (!['tokens', 'spent', 'own', 'hat', 'chirp'].includes(segments[0]) || segments[1] !== args.subject) {
|
|
435
|
+
return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', `invalid town storage key ${JSON.stringify(key)}`);
|
|
436
|
+
}
|
|
437
|
+
}
|
|
438
|
+
// Dev has no trusted door-to-town binding. Isolate these rows in the DEV
|
|
439
|
+
// deck's own scope so an author testing a door never edits a real town.
|
|
440
|
+
const plain = { ...args };
|
|
441
|
+
delete plain.place;
|
|
442
|
+
args = { ...plain, scope: 'DECK', subject: null };
|
|
443
|
+
if (op === 'increment')
|
|
444
|
+
args.key = `town/${keys[0]}`;
|
|
445
|
+
else if (op === 'set')
|
|
446
|
+
args.entries = entries.map((entry) => ({ ...entry, key: `town/${String(entry.key)}` }));
|
|
447
|
+
else
|
|
448
|
+
args.keys = keys.map((key) => `town/${String(key)}`);
|
|
449
|
+
}
|
|
410
450
|
const operation = OPERATIONS[op];
|
|
411
451
|
if (!operation) {
|
|
412
452
|
return failure('CAULDRON_STORAGE_INVALID_ARGUMENT', `unknown storage operation ${op}`);
|
|
@@ -469,7 +509,13 @@ export async function runDevStorageOperation(deckId, op, args, connectedUserIds
|
|
|
469
509
|
},
|
|
470
510
|
};
|
|
471
511
|
}
|
|
472
|
-
|
|
512
|
+
const value = response.data?.[operation.field] ?? null;
|
|
513
|
+
return {
|
|
514
|
+
ok: true,
|
|
515
|
+
value: town && op === 'get' && Array.isArray(value)
|
|
516
|
+
? value.map((entry) => ({ ...entry, key: entry.key.slice('town/'.length) }))
|
|
517
|
+
: value,
|
|
518
|
+
};
|
|
473
519
|
}
|
|
474
520
|
catch (error) {
|
|
475
521
|
return failure('CAULDRON_STORAGE_UNAVAILABLE', error instanceof Error ? error.message : 'storage request failed');
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { type ImportVersion } from './imports.js';
|
|
2
|
+
export interface ImportPinMismatch {
|
|
3
|
+
alias: string;
|
|
4
|
+
pinned: ImportVersion;
|
|
5
|
+
installed: ImportVersion;
|
|
6
|
+
/**
|
|
7
|
+
* Whether `--pin-installed-imports` may move this pin: only forward, within
|
|
8
|
+
* the same deck. Pinning older files, or another deck's, would quietly roll
|
|
9
|
+
* the deck back or swap what it imports; those go through update-import.
|
|
10
|
+
*/
|
|
11
|
+
pinnable: boolean;
|
|
12
|
+
}
|
|
13
|
+
export declare function importPinMismatches(deckDir: string): ImportPinMismatch[];
|
|
14
|
+
export declare function importPinMismatchMessage(dir: string, command: 'check' | 'save-deck', mismatches: ImportPinMismatch[], pinInstalled?: boolean): string;
|
|
15
|
+
/**
|
|
16
|
+
* Whether `command` may go on to build: true when every fetched import's files
|
|
17
|
+
* match its pin, or when `pinInstalled` moved the pins that did not (each move
|
|
18
|
+
* logged; only when every one of them moves forward). Otherwise the refusal is
|
|
19
|
+
* printed and false returned, with nothing written. Silent, and castle.json
|
|
20
|
+
* untouched, when nothing differs.
|
|
21
|
+
*/
|
|
22
|
+
export declare function settleImportPins(deckDir: string, dir: string, command: 'check' | 'save-deck', pinInstalled: boolean): boolean;
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { readCastleJson } from './castleJson.js';
|
|
2
|
+
import { readImportVersion, writeImportPin } from './imports.js';
|
|
3
|
+
function movesForward(pinned, installed) {
|
|
4
|
+
if (pinned.deckId !== installed.deckId)
|
|
5
|
+
return false;
|
|
6
|
+
const from = Date.parse(pinned.version);
|
|
7
|
+
const to = Date.parse(installed.version);
|
|
8
|
+
return Number.isFinite(from) && Number.isFinite(to) && to > from;
|
|
9
|
+
}
|
|
10
|
+
export function importPinMismatches(deckDir) {
|
|
11
|
+
const pins = readCastleJson(deckDir)?.imports ?? {};
|
|
12
|
+
const out = [];
|
|
13
|
+
for (const [alias, pin] of Object.entries(pins)) {
|
|
14
|
+
if (!pin?.deckId || typeof pin.version !== 'string')
|
|
15
|
+
continue;
|
|
16
|
+
const installed = readImportVersion(deckDir, alias);
|
|
17
|
+
if (!installed)
|
|
18
|
+
continue;
|
|
19
|
+
if (installed.deckId === pin.deckId && installed.version === pin.version)
|
|
20
|
+
continue;
|
|
21
|
+
const pinned = { deckId: pin.deckId, version: pin.version };
|
|
22
|
+
out.push({ alias, pinned, installed, pinnable: movesForward(pinned, installed) });
|
|
23
|
+
}
|
|
24
|
+
return out;
|
|
25
|
+
}
|
|
26
|
+
function describe(from, to) {
|
|
27
|
+
return from.deckId === to.deckId
|
|
28
|
+
? [from.version, to.version]
|
|
29
|
+
: [`deck ${from.deckId} ${from.version}`, `deck ${to.deckId} ${to.version}`];
|
|
30
|
+
}
|
|
31
|
+
export function importPinMismatchMessage(dir, command, mismatches, pinInstalled = false) {
|
|
32
|
+
const remedy = (m) => {
|
|
33
|
+
if (m.pinnable)
|
|
34
|
+
return 'installed is newer: `--pin-installed-imports` pins it';
|
|
35
|
+
const why = m.installed.deckId !== m.pinned.deckId ? 'installed is another deck' : 'installed is not newer';
|
|
36
|
+
return `${why}: run \`castle-web update-import ${m.alias} ${dir}\``;
|
|
37
|
+
};
|
|
38
|
+
const lines = [
|
|
39
|
+
`${command === 'save-deck' ? 'Not saved' : 'Check failed'}: imports/ holds other versions than castle.json pins:`,
|
|
40
|
+
...mismatches.map((m) => {
|
|
41
|
+
const [pinned, installed] = describe(m.pinned, m.installed);
|
|
42
|
+
return ` ${m.alias}: pinned ${pinned}, installed ${installed} -- ${remedy(m)}`;
|
|
43
|
+
}),
|
|
44
|
+
];
|
|
45
|
+
if (pinInstalled) {
|
|
46
|
+
lines.push('--pin-installed-imports only moves a pin forward within the same deck, so nothing was moved.');
|
|
47
|
+
}
|
|
48
|
+
lines.push('The server keeps only the latest version of a deck, so `castle-web install` cannot put a pinned one back.');
|
|
49
|
+
if (mismatches.some((m) => m.pinnable)) {
|
|
50
|
+
lines.push(` castle-web ${command} ${dir} --pin-installed-imports move the newer ones' pins to what is installed`);
|
|
51
|
+
}
|
|
52
|
+
lines.push(` castle-web update-import <alias> ${dir} fetch the latest version and pin it, then play the deck to check it`);
|
|
53
|
+
return lines.join('\n');
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Whether `command` may go on to build: true when every fetched import's files
|
|
57
|
+
* match its pin, or when `pinInstalled` moved the pins that did not (each move
|
|
58
|
+
* logged; only when every one of them moves forward). Otherwise the refusal is
|
|
59
|
+
* printed and false returned, with nothing written. Silent, and castle.json
|
|
60
|
+
* untouched, when nothing differs.
|
|
61
|
+
*/
|
|
62
|
+
export function settleImportPins(deckDir, dir, command, pinInstalled) {
|
|
63
|
+
const mismatches = importPinMismatches(deckDir);
|
|
64
|
+
if (mismatches.length === 0)
|
|
65
|
+
return true;
|
|
66
|
+
if (!pinInstalled || mismatches.some((m) => !m.pinnable)) {
|
|
67
|
+
console.error(importPinMismatchMessage(dir, command, mismatches, pinInstalled));
|
|
68
|
+
return false;
|
|
69
|
+
}
|
|
70
|
+
const pins = readCastleJson(deckDir)?.imports ?? {};
|
|
71
|
+
for (const m of mismatches) {
|
|
72
|
+
writeImportPin(deckDir, m.alias, { ...pins[m.alias], ...m.installed });
|
|
73
|
+
const [pinned, installed] = describe(m.pinned, m.installed);
|
|
74
|
+
console.log(`${m.alias}: pin moved ${pinned} -> ${installed}`);
|
|
75
|
+
}
|
|
76
|
+
return true;
|
|
77
|
+
}
|
package/dist/importRegression.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import * as zlib from 'zlib';
|
|
2
2
|
import * as api from './api.js';
|
|
3
|
-
import { readImportVersion } from './imports.js';
|
|
3
|
+
import { readImportVersion, versionOlder } from './imports.js';
|
|
4
4
|
/** The import pins in the saved deck's castle.json, or null when it can't be read. */
|
|
5
5
|
export async function savedDeckImportPins(deckId, fetchArchive = fetchBytes) {
|
|
6
6
|
const source = await api.webDeckSource(deckId);
|
|
@@ -49,22 +49,10 @@ export function tarFileText(tar, want) {
|
|
|
49
49
|
}
|
|
50
50
|
return null;
|
|
51
51
|
}
|
|
52
|
-
function semverParts(version) {
|
|
53
|
-
const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version);
|
|
54
|
-
return match ? match.slice(1, 4).map(Number) : null;
|
|
55
|
-
}
|
|
56
52
|
/** Whether `a` is an older version than `b` of the same kind of pin; false when unsure. */
|
|
57
53
|
function older(a, aVersion, b) {
|
|
58
|
-
if (a.source === 'builtin' && b.source === 'builtin')
|
|
59
|
-
|
|
60
|
-
const y = semverParts(b.version);
|
|
61
|
-
if (!x || !y)
|
|
62
|
-
return false;
|
|
63
|
-
for (let i = 0; i < 3; i += 1)
|
|
64
|
-
if (x[i] !== y[i])
|
|
65
|
-
return x[i] < y[i];
|
|
66
|
-
return false;
|
|
67
|
-
}
|
|
54
|
+
if (a.source === 'builtin' && b.source === 'builtin')
|
|
55
|
+
return versionOlder(aVersion, b.version);
|
|
68
56
|
if (a.deckId && a.deckId === b.deckId) {
|
|
69
57
|
const x = Date.parse(aVersion);
|
|
70
58
|
const y = Date.parse(b.version);
|
package/dist/imports.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { IMPORTS_DIR, IMPORT_VERSION_FILE } from './castleJson.js';
|
|
1
|
+
import { IMPORTS_DIR, IMPORT_VERSION_FILE, type DeckImport } from './castleJson.js';
|
|
2
2
|
export { IMPORTS_DIR, IMPORT_VERSION_FILE };
|
|
3
3
|
export interface ImportVersion {
|
|
4
4
|
deckId: string;
|
|
@@ -17,11 +17,17 @@ export declare function builtinKitDigest(kitDir: string): string;
|
|
|
17
17
|
export declare function writeBuiltinStamp(importDir: string, stamp: BuiltinImportStamp): void;
|
|
18
18
|
/** A builtin kit copied into a deck, stamped. `destDir` must not exist. */
|
|
19
19
|
export declare function copyBuiltinKit(kitDir: string, destDir: string, kit: string, version: string): void;
|
|
20
|
+
/** Whether x.y.z version `a` is older than `b`; false when either is not one. */
|
|
21
|
+
export declare function versionOlder(a: string, b: string): boolean;
|
|
20
22
|
/**
|
|
21
23
|
* Builtin imports whose copy differs from this CLI's kit of the same version,
|
|
22
|
-
* replaced with this CLI's.
|
|
24
|
+
* replaced with this CLI's. With `olderPins` (save-deck only), a builtin pinned
|
|
25
|
+
* at an older CLI version is replaced too and its pin moved to this CLI's
|
|
26
|
+
* version. Returns the aliases replaced.
|
|
23
27
|
*/
|
|
24
|
-
export declare function refreshStaleBuiltinImports(deckDir: string, log?: (message: string) => void
|
|
28
|
+
export declare function refreshStaleBuiltinImports(deckDir: string, log?: (message: string) => void, options?: {
|
|
29
|
+
olderPins?: boolean;
|
|
30
|
+
}): Promise<string[]>;
|
|
25
31
|
export type ImportErrorCode = 'no-deck-ref' | 'bad-deck-ref' | 'not-a-deck-link' | 'link-unreachable' | 'no-such-dir' | 'self-import' | 'classic-deck' | 'no-source' | 'bad-alias' | 'already-imported';
|
|
26
32
|
export declare class ImportError extends Error {
|
|
27
33
|
code: ImportErrorCode;
|
|
@@ -29,6 +35,7 @@ export declare class ImportError extends Error {
|
|
|
29
35
|
}
|
|
30
36
|
export declare function parseDeckRef(raw: string): string | null;
|
|
31
37
|
export declare function resolveDeckRef(raw: string): Promise<string | null>;
|
|
38
|
+
export declare function writeImportPin(dir: string, alias: string, pin: DeckImport): void;
|
|
32
39
|
export declare function lockImportTree(dir: string): void;
|
|
33
40
|
export declare function syncImportDependencies(deckDir: string): string[];
|
|
34
41
|
export declare function restoreMissingImports(deckDir: string): Promise<string[]>;
|
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
|
@@ -184,7 +184,7 @@ function usage() {
|
|
|
184
184
|
castle-web serve [dir] [--port PORT] [--host HOST] [--open] [--detach]
|
|
185
185
|
castle-web restart [--port PORT]
|
|
186
186
|
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)
|
|
187
|
+
castle-web save-deck [dir] [--title TITLE] [--caption TEXT] [--visibility unlisted|private] [--force] [--pin-installed-imports] (--force: save over a newer saved copy; --pin-installed-imports: move import pins to the versions imports/ holds instead of refusing)
|
|
188
188
|
castle-web get-deck [dir] [--deck-id ID] [--force] (replaces the source if the deck is already there)
|
|
189
189
|
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
190
|
castle-web source-status <dir> [--adopt] [--notify] [--json] (whether the deck's saved copy is newer than this folder)
|
|
@@ -195,7 +195,7 @@ function usage() {
|
|
|
195
195
|
castle-web revert-import-file <imports/...> [dir]
|
|
196
196
|
castle-web update-import [alias] [dir] [--check] [--revert] (re-fetches imports; no alias means all)
|
|
197
197
|
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)
|
|
198
|
+
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)
|
|
199
199
|
castle-web save-version [-m MESSAGE] [paths...] [--dir DIR] (no paths saves the whole deck)
|
|
200
200
|
castle-web list-versions [version] [--dir DIR] (defaults to the latest version)
|
|
201
201
|
castle-web show-version <version> [--dir DIR] (diffs of the files that version changed)
|
|
@@ -555,7 +555,8 @@ async function main() {
|
|
|
555
555
|
const title = getFlagValue('--title');
|
|
556
556
|
const caption = getFlagValue('--caption');
|
|
557
557
|
const visibility = getFlagValue('--visibility');
|
|
558
|
-
|
|
558
|
+
const pinInstalledImports = hasFlag('--pin-installed-imports');
|
|
559
|
+
await saveDeck(dir, { title, caption, visibility, force: hasFlag('--force'), pinInstalledImports });
|
|
559
560
|
break;
|
|
560
561
|
}
|
|
561
562
|
case 'get-deck': {
|
|
@@ -633,7 +634,7 @@ async function main() {
|
|
|
633
634
|
break;
|
|
634
635
|
}
|
|
635
636
|
case 'check': {
|
|
636
|
-
await check(findPositionalDir());
|
|
637
|
+
await check(findPositionalDir(), { pinInstalledImports: hasFlag('--pin-installed-imports') });
|
|
637
638
|
break;
|
|
638
639
|
}
|
|
639
640
|
// The version commands spend their positionals on their own arguments --
|
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.47';
|
|
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
|
@@ -40,5 +40,10 @@ export interface SaveDeckOptions {
|
|
|
40
40
|
visibility?: SaveVisibility;
|
|
41
41
|
/** Save even when the deck's saved copy is newer than this folder. */
|
|
42
42
|
force?: boolean;
|
|
43
|
+
/** Move import pins to the versions imports/ holds, rather than refuse. */
|
|
44
|
+
pinInstalledImports?: boolean;
|
|
43
45
|
}
|
|
44
46
|
export declare function saveDeck(dir: string, opts?: SaveDeckOptions): Promise<void>;
|
|
47
|
+
export declare function builtinRefreshOptions(env?: NodeJS.ProcessEnv): {
|
|
48
|
+
olderPins: boolean;
|
|
49
|
+
};
|
package/dist/save-deck.js
CHANGED
|
@@ -13,6 +13,8 @@ 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';
|
|
@@ -463,11 +465,42 @@ export async function saveDeck(dir, opts = {}) {
|
|
|
463
465
|
throw error;
|
|
464
466
|
}
|
|
465
467
|
}
|
|
468
|
+
// A save from castle-www or from inside a cloud sandbox: decks there save
|
|
469
|
+
// exactly as they did, with these checks only warning.
|
|
470
|
+
function cloudSave(env) {
|
|
471
|
+
return env[SAVE_FAILURE_ENV] === '1' || isSandboxEnv(env);
|
|
472
|
+
}
|
|
473
|
+
// How save-deck refreshes builtin kits: a pin older than this CLI moves to its
|
|
474
|
+
// kit -- except in a cloud save, where decks save exactly as they did.
|
|
475
|
+
export function builtinRefreshOptions(env = process.env) {
|
|
476
|
+
return { olderPins: !cloudSave(env) };
|
|
477
|
+
}
|
|
478
|
+
// False (exit code set) when save-deck must stop because imports/ holds other
|
|
479
|
+
// versions than castle.json pins. castle-www's cloud save understands only its
|
|
480
|
+
// own refusal and cannot pass the flag, so in a cloud save this is a warning, as
|
|
481
|
+
// an import regression is (and as `check` in a sandbox does).
|
|
482
|
+
function importPinsSettled(dir, projectDir, opts) {
|
|
483
|
+
if (settleImportPins(projectDir, dir, 'save-deck', opts.pinInstalledImports === true))
|
|
484
|
+
return true;
|
|
485
|
+
if (cloudSave(process.env)) {
|
|
486
|
+
console.error('Saving anyway (cloud save).');
|
|
487
|
+
return true;
|
|
488
|
+
}
|
|
489
|
+
process.exitCode = 1;
|
|
490
|
+
return false;
|
|
491
|
+
}
|
|
466
492
|
async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
|
|
467
|
-
//
|
|
468
|
-
//
|
|
469
|
-
|
|
470
|
-
|
|
493
|
+
// First, before anything is changed or the network touched: imports/ holding
|
|
494
|
+
// other versions than the pins is a deck no pin describes.
|
|
495
|
+
if (!importPinsSettled(dir, projectDir, opts))
|
|
496
|
+
return;
|
|
497
|
+
// A builtin kit that changed under the same CLI version, or is pinned at an
|
|
498
|
+
// older CLI, is this CLI's again before anything is read, packed or bundled: a
|
|
499
|
+
// save never ships a stale copy, and the pins a refreshed kit adds are read here.
|
|
500
|
+
const refreshed = await refreshStaleBuiltinImports(projectDir, undefined, builtinRefreshOptions());
|
|
501
|
+
// A refresh can restore a kit's new imports, at whatever the server has now.
|
|
502
|
+
if (refreshed.length > 0 && !importPinsSettled(dir, projectDir, opts))
|
|
503
|
+
return;
|
|
471
504
|
const castleJson = readCastleJson(projectDir);
|
|
472
505
|
const existingDeckId = typeof castleJson?.deckId === 'string' && castleJson.deckId ? castleJson.deckId : null;
|
|
473
506
|
const experiments = checkedExperiments(castleJson);
|
package/dist/serve.js
CHANGED
|
@@ -856,6 +856,8 @@ function devHubVisit(ws, playSessionSlot, projectDir, multiplayer, multiplayerUr
|
|
|
856
856
|
entry.mp.url = multiplayerUrl;
|
|
857
857
|
return entry.visit;
|
|
858
858
|
}
|
|
859
|
+
// Account hearts shared across the dev serve's panels, never persisted.
|
|
860
|
+
const localHubHearts = new Map();
|
|
859
861
|
// Commands in flight on each socket, so a deck's cancel or a closed socket can
|
|
860
862
|
// abort a streaming one.
|
|
861
863
|
const commandAborts = new WeakMap();
|
|
@@ -891,6 +893,7 @@ async function handleCastleCommand(ws, projectDir, broadcast, multiplayer, multi
|
|
|
891
893
|
const save = devSaveGraphql(projectDir, ctx.userId, query, variables);
|
|
892
894
|
return save ? Promise.resolve(save) : castleGraphql(query, variables);
|
|
893
895
|
},
|
|
896
|
+
localHubHearts,
|
|
894
897
|
oracleStream,
|
|
895
898
|
showLeaderboard: (payload) => broadcast({ type: 'castle_leaderboard_show', payload }),
|
|
896
899
|
hub: devHubVisit(ws, playSessionSlot, projectDir, multiplayer, multiplayerUrl),
|