@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,90 @@
|
|
|
1
|
+
import type { DisplayObject } from '@egret/runtime';
|
|
2
|
+
import type { HoverInput } from '../hoverInputTypes.js';
|
|
3
|
+
import type { PointerInput } from '../pointerInputTypes.js';
|
|
4
|
+
/**
|
|
5
|
+
* Hover, toggle and single-selection state for controls an application draws itself.
|
|
6
|
+
*
|
|
7
|
+
* Like the movement and action controls these own state only. They add no host listener and draw
|
|
8
|
+
* nothing: the application paints each state, and binds keys to the same methods a pointer reaches.
|
|
9
|
+
*/
|
|
10
|
+
export interface HoverControlOptions {
|
|
11
|
+
readonly hover: HoverInput;
|
|
12
|
+
/** The surface of the control. A pointer over it or over one of its descendants hovers it. */
|
|
13
|
+
readonly target: DisplayObject;
|
|
14
|
+
readonly onHoverChange?: (hovered: boolean) => void;
|
|
15
|
+
}
|
|
16
|
+
/** Whether a pointer hovers over a target; dispose of it to stop. */
|
|
17
|
+
export interface HoverControl {
|
|
18
|
+
/** Whether an enabled control has a pointer over it. */
|
|
19
|
+
readonly hovered: boolean;
|
|
20
|
+
readonly enabled: boolean;
|
|
21
|
+
setEnabled(enabled: boolean): void;
|
|
22
|
+
dispose(): void;
|
|
23
|
+
}
|
|
24
|
+
/** A toggle to make: its input and target, whether it starts checked, and what it calls. */
|
|
25
|
+
export interface ToggleControlOptions {
|
|
26
|
+
readonly input: PointerInput;
|
|
27
|
+
readonly target: DisplayObject;
|
|
28
|
+
/** The value it starts with. Defaults to false. */
|
|
29
|
+
readonly checked?: boolean;
|
|
30
|
+
readonly onChange?: (checked: boolean) => void;
|
|
31
|
+
readonly onPressChange?: (pressed: boolean) => void;
|
|
32
|
+
}
|
|
33
|
+
/** A checkbox or switch: whether it is checked and pressed, and calls that toggle or set it. */
|
|
34
|
+
export interface ToggleControl {
|
|
35
|
+
readonly checked: boolean;
|
|
36
|
+
readonly pressed: boolean;
|
|
37
|
+
readonly enabled: boolean;
|
|
38
|
+
/** One activation, as a completed press is: the value flips and the change is reported. */
|
|
39
|
+
toggle(): void;
|
|
40
|
+
/** Sets the value without an activation. A change is reported only when the value differs. */
|
|
41
|
+
setChecked(checked: boolean): void;
|
|
42
|
+
/** Keyboard or scripted equivalents share the pointer activation path. */
|
|
43
|
+
press(): void;
|
|
44
|
+
release(): void;
|
|
45
|
+
setEnabled(enabled: boolean): void;
|
|
46
|
+
dispose(): void;
|
|
47
|
+
}
|
|
48
|
+
/** One item of a selection group: its key, its target and whether it can be chosen. */
|
|
49
|
+
export interface SelectionItem {
|
|
50
|
+
readonly key: string;
|
|
51
|
+
readonly target: DisplayObject;
|
|
52
|
+
/** Defaults to true. A disabled item is skipped by movement and refuses a press. */
|
|
53
|
+
readonly enabled?: boolean;
|
|
54
|
+
}
|
|
55
|
+
/** A selection group to make: its input and items, the one selected, whether it wraps, and what it calls. */
|
|
56
|
+
export interface SelectionGroupOptions {
|
|
57
|
+
readonly input: PointerInput;
|
|
58
|
+
/** One to 256 items with distinct keys and distinct targets, in the order movement follows. */
|
|
59
|
+
readonly items: readonly SelectionItem[];
|
|
60
|
+
/** The key selected at first. Without it nothing is selected until an item is chosen. */
|
|
61
|
+
readonly selected?: string;
|
|
62
|
+
/** Whether movement past either end continues at the other. Defaults to true. */
|
|
63
|
+
readonly wrap?: boolean;
|
|
64
|
+
readonly onChange?: (selected: string, previous: string | undefined) => void;
|
|
65
|
+
}
|
|
66
|
+
/** One of several: a radio group, a segmented control, or a listbox with a single selection. */
|
|
67
|
+
export interface SelectionGroup {
|
|
68
|
+
readonly selected: string | undefined;
|
|
69
|
+
readonly keys: readonly string[];
|
|
70
|
+
readonly enabled: boolean;
|
|
71
|
+
/** Selects an enabled item. Returns whether the selection changed. */
|
|
72
|
+
select(key: string): boolean;
|
|
73
|
+
/** Move the selection among the enabled items. Each returns whether it changed. */
|
|
74
|
+
next(): boolean;
|
|
75
|
+
previous(): boolean;
|
|
76
|
+
first(): boolean;
|
|
77
|
+
last(): boolean;
|
|
78
|
+
isItemEnabled(key: string): boolean;
|
|
79
|
+
/** A disabled item that is selected stays selected. */
|
|
80
|
+
setItemEnabled(key: string, enabled: boolean): void;
|
|
81
|
+
setEnabled(enabled: boolean): void;
|
|
82
|
+
dispose(): void;
|
|
83
|
+
}
|
|
84
|
+
/** Tells whether a pointer hovers over a target. */
|
|
85
|
+
export declare function createHoverControl(options: HoverControlOptions): HoverControl;
|
|
86
|
+
/** A checkbox or switch on a target: a press and release inside it toggles it. */
|
|
87
|
+
export declare function createToggleControl(options: ToggleControlOptions): ToggleControl;
|
|
88
|
+
/** Radio buttons or tabs: one item of the group is selected at a time. */
|
|
89
|
+
export declare function createSelectionGroup(options: SelectionGroupOptions): SelectionGroup;
|
|
90
|
+
//# sourceMappingURL=stateControls.d.ts.map
|
|
@@ -0,0 +1,331 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import { EgretError } from '@egret/runtime';
|
|
3
|
+
import { createActionControl } from './controls.js';
|
|
4
|
+
const MAX_DEPTH = 4096;
|
|
5
|
+
function record(options) {
|
|
6
|
+
if (options === null || typeof options !== 'object' || Array.isArray(options))
|
|
7
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
8
|
+
return options;
|
|
9
|
+
}
|
|
10
|
+
function displayTarget(value) {
|
|
11
|
+
if (value === null || typeof value !== 'object' || typeof value.on !== 'function')
|
|
12
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
13
|
+
return value;
|
|
14
|
+
}
|
|
15
|
+
function callback(value) {
|
|
16
|
+
if (value !== undefined && typeof value !== 'function')
|
|
17
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
18
|
+
return value;
|
|
19
|
+
}
|
|
20
|
+
/** Whether a display object is the root of a subtree or inside it. */
|
|
21
|
+
function within(root, node) {
|
|
22
|
+
let current = node;
|
|
23
|
+
for (let depth = 0; current !== undefined && depth < MAX_DEPTH; depth++) {
|
|
24
|
+
if (current === root)
|
|
25
|
+
return true;
|
|
26
|
+
current = current.parent;
|
|
27
|
+
}
|
|
28
|
+
return false;
|
|
29
|
+
}
|
|
30
|
+
/** Tells whether a pointer hovers over a target. */
|
|
31
|
+
export function createHoverControl(options) {
|
|
32
|
+
const { hover, onHoverChange } = record(options);
|
|
33
|
+
const target = displayTarget(options.target);
|
|
34
|
+
if (hover === null ||
|
|
35
|
+
typeof hover !== 'object' ||
|
|
36
|
+
typeof hover.observe !== 'function' ||
|
|
37
|
+
hover.events === null ||
|
|
38
|
+
typeof hover.events !== 'object')
|
|
39
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
40
|
+
callback(onHoverChange);
|
|
41
|
+
// The pointers that are over the control or over one of its descendants.
|
|
42
|
+
const inside = new Set();
|
|
43
|
+
let closed = false, enabled = true, reported = false;
|
|
44
|
+
function publish() {
|
|
45
|
+
const next = enabled && !closed && inside.size > 0;
|
|
46
|
+
if (next === reported)
|
|
47
|
+
return;
|
|
48
|
+
reported = next;
|
|
49
|
+
onHoverChange?.(next);
|
|
50
|
+
}
|
|
51
|
+
const subscriptions = [
|
|
52
|
+
target.on(hover.events.enter, event => {
|
|
53
|
+
if (closed)
|
|
54
|
+
return;
|
|
55
|
+
inside.add(event.payload.pointerId);
|
|
56
|
+
publish();
|
|
57
|
+
}),
|
|
58
|
+
// A pointer that goes from one descendant to another has not left the control.
|
|
59
|
+
target.on(hover.events.leave, event => {
|
|
60
|
+
if (closed || within(target, event.payload.related))
|
|
61
|
+
return;
|
|
62
|
+
inside.delete(event.payload.pointerId);
|
|
63
|
+
publish();
|
|
64
|
+
}),
|
|
65
|
+
// A target that has left the stage receives no event. The stream of the input still says its hover ended.
|
|
66
|
+
hover.observe(notification => {
|
|
67
|
+
if (closed ||
|
|
68
|
+
notification.kind !== 'leave' ||
|
|
69
|
+
!inside.has(notification.point.pointerId) ||
|
|
70
|
+
within(target, notification.related))
|
|
71
|
+
return;
|
|
72
|
+
inside.delete(notification.point.pointerId);
|
|
73
|
+
publish();
|
|
74
|
+
})
|
|
75
|
+
];
|
|
76
|
+
return Object.freeze({
|
|
77
|
+
get hovered() {
|
|
78
|
+
return reported;
|
|
79
|
+
},
|
|
80
|
+
get enabled() {
|
|
81
|
+
return enabled;
|
|
82
|
+
},
|
|
83
|
+
setEnabled(next) {
|
|
84
|
+
if (closed)
|
|
85
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
86
|
+
if (typeof next !== 'boolean')
|
|
87
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
88
|
+
if (enabled === next)
|
|
89
|
+
return;
|
|
90
|
+
// The pointer may still be over a disabled control; enabling it again finds it there.
|
|
91
|
+
enabled = next;
|
|
92
|
+
publish();
|
|
93
|
+
},
|
|
94
|
+
dispose() {
|
|
95
|
+
if (closed)
|
|
96
|
+
return;
|
|
97
|
+
closed = true;
|
|
98
|
+
let failure;
|
|
99
|
+
try {
|
|
100
|
+
publish();
|
|
101
|
+
}
|
|
102
|
+
catch (cause) {
|
|
103
|
+
failure = cause;
|
|
104
|
+
}
|
|
105
|
+
finally {
|
|
106
|
+
inside.clear();
|
|
107
|
+
for (const unsubscribe of subscriptions)
|
|
108
|
+
try {
|
|
109
|
+
unsubscribe();
|
|
110
|
+
}
|
|
111
|
+
catch (cause) {
|
|
112
|
+
failure ??= cause;
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
if (failure !== undefined)
|
|
116
|
+
throw failure;
|
|
117
|
+
}
|
|
118
|
+
});
|
|
119
|
+
}
|
|
120
|
+
/** A checkbox or switch on a target: a press and release inside it toggles it. */
|
|
121
|
+
export function createToggleControl(options) {
|
|
122
|
+
const { input, target, onChange, onPressChange } = record(options);
|
|
123
|
+
let checked = options.checked ?? false;
|
|
124
|
+
if (typeof checked !== 'boolean')
|
|
125
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
126
|
+
callback(onChange);
|
|
127
|
+
callback(onPressChange);
|
|
128
|
+
function set(next) {
|
|
129
|
+
if (checked === next)
|
|
130
|
+
return;
|
|
131
|
+
checked = next;
|
|
132
|
+
onChange?.(next);
|
|
133
|
+
}
|
|
134
|
+
const action = createActionControl({
|
|
135
|
+
input,
|
|
136
|
+
target,
|
|
137
|
+
onActivate: () => set(!checked),
|
|
138
|
+
...(onPressChange === undefined ? {} : { onPressChange })
|
|
139
|
+
});
|
|
140
|
+
let closed = false;
|
|
141
|
+
function open() {
|
|
142
|
+
if (closed)
|
|
143
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
144
|
+
}
|
|
145
|
+
return Object.freeze({
|
|
146
|
+
get checked() {
|
|
147
|
+
return checked;
|
|
148
|
+
},
|
|
149
|
+
get pressed() {
|
|
150
|
+
return action.pressed;
|
|
151
|
+
},
|
|
152
|
+
get enabled() {
|
|
153
|
+
return action.enabled;
|
|
154
|
+
},
|
|
155
|
+
toggle() {
|
|
156
|
+
open();
|
|
157
|
+
if (action.enabled)
|
|
158
|
+
set(!checked);
|
|
159
|
+
},
|
|
160
|
+
setChecked(next) {
|
|
161
|
+
open();
|
|
162
|
+
if (typeof next !== 'boolean')
|
|
163
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
164
|
+
set(next);
|
|
165
|
+
},
|
|
166
|
+
press() {
|
|
167
|
+
action.press();
|
|
168
|
+
},
|
|
169
|
+
release() {
|
|
170
|
+
action.release();
|
|
171
|
+
},
|
|
172
|
+
setEnabled(next) {
|
|
173
|
+
if (typeof next !== 'boolean')
|
|
174
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
175
|
+
action.setEnabled(next);
|
|
176
|
+
},
|
|
177
|
+
dispose() {
|
|
178
|
+
closed = true;
|
|
179
|
+
action.dispose();
|
|
180
|
+
}
|
|
181
|
+
});
|
|
182
|
+
}
|
|
183
|
+
/** Radio buttons or tabs: one item of the group is selected at a time. */
|
|
184
|
+
export function createSelectionGroup(options) {
|
|
185
|
+
const { input, onChange } = record(options);
|
|
186
|
+
const { items, wrap = true } = options;
|
|
187
|
+
callback(onChange);
|
|
188
|
+
if (!Array.isArray(items) || items.length < 1 || items.length > 256 || typeof wrap !== 'boolean')
|
|
189
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
190
|
+
const entries = [], byKey = new Map(), targets = new Set();
|
|
191
|
+
for (const item of items) {
|
|
192
|
+
const { key, enabled: itemEnabled = true } = record(item), target = displayTarget(item.target);
|
|
193
|
+
if (typeof key !== 'string' ||
|
|
194
|
+
key.length < 1 ||
|
|
195
|
+
key.length > 128 ||
|
|
196
|
+
byKey.has(key) ||
|
|
197
|
+
targets.has(target) ||
|
|
198
|
+
typeof itemEnabled !== 'boolean')
|
|
199
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
200
|
+
const entry = { key, target, enabled: itemEnabled, action: undefined };
|
|
201
|
+
entries.push(entry);
|
|
202
|
+
byKey.set(key, entry);
|
|
203
|
+
targets.add(target);
|
|
204
|
+
}
|
|
205
|
+
let selected;
|
|
206
|
+
if (options.selected !== undefined) {
|
|
207
|
+
selected = byKey.get(options.selected);
|
|
208
|
+
if (selected === undefined)
|
|
209
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
210
|
+
}
|
|
211
|
+
const keys = Object.freeze(entries.map(entry => entry.key));
|
|
212
|
+
let closed = false, enabled = true;
|
|
213
|
+
function open() {
|
|
214
|
+
if (closed)
|
|
215
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
216
|
+
}
|
|
217
|
+
function known(key) {
|
|
218
|
+
const entry = byKey.get(key);
|
|
219
|
+
if (entry === undefined)
|
|
220
|
+
throw new EgretError('UI_CONTROL_UNKNOWN_ITEM');
|
|
221
|
+
return entry;
|
|
222
|
+
}
|
|
223
|
+
function choose(entry) {
|
|
224
|
+
if (entry === undefined || entry === selected || !enabled || !entry.enabled)
|
|
225
|
+
return false;
|
|
226
|
+
const previous = selected;
|
|
227
|
+
selected = entry;
|
|
228
|
+
onChange?.(entry.key, previous?.key);
|
|
229
|
+
return true;
|
|
230
|
+
}
|
|
231
|
+
/** The nearest enabled item from a position, in one direction. */
|
|
232
|
+
function seek(from, step) {
|
|
233
|
+
for (let count = 0, index = from; count < entries.length; count++, index += step) {
|
|
234
|
+
if (index < 0 || index >= entries.length) {
|
|
235
|
+
if (!wrap)
|
|
236
|
+
return undefined;
|
|
237
|
+
index = (index + entries.length) % entries.length;
|
|
238
|
+
}
|
|
239
|
+
if (entries[index].enabled)
|
|
240
|
+
return entries[index];
|
|
241
|
+
}
|
|
242
|
+
return undefined;
|
|
243
|
+
}
|
|
244
|
+
function move(step) {
|
|
245
|
+
open();
|
|
246
|
+
// With nothing selected, movement starts at the end it is leaving from.
|
|
247
|
+
if (selected === undefined)
|
|
248
|
+
return choose(seek(step === 1 ? 0 : entries.length - 1, step));
|
|
249
|
+
return choose(seek(entries.indexOf(selected) + step, step));
|
|
250
|
+
}
|
|
251
|
+
try {
|
|
252
|
+
// Each item takes its press through an action control; whether the press may select is decided in one place, above.
|
|
253
|
+
for (const entry of entries)
|
|
254
|
+
entry.action = createActionControl({
|
|
255
|
+
input,
|
|
256
|
+
target: entry.target,
|
|
257
|
+
onActivate: () => {
|
|
258
|
+
choose(entry);
|
|
259
|
+
}
|
|
260
|
+
});
|
|
261
|
+
}
|
|
262
|
+
catch (cause) {
|
|
263
|
+
for (const entry of entries)
|
|
264
|
+
try {
|
|
265
|
+
entry.action?.dispose();
|
|
266
|
+
}
|
|
267
|
+
catch {
|
|
268
|
+
/* the first failure is the one reported */
|
|
269
|
+
}
|
|
270
|
+
throw cause;
|
|
271
|
+
}
|
|
272
|
+
return Object.freeze({
|
|
273
|
+
get selected() {
|
|
274
|
+
return selected?.key;
|
|
275
|
+
},
|
|
276
|
+
keys,
|
|
277
|
+
get enabled() {
|
|
278
|
+
return enabled;
|
|
279
|
+
},
|
|
280
|
+
select(key) {
|
|
281
|
+
open();
|
|
282
|
+
return choose(known(key));
|
|
283
|
+
},
|
|
284
|
+
next() {
|
|
285
|
+
return move(1);
|
|
286
|
+
},
|
|
287
|
+
previous() {
|
|
288
|
+
return move(-1);
|
|
289
|
+
},
|
|
290
|
+
first() {
|
|
291
|
+
open();
|
|
292
|
+
return choose(seek(0, 1));
|
|
293
|
+
},
|
|
294
|
+
last() {
|
|
295
|
+
open();
|
|
296
|
+
return choose(seek(entries.length - 1, -1));
|
|
297
|
+
},
|
|
298
|
+
isItemEnabled(key) {
|
|
299
|
+
return known(key).enabled;
|
|
300
|
+
},
|
|
301
|
+
setItemEnabled(key, next) {
|
|
302
|
+
open();
|
|
303
|
+
const entry = known(key);
|
|
304
|
+
if (typeof next !== 'boolean')
|
|
305
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
306
|
+
entry.enabled = next;
|
|
307
|
+
},
|
|
308
|
+
setEnabled(next) {
|
|
309
|
+
open();
|
|
310
|
+
if (typeof next !== 'boolean')
|
|
311
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
312
|
+
enabled = next;
|
|
313
|
+
},
|
|
314
|
+
dispose() {
|
|
315
|
+
if (closed)
|
|
316
|
+
return;
|
|
317
|
+
closed = true;
|
|
318
|
+
let failure;
|
|
319
|
+
for (const entry of entries)
|
|
320
|
+
try {
|
|
321
|
+
entry.action.dispose();
|
|
322
|
+
}
|
|
323
|
+
catch (cause) {
|
|
324
|
+
failure ??= cause;
|
|
325
|
+
}
|
|
326
|
+
if (failure !== undefined)
|
|
327
|
+
throw failure;
|
|
328
|
+
}
|
|
329
|
+
});
|
|
330
|
+
}
|
|
331
|
+
//# sourceMappingURL=stateControls.js.map
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import type { TextEditState, TextEditSession, TextEditSample, TextEditResult } from '@egret/runtime/ui/editing';
|
|
2
|
+
import type { ParagraphTextGeometry } from '@egret/runtime/paragraph';
|
|
3
|
+
import type { UiRootAccess } from '../internal/uiRootState.js';
|
|
4
|
+
import type { UiRoot } from './types.js';
|
|
5
|
+
import type { UiTextEditor, UiTextEditorOptions, UiTextEditorStyle, UiTextEditorTarget } from './textEditorTypes.js';
|
|
6
|
+
export interface EditorLogicalBox {
|
|
7
|
+
readonly x: number;
|
|
8
|
+
readonly y: number;
|
|
9
|
+
readonly width: number;
|
|
10
|
+
readonly height: number;
|
|
11
|
+
}
|
|
12
|
+
export interface EditorPresentation {
|
|
13
|
+
readonly contentRevision: number;
|
|
14
|
+
readonly source: string;
|
|
15
|
+
readonly style: UiTextEditorStyle;
|
|
16
|
+
readonly geometry: ParagraphTextGeometry | undefined;
|
|
17
|
+
readonly box: EditorLogicalBox;
|
|
18
|
+
readonly clip: EditorLogicalBox;
|
|
19
|
+
readonly scaleX: number;
|
|
20
|
+
readonly scaleY: number;
|
|
21
|
+
readonly localWidth: number;
|
|
22
|
+
readonly localHeight: number;
|
|
23
|
+
readonly rowVisible: boolean;
|
|
24
|
+
}
|
|
25
|
+
interface HostHooks {
|
|
26
|
+
changed(): void;
|
|
27
|
+
dispose(): void;
|
|
28
|
+
viewRetired(): void;
|
|
29
|
+
}
|
|
30
|
+
export interface TextEditorHostPort {
|
|
31
|
+
readonly engine: object;
|
|
32
|
+
readonly mode: UiTextEditor['mode'];
|
|
33
|
+
readonly maxLength: number;
|
|
34
|
+
snapshot(): ReturnType<TextEditState['snapshot']>;
|
|
35
|
+
contentRevision(): number;
|
|
36
|
+
style(): UiTextEditorStyle;
|
|
37
|
+
begin(): TextEditSession;
|
|
38
|
+
observe(session: TextEditSession, revision: number, sample: TextEditSample): TextEditResult;
|
|
39
|
+
compositionStart(session: TextEditSession, revision: number): boolean;
|
|
40
|
+
compositionUpdate(session: TextEditSession, revision: number, sample: TextEditSample): boolean;
|
|
41
|
+
compositionEnd(session: TextEditSession, revision: number, sample: TextEditSample): TextEditResult;
|
|
42
|
+
end(session: TextEditSession, revision: number, how: 'commit' | 'cancel', sample?: TextEditSample): TextEditResult;
|
|
43
|
+
root(root: UiRoot): UiRootAccess;
|
|
44
|
+
presentation(root: UiRootAccess, target: UiTextEditorTarget): EditorPresentation | undefined;
|
|
45
|
+
showNative(value: boolean): void;
|
|
46
|
+
setStyle(style: UiTextEditorStyle): void;
|
|
47
|
+
release(): void;
|
|
48
|
+
}
|
|
49
|
+
/** Browser-only package alias; the public UI entry never exposes native session operations. */
|
|
50
|
+
export declare function bindTextEditorHost(editor: UiTextEditor, hooks: HostHooks): TextEditorHostPort;
|
|
51
|
+
/** A text editor drawn by the engine, its text and selection kept by the platform's text input. */
|
|
52
|
+
export declare function createUiTextEditor(options: UiTextEditorOptions): UiTextEditor;
|
|
53
|
+
export { requireUiEngine as requireEditorEngine } from '../internal/uiFactoryState.js';
|
|
54
|
+
//# sourceMappingURL=textEditor.d.ts.map
|