@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,477 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import { isAdmittedResourceManifest } from '@egret/contracts/resources';
|
|
3
|
+
import { CancellationController, EgretError, Scope } from '@egret/runtime';
|
|
4
|
+
import { requireManifestBinding } from './manifestResourceState.js';
|
|
5
|
+
const APPLY = Reflect.apply;
|
|
6
|
+
const FREEZE = Object.freeze;
|
|
7
|
+
const IS_ARRAY = Array.isArray;
|
|
8
|
+
const HAS_OWN = Object.prototype.hasOwnProperty;
|
|
9
|
+
const THEN = Promise.prototype.then;
|
|
10
|
+
const SCOPE_STATE = Object.getOwnPropertyDescriptor(Scope.prototype, 'state').get;
|
|
11
|
+
const SCOPE_USE = Scope.prototype.use;
|
|
12
|
+
const ABORT = CancellationController.prototype.abort;
|
|
13
|
+
const MAX_GROUP = 128;
|
|
14
|
+
const MAX_QUEUED = 128;
|
|
15
|
+
const MAX_ACTIVE = 4;
|
|
16
|
+
function assertLifetime(context, scope) {
|
|
17
|
+
context.assertOpen();
|
|
18
|
+
if (!context.isEngineScope(scope))
|
|
19
|
+
throw new EgretError('MANIFEST_GROUP_SCOPE_INVALID');
|
|
20
|
+
if (APPLY(SCOPE_STATE, scope, []) !== 'open')
|
|
21
|
+
throw new EgretError('SCOPE_CLOSED');
|
|
22
|
+
}
|
|
23
|
+
/** Caller access cannot hide Engine/Scope closure, including a thrown undefined. */
|
|
24
|
+
function callerRead(context, scope, code, read) {
|
|
25
|
+
let value;
|
|
26
|
+
let failed = false;
|
|
27
|
+
let cause;
|
|
28
|
+
try {
|
|
29
|
+
value = read();
|
|
30
|
+
}
|
|
31
|
+
catch (error) {
|
|
32
|
+
failed = true;
|
|
33
|
+
cause = error;
|
|
34
|
+
}
|
|
35
|
+
assertLifetime(context, scope);
|
|
36
|
+
if (failed)
|
|
37
|
+
throw new EgretError(code, { cause });
|
|
38
|
+
return value;
|
|
39
|
+
}
|
|
40
|
+
function snapshotArray(context, scope, input, code) {
|
|
41
|
+
if (!callerRead(context, scope, code, () => IS_ARRAY(input)))
|
|
42
|
+
throw new EgretError(code);
|
|
43
|
+
const source = input;
|
|
44
|
+
const length = callerRead(context, scope, code, () => source.length);
|
|
45
|
+
if (!Number.isInteger(length) || length < 0 || length > MAX_GROUP)
|
|
46
|
+
throw new EgretError(code);
|
|
47
|
+
const values = [];
|
|
48
|
+
for (let index = 0; index < length; index++) {
|
|
49
|
+
if (!callerRead(context, scope, code, () => APPLY(HAS_OWN, source, [index])))
|
|
50
|
+
throw new EgretError(code);
|
|
51
|
+
values.push(callerRead(context, scope, code, () => source[index]));
|
|
52
|
+
}
|
|
53
|
+
return FREEZE(values);
|
|
54
|
+
}
|
|
55
|
+
function admitPriority(context, scope, options) {
|
|
56
|
+
if (options === undefined)
|
|
57
|
+
return 'interactive';
|
|
58
|
+
if (typeof options !== 'object' ||
|
|
59
|
+
options === null ||
|
|
60
|
+
callerRead(context, scope, 'MANIFEST_GROUP_OPTIONS_INVALID', () => IS_ARRAY(options))) {
|
|
61
|
+
throw new EgretError('MANIFEST_GROUP_OPTIONS_INVALID');
|
|
62
|
+
}
|
|
63
|
+
const priority = callerRead(context, scope, 'MANIFEST_GROUP_OPTIONS_INVALID', () => options.priority);
|
|
64
|
+
if (priority === undefined)
|
|
65
|
+
return 'interactive';
|
|
66
|
+
if (priority !== 'interactive' && priority !== 'background')
|
|
67
|
+
throw new EgretError('MANIFEST_GROUP_OPTIONS_INVALID');
|
|
68
|
+
return priority;
|
|
69
|
+
}
|
|
70
|
+
/** Select already admitted graph data; do not duplicate manifest validation/hash. */
|
|
71
|
+
function selectMembers(manifest, roots, bindings) {
|
|
72
|
+
const entries = new Map();
|
|
73
|
+
for (const entry of manifest.entries)
|
|
74
|
+
entries.set(entry.id, entry);
|
|
75
|
+
const rootIds = new Set();
|
|
76
|
+
for (const id of roots) {
|
|
77
|
+
if (typeof id !== 'string' || rootIds.has(id) || !entries.has(id))
|
|
78
|
+
throw new EgretError('MANIFEST_GROUP_ROOTS_INVALID');
|
|
79
|
+
rootIds.add(id);
|
|
80
|
+
}
|
|
81
|
+
const selected = new Set();
|
|
82
|
+
const ordered = [];
|
|
83
|
+
function visit(id) {
|
|
84
|
+
if (selected.has(id))
|
|
85
|
+
return;
|
|
86
|
+
if (selected.size === MAX_GROUP)
|
|
87
|
+
throw new EgretError('MANIFEST_GROUP_LIMIT');
|
|
88
|
+
selected.add(id);
|
|
89
|
+
const entry = entries.get(id);
|
|
90
|
+
for (const dependency of entry.dependencies)
|
|
91
|
+
visit(dependency);
|
|
92
|
+
ordered.push(entry);
|
|
93
|
+
}
|
|
94
|
+
for (const id of rootIds)
|
|
95
|
+
visit(id);
|
|
96
|
+
if (bindings.length !== selected.size)
|
|
97
|
+
throw new EgretError('MANIFEST_GROUP_BINDINGS_INVALID');
|
|
98
|
+
const byId = new Map();
|
|
99
|
+
for (const binding of bindings) {
|
|
100
|
+
const state = requireManifestBinding(binding);
|
|
101
|
+
if (state.manifest !== manifest || !selected.has(state.entry.id) || byId.has(state.entry.id)) {
|
|
102
|
+
throw new EgretError('MANIFEST_GROUP_BINDINGS_INVALID');
|
|
103
|
+
}
|
|
104
|
+
byId.set(state.entry.id, { binding: binding, state });
|
|
105
|
+
}
|
|
106
|
+
return FREEZE(ordered.map(entry => byId.get(entry.id)));
|
|
107
|
+
}
|
|
108
|
+
function makeRecord(scope, selected, priority) {
|
|
109
|
+
let resolveReady;
|
|
110
|
+
let rejectReady;
|
|
111
|
+
const ready = new Promise((resolve, reject) => {
|
|
112
|
+
resolveReady = resolve;
|
|
113
|
+
rejectReady = reject;
|
|
114
|
+
});
|
|
115
|
+
void APPLY(THEN, ready, [undefined, () => { }]);
|
|
116
|
+
const group = {
|
|
117
|
+
controller: new CancellationController(),
|
|
118
|
+
priority,
|
|
119
|
+
ready,
|
|
120
|
+
resolveReady,
|
|
121
|
+
rejectReady,
|
|
122
|
+
byBinding: new Map(),
|
|
123
|
+
scope,
|
|
124
|
+
facade: undefined,
|
|
125
|
+
state: 'pending',
|
|
126
|
+
members: [],
|
|
127
|
+
acquired: [],
|
|
128
|
+
completed: 0,
|
|
129
|
+
reserved: false
|
|
130
|
+
};
|
|
131
|
+
const byId = new Map();
|
|
132
|
+
for (const value of selected) {
|
|
133
|
+
const member = {
|
|
134
|
+
group,
|
|
135
|
+
ref: value.state.ref,
|
|
136
|
+
state: 'queued',
|
|
137
|
+
unmet: value.state.entry.dependencies.length,
|
|
138
|
+
dependants: [],
|
|
139
|
+
lease: undefined
|
|
140
|
+
};
|
|
141
|
+
group.members.push(member);
|
|
142
|
+
group.byBinding.set(value.binding, member);
|
|
143
|
+
byId.set(value.state.entry.id, member);
|
|
144
|
+
}
|
|
145
|
+
for (const value of selected) {
|
|
146
|
+
const dependant = byId.get(value.state.entry.id);
|
|
147
|
+
for (const dependency of value.state.entry.dependencies)
|
|
148
|
+
byId.get(dependency).dependants.push(dependant);
|
|
149
|
+
}
|
|
150
|
+
return group;
|
|
151
|
+
}
|
|
152
|
+
/** One finite acquisition scheduler, using only captured manager lease authority. */
|
|
153
|
+
export function createManifestAssetGroupOwner(context, operations) {
|
|
154
|
+
const groups = new Set();
|
|
155
|
+
const interactive = [];
|
|
156
|
+
const background = [];
|
|
157
|
+
let admissionBusy = false;
|
|
158
|
+
let pumping = false;
|
|
159
|
+
let closed = false;
|
|
160
|
+
let queued = 0;
|
|
161
|
+
let active = 0;
|
|
162
|
+
let interactiveRun = 0;
|
|
163
|
+
function assertOpen() {
|
|
164
|
+
context.assertOpen();
|
|
165
|
+
if (closed)
|
|
166
|
+
throw new EgretError('ENGINE_CLOSED');
|
|
167
|
+
}
|
|
168
|
+
function reportCleanup(cause) {
|
|
169
|
+
context.captureCleanup(cause);
|
|
170
|
+
context.report({ code: 'MANIFEST_GROUP_CLEANUP_FAILED', phase: 'assets', severity: 'error', cause });
|
|
171
|
+
}
|
|
172
|
+
function release(lease) {
|
|
173
|
+
try {
|
|
174
|
+
operations.releaseGroupLease(lease);
|
|
175
|
+
}
|
|
176
|
+
catch (cause) {
|
|
177
|
+
reportCleanup(cause);
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
function removeReadyRecords(queue, group) {
|
|
181
|
+
// Remove physical records, not tombstones that cancellation loops can grow.
|
|
182
|
+
for (let index = queue.length - 1; index >= 0; index--) {
|
|
183
|
+
if (queue[index].group === group)
|
|
184
|
+
queue.splice(index, 1);
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
function commitTerminal(group, state, cause) {
|
|
188
|
+
if (group.state === 'failed' || group.state === 'disposed')
|
|
189
|
+
return undefined;
|
|
190
|
+
const pending = group.state === 'pending';
|
|
191
|
+
group.state = state;
|
|
192
|
+
const error = new EgretError(state === 'failed' ? 'MANIFEST_GROUP_ACQUIRE_FAILED' : 'MANIFEST_GROUP_DISPOSED', {
|
|
193
|
+
cause
|
|
194
|
+
});
|
|
195
|
+
if (pending)
|
|
196
|
+
group.rejectReady(error);
|
|
197
|
+
removeReadyRecords(interactive, group);
|
|
198
|
+
removeReadyRecords(background, group);
|
|
199
|
+
for (const member of group.members) {
|
|
200
|
+
if (member.state === 'queued') {
|
|
201
|
+
if (group.reserved)
|
|
202
|
+
queued--;
|
|
203
|
+
member.state = 'cancelled';
|
|
204
|
+
}
|
|
205
|
+
member.ref = undefined;
|
|
206
|
+
member.dependants = [];
|
|
207
|
+
member.lease = undefined;
|
|
208
|
+
}
|
|
209
|
+
group.reserved = false;
|
|
210
|
+
group.scope = undefined;
|
|
211
|
+
group.facade = undefined;
|
|
212
|
+
group.byBinding.clear();
|
|
213
|
+
group.members = [];
|
|
214
|
+
groups.delete(group);
|
|
215
|
+
const leases = group.acquired;
|
|
216
|
+
group.acquired = [];
|
|
217
|
+
return { group, error, leases };
|
|
218
|
+
}
|
|
219
|
+
function runCleanup(snapshot) {
|
|
220
|
+
// The group/queue authority is already revoked before either callback path.
|
|
221
|
+
try {
|
|
222
|
+
APPLY(ABORT, snapshot.group.controller, [snapshot.error]);
|
|
223
|
+
}
|
|
224
|
+
catch (cause) {
|
|
225
|
+
reportCleanup(cause);
|
|
226
|
+
}
|
|
227
|
+
for (let index = snapshot.leases.length - 1; index >= 0; index--)
|
|
228
|
+
release(snapshot.leases[index]);
|
|
229
|
+
}
|
|
230
|
+
function terminate(group, state, cause) {
|
|
231
|
+
const snapshot = commitTerminal(group, state, cause);
|
|
232
|
+
if (snapshot !== undefined)
|
|
233
|
+
runCleanup(snapshot);
|
|
234
|
+
pump();
|
|
235
|
+
}
|
|
236
|
+
function requirePending(group) {
|
|
237
|
+
if (group.state !== 'pending')
|
|
238
|
+
return false;
|
|
239
|
+
try {
|
|
240
|
+
assertOpen();
|
|
241
|
+
assertLifetime(context, group.scope);
|
|
242
|
+
return true;
|
|
243
|
+
}
|
|
244
|
+
catch (cause) {
|
|
245
|
+
terminate(group, 'disposed', cause);
|
|
246
|
+
return false;
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
function enqueue(member) {
|
|
250
|
+
if (member.state !== 'queued' || member.unmet !== 0 || member.group.state !== 'pending')
|
|
251
|
+
return;
|
|
252
|
+
(member.group.priority === 'interactive' ? interactive : background).push(member);
|
|
253
|
+
}
|
|
254
|
+
function fulfill(member, lease) {
|
|
255
|
+
const group = member.group;
|
|
256
|
+
if (!requirePending(group)) {
|
|
257
|
+
release(lease);
|
|
258
|
+
return;
|
|
259
|
+
}
|
|
260
|
+
try {
|
|
261
|
+
operations.claimGroupLease(lease, group.facade);
|
|
262
|
+
}
|
|
263
|
+
catch (cause) {
|
|
264
|
+
terminate(group, 'failed', cause);
|
|
265
|
+
release(lease);
|
|
266
|
+
return;
|
|
267
|
+
}
|
|
268
|
+
member.lease = lease;
|
|
269
|
+
group.acquired.push(lease);
|
|
270
|
+
group.completed++;
|
|
271
|
+
if (group.completed === group.members.length) {
|
|
272
|
+
group.state = 'ready';
|
|
273
|
+
for (const item of group.members) {
|
|
274
|
+
item.ref = undefined;
|
|
275
|
+
item.dependants = [];
|
|
276
|
+
}
|
|
277
|
+
group.resolveReady();
|
|
278
|
+
return;
|
|
279
|
+
}
|
|
280
|
+
for (const dependant of member.dependants) {
|
|
281
|
+
dependant.unmet--;
|
|
282
|
+
if (dependant.unmet === 0)
|
|
283
|
+
enqueue(dependant);
|
|
284
|
+
}
|
|
285
|
+
member.dependants = [];
|
|
286
|
+
}
|
|
287
|
+
function reject(group, cause) {
|
|
288
|
+
if (requirePending(group))
|
|
289
|
+
terminate(group, 'failed', cause);
|
|
290
|
+
}
|
|
291
|
+
function start(member) {
|
|
292
|
+
const group = member.group;
|
|
293
|
+
const ref = member.ref;
|
|
294
|
+
member.ref = undefined;
|
|
295
|
+
member.state = 'active';
|
|
296
|
+
queued--;
|
|
297
|
+
active++;
|
|
298
|
+
let outstanding = true;
|
|
299
|
+
const retireSlot = () => {
|
|
300
|
+
if (!outstanding)
|
|
301
|
+
return;
|
|
302
|
+
outstanding = false;
|
|
303
|
+
active--;
|
|
304
|
+
member.state = 'settled';
|
|
305
|
+
};
|
|
306
|
+
// This slot is a manager waiter. Its cancellation is not native settlement.
|
|
307
|
+
try {
|
|
308
|
+
const promise = operations.acquire(ref, { signal: group.controller.signal });
|
|
309
|
+
const continuation = APPLY(THEN, promise, [
|
|
310
|
+
(lease) => {
|
|
311
|
+
retireSlot();
|
|
312
|
+
try {
|
|
313
|
+
fulfill(member, lease);
|
|
314
|
+
}
|
|
315
|
+
finally {
|
|
316
|
+
pump();
|
|
317
|
+
}
|
|
318
|
+
},
|
|
319
|
+
(cause) => {
|
|
320
|
+
retireSlot();
|
|
321
|
+
reject(group, cause);
|
|
322
|
+
pump();
|
|
323
|
+
}
|
|
324
|
+
]);
|
|
325
|
+
void APPLY(THEN, continuation, [
|
|
326
|
+
undefined,
|
|
327
|
+
(cause) => {
|
|
328
|
+
retireSlot();
|
|
329
|
+
reject(group, cause);
|
|
330
|
+
pump();
|
|
331
|
+
}
|
|
332
|
+
]);
|
|
333
|
+
}
|
|
334
|
+
catch (cause) {
|
|
335
|
+
retireSlot();
|
|
336
|
+
reject(group, cause);
|
|
337
|
+
pump();
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
function next() {
|
|
341
|
+
if (interactive.length !== 0 && background.length !== 0) {
|
|
342
|
+
if (interactiveRun < 4) {
|
|
343
|
+
interactiveRun++;
|
|
344
|
+
return interactive.shift();
|
|
345
|
+
}
|
|
346
|
+
interactiveRun = 0;
|
|
347
|
+
return background.shift();
|
|
348
|
+
}
|
|
349
|
+
interactiveRun = 0;
|
|
350
|
+
return interactive.length !== 0 ? interactive.shift() : background.shift();
|
|
351
|
+
}
|
|
352
|
+
function pump() {
|
|
353
|
+
if (pumping || admissionBusy || closed)
|
|
354
|
+
return;
|
|
355
|
+
pumping = true;
|
|
356
|
+
try {
|
|
357
|
+
while (active < MAX_ACTIVE) {
|
|
358
|
+
const member = next();
|
|
359
|
+
if (member === undefined)
|
|
360
|
+
return;
|
|
361
|
+
if (member.state !== 'queued' || !requirePending(member.group))
|
|
362
|
+
continue;
|
|
363
|
+
start(member);
|
|
364
|
+
}
|
|
365
|
+
}
|
|
366
|
+
finally {
|
|
367
|
+
pumping = false;
|
|
368
|
+
}
|
|
369
|
+
}
|
|
370
|
+
function disposalCause(group) {
|
|
371
|
+
try {
|
|
372
|
+
assertOpen();
|
|
373
|
+
}
|
|
374
|
+
catch (cause) {
|
|
375
|
+
return cause;
|
|
376
|
+
}
|
|
377
|
+
if (group.scope !== undefined && APPLY(SCOPE_STATE, group.scope, []) !== 'open')
|
|
378
|
+
return new EgretError('SCOPE_CLOSED');
|
|
379
|
+
return undefined;
|
|
380
|
+
}
|
|
381
|
+
function makeHandle(group) {
|
|
382
|
+
function assertReceiver(receiver) {
|
|
383
|
+
if (receiver !== facade)
|
|
384
|
+
throw new EgretError('MANIFEST_GROUP_INVALID');
|
|
385
|
+
}
|
|
386
|
+
const facade = FREEZE({
|
|
387
|
+
get ready() {
|
|
388
|
+
assertReceiver(this);
|
|
389
|
+
return group.ready;
|
|
390
|
+
},
|
|
391
|
+
get(binding) {
|
|
392
|
+
assertReceiver(this);
|
|
393
|
+
requireManifestBinding(binding);
|
|
394
|
+
const member = group.byBinding.get(binding);
|
|
395
|
+
if (member === undefined)
|
|
396
|
+
throw new EgretError('MANIFEST_GROUP_BINDING_INVALID');
|
|
397
|
+
if (group.state !== 'ready')
|
|
398
|
+
throw new EgretError('MANIFEST_GROUP_NOT_READY');
|
|
399
|
+
assertOpen();
|
|
400
|
+
assertLifetime(context, group.scope);
|
|
401
|
+
return member.lease;
|
|
402
|
+
},
|
|
403
|
+
dispose() {
|
|
404
|
+
assertReceiver(this);
|
|
405
|
+
terminate(group, 'disposed', disposalCause(group));
|
|
406
|
+
}
|
|
407
|
+
});
|
|
408
|
+
group.facade = facade;
|
|
409
|
+
return facade;
|
|
410
|
+
}
|
|
411
|
+
return FREEZE({
|
|
412
|
+
create(scope, manifest, roots, bindings, options) {
|
|
413
|
+
assertOpen();
|
|
414
|
+
assertLifetime(context, scope);
|
|
415
|
+
if (admissionBusy)
|
|
416
|
+
throw new EgretError('MANIFEST_GROUP_REENTRANT');
|
|
417
|
+
if (!isAdmittedResourceManifest(manifest))
|
|
418
|
+
throw new EgretError('MANIFEST_GROUP_MANIFEST_INVALID');
|
|
419
|
+
admissionBusy = true;
|
|
420
|
+
let group;
|
|
421
|
+
let facade;
|
|
422
|
+
try {
|
|
423
|
+
const rootSnapshot = snapshotArray(context, scope, roots, 'MANIFEST_GROUP_ROOTS_INVALID');
|
|
424
|
+
const bindingSnapshot = snapshotArray(context, scope, bindings, 'MANIFEST_GROUP_BINDINGS_INVALID');
|
|
425
|
+
const priority = admitPriority(context, scope, options);
|
|
426
|
+
const selected = selectMembers(manifest, rootSnapshot, bindingSnapshot);
|
|
427
|
+
operations.admitGroupRefs(selected.map(value => value.state.ref));
|
|
428
|
+
assertLifetime(context, scope);
|
|
429
|
+
if (selected.length > MAX_QUEUED - queued)
|
|
430
|
+
throw new EgretError('MANIFEST_GROUP_QUEUE_LIMIT');
|
|
431
|
+
group = makeRecord(scope, selected, priority);
|
|
432
|
+
facade = makeHandle(group);
|
|
433
|
+
// Reserve the whole closure, including blocked nodes, before activation.
|
|
434
|
+
queued += selected.length;
|
|
435
|
+
group.reserved = true;
|
|
436
|
+
groups.add(group);
|
|
437
|
+
try {
|
|
438
|
+
APPLY(SCOPE_USE, scope, [facade]);
|
|
439
|
+
assertLifetime(context, scope);
|
|
440
|
+
}
|
|
441
|
+
catch (cause) {
|
|
442
|
+
terminate(group, 'disposed', cause);
|
|
443
|
+
throw cause;
|
|
444
|
+
}
|
|
445
|
+
}
|
|
446
|
+
finally {
|
|
447
|
+
admissionBusy = false;
|
|
448
|
+
}
|
|
449
|
+
if (requirePending(group)) {
|
|
450
|
+
if (group.members.length === 0) {
|
|
451
|
+
group.state = 'ready';
|
|
452
|
+
group.resolveReady();
|
|
453
|
+
}
|
|
454
|
+
else
|
|
455
|
+
for (const member of group.members)
|
|
456
|
+
enqueue(member);
|
|
457
|
+
}
|
|
458
|
+
pump();
|
|
459
|
+
return facade;
|
|
460
|
+
},
|
|
461
|
+
close() {
|
|
462
|
+
if (closed)
|
|
463
|
+
return;
|
|
464
|
+
closed = true;
|
|
465
|
+
const snapshots = [];
|
|
466
|
+
// Every group and queue record becomes terminal before the first callback.
|
|
467
|
+
for (const group of groups) {
|
|
468
|
+
const snapshot = commitTerminal(group, 'disposed', new EgretError('ENGINE_CLOSED'));
|
|
469
|
+
if (snapshot !== undefined)
|
|
470
|
+
snapshots.push(snapshot);
|
|
471
|
+
}
|
|
472
|
+
for (const snapshot of snapshots)
|
|
473
|
+
runCleanup(snapshot);
|
|
474
|
+
}
|
|
475
|
+
});
|
|
476
|
+
}
|
|
477
|
+
//# sourceMappingURL=manifestAssetGroup.js.map
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import type { AdmittedResourceManifest, ResourceManifestEntry } from '@egret/contracts/resources';
|
|
2
|
+
import type { AssetRef, AssetType } from '@egret/runtime';
|
|
3
|
+
import type { ManifestAssetBinding } from './manifestResourceTypes.js';
|
|
4
|
+
/** Private immutable metadata, shared only through the exact assembly alias. */
|
|
5
|
+
export interface ManifestBindingState {
|
|
6
|
+
readonly manifest: AdmittedResourceManifest;
|
|
7
|
+
readonly entry: ResourceManifestEntry;
|
|
8
|
+
readonly ref: AssetRef<unknown>;
|
|
9
|
+
}
|
|
10
|
+
/** Authentication never reads a structural lookalike or proxy property. */
|
|
11
|
+
export declare function requireManifestBinding(value: unknown): ManifestBindingState;
|
|
12
|
+
/** A matching ref ID alone cannot turn caller metadata into a verified source. */
|
|
13
|
+
export declare function requireManifestAssetRef(value: unknown): ManifestBindingState;
|
|
14
|
+
export declare function createManifestAssetBinding<T>(manifest: AdmittedResourceManifest, assetId: string, type: AssetType<T>): ManifestAssetBinding<T>;
|
|
15
|
+
export type { ManifestBinding } from './manifestResourceTypes.js';
|
|
16
|
+
//# sourceMappingURL=manifestResourceState.d.ts.map
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import { isAdmittedResourceManifest } from '@egret/contracts/resources';
|
|
3
|
+
import { createAssetRef, EgretError } from '@egret/runtime';
|
|
4
|
+
const APPLY = Reflect.apply;
|
|
5
|
+
const GET = WeakMap.prototype.get;
|
|
6
|
+
const SET = WeakMap.prototype.set;
|
|
7
|
+
const FREEZE = Object.freeze;
|
|
8
|
+
const bindingStates = new WeakMap();
|
|
9
|
+
const refStates = new WeakMap();
|
|
10
|
+
const typeTokens = new WeakMap();
|
|
11
|
+
let lastTypeToken = 0;
|
|
12
|
+
/** Authentication never reads a structural lookalike or proxy property. */
|
|
13
|
+
export function requireManifestBinding(value) {
|
|
14
|
+
const state = APPLY(GET, bindingStates, [value]);
|
|
15
|
+
if (state === undefined)
|
|
16
|
+
throw new EgretError('MANIFEST_BINDING_INVALID');
|
|
17
|
+
return state;
|
|
18
|
+
}
|
|
19
|
+
/** A matching ref ID alone cannot turn caller metadata into a verified source. */
|
|
20
|
+
export function requireManifestAssetRef(value) {
|
|
21
|
+
const state = APPLY(GET, refStates, [value]);
|
|
22
|
+
if (state === undefined)
|
|
23
|
+
throw new EgretError('MANIFEST_BINDING_REF_INVALID');
|
|
24
|
+
return state;
|
|
25
|
+
}
|
|
26
|
+
export function createManifestAssetBinding(manifest, assetId, type) {
|
|
27
|
+
if (!isAdmittedResourceManifest(manifest))
|
|
28
|
+
throw new EgretError('MANIFEST_BINDING_MANIFEST_INVALID');
|
|
29
|
+
if (typeof assetId !== 'string')
|
|
30
|
+
throw new EgretError('MANIFEST_BINDING_ASSET_INVALID');
|
|
31
|
+
let entry;
|
|
32
|
+
for (const candidate of manifest.entries) {
|
|
33
|
+
if (candidate.id === assetId) {
|
|
34
|
+
entry = candidate;
|
|
35
|
+
break;
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
if (entry === undefined)
|
|
39
|
+
throw new EgretError('MANIFEST_BINDING_ASSET_INVALID');
|
|
40
|
+
const known = APPLY(GET, typeTokens, [type]);
|
|
41
|
+
const token = known ?? lastTypeToken + 1;
|
|
42
|
+
if (!Number.isSafeInteger(token))
|
|
43
|
+
throw new EgretError('MANIFEST_BINDING_ID_EXHAUSTED');
|
|
44
|
+
// createAssetRef authenticates the type without reading its name/predicate.
|
|
45
|
+
// Publish a new token only after that succeeds. No manager registration occurs.
|
|
46
|
+
const ref = createAssetRef(type, 'egret.resource:' + entry.runtimeIdentity + ':type:' + token);
|
|
47
|
+
if (known === undefined) {
|
|
48
|
+
APPLY(SET, typeTokens, [type, token]);
|
|
49
|
+
lastTypeToken = token;
|
|
50
|
+
}
|
|
51
|
+
const state = FREEZE({ manifest, entry, ref: ref });
|
|
52
|
+
const binding = FREEZE({ ref });
|
|
53
|
+
APPLY(SET, bindingStates, [binding, state]);
|
|
54
|
+
APPLY(SET, refStates, [ref, state]);
|
|
55
|
+
return binding;
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=manifestResourceState.js.map
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { AssetLease, AssetRef } from '@egret/runtime';
|
|
2
|
+
declare const manifestBindingBrand: unique symbol;
|
|
3
|
+
declare const manifestBindingValue: unique symbol;
|
|
4
|
+
declare const manifestGroupBrand: unique symbol;
|
|
5
|
+
/** Immutable resource metadata; only the optional binding factory creates it. */
|
|
6
|
+
export interface ManifestBinding {
|
|
7
|
+
readonly [manifestBindingBrand]: true;
|
|
8
|
+
}
|
|
9
|
+
/** A genuine invariant ref paired with one exact admitted manifest entry. */
|
|
10
|
+
export interface ManifestAssetBinding<T> extends ManifestBinding {
|
|
11
|
+
readonly ref: AssetRef<T>;
|
|
12
|
+
readonly [manifestBindingValue]?: (value: T) => T;
|
|
13
|
+
}
|
|
14
|
+
export interface ManifestGroupOptions {
|
|
15
|
+
readonly priority?: 'interactive' | 'background';
|
|
16
|
+
}
|
|
17
|
+
/** Scope-owned dependency group. Member leases are borrowed, never transferred. */
|
|
18
|
+
export interface ManifestAssetGroup {
|
|
19
|
+
readonly [manifestGroupBrand]: true;
|
|
20
|
+
readonly ready: Promise<void>;
|
|
21
|
+
get<T>(binding: ManifestAssetBinding<T>): AssetLease<T>;
|
|
22
|
+
dispose(): void;
|
|
23
|
+
}
|
|
24
|
+
export {};
|
|
25
|
+
//# sourceMappingURL=manifestResourceTypes.d.ts.map
|
package/dist/motion.d.ts
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { Scope } from '@egret/runtime';
|
|
2
|
+
import type { Engine } from './Engine.js';
|
|
3
|
+
/** How a step runs from its start to its end: a name, or a function from 0–1 to 0–1 (it may pass both on the way). */
|
|
4
|
+
export type MotionEasing = MotionEasingName | ((fraction: number) => number);
|
|
5
|
+
export type MotionEasingName = 'linear' | 'quadIn' | 'quadOut' | 'quadInOut' | 'cubicIn' | 'cubicOut' | 'cubicInOut' | 'quartIn' | 'quartOut' | 'quartInOut' | 'sineIn' | 'sineOut' | 'sineInOut' | 'expoIn' | 'expoOut' | 'expoInOut' | 'backIn' | 'backOut' | 'backInOut' | 'elasticOut' | 'bounceOut';
|
|
6
|
+
export type MotionState = 'idle' | 'running' | 'paused' | 'finished' | 'stopped';
|
|
7
|
+
/** A chain of steps for one object. Steps are added before `start`; the calls return the motion, so they chain. */
|
|
8
|
+
export interface Motion<T extends object> {
|
|
9
|
+
readonly state: MotionState;
|
|
10
|
+
/** Moves the named numbers of the object from what they are when the step begins to these values, over seconds. */
|
|
11
|
+
to(values: {
|
|
12
|
+
readonly [K in keyof T]?: number;
|
|
13
|
+
}, seconds: number, easing?: MotionEasing): this;
|
|
14
|
+
/** Holds for seconds. */
|
|
15
|
+
wait(seconds: number): this;
|
|
16
|
+
/** Calls a function when the chain reaches it. */
|
|
17
|
+
call(callback: () => void): this;
|
|
18
|
+
/** Runs the chain this many times in all; without a number, until it is stopped. */
|
|
19
|
+
loop(times?: number): this;
|
|
20
|
+
/** Called once when the last step of the last run has ended. */
|
|
21
|
+
onFinish(callback: () => void): this;
|
|
22
|
+
start(): this;
|
|
23
|
+
pause(): void;
|
|
24
|
+
resume(): void;
|
|
25
|
+
/** Ends the motion where it is. The object keeps the values it has. */
|
|
26
|
+
stop(): void;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* A motion of one object: `animate(engine, scope, sprite).to({ x: 100, alpha: 0.5 }, 0.5, 'quadOut').wait(0.2).to({ x: 0 }, 0.5).start()`.
|
|
30
|
+
* It runs on the Engine's clock, like a tween, and ends with its scope.
|
|
31
|
+
*/
|
|
32
|
+
export declare function animate<T extends object>(engine: Engine, scope: Scope, target: T): Motion<T>;
|
|
33
|
+
//# sourceMappingURL=motion.d.ts.map
|