@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,618 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import { EgretError, SequencePlayer } from '@egret/runtime';
|
|
3
|
+
import { requireSequenceControllerEngine } from '../internal/sequenceControllerFactoryState.js';
|
|
4
|
+
import { assertNotCapturing, captureInput, coordinatorSize, deliver, mustQueue, requireCoordinator } from './sequenceCoordinator.js';
|
|
5
|
+
import { admitRate, captureOptions, captureSeek } from './sequenceInput.js';
|
|
6
|
+
import { locatePosition, planEvents } from './sequenceMath.js';
|
|
7
|
+
const apply = Reflect.apply;
|
|
8
|
+
const playerApply = SequencePlayer.prototype.applyAt;
|
|
9
|
+
const playerDispose = SequencePlayer.prototype.dispose;
|
|
10
|
+
const playerConstructor = SequencePlayer;
|
|
11
|
+
const EMPTY_MARKERS = Object.freeze([]);
|
|
12
|
+
function terminal(state) {
|
|
13
|
+
return state === 'completed' || state === 'stopped' || state === 'faulted';
|
|
14
|
+
}
|
|
15
|
+
function codeOf(cause, fallback) {
|
|
16
|
+
return cause instanceof EgretError ? cause.code : fallback;
|
|
17
|
+
}
|
|
18
|
+
function remember(record, issue) {
|
|
19
|
+
record.lastIssue = Object.freeze({ code: issue.code, clockTickId: issue.clockTickId });
|
|
20
|
+
}
|
|
21
|
+
function originalDispose() {
|
|
22
|
+
apply(playerDispose, this, []);
|
|
23
|
+
}
|
|
24
|
+
/** Revoke first; every acquired borrow is then attempted independently. */
|
|
25
|
+
function retire(record, state, keepDelivery = false) {
|
|
26
|
+
if (!keepDelivery && record.delivery !== undefined)
|
|
27
|
+
record.delivery.active = false;
|
|
28
|
+
if (terminal(record.state) && record.port === undefined)
|
|
29
|
+
return undefined;
|
|
30
|
+
record.state = state;
|
|
31
|
+
const port = record.port, scope = record.scope, coordinator = record.coordinator;
|
|
32
|
+
const driver = record.driver, player = record.player, target = record.target, abort = record.abort;
|
|
33
|
+
const claimed = record.claimed;
|
|
34
|
+
record.port = undefined;
|
|
35
|
+
record.scope = undefined;
|
|
36
|
+
record.coordinator = undefined;
|
|
37
|
+
record.driver = undefined;
|
|
38
|
+
record.player = undefined;
|
|
39
|
+
record.clip = undefined;
|
|
40
|
+
record.target = undefined;
|
|
41
|
+
record.abort = undefined;
|
|
42
|
+
record.claimed = false;
|
|
43
|
+
record.listener = undefined;
|
|
44
|
+
record.markers = EMPTY_MARKERS;
|
|
45
|
+
record.pending = [];
|
|
46
|
+
let first;
|
|
47
|
+
for (const cleanup of [
|
|
48
|
+
() => {
|
|
49
|
+
if (abort !== undefined)
|
|
50
|
+
scope?.remove(abort);
|
|
51
|
+
},
|
|
52
|
+
() => {
|
|
53
|
+
if (claimed && target !== undefined)
|
|
54
|
+
port?.claims.release(target, record.claimToken);
|
|
55
|
+
},
|
|
56
|
+
() => {
|
|
57
|
+
if (driver !== undefined)
|
|
58
|
+
coordinator?.remove(driver);
|
|
59
|
+
},
|
|
60
|
+
() => {
|
|
61
|
+
if (player !== undefined)
|
|
62
|
+
apply(playerDispose, player, []);
|
|
63
|
+
}
|
|
64
|
+
]) {
|
|
65
|
+
try {
|
|
66
|
+
cleanup();
|
|
67
|
+
}
|
|
68
|
+
catch (cause) {
|
|
69
|
+
first ??= { code: 'ANIMATION_CLEANUP_FAILED', clockTickId: port?.clock.tickId ?? 0, cause };
|
|
70
|
+
try {
|
|
71
|
+
port?.captureCleanup(cause);
|
|
72
|
+
}
|
|
73
|
+
catch {
|
|
74
|
+
/* Preserve the primary transition outcome. */
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
if (first !== undefined)
|
|
79
|
+
remember(record, first);
|
|
80
|
+
return first;
|
|
81
|
+
}
|
|
82
|
+
function assertControl(record) {
|
|
83
|
+
const port = record.port;
|
|
84
|
+
if (port === undefined || terminal(record.state))
|
|
85
|
+
throw new EgretError('ANIMATION_TERMINAL');
|
|
86
|
+
assertNotCapturing(port);
|
|
87
|
+
port.assertOpen();
|
|
88
|
+
record.scope.assertOpen();
|
|
89
|
+
if (record.busy)
|
|
90
|
+
throw new EgretError('ANIMATION_REENTRANT');
|
|
91
|
+
return port;
|
|
92
|
+
}
|
|
93
|
+
function snapshot(record) {
|
|
94
|
+
return Object.freeze({
|
|
95
|
+
state: record.state,
|
|
96
|
+
isDisposed: terminal(record.state),
|
|
97
|
+
elapsedSeconds: record.elapsed,
|
|
98
|
+
positionSeconds: record.position,
|
|
99
|
+
playIndex: record.play,
|
|
100
|
+
rate: record.rate,
|
|
101
|
+
totalPlays: record.totalPlays,
|
|
102
|
+
lastSample: record.lastSample,
|
|
103
|
+
pendingCommands: record.pending.length,
|
|
104
|
+
committedEventCount: record.eventCount,
|
|
105
|
+
lastIssue: record.lastIssue
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
function begin(record) {
|
|
109
|
+
return {
|
|
110
|
+
state: record.state,
|
|
111
|
+
elapsed: record.elapsed,
|
|
112
|
+
position: record.position,
|
|
113
|
+
play: record.play,
|
|
114
|
+
rate: record.rate,
|
|
115
|
+
baseline: record.baseline,
|
|
116
|
+
applyTarget: false,
|
|
117
|
+
consumed: 0,
|
|
118
|
+
terminalCommand: false,
|
|
119
|
+
events: []
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
function appendEvents(record, candidate, to, source, includeStart = false, includeComplete = true) {
|
|
123
|
+
const events = planEvents(record.duration, record.totalPlays, record.markers, candidate.elapsed, to, { includeStart, includeComplete }, 1024 - candidate.events.length);
|
|
124
|
+
if (!Number.isSafeInteger(record.eventCount + candidate.events.length + events.length))
|
|
125
|
+
throw new EgretError('ANIMATION_EVENT_SEQUENCE_LIMIT');
|
|
126
|
+
for (const event of events)
|
|
127
|
+
candidate.events.push({ event, source });
|
|
128
|
+
}
|
|
129
|
+
function move(record, candidate, to, source, replay) {
|
|
130
|
+
const position = locatePosition(record.duration, record.totalPlays, to);
|
|
131
|
+
if (replay)
|
|
132
|
+
appendEvents(record, candidate, to, source);
|
|
133
|
+
candidate.elapsed = to;
|
|
134
|
+
candidate.position = position.positionSeconds;
|
|
135
|
+
candidate.play = position.playIndex;
|
|
136
|
+
candidate.applyTarget = true;
|
|
137
|
+
if (position.complete)
|
|
138
|
+
candidate.state = 'completed';
|
|
139
|
+
}
|
|
140
|
+
function settle(record, candidate, now, source) {
|
|
141
|
+
if (now < candidate.baseline)
|
|
142
|
+
throw new EgretError('ANIMATION_TIME_LIMIT');
|
|
143
|
+
const delta = now - candidate.baseline;
|
|
144
|
+
candidate.baseline = now;
|
|
145
|
+
if (candidate.state !== 'running' || delta === 0)
|
|
146
|
+
return;
|
|
147
|
+
const distance = delta * candidate.rate;
|
|
148
|
+
if (!Number.isFinite(distance))
|
|
149
|
+
throw new EgretError('ANIMATION_TIME_LIMIT');
|
|
150
|
+
if (distance === 0 && candidate.rate > 0)
|
|
151
|
+
throw new EgretError('ANIMATION_PRECISION_LIMIT');
|
|
152
|
+
const end = record.totalPlays === 'infinite' ? undefined : record.duration * record.totalPlays;
|
|
153
|
+
const final = end !== undefined && distance >= end - candidate.elapsed;
|
|
154
|
+
const next = final ? end : candidate.elapsed + distance;
|
|
155
|
+
if (!final && distance > 0 && next <= candidate.elapsed)
|
|
156
|
+
throw new EgretError('ANIMATION_PRECISION_LIMIT');
|
|
157
|
+
move(record, candidate, next, source, true);
|
|
158
|
+
}
|
|
159
|
+
function commandCandidate(record, candidate, command, now) {
|
|
160
|
+
if (terminal(candidate.state))
|
|
161
|
+
throw new EgretError('ANIMATION_TERMINAL');
|
|
162
|
+
switch (command.kind) {
|
|
163
|
+
case 'start':
|
|
164
|
+
if (candidate.state !== 'idle')
|
|
165
|
+
throw new EgretError('ANIMATION_ALREADY_STARTED');
|
|
166
|
+
appendEvents(record, candidate, 0, 'start', true, false);
|
|
167
|
+
candidate.elapsed = 0;
|
|
168
|
+
candidate.position = 0;
|
|
169
|
+
candidate.play = 0;
|
|
170
|
+
candidate.baseline = now;
|
|
171
|
+
candidate.state = candidate.rate === 0 ? 'paused' : 'running';
|
|
172
|
+
candidate.applyTarget = true;
|
|
173
|
+
return;
|
|
174
|
+
case 'pause':
|
|
175
|
+
if (candidate.state === 'idle')
|
|
176
|
+
throw new EgretError('ANIMATION_NOT_STARTED');
|
|
177
|
+
candidate.state = 'paused';
|
|
178
|
+
candidate.baseline = now;
|
|
179
|
+
return;
|
|
180
|
+
case 'resume':
|
|
181
|
+
if (candidate.state === 'idle')
|
|
182
|
+
throw new EgretError('ANIMATION_NOT_STARTED');
|
|
183
|
+
if (candidate.state === 'running')
|
|
184
|
+
return;
|
|
185
|
+
if (candidate.rate === 0)
|
|
186
|
+
throw new EgretError('ANIMATION_RATE_ZERO');
|
|
187
|
+
candidate.state = 'running';
|
|
188
|
+
candidate.baseline = now;
|
|
189
|
+
return;
|
|
190
|
+
case 'rate':
|
|
191
|
+
candidate.rate = command.rate;
|
|
192
|
+
if (candidate.state === 'running' && command.rate === 0)
|
|
193
|
+
candidate.state = 'paused';
|
|
194
|
+
candidate.baseline = now;
|
|
195
|
+
return;
|
|
196
|
+
case 'seek':
|
|
197
|
+
if (candidate.state === 'idle')
|
|
198
|
+
throw new EgretError('ANIMATION_NOT_STARTED');
|
|
199
|
+
if (command.replay && command.time < candidate.elapsed)
|
|
200
|
+
throw new EgretError('ANIMATION_SEEK_BACKWARDS');
|
|
201
|
+
move(record, candidate, command.time, 'seek', command.replay);
|
|
202
|
+
candidate.baseline = now;
|
|
203
|
+
return;
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
function observeRejected(result) {
|
|
207
|
+
const ignore = () => { };
|
|
208
|
+
try {
|
|
209
|
+
void apply(Promise.prototype.then, result, [undefined, ignore]);
|
|
210
|
+
}
|
|
211
|
+
catch {
|
|
212
|
+
try {
|
|
213
|
+
void Promise.resolve(result).then(undefined, ignore);
|
|
214
|
+
}
|
|
215
|
+
catch {
|
|
216
|
+
/* Return observation cannot replace the committed callback outcome. */
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
/** Event delivery owns a short-lived borrow independent of the retired controller. */
|
|
221
|
+
function makeDelivery(record, port, scope, listener, events, token, initialIssue) {
|
|
222
|
+
let issue = initialIssue;
|
|
223
|
+
return {
|
|
224
|
+
events() {
|
|
225
|
+
if (listener === undefined)
|
|
226
|
+
return;
|
|
227
|
+
for (const event of events) {
|
|
228
|
+
if (!token.active)
|
|
229
|
+
break;
|
|
230
|
+
try {
|
|
231
|
+
port.assertOpen();
|
|
232
|
+
scope.assertOpen();
|
|
233
|
+
}
|
|
234
|
+
catch {
|
|
235
|
+
token.active = false;
|
|
236
|
+
break;
|
|
237
|
+
}
|
|
238
|
+
try {
|
|
239
|
+
const result = listener(event);
|
|
240
|
+
if (result !== undefined) {
|
|
241
|
+
observeRejected(result);
|
|
242
|
+
issue ??= { code: 'ANIMATION_CALLBACK_RETURN_INVALID', clockTickId: event.clockTickId };
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
catch (cause) {
|
|
246
|
+
issue ??= { code: 'ANIMATION_CALLBACK_FAILED', clockTickId: event.clockTickId, cause };
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
},
|
|
250
|
+
diagnostics() {
|
|
251
|
+
try {
|
|
252
|
+
if (issue === undefined)
|
|
253
|
+
return;
|
|
254
|
+
remember(record, issue);
|
|
255
|
+
// A prior observer can close another controller's lifetime. Keep inert
|
|
256
|
+
// failure evidence, but deliver ordinary profile callbacks only while live.
|
|
257
|
+
// Cleanup failures remain reportable during authoritative teardown.
|
|
258
|
+
if (issue.code !== 'ANIMATION_CLEANUP_FAILED') {
|
|
259
|
+
try {
|
|
260
|
+
port.assertOpen();
|
|
261
|
+
scope.assertOpen();
|
|
262
|
+
}
|
|
263
|
+
catch {
|
|
264
|
+
return;
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
port.report({ code: issue.code, phase: 'engine', severity: 'error', cause: issue.cause });
|
|
268
|
+
}
|
|
269
|
+
finally {
|
|
270
|
+
if (record.delivery === token)
|
|
271
|
+
record.delivery = undefined;
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
};
|
|
275
|
+
}
|
|
276
|
+
function refusal(record, port, scope, cause, tick, code) {
|
|
277
|
+
const issue = { code: code ?? codeOf(cause, 'ANIMATION_COMMAND_INVALID'), clockTickId: tick, cause };
|
|
278
|
+
remember(record, issue);
|
|
279
|
+
return makeDelivery(record, port, scope, undefined, [], { active: false }, issue);
|
|
280
|
+
}
|
|
281
|
+
function bindingError(cause) {
|
|
282
|
+
return (cause instanceof EgretError &&
|
|
283
|
+
[
|
|
284
|
+
'SEQ_BINDING_CHANGED',
|
|
285
|
+
'OBJECT_DISPOSED',
|
|
286
|
+
'LEASE_RELEASED',
|
|
287
|
+
'TEXTURE_DISPOSED',
|
|
288
|
+
'ASSET_LEASE_RELEASED',
|
|
289
|
+
'ASSET_DISPOSED',
|
|
290
|
+
'BITMAP_TEXTURE_REQUIRED'
|
|
291
|
+
].includes(cause.code));
|
|
292
|
+
}
|
|
293
|
+
/** Pure preparation precedes one original player apply and callback-free publication. */
|
|
294
|
+
function commit(record, candidate, tick, replaced) {
|
|
295
|
+
const port = record.port, scope = record.scope, listener = record.listener;
|
|
296
|
+
scope.assertOpen();
|
|
297
|
+
let sample = record.lastSample;
|
|
298
|
+
if (candidate.applyTarget) {
|
|
299
|
+
try {
|
|
300
|
+
sample = apply(playerApply, record.player, [candidate.position]);
|
|
301
|
+
}
|
|
302
|
+
catch (cause) {
|
|
303
|
+
const code = bindingError(cause) ? 'ANIMATION_BINDING_INVALID' : 'ANIMATION_APPLY_FAILED';
|
|
304
|
+
const issue = { code, clockTickId: tick, cause };
|
|
305
|
+
retire(record, 'faulted');
|
|
306
|
+
remember(record, issue);
|
|
307
|
+
throw new EgretError(code, { cause });
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
scope.assertOpen();
|
|
311
|
+
const events = candidate.events.map(({ event, source }, index) => Object.freeze({ ...event, source, clockTickId: tick, sequence: record.eventCount + index + 1 }));
|
|
312
|
+
const token = { active: true };
|
|
313
|
+
record.elapsed = candidate.elapsed;
|
|
314
|
+
record.position = candidate.position;
|
|
315
|
+
record.play = candidate.play;
|
|
316
|
+
record.rate = candidate.rate;
|
|
317
|
+
record.baseline = candidate.baseline;
|
|
318
|
+
record.state = candidate.state;
|
|
319
|
+
record.lastSample = sample;
|
|
320
|
+
record.eventCount += events.length;
|
|
321
|
+
if (replaced)
|
|
322
|
+
record.pending = [];
|
|
323
|
+
else
|
|
324
|
+
record.pending.splice(0, candidate.consumed);
|
|
325
|
+
record.delivery = token;
|
|
326
|
+
let issue;
|
|
327
|
+
if (candidate.terminalCommand)
|
|
328
|
+
issue = { code: 'ANIMATION_TERMINAL_COMMAND', clockTickId: tick };
|
|
329
|
+
else if (replaced)
|
|
330
|
+
issue = { code: 'ANIMATION_COMMANDS_REPLACED', clockTickId: tick };
|
|
331
|
+
if (candidate.state === 'completed') {
|
|
332
|
+
const cleanupIssue = retire(record, 'completed', true);
|
|
333
|
+
issue ??= cleanupIssue;
|
|
334
|
+
}
|
|
335
|
+
return makeDelivery(record, port, scope, listener, events, token, issue);
|
|
336
|
+
}
|
|
337
|
+
function advance(record, tick) {
|
|
338
|
+
if (record.port === undefined || terminal(record.state))
|
|
339
|
+
return undefined;
|
|
340
|
+
const port = record.port, scope = record.scope;
|
|
341
|
+
record.busy = true;
|
|
342
|
+
try {
|
|
343
|
+
scope.assertOpen();
|
|
344
|
+
const candidate = begin(record);
|
|
345
|
+
settle(record, candidate, tick.elapsedSeconds, 'clock');
|
|
346
|
+
if (candidate.state === 'completed')
|
|
347
|
+
candidate.terminalCommand = record.pending.length > 0;
|
|
348
|
+
else {
|
|
349
|
+
for (const pending of record.pending) {
|
|
350
|
+
if (pending.tick > tick.tickId)
|
|
351
|
+
break;
|
|
352
|
+
try {
|
|
353
|
+
commandCandidate(record, candidate, pending.command, tick.elapsedSeconds);
|
|
354
|
+
}
|
|
355
|
+
catch (cause) {
|
|
356
|
+
throw new EgretError('ANIMATION_COMMAND_INVALID', { cause });
|
|
357
|
+
}
|
|
358
|
+
candidate.consumed++;
|
|
359
|
+
if (terminal(candidate.state)) {
|
|
360
|
+
candidate.terminalCommand = record.pending.length > candidate.consumed;
|
|
361
|
+
break;
|
|
362
|
+
}
|
|
363
|
+
}
|
|
364
|
+
}
|
|
365
|
+
return commit(record, candidate, tick.tickId, false);
|
|
366
|
+
}
|
|
367
|
+
catch (cause) {
|
|
368
|
+
if (codeOf(cause, '') === 'SCOPE_CLOSED' || codeOf(cause, '') === 'ENGINE_CLOSED') {
|
|
369
|
+
retire(record, 'stopped');
|
|
370
|
+
return undefined;
|
|
371
|
+
}
|
|
372
|
+
return refusal(record, port, scope, cause, tick.tickId);
|
|
373
|
+
}
|
|
374
|
+
finally {
|
|
375
|
+
record.busy = false;
|
|
376
|
+
}
|
|
377
|
+
}
|
|
378
|
+
function execute(record, command, revision) {
|
|
379
|
+
const port = assertControl(record), scope = record.scope;
|
|
380
|
+
record.revision = revision ?? {};
|
|
381
|
+
const tick = port.clock.tickId;
|
|
382
|
+
if (mustQueue(port)) {
|
|
383
|
+
if (record.pending.length >= 16)
|
|
384
|
+
throw new EgretError('ANIMATION_COMMAND_LIMIT');
|
|
385
|
+
if (!Number.isSafeInteger(tick + 1))
|
|
386
|
+
throw new EgretError('ANIMATION_TIME_LIMIT');
|
|
387
|
+
record.pending.push(Object.freeze({ tick: tick + 1, command }));
|
|
388
|
+
return;
|
|
389
|
+
}
|
|
390
|
+
const replace = command.kind === 'seek' && !command.replay;
|
|
391
|
+
if (record.pending.length !== 0 && !replace)
|
|
392
|
+
throw new EgretError('ANIMATION_COMMANDS_PENDING');
|
|
393
|
+
const replaced = replace && record.pending.length !== 0;
|
|
394
|
+
record.busy = true;
|
|
395
|
+
let batch;
|
|
396
|
+
try {
|
|
397
|
+
const candidate = begin(record), now = port.clock.elapsedSeconds;
|
|
398
|
+
if (command.kind === 'pause' || command.kind === 'rate')
|
|
399
|
+
settle(record, candidate, now, 'control');
|
|
400
|
+
if (candidate.state === 'completed')
|
|
401
|
+
candidate.terminalCommand = true;
|
|
402
|
+
else
|
|
403
|
+
commandCandidate(record, candidate, command, now);
|
|
404
|
+
batch = commit(record, candidate, tick, replaced);
|
|
405
|
+
}
|
|
406
|
+
catch (cause) {
|
|
407
|
+
batch = refusal(record, port, scope, cause, tick);
|
|
408
|
+
record.busy = false;
|
|
409
|
+
deliver(port, batch);
|
|
410
|
+
throw cause;
|
|
411
|
+
}
|
|
412
|
+
finally {
|
|
413
|
+
record.busy = false;
|
|
414
|
+
}
|
|
415
|
+
deliver(port, batch);
|
|
416
|
+
}
|
|
417
|
+
function stop(record, ownedCancellation = false) {
|
|
418
|
+
const port = record.port, scope = record.scope;
|
|
419
|
+
if (port !== undefined && !ownedCancellation)
|
|
420
|
+
assertNotCapturing(port);
|
|
421
|
+
// A refused reentrant command cannot invalidate an otherwise prepared RESET.
|
|
422
|
+
record.revision = {};
|
|
423
|
+
const issue = retire(record, terminal(record.state) ? record.state : 'stopped');
|
|
424
|
+
if (issue !== undefined && port !== undefined && scope !== undefined)
|
|
425
|
+
deliver(port, makeDelivery(record, port, scope, undefined, [], { active: false }, issue));
|
|
426
|
+
}
|
|
427
|
+
function handleFor(record) {
|
|
428
|
+
function receiver(value) {
|
|
429
|
+
if (value !== handle)
|
|
430
|
+
throw new EgretError('ANIMATION_CONTROLLER_INVALID');
|
|
431
|
+
}
|
|
432
|
+
const handle = Object.freeze({
|
|
433
|
+
profile: 'egret.sequence-control/1',
|
|
434
|
+
start() {
|
|
435
|
+
receiver(this);
|
|
436
|
+
execute(record, Object.freeze({ kind: 'start' }));
|
|
437
|
+
},
|
|
438
|
+
pause() {
|
|
439
|
+
receiver(this);
|
|
440
|
+
execute(record, Object.freeze({ kind: 'pause' }));
|
|
441
|
+
},
|
|
442
|
+
resume() {
|
|
443
|
+
receiver(this);
|
|
444
|
+
execute(record, Object.freeze({ kind: 'resume' }));
|
|
445
|
+
},
|
|
446
|
+
setRate(rate) {
|
|
447
|
+
receiver(this);
|
|
448
|
+
const port = assertControl(record);
|
|
449
|
+
execute(record, captureInput(port, () => Object.freeze({ kind: 'rate', rate: admitRate(rate) })));
|
|
450
|
+
},
|
|
451
|
+
seek(request) {
|
|
452
|
+
receiver(this);
|
|
453
|
+
const port = assertControl(record);
|
|
454
|
+
execute(record, captureInput(port, () => captureSeek(request)));
|
|
455
|
+
},
|
|
456
|
+
stop() {
|
|
457
|
+
receiver(this);
|
|
458
|
+
stop(record);
|
|
459
|
+
},
|
|
460
|
+
dispose() {
|
|
461
|
+
receiver(this);
|
|
462
|
+
stop(record);
|
|
463
|
+
},
|
|
464
|
+
getStatus() {
|
|
465
|
+
receiver(this);
|
|
466
|
+
return snapshot(record);
|
|
467
|
+
}
|
|
468
|
+
});
|
|
469
|
+
resetControllers.set(handle, record);
|
|
470
|
+
let targets = resetTargets.get(record.target);
|
|
471
|
+
if (!targets) {
|
|
472
|
+
targets = new WeakMap();
|
|
473
|
+
resetTargets.set(record.target, targets);
|
|
474
|
+
}
|
|
475
|
+
targets.set(handle, record.port);
|
|
476
|
+
return handle;
|
|
477
|
+
}
|
|
478
|
+
const resetControllers = new WeakMap();
|
|
479
|
+
// Neither a terminal handle nor this registry retains its former Bitmap borrow.
|
|
480
|
+
const resetTargets = new WeakMap();
|
|
481
|
+
function requireResetRecord(value, port, bitmap) {
|
|
482
|
+
const record = resetControllers.get(value);
|
|
483
|
+
if (!record || resetTargets.get(bitmap)?.get(value) !== port)
|
|
484
|
+
throw new EgretError('SEQUENCE_RESET_INITIAL_INVALID');
|
|
485
|
+
return record;
|
|
486
|
+
}
|
|
487
|
+
/** Optional assembly only: authenticate the exact Engine, original controller and Bitmap. */
|
|
488
|
+
export function requireResetController(value, port, bitmap) {
|
|
489
|
+
const record = requireResetRecord(value, port, bitmap);
|
|
490
|
+
return () => record.revision;
|
|
491
|
+
}
|
|
492
|
+
/** Reserve the replacement pause revision before synchronous event delivery can reenter the slot. */
|
|
493
|
+
export function pauseSequenceForReplacement(value, port, bitmap, revision) {
|
|
494
|
+
execute(requireResetRecord(value, port, bitmap), { kind: 'pause' }, revision);
|
|
495
|
+
}
|
|
496
|
+
function requirePreserveRecord(value, port, bitmap) {
|
|
497
|
+
const record = requireResetRecord(value, port, bitmap);
|
|
498
|
+
if ((record.state !== 'running' && record.state !== 'paused') || record.pending.length !== 0) {
|
|
499
|
+
throw new EgretError('SEQUENCE_RESET_PRESERVE_STATE');
|
|
500
|
+
}
|
|
501
|
+
assertControl(record);
|
|
502
|
+
return record;
|
|
503
|
+
}
|
|
504
|
+
export function requireSequencePreserveSource(value, port, bitmap) {
|
|
505
|
+
const record = requirePreserveRecord(value, port, bitmap);
|
|
506
|
+
return { clip: record.clip, totalPlays: record.totalPlays, markers: record.markers };
|
|
507
|
+
}
|
|
508
|
+
/** Stage an event-free successor at the paused source position. The slot has checked both timelines. */
|
|
509
|
+
export function stageSequencePreserve(port, from, fromBitmap, to, toBitmap, running) {
|
|
510
|
+
const source = requirePreserveRecord(from, port, fromBitmap), next = requireResetRecord(to, port, toBitmap);
|
|
511
|
+
assertControl(next);
|
|
512
|
+
if (source.state !== 'paused' || next.state !== 'idle' || source.totalPlays !== next.totalPlays) {
|
|
513
|
+
throw new EgretError('SEQUENCE_RESET_PRESERVE_STATE');
|
|
514
|
+
}
|
|
515
|
+
const candidate = begin(next);
|
|
516
|
+
candidate.elapsed = source.elapsed;
|
|
517
|
+
candidate.position = source.position;
|
|
518
|
+
candidate.play = source.play;
|
|
519
|
+
candidate.rate = source.rate;
|
|
520
|
+
candidate.state = 'paused';
|
|
521
|
+
candidate.applyTarget = true;
|
|
522
|
+
candidate.baseline = port.clock.elapsedSeconds;
|
|
523
|
+
commit(next, candidate, port.clock.tickId, false).diagnostics();
|
|
524
|
+
next.eventCount = source.eventCount;
|
|
525
|
+
next.listener = source.listener;
|
|
526
|
+
// The final window can span clock ticks. Rebase only when the subtree publishes.
|
|
527
|
+
return () => {
|
|
528
|
+
next.baseline = port.clock.elapsedSeconds;
|
|
529
|
+
next.state = running ? 'running' : 'paused';
|
|
530
|
+
};
|
|
531
|
+
}
|
|
532
|
+
/** Opt-in sequence controls share Engine ownership but never create a second timer. */
|
|
533
|
+
export function createSequenceController(engine, scope, bitmap, clip, options) {
|
|
534
|
+
const port = requireSequenceControllerEngine(engine);
|
|
535
|
+
const owned = port.scope(scope);
|
|
536
|
+
assertNotCapturing(port);
|
|
537
|
+
if (coordinatorSize(port) >= 256)
|
|
538
|
+
throw new EgretError('ANIMATION_CONTROLLER_LIMIT');
|
|
539
|
+
if (port.claims.size >= 256)
|
|
540
|
+
throw new EgretError('ANIMATION_LIMIT');
|
|
541
|
+
let player, coordinator, record;
|
|
542
|
+
try {
|
|
543
|
+
// Original constructor authenticates Bitmap/clip before reading clip dimensions.
|
|
544
|
+
player = new playerConstructor(bitmap, clip, 'once');
|
|
545
|
+
Object.defineProperty(player, 'dispose', { value: originalDispose, writable: false, configurable: false });
|
|
546
|
+
const admitted = captureInput(port, () => captureOptions(options, clip.durationSeconds));
|
|
547
|
+
owned.assertOpen();
|
|
548
|
+
if (port.claims.has(bitmap))
|
|
549
|
+
throw new EgretError('ANIMATION_TARGET_BUSY');
|
|
550
|
+
coordinator = requireCoordinator(port);
|
|
551
|
+
record = {
|
|
552
|
+
port,
|
|
553
|
+
scope: owned,
|
|
554
|
+
coordinator,
|
|
555
|
+
driver: undefined,
|
|
556
|
+
player,
|
|
557
|
+
clip,
|
|
558
|
+
target: bitmap,
|
|
559
|
+
claimed: false,
|
|
560
|
+
claimToken: {},
|
|
561
|
+
abort: undefined,
|
|
562
|
+
duration: clip.durationSeconds,
|
|
563
|
+
totalPlays: admitted.totalPlays,
|
|
564
|
+
markers: admitted.markers,
|
|
565
|
+
listener: admitted.listener,
|
|
566
|
+
state: 'idle',
|
|
567
|
+
elapsed: 0,
|
|
568
|
+
position: 0,
|
|
569
|
+
play: 0,
|
|
570
|
+
rate: admitted.rate,
|
|
571
|
+
baseline: port.clock.elapsedSeconds,
|
|
572
|
+
lastSample: undefined,
|
|
573
|
+
eventCount: 0,
|
|
574
|
+
lastIssue: undefined,
|
|
575
|
+
pending: [],
|
|
576
|
+
busy: false,
|
|
577
|
+
revision: {},
|
|
578
|
+
delivery: undefined
|
|
579
|
+
};
|
|
580
|
+
player = undefined;
|
|
581
|
+
const current = record;
|
|
582
|
+
const handle = handleFor(current);
|
|
583
|
+
const driver = {
|
|
584
|
+
advance: (tick) => advance(current, tick),
|
|
585
|
+
stop: () => stop(current, true)
|
|
586
|
+
};
|
|
587
|
+
current.driver = driver;
|
|
588
|
+
owned.use(current.player);
|
|
589
|
+
owned.use(handle);
|
|
590
|
+
current.abort = () => stop(current, true);
|
|
591
|
+
owned.add(current.abort);
|
|
592
|
+
owned.assertOpen();
|
|
593
|
+
port.claims.acquire(bitmap, current.claimToken);
|
|
594
|
+
current.claimed = true;
|
|
595
|
+
coordinator.add(driver);
|
|
596
|
+
return handle;
|
|
597
|
+
}
|
|
598
|
+
catch (cause) {
|
|
599
|
+
if (record !== undefined)
|
|
600
|
+
retire(record, 'stopped');
|
|
601
|
+
else if (player !== undefined) {
|
|
602
|
+
try {
|
|
603
|
+
apply(playerDispose, player, []);
|
|
604
|
+
}
|
|
605
|
+
catch (cleanupCause) {
|
|
606
|
+
port.captureCleanup(cleanupCause);
|
|
607
|
+
}
|
|
608
|
+
}
|
|
609
|
+
try {
|
|
610
|
+
coordinator?.discardIfEmpty();
|
|
611
|
+
}
|
|
612
|
+
catch (cleanupCause) {
|
|
613
|
+
port.captureCleanup(cleanupCause);
|
|
614
|
+
}
|
|
615
|
+
throw cause;
|
|
616
|
+
}
|
|
617
|
+
}
|
|
618
|
+
//# sourceMappingURL=sequenceController.js.map
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { GameClockTick } from '../gameClockTypes.js';
|
|
2
|
+
import type { SequenceControllerEnginePort } from '../internal/sequenceControllerFactoryState.js';
|
|
3
|
+
export interface SequenceDelivery {
|
|
4
|
+
events(): void;
|
|
5
|
+
diagnostics(): void;
|
|
6
|
+
}
|
|
7
|
+
export interface SequenceDriver {
|
|
8
|
+
advance(tick: GameClockTick): SequenceDelivery | undefined;
|
|
9
|
+
stop(): void;
|
|
10
|
+
}
|
|
11
|
+
export interface SequenceCoordinator {
|
|
12
|
+
readonly size: number;
|
|
13
|
+
add(driver: SequenceDriver): void;
|
|
14
|
+
remove(driver: SequenceDriver): void;
|
|
15
|
+
discardIfEmpty(): void;
|
|
16
|
+
}
|
|
17
|
+
/** User getters cannot masquerade as an ordinary callback command boundary. */
|
|
18
|
+
export declare function assertNotCapturing(port: SequenceControllerEnginePort): void;
|
|
19
|
+
export declare function captureInput<T>(port: SequenceControllerEnginePort, callback: () => T): T;
|
|
20
|
+
export declare function mustQueue(port: SequenceControllerEnginePort): boolean;
|
|
21
|
+
export declare function protectedDelivery<T>(port: SequenceControllerEnginePort, callback: () => T): T;
|
|
22
|
+
export declare function deliver(port: SequenceControllerEnginePort, delivery: SequenceDelivery | undefined): void;
|
|
23
|
+
export declare function coordinatorSize(port: SequenceControllerEnginePort): number;
|
|
24
|
+
/** One authentic subscription serves all live controllers, never the first caller's Scope. */
|
|
25
|
+
export declare function requireCoordinator(port: SequenceControllerEnginePort): SequenceCoordinator;
|
|
26
|
+
//# sourceMappingURL=sequenceCoordinator.d.ts.map
|