castle-web-cli 0.4.233 → 0.4.235
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 +266 -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 +68 -5
- package/kits/base/sdk/hubRejoin.d.ts +4 -0
- package/kits/base/sdk/hubRejoin.js +15 -0
- package/kits/base/sdk/multiplayer.d.ts +7 -1
- package/kits/base/sdk/multiplayer.js +147 -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 +1259 -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 +917 -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
|
@@ -0,0 +1,273 @@
|
|
|
1
|
+
import * as THREE from 'three';
|
|
2
|
+
import { ActorNode } from './actornode.js';
|
|
3
|
+
|
|
4
|
+
// One world owns these bindings, and drops them on a scene switch/dispose.
|
|
5
|
+
// Writes thaw immediately (including a draw between the write and the next
|
|
6
|
+
// sync); placement/rebuild waits for the next sync's independent dirty queue.
|
|
7
|
+
export class FrozenStatics {
|
|
8
|
+
constructor(world, runtime) {
|
|
9
|
+
this.world = world;
|
|
10
|
+
this.runtime = runtime;
|
|
11
|
+
this.owner = runtime.frozenActors;
|
|
12
|
+
this.records = new Map();
|
|
13
|
+
this.reconcileNodes = true;
|
|
14
|
+
// A watched actor needs broad invalidation once until it is visited or
|
|
15
|
+
// watched again. Node builds can call out repeatedly within one pass.
|
|
16
|
+
this.invalidatable = new Set();
|
|
17
|
+
this.live = new Set();
|
|
18
|
+
// The actors the current sync took because they changed, not merely live.
|
|
19
|
+
this.dirty = new Set();
|
|
20
|
+
this.assetUsers = { assets: new Map(), arts: new Map() };
|
|
21
|
+
this.pending = this.owner.consumer(actor => this.thawActor(actor), () => {
|
|
22
|
+
this.dispose();
|
|
23
|
+
if (world.frozenStatics === this) delete world.frozenStatics;
|
|
24
|
+
});
|
|
25
|
+
this.sceneRestores = [];
|
|
26
|
+
const sceneChanged = () => {
|
|
27
|
+
for (const record of this.records.values()) this.changed(record);
|
|
28
|
+
};
|
|
29
|
+
watchTransform(world.scene, sceneChanged, this.sceneRestores);
|
|
30
|
+
for (const key of ['parent', 'matrixAutoUpdate', 'matrixWorldAutoUpdate', 'updateMatrix', 'updateMatrixWorld']) {
|
|
31
|
+
watchValue(world.scene, key, sceneChanged, this.sceneRestores);
|
|
32
|
+
}
|
|
33
|
+
for (const matrix of [world.scene.matrix, world.scene.matrixWorld]) {
|
|
34
|
+
for (let i = 0; i < 16; i++) watchValue(matrix.elements, String(i), sceneChanged, this.sceneRestores);
|
|
35
|
+
}
|
|
36
|
+
this.shared = null;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
thawActor(actor) {
|
|
40
|
+
const record = this.records.get(actor);
|
|
41
|
+
if (record) this.thaw(record);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
changed(record) {
|
|
45
|
+
if (record.writing) return;
|
|
46
|
+
this.pending.dirty.add(record.actor);
|
|
47
|
+
this.thaw(record);
|
|
48
|
+
// A parent can have another actor under it; changing its local transform
|
|
49
|
+
// changes those world matrices even if their own components did not move.
|
|
50
|
+
const pending = [record.node], seen = new Set();
|
|
51
|
+
while (pending.length) {
|
|
52
|
+
const object = pending.pop();
|
|
53
|
+
// Array.splice/reverse can notify between its individual writes.
|
|
54
|
+
if (!object || seen.has(object)) continue;
|
|
55
|
+
seen.add(object);
|
|
56
|
+
const actor = this.runtime.getActor(object.userData.actorId);
|
|
57
|
+
if (actor && actor !== record.actor) { this.pending.dirty.add(actor); this.thawActor(actor); }
|
|
58
|
+
pending.push(...object.children);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
thaw(record) {
|
|
63
|
+
if (!record.frozen) return;
|
|
64
|
+
record.writing = true;
|
|
65
|
+
record.node.frozenStatic = false;
|
|
66
|
+
for (const object of record.objects) {
|
|
67
|
+
object.matrixAutoUpdate = true;
|
|
68
|
+
object.matrixWorldAutoUpdate = true;
|
|
69
|
+
}
|
|
70
|
+
record.node.computedFrom = null;
|
|
71
|
+
record.frozen = false;
|
|
72
|
+
record.writing = false;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
forget(actor) {
|
|
76
|
+
this.invalidatable.delete(actor);
|
|
77
|
+
const record = this.records.get(actor);
|
|
78
|
+
if (record) {
|
|
79
|
+
this.thaw(record);
|
|
80
|
+
for (const restore of record.restores.reverse()) restore();
|
|
81
|
+
delete record.node.frozenStatic;
|
|
82
|
+
for (const [table, key] of record.assets ?? []) {
|
|
83
|
+
const count = this.assetUsers[table].get(key) - 1;
|
|
84
|
+
if (count) this.assetUsers[table].set(key, count);
|
|
85
|
+
else { this.assetUsers[table].delete(key); this[table].delete(key); }
|
|
86
|
+
}
|
|
87
|
+
this.records.delete(actor);
|
|
88
|
+
}
|
|
89
|
+
this.live.delete(actor);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
rememberAsset(actor, table, key, signature) {
|
|
93
|
+
const record = this.records.get(actor);
|
|
94
|
+
if (!record || this.live.has(actor)) return;
|
|
95
|
+
const refs = record.assets ??= [];
|
|
96
|
+
if (!refs.some(([kind, ref]) => kind === table && ref === key)) {
|
|
97
|
+
refs.push([table, key]);
|
|
98
|
+
this.assetUsers[table].set(key, (this.assetUsers[table].get(key) ?? 0) + 1);
|
|
99
|
+
}
|
|
100
|
+
this[table].set(key, signature);
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
watch(actor, node) {
|
|
104
|
+
this.forget(actor);
|
|
105
|
+
const record = { actor, node, objects: [], restores: [], frozen: false, writing: false, safe: node instanceof ActorNode };
|
|
106
|
+
this.records.set(actor, record);
|
|
107
|
+
this.invalidatable.add(actor);
|
|
108
|
+
const changed = () => this.changed(record);
|
|
109
|
+
const visit = object => {
|
|
110
|
+
if (object !== node && object.userData.actorId) { record.safe = false; return; }
|
|
111
|
+
record.objects.push(object);
|
|
112
|
+
if (object.updateMatrix !== THREE.Object3D.prototype.updateMatrix ||
|
|
113
|
+
(object !== node && object.updateMatrixWorld !== THREE.Object3D.prototype.updateMatrixWorld) ||
|
|
114
|
+
!object.matrixAutoUpdate || !object.matrixWorldAutoUpdate) record.safe = false;
|
|
115
|
+
watchTransform(object, changed, record.restores);
|
|
116
|
+
for (const key of ['visible', 'parent']) watchValue(object, key, changed, record.restores);
|
|
117
|
+
for (const event of ['added', 'removed', 'childadded', 'childremoved']) {
|
|
118
|
+
object.addEventListener(event, changed);
|
|
119
|
+
record.restores.push(() => object.removeEventListener(event, changed));
|
|
120
|
+
}
|
|
121
|
+
const originalChildren = object.children;
|
|
122
|
+
const watchedChildren = new Proxy(originalChildren, {
|
|
123
|
+
set(target, key, value) { const ok = Reflect.set(target, key, value); changed(); return ok; },
|
|
124
|
+
deleteProperty(target, key) { const ok = Reflect.deleteProperty(target, key); changed(); return ok; },
|
|
125
|
+
});
|
|
126
|
+
object.children = watchedChildren;
|
|
127
|
+
record.restores.push(() => { if (object.children === watchedChildren) object.children = originalChildren; });
|
|
128
|
+
// Decor previews clone actor nodes. A clone needs normal update flags so
|
|
129
|
+
// it can move independently; thaw the source before three.js copies it.
|
|
130
|
+
const ownClone = Object.getOwnPropertyDescriptor(object, 'clone');
|
|
131
|
+
const originalClone = object.clone;
|
|
132
|
+
const clone = function (...args) { changed(); return originalClone.apply(this, args); };
|
|
133
|
+
object.clone = clone;
|
|
134
|
+
record.restores.push(() => {
|
|
135
|
+
if (object.clone !== clone) return;
|
|
136
|
+
if (ownClone) Object.defineProperty(object, 'clone', ownClone);
|
|
137
|
+
else delete object.clone;
|
|
138
|
+
});
|
|
139
|
+
// Raw matrix writes are observable too. Consumers retaining an elements
|
|
140
|
+
// array still write the same array, so no Proxy or replacement is needed.
|
|
141
|
+
for (const matrix of [object.matrix, object.matrixWorld]) {
|
|
142
|
+
for (let i = 0; i < 16; i++) watchValue(matrix.elements, String(i), changed, record.restores);
|
|
143
|
+
watchValue(matrix, 'elements', () => { if (!record.writing) { record.safe = false; changed(); } }, record.restores);
|
|
144
|
+
}
|
|
145
|
+
for (const key of ['matrixAutoUpdate', 'matrixWorldAutoUpdate']) {
|
|
146
|
+
watchValue(object, key, next => {
|
|
147
|
+
if (record.writing) return;
|
|
148
|
+
record.safe = false;
|
|
149
|
+
changed();
|
|
150
|
+
// Thaw restores the mode's flags. Preserve the controller's newly
|
|
151
|
+
// requested flag, including an explicit write of the frozen false.
|
|
152
|
+
record.writing = true;
|
|
153
|
+
try { object[key] = next; } finally { record.writing = false; }
|
|
154
|
+
}, record.restores, true);
|
|
155
|
+
}
|
|
156
|
+
for (const key of ['updateMatrix', 'updateMatrixWorld']) {
|
|
157
|
+
watchValue(object, key, () => { if (!record.writing) { record.safe = false; changed(); } }, record.restores);
|
|
158
|
+
}
|
|
159
|
+
for (const key of ['children', 'matrix', 'matrixWorld']) {
|
|
160
|
+
watchValue(object, key, () => { if (!record.writing) { record.safe = false; changed(); } }, record.restores);
|
|
161
|
+
}
|
|
162
|
+
for (const child of object.children) visit(child);
|
|
163
|
+
};
|
|
164
|
+
visit(node);
|
|
165
|
+
return record;
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
// Every ancestor must be a static actor (ordinary model groups within its
|
|
169
|
+
// subtree are fine). An unknown parent/controller stays on the old walk.
|
|
170
|
+
canFreeze(actor, record) {
|
|
171
|
+
if (!record.safe || !this.owner.isStatic(actor)) return false;
|
|
172
|
+
for (let parent = record.node.parent; parent && parent !== this.world.scene; parent = parent.parent) {
|
|
173
|
+
const ancestor = this.runtime.getActor(parent.userData.actorId);
|
|
174
|
+
const watched = this.records.get(ancestor);
|
|
175
|
+
if (!ancestor || !this.owner.isStatic(ancestor) || !watched || watched.node !== parent || !watched.safe || this.live.has(ancestor)) return false;
|
|
176
|
+
}
|
|
177
|
+
// A transformed external parent of the scene is not owned by this mode.
|
|
178
|
+
const scene = this.world.scene;
|
|
179
|
+
return scene.parent === null && scene.matrixAutoUpdate && scene.matrixWorldAutoUpdate &&
|
|
180
|
+
scene.updateMatrix === THREE.Object3D.prototype.updateMatrix && scene.updateMatrixWorld === THREE.Object3D.prototype.updateMatrixWorld;
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
freeze(actor, entry) {
|
|
184
|
+
if (!this.owner.isStatic(actor)) { this.forget(actor); return; }
|
|
185
|
+
let record = this.records.get(actor);
|
|
186
|
+
// Rewatch on a dirty sync so added/removed descendants are covered too.
|
|
187
|
+
if (record?.safe === false && record.node === entry.node) { this.live.add(actor); return; }
|
|
188
|
+
// A live actor resynced only because an ancestor cannot freeze keeps its
|
|
189
|
+
// watch: nothing under it changed, so re-walking it every frame buys nothing.
|
|
190
|
+
// Changes noticed after take() (another actor's rebuild in this sync)
|
|
191
|
+
// count too: they are queued for the next sync but the watch is stale now.
|
|
192
|
+
if (record?.node !== entry.node || this.dirty.has(actor) || this.pending.dirty.has(actor)) record = this.watch(actor, entry.node);
|
|
193
|
+
if (!this.canFreeze(actor, record)) { this.live.add(actor); return; }
|
|
194
|
+
this.live.delete(actor);
|
|
195
|
+
// Hidden roots are not traversed by the old renderer. Keep their matrices
|
|
196
|
+
// at that same last-rendered pose; reattachment queues a fresh sync.
|
|
197
|
+
if (!entry.node.parent && !entry.node.emptyDetached) return;
|
|
198
|
+
record.writing = true;
|
|
199
|
+
try {
|
|
200
|
+
entry.node.computedFrom = null;
|
|
201
|
+
entry.node.updateWorldMatrix(true, true);
|
|
202
|
+
for (const object of record.objects) {
|
|
203
|
+
object.matrixAutoUpdate = false;
|
|
204
|
+
object.matrixWorldAutoUpdate = false;
|
|
205
|
+
}
|
|
206
|
+
entry.node.frozenStatic = true;
|
|
207
|
+
record.frozen = true;
|
|
208
|
+
} finally { record.writing = false; }
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
take() {
|
|
212
|
+
this.dirty = new Set(this.pending.take());
|
|
213
|
+
const actors = new Set(this.dirty);
|
|
214
|
+
for (const actor of this.live) actors.add(actor);
|
|
215
|
+
// A consumed notification must be armed again before any later callout.
|
|
216
|
+
for (const actor of actors) if (this.records.has(actor)) this.invalidatable.add(actor);
|
|
217
|
+
return [...actors].sort((a, b) => (a.components.Layout?.z ?? 0) - (b.components.Layout?.z ?? 0) ||
|
|
218
|
+
(this.owner.records.get(a)?.order ?? -1) - (this.owner.records.get(b)?.order ?? -1));
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
invalidate() {
|
|
222
|
+
const actors = [...this.invalidatable];
|
|
223
|
+
this.invalidatable.clear();
|
|
224
|
+
for (const actor of actors) this.owner.mark(actor);
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
dispose() {
|
|
228
|
+
this.pending.dispose();
|
|
229
|
+
for (const actor of this.records.keys()) this.forget(actor);
|
|
230
|
+
for (const restore of this.sceneRestores.reverse()) restore();
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
function watchTransform(object, changed, restores) {
|
|
235
|
+
for (const [value, keys] of [[object.position, ['x', 'y', 'z']], [object.scale, ['x', 'y', 'z']],
|
|
236
|
+
[object.quaternion, ['_x', '_y', '_z', '_w']], [object.rotation, ['_x', '_y', '_z', '_order']]]) {
|
|
237
|
+
for (const key of keys) watchValue(value, key, changed, restores);
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
function watchValue(object, key, changed, restores, notifySame = false) {
|
|
242
|
+
const own = Object.getOwnPropertyDescriptor(object, key);
|
|
243
|
+
if (own && (!own.configurable || !('value' in own))) return;
|
|
244
|
+
let value = object[key];
|
|
245
|
+
const get = () => value;
|
|
246
|
+
Object.defineProperty(object, key, {
|
|
247
|
+
configurable: true, enumerable: own?.enumerable ?? false, get,
|
|
248
|
+
set(next) { if (notifySame || !Object.is(value, next)) { value = next; changed(next); } },
|
|
249
|
+
});
|
|
250
|
+
restores.push(() => {
|
|
251
|
+
if (Object.getOwnPropertyDescriptor(object, key)?.get !== get) return;
|
|
252
|
+
if (own) Object.defineProperty(object, key, { ...own, value });
|
|
253
|
+
else { delete object[key]; if (value !== undefined) object[key] = value; }
|
|
254
|
+
});
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
export function frozenNodeState(world) {
|
|
258
|
+
const state = [];
|
|
259
|
+
for (const [id, entry] of world.nodes) {
|
|
260
|
+
const matrices = [];
|
|
261
|
+
entry.node.traverse(object => matrices.push([...object.matrixWorld.elements]));
|
|
262
|
+
state.push([id, entry.sig, matrices]);
|
|
263
|
+
}
|
|
264
|
+
return frozenState(state);
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
export function frozenState(value) {
|
|
268
|
+
return JSON.stringify(value, (key, item) => Object.is(item, -0) ? '-0' : item);
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
export function assertFrozenEqual(before, after, what) {
|
|
272
|
+
if (before !== after) throw new Error(`frozenStatics audit: ${what} differ from the full unchanged pass`);
|
|
273
|
+
}
|
|
@@ -26,6 +26,14 @@ export function takeWalkSpeedHint(node, now = typeof performance === 'undefined'
|
|
|
26
26
|
return Number.isFinite(speed) ? { speed: Math.max(0, speed), time } : undefined;
|
|
27
27
|
}
|
|
28
28
|
|
|
29
|
+
// Play-only opt-in for ordinary userData objects. Presence (including an
|
|
30
|
+
// inherited or undefined field) keeps the original consumption path intact.
|
|
31
|
+
export function takeWalkSpeedHintIfPresent(node, now) {
|
|
32
|
+
const data = node.userData;
|
|
33
|
+
if (!('walkSpeedHint' in data) && !('walkTimeHint' in data) && !('walkHintAt' in data)) return undefined;
|
|
34
|
+
return takeWalkSpeedHint(node, now);
|
|
35
|
+
}
|
|
36
|
+
|
|
29
37
|
// Bounds of visible geometry only (outlines and hidden pattern parts excluded).
|
|
30
38
|
function boundsOf(node) {
|
|
31
39
|
const bounds = new THREE.Box3();
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
// The immutable file map shared by play and the live editor.
|
|
2
|
+
import { initialFiles } from '@imports/castle.physics-2d/engine/files';
|
|
3
|
+
|
|
4
|
+
// Both the deck's own models and every import's -- same shape as the imported
|
|
5
|
+
// engine's own file globs: when this kit is itself an import, its models live
|
|
6
|
+
// under imports/<alias>/models/ in the deck being served, and a map without
|
|
7
|
+
// them can't resolve a kit blueprint's Model ref.
|
|
8
|
+
const modelModules = import.meta.glob(
|
|
9
|
+
['/**/*.pxmodel', '!/node_modules/**', '!/dist/**', '!/.castle/**'],
|
|
10
|
+
{ query: '?raw', import: 'default', eager: true }
|
|
11
|
+
);
|
|
12
|
+
|
|
13
|
+
export const initialFiles3D = {
|
|
14
|
+
...initialFiles,
|
|
15
|
+
...Object.fromEntries(
|
|
16
|
+
Object.entries(modelModules).map(([globPath, text]) => [globPath.replace(/^\//, ''), text])
|
|
17
|
+
),
|
|
18
|
+
};
|
|
@@ -73,6 +73,12 @@ function partLooks(model) {
|
|
|
73
73
|
for (const part of model.parts) {
|
|
74
74
|
looks.set(part.id, readLook(part.look, base));
|
|
75
75
|
}
|
|
76
|
+
if (later?.queue?.skipSurfaceBakes === true) {
|
|
77
|
+
return {
|
|
78
|
+
base: { ...base, outline: 0, ao: 0 },
|
|
79
|
+
looks: new Map([...looks].map(([id, look]) => [id, look ? { ...look, outline: 0, ao: 0 } : null])),
|
|
80
|
+
};
|
|
81
|
+
}
|
|
76
82
|
return { base, looks };
|
|
77
83
|
}
|
|
78
84
|
|
|
@@ -383,6 +389,7 @@ function setOutlineAttributes(geometry, { positions, slots, smooth, bySlot }) {
|
|
|
383
389
|
// returned says where each part will lie in the merged geometry
|
|
384
390
|
// (`outlineMergedLater`).
|
|
385
391
|
export function outlinePartByPart(geometries) {
|
|
392
|
+
if (later?.queue?.skipSurfaceBakes === true) return null;
|
|
386
393
|
if (!later) {
|
|
387
394
|
geometries.forEach(addOutlineAttributes);
|
|
388
395
|
return null;
|
|
@@ -6,28 +6,14 @@
|
|
|
6
6
|
// the files API instead of forcing a context reload (the glob puts models in
|
|
7
7
|
// vite's module graph, which the imported hook would read as "code changed").
|
|
8
8
|
import { useEffect, useRef, useState } from 'react';
|
|
9
|
+
import { initialFiles3D } from './initialModelFiles';
|
|
10
|
+
export { initialFiles3D } from './initialModelFiles';
|
|
9
11
|
import { onFilesChanged } from 'castle-web-sdk';
|
|
10
|
-
import {
|
|
12
|
+
import { initialMedia, isImageFile } from '@imports/castle.physics-2d/engine/files';
|
|
11
13
|
import { hydrateDeclaredFiles } from '@imports/castle.physics-2d/engine/liveReload';
|
|
12
14
|
import { parseFull } from '@imports/castle.physics-2d/engine/pxart';
|
|
13
15
|
import { imageArt } from '@imports/castle.physics-2d/engine/art';
|
|
14
16
|
|
|
15
|
-
// Both the deck's own models and every import's -- same shape as the imported
|
|
16
|
-
// engine's own file globs: when this kit is itself an import, its models live
|
|
17
|
-
// under imports/<alias>/models/ in the deck being served, and a map without
|
|
18
|
-
// them can't resolve a kit blueprint's Model ref.
|
|
19
|
-
const modelModules = import.meta.glob(
|
|
20
|
-
['/**/*.pxmodel', '!/node_modules/**', '!/dist/**', '!/.castle/**'],
|
|
21
|
-
{ query: '?raw', import: 'default', eager: true }
|
|
22
|
-
);
|
|
23
|
-
|
|
24
|
-
export const initialFiles3D = {
|
|
25
|
-
...initialFiles,
|
|
26
|
-
...Object.fromEntries(
|
|
27
|
-
Object.entries(modelModules).map(([globPath, text]) => [globPath.replace(/^\//, ''), text])
|
|
28
|
-
),
|
|
29
|
-
};
|
|
30
|
-
|
|
31
17
|
const DATA_EXTS = ['.scene', '.sprite', '.pxart', '.drawing', '.pxmodel'];
|
|
32
18
|
const CODE_EXTS = ['.js', '.jsx', '.ts', '.tsx', '.css'];
|
|
33
19
|
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
// Shared numeric and point helpers for procedural model geometry.
|
|
2
|
+
import * as THREE from 'three';
|
|
3
|
+
|
|
4
|
+
export function points2(list) {
|
|
5
|
+
if (!Array.isArray(list)) {
|
|
6
|
+
return [];
|
|
7
|
+
}
|
|
8
|
+
return list
|
|
9
|
+
.filter((p) => Array.isArray(p) && Number.isFinite(p[0]) && Number.isFinite(p[1]))
|
|
10
|
+
.map((p) => new THREE.Vector2(p[0], p[1]));
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
export function points3(list) {
|
|
14
|
+
if (!Array.isArray(list)) {
|
|
15
|
+
return [];
|
|
16
|
+
}
|
|
17
|
+
return list
|
|
18
|
+
.filter((p) => Array.isArray(p) && p.slice(0, 3).every(Number.isFinite))
|
|
19
|
+
.map((p) => new THREE.Vector3(p[0], p[1], p[2]));
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export function clampInt(value, min, max, fallback) {
|
|
23
|
+
if (!Number.isFinite(value)) {
|
|
24
|
+
return fallback;
|
|
25
|
+
}
|
|
26
|
+
return Math.max(min, Math.min(max, Math.round(value)));
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
// Cage UVs may have only two coordinates; cage operations keep their strict Z policy.
|
|
30
|
+
export function average(points, fillMissingZ = false) {
|
|
31
|
+
const sum = [0, 0, 0];
|
|
32
|
+
for (const point of points) {
|
|
33
|
+
sum[0] += point[0];
|
|
34
|
+
sum[1] += point[1];
|
|
35
|
+
sum[2] += fillMissingZ ? (point[2] ?? 0) : point[2];
|
|
36
|
+
}
|
|
37
|
+
return sum.map((value) => value / Math.max(1, points.length));
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
// Mulberry32; branches retain their original +17 seed offset.
|
|
41
|
+
export function seededRandom(seed, offset = 0) {
|
|
42
|
+
let state = Math.round(seed * 9973 + offset) | 0;
|
|
43
|
+
return () => {
|
|
44
|
+
state = (state + 0x6d2b79f5) | 0;
|
|
45
|
+
let t = Math.imul(state ^ (state >>> 15), 1 | state);
|
|
46
|
+
t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
|
|
47
|
+
return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
|
|
48
|
+
};
|
|
49
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
// Call before retaining, cloning or measuring an actor's model. A waiting
|
|
2
|
+
// actor's whole shared key fills synchronously through the usual fill path.
|
|
3
|
+
// Dormant without engine.load; callers must look up the entry again because
|
|
4
|
+
// a signature edit can replace it. This module pulls no renderer into readers.
|
|
5
|
+
export function ensureActorModel(world, actorId) {
|
|
6
|
+
world?.modelLoad?.ensureActor(actorId);
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
// Legacy physics-2d has no per-consumer fence. Check at every dispatch
|
|
10
|
+
// boundary physics-3d owns; absent keys and capable runtimes do no work here.
|
|
11
|
+
// actorId restricts a collision check to that actor's waiting entry.
|
|
12
|
+
export function prepareModelConsumers(world, runtime, actorId) {
|
|
13
|
+
if (runtime.callsBeforeBehavior === true) return;
|
|
14
|
+
const load = world?.modelLoad;
|
|
15
|
+
if (load?.runtime === runtime && load.pending.size) load.prepareConsumers(actorId);
|
|
16
|
+
}
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
// and sets its channels outright; motion here adds to what it leaves.
|
|
8
8
|
|
|
9
9
|
import { checkEmptyPass } from './emptynodes.js';
|
|
10
|
-
import { modelWalk, takeWalkSpeedHint, walkGait } from './gait.js';
|
|
10
|
+
import { modelWalk, takeWalkSpeedHint, takeWalkSpeedHintIfPresent, walkGait } from './gait.js';
|
|
11
11
|
|
|
12
12
|
const DEG = Math.PI / 180;
|
|
13
13
|
const TAU = Math.PI * 2;
|
|
@@ -559,10 +559,10 @@ function setupMotion(entry, actor) {
|
|
|
559
559
|
// animateModelParts, with the actor whose clips to play (optional). dt of 0
|
|
560
560
|
// (editor views) leaves the model in its rest pose. The first call finds the
|
|
561
561
|
// parts and moves nothing.
|
|
562
|
-
export function animateMotion(entry, dt, actor = null, world) {
|
|
562
|
+
export function animateMotion(entry, dt, actor = null, world, skipEmptyHints = false) {
|
|
563
563
|
let hint;
|
|
564
564
|
if (walkGait() === 'model') {
|
|
565
|
-
hint = entry.walkFrameHint ?? takeWalkSpeedHint(entry.node);
|
|
565
|
+
hint = entry.walkFrameHint ?? (skipEmptyHints ? takeWalkSpeedHintIfPresent(entry.node) : takeWalkSpeedHint(entry.node));
|
|
566
566
|
delete entry.walkFrameHint;
|
|
567
567
|
}
|
|
568
568
|
if (!(dt > 0)) {
|
|
@@ -145,7 +145,56 @@
|
|
|
145
145
|
// drops it all. The map, and a
|
|
146
146
|
// blur map were there ever one, are taken off the shadow before they are
|
|
147
147
|
// disposed, once.
|
|
148
|
+
//
|
|
149
|
+
// Optional `"cacheStill": true` under the same `engine.shadows` object:
|
|
150
|
+
//
|
|
151
|
+
// The existing whole-texel box placement is unchanged. Still casters are
|
|
152
|
+
// under this runtime's adopted/frozen ActorNodes; touched, thawed, spawned,
|
|
153
|
+
// skinned, morphed, instanced or texture-dependent depth casters stay live.
|
|
154
|
+
// stillshadows.js keeps an extra packed-depth target with a hardware depth
|
|
155
|
+
// texture. Its key is the snapped matrix, projection, runtime/still
|
|
156
|
+
// version, frozen epoch, render camera/scene/layers, and selected still
|
|
157
|
+
// casters (including matrices, geometry and depth material). A changed
|
|
158
|
+
// key draws the ordinary pass: no copy or still-map rebuild. Only after
|
|
159
|
+
// STABLE_FRAMES (3) consecutive engine frames with the same complete key
|
|
160
|
+
// does it build, then reuse, the still map. Repeated renders in one frame
|
|
161
|
+
// do not advance that count. Key buffers and selection arrays are reused;
|
|
162
|
+
// existing casters need no descriptor allocations to compute the key.
|
|
163
|
+
// Continuous movement therefore adds key computation only, rather than a
|
|
164
|
+
// depth pass and copy each frame. Checking the selection preserves
|
|
165
|
+
// exact view-slice culling, even past `distance`; it can invalidate inside
|
|
166
|
+
// one snapped box. Caching the full box would change that picture.
|
|
167
|
+
//
|
|
168
|
+
// r180 WebGLShadowMap clears unconditionally, but calls updateMatrices
|
|
169
|
+
// after clearing/setting the viewport and before drawing. There the cache
|
|
170
|
+
// draws one fullscreen triangle copying BOTH packed colour and hardware
|
|
171
|
+
// depth into the live map on a hit or the qualified build frame. Movers
|
|
172
|
+
// draw normally without another clear. Once a key qualifies, a nested
|
|
173
|
+
// shadow-only pass builds the still target first;
|
|
174
|
+
// it saves/restores the live target and uses the same viewport size. No
|
|
175
|
+
// receiver shader changes or renderer settings. Another three revision,
|
|
176
|
+
// reversed/logarithmic depth, or an unhookable pass draws ordinary near
|
|
177
|
+
// shadows. Custom shadow callbacks or unwritable cast flags make the frame
|
|
178
|
+
// uncached, as do custom depth rules whose result depends on draw order.
|
|
179
|
+
//
|
|
180
|
+
// Only with this extra key, a shadowMap.render hook wraps the fade's hook
|
|
181
|
+
// during that one render call. It calls the original pass per light,
|
|
182
|
+
// and bypasses the cache for a different actual render camera or scene:
|
|
183
|
+
// those renders draw the ordinary pass and do not alter the primary key.
|
|
184
|
+
// Selection and rebuild use the hook's actual camera and scene. It restores
|
|
185
|
+
// temporarily suppressed castShadow flags before the next light
|
|
186
|
+
// or colour pass. The fade puts original materials back before both depth
|
|
187
|
+
// passes; receiver variants and shaders are unchanged. A private triangle
|
|
188
|
+
// with an invisible material is attached before a build can qualify, with
|
|
189
|
+
// all layers enabled, so any camera's object walk uploads and tracks its
|
|
190
|
+
// geometry without submitting a colour draw. It detaches at the primary
|
|
191
|
+
// shadow pass; unrelated renders leave it for that walk. giveBack
|
|
192
|
+
// removes it and the hooks and restores flags before disposal or a plain
|
|
193
|
+
// nested frame. All cache resources detach and free with the near shadow
|
|
194
|
+
// on every exit, throw and dispose, including removal of cacheStill itself.
|
|
195
|
+
// Absent/false acquires no cache objects, maps, hooks, walks or shaders.
|
|
148
196
|
import * as THREE from 'three';
|
|
197
|
+
import { StillShadows, canCacheStill } from './stillshadows.js';
|
|
149
198
|
|
|
150
199
|
// How far from the point it shades three.js's shader may read the shadow map,
|
|
151
200
|
// across the light: what the outline is pushed out by and the box made wider
|
|
@@ -276,6 +325,9 @@ function defineNearShadow(DirectionalLightShadow) {
|
|
|
276
325
|
points.push([point.dot(axisX), point.dot(axisY)]);
|
|
277
326
|
}
|
|
278
327
|
outlineSides(this.slice.sides, points, axisX, axisY, this.margin);
|
|
328
|
+
// WebGLShadowMap has cleared and set the viewport, but has not drawn
|
|
329
|
+
// any casters yet. The optional cache seeds colour AND hardware depth.
|
|
330
|
+
this.stillCache?.draw(light);
|
|
279
331
|
}
|
|
280
332
|
|
|
281
333
|
// The camera at `target + offset` looking at `target`, and the matrices that
|
|
@@ -290,19 +342,24 @@ function defineNearShadow(DirectionalLightShadow) {
|
|
|
290
342
|
// have made) off before disposing it, so nothing that runs from its
|
|
291
343
|
// `dispose` finds it here.
|
|
292
344
|
release() {
|
|
293
|
-
const { map, mapPass } = this;
|
|
345
|
+
const { map, mapPass, stillCache } = this;
|
|
294
346
|
this.map = null;
|
|
295
347
|
this.mapPass = null;
|
|
348
|
+
this.stillCache = null;
|
|
296
349
|
// Both are off the shadow before either is disposed, and a `dispose`
|
|
297
350
|
// listener that throws does not keep the other from being freed.
|
|
298
351
|
// One bracket spans both maps and all their listeners. Empty releases
|
|
299
352
|
// and unchanged frames neither call out nor allocate this operation.
|
|
300
|
-
if (!map && !mapPass) return;
|
|
353
|
+
if (!map && !mapPass && !stillCache) return;
|
|
301
354
|
const dispose = () => {
|
|
302
355
|
try {
|
|
303
|
-
|
|
356
|
+
stillCache?.dispose();
|
|
304
357
|
} finally {
|
|
305
|
-
|
|
358
|
+
try {
|
|
359
|
+
if (map) map.dispose();
|
|
360
|
+
} finally {
|
|
361
|
+
if (mapPass) mapPass.dispose();
|
|
362
|
+
}
|
|
306
363
|
}
|
|
307
364
|
};
|
|
308
365
|
if (this.onCallout) this.onCallout(dispose);
|
|
@@ -342,7 +399,8 @@ function shadowSettings(world) {
|
|
|
342
399
|
function giveBack(state) {
|
|
343
400
|
const frame = state.frame;
|
|
344
401
|
state.frame = null;
|
|
345
|
-
if (frame && frame.sun.shadow === frame.near) frame.sun.shadow = frame.own;
|
|
402
|
+
if (frame && (frame.sun.shadow === frame.near || frame.sun.shadow === frame.cache?.shadow)) frame.sun.shadow = frame.own;
|
|
403
|
+
frame?.cache?.end();
|
|
346
404
|
if (frame?.fade) frame.fade.end();
|
|
347
405
|
}
|
|
348
406
|
|
|
@@ -378,7 +436,7 @@ export function dropNearShadows(world) {
|
|
|
378
436
|
// release operation when a map's disposal can run listeners. `fade` (the
|
|
379
437
|
// scene has the orbit camera key as well, shadowfade.js) fades the far edge
|
|
380
438
|
// of a frame the mode draws; a plain frame is drawn the same either way.
|
|
381
|
-
export function renderWithNearShadows(world, distance, fitBias, render, onCallout, fade) {
|
|
439
|
+
export function renderWithNearShadows(world, distance, fitBias, render, onCallout, fade, runtime) {
|
|
382
440
|
const state = world.nearShadows ?? newState(world, onCallout);
|
|
383
441
|
if (state.depth > 0) {
|
|
384
442
|
// Term 2: entered from inside another call. Plain, and nothing is made.
|
|
@@ -394,7 +452,7 @@ export function renderWithNearShadows(world, distance, fitBias, render, onCallou
|
|
|
394
452
|
let returned = false;
|
|
395
453
|
try {
|
|
396
454
|
try {
|
|
397
|
-
drawn = guardedFrame(world, state, distance, fitBias, render, fade);
|
|
455
|
+
drawn = guardedFrame(world, state, distance, fitBias, render, fade, runtime);
|
|
398
456
|
returned = true;
|
|
399
457
|
} finally {
|
|
400
458
|
// First what must happen whatever follows and cannot call out: the sun
|
|
@@ -418,7 +476,7 @@ function newState(world, onCallout) {
|
|
|
418
476
|
}
|
|
419
477
|
|
|
420
478
|
// The frame, inside the guard. True when the mode drew it.
|
|
421
|
-
function guardedFrame(world, state, distance, fitBias, render, fade) {
|
|
479
|
+
function guardedFrame(world, state, distance, fitBias, render, fade, runtime) {
|
|
422
480
|
if (!(distance > 0) || world.disposed === true || state.off) {
|
|
423
481
|
leaveMode(state);
|
|
424
482
|
fitBias();
|
|
@@ -431,7 +489,7 @@ function guardedFrame(world, state, distance, fitBias, render, fade) {
|
|
|
431
489
|
const due = type !== undefined && state.lastType === type;
|
|
432
490
|
state.lastType = undefined;
|
|
433
491
|
fitBias();
|
|
434
|
-
const drawn = due && nearFrame(world, state, distance, render, fade);
|
|
492
|
+
const drawn = due && nearFrame(world, state, distance, render, fade, runtime);
|
|
435
493
|
if (!drawn) {
|
|
436
494
|
leaveMode(state);
|
|
437
495
|
render();
|
|
@@ -442,7 +500,7 @@ function guardedFrame(world, state, distance, fitBias, render, fade) {
|
|
|
442
500
|
|
|
443
501
|
// Draws the frame with the mode's own shadow on the sun, if the terms hold.
|
|
444
502
|
// False when they do not and nothing has been drawn.
|
|
445
|
-
function nearFrame(world, state, distance, render, fade) {
|
|
503
|
+
function nearFrame(world, state, distance, render, fade, runtime) {
|
|
446
504
|
const sun = sunOf(world);
|
|
447
505
|
if (!sun) return false;
|
|
448
506
|
state.shadow ??= makeNearShadow(state.onCallout);
|
|
@@ -451,11 +509,20 @@ function nearFrame(world, state, distance, render, fade) {
|
|
|
451
509
|
// Fitting may free a map of the wrong size, whose `dispose` runs someone
|
|
452
510
|
// else's code: a call from there has left the mode.
|
|
453
511
|
if (!fit(frame.near, frame.own, world, distance) || state.frame !== frame) return false;
|
|
512
|
+
const cacheStill = runtime?.data?.engine?.shadows?.cacheStill === true && canCacheStill(world.renderer, world.scene);
|
|
513
|
+
if (!cacheStill && frame.near.stillCache) frame.near.release();
|
|
514
|
+
if (state.frame !== frame) return false;
|
|
515
|
+
if (cacheStill) {
|
|
516
|
+
frame.cache = frame.near.stillCache ??= new StillShadows(world, frame.near);
|
|
517
|
+
}
|
|
454
518
|
sun.shadow = frame.near;
|
|
455
519
|
if (fade) {
|
|
456
520
|
frame.fade = fade;
|
|
457
521
|
fade.begin(frame.near.reach, sun);
|
|
458
522
|
}
|
|
523
|
+
// Outside the fade's hook, so it restores originals before either depth
|
|
524
|
+
// pass, and giveBack removes the two hooks in the opposite order.
|
|
525
|
+
frame.cache?.begin(frame, runtime);
|
|
459
526
|
render();
|
|
460
527
|
return true;
|
|
461
528
|
}
|