castle-web-cli 0.4.233 → 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/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 +17 -2
- package/dist/castle-host/host.js +793 -36
- package/dist/castleJson.d.ts +20 -1
- package/dist/castleJson.js +44 -2
- package/dist/check.js +9 -2
- 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 +3 -1
- 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/index.js +8 -2
- package/dist/init.js +1 -1
- package/dist/save-deck.d.ts +20 -1
- package/dist/save-deck.js +141 -5
- package/dist/serve.js +29 -11
- package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
- package/dist/shell/index.html +1 -1
- package/dist/vitePlugins.d.ts +2 -1
- package/dist/vitePlugins.js +13 -0
- package/kits/base/castle.json +1 -1
- package/kits/base/sdk/README.md +260 -3
- package/kits/base/sdk/castle.d.ts +7 -3
- package/kits/base/sdk/castle.js +2 -0
- package/kits/base/sdk/commands.d.ts +162 -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 +33 -6
- package/kits/base/sdk/hub.js +50 -4
- package/kits/base/sdk/multiplayer.d.ts +7 -1
- package/kits/base/sdk/multiplayer.js +140 -40
- 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 +79 -6
- package/kits/base/sdk/server/hub.d.ts +31 -1
- package/kits/base/sdk/server/hub.js +50 -3
- package/kits/base/sdk/server/platformHandle.d.ts +13 -1
- package/kits/base/sdk/server/storage.d.ts +4 -0
- package/kits/base/sdk/server/storage.js +19 -3
- package/kits/base/sdk/server/wrapper.d.ts +7 -1
- package/kits/base/sdk/server/wrapper.js +10 -1
- package/kits/base/sdk/social.d.ts +9 -0
- package/kits/base/sdk/social.js +5 -0
- package/kits/hub-game/CLAUDE.md +123 -3
- package/kits/hub-game/README.md +63 -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/arrivalCamera.js +50 -0
- package/kits/hub-game/code/client/askSlot.js +117 -0
- package/kits/hub-game/code/client/avatar.js +4 -2
- package/kits/hub-game/code/client/avatarShare.js +2 -0
- package/kits/hub-game/code/client/backVisibility.js +13 -0
- package/kits/hub-game/code/client/ballot.js +15 -10
- package/kits/hub-game/code/client/build.js +16 -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 +1148 -258
- package/kits/hub-game/code/client/crowdNames.js +241 -0
- package/kits/hub-game/code/client/decor.js +10 -4
- 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/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 +31 -11
- package/kits/hub-game/code/client/hookLayer.js +87 -8
- 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 +14 -2
- 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/labelsNear.js +31 -2
- 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/menuRows.js +43 -0
- package/kits/hub-game/code/client/modelReady.js +7 -0
- 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/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 +64 -10
- 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/state.js +53 -0
- package/kits/hub-game/code/client/talk.js +209 -45
- package/kits/hub-game/code/client/tiers.js +68 -66
- package/kits/hub-game/code/client/together.js +7 -2
- 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/worldLabels.js +241 -0
- package/kits/hub-game/code/client/yours.js +10 -9
- package/kits/hub-game/code/npcDisplayText.js +55 -0
- package/kits/hub-game/code/server/act.js +124 -0
- package/kits/hub-game/code/server/actions.js +6 -1
- package/kits/hub-game/code/server/actors.js +2 -1
- 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/companion.js +28 -3
- package/kits/hub-game/code/server/doorAnalytics.js +52 -0
- package/kits/hub-game/code/server/earned.js +22 -5
- package/kits/hub-game/code/server/frameBatch.js +183 -0
- package/kits/hub-game/code/server/friendsAmong.js +49 -9
- package/kits/hub-game/code/server/history.js +2 -0
- package/kits/hub-game/code/server/hub.js +1306 -95
- package/kits/hub-game/code/server/idle.js +30 -1
- package/kits/hub-game/code/server/index.js +26 -4
- package/kits/hub-game/code/server/invites.js +19 -0
- package/kits/hub-game/code/server/labels.js +9 -1
- package/kits/hub-game/code/server/loadAbandon.js +106 -0
- package/kits/hub-game/code/server/manifest.js +211 -3
- package/kits/hub-game/code/server/menu.js +31 -3
- package/kits/hub-game/code/server/npcs.js +226 -64
- 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/players.js +9 -1
- 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/standing.js +4 -5
- package/kits/hub-game/code/server/storageLimit.js +187 -0
- package/kits/hub-game/code/server/vis.js +67 -5
- package/kits/hub-game/code/shared/act.js +35 -0
- package/kits/hub-game/code/shared/danceIdle.js +28 -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 +35 -1
- package/kits/hub-game/code/systems/hub.js +970 -169
- package/kits/hub-game/docs/analytics.md +279 -0
- package/kits/hub-game/docs/contract.md +1257 -42
- package/kits/hub-game/docs/home-pieces.md +9 -2
- package/kits/hub-game/docs/observed-progress.md +252 -0
- package/kits/hub-game/main.jsx +2 -0
- package/kits/hub-game/package-lock.json +10 -3
- package/kits/hub-game/package.json +6 -3
- 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 +39 -5
- package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
- package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
- package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
- package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
- package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -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 +367 -2
- package/kits/hub-game/scripts/test-actors.mjs +20 -7
- 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-slot.mjs +85 -0
- package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
- package/kits/hub-game/scripts/test-avatar.mjs +44 -0
- package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
- package/kits/hub-game/scripts/test-ballot.mjs +11 -4
- package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
- package/kits/hub-game/scripts/test-build.mjs +20 -2
- package/kits/hub-game/scripts/test-chat.mjs +206 -5
- package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
- 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 +45 -4
- package/kits/hub-game/scripts/test-decor.mjs +7 -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.mjs +33 -3
- 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-grab-orbit.mjs +47 -4
- package/kits/hub-game/scripts/test-high-only.mjs +170 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
- package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
- package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
- 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 +66 -0
- package/kits/hub-game/scripts/test-interest-cells.mjs +20 -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-labels.mjs +71 -3
- 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 +265 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
- package/kits/hub-game/scripts/test-menu.mjs +23 -0
- package/kits/hub-game/scripts/test-npcs.mjs +819 -10
- package/kits/hub-game/scripts/test-observed.mjs +745 -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 +234 -7
- 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 +699 -5
- 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 +145 -0
- package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
- package/kits/hub-game/scripts/test-standing.mjs +35 -2
- package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
- package/kits/hub-game/scripts/test-stuck.mjs +5 -4
- package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
- package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
- package/kits/hub-game/scripts/test-tiers.mjs +7 -8
- package/kits/hub-game/scripts/test-vis.mjs +433 -6
- 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 +50 -6
- package/kits/hub-game/scripts/test-yours.mjs +39 -8
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
- package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
- package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
- package/kits/multiplayer-3d/package-lock.json +8 -1
- package/kits/multiplayer-3d/package.json +2 -1
- package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
- package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
- package/kits/physics-2d/CLAUDE.md +10 -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 +87 -5
- 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-3d/CLAUDE.md +25 -1651
- 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 +35 -18
- 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 +1 -1
- package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
- package/kits/physics-3d/engine3d/actornode.js +1 -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/framecap.js +4 -1
- 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 +8 -0
- package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
- package/kits/physics-3d/engine3d/look.js +7 -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 +3 -3
- package/kits/physics-3d/engine3d/nearshadows.js +77 -10
- package/kits/physics-3d/engine3d/orbitinput.js +59 -25
- 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 +3 -3
- 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 +23 -15
- package/kits/physics-3d/engine3d/sky.js +1 -1
- 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/world3d.js +468 -18
- package/kits/physics-3d/eslint.config.js +2 -1
- package/kits/physics-3d/main.jsx +6 -3
- 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/test-camera-follow.mjs +5 -1
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
- package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
- package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
- package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
- 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-look-bake.mjs +1 -1
- package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
- package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
- package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
- package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
- package/kits/physics-3d/scripts/test-sky.mjs +1 -1
- package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
- package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
- package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
- package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
- package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
- package/kits/physics-3d/systems/physics3d.js +37 -4
- 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/session.js +6 -4
- package/kits/real-time/package-lock.json +1 -1
- package/package.json +2 -2
package/dist/ide.js
CHANGED
|
@@ -241,6 +241,83 @@ const FILES_IGNORE_DIRS = new Set(['.git', '.castle', 'node_modules', 'dist', FO
|
|
|
241
241
|
// read-only and unlocking around writes races with concurrent processes, gets
|
|
242
242
|
// clobbered by tools, and still would not stop a raw shell write.
|
|
243
243
|
const PROTECTED_WRITE_DIRS = new Set(['.castle']);
|
|
244
|
+
// Deck-root files the files API will not delete or rename away, nor let another
|
|
245
|
+
// file be moved over. Without `castle.json` a deck is not a deck: every cloud save
|
|
246
|
+
// is refused until it comes back. The bootstrap binding is what ties a cloud deck
|
|
247
|
+
// to its owner. Writing new contents into either stays an ordinary edit.
|
|
248
|
+
const DECK_ROOT_ANCHORS = new Map([
|
|
249
|
+
['castle.json', "castle.json defines this deck and can't be deleted or renamed."],
|
|
250
|
+
[
|
|
251
|
+
'.castle-cloud-bootstrap-binding',
|
|
252
|
+
".castle-cloud-bootstrap-binding ties this cloud deck to its owner and can't be deleted or renamed.",
|
|
253
|
+
],
|
|
254
|
+
]);
|
|
255
|
+
// Where a path lands on disk with every symlinked DIRECTORY on the way resolved,
|
|
256
|
+
// but not the last component: a delete or rename acts on that entry itself (a
|
|
257
|
+
// symlink is removed or moved, never followed). Parents that don't exist yet --
|
|
258
|
+
// a rename destination -- resolve through their nearest existing ancestor.
|
|
259
|
+
function physicalPath(abs) {
|
|
260
|
+
const tail = [path.basename(abs)];
|
|
261
|
+
let dir = path.dirname(abs);
|
|
262
|
+
for (;;) {
|
|
263
|
+
try {
|
|
264
|
+
return path.join(fs.realpathSync(dir), ...tail);
|
|
265
|
+
}
|
|
266
|
+
catch {
|
|
267
|
+
const parent = path.dirname(dir);
|
|
268
|
+
if (parent === dir)
|
|
269
|
+
return abs;
|
|
270
|
+
tail.unshift(path.basename(dir));
|
|
271
|
+
dir = parent;
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
}
|
|
275
|
+
function realOrSelf(abs) {
|
|
276
|
+
try {
|
|
277
|
+
return fs.realpathSync(abs);
|
|
278
|
+
}
|
|
279
|
+
catch {
|
|
280
|
+
return abs;
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
// The refusal for a resolved deck path that IS one of the anchors (or the deck
|
|
284
|
+
// root), or null. `rel` is already normalized by resolveDeckPath (`./castle.json`,
|
|
285
|
+
// `castle.json/` and `a/../castle.json` all arrive as `castle.json`), but it is
|
|
286
|
+
// lexical: `alias/castle.json` with `alias -> .` names the same file, so the
|
|
287
|
+
// comparison is made on the physical path. The inode check also catches another
|
|
288
|
+
// spelling of the name on a case-insensitive filesystem.
|
|
289
|
+
function deckRootAnchorRefusal(deckDir, target) {
|
|
290
|
+
const deckReal = realOrSelf(deckDir);
|
|
291
|
+
if (realOrSelf(target.abs) === deckReal) {
|
|
292
|
+
return `${target.rel} is the deck folder itself and can't be deleted or renamed.`;
|
|
293
|
+
}
|
|
294
|
+
const physical = physicalPath(target.abs);
|
|
295
|
+
const atRoot = path.dirname(physical) === deckReal;
|
|
296
|
+
const base = path.basename(physical);
|
|
297
|
+
for (const [name, refusal] of DECK_ROOT_ANCHORS) {
|
|
298
|
+
if (target.rel === name)
|
|
299
|
+
return refusal;
|
|
300
|
+
if (!atRoot)
|
|
301
|
+
continue;
|
|
302
|
+
if (base === name)
|
|
303
|
+
return refusal;
|
|
304
|
+
if (base.toLowerCase() === name && isSameFile(physical, path.join(deckReal, name))) {
|
|
305
|
+
return refusal;
|
|
306
|
+
}
|
|
307
|
+
}
|
|
308
|
+
return null;
|
|
309
|
+
}
|
|
310
|
+
// One `[files] ...` line in the deck's log per files API mutation, so a file that
|
|
311
|
+
// vanished can be traced to the editor. Best-effort: a failed log write never
|
|
312
|
+
// fails the request.
|
|
313
|
+
function logFilesMutation(log, line) {
|
|
314
|
+
try {
|
|
315
|
+
log?.(`[files] ${line}\n`);
|
|
316
|
+
}
|
|
317
|
+
catch {
|
|
318
|
+
// logging must never fail a files request
|
|
319
|
+
}
|
|
320
|
+
}
|
|
244
321
|
// Ceiling on one uploaded file. A deck is saved whole (source tar + bundle), so
|
|
245
322
|
// a huge asset is a problem for the deck long before it is a problem here --
|
|
246
323
|
// refuse it at the door with a message rather than let it land and break `save`.
|
|
@@ -305,7 +382,9 @@ export function resolveDeckPath(deckDir, requestedPath, opts = {}) {
|
|
|
305
382
|
}
|
|
306
383
|
const abs = path.resolve(deckDir, normalized);
|
|
307
384
|
const rel = path.relative(deckDir, abs);
|
|
308
|
-
|
|
385
|
+
// `./` and `sub/../` normalize to `./`, not `.`, so the check above misses
|
|
386
|
+
// them; resolved, they are the deck root -- which a delete would remove whole.
|
|
387
|
+
if (rel === '' || rel.startsWith('..') || path.isAbsolute(rel)) {
|
|
309
388
|
return { ok: false, error: `Path outside the deck: ${requestedPath}` };
|
|
310
389
|
}
|
|
311
390
|
const relPosix = rel.split(path.sep).join('/');
|
|
@@ -607,7 +686,7 @@ async function gitPanelAction(res, args, deckDir, onSuccess) {
|
|
|
607
686
|
// over whatever landed in between, and the Parameters panel is the one that
|
|
608
687
|
// needs it (it splices against its last read and ignores external changes while
|
|
609
688
|
// its own write is in flight).
|
|
610
|
-
function handleFilesWrite(deckDir, req, res, ledger) {
|
|
689
|
+
function handleFilesWrite(deckDir, req, res, ledger, log) {
|
|
611
690
|
withMutationPath(deckDir, req, res, (target, body) => {
|
|
612
691
|
if (typeof body.contents !== 'string') {
|
|
613
692
|
return sendJson(res, 400, { error: 'File contents must be a string.' });
|
|
@@ -626,10 +705,14 @@ function handleFilesWrite(deckDir, req, res, ledger) {
|
|
|
626
705
|
});
|
|
627
706
|
}
|
|
628
707
|
recordParamsWrite(deckDir, target.rel, body.tuned);
|
|
708
|
+
// A tune is a Parameters slider writing many times a second; the watcher's
|
|
709
|
+
// `[watch] ... tuned` line already covers it without flooding the log.
|
|
710
|
+
if (!body.tuned)
|
|
711
|
+
logFilesMutation(log, `write ${target.rel}`);
|
|
629
712
|
sendJson(res, 200, { ok: true, path: target.rel });
|
|
630
713
|
});
|
|
631
714
|
}
|
|
632
|
-
function handleFilesMkdir(deckDir, req, res) {
|
|
715
|
+
function handleFilesMkdir(deckDir, req, res, log) {
|
|
633
716
|
withMutationPath(deckDir, req, res, (target) => {
|
|
634
717
|
try {
|
|
635
718
|
fs.mkdirSync(target.abs, { recursive: true });
|
|
@@ -637,6 +720,7 @@ function handleFilesMkdir(deckDir, req, res) {
|
|
|
637
720
|
catch (err) {
|
|
638
721
|
return sendFailure(res, 'create folder', target.rel, err);
|
|
639
722
|
}
|
|
723
|
+
logFilesMutation(log, `mkdir ${target.rel}`);
|
|
640
724
|
sendJson(res, 200, { ok: true, path: target.rel });
|
|
641
725
|
});
|
|
642
726
|
}
|
|
@@ -671,7 +755,7 @@ function handleCoverApi(deckDir, req, res) {
|
|
|
671
755
|
});
|
|
672
756
|
return true;
|
|
673
757
|
}
|
|
674
|
-
function handleFilesUpload(deckDir, req, res) {
|
|
758
|
+
function handleFilesUpload(deckDir, req, res, log) {
|
|
675
759
|
const url = new URL(req.url ?? '/', 'http://localhost');
|
|
676
760
|
const target = resolveDeckPath(deckDir, url.searchParams.get('path'), {
|
|
677
761
|
mutation: true,
|
|
@@ -698,6 +782,7 @@ function handleFilesUpload(deckDir, req, res) {
|
|
|
698
782
|
catch (err) {
|
|
699
783
|
return sendFailure(res, 'upload', target.rel, err);
|
|
700
784
|
}
|
|
785
|
+
logFilesMutation(log, `upload ${target.rel}`);
|
|
701
786
|
sendJson(res, 200, { ok: true, path: target.rel });
|
|
702
787
|
}, (err) => {
|
|
703
788
|
if (err instanceof RangeError)
|
|
@@ -769,7 +854,7 @@ function isBinary(bytes) {
|
|
|
769
854
|
}
|
|
770
855
|
// Copy a file byte-for-byte. The Files panel's Duplicate goes through this
|
|
771
856
|
// rather than read-then-write, which would corrupt anything binary.
|
|
772
|
-
function handleFilesCopy(deckDir, req, res) {
|
|
857
|
+
function handleFilesCopy(deckDir, req, res, log) {
|
|
773
858
|
withJsonBody(req, res, (body) => {
|
|
774
859
|
const from = resolveDeckPath(deckDir, body.from);
|
|
775
860
|
if (!from.ok)
|
|
@@ -786,6 +871,7 @@ function handleFilesCopy(deckDir, req, res) {
|
|
|
786
871
|
try {
|
|
787
872
|
fs.mkdirSync(path.dirname(to.abs), { recursive: true });
|
|
788
873
|
fs.copyFileSync(from.abs, to.abs);
|
|
874
|
+
logFilesMutation(log, `copy ${from.rel} -> ${to.rel}`);
|
|
789
875
|
sendJson(res, 200, { ok: true, path: to.rel });
|
|
790
876
|
}
|
|
791
877
|
catch (err) {
|
|
@@ -805,7 +891,7 @@ function isSameFile(a, b) {
|
|
|
805
891
|
return false;
|
|
806
892
|
}
|
|
807
893
|
}
|
|
808
|
-
function handleFilesRename(deckDir, req, res) {
|
|
894
|
+
function handleFilesRename(deckDir, req, res, log) {
|
|
809
895
|
withJsonBody(req, res, (body) => {
|
|
810
896
|
const from = resolveDeckPath(deckDir, body.from, { mutation: true });
|
|
811
897
|
if (!from.ok)
|
|
@@ -813,6 +899,15 @@ function handleFilesRename(deckDir, req, res) {
|
|
|
813
899
|
const to = resolveDeckPath(deckDir, body.to, { mutation: true });
|
|
814
900
|
if (!to.ok)
|
|
815
901
|
return sendJson(res, 400, { error: to.error });
|
|
902
|
+
// Renaming an anchor away loses it as surely as deleting it; moving another
|
|
903
|
+
// file over one replaces it. Moving a file INTO an anchor's empty slot is
|
|
904
|
+
// allowed -- that is how a lost castle.json comes back.
|
|
905
|
+
const anchorRefusal = deckRootAnchorRefusal(deckDir, from) ??
|
|
906
|
+
(fs.existsSync(to.abs) ? deckRootAnchorRefusal(deckDir, to) : null);
|
|
907
|
+
if (anchorRefusal) {
|
|
908
|
+
logFilesMutation(log, `refused rename ${from.rel} -> ${to.rel}`);
|
|
909
|
+
return sendJson(res, 400, { error: anchorRefusal });
|
|
910
|
+
}
|
|
816
911
|
if (!fs.existsSync(from.abs)) {
|
|
817
912
|
return sendJson(res, 404, { error: `Not found: ${from.rel}` });
|
|
818
913
|
}
|
|
@@ -826,6 +921,7 @@ function handleFilesRename(deckDir, req, res) {
|
|
|
826
921
|
try {
|
|
827
922
|
fs.mkdirSync(path.dirname(to.abs), { recursive: true });
|
|
828
923
|
fs.renameSync(from.abs, to.abs);
|
|
924
|
+
logFilesMutation(log, `rename ${from.rel} -> ${to.rel}`);
|
|
829
925
|
sendJson(res, 200, { ok: true, path: to.rel });
|
|
830
926
|
}
|
|
831
927
|
catch (err) {
|
|
@@ -833,13 +929,21 @@ function handleFilesRename(deckDir, req, res) {
|
|
|
833
929
|
}
|
|
834
930
|
});
|
|
835
931
|
}
|
|
836
|
-
function handleFilesDelete(deckDir, req, res) {
|
|
932
|
+
function handleFilesDelete(deckDir, req, res, log) {
|
|
837
933
|
withMutationPath(deckDir, req, res, (target) => {
|
|
934
|
+
// resolveDeckPath refuses the deck root by name; a symlink into it (to the
|
|
935
|
+
// root itself, or to a folder that holds an anchor) is caught here.
|
|
936
|
+
const anchorRefusal = deckRootAnchorRefusal(deckDir, target);
|
|
937
|
+
if (anchorRefusal) {
|
|
938
|
+
logFilesMutation(log, `refused delete ${target.rel}`);
|
|
939
|
+
return sendJson(res, 400, { error: anchorRefusal });
|
|
940
|
+
}
|
|
838
941
|
if (!fs.existsSync(target.abs)) {
|
|
839
942
|
return sendJson(res, 404, { error: `Not found: ${target.rel}` });
|
|
840
943
|
}
|
|
841
944
|
try {
|
|
842
945
|
fs.rmSync(target.abs, { recursive: true, force: true });
|
|
946
|
+
logFilesMutation(log, `delete ${target.rel}`);
|
|
843
947
|
sendJson(res, 200, { ok: true, path: target.rel });
|
|
844
948
|
}
|
|
845
949
|
catch (err) {
|
|
@@ -856,7 +960,7 @@ function playSnapEnabled() {
|
|
|
856
960
|
// The builtin Files + code-editor backend: list / read / write deck files and
|
|
857
961
|
// report kit-owned editor extensions. Paths are deck-relative; resolveDeckPath
|
|
858
962
|
// rejects traversal and protected dirs.
|
|
859
|
-
function handleFilesApi(deckDir, req, res, reqPath, restart, invalidate, tuneLedger) {
|
|
963
|
+
function handleFilesApi(deckDir, req, res, reqPath, restart, invalidate, tuneLedger, log) {
|
|
860
964
|
const action = reqPath.slice(FILES_API_PREFIX.length);
|
|
861
965
|
if (action === 'info') {
|
|
862
966
|
const config = readEditorConfig(deckDir);
|
|
@@ -1023,27 +1127,27 @@ function handleFilesApi(deckDir, req, res, reqPath, restart, invalidate, tuneLed
|
|
|
1023
1127
|
return true;
|
|
1024
1128
|
}
|
|
1025
1129
|
if (action === 'copy') {
|
|
1026
|
-
handleFilesCopy(deckDir, req, res);
|
|
1130
|
+
handleFilesCopy(deckDir, req, res, log);
|
|
1027
1131
|
return true;
|
|
1028
1132
|
}
|
|
1029
1133
|
if (action === 'write') {
|
|
1030
|
-
handleFilesWrite(deckDir, req, res, tuneLedger);
|
|
1134
|
+
handleFilesWrite(deckDir, req, res, tuneLedger, log);
|
|
1031
1135
|
return true;
|
|
1032
1136
|
}
|
|
1033
1137
|
if (action === 'rename') {
|
|
1034
|
-
handleFilesRename(deckDir, req, res);
|
|
1138
|
+
handleFilesRename(deckDir, req, res, log);
|
|
1035
1139
|
return true;
|
|
1036
1140
|
}
|
|
1037
1141
|
if (action === 'delete') {
|
|
1038
|
-
handleFilesDelete(deckDir, req, res);
|
|
1142
|
+
handleFilesDelete(deckDir, req, res, log);
|
|
1039
1143
|
return true;
|
|
1040
1144
|
}
|
|
1041
1145
|
if (action === 'mkdir') {
|
|
1042
|
-
handleFilesMkdir(deckDir, req, res);
|
|
1146
|
+
handleFilesMkdir(deckDir, req, res, log);
|
|
1043
1147
|
return true;
|
|
1044
1148
|
}
|
|
1045
1149
|
if (action === 'upload') {
|
|
1046
|
-
handleFilesUpload(deckDir, req, res);
|
|
1150
|
+
handleFilesUpload(deckDir, req, res, log);
|
|
1047
1151
|
return true;
|
|
1048
1152
|
}
|
|
1049
1153
|
if (action === 'raw') {
|
|
@@ -1281,7 +1385,7 @@ export function createIdeServer(opts) {
|
|
|
1281
1385
|
return handleCoverApi(deckDir, req, res);
|
|
1282
1386
|
}
|
|
1283
1387
|
if (reqPath.startsWith(FILES_API_PREFIX)) {
|
|
1284
|
-
return handleFilesApi(deckDir, req, res, reqPath, opts.restart, opts.invalidate, opts.tuneLedger);
|
|
1388
|
+
return handleFilesApi(deckDir, req, res, reqPath, opts.restart, opts.invalidate, opts.tuneLedger, opts.log);
|
|
1285
1389
|
}
|
|
1286
1390
|
if (reqPath.startsWith(IMPORT_API_PREFIX)) {
|
|
1287
1391
|
return handleImportApi(deckDir, req, res, reqPath, opts.restart);
|
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] [--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
|
+
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)
|
|
@@ -196,6 +197,7 @@ function usage() {
|
|
|
196
197
|
castle-web update-import [alias] [dir] [--check] [--revert] (re-fetches imports; no alias means all)
|
|
197
198
|
castle-web install [dir]
|
|
198
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)
|
|
@@ -556,7 +558,8 @@ async function main() {
|
|
|
556
558
|
const caption = getFlagValue('--caption');
|
|
557
559
|
const visibility = getFlagValue('--visibility');
|
|
558
560
|
const pinInstalledImports = hasFlag('--pin-installed-imports');
|
|
559
|
-
|
|
561
|
+
const chunkedBundle = hasFlag('--chunked-bundle');
|
|
562
|
+
await saveDeck(dir, { title, caption, visibility, force: hasFlag('--force'), pinInstalledImports, chunkedBundle });
|
|
560
563
|
break;
|
|
561
564
|
}
|
|
562
565
|
case 'get-deck': {
|
|
@@ -637,6 +640,9 @@ async function main() {
|
|
|
637
640
|
await check(findPositionalDir(), { pinInstalledImports: hasFlag('--pin-installed-imports') });
|
|
638
641
|
break;
|
|
639
642
|
}
|
|
643
|
+
case 'bundle-chunks':
|
|
644
|
+
await (await import('./bundle.js')).bundleChunksCommand(findPositionalDir(), getFlagValue('--out'), getFlagValue('--base-url'));
|
|
645
|
+
break;
|
|
640
646
|
// The version commands spend their positionals on their own arguments --
|
|
641
647
|
// paths to save, a version to list from or restore to -- so the deck dir is
|
|
642
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/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;
|
|
@@ -42,6 +59,8 @@ export interface SaveDeckOptions {
|
|
|
42
59
|
force?: boolean;
|
|
43
60
|
/** Move import pins to the versions imports/ holds, rather than refuse. */
|
|
44
61
|
pinInstalledImports?: boolean;
|
|
62
|
+
/** Publish a classic chunked bundle, as castle.json `"bundle": { "chunks": "classic" }` does. */
|
|
63
|
+
chunkedBundle?: boolean;
|
|
45
64
|
}
|
|
46
65
|
export declare function saveDeck(dir: string, opts?: SaveDeckOptions): Promise<void>;
|
|
47
66
|
export declare function builtinRefreshOptions(env?: NodeJS.ProcessEnv): {
|
package/dist/save-deck.js
CHANGED
|
@@ -5,8 +5,8 @@ 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';
|
|
@@ -380,6 +380,127 @@ async function uploadContentPack(deckId, pack) {
|
|
|
380
380
|
await uploadPresignedFile(config, new Blob([new Uint8Array(pack.bytes)], { type: 'application/json' }), 'application/json', LARGE_UPLOAD_TIMEOUT_MS, 'Content pack upload');
|
|
381
381
|
return config.uploadId;
|
|
382
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
|
+
}
|
|
383
504
|
async function uploadLocalCover(projectDir) {
|
|
384
505
|
try {
|
|
385
506
|
const selected = await selectSaveCover(projectDir, { onProgress: (message) => console.log(message) });
|
|
@@ -504,6 +625,13 @@ async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
|
|
|
504
625
|
const castleJson = readCastleJson(projectDir);
|
|
505
626
|
const existingDeckId = typeof castleJson?.deckId === 'string' && castleJson.deckId ? castleJson.deckId : null;
|
|
506
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
|
+
}
|
|
507
635
|
// A deck without an id is new: the source commit sends no precondition, as before.
|
|
508
636
|
let expectedS3Key;
|
|
509
637
|
let markerVia = 'save-deck';
|
|
@@ -547,17 +675,22 @@ async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
|
|
|
547
675
|
// build, as far as publishing is concerned (and as castle-www's failed_at
|
|
548
676
|
// reports it).
|
|
549
677
|
const built = await traceSaveStage('bundle', async () => {
|
|
550
|
-
const
|
|
678
|
+
const page = chunked ? await bundleProjectChunked(projectDir) : null;
|
|
679
|
+
const html = page ? page.renderHtml(BUNDLE_CHUNK_BASE_URL) : await bundleProject(projectDir);
|
|
551
680
|
const { errors } = await runImportChecks(projectDir);
|
|
552
681
|
if (errors.length > 0)
|
|
553
682
|
throw new Error(importChecksFailedMessage(errors));
|
|
554
|
-
return { html
|
|
683
|
+
return { html, page, pack: await buildContentPack(projectDir) };
|
|
555
684
|
}, (value) => ({ bytes: Buffer.byteLength(value.html) }));
|
|
556
|
-
const { html: bundle, pack } = built;
|
|
685
|
+
const { html: bundle, page: chunkedPage, pack } = built;
|
|
557
686
|
if (pack)
|
|
558
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.
|
|
559
690
|
const sizeKB = bundle.length / 1024;
|
|
560
691
|
console.log(`Bundle size: ${sizeKB.toFixed(1)}KB`);
|
|
692
|
+
if (chunkedPage)
|
|
693
|
+
reportChunks(chunkedPage);
|
|
561
694
|
if (sizeKB > 1024) {
|
|
562
695
|
console.warn(`Warning: Bundle is ${(sizeKB / 1024).toFixed(1)}MB. Large bundles may load slowly.`);
|
|
563
696
|
}
|
|
@@ -581,6 +714,9 @@ async function saveDeckAfterValidation(dir, opts, projectDir, visibility) {
|
|
|
581
714
|
// transferred. The promise is deliberately non-throwing: a thumbnail must never make the
|
|
582
715
|
// content upload fail or create an unhandled rejection if that upload exits early.
|
|
583
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);
|
|
584
720
|
// Upload scene data to S3
|
|
585
721
|
const configs = await traceSaveStage('scene_upload_config', async () => {
|
|
586
722
|
const result = await api.createSceneDataUploadConfig([cardId]);
|