@egret/engine 0.0.0-stage → 7.0.1-rc.3
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/LICENSE +201 -0
- package/NOTICE +21 -0
- package/README.md +101 -2
- package/README.zh-CN.md +102 -0
- package/dist/Engine.d.ts +77 -0
- package/dist/Engine.js +464 -0
- package/dist/animation/index.d.ts +6 -0
- package/dist/animation/index.js +5 -0
- package/dist/animation/sequenceController.d.ts +22 -0
- package/dist/animation/sequenceController.js +618 -0
- package/dist/animation/sequenceCoordinator.d.ts +26 -0
- package/dist/animation/sequenceCoordinator.js +161 -0
- package/dist/animation/sequenceInput.d.ts +25 -0
- package/dist/animation/sequenceInput.js +108 -0
- package/dist/animation/sequenceMath.d.ts +35 -0
- package/dist/animation/sequenceMath.js +164 -0
- package/dist/animation/sequenceResetSlot.d.ts +7 -0
- package/dist/animation/sequenceResetSlot.js +367 -0
- package/dist/animation/sequenceResetTypes.d.ts +42 -0
- package/dist/animation/sequenceResetTypes.js +2 -0
- package/dist/animation/types.d.ts +69 -0
- package/dist/animation/types.js +2 -0
- package/dist/assetBundle.d.ts +52 -0
- package/dist/assetBundle.js +173 -0
- package/dist/assetGroup.d.ts +17 -0
- package/dist/assetGroup.js +332 -0
- package/dist/assetGroupTypes.d.ts +15 -0
- package/dist/assetGroupTypes.js +2 -0
- package/dist/audio.d.ts +4 -0
- package/dist/audio.js +4 -0
- package/dist/audioCues.d.ts +43 -0
- package/dist/audioCues.js +127 -0
- package/dist/audioMixer.d.ts +7 -0
- package/dist/audioMixer.js +785 -0
- package/dist/audioTypes.d.ts +233 -0
- package/dist/audioTypes.js +3 -0
- package/dist/bitmapBindingTicket.d.ts +24 -0
- package/dist/bitmapBindingTicket.js +215 -0
- package/dist/bitmapButton.d.ts +4 -0
- package/dist/bitmapButton.js +407 -0
- package/dist/bitmapButtonTypes.d.ts +29 -0
- package/dist/bitmapButtonTypes.js +2 -0
- package/dist/bitmapFontParse.d.ts +10 -0
- package/dist/bitmapFontParse.js +246 -0
- package/dist/bitmapFontTypes.d.ts +109 -0
- package/dist/bitmapFontTypes.js +2 -0
- package/dist/bitmapResourceSlot.d.ts +25 -0
- package/dist/bitmapResourceSlot.js +340 -0
- package/dist/bitmapText.d.ts +6 -0
- package/dist/bitmapText.js +320 -0
- package/dist/bitmapfont.d.ts +5 -0
- package/dist/bitmapfont.js +5 -0
- package/dist/camera.d.ts +4 -0
- package/dist/camera.js +4 -0
- package/dist/camera2d.d.ts +7 -0
- package/dist/camera2d.js +411 -0
- package/dist/cameraTypes.d.ts +114 -0
- package/dist/cameraTypes.js +2 -0
- package/dist/closeHost.d.ts +4 -0
- package/dist/closeHost.js +66 -0
- package/dist/contentArtifacts.d.ts +12 -0
- package/dist/contentArtifacts.js +153 -0
- package/dist/contentAtlasPages.d.ts +13 -0
- package/dist/contentAtlasPages.js +117 -0
- package/dist/contentLoader.d.ts +6 -0
- package/dist/contentLoader.js +327 -0
- package/dist/contentTypes.d.ts +33 -0
- package/dist/contentTypes.js +2 -0
- package/dist/createEngine.d.ts +7 -0
- package/dist/createEngine.js +25 -0
- package/dist/createEngineForProfile.d.ts +5 -0
- package/dist/createEngineForProfile.js +42 -0
- package/dist/displaySubtreeTicket.d.ts +25 -0
- package/dist/displaySubtreeTicket.js +76 -0
- package/dist/fontContentLoader.d.ts +6 -0
- package/dist/fontContentLoader.js +298 -0
- package/dist/fontContentTypes.d.ts +34 -0
- package/dist/fontContentTypes.js +2 -0
- package/dist/gameClock.d.ts +24 -0
- package/dist/gameClock.js +246 -0
- package/dist/gameClockTypes.d.ts +31 -0
- package/dist/gameClockTypes.js +2 -0
- package/dist/gameRun.d.ts +50 -0
- package/dist/gameRun.js +97 -0
- package/dist/gamepad.d.ts +5 -0
- package/dist/gamepad.js +5 -0
- package/dist/gamepadInput.d.ts +4 -0
- package/dist/gamepadInput.js +281 -0
- package/dist/gamepadKeys.d.ts +4 -0
- package/dist/gamepadKeys.js +205 -0
- package/dist/gamepadTypes.d.ts +134 -0
- package/dist/gamepadTypes.js +3 -0
- package/dist/hover.d.ts +4 -0
- package/dist/hover.js +4 -0
- package/dist/hoverInput.d.ts +8 -0
- package/dist/hoverInput.js +503 -0
- package/dist/hoverInputTypes.d.ts +119 -0
- package/dist/hoverInputTypes.js +2 -0
- package/dist/index.d.ts +49 -0
- package/dist/index.js +20 -0
- package/dist/input.d.ts +6 -0
- package/dist/input.js +5 -0
- package/dist/inputActions.d.ts +81 -0
- package/dist/inputActions.js +330 -0
- package/dist/internal/contentFactoryState.d.ts +19 -0
- package/dist/internal/contentFactoryState.js +42 -0
- package/dist/internal/mouseInputFactoryState.d.ts +57 -0
- package/dist/internal/mouseInputFactoryState.js +125 -0
- package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
- package/dist/internal/sequenceControllerFactoryState.js +98 -0
- package/dist/internal/textFieldFactoryState.d.ts +11 -0
- package/dist/internal/textFieldFactoryState.js +32 -0
- package/dist/internal/texturedFrameState.d.ts +4 -0
- package/dist/internal/texturedFrameState.js +12 -0
- package/dist/internal/uiFactoryState.d.ts +64 -0
- package/dist/internal/uiFactoryState.js +157 -0
- package/dist/internal/uiRootState.d.ts +67 -0
- package/dist/internal/uiRootState.js +103 -0
- package/dist/keyboardInput.d.ts +12 -0
- package/dist/keyboardInput.js +578 -0
- package/dist/keyboardInputTypes.d.ts +81 -0
- package/dist/keyboardInputTypes.js +2 -0
- package/dist/kit.d.ts +14 -0
- package/dist/kit.js +9 -0
- package/dist/layout.d.ts +5 -0
- package/dist/layout.js +132 -0
- package/dist/layoutTypes.d.ts +28 -0
- package/dist/layoutTypes.js +2 -0
- package/dist/manifestAssetGroup.d.ts +10 -0
- package/dist/manifestAssetGroup.js +477 -0
- package/dist/manifestResourceState.d.ts +16 -0
- package/dist/manifestResourceState.js +57 -0
- package/dist/manifestResourceTypes.d.ts +25 -0
- package/dist/manifestResourceTypes.js +2 -0
- package/dist/motion.d.ts +33 -0
- package/dist/motion.js +206 -0
- package/dist/mouseInput.d.ts +102 -0
- package/dist/mouseInput.js +562 -0
- package/dist/mouseInputTypes.d.ts +37 -0
- package/dist/mouseInputTypes.js +2 -0
- package/dist/paragraph.d.ts +8 -0
- package/dist/paragraph.js +7 -0
- package/dist/particleEmitter.d.ts +4 -0
- package/dist/particleEmitter.js +292 -0
- package/dist/particleTypes.d.ts +107 -0
- package/dist/particleTypes.js +2 -0
- package/dist/particles.d.ts +4 -0
- package/dist/particles.js +4 -0
- package/dist/physics2d.d.ts +4 -0
- package/dist/physics2d.js +4 -0
- package/dist/physics2dGeometry.d.ts +39 -0
- package/dist/physics2dGeometry.js +230 -0
- package/dist/physics2dTypes.d.ts +167 -0
- package/dist/physics2dTypes.js +2 -0
- package/dist/physics2dWorld.d.ts +4 -0
- package/dist/physics2dWorld.js +623 -0
- package/dist/pointerInput.d.ts +11 -0
- package/dist/pointerInput.js +299 -0
- package/dist/pointerInputTypes.d.ts +38 -0
- package/dist/pointerInputTypes.js +2 -0
- package/dist/random.d.ts +29 -0
- package/dist/random.js +131 -0
- package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
- package/dist/rendering/ownedPreparationFailure2D.js +33 -0
- package/dist/rendering/packSharedDraws2D.d.ts +50 -0
- package/dist/rendering/packSharedDraws2D.js +331 -0
- package/dist/rendering/packedOrientation.d.ts +4 -0
- package/dist/rendering/packedOrientation.js +7 -0
- package/dist/rendering/prepareRectangles2D.d.ts +92 -0
- package/dist/rendering/prepareRectangles2D.js +481 -0
- package/dist/rendering/prepareSharedDraws2D.d.ts +88 -0
- package/dist/rendering/prepareSharedDraws2D.js +652 -0
- package/dist/rendering/preparedBatches2D.d.ts +17 -0
- package/dist/rendering/preparedBatches2D.js +30 -0
- package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
- package/dist/rendering/preparedSharedBatches2D.js +247 -0
- package/dist/rendering/sharedColor2D.d.ts +18 -0
- package/dist/rendering/sharedColor2D.js +68 -0
- package/dist/rendering/sharedEffects2D.d.ts +23 -0
- package/dist/rendering/sharedEffects2D.js +118 -0
- package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
- package/dist/rendering/sharedPreparationRetention2D.js +357 -0
- package/dist/rendering/srgbBytes.d.ts +3 -0
- package/dist/rendering/srgbBytes.js +64 -0
- package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
- package/dist/rendering/texturedPreparationBudget2D.js +81 -0
- package/dist/rendering/world3d/Animation3D.d.ts +95 -0
- package/dist/rendering/world3d/Animation3D.js +380 -0
- package/dist/rendering/world3d/AnimationTexture3D.d.ts +157 -0
- package/dist/rendering/world3d/AnimationTexture3D.js +601 -0
- package/dist/rendering/world3d/Batch3D.d.ts +71 -0
- package/dist/rendering/world3d/Batch3D.js +329 -0
- package/dist/rendering/world3d/Camera3D.d.ts +57 -0
- package/dist/rendering/world3d/Camera3D.js +129 -0
- package/dist/rendering/world3d/Character3D.d.ts +123 -0
- package/dist/rendering/world3d/Character3D.js +303 -0
- package/dist/rendering/world3d/Cloth3D.d.ts +115 -0
- package/dist/rendering/world3d/Cloth3D.js +498 -0
- package/dist/rendering/world3d/Compression3D.d.ts +21 -0
- package/dist/rendering/world3d/Compression3D.js +702 -0
- package/dist/rendering/world3d/Curves3D.d.ts +111 -0
- package/dist/rendering/world3d/Curves3D.js +455 -0
- package/dist/rendering/world3d/Decal3D.d.ts +41 -0
- package/dist/rendering/world3d/Decal3D.js +241 -0
- package/dist/rendering/world3d/Geometry3D.d.ts +85 -0
- package/dist/rendering/world3d/Geometry3D.js +326 -0
- package/dist/rendering/world3d/GeometryBuilder3D.d.ts +51 -0
- package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
- package/dist/rendering/world3d/Gizmo3D.d.ts +75 -0
- package/dist/rendering/world3d/Gizmo3D.js +512 -0
- package/dist/rendering/world3d/Gltf3D.d.ts +67 -0
- package/dist/rendering/world3d/Gltf3D.js +976 -0
- package/dist/rendering/world3d/GpuParticles3D.d.ts +107 -0
- package/dist/rendering/world3d/GpuParticles3D.js +400 -0
- package/dist/rendering/world3d/Hdr3D.d.ts +33 -0
- package/dist/rendering/world3d/Hdr3D.js +190 -0
- package/dist/rendering/world3d/Jelly3D.d.ts +75 -0
- package/dist/rendering/world3d/Jelly3D.js +266 -0
- package/dist/rendering/world3d/Ktx23D.d.ts +27 -0
- package/dist/rendering/world3d/Ktx23D.js +112 -0
- package/dist/rendering/world3d/Light3D.d.ts +75 -0
- package/dist/rendering/world3d/Light3D.js +93 -0
- package/dist/rendering/world3d/Material3D.d.ts +243 -0
- package/dist/rendering/world3d/Material3D.js +267 -0
- package/dist/rendering/world3d/Mesh3D.d.ts +108 -0
- package/dist/rendering/world3d/Mesh3D.js +323 -0
- package/dist/rendering/world3d/Meshopt3D.d.ts +12 -0
- package/dist/rendering/world3d/Meshopt3D.js +275 -0
- package/dist/rendering/world3d/Navigation3D.d.ts +173 -0
- package/dist/rendering/world3d/Navigation3D.js +971 -0
- package/dist/rendering/world3d/Object3D.d.ts +107 -0
- package/dist/rendering/world3d/Object3D.js +305 -0
- package/dist/rendering/world3d/Particles3D.d.ts +85 -0
- package/dist/rendering/world3d/Particles3D.js +274 -0
- package/dist/rendering/world3d/Physics3D.d.ts +416 -0
- package/dist/rendering/world3d/Physics3D.js +2835 -0
- package/dist/rendering/world3d/PhysicsHull3D.d.ts +35 -0
- package/dist/rendering/world3d/PhysicsHull3D.js +227 -0
- package/dist/rendering/world3d/PhysicsMesh3D.d.ts +39 -0
- package/dist/rendering/world3d/PhysicsMesh3D.js +338 -0
- package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
- package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
- package/dist/rendering/world3d/PhysicsRemote3D.d.ts +174 -0
- package/dist/rendering/world3d/PhysicsRemote3D.js +534 -0
- package/dist/rendering/world3d/Ragdoll3D.d.ts +69 -0
- package/dist/rendering/world3d/Ragdoll3D.js +200 -0
- package/dist/rendering/world3d/Raycast3D.d.ts +37 -0
- package/dist/rendering/world3d/Raycast3D.js +246 -0
- package/dist/rendering/world3d/RenderList3D.d.ts +88 -0
- package/dist/rendering/world3d/RenderList3D.js +490 -0
- package/dist/rendering/world3d/Retarget3D.d.ts +20 -0
- package/dist/rendering/world3d/Retarget3D.js +185 -0
- package/dist/rendering/world3d/Serialize3D.d.ts +49 -0
- package/dist/rendering/world3d/Serialize3D.js +607 -0
- package/dist/rendering/world3d/StateMachine3D.d.ts +78 -0
- package/dist/rendering/world3d/StateMachine3D.js +277 -0
- package/dist/rendering/world3d/Terrain3D.d.ts +227 -0
- package/dist/rendering/world3d/Terrain3D.js +803 -0
- package/dist/rendering/world3d/Text3D.d.ts +90 -0
- package/dist/rendering/world3d/Text3D.js +558 -0
- package/dist/rendering/world3d/Texture3D.d.ts +133 -0
- package/dist/rendering/world3d/Texture3D.js +252 -0
- package/dist/rendering/world3d/Trail3D.d.ts +59 -0
- package/dist/rendering/world3d/Trail3D.js +193 -0
- package/dist/rendering/world3d/Vehicle3D.d.ts +97 -0
- package/dist/rendering/world3d/Vehicle3D.js +226 -0
- package/dist/rendering/world3d/VolumetricFog3D.d.ts +55 -0
- package/dist/rendering/world3d/VolumetricFog3D.js +229 -0
- package/dist/rendering/world3d/Water3D.d.ts +163 -0
- package/dist/rendering/world3d/Water3D.js +606 -0
- package/dist/rendering/world3d/core3D.d.ts +34 -0
- package/dist/rendering/world3d/core3D.js +99 -0
- package/dist/rendering/world3d/debug3D.d.ts +64 -0
- package/dist/rendering/world3d/debug3D.js +257 -0
- package/dist/rendering/world3d/decoders3D.d.ts +42 -0
- package/dist/rendering/world3d/decoders3D.js +133 -0
- package/dist/rendering/world3d/geometries3D.d.ts +99 -0
- package/dist/rendering/world3d/geometries3D.js +605 -0
- package/dist/rendering/world3d/helpers3D.d.ts +65 -0
- package/dist/rendering/world3d/helpers3D.js +177 -0
- package/dist/rendering/world3d/index.d.ts +91 -0
- package/dist/rendering/world3d/index.js +56 -0
- package/dist/rendering/world3d/math3D.d.ts +78 -0
- package/dist/rendering/world3d/math3D.js +640 -0
- package/dist/rendering/world3d/primitives3D.d.ts +60 -0
- package/dist/rendering/world3d/primitives3D.js +196 -0
- package/dist/resources.d.ts +8 -0
- package/dist/resources.js +6 -0
- package/dist/saveStore.d.ts +56 -0
- package/dist/saveStore.js +163 -0
- package/dist/semanticList.d.ts +122 -0
- package/dist/semanticList.js +174 -0
- package/dist/semanticTree.d.ts +10 -0
- package/dist/semanticTree.js +532 -0
- package/dist/semanticTypes.d.ts +167 -0
- package/dist/semanticTypes.js +2 -0
- package/dist/semantics.d.ts +6 -0
- package/dist/semantics.js +5 -0
- package/dist/sequencePlayback.d.ts +19 -0
- package/dist/sequencePlayback.js +391 -0
- package/dist/sequencePlaybackTypes.d.ts +21 -0
- package/dist/sequencePlaybackTypes.js +2 -0
- package/dist/sequenceTargetClaims.d.ts +10 -0
- package/dist/sequenceTargetClaims.js +31 -0
- package/dist/srgbBytes.d.ts +3 -0
- package/dist/srgbBytes.js +64 -0
- package/dist/startEngine.d.ts +5 -0
- package/dist/startEngine.js +31 -0
- package/dist/surfaceOwnership.d.ts +3 -0
- package/dist/surfaceOwnership.js +15 -0
- package/dist/text.d.ts +23 -0
- package/dist/text.js +4 -0
- package/dist/textField.d.ts +6 -0
- package/dist/textField.js +6 -0
- package/dist/tileMapDraw.d.ts +7 -0
- package/dist/tileMapDraw.js +310 -0
- package/dist/tiledImport.d.ts +9 -0
- package/dist/tiledImport.js +357 -0
- package/dist/tilemap.d.ts +5 -0
- package/dist/tilemap.js +5 -0
- package/dist/tilemapTypes.d.ts +169 -0
- package/dist/tilemapTypes.js +2 -0
- package/dist/tween.d.ts +15 -0
- package/dist/tween.js +329 -0
- package/dist/tweenTypes.d.ts +27 -0
- package/dist/tweenTypes.js +2 -0
- package/dist/ui/controlKeys.d.ts +109 -0
- package/dist/ui/controlKeys.js +249 -0
- package/dist/ui/controls.d.ts +52 -0
- package/dist/ui/controls.js +288 -0
- package/dist/ui/editing.d.ts +3 -0
- package/dist/ui/editing.js +3 -0
- package/dist/ui/index.d.ts +19 -0
- package/dist/ui/index.js +11 -0
- package/dist/ui/keyboardFocus.d.ts +32 -0
- package/dist/ui/keyboardFocus.js +146 -0
- package/dist/ui/layerTypes.d.ts +91 -0
- package/dist/ui/layerTypes.js +2 -0
- package/dist/ui/layers.d.ts +4 -0
- package/dist/ui/layers.js +586 -0
- package/dist/ui/leafContent.d.ts +21 -0
- package/dist/ui/leafContent.js +136 -0
- package/dist/ui/rangeControl.d.ts +50 -0
- package/dist/ui/rangeControl.js +167 -0
- package/dist/ui/scrollControl.d.ts +72 -0
- package/dist/ui/scrollControl.js +218 -0
- package/dist/ui/stateControls.d.ts +82 -0
- package/dist/ui/stateControls.js +328 -0
- package/dist/ui/textEditor.d.ts +53 -0
- package/dist/ui/textEditor.js +370 -0
- package/dist/ui/textEditorTypes.d.ts +78 -0
- package/dist/ui/textEditorTypes.js +2 -0
- package/dist/ui/textFieldControl.d.ts +96 -0
- package/dist/ui/textFieldControl.js +259 -0
- package/dist/ui/theme.d.ts +59 -0
- package/dist/ui/theme.js +165 -0
- package/dist/ui/types.d.ts +265 -0
- package/dist/ui/types.js +2 -0
- package/dist/ui/uiRoot.d.ts +4 -0
- package/dist/ui/uiRoot.js +1497 -0
- package/dist/ui/uiRootDisplay.d.ts +46 -0
- package/dist/ui/uiRootDisplay.js +148 -0
- package/dist/ui/uiRootModel.d.ts +112 -0
- package/dist/ui/uiRootModel.js +60 -0
- package/dist/ui/virtualList.d.ts +20 -0
- package/dist/ui/virtualList.js +105 -0
- package/dist/video.d.ts +4 -0
- package/dist/video.js +4 -0
- package/dist/videoPlayer.d.ts +4 -0
- package/dist/videoPlayer.js +215 -0
- package/dist/videoTypes.d.ts +74 -0
- package/dist/videoTypes.js +2 -0
- package/dist/web/BrowserAssetBundle.d.ts +39 -0
- package/dist/web/BrowserAssetBundle.js +136 -0
- package/dist/web/BrowserAudio.d.ts +41 -0
- package/dist/web/BrowserAudio.js +473 -0
- package/dist/web/BrowserFrameLoop.d.ts +65 -0
- package/dist/web/BrowserFrameLoop.js +125 -0
- package/dist/web/BrowserGame.d.ts +112 -0
- package/dist/web/BrowserGame.js +352 -0
- package/dist/web/BrowserGamepadInput.d.ts +35 -0
- package/dist/web/BrowserGamepadInput.js +134 -0
- package/dist/web/BrowserHoverInput.d.ts +24 -0
- package/dist/web/BrowserHoverInput.js +266 -0
- package/dist/web/BrowserImageTextures.d.ts +66 -0
- package/dist/web/BrowserImageTextures.js +169 -0
- package/dist/web/BrowserInputActions.d.ts +53 -0
- package/dist/web/BrowserInputActions.js +342 -0
- package/dist/web/BrowserKeyboardInput.d.ts +4 -0
- package/dist/web/BrowserKeyboardInput.js +223 -0
- package/dist/web/BrowserPlay.d.ts +289 -0
- package/dist/web/BrowserPlay.js +1301 -0
- package/dist/web/BrowserPointerInput.d.ts +4 -0
- package/dist/web/BrowserPointerInput.js +511 -0
- package/dist/web/BrowserSemantics.d.ts +34 -0
- package/dist/web/BrowserSemantics.js +418 -0
- package/dist/web/BrowserStatsPanel.d.ts +46 -0
- package/dist/web/BrowserStatsPanel.js +137 -0
- package/dist/web/BrowserStorage.d.ts +33 -0
- package/dist/web/BrowserStorage.js +132 -0
- package/dist/web/BrowserTextEditor.d.ts +49 -0
- package/dist/web/BrowserTextEditor.js +839 -0
- package/dist/web/BrowserTextInput.d.ts +83 -0
- package/dist/web/BrowserTextInput.js +524 -0
- package/dist/web/BrowserTextureProvider.d.ts +52 -0
- package/dist/web/BrowserTextureProvider.js +935 -0
- package/dist/web/BrowserVideo.d.ts +28 -0
- package/dist/web/BrowserVideo.js +211 -0
- package/dist/web/CanvasKitFontSetProvider.d.ts +29 -0
- package/dist/web/CanvasKitFontSetProvider.js +215 -0
- package/dist/web/CanvasKitParagraphProvider.d.ts +169 -0
- package/dist/web/CanvasKitParagraphProvider.js +691 -0
- package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
- package/dist/web/CanvasTextRasterProvider.js +312 -0
- package/dist/web/ManifestByteSource.d.ts +147 -0
- package/dist/web/ManifestByteSource.js +974 -0
- package/dist/web/ManifestFontContentLoader.d.ts +12 -0
- package/dist/web/ManifestFontContentLoader.js +30 -0
- package/dist/web/MouseInput.d.ts +4 -0
- package/dist/web/MouseInput.js +218 -0
- package/dist/web/WebGL2Host.d.ts +5 -0
- package/dist/web/WebGL2Host.js +2672 -0
- package/dist/web/WebGPUHost.d.ts +87 -0
- package/dist/web/WebGPUHost.js +3349 -0
- package/dist/web/audio.d.ts +3 -0
- package/dist/web/audio.js +4 -0
- package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
- package/dist/web/canvasKitParagraphGeometry.js +83 -0
- package/dist/web/editing.d.ts +5 -0
- package/dist/web/editing.js +4 -0
- package/dist/web/editorFonts.d.ts +50 -0
- package/dist/web/editorFonts.js +297 -0
- package/dist/web/game.d.ts +5 -0
- package/dist/web/game.js +6 -0
- package/dist/web/gamepad.d.ts +3 -0
- package/dist/web/gamepad.js +4 -0
- package/dist/web/hover.d.ts +3 -0
- package/dist/web/hover.js +4 -0
- package/dist/web/image.d.ts +4 -0
- package/dist/web/image.js +4 -0
- package/dist/web/imageProjections2D.d.ts +14 -0
- package/dist/web/imageProjections2D.js +2 -0
- package/dist/web/input.d.ts +6 -0
- package/dist/web/input.js +4 -0
- package/dist/web/keyboard.d.ts +3 -0
- package/dist/web/keyboard.js +3 -0
- package/dist/web/kit.d.ts +10 -0
- package/dist/web/kit.js +7 -0
- package/dist/web/loop.d.ts +3 -0
- package/dist/web/loop.js +4 -0
- package/dist/web/paragraph.d.ts +6 -0
- package/dist/web/paragraph.js +4 -0
- package/dist/web/play.d.ts +5 -0
- package/dist/web/play.js +6 -0
- package/dist/web/playSfx.d.ts +36 -0
- package/dist/web/playSfx.js +112 -0
- package/dist/web/pointer.d.ts +3 -0
- package/dist/web/pointer.js +3 -0
- package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
- package/dist/web/prepareSharedSubmission2D.js +57 -0
- package/dist/web/resources.d.ts +27 -0
- package/dist/web/resources.js +96 -0
- package/dist/web/semantics.d.ts +3 -0
- package/dist/web/semantics.js +4 -0
- package/dist/web/sharedDeviceSession.d.ts +64 -0
- package/dist/web/sharedDeviceSession.js +2 -0
- package/dist/web/sharedEffectShaders.d.ts +9 -0
- package/dist/web/sharedEffectShaders.js +165 -0
- package/dist/web/sharedFrameUpload.d.ts +25 -0
- package/dist/web/sharedFrameUpload.js +2 -0
- package/dist/web/sharedHostDeferred.d.ts +7 -0
- package/dist/web/sharedHostDeferred.js +12 -0
- package/dist/web/sharedRetentionLedger.d.ts +85 -0
- package/dist/web/sharedRetentionLedger.js +391 -0
- package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
- package/dist/web/sharedSubmissionStorage2D.js +73 -0
- package/dist/web/sharedWebGL2Arena.d.ts +40 -0
- package/dist/web/sharedWebGL2Arena.js +77 -0
- package/dist/web/sharedWebGL2Options.d.ts +30 -0
- package/dist/web/sharedWebGL2Options.js +96 -0
- package/dist/web/sharedWebGL2Shaders.d.ts +20 -0
- package/dist/web/sharedWebGL2Shaders.js +314 -0
- package/dist/web/sharedWebGPUOptions.d.ts +37 -0
- package/dist/web/sharedWebGPUOptions.js +126 -0
- package/dist/web/text.d.ts +3 -0
- package/dist/web/text.js +3 -0
- package/dist/web/textInput.d.ts +3 -0
- package/dist/web/textInput.js +3 -0
- package/dist/web/video.d.ts +3 -0
- package/dist/web/video.js +4 -0
- package/dist/web/webgl2.d.ts +7 -0
- package/dist/web/webgl2.js +4 -0
- package/dist/web/webgl2LayerState.d.ts +50 -0
- package/dist/web/webgl2LayerState.js +102 -0
- package/dist/web/webgl2Native.d.ts +70 -0
- package/dist/web/webgl2Native.js +568 -0
- package/dist/web/webgl2Types.d.ts +132 -0
- package/dist/web/webgl2Types.js +2 -0
- package/dist/web/webgpu.d.ts +6 -0
- package/dist/web/webgpu.js +2 -0
- package/dist/web/webgpuBindingCache.d.ts +26 -0
- package/dist/web/webgpuBindingCache.js +223 -0
- package/dist/web/webgpuBufferPool.d.ts +51 -0
- package/dist/web/webgpuBufferPool.js +58 -0
- package/dist/web/webgpuImageResidency.d.ts +53 -0
- package/dist/web/webgpuImageResidency.js +61 -0
- package/dist/web/webgpuLifetime.d.ts +45 -0
- package/dist/web/webgpuLifetime.js +64 -0
- package/dist/web/webgpuRetentionPool.d.ts +66 -0
- package/dist/web/webgpuRetentionPool.js +84 -0
- package/dist/web/webgpuSharedPass.d.ts +7 -0
- package/dist/web/webgpuSharedPass.js +211 -0
- package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
- package/dist/web/webgpuSharedResolvePass.js +29 -0
- package/dist/web/world3d/Audio3D.d.ts +68 -0
- package/dist/web/world3d/Audio3D.js +212 -0
- package/dist/web/world3d/BrowserPlay3D.d.ts +182 -0
- package/dist/web/world3d/BrowserPlay3D.js +851 -0
- package/dist/web/world3d/FlyControls3D.d.ts +55 -0
- package/dist/web/world3d/FlyControls3D.js +160 -0
- package/dist/web/world3d/FollowControls3D.d.ts +28 -0
- package/dist/web/world3d/FollowControls3D.js +117 -0
- package/dist/web/world3d/OrbitControls3D.d.ts +55 -0
- package/dist/web/world3d/OrbitControls3D.js +187 -0
- package/dist/web/world3d/TransformControls3D.d.ts +34 -0
- package/dist/web/world3d/TransformControls3D.js +125 -0
- package/dist/web/world3d/WebGL2Renderer3D.d.ts +133 -0
- package/dist/web/world3d/WebGL2Renderer3D.js +1173 -0
- package/dist/web/world3d/WebGPURenderer3D.d.ts +110 -0
- package/dist/web/world3d/WebGPURenderer3D.js +1915 -0
- package/dist/web/world3d/World3DView.d.ts +51 -0
- package/dist/web/world3d/World3DView.js +77 -0
- package/dist/web/world3d/app3D.d.ts +136 -0
- package/dist/web/world3d/app3D.js +304 -0
- package/dist/web/world3d/assets3D.d.ts +38 -0
- package/dist/web/world3d/assets3D.js +112 -0
- package/dist/web/world3d/atmosphere3D.d.ts +47 -0
- package/dist/web/world3d/atmosphere3D.js +178 -0
- package/dist/web/world3d/frame3D.d.ts +142 -0
- package/dist/web/world3d/frame3D.js +388 -0
- package/dist/web/world3d/gpuResources3D.d.ts +98 -0
- package/dist/web/world3d/gpuResources3D.js +901 -0
- package/dist/web/world3d/host3D.d.ts +23 -0
- package/dist/web/world3d/host3D.js +61 -0
- package/dist/web/world3d/index.d.ts +38 -0
- package/dist/web/world3d/index.js +23 -0
- package/dist/web/world3d/loaders3D.d.ts +26 -0
- package/dist/web/world3d/loaders3D.js +138 -0
- package/dist/web/world3d/markers3D.d.ts +49 -0
- package/dist/web/world3d/markers3D.js +130 -0
- package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
- package/dist/web/world3d/materialWebGL23D.js +218 -0
- package/dist/web/world3d/overlay3D.d.ts +28 -0
- package/dist/web/world3d/overlay3D.js +170 -0
- package/dist/web/world3d/post3D.d.ts +112 -0
- package/dist/web/world3d/post3D.js +459 -0
- package/dist/web/world3d/postWebGL23D.d.ts +24 -0
- package/dist/web/world3d/postWebGL23D.js +237 -0
- package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
- package/dist/web/world3d/postWebGPU3D.js +255 -0
- package/dist/web/world3d/probe3D.d.ts +14 -0
- package/dist/web/world3d/probe3D.js +66 -0
- package/dist/web/world3d/shaders3D.d.ts +43 -0
- package/dist/web/world3d/shaders3D.js +851 -0
- package/dist/web/world3d/stats3D.d.ts +31 -0
- package/dist/web/world3d/stats3D.js +80 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +66 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
- package/dist/web/world3d/webgpu.d.ts +35 -0
- package/dist/web/world3d/webgpu.js +22 -0
- package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
- package/dist/web/world3d/webgpuPacking3D.js +85 -0
- package/dist/web/world3d/wgsl3D.d.ts +68 -0
- package/dist/web/world3d/wgsl3D.js +781 -0
- package/package.json +220 -4
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
import { EgretError, Scope } from '@egret/runtime';
|
|
2
|
+
const MAX_SUBSCRIPTIONS = 256;
|
|
3
|
+
const scopeState = Object.getOwnPropertyDescriptor(Scope.prototype, 'state').get;
|
|
4
|
+
const scopeUse = Scope.prototype.use;
|
|
5
|
+
/** Admission retains only a frozen scalar, never the caller's option object. */
|
|
6
|
+
export function admitGameClockOptions(value) {
|
|
7
|
+
let maximum;
|
|
8
|
+
if (value !== undefined) {
|
|
9
|
+
if (value === null || typeof value !== 'object')
|
|
10
|
+
throw new EgretError('CLOCK_OPTIONS_INVALID');
|
|
11
|
+
let isArray;
|
|
12
|
+
try {
|
|
13
|
+
isArray = Array.isArray(value);
|
|
14
|
+
}
|
|
15
|
+
catch (cause) {
|
|
16
|
+
throw new EgretError('CLOCK_OPTIONS_INVALID', { cause });
|
|
17
|
+
}
|
|
18
|
+
if (isArray)
|
|
19
|
+
throw new EgretError('CLOCK_OPTIONS_INVALID');
|
|
20
|
+
try {
|
|
21
|
+
maximum = value.maxDeltaSeconds;
|
|
22
|
+
}
|
|
23
|
+
catch (cause) {
|
|
24
|
+
throw new EgretError('CLOCK_OPTIONS_INVALID', { cause });
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
if (maximum === undefined)
|
|
28
|
+
maximum = 0.25;
|
|
29
|
+
if (typeof maximum !== 'number' || !Number.isFinite(maximum) || maximum <= 0 || maximum > 1)
|
|
30
|
+
throw new EgretError('CLOCK_OPTIONS_INVALID');
|
|
31
|
+
return Object.freeze({ maxDeltaSeconds: maximum });
|
|
32
|
+
}
|
|
33
|
+
/** Invalid asynchronous returns are observed, never awaited or accepted. */
|
|
34
|
+
function observeRejectedResult(result) {
|
|
35
|
+
const ignoreRejection = () => { };
|
|
36
|
+
try {
|
|
37
|
+
void Reflect.apply(Promise.prototype.then, result, [undefined, ignoreRejection]);
|
|
38
|
+
}
|
|
39
|
+
catch {
|
|
40
|
+
try {
|
|
41
|
+
void Promise.resolve(result).then(undefined, ignoreRejection);
|
|
42
|
+
}
|
|
43
|
+
catch {
|
|
44
|
+
/* Observation cannot replace CLOCK_CALLBACK_RETURN_INVALID. */
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
/** Private owner; public facades supply observation and receiver-checked service. */
|
|
49
|
+
export function createGameClockOwner(context, options) {
|
|
50
|
+
let state = 'running';
|
|
51
|
+
let elapsedSeconds = 0;
|
|
52
|
+
let tickId = 0;
|
|
53
|
+
// The monotonic source floor survives pauses; the running anchor excludes gaps.
|
|
54
|
+
let acceptedSource;
|
|
55
|
+
let anchor;
|
|
56
|
+
let nextSequence = 1;
|
|
57
|
+
let liveCount = 0;
|
|
58
|
+
let busy = false;
|
|
59
|
+
let idle;
|
|
60
|
+
let releaseIdle;
|
|
61
|
+
// Slots retain only live registrations. Scope's historical handles remain its own.
|
|
62
|
+
const slots = new Array(MAX_SUBSCRIPTIONS).fill(undefined);
|
|
63
|
+
function retire(record) {
|
|
64
|
+
if (record.disposed)
|
|
65
|
+
return;
|
|
66
|
+
record.disposed = true;
|
|
67
|
+
record.handler = undefined;
|
|
68
|
+
if (slots[record.slot] === record) {
|
|
69
|
+
slots[record.slot] = undefined;
|
|
70
|
+
liveCount--;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
function assertClock(receiver) {
|
|
74
|
+
if (receiver !== clock)
|
|
75
|
+
throw new EgretError('CLOCK_INVALID');
|
|
76
|
+
}
|
|
77
|
+
const clock = Object.freeze({
|
|
78
|
+
get state() {
|
|
79
|
+
assertClock(this);
|
|
80
|
+
return state;
|
|
81
|
+
},
|
|
82
|
+
get elapsedSeconds() {
|
|
83
|
+
assertClock(this);
|
|
84
|
+
return elapsedSeconds;
|
|
85
|
+
},
|
|
86
|
+
get tickId() {
|
|
87
|
+
assertClock(this);
|
|
88
|
+
return tickId;
|
|
89
|
+
},
|
|
90
|
+
get maxDeltaSeconds() {
|
|
91
|
+
assertClock(this);
|
|
92
|
+
return options.maxDeltaSeconds;
|
|
93
|
+
},
|
|
94
|
+
onTick(scope, handler) {
|
|
95
|
+
assertClock(this);
|
|
96
|
+
context.assertOpen();
|
|
97
|
+
if (!context.isEngineScope(scope))
|
|
98
|
+
throw new EgretError('CLOCK_SCOPE_INVALID');
|
|
99
|
+
if (Reflect.apply(scopeState, scope, []) !== 'open')
|
|
100
|
+
throw new EgretError('SCOPE_CLOSED');
|
|
101
|
+
if (typeof handler !== 'function')
|
|
102
|
+
throw new EgretError('CLOCK_HANDLER_INVALID');
|
|
103
|
+
if (liveCount >= MAX_SUBSCRIPTIONS)
|
|
104
|
+
throw new EgretError('CLOCK_CALLBACK_LIMIT');
|
|
105
|
+
if (!Number.isSafeInteger(nextSequence) || nextSequence <= 0)
|
|
106
|
+
throw new EgretError('CLOCK_SUBSCRIPTION_ID_EXHAUSTED');
|
|
107
|
+
const slot = slots.indexOf(undefined);
|
|
108
|
+
const record = { sequence: nextSequence, slot, disposed: false, handler };
|
|
109
|
+
const subscription = Object.freeze({
|
|
110
|
+
get isDisposed() {
|
|
111
|
+
if (this !== subscription)
|
|
112
|
+
throw new EgretError('CLOCK_SUBSCRIPTION_INVALID');
|
|
113
|
+
return record.disposed;
|
|
114
|
+
},
|
|
115
|
+
dispose() {
|
|
116
|
+
if (this !== subscription)
|
|
117
|
+
throw new EgretError('CLOCK_SUBSCRIPTION_INVALID');
|
|
118
|
+
retire(record);
|
|
119
|
+
}
|
|
120
|
+
});
|
|
121
|
+
try {
|
|
122
|
+
Reflect.apply(scopeUse, scope, [subscription]);
|
|
123
|
+
}
|
|
124
|
+
catch (cause) {
|
|
125
|
+
retire(record);
|
|
126
|
+
throw cause;
|
|
127
|
+
}
|
|
128
|
+
// No caller operation runs between intrinsic adoption and slot publication.
|
|
129
|
+
slots[slot] = record;
|
|
130
|
+
liveCount++;
|
|
131
|
+
nextSequence++;
|
|
132
|
+
return subscription;
|
|
133
|
+
},
|
|
134
|
+
pause() {
|
|
135
|
+
assertClock(this);
|
|
136
|
+
context.assertOpen();
|
|
137
|
+
state = 'paused';
|
|
138
|
+
},
|
|
139
|
+
resume() {
|
|
140
|
+
assertClock(this);
|
|
141
|
+
context.assertOpen();
|
|
142
|
+
if (busy)
|
|
143
|
+
throw new EgretError('CLOCK_REENTRANT');
|
|
144
|
+
// Only an actual paused-to-running transition discards the old anchor.
|
|
145
|
+
if (state === 'paused') {
|
|
146
|
+
state = 'running';
|
|
147
|
+
anchor = undefined;
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
});
|
|
151
|
+
return Object.freeze({
|
|
152
|
+
clock,
|
|
153
|
+
advance(sourceSeconds) {
|
|
154
|
+
context.assertOpen();
|
|
155
|
+
if (busy || context.isFrameBusy())
|
|
156
|
+
throw new EgretError('CLOCK_REENTRANT');
|
|
157
|
+
if (typeof sourceSeconds !== 'number' || !Number.isFinite(sourceSeconds) || sourceSeconds < 0)
|
|
158
|
+
throw new EgretError('CLOCK_SOURCE_INVALID');
|
|
159
|
+
const source = sourceSeconds === 0 ? 0 : sourceSeconds;
|
|
160
|
+
if (acceptedSource !== undefined && source < acceptedSource)
|
|
161
|
+
throw new EgretError('CLOCK_SOURCE_BACKWARDS');
|
|
162
|
+
// Paused, initial, resumed and equal samples dispatch no gameplay tick.
|
|
163
|
+
if (state === 'paused') {
|
|
164
|
+
acceptedSource = source;
|
|
165
|
+
return undefined;
|
|
166
|
+
}
|
|
167
|
+
if (anchor === undefined) {
|
|
168
|
+
acceptedSource = source;
|
|
169
|
+
anchor = source;
|
|
170
|
+
return undefined;
|
|
171
|
+
}
|
|
172
|
+
if (source === acceptedSource)
|
|
173
|
+
return undefined;
|
|
174
|
+
const deltaSeconds = source - anchor;
|
|
175
|
+
// Refused samples cannot advance the accepted floor, anchor or game time.
|
|
176
|
+
if (deltaSeconds > options.maxDeltaSeconds)
|
|
177
|
+
throw new EgretError('CLOCK_DELTA_LIMIT');
|
|
178
|
+
const nextElapsed = elapsedSeconds + deltaSeconds;
|
|
179
|
+
if (!Number.isFinite(nextElapsed) || nextElapsed <= elapsedSeconds)
|
|
180
|
+
throw new EgretError('CLOCK_TIME_RANGE');
|
|
181
|
+
const nextTickId = tickId + 1;
|
|
182
|
+
if (!Number.isSafeInteger(nextTickId) || nextTickId <= 0)
|
|
183
|
+
throw new EgretError('CLOCK_TICK_ID_EXHAUSTED');
|
|
184
|
+
const tick = Object.freeze({ tickId: nextTickId, elapsedSeconds: nextElapsed, deltaSeconds });
|
|
185
|
+
// Snapshot identities, not slot numbers: reuse cannot substitute a new handler.
|
|
186
|
+
const candidates = slots
|
|
187
|
+
.filter((record) => record !== undefined)
|
|
188
|
+
.sort((a, b) => a.sequence - b.sequence);
|
|
189
|
+
idle = new Promise(resolve => {
|
|
190
|
+
releaseIdle = resolve;
|
|
191
|
+
});
|
|
192
|
+
busy = true;
|
|
193
|
+
// Commit before callbacks: failure never rolls back time or replays candidates.
|
|
194
|
+
acceptedSource = source;
|
|
195
|
+
anchor = source;
|
|
196
|
+
elapsedSeconds = nextElapsed;
|
|
197
|
+
tickId = nextTickId;
|
|
198
|
+
try {
|
|
199
|
+
for (const candidate of candidates) {
|
|
200
|
+
if (state !== 'running')
|
|
201
|
+
break;
|
|
202
|
+
const handler = candidate.handler;
|
|
203
|
+
if (candidate.disposed || handler === undefined)
|
|
204
|
+
continue;
|
|
205
|
+
try {
|
|
206
|
+
const result = handler(tick);
|
|
207
|
+
if (result !== undefined) {
|
|
208
|
+
observeRejectedResult(result);
|
|
209
|
+
throw new EgretError('CLOCK_CALLBACK_RETURN_INVALID');
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
catch (cause) {
|
|
213
|
+
context.report({ code: 'CLOCK_CALLBACK_FAILED', phase: 'engine', severity: 'error', cause });
|
|
214
|
+
throw new EgretError('CLOCK_CALLBACK_FAILED', { cause });
|
|
215
|
+
}
|
|
216
|
+
}
|
|
217
|
+
return tick;
|
|
218
|
+
}
|
|
219
|
+
finally {
|
|
220
|
+
candidates.length = 0;
|
|
221
|
+
busy = false;
|
|
222
|
+
// Engine cleanup waits for this synchronous callback barrier, not its return.
|
|
223
|
+
const release = releaseIdle;
|
|
224
|
+
releaseIdle = undefined;
|
|
225
|
+
idle = undefined;
|
|
226
|
+
release?.();
|
|
227
|
+
}
|
|
228
|
+
},
|
|
229
|
+
close() {
|
|
230
|
+
if (state === 'closed')
|
|
231
|
+
return;
|
|
232
|
+
// Retire callbacks immediately; the Engine owns subsequent Scope/host cleanup.
|
|
233
|
+
state = 'closed';
|
|
234
|
+
for (const record of slots)
|
|
235
|
+
if (record !== undefined)
|
|
236
|
+
retire(record);
|
|
237
|
+
},
|
|
238
|
+
isBusy() {
|
|
239
|
+
return busy;
|
|
240
|
+
},
|
|
241
|
+
whenIdle() {
|
|
242
|
+
return idle ?? Promise.resolve();
|
|
243
|
+
}
|
|
244
|
+
});
|
|
245
|
+
}
|
|
246
|
+
//# sourceMappingURL=gameClock.js.map
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import type { Disposable } from '@egret/contracts';
|
|
2
|
+
import type { Scope } from '@egret/runtime';
|
|
3
|
+
export interface GameClockOptions {
|
|
4
|
+
readonly maxDeltaSeconds?: number;
|
|
5
|
+
}
|
|
6
|
+
export type GameClockState = 'running' | 'paused' | 'closed';
|
|
7
|
+
export interface GameClockTick {
|
|
8
|
+
readonly tickId: number;
|
|
9
|
+
readonly elapsedSeconds: number;
|
|
10
|
+
readonly deltaSeconds: number;
|
|
11
|
+
}
|
|
12
|
+
export type GameClockHandler = (tick: GameClockTick) => undefined;
|
|
13
|
+
declare const clockBrand: unique symbol;
|
|
14
|
+
declare const subscriptionBrand: unique symbol;
|
|
15
|
+
export interface GameClockSubscription extends Disposable {
|
|
16
|
+
readonly [subscriptionBrand]: true;
|
|
17
|
+
readonly isDisposed: boolean;
|
|
18
|
+
dispose(): void;
|
|
19
|
+
}
|
|
20
|
+
export interface GameClock {
|
|
21
|
+
readonly [clockBrand]: true;
|
|
22
|
+
readonly state: GameClockState;
|
|
23
|
+
readonly elapsedSeconds: number;
|
|
24
|
+
readonly tickId: number;
|
|
25
|
+
readonly maxDeltaSeconds: number;
|
|
26
|
+
onTick(scope: Scope, handler: GameClockHandler): GameClockSubscription;
|
|
27
|
+
pause(): void;
|
|
28
|
+
resume(): void;
|
|
29
|
+
}
|
|
30
|
+
export {};
|
|
31
|
+
//# sourceMappingURL=gameClockTypes.d.ts.map
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/** Quality tiers from lowest to highest, as World3D names them. */
|
|
2
|
+
export declare const QUALITY_TIERS: readonly ["low", "medium", "high"];
|
|
3
|
+
export type QualityTier = (typeof QUALITY_TIERS)[number];
|
|
4
|
+
/**
|
|
5
|
+
* Of several variants of one asset, the one for `quality`: an exact tier, or else the nearest below, or else the
|
|
6
|
+
* nearest above. `variants` maps tiers to anything: a URL, a bundle entry name, a loaded model.
|
|
7
|
+
*/
|
|
8
|
+
export declare function pickQualityVariant<T>(variants: Partial<Record<QualityTier, T>>, quality: QualityTier): T;
|
|
9
|
+
/**
|
|
10
|
+
* Names of the form `<base>-<tier>.<ext>` grouped by base and chosen for `quality`, as a bundle or a folder lists
|
|
11
|
+
* them: `hero-high.glb`, `hero-low.glb` and `hall.webp` give `hero-low.glb` (for `medium`) and `hall.webp`.
|
|
12
|
+
*/
|
|
13
|
+
export declare function pickQualityFiles(names: readonly string[], quality: QualityTier): string[];
|
|
14
|
+
/** What a headless run needs of a game: its state and one step of its rules. */
|
|
15
|
+
export interface HeadlessGame<Input> {
|
|
16
|
+
/** One step of `seconds` with the stand-in player's input. */
|
|
17
|
+
update(seconds: number, input: Input): void;
|
|
18
|
+
}
|
|
19
|
+
export interface HeadlessRunOptions<G extends HeadlessGame<Input>, Input> {
|
|
20
|
+
/** A new game for a seed. */
|
|
21
|
+
readonly createGame: (seed: number) => G;
|
|
22
|
+
/** The stand-in player for that game: given the game and a step, it returns the input. */
|
|
23
|
+
readonly createPlayer: (game: G, seed: number) => (seconds: number) => Input;
|
|
24
|
+
/** True when the run is over, as when the game is won or lost. */
|
|
25
|
+
readonly done: (game: G) => boolean;
|
|
26
|
+
/** The seeds to play: a count from 1, or a list. Defaults to 1. */
|
|
27
|
+
readonly seeds?: number | readonly number[];
|
|
28
|
+
/** Seconds a step. Defaults to 1/60. */
|
|
29
|
+
readonly step?: number;
|
|
30
|
+
/** Game seconds after which a run is stopped as unfinished. Defaults to 1200. */
|
|
31
|
+
readonly maxSeconds?: number;
|
|
32
|
+
/** What to record of a finished game, such as its outcome and score. */
|
|
33
|
+
readonly summary?: (game: G) => Record<string, unknown>;
|
|
34
|
+
/** Milliseconds now; `performance.now()` by default. */
|
|
35
|
+
readonly now?: () => number;
|
|
36
|
+
}
|
|
37
|
+
export interface HeadlessRunResult {
|
|
38
|
+
readonly seed: number;
|
|
39
|
+
/** False when the run reached `maxSeconds` without `done`. */
|
|
40
|
+
readonly finished: boolean;
|
|
41
|
+
readonly seconds: number;
|
|
42
|
+
readonly steps: number;
|
|
43
|
+
/** Milliseconds per step: the average and the slowest. */
|
|
44
|
+
readonly averageMs: number;
|
|
45
|
+
readonly slowestMs: number;
|
|
46
|
+
readonly summary: Record<string, unknown>;
|
|
47
|
+
}
|
|
48
|
+
/** Plays the game once per seed with the stand-in player and reports each run. */
|
|
49
|
+
export declare function runHeadless<G extends HeadlessGame<Input>, Input>(options: HeadlessRunOptions<G, Input>): HeadlessRunResult[];
|
|
50
|
+
//# sourceMappingURL=gameRun.d.ts.map
|
package/dist/gameRun.js
ADDED
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Two parts most games wrote for themselves.
|
|
3
|
+
//
|
|
4
|
+
// Quality variants: the same model or picture at several levels of detail, and
|
|
5
|
+
// the one to load for the picture quality a player chose. A tier that is not
|
|
6
|
+
// there gives the nearest one below it, then above it.
|
|
7
|
+
//
|
|
8
|
+
// Headless runs: the game's rules played to the end without a page, by a
|
|
9
|
+
// stand-in player, once per seed, with how long each step took. Rules kept
|
|
10
|
+
// apart from the picture can then be tested whole and balanced from a script.
|
|
11
|
+
import { EgretError } from '@egret/runtime';
|
|
12
|
+
/** Quality tiers from lowest to highest, as World3D names them. */
|
|
13
|
+
export const QUALITY_TIERS = Object.freeze(['low', 'medium', 'high']);
|
|
14
|
+
/**
|
|
15
|
+
* Of several variants of one asset, the one for `quality`: an exact tier, or else the nearest below, or else the
|
|
16
|
+
* nearest above. `variants` maps tiers to anything: a URL, a bundle entry name, a loaded model.
|
|
17
|
+
*/
|
|
18
|
+
export function pickQualityVariant(variants, quality) {
|
|
19
|
+
if (typeof variants !== 'object' || variants === null)
|
|
20
|
+
throw new EgretError('QUALITY_VARIANT_INVALID');
|
|
21
|
+
const at = QUALITY_TIERS.indexOf(quality);
|
|
22
|
+
if (at < 0)
|
|
23
|
+
throw new EgretError('QUALITY_VARIANT_INVALID', { cause: new TypeError(String(quality)) });
|
|
24
|
+
for (let i = at; i >= 0; i--)
|
|
25
|
+
if (variants[QUALITY_TIERS[i]] !== undefined)
|
|
26
|
+
return variants[QUALITY_TIERS[i]];
|
|
27
|
+
for (let i = at + 1; i < QUALITY_TIERS.length; i++)
|
|
28
|
+
if (variants[QUALITY_TIERS[i]] !== undefined)
|
|
29
|
+
return variants[QUALITY_TIERS[i]];
|
|
30
|
+
throw new EgretError('QUALITY_VARIANT_MISSING');
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Names of the form `<base>-<tier>.<ext>` grouped by base and chosen for `quality`, as a bundle or a folder lists
|
|
34
|
+
* them: `hero-high.glb`, `hero-low.glb` and `hall.webp` give `hero-low.glb` (for `medium`) and `hall.webp`.
|
|
35
|
+
*/
|
|
36
|
+
export function pickQualityFiles(names, quality) {
|
|
37
|
+
if (!Array.isArray(names))
|
|
38
|
+
throw new EgretError('QUALITY_VARIANT_INVALID');
|
|
39
|
+
const groups = new Map();
|
|
40
|
+
for (const name of names) {
|
|
41
|
+
if (typeof name !== 'string')
|
|
42
|
+
throw new EgretError('QUALITY_VARIANT_INVALID');
|
|
43
|
+
const match = /^(.*)-(low|medium|high)(\.[^./]+)?$/.exec(name);
|
|
44
|
+
if (!match) {
|
|
45
|
+
groups.set(name, name);
|
|
46
|
+
continue;
|
|
47
|
+
}
|
|
48
|
+
const key = match[1] + (match[3] ?? '');
|
|
49
|
+
const group = groups.get(key);
|
|
50
|
+
const variants = typeof group === 'object' ? group : {};
|
|
51
|
+
variants[match[2]] = name;
|
|
52
|
+
groups.set(key, variants);
|
|
53
|
+
}
|
|
54
|
+
return [...groups.values()].map(group => (typeof group === 'string' ? group : pickQualityVariant(group, quality)));
|
|
55
|
+
}
|
|
56
|
+
/** Plays the game once per seed with the stand-in player and reports each run. */
|
|
57
|
+
export function runHeadless(options) {
|
|
58
|
+
if (!options ||
|
|
59
|
+
typeof options.createGame !== 'function' ||
|
|
60
|
+
typeof options.createPlayer !== 'function' ||
|
|
61
|
+
typeof options.done !== 'function')
|
|
62
|
+
throw new EgretError('HEADLESS_RUN_INVALID');
|
|
63
|
+
const step = options.step ?? 1 / 60, maxSeconds = options.maxSeconds ?? 1200;
|
|
64
|
+
if (!(step > 0 && step <= 1) || !(maxSeconds > 0) || !Number.isFinite(maxSeconds))
|
|
65
|
+
throw new EgretError('HEADLESS_RUN_INVALID');
|
|
66
|
+
const seeds = typeof options.seeds === 'number'
|
|
67
|
+
? Array.from({ length: options.seeds }, (_, i) => i + 1)
|
|
68
|
+
: [...(options.seeds ?? [1])];
|
|
69
|
+
if (seeds.length === 0 || !seeds.every(seed => Number.isFinite(seed)))
|
|
70
|
+
throw new EgretError('HEADLESS_RUN_INVALID');
|
|
71
|
+
const clock = globalThis.performance;
|
|
72
|
+
const now = options.now ?? (() => (clock ? clock.now() : Date.now()));
|
|
73
|
+
const maxSteps = Math.ceil(maxSeconds / step);
|
|
74
|
+
return seeds.map(seed => {
|
|
75
|
+
const game = options.createGame(seed);
|
|
76
|
+
const player = options.createPlayer(game, seed);
|
|
77
|
+
let steps = 0, total = 0, slowest = 0;
|
|
78
|
+
while (!options.done(game) && steps < maxSteps) {
|
|
79
|
+
const before = now();
|
|
80
|
+
game.update(step, player(step));
|
|
81
|
+
const took = now() - before;
|
|
82
|
+
total += took;
|
|
83
|
+
slowest = Math.max(slowest, took);
|
|
84
|
+
steps++;
|
|
85
|
+
}
|
|
86
|
+
return Object.freeze({
|
|
87
|
+
seed,
|
|
88
|
+
finished: options.done(game),
|
|
89
|
+
seconds: steps * step,
|
|
90
|
+
steps,
|
|
91
|
+
averageMs: steps ? total / steps : 0,
|
|
92
|
+
slowestMs: slowest,
|
|
93
|
+
summary: options.summary ? options.summary(game) : {}
|
|
94
|
+
});
|
|
95
|
+
});
|
|
96
|
+
}
|
|
97
|
+
//# sourceMappingURL=gameRun.js.map
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
/** Optional gamepad input, free of the DOM; importing it reads no device and starts no work. */
|
|
2
|
+
export { createGamepadInput } from './gamepadInput.js';
|
|
3
|
+
export { bindGamepadKeys } from './gamepadKeys.js';
|
|
4
|
+
export type { GamepadButtonChange, GamepadButtonName, GamepadButtonSample, GamepadConnectionChange, GamepadInput, GamepadInputOptions, GamepadKeyAction, GamepadKeys, GamepadKeysOptions, GamepadKeyTarget, GamepadPad, GamepadSample, GamepadStick, GamepadStickName } from './gamepadTypes.js';
|
|
5
|
+
//# sourceMappingURL=gamepad.d.ts.map
|
package/dist/gamepad.js
ADDED
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
/** Optional gamepad input, free of the DOM; importing it reads no device and starts no work. */
|
|
3
|
+
export { createGamepadInput } from './gamepadInput.js';
|
|
4
|
+
export { bindGamepadKeys } from './gamepadKeys.js';
|
|
5
|
+
//# sourceMappingURL=gamepad.js.map
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { GamepadInput, GamepadInputOptions } from './gamepadTypes.js';
|
|
2
|
+
/** Pads as a stream of samples a host gives it: what is held, how far a stick is pushed, and what changed since the last look. */
|
|
3
|
+
export declare function createGamepadInput(options?: GamepadInputOptions): GamepadInput;
|
|
4
|
+
//# sourceMappingURL=gamepadInput.d.ts.map
|