@egret/engine 0.0.0-stage → 7.0.2
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 +469 -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 +48 -0
- package/dist/animation/sequenceResetTypes.js +2 -0
- package/dist/animation/types.d.ts +75 -0
- package/dist/animation/types.js +2 -0
- package/dist/assetBundle.d.ts +54 -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 +17 -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 +47 -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 +246 -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 +31 -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 +112 -0
- package/dist/bitmapFontTypes.js +2 -0
- package/dist/bitmapResourceSlot.d.ts +26 -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 +419 -0
- package/dist/cameraTypes.d.ts +126 -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 +35 -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 +45 -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 +39 -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 +37 -0
- package/dist/gameClockTypes.js +2 -0
- package/dist/gameRun.d.ts +53 -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 +142 -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 +129 -0
- package/dist/hoverInputTypes.js +2 -0
- package/dist/index.d.ts +52 -0
- package/dist/index.js +21 -0
- package/dist/input.d.ts +6 -0
- package/dist/input.js +5 -0
- package/dist/inputActions.d.ts +86 -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 +68 -0
- package/dist/internal/uiFactoryState.js +173 -0
- package/dist/internal/uiRootState.d.ts +67 -0
- package/dist/internal/uiRootState.js +103 -0
- package/dist/keyboardInput.d.ts +13 -0
- package/dist/keyboardInput.js +579 -0
- package/dist/keyboardInputTypes.d.ts +93 -0
- package/dist/keyboardInputTypes.js +2 -0
- package/dist/kit.d.ts +16 -0
- package/dist/kit.js +10 -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 +17 -0
- package/dist/manifestResourceState.js +58 -0
- package/dist/manifestResourceTypes.d.ts +26 -0
- package/dist/manifestResourceTypes.js +2 -0
- package/dist/motion.d.ts +35 -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 +41 -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 +300 -0
- package/dist/particleTypes.d.ts +115 -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 +221 -0
- package/dist/physics2dTypes.js +2 -0
- package/dist/physics2dWorld.d.ts +4 -0
- package/dist/physics2dWorld.js +823 -0
- package/dist/pointerInput.d.ts +12 -0
- package/dist/pointerInput.js +300 -0
- package/dist/pointerInputTypes.d.ts +41 -0
- package/dist/pointerInputTypes.js +2 -0
- package/dist/random.d.ts +30 -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 +379 -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 +90 -0
- package/dist/rendering/prepareSharedDraws2D.js +663 -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 +52 -0
- package/dist/rendering/sharedColor2D.js +191 -0
- package/dist/rendering/sharedEffects2D.d.ts +23 -0
- package/dist/rendering/sharedEffects2D.js +126 -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 +104 -0
- package/dist/rendering/world3d/Animation3D.js +384 -0
- package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
- package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
- package/dist/rendering/world3d/Batch3D.d.ts +75 -0
- package/dist/rendering/world3d/Batch3D.js +332 -0
- package/dist/rendering/world3d/Camera3D.d.ts +62 -0
- package/dist/rendering/world3d/Camera3D.js +132 -0
- package/dist/rendering/world3d/Character3D.d.ts +127 -0
- package/dist/rendering/world3d/Character3D.js +305 -0
- package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
- package/dist/rendering/world3d/Cloth3D.js +503 -0
- package/dist/rendering/world3d/Compression3D.d.ts +22 -0
- package/dist/rendering/world3d/Compression3D.js +703 -0
- package/dist/rendering/world3d/Curves3D.d.ts +119 -0
- package/dist/rendering/world3d/Curves3D.js +460 -0
- package/dist/rendering/world3d/Decal3D.d.ts +43 -0
- package/dist/rendering/world3d/Decal3D.js +242 -0
- package/dist/rendering/world3d/Export3D.d.ts +13 -0
- package/dist/rendering/world3d/Export3D.js +263 -0
- package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
- package/dist/rendering/world3d/Geometry3D.js +335 -0
- package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
- package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
- package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
- package/dist/rendering/world3d/Gizmo3D.js +514 -0
- package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
- package/dist/rendering/world3d/Gltf3D.js +996 -0
- package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
- package/dist/rendering/world3d/GpuParticles3D.js +401 -0
- package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
- package/dist/rendering/world3d/Hdr3D.js +191 -0
- package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
- package/dist/rendering/world3d/Jelly3D.js +267 -0
- package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
- package/dist/rendering/world3d/Ktx23D.js +112 -0
- package/dist/rendering/world3d/Light3D.d.ts +84 -0
- package/dist/rendering/world3d/Light3D.js +97 -0
- package/dist/rendering/world3d/Material3D.d.ts +253 -0
- package/dist/rendering/world3d/Material3D.js +269 -0
- package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
- package/dist/rendering/world3d/Mesh3D.js +337 -0
- package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
- package/dist/rendering/world3d/Meshopt3D.js +276 -0
- package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
- package/dist/rendering/world3d/Navigation3D.js +1043 -0
- package/dist/rendering/world3d/Object3D.d.ts +118 -0
- package/dist/rendering/world3d/Object3D.js +315 -0
- package/dist/rendering/world3d/Particles3D.d.ts +90 -0
- package/dist/rendering/world3d/Particles3D.js +277 -0
- package/dist/rendering/world3d/Physics3D.d.ts +430 -0
- package/dist/rendering/world3d/Physics3D.js +2840 -0
- package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
- package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
- package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
- package/dist/rendering/world3d/PhysicsMesh3D.js +340 -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 +179 -0
- package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
- package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
- package/dist/rendering/world3d/Ragdoll3D.js +202 -0
- package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
- package/dist/rendering/world3d/Raycast3D.js +247 -0
- package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
- package/dist/rendering/world3d/RenderList3D.js +502 -0
- package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
- package/dist/rendering/world3d/Retarget3D.js +185 -0
- package/dist/rendering/world3d/Rig3D.d.ts +57 -0
- package/dist/rendering/world3d/Rig3D.js +219 -0
- package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
- package/dist/rendering/world3d/Sdf3D.js +1136 -0
- package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
- package/dist/rendering/world3d/SdfLod3D.js +56 -0
- package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
- package/dist/rendering/world3d/Serialize3D.js +629 -0
- package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
- package/dist/rendering/world3d/Simplify3D.js +426 -0
- package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
- package/dist/rendering/world3d/StateMachine3D.js +280 -0
- package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
- package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
- package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
- package/dist/rendering/world3d/Terrain3D.js +827 -0
- package/dist/rendering/world3d/Text3D.d.ts +95 -0
- package/dist/rendering/world3d/Text3D.js +560 -0
- package/dist/rendering/world3d/Texture3D.d.ts +148 -0
- package/dist/rendering/world3d/Texture3D.js +270 -0
- package/dist/rendering/world3d/Trail3D.d.ts +62 -0
- package/dist/rendering/world3d/Trail3D.js +195 -0
- package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
- package/dist/rendering/world3d/Vehicle3D.js +228 -0
- package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
- package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
- package/dist/rendering/world3d/Water3D.d.ts +165 -0
- package/dist/rendering/world3d/Water3D.js +607 -0
- package/dist/rendering/world3d/core3D.d.ts +36 -0
- package/dist/rendering/world3d/core3D.js +99 -0
- package/dist/rendering/world3d/debug3D.d.ts +69 -0
- package/dist/rendering/world3d/debug3D.js +262 -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 +111 -0
- package/dist/rendering/world3d/geometries3D.js +610 -0
- package/dist/rendering/world3d/helpers3D.d.ts +67 -0
- package/dist/rendering/world3d/helpers3D.js +178 -0
- package/dist/rendering/world3d/index.d.ts +103 -0
- package/dist/rendering/world3d/index.js +62 -0
- package/dist/rendering/world3d/math3D.d.ts +114 -0
- package/dist/rendering/world3d/math3D.js +675 -0
- package/dist/rendering/world3d/primitives3D.d.ts +67 -0
- package/dist/rendering/world3d/primitives3D.js +197 -0
- package/dist/resources.d.ts +8 -0
- package/dist/resources.js +6 -0
- package/dist/saveStore.d.ts +71 -0
- package/dist/saveStore.js +182 -0
- package/dist/semanticList.d.ts +126 -0
- package/dist/semanticList.js +175 -0
- package/dist/semanticTree.d.ts +10 -0
- package/dist/semanticTree.js +539 -0
- package/dist/semanticTypes.d.ts +175 -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 +24 -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 +24 -0
- package/dist/text.js +4 -0
- package/dist/textField.d.ts +6 -0
- package/dist/textField.js +6 -0
- package/dist/textTable.d.ts +41 -0
- package/dist/textTable.js +114 -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 +182 -0
- package/dist/tilemapTypes.js +2 -0
- package/dist/timer.d.ts +34 -0
- package/dist/timer.js +119 -0
- package/dist/tween.d.ts +15 -0
- package/dist/tween.js +329 -0
- package/dist/tweenTypes.d.ts +31 -0
- package/dist/tweenTypes.js +2 -0
- package/dist/ui/controlKeys.d.ts +113 -0
- package/dist/ui/controlKeys.js +250 -0
- package/dist/ui/controls.d.ts +58 -0
- package/dist/ui/controls.js +290 -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 +98 -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 +53 -0
- package/dist/ui/rangeControl.js +168 -0
- package/dist/ui/scrollControl.d.ts +84 -0
- package/dist/ui/scrollControl.js +222 -0
- package/dist/ui/stateControls.d.ts +90 -0
- package/dist/ui/stateControls.js +331 -0
- package/dist/ui/textEditor.d.ts +54 -0
- package/dist/ui/textEditor.js +371 -0
- package/dist/ui/textEditorTypes.d.ts +85 -0
- package/dist/ui/textEditorTypes.js +2 -0
- package/dist/ui/textFieldControl.d.ts +100 -0
- package/dist/ui/textFieldControl.js +260 -0
- package/dist/ui/theme.d.ts +64 -0
- package/dist/ui/theme.js +166 -0
- package/dist/ui/types.d.ts +285 -0
- package/dist/ui/types.js +2 -0
- package/dist/ui/uiRoot.d.ts +4 -0
- package/dist/ui/uiRoot.js +1526 -0
- package/dist/ui/uiRootDisplay.d.ts +46 -0
- package/dist/ui/uiRootDisplay.js +148 -0
- package/dist/ui/uiRootModel.d.ts +114 -0
- package/dist/ui/uiRootModel.js +66 -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 +77 -0
- package/dist/videoTypes.js +2 -0
- package/dist/web/BrowserAssetBundle.d.ts +41 -0
- package/dist/web/BrowserAssetBundle.js +136 -0
- package/dist/web/BrowserAudio.d.ts +74 -0
- package/dist/web/BrowserAudio.js +503 -0
- package/dist/web/BrowserFrameLoop.d.ts +69 -0
- package/dist/web/BrowserFrameLoop.js +125 -0
- package/dist/web/BrowserGame.d.ts +174 -0
- package/dist/web/BrowserGame.js +473 -0
- package/dist/web/BrowserGamepadInput.d.ts +38 -0
- package/dist/web/BrowserGamepadInput.js +134 -0
- package/dist/web/BrowserHoverInput.d.ts +25 -0
- package/dist/web/BrowserHoverInput.js +266 -0
- package/dist/web/BrowserImageTextures.d.ts +72 -0
- package/dist/web/BrowserImageTextures.js +169 -0
- package/dist/web/BrowserInputActions.d.ts +63 -0
- package/dist/web/BrowserInputActions.js +345 -0
- package/dist/web/BrowserKeyboardInput.d.ts +4 -0
- package/dist/web/BrowserKeyboardInput.js +223 -0
- package/dist/web/BrowserPlay.d.ts +417 -0
- package/dist/web/BrowserPlay.js +1648 -0
- package/dist/web/BrowserPointerInput.d.ts +4 -0
- package/dist/web/BrowserPointerInput.js +511 -0
- package/dist/web/BrowserPreferences.d.ts +10 -0
- package/dist/web/BrowserPreferences.js +39 -0
- package/dist/web/BrowserSemantics.d.ts +36 -0
- package/dist/web/BrowserSemantics.js +418 -0
- package/dist/web/BrowserStatsPanel.d.ts +56 -0
- package/dist/web/BrowserStatsPanel.js +143 -0
- package/dist/web/BrowserStorage.d.ts +35 -0
- package/dist/web/BrowserStorage.js +132 -0
- package/dist/web/BrowserTextEditor.d.ts +52 -0
- package/dist/web/BrowserTextEditor.js +839 -0
- package/dist/web/BrowserTextInput.d.ts +89 -0
- package/dist/web/BrowserTextInput.js +524 -0
- package/dist/web/BrowserTextureProvider.d.ts +58 -0
- package/dist/web/BrowserTextureProvider.js +935 -0
- package/dist/web/BrowserVideo.d.ts +40 -0
- package/dist/web/BrowserVideo.js +237 -0
- package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
- package/dist/web/CanvasKitFontSetProvider.js +215 -0
- package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
- package/dist/web/CanvasKitParagraphProvider.js +692 -0
- package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
- package/dist/web/CanvasTextRasterProvider.js +312 -0
- package/dist/web/ManifestByteSource.d.ts +151 -0
- package/dist/web/ManifestByteSource.js +975 -0
- package/dist/web/ManifestFontContentLoader.d.ts +13 -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 +2711 -0
- package/dist/web/WebGPUHost.d.ts +100 -0
- package/dist/web/WebGPUHost.js +3430 -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 +54 -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 +16 -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 +11 -0
- package/dist/web/kit.js +8 -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 +10 -0
- package/dist/web/play.js +9 -0
- package/dist/web/playMusic.d.ts +33 -0
- package/dist/web/playMusic.js +194 -0
- package/dist/web/playSfx.d.ts +36 -0
- package/dist/web/playSfx.js +112 -0
- package/dist/web/playTouch.d.ts +45 -0
- package/dist/web/playTouch.js +141 -0
- package/dist/web/playWidgets.d.ts +71 -0
- package/dist/web/playWidgets.js +431 -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 +63 -0
- package/dist/web/resources.d.ts +29 -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 +13 -0
- package/dist/web/sharedEffectShaders.js +181 -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 +33 -0
- package/dist/web/sharedWebGL2Options.js +102 -0
- package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
- package/dist/web/sharedWebGL2Shaders.js +408 -0
- package/dist/web/sharedWebGPUOptions.d.ts +41 -0
- package/dist/web/sharedWebGPUOptions.js +130 -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 +72 -0
- package/dist/web/webgl2Native.js +572 -0
- package/dist/web/webgl2Types.d.ts +150 -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 +56 -0
- package/dist/web/webgpuImageResidency.js +65 -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 +85 -0
- package/dist/web/webgpuSharedPass.d.ts +7 -0
- package/dist/web/webgpuSharedPass.js +293 -0
- package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
- package/dist/web/webgpuSharedResolvePass.js +34 -0
- package/dist/web/world3d/Audio3D.d.ts +85 -0
- package/dist/web/world3d/Audio3D.js +271 -0
- package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
- package/dist/web/world3d/BrowserPlay3D.js +1256 -0
- package/dist/web/world3d/FlyControls3D.d.ts +59 -0
- package/dist/web/world3d/FlyControls3D.js +162 -0
- package/dist/web/world3d/FollowControls3D.d.ts +31 -0
- package/dist/web/world3d/FollowControls3D.js +119 -0
- package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
- package/dist/web/world3d/OrbitControls3D.js +189 -0
- package/dist/web/world3d/TransformControls3D.d.ts +37 -0
- package/dist/web/world3d/TransformControls3D.js +128 -0
- package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
- package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
- package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
- package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
- package/dist/web/world3d/World3DView.d.ts +54 -0
- package/dist/web/world3d/World3DView.js +79 -0
- package/dist/web/world3d/app3D.d.ts +143 -0
- package/dist/web/world3d/app3D.js +305 -0
- package/dist/web/world3d/assets3D.d.ts +39 -0
- package/dist/web/world3d/assets3D.js +112 -0
- package/dist/web/world3d/atmosphere3D.d.ts +56 -0
- package/dist/web/world3d/atmosphere3D.js +193 -0
- package/dist/web/world3d/canvasFont3D.d.ts +21 -0
- package/dist/web/world3d/canvasFont3D.js +165 -0
- package/dist/web/world3d/frame3D.d.ts +144 -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 +24 -0
- package/dist/web/world3d/host3D.js +61 -0
- package/dist/web/world3d/index.d.ts +40 -0
- package/dist/web/world3d/index.js +24 -0
- package/dist/web/world3d/loaders3D.d.ts +27 -0
- package/dist/web/world3d/loaders3D.js +138 -0
- package/dist/web/world3d/markers3D.d.ts +53 -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 +47 -0
- package/dist/web/world3d/overlay3D.js +187 -0
- package/dist/web/world3d/post3D.d.ts +116 -0
- package/dist/web/world3d/post3D.js +462 -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 +15 -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 +34 -0
- package/dist/web/world3d/stats3D.js +81 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
- package/dist/web/world3d/webgpu.d.ts +37 -0
- package/dist/web/world3d/webgpu.js +23 -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,250 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import { EgretError } from '@egret/runtime';
|
|
3
|
+
const ARROWS = {
|
|
4
|
+
ArrowLeft: [-1, 0],
|
|
5
|
+
ArrowRight: [1, 0],
|
|
6
|
+
ArrowUp: [0, -1],
|
|
7
|
+
ArrowDown: [0, 1]
|
|
8
|
+
};
|
|
9
|
+
const LETTERS = { KeyA: [-1, 0], KeyD: [1, 0], KeyW: [0, -1], KeyS: [0, 1] };
|
|
10
|
+
const ACTIVATES = ['Space', 'Enter', 'NumpadEnter'];
|
|
11
|
+
const METHODS = {
|
|
12
|
+
action: ['press', 'release'],
|
|
13
|
+
toggle: ['toggle'],
|
|
14
|
+
textField: ['edit'],
|
|
15
|
+
selection: ['next', 'previous', 'first', 'last'],
|
|
16
|
+
scroll: ['line', 'page', 'toStart', 'toEnd'],
|
|
17
|
+
range: ['stepBy', 'toMin', 'toMax'],
|
|
18
|
+
movement: ['setDirection']
|
|
19
|
+
};
|
|
20
|
+
/** Binds the keyboard to a control: Space and Enter press an action or a toggle, arrows move a selection. */
|
|
21
|
+
export function createControlKeys(options) {
|
|
22
|
+
if (options === null || typeof options !== 'object')
|
|
23
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
24
|
+
const { keyboard, target, kind, control } = options;
|
|
25
|
+
const events = keyboard === null || typeof keyboard !== 'object' ? undefined : keyboard.events;
|
|
26
|
+
const methods = typeof kind === 'string' && Object.hasOwn(METHODS, kind) ? METHODS[kind] : undefined;
|
|
27
|
+
if (events === null ||
|
|
28
|
+
typeof events !== 'object' ||
|
|
29
|
+
[events.keyDown, events.keyUp, events.cancel].some(type => type === null || typeof type !== 'object') ||
|
|
30
|
+
target === null ||
|
|
31
|
+
typeof target !== 'object' ||
|
|
32
|
+
typeof target.on !== 'function' ||
|
|
33
|
+
methods === undefined ||
|
|
34
|
+
control === null ||
|
|
35
|
+
typeof control !== 'object' ||
|
|
36
|
+
methods.some(name => typeof control[name] !== 'function'))
|
|
37
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
38
|
+
const onPressChange = options.kind === 'selection' || options.kind === 'scroll' || options.kind === 'range'
|
|
39
|
+
? undefined
|
|
40
|
+
: options.onPressChange;
|
|
41
|
+
if (onPressChange !== undefined && typeof onPressChange !== 'function')
|
|
42
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
43
|
+
let closed = false;
|
|
44
|
+
/** The codes this binding holds, in the order they went down. */
|
|
45
|
+
const held = new Set();
|
|
46
|
+
function hold(code, down) {
|
|
47
|
+
const was = held.size > 0;
|
|
48
|
+
if (down)
|
|
49
|
+
held.add(code);
|
|
50
|
+
else
|
|
51
|
+
held.delete(code);
|
|
52
|
+
if (was !== held.size > 0)
|
|
53
|
+
onPressChange?.(!was);
|
|
54
|
+
}
|
|
55
|
+
const shortcut = (payload) => payload.altKey || payload.ctrlKey || payload.metaKey;
|
|
56
|
+
let down, release = () => {
|
|
57
|
+
/* nothing is held */
|
|
58
|
+
};
|
|
59
|
+
if (options.kind === 'action' || options.kind === 'toggle' || options.kind === 'textField') {
|
|
60
|
+
const activate = options.kind === 'action'
|
|
61
|
+
? () => {
|
|
62
|
+
options.control.press();
|
|
63
|
+
options.control.release();
|
|
64
|
+
}
|
|
65
|
+
: options.kind === 'toggle'
|
|
66
|
+
? () => {
|
|
67
|
+
options.control.toggle();
|
|
68
|
+
}
|
|
69
|
+
: () => {
|
|
70
|
+
options.control.edit();
|
|
71
|
+
};
|
|
72
|
+
down = event => {
|
|
73
|
+
const { code, repeat } = event.payload;
|
|
74
|
+
if (!ACTIVATES.includes(code) || shortcut(event.payload) || !control.enabled)
|
|
75
|
+
return;
|
|
76
|
+
// One key activates at a time. The repeats of the key that is held are taken with it.
|
|
77
|
+
if (held.size === 0 && !repeat)
|
|
78
|
+
hold(code, true);
|
|
79
|
+
else if (!held.has(code))
|
|
80
|
+
return;
|
|
81
|
+
event.preventDefault();
|
|
82
|
+
};
|
|
83
|
+
release = (code, completed) => {
|
|
84
|
+
hold(code, false);
|
|
85
|
+
if (completed && control.enabled)
|
|
86
|
+
activate();
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
else if (options.kind === 'selection') {
|
|
90
|
+
const group = options.control, orientation = options.orientation ?? 'both';
|
|
91
|
+
if (orientation !== 'horizontal' && orientation !== 'vertical' && orientation !== 'both')
|
|
92
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
93
|
+
const moves = { Home: () => group.first(), End: () => group.last() };
|
|
94
|
+
if (orientation !== 'vertical') {
|
|
95
|
+
moves.ArrowRight = () => group.next();
|
|
96
|
+
moves.ArrowLeft = () => group.previous();
|
|
97
|
+
}
|
|
98
|
+
if (orientation !== 'horizontal') {
|
|
99
|
+
moves.ArrowDown = () => group.next();
|
|
100
|
+
moves.ArrowUp = () => group.previous();
|
|
101
|
+
}
|
|
102
|
+
down = event => {
|
|
103
|
+
const move = Object.hasOwn(moves, event.payload.code) ? moves[event.payload.code] : undefined;
|
|
104
|
+
if (move === undefined || shortcut(event.payload) || !control.enabled)
|
|
105
|
+
return;
|
|
106
|
+
// The key is the group's also at an end that does not wrap, as it is in a native group.
|
|
107
|
+
event.preventDefault();
|
|
108
|
+
move();
|
|
109
|
+
};
|
|
110
|
+
}
|
|
111
|
+
else if (options.kind === 'scroll') {
|
|
112
|
+
const scroll = options.control;
|
|
113
|
+
if (scroll.axis !== 'x' && scroll.axis !== 'y')
|
|
114
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
115
|
+
const moves = {
|
|
116
|
+
PageDown: () => scroll.page(1),
|
|
117
|
+
PageUp: () => scroll.page(-1),
|
|
118
|
+
Home: () => scroll.toStart(),
|
|
119
|
+
End: () => scroll.toEnd()
|
|
120
|
+
};
|
|
121
|
+
moves[scroll.axis === 'y' ? 'ArrowDown' : 'ArrowRight'] = () => scroll.line(1);
|
|
122
|
+
moves[scroll.axis === 'y' ? 'ArrowUp' : 'ArrowLeft'] = () => scroll.line(-1);
|
|
123
|
+
down = event => {
|
|
124
|
+
const move = Object.hasOwn(moves, event.payload.code) ? moves[event.payload.code] : undefined;
|
|
125
|
+
if (move === undefined || shortcut(event.payload) || !control.enabled)
|
|
126
|
+
return;
|
|
127
|
+
// At its end the viewport leaves the key to a viewport outside it, or to the page.
|
|
128
|
+
if (move())
|
|
129
|
+
event.preventDefault();
|
|
130
|
+
};
|
|
131
|
+
}
|
|
132
|
+
else if (options.kind === 'range') {
|
|
133
|
+
const range = options.control, orientation = options.orientation ?? 'both', page = options.page ?? 10;
|
|
134
|
+
if ((orientation !== 'horizontal' && orientation !== 'vertical' && orientation !== 'both') ||
|
|
135
|
+
!Number.isSafeInteger(page) ||
|
|
136
|
+
page < 1)
|
|
137
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
138
|
+
const moves = {
|
|
139
|
+
PageUp: () => range.stepBy(page),
|
|
140
|
+
PageDown: () => range.stepBy(-page),
|
|
141
|
+
Home: () => range.toMin(),
|
|
142
|
+
End: () => range.toMax()
|
|
143
|
+
};
|
|
144
|
+
if (orientation !== 'vertical') {
|
|
145
|
+
moves.ArrowRight = () => range.stepBy(1);
|
|
146
|
+
moves.ArrowLeft = () => range.stepBy(-1);
|
|
147
|
+
}
|
|
148
|
+
if (orientation !== 'horizontal') {
|
|
149
|
+
moves.ArrowUp = () => range.stepBy(1);
|
|
150
|
+
moves.ArrowDown = () => range.stepBy(-1);
|
|
151
|
+
}
|
|
152
|
+
down = event => {
|
|
153
|
+
const move = Object.hasOwn(moves, event.payload.code) ? moves[event.payload.code] : undefined;
|
|
154
|
+
if (move === undefined || shortcut(event.payload) || !control.enabled)
|
|
155
|
+
return;
|
|
156
|
+
// The key is the slider's also at an end, as it is in a native one: the page does not scroll under it.
|
|
157
|
+
event.preventDefault();
|
|
158
|
+
move();
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
else {
|
|
162
|
+
const movement = options.control, keys = options.keys ?? 'both';
|
|
163
|
+
if (keys !== 'arrows' && keys !== 'wasd' && keys !== 'both')
|
|
164
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
165
|
+
const vectors = {
|
|
166
|
+
...(keys === 'wasd' ? {} : ARROWS),
|
|
167
|
+
...(keys === 'arrows' ? {} : LETTERS)
|
|
168
|
+
};
|
|
169
|
+
const steer = () => {
|
|
170
|
+
let x = 0, y = 0;
|
|
171
|
+
for (const code of held) {
|
|
172
|
+
x += vectors[code][0];
|
|
173
|
+
y += vectors[code][1];
|
|
174
|
+
}
|
|
175
|
+
movement.setDirection(x, y);
|
|
176
|
+
};
|
|
177
|
+
down = event => {
|
|
178
|
+
const { code } = event.payload;
|
|
179
|
+
if (!Object.hasOwn(vectors, code) || shortcut(event.payload) || !control.enabled)
|
|
180
|
+
return;
|
|
181
|
+
event.preventDefault();
|
|
182
|
+
if (held.has(code))
|
|
183
|
+
return;
|
|
184
|
+
hold(code, true);
|
|
185
|
+
steer();
|
|
186
|
+
};
|
|
187
|
+
release = code => {
|
|
188
|
+
hold(code, false);
|
|
189
|
+
steer();
|
|
190
|
+
};
|
|
191
|
+
}
|
|
192
|
+
const subscriptions = [
|
|
193
|
+
target.on(events.keyDown, event => {
|
|
194
|
+
if (!closed && !event.defaultPrevented)
|
|
195
|
+
down(event);
|
|
196
|
+
}),
|
|
197
|
+
target.on(events.keyUp, event => {
|
|
198
|
+
if (closed || !held.has(event.payload.code))
|
|
199
|
+
return;
|
|
200
|
+
const taken = event.defaultPrevented;
|
|
201
|
+
event.preventDefault();
|
|
202
|
+
release(event.payload.code, !taken);
|
|
203
|
+
}),
|
|
204
|
+
// The focus left, or the page did, while the key was down.
|
|
205
|
+
target.on(events.cancel, event => {
|
|
206
|
+
if (!closed && held.has(event.payload.code))
|
|
207
|
+
release(event.payload.code, false);
|
|
208
|
+
})
|
|
209
|
+
];
|
|
210
|
+
return Object.freeze({
|
|
211
|
+
get pressed() {
|
|
212
|
+
return held.size > 0;
|
|
213
|
+
},
|
|
214
|
+
dispose() {
|
|
215
|
+
if (closed)
|
|
216
|
+
return;
|
|
217
|
+
closed = true;
|
|
218
|
+
let failure;
|
|
219
|
+
const was = held.size > 0;
|
|
220
|
+
held.clear();
|
|
221
|
+
if (was) {
|
|
222
|
+
// A direction that was held ends with the binding. A control that is already closed has none.
|
|
223
|
+
if (options.kind === 'movement')
|
|
224
|
+
try {
|
|
225
|
+
options.control.setDirection(0, 0);
|
|
226
|
+
}
|
|
227
|
+
catch (cause) {
|
|
228
|
+
if (!(cause instanceof EgretError) || cause.code !== 'UI_CONTROL_CLOSED')
|
|
229
|
+
failure = cause;
|
|
230
|
+
}
|
|
231
|
+
try {
|
|
232
|
+
onPressChange?.(false);
|
|
233
|
+
}
|
|
234
|
+
catch (cause) {
|
|
235
|
+
failure ??= cause;
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
for (const unsubscribe of subscriptions)
|
|
239
|
+
try {
|
|
240
|
+
unsubscribe();
|
|
241
|
+
}
|
|
242
|
+
catch (cause) {
|
|
243
|
+
failure ??= cause;
|
|
244
|
+
}
|
|
245
|
+
if (failure !== undefined)
|
|
246
|
+
throw failure;
|
|
247
|
+
}
|
|
248
|
+
});
|
|
249
|
+
}
|
|
250
|
+
//# sourceMappingURL=controlKeys.js.map
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import type { DisplayObject } from '@egret/runtime';
|
|
2
|
+
import type { PointerInput } from '../pointerInputTypes.js';
|
|
3
|
+
/**
|
|
4
|
+
* Reusable movement and action controls over the existing contact stream.
|
|
5
|
+
*
|
|
6
|
+
* These own control state only: they add no host listener, scheduler or gesture framework, and they
|
|
7
|
+
* do not decide routing. A control takes one contact at most, refuses a second rather than stealing
|
|
8
|
+
* it, and always ends at exactly one released value so a suspended or disposed control can never
|
|
9
|
+
* leave an action held.
|
|
10
|
+
*/
|
|
11
|
+
export interface MovementValue {
|
|
12
|
+
readonly x: number;
|
|
13
|
+
readonly y: number;
|
|
14
|
+
}
|
|
15
|
+
/** A movement control to make: its input and target, its radius and dead zone, and what it calls. */
|
|
16
|
+
export interface MovementControlOptions {
|
|
17
|
+
readonly input: PointerInput;
|
|
18
|
+
/** The surface that owns this control; contacts routed elsewhere are not claimed. */
|
|
19
|
+
readonly target: DisplayObject;
|
|
20
|
+
/** Full-deflection distance in logical units. */
|
|
21
|
+
readonly radius: number;
|
|
22
|
+
/** Distance below which the control reports no movement. Defaults to a tenth of the radius. */
|
|
23
|
+
readonly deadZone?: number;
|
|
24
|
+
readonly onMovement?: (value: MovementValue) => void;
|
|
25
|
+
}
|
|
26
|
+
/** A virtual stick: where it points now, whether it is held, and calls that set or disable it. */
|
|
27
|
+
export interface MovementControl {
|
|
28
|
+
readonly value: MovementValue;
|
|
29
|
+
readonly active: boolean;
|
|
30
|
+
readonly enabled: boolean;
|
|
31
|
+
/** Keyboard or scripted equivalents issue movement through the same value. */
|
|
32
|
+
setDirection(x: number, y: number): void;
|
|
33
|
+
setEnabled(enabled: boolean): void;
|
|
34
|
+
dispose(): void;
|
|
35
|
+
}
|
|
36
|
+
/** An action control to make: its input and target, and what is called when it is activated or pressed. */
|
|
37
|
+
export interface ActionControlOptions {
|
|
38
|
+
readonly input: PointerInput;
|
|
39
|
+
readonly target: DisplayObject;
|
|
40
|
+
readonly onActivate?: () => void;
|
|
41
|
+
readonly onPressChange?: (pressed: boolean) => void;
|
|
42
|
+
}
|
|
43
|
+
/** A button control: whether it is pressed, how often it was activated, and calls that press or disable it. */
|
|
44
|
+
export interface ActionControl {
|
|
45
|
+
readonly pressed: boolean;
|
|
46
|
+
readonly enabled: boolean;
|
|
47
|
+
readonly activationCount: number;
|
|
48
|
+
/** Keyboard or scripted equivalents share the pointer activation path. */
|
|
49
|
+
press(): void;
|
|
50
|
+
release(): void;
|
|
51
|
+
setEnabled(enabled: boolean): void;
|
|
52
|
+
dispose(): void;
|
|
53
|
+
}
|
|
54
|
+
/** A virtual stick on a target: dragging inside its radius gives a direction. */
|
|
55
|
+
export declare function createMovementControl(options: MovementControlOptions): MovementControl;
|
|
56
|
+
/** A button on a target: a press and release inside it activates it. */
|
|
57
|
+
export declare function createActionControl(options: ActionControlOptions): ActionControl;
|
|
58
|
+
//# sourceMappingURL=controls.d.ts.map
|
|
@@ -0,0 +1,290 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import { EgretError } from '@egret/runtime';
|
|
3
|
+
const ZERO = Object.freeze({ x: 0, y: 0 });
|
|
4
|
+
function finite(value) {
|
|
5
|
+
return typeof value === 'number' && Number.isFinite(value);
|
|
6
|
+
}
|
|
7
|
+
function checkOptions(options) {
|
|
8
|
+
if (options === null || typeof options !== 'object')
|
|
9
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
10
|
+
const { input, target } = options;
|
|
11
|
+
if (input === null || typeof input !== 'object')
|
|
12
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
13
|
+
if (target === null || typeof target !== 'object' || typeof target.on !== 'function') {
|
|
14
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
/** Clamp a scripted or keyboard direction into the control's admitted range. */
|
|
18
|
+
function direction(x, y) {
|
|
19
|
+
if (!finite(x) || !finite(y))
|
|
20
|
+
throw new EgretError('UI_CONTROL_DIRECTION');
|
|
21
|
+
const length = Math.hypot(x, y);
|
|
22
|
+
if (length === 0)
|
|
23
|
+
return ZERO;
|
|
24
|
+
const scale = length > 1 ? 1 / length : 1;
|
|
25
|
+
return Object.freeze({ x: x * scale, y: y * scale });
|
|
26
|
+
}
|
|
27
|
+
/** A virtual stick on a target: dragging inside its radius gives a direction. */
|
|
28
|
+
export function createMovementControl(options) {
|
|
29
|
+
checkOptions(options);
|
|
30
|
+
const { input, target, radius, onMovement } = options;
|
|
31
|
+
const deadZone = options.deadZone ?? radius / 10;
|
|
32
|
+
if (!finite(radius) || radius <= 0)
|
|
33
|
+
throw new EgretError('UI_CONTROL_RADIUS');
|
|
34
|
+
if (!finite(deadZone) || deadZone < 0 || deadZone >= radius)
|
|
35
|
+
throw new EgretError('UI_CONTROL_RADIUS');
|
|
36
|
+
let closed = false;
|
|
37
|
+
let enabled = true;
|
|
38
|
+
let value = ZERO;
|
|
39
|
+
let owner;
|
|
40
|
+
function publish(next) {
|
|
41
|
+
if (next.x === value.x && next.y === value.y)
|
|
42
|
+
return;
|
|
43
|
+
value = next;
|
|
44
|
+
try {
|
|
45
|
+
onMovement?.(next);
|
|
46
|
+
}
|
|
47
|
+
catch (cause) {
|
|
48
|
+
throw cause;
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
function release() {
|
|
52
|
+
owner = undefined;
|
|
53
|
+
publish(ZERO);
|
|
54
|
+
}
|
|
55
|
+
function begin(event) {
|
|
56
|
+
if (closed || !enabled)
|
|
57
|
+
return;
|
|
58
|
+
// One owning contact. A second contact is refused rather than replacing the first.
|
|
59
|
+
if (owner !== undefined)
|
|
60
|
+
return;
|
|
61
|
+
owner = { session: event.payload.session, originX: event.payload.globalX, originY: event.payload.globalY };
|
|
62
|
+
}
|
|
63
|
+
function move(event) {
|
|
64
|
+
if (closed || owner === undefined || event.payload.session !== owner.session)
|
|
65
|
+
return;
|
|
66
|
+
const dx = event.payload.globalX - owner.originX;
|
|
67
|
+
const dy = event.payload.globalY - owner.originY;
|
|
68
|
+
const distance = Math.hypot(dx, dy);
|
|
69
|
+
// Inside the dead zone the control reports rest, not a debounced direction.
|
|
70
|
+
if (distance <= deadZone) {
|
|
71
|
+
publish(ZERO);
|
|
72
|
+
return;
|
|
73
|
+
}
|
|
74
|
+
const magnitude = Math.min(1, distance / radius);
|
|
75
|
+
const scale = magnitude / distance;
|
|
76
|
+
publish(Object.freeze({ x: dx * scale, y: dy * scale }));
|
|
77
|
+
}
|
|
78
|
+
function end(event) {
|
|
79
|
+
// A refused second contact must not release the contact that owns the movement.
|
|
80
|
+
if (closed || owner === undefined || event.payload.session !== owner.session)
|
|
81
|
+
return;
|
|
82
|
+
release();
|
|
83
|
+
}
|
|
84
|
+
const subscriptions = [
|
|
85
|
+
target.on(input.events.begin, begin),
|
|
86
|
+
target.on(input.events.move, move),
|
|
87
|
+
target.on(input.events.end, end),
|
|
88
|
+
target.on(input.events.cancel, end)
|
|
89
|
+
];
|
|
90
|
+
// An invalid target receives no dispatch, so the owner-session terminal stream is the only
|
|
91
|
+
// signal that the held contact is gone.
|
|
92
|
+
const observeTerminal = input.observe(notification => {
|
|
93
|
+
if (closed || owner === undefined || notification.contact.session !== owner.session)
|
|
94
|
+
return;
|
|
95
|
+
// Retire whatever the owning session leaves behind after the dispatch attempt, whatever the
|
|
96
|
+
// destination, a stopped propagation or a routed failure did to it. An ordinary delivery has
|
|
97
|
+
// already released here from the control's own handler, so this is only the fallback.
|
|
98
|
+
if (notification.kind === 'cancel' || notification.kind === 'end')
|
|
99
|
+
release();
|
|
100
|
+
});
|
|
101
|
+
return Object.freeze({
|
|
102
|
+
get value() {
|
|
103
|
+
return value;
|
|
104
|
+
},
|
|
105
|
+
get active() {
|
|
106
|
+
return owner !== undefined;
|
|
107
|
+
},
|
|
108
|
+
get enabled() {
|
|
109
|
+
return enabled;
|
|
110
|
+
},
|
|
111
|
+
setDirection(x, y) {
|
|
112
|
+
if (closed)
|
|
113
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
114
|
+
if (!enabled) {
|
|
115
|
+
publish(ZERO);
|
|
116
|
+
return;
|
|
117
|
+
}
|
|
118
|
+
publish(direction(x, y));
|
|
119
|
+
},
|
|
120
|
+
setEnabled(next) {
|
|
121
|
+
if (closed)
|
|
122
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
123
|
+
if (enabled === next)
|
|
124
|
+
return;
|
|
125
|
+
enabled = next;
|
|
126
|
+
// Disabling a held control must not keep an action pressed.
|
|
127
|
+
if (!enabled)
|
|
128
|
+
release();
|
|
129
|
+
},
|
|
130
|
+
dispose() {
|
|
131
|
+
if (closed)
|
|
132
|
+
return;
|
|
133
|
+
closed = true;
|
|
134
|
+
let failure;
|
|
135
|
+
try {
|
|
136
|
+
release();
|
|
137
|
+
}
|
|
138
|
+
catch (cause) {
|
|
139
|
+
// Keep the control terminal: every owned subscription is still released below.
|
|
140
|
+
failure = cause;
|
|
141
|
+
}
|
|
142
|
+
finally {
|
|
143
|
+
observeTerminal();
|
|
144
|
+
for (const unsubscribe of subscriptions) {
|
|
145
|
+
try {
|
|
146
|
+
unsubscribe();
|
|
147
|
+
}
|
|
148
|
+
catch (cause) {
|
|
149
|
+
failure ??= cause;
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
if (failure !== undefined)
|
|
154
|
+
throw failure;
|
|
155
|
+
}
|
|
156
|
+
});
|
|
157
|
+
}
|
|
158
|
+
/** A button on a target: a press and release inside it activates it. */
|
|
159
|
+
export function createActionControl(options) {
|
|
160
|
+
checkOptions(options);
|
|
161
|
+
const { input, target, onActivate, onPressChange } = options;
|
|
162
|
+
let closed = false;
|
|
163
|
+
let enabled = true;
|
|
164
|
+
let candidate;
|
|
165
|
+
let held = false;
|
|
166
|
+
let activations = 0;
|
|
167
|
+
function setPressed(next) {
|
|
168
|
+
if (held === next)
|
|
169
|
+
return;
|
|
170
|
+
held = next;
|
|
171
|
+
onPressChange?.(next);
|
|
172
|
+
}
|
|
173
|
+
function begin(event) {
|
|
174
|
+
if (closed || !enabled)
|
|
175
|
+
return;
|
|
176
|
+
if (candidate !== undefined)
|
|
177
|
+
return;
|
|
178
|
+
candidate = event.payload.session;
|
|
179
|
+
setPressed(true);
|
|
180
|
+
}
|
|
181
|
+
function move(event) {
|
|
182
|
+
// The contact keeps the button pressed; a movement threshold belongs to the control owner.
|
|
183
|
+
if (closed || candidate === undefined || event.payload.session !== candidate)
|
|
184
|
+
return;
|
|
185
|
+
}
|
|
186
|
+
function end(event) {
|
|
187
|
+
if (closed || candidate === undefined || event.payload.session !== candidate)
|
|
188
|
+
return;
|
|
189
|
+
candidate = undefined;
|
|
190
|
+
setPressed(false);
|
|
191
|
+
activate();
|
|
192
|
+
}
|
|
193
|
+
function cancel(event) {
|
|
194
|
+
// The refused second contact cancelling must not clear the first one's pending activation.
|
|
195
|
+
if (closed || candidate === undefined || event.payload.session !== candidate)
|
|
196
|
+
return;
|
|
197
|
+
candidate = undefined;
|
|
198
|
+
setPressed(false);
|
|
199
|
+
}
|
|
200
|
+
function activate() {
|
|
201
|
+
if (closed || !enabled)
|
|
202
|
+
return;
|
|
203
|
+
activations += 1;
|
|
204
|
+
onActivate?.();
|
|
205
|
+
}
|
|
206
|
+
const subscriptions = [
|
|
207
|
+
target.on(input.events.begin, begin),
|
|
208
|
+
target.on(input.events.move, move),
|
|
209
|
+
target.on(input.events.end, end),
|
|
210
|
+
target.on(input.events.cancel, cancel)
|
|
211
|
+
];
|
|
212
|
+
const observeTerminal = input.observe(notification => {
|
|
213
|
+
if (closed || candidate === undefined || notification.contact.session !== candidate)
|
|
214
|
+
return;
|
|
215
|
+
// A terminal the control's own handler did not consume clears the press without activating.
|
|
216
|
+
if (notification.kind === 'cancel' || notification.kind === 'end') {
|
|
217
|
+
candidate = undefined;
|
|
218
|
+
setPressed(false);
|
|
219
|
+
}
|
|
220
|
+
});
|
|
221
|
+
return Object.freeze({
|
|
222
|
+
get pressed() {
|
|
223
|
+
return held;
|
|
224
|
+
},
|
|
225
|
+
get enabled() {
|
|
226
|
+
return enabled;
|
|
227
|
+
},
|
|
228
|
+
get activationCount() {
|
|
229
|
+
return activations;
|
|
230
|
+
},
|
|
231
|
+
press() {
|
|
232
|
+
if (closed)
|
|
233
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
234
|
+
if (!enabled)
|
|
235
|
+
return;
|
|
236
|
+
setPressed(true);
|
|
237
|
+
},
|
|
238
|
+
release() {
|
|
239
|
+
if (closed)
|
|
240
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
241
|
+
if (!enabled) {
|
|
242
|
+
setPressed(false);
|
|
243
|
+
return;
|
|
244
|
+
}
|
|
245
|
+
// A scripted release activates only if a press is outstanding; it cannot double-fire.
|
|
246
|
+
if (!held)
|
|
247
|
+
return;
|
|
248
|
+
setPressed(false);
|
|
249
|
+
activate();
|
|
250
|
+
},
|
|
251
|
+
setEnabled(next) {
|
|
252
|
+
if (closed)
|
|
253
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
254
|
+
if (enabled === next)
|
|
255
|
+
return;
|
|
256
|
+
enabled = next;
|
|
257
|
+
if (!enabled) {
|
|
258
|
+
candidate = undefined;
|
|
259
|
+
setPressed(false);
|
|
260
|
+
}
|
|
261
|
+
},
|
|
262
|
+
dispose() {
|
|
263
|
+
if (closed)
|
|
264
|
+
return;
|
|
265
|
+
closed = true;
|
|
266
|
+
candidate = undefined;
|
|
267
|
+
let failure;
|
|
268
|
+
try {
|
|
269
|
+
setPressed(false);
|
|
270
|
+
}
|
|
271
|
+
catch (cause) {
|
|
272
|
+
failure = cause;
|
|
273
|
+
}
|
|
274
|
+
finally {
|
|
275
|
+
observeTerminal();
|
|
276
|
+
for (const unsubscribe of subscriptions) {
|
|
277
|
+
try {
|
|
278
|
+
unsubscribe();
|
|
279
|
+
}
|
|
280
|
+
catch (cause) {
|
|
281
|
+
failure ??= cause;
|
|
282
|
+
}
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
if (failure !== undefined)
|
|
286
|
+
throw failure;
|
|
287
|
+
}
|
|
288
|
+
});
|
|
289
|
+
}
|
|
290
|
+
//# sourceMappingURL=controls.js.map
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
export { createUiTextEditor } from './textEditor.js';
|
|
2
|
+
export type { UiTextEditor, UiTextEditorOptions, UiTextEditorStyle, UiTextEditorChange, UiTextEditorTarget, UiTextEditorSnapshot, UiTextEditorSetOptions, TextEditSelection } from './textEditorTypes.js';
|
|
3
|
+
//# sourceMappingURL=editing.d.ts.map
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
export { createUiRoot } from './uiRoot.js';
|
|
2
|
+
export type { LayoutNode, UiInvalidationKind, UiLimits, VirtualRecord, VirtualDataSource, RowBindContext, UiLeafPrepareContext, UiLeafContent, RowBinding, RowUnbindInfo, RowRetention, UiRowPointerNotification, UiRootOptions, UiKeyboardOptions, UiPreparation, UiCommitResult, UiRowSnapshot, UiCounters, VirtualListSnapshot, UiSnapshot, VirtualListHandle, VirtualListRevealOptions, UiRoot } from './types.js';
|
|
3
|
+
export { createUiTheme, selectUiSkin } from './theme.js';
|
|
4
|
+
export type { UiTheme, UiThemeDescriptor, UiThemeTypography, UiThemeSkin, UiThemeNode, UiSkinState, UiSkinStateName } from './theme.js';
|
|
5
|
+
export { createMovementControl, createActionControl } from './controls.js';
|
|
6
|
+
export type { MovementValue, MovementControl, MovementControlOptions, ActionControl, ActionControlOptions } from './controls.js';
|
|
7
|
+
export { createHoverControl, createToggleControl, createSelectionGroup } from './stateControls.js';
|
|
8
|
+
export type { HoverControl, HoverControlOptions, ToggleControl, ToggleControlOptions, SelectionItem, SelectionGroup, SelectionGroupOptions } from './stateControls.js';
|
|
9
|
+
export { createScrollControl } from './scrollControl.js';
|
|
10
|
+
export type { ScrollAxis, ScrollControl, ScrollControlOptions, ScrollThumb, ScrollThumbOptions, ScrollWheelOptions } from './scrollControl.js';
|
|
11
|
+
export { createTextFieldControl } from './textFieldControl.js';
|
|
12
|
+
export type { TextFieldChange, TextFieldControl, TextFieldControlOptions, TextFieldEditor, TextFieldRectangle, TextFieldSession } from './textFieldControl.js';
|
|
13
|
+
export { createRangeControl } from './rangeControl.js';
|
|
14
|
+
export type { RangeAxis, RangeControl, RangeControlOptions } from './rangeControl.js';
|
|
15
|
+
export { createControlKeys } from './controlKeys.js';
|
|
16
|
+
export type { ActionKeysOptions, ControlKeys, ControlKeysOptions, ControlKeysSource, MovementKeysOptions, RangeKeysOptions, ScrollKeysOptions, SelectionKeysOptions, TextFieldKeysOptions, ToggleKeysOptions } from './controlKeys.js';
|
|
17
|
+
export { createUiLayerManager } from './layers.js';
|
|
18
|
+
export type { UiLayerTarget, UiLayerAnchor, UiLayerManagerOptions, UiLayerOptions, UiLayerRegistration, UiLayerCommitResult, UiLayerSnapshot, UiLayerManager } from './layerTypes.js';
|
|
19
|
+
//# sourceMappingURL=index.d.ts.map
|
package/dist/ui/index.js
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
export { createUiRoot } from './uiRoot.js';
|
|
3
|
+
export { createUiTheme, selectUiSkin } from './theme.js';
|
|
4
|
+
export { createMovementControl, createActionControl } from './controls.js';
|
|
5
|
+
export { createHoverControl, createToggleControl, createSelectionGroup } from './stateControls.js';
|
|
6
|
+
export { createScrollControl } from './scrollControl.js';
|
|
7
|
+
export { createTextFieldControl } from './textFieldControl.js';
|
|
8
|
+
export { createRangeControl } from './rangeControl.js';
|
|
9
|
+
export { createControlKeys } from './controlKeys.js';
|
|
10
|
+
export { createUiLayerManager } from './layers.js';
|
|
11
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { DisplayObjectContainer } from '@egret/runtime';
|
|
2
|
+
import type { KeyboardInput, KeyboardFocusOptions } from '../keyboardInputTypes.js';
|
|
3
|
+
export interface KeyboardRow {
|
|
4
|
+
readonly key: string;
|
|
5
|
+
readonly content: DisplayObjectContainer;
|
|
6
|
+
readonly visible: boolean;
|
|
7
|
+
}
|
|
8
|
+
/**
|
|
9
|
+
* Owns registrations only. The application retains the channel and its native bridge.
|
|
10
|
+
*
|
|
11
|
+
* Without `tabStop` every row that shows is a stop of its own, in the order of the rows. With it
|
|
12
|
+
* the rows are one stop of that index: Tab enters at the row that last held the focus, or at the
|
|
13
|
+
* first that shows, and leaves the list from there.
|
|
14
|
+
*/
|
|
15
|
+
export declare function createUiKeyboardFocus(input: KeyboardInput, prefix: string, tabStop?: number): Readonly<{
|
|
16
|
+
validate: (keys: Iterable<string>) => void;
|
|
17
|
+
getFocus: () => Readonly<{
|
|
18
|
+
key: string | undefined;
|
|
19
|
+
focusVisible: boolean;
|
|
20
|
+
}>;
|
|
21
|
+
focus: (key: string | undefined, options?: KeyboardFocusOptions) => void;
|
|
22
|
+
before: (rows: readonly KeyboardRow[]) => Readonly<{
|
|
23
|
+
key: string | undefined;
|
|
24
|
+
focusVisible: boolean;
|
|
25
|
+
}> | undefined;
|
|
26
|
+
commit: (rows: readonly KeyboardRow[], restore: ReturnType<(rows: readonly KeyboardRow[]) => Readonly<{
|
|
27
|
+
key: string | undefined;
|
|
28
|
+
focusVisible: boolean;
|
|
29
|
+
}> | undefined>) => void;
|
|
30
|
+
dispose: () => void;
|
|
31
|
+
}>;
|
|
32
|
+
//# sourceMappingURL=keyboardFocus.d.ts.map
|