@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,260 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import { EgretError } from '@egret/runtime';
|
|
3
|
+
import { createActionControl } from './controls.js';
|
|
4
|
+
const finite = (value) => typeof value === 'number' && Number.isFinite(value);
|
|
5
|
+
/** The first `limit` code points of a text. A pair of surrogates is never split. */
|
|
6
|
+
function clip(text, limit) {
|
|
7
|
+
if (limit === undefined || text.length <= limit)
|
|
8
|
+
return text;
|
|
9
|
+
let count = 0, index = 0;
|
|
10
|
+
for (const character of text) {
|
|
11
|
+
if (count === limit)
|
|
12
|
+
break;
|
|
13
|
+
count++;
|
|
14
|
+
index += character.length;
|
|
15
|
+
}
|
|
16
|
+
return text.slice(0, index);
|
|
17
|
+
}
|
|
18
|
+
/** A text field on a target: pressing it opens the platform's editing, and the value is committed or cancelled. */
|
|
19
|
+
export function createTextFieldControl(options) {
|
|
20
|
+
if (options === null || typeof options !== 'object')
|
|
21
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
22
|
+
const { input, target, editor, field, multiline = false, password = false, maxLength, placeholder, label, onChange, onInput, onEditingChange, onPressChange } = options;
|
|
23
|
+
const initial = options.value ?? '';
|
|
24
|
+
if (editor === null ||
|
|
25
|
+
typeof editor !== 'object' ||
|
|
26
|
+
typeof editor.open !== 'function' ||
|
|
27
|
+
typeof editor.commit !== 'function' ||
|
|
28
|
+
typeof editor.cancel !== 'function' ||
|
|
29
|
+
typeof editor.setValue !== 'function' ||
|
|
30
|
+
typeof field !== 'function' ||
|
|
31
|
+
typeof initial !== 'string' ||
|
|
32
|
+
typeof multiline !== 'boolean' ||
|
|
33
|
+
typeof password !== 'boolean' ||
|
|
34
|
+
(password && multiline) ||
|
|
35
|
+
(maxLength !== undefined && (!Number.isSafeInteger(maxLength) || maxLength < 1)) ||
|
|
36
|
+
(placeholder !== undefined && typeof placeholder !== 'string') ||
|
|
37
|
+
(label !== undefined && typeof label !== 'string') ||
|
|
38
|
+
[onChange, onInput, onEditingChange, onPressChange].some(callback => callback !== undefined && typeof callback !== 'function'))
|
|
39
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
40
|
+
let value = clip(initial, maxLength), draft = value, composing = false, closed = false;
|
|
41
|
+
/** The open session. A callback of an earlier one finds another token here and does nothing. */
|
|
42
|
+
let session, announced = false;
|
|
43
|
+
function assign(next) {
|
|
44
|
+
if (next === value)
|
|
45
|
+
return;
|
|
46
|
+
const previous = value;
|
|
47
|
+
value = next;
|
|
48
|
+
onChange?.(next, previous);
|
|
49
|
+
}
|
|
50
|
+
/** The one end of a session: the field is gone, and then the text is the application's. */
|
|
51
|
+
function finish(token, committed) {
|
|
52
|
+
if (session !== token)
|
|
53
|
+
return;
|
|
54
|
+
session = undefined;
|
|
55
|
+
composing = false;
|
|
56
|
+
const next = committed === undefined ? value : clip(committed, maxLength);
|
|
57
|
+
draft = next;
|
|
58
|
+
let failure, failed = false;
|
|
59
|
+
// An edit that was never reported as begun is not reported as ended.
|
|
60
|
+
if (announced) {
|
|
61
|
+
announced = false;
|
|
62
|
+
try {
|
|
63
|
+
onEditingChange?.(false);
|
|
64
|
+
}
|
|
65
|
+
catch (cause) {
|
|
66
|
+
failure = cause;
|
|
67
|
+
failed = true;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
// The text is kept even when the listener of the edit failed.
|
|
71
|
+
if (!closed)
|
|
72
|
+
assign(next);
|
|
73
|
+
if (failed)
|
|
74
|
+
throw failure;
|
|
75
|
+
}
|
|
76
|
+
function begin() {
|
|
77
|
+
if (closed)
|
|
78
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
79
|
+
if (!action.enabled || session !== undefined)
|
|
80
|
+
return false;
|
|
81
|
+
const presentation = field();
|
|
82
|
+
if (presentation === null ||
|
|
83
|
+
typeof presentation !== 'object' ||
|
|
84
|
+
!finite(presentation.x) ||
|
|
85
|
+
!finite(presentation.y) ||
|
|
86
|
+
!finite(presentation.width) ||
|
|
87
|
+
!finite(presentation.height) ||
|
|
88
|
+
presentation.width <= 0 ||
|
|
89
|
+
presentation.height <= 0)
|
|
90
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
91
|
+
const token = {};
|
|
92
|
+
// Between edits the draft is the value and nothing is being composed.
|
|
93
|
+
session = token;
|
|
94
|
+
try {
|
|
95
|
+
editor.open({
|
|
96
|
+
...presentation,
|
|
97
|
+
value,
|
|
98
|
+
multiline,
|
|
99
|
+
password,
|
|
100
|
+
...(maxLength === undefined ? {} : { maxLength }),
|
|
101
|
+
...(placeholder === undefined ? {} : { placeholder }),
|
|
102
|
+
...(label === undefined ? {} : { label }),
|
|
103
|
+
onChange(change) {
|
|
104
|
+
if (session !== token || change === null || typeof change !== 'object' || typeof change.value !== 'string')
|
|
105
|
+
return;
|
|
106
|
+
draft = change.value;
|
|
107
|
+
composing = change.composing === true;
|
|
108
|
+
onInput?.(Object.freeze({ value: draft, composing }));
|
|
109
|
+
},
|
|
110
|
+
onCommit(committed) {
|
|
111
|
+
finish(token, typeof committed === 'string' ? committed : draft);
|
|
112
|
+
},
|
|
113
|
+
onCancel() {
|
|
114
|
+
finish(token, undefined);
|
|
115
|
+
}
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
catch (cause) {
|
|
119
|
+
// An editor that refused shows nothing: the field is as it was before the press.
|
|
120
|
+
if (session === token)
|
|
121
|
+
session = undefined;
|
|
122
|
+
throw cause;
|
|
123
|
+
}
|
|
124
|
+
// An editor may end the session before it returns. Only one that is still open is reported.
|
|
125
|
+
if (session !== token)
|
|
126
|
+
return false;
|
|
127
|
+
announced = true;
|
|
128
|
+
onEditingChange?.(true);
|
|
129
|
+
return session === token;
|
|
130
|
+
}
|
|
131
|
+
const action = createActionControl({
|
|
132
|
+
input,
|
|
133
|
+
target,
|
|
134
|
+
onActivate: () => {
|
|
135
|
+
begin();
|
|
136
|
+
},
|
|
137
|
+
...(onPressChange === undefined ? {} : { onPressChange })
|
|
138
|
+
});
|
|
139
|
+
/** Ends an open session through its editor, which answers with the callback of that session. */
|
|
140
|
+
function end(keep) {
|
|
141
|
+
const token = session;
|
|
142
|
+
if (token === undefined)
|
|
143
|
+
return;
|
|
144
|
+
let failure, failed = false;
|
|
145
|
+
try {
|
|
146
|
+
if (keep)
|
|
147
|
+
editor.commit();
|
|
148
|
+
else
|
|
149
|
+
editor.cancel();
|
|
150
|
+
}
|
|
151
|
+
catch (cause) {
|
|
152
|
+
failure = cause;
|
|
153
|
+
failed = true;
|
|
154
|
+
}
|
|
155
|
+
// An editor that did not answer, or failed, is not waited for: the control is no longer editing.
|
|
156
|
+
try {
|
|
157
|
+
finish(token, keep && !failed ? draft : undefined);
|
|
158
|
+
}
|
|
159
|
+
catch (cause) {
|
|
160
|
+
if (!failed) {
|
|
161
|
+
failure = cause;
|
|
162
|
+
failed = true;
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
if (failed)
|
|
166
|
+
throw failure;
|
|
167
|
+
}
|
|
168
|
+
return Object.freeze({
|
|
169
|
+
get value() {
|
|
170
|
+
return value;
|
|
171
|
+
},
|
|
172
|
+
get draft() {
|
|
173
|
+
return draft;
|
|
174
|
+
},
|
|
175
|
+
get composing() {
|
|
176
|
+
return composing;
|
|
177
|
+
},
|
|
178
|
+
get editing() {
|
|
179
|
+
return session !== undefined;
|
|
180
|
+
},
|
|
181
|
+
get pressed() {
|
|
182
|
+
return action.pressed;
|
|
183
|
+
},
|
|
184
|
+
get enabled() {
|
|
185
|
+
return action.enabled;
|
|
186
|
+
},
|
|
187
|
+
edit: begin,
|
|
188
|
+
commit() {
|
|
189
|
+
if (closed)
|
|
190
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
191
|
+
end(true);
|
|
192
|
+
},
|
|
193
|
+
cancel() {
|
|
194
|
+
if (closed)
|
|
195
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
196
|
+
end(false);
|
|
197
|
+
},
|
|
198
|
+
setValue(next) {
|
|
199
|
+
if (closed)
|
|
200
|
+
throw new EgretError('UI_CONTROL_CLOSED');
|
|
201
|
+
if (typeof next !== 'string')
|
|
202
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
203
|
+
const clipped = clip(next, maxLength);
|
|
204
|
+
if (session !== undefined) {
|
|
205
|
+
draft = clipped;
|
|
206
|
+
editor.setValue(clipped);
|
|
207
|
+
}
|
|
208
|
+
else
|
|
209
|
+
draft = clipped;
|
|
210
|
+
assign(clipped);
|
|
211
|
+
},
|
|
212
|
+
press() {
|
|
213
|
+
action.press();
|
|
214
|
+
},
|
|
215
|
+
release() {
|
|
216
|
+
action.release();
|
|
217
|
+
},
|
|
218
|
+
setEnabled(next) {
|
|
219
|
+
if (typeof next !== 'boolean')
|
|
220
|
+
throw new EgretError('UI_CONTROL_OPTIONS');
|
|
221
|
+
let failure, failed = false;
|
|
222
|
+
if (!next)
|
|
223
|
+
try {
|
|
224
|
+
end(false);
|
|
225
|
+
}
|
|
226
|
+
catch (cause) {
|
|
227
|
+
failure = cause;
|
|
228
|
+
failed = true;
|
|
229
|
+
}
|
|
230
|
+
action.setEnabled(next);
|
|
231
|
+
if (failed)
|
|
232
|
+
throw failure;
|
|
233
|
+
},
|
|
234
|
+
dispose() {
|
|
235
|
+
if (closed)
|
|
236
|
+
return;
|
|
237
|
+
let failure, failed = false;
|
|
238
|
+
try {
|
|
239
|
+
end(false);
|
|
240
|
+
}
|
|
241
|
+
catch (cause) {
|
|
242
|
+
failure = cause;
|
|
243
|
+
failed = true;
|
|
244
|
+
}
|
|
245
|
+
closed = true;
|
|
246
|
+
try {
|
|
247
|
+
action.dispose();
|
|
248
|
+
}
|
|
249
|
+
catch (cause) {
|
|
250
|
+
if (!failed) {
|
|
251
|
+
failure = cause;
|
|
252
|
+
failed = true;
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
if (failed)
|
|
256
|
+
throw failure;
|
|
257
|
+
}
|
|
258
|
+
});
|
|
259
|
+
}
|
|
260
|
+
//# sourceMappingURL=textFieldControl.js.map
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import type { UiLayoutTree } from '@egret/runtime/ui';
|
|
2
|
+
/** A theme's type: its font family, size and line height. */
|
|
3
|
+
export interface UiThemeTypography {
|
|
4
|
+
readonly fontFamily: string;
|
|
5
|
+
readonly fontSize: number;
|
|
6
|
+
readonly lineHeight: number;
|
|
7
|
+
}
|
|
8
|
+
/** Skin names resolve through application-owned, typed asset references, never URLs. */
|
|
9
|
+
export interface UiThemeSkin {
|
|
10
|
+
readonly default: string;
|
|
11
|
+
readonly hover?: string;
|
|
12
|
+
readonly pressed?: string;
|
|
13
|
+
readonly disabled?: string;
|
|
14
|
+
readonly focus?: string;
|
|
15
|
+
readonly checked?: string;
|
|
16
|
+
readonly selected?: string;
|
|
17
|
+
readonly expanded?: string;
|
|
18
|
+
}
|
|
19
|
+
/** A theme to make: its id, colors, spacing, type and skins. */
|
|
20
|
+
export interface UiThemeDescriptor {
|
|
21
|
+
readonly id: string;
|
|
22
|
+
readonly colors?: Readonly<Record<string, number>>;
|
|
23
|
+
readonly spacing?: Readonly<Record<string, number>>;
|
|
24
|
+
readonly typography?: Readonly<Record<string, UiThemeTypography>>;
|
|
25
|
+
readonly skins?: Readonly<Record<string, UiThemeSkin>>;
|
|
26
|
+
}
|
|
27
|
+
declare const themeBrand: unique symbol;
|
|
28
|
+
/** Every factory result is a distinct immutable generation, including equal descriptors. */
|
|
29
|
+
export interface UiTheme {
|
|
30
|
+
readonly [themeBrand]: true;
|
|
31
|
+
readonly id: string;
|
|
32
|
+
readonly colors: Readonly<Record<string, number>>;
|
|
33
|
+
readonly spacing: Readonly<Record<string, number>>;
|
|
34
|
+
readonly typography: Readonly<Record<string, UiThemeTypography>>;
|
|
35
|
+
readonly skins: Readonly<Record<string, UiThemeSkin>>;
|
|
36
|
+
}
|
|
37
|
+
/** How a node of a theme is filled and spaced. */
|
|
38
|
+
export interface UiThemeNode {
|
|
39
|
+
readonly fill?: string;
|
|
40
|
+
readonly padding?: string;
|
|
41
|
+
readonly gap?: string;
|
|
42
|
+
}
|
|
43
|
+
/** Checks and freezes a theme from its description. */
|
|
44
|
+
export declare function createUiTheme(descriptor: UiThemeDescriptor): UiTheme;
|
|
45
|
+
/** The states of a control that a skin may have a name for. */
|
|
46
|
+
export type UiSkinStateName = Exclude<keyof UiThemeSkin, 'default'>;
|
|
47
|
+
/** Which named states of a control are on, to choose its skin. */
|
|
48
|
+
export type UiSkinState = {
|
|
49
|
+
readonly [Name in UiSkinStateName]?: boolean;
|
|
50
|
+
};
|
|
51
|
+
/**
|
|
52
|
+
* The name a skin gives to the state of a control: of the states that hold, the first in `order`
|
|
53
|
+
* that the skin has a name for, and `default` when it has none. The usual order is the one a player
|
|
54
|
+
* reads a control in: unavailable, held, set, focused, pointed at. A state left out of `order` is
|
|
55
|
+
* never chosen.
|
|
56
|
+
*/
|
|
57
|
+
export declare function selectUiSkin(skin: UiThemeSkin, state?: UiSkinState, order?: readonly UiSkinStateName[]): string;
|
|
58
|
+
export declare function requireUiTheme(value: UiTheme | undefined): void;
|
|
59
|
+
export declare function sameThemeMetrics(a: UiTheme | undefined, b: UiTheme | undefined): boolean;
|
|
60
|
+
export declare function captureThemeNode(value: unknown): UiThemeNode;
|
|
61
|
+
/** Resolve a captured numeric tree without callbacks or resource acquisition. */
|
|
62
|
+
export declare function applyUiTheme(tree: UiLayoutTree, bindings: ReadonlyMap<string, UiThemeNode>, theme: UiTheme | undefined): UiLayoutTree;
|
|
63
|
+
export {};
|
|
64
|
+
//# sourceMappingURL=theme.d.ts.map
|
package/dist/ui/theme.js
ADDED
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import { EgretError } from '@egret/runtime';
|
|
3
|
+
import { captureUiLayout } from '@egret/runtime/ui';
|
|
4
|
+
const themes = new WeakMap();
|
|
5
|
+
const freeze = Object.freeze;
|
|
6
|
+
function invalid() {
|
|
7
|
+
throw new EgretError('UI_THEME_INVALID');
|
|
8
|
+
}
|
|
9
|
+
function record(value, allowed) {
|
|
10
|
+
if (value === null || typeof value !== 'object')
|
|
11
|
+
invalid();
|
|
12
|
+
const prototype = Object.getPrototypeOf(value);
|
|
13
|
+
if (prototype !== Object.prototype && prototype !== null)
|
|
14
|
+
invalid();
|
|
15
|
+
const keys = Reflect.ownKeys(value);
|
|
16
|
+
if (keys.length > 64)
|
|
17
|
+
throw new EgretError('UI_THEME_LIMIT');
|
|
18
|
+
const result = Object.create(null);
|
|
19
|
+
for (const key of keys) {
|
|
20
|
+
if (typeof key !== 'string' ||
|
|
21
|
+
!/^[A-Za-z][A-Za-z0-9_.-]{0,63}$/.test(key) ||
|
|
22
|
+
(allowed !== undefined && !allowed.includes(key)))
|
|
23
|
+
invalid();
|
|
24
|
+
// Data-only descriptors prevent hidden getter work during admission.
|
|
25
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, key);
|
|
26
|
+
if (!('value' in descriptor))
|
|
27
|
+
invalid();
|
|
28
|
+
result[key] = descriptor.value;
|
|
29
|
+
}
|
|
30
|
+
return result;
|
|
31
|
+
}
|
|
32
|
+
function name(value) {
|
|
33
|
+
if (typeof value !== 'string' || !/^[A-Za-z][A-Za-z0-9_.-]{0,63}$/.test(value))
|
|
34
|
+
invalid();
|
|
35
|
+
return value;
|
|
36
|
+
}
|
|
37
|
+
function numeric(value, min, max) {
|
|
38
|
+
if (typeof value !== 'number' || !Number.isFinite(value) || value < min || value > max)
|
|
39
|
+
invalid();
|
|
40
|
+
return value === 0 ? 0 : value;
|
|
41
|
+
}
|
|
42
|
+
function tokens(value, capture) {
|
|
43
|
+
const input = value === undefined ? {} : record(value), result = Object.create(null);
|
|
44
|
+
for (const key of Object.keys(input).sort())
|
|
45
|
+
result[key] = capture(input[key]);
|
|
46
|
+
return freeze(result);
|
|
47
|
+
}
|
|
48
|
+
/** Checks and freezes a theme from its description. */
|
|
49
|
+
export function createUiTheme(descriptor) {
|
|
50
|
+
const raw = record(descriptor, ['id', 'colors', 'spacing', 'typography', 'skins']);
|
|
51
|
+
const result = freeze({
|
|
52
|
+
id: name(raw.id),
|
|
53
|
+
colors: tokens(raw.colors, value => {
|
|
54
|
+
const n = numeric(value, 0, 0xffffff);
|
|
55
|
+
if (!Number.isInteger(n))
|
|
56
|
+
invalid();
|
|
57
|
+
return n;
|
|
58
|
+
}),
|
|
59
|
+
spacing: tokens(raw.spacing, value => numeric(value, 0, 4096)),
|
|
60
|
+
typography: tokens(raw.typography, value => {
|
|
61
|
+
const t = record(value, ['fontFamily', 'fontSize', 'lineHeight']);
|
|
62
|
+
if (typeof t.fontFamily !== 'string' ||
|
|
63
|
+
!t.fontFamily.length ||
|
|
64
|
+
t.fontFamily.length > 256 ||
|
|
65
|
+
/[\x00-\x1f\x7f]/.test(t.fontFamily))
|
|
66
|
+
invalid();
|
|
67
|
+
return freeze({
|
|
68
|
+
fontFamily: t.fontFamily,
|
|
69
|
+
fontSize: numeric(t.fontSize, 1, 512),
|
|
70
|
+
lineHeight: numeric(t.lineHeight, 1, 2048)
|
|
71
|
+
});
|
|
72
|
+
}),
|
|
73
|
+
skins: tokens(raw.skins, value => {
|
|
74
|
+
const rawSkin = record(value, [
|
|
75
|
+
'default',
|
|
76
|
+
'hover',
|
|
77
|
+
'pressed',
|
|
78
|
+
'disabled',
|
|
79
|
+
'focus',
|
|
80
|
+
'checked',
|
|
81
|
+
'selected',
|
|
82
|
+
'expanded'
|
|
83
|
+
]);
|
|
84
|
+
const skin = Object.create(null);
|
|
85
|
+
skin.default = name(rawSkin.default);
|
|
86
|
+
for (const key of Object.keys(rawSkin))
|
|
87
|
+
skin[key] = name(rawSkin[key]);
|
|
88
|
+
return freeze(skin);
|
|
89
|
+
})
|
|
90
|
+
});
|
|
91
|
+
themes.set(result, JSON.stringify([result.spacing, result.typography]));
|
|
92
|
+
return result;
|
|
93
|
+
}
|
|
94
|
+
const skinStates = freeze([
|
|
95
|
+
'disabled',
|
|
96
|
+
'pressed',
|
|
97
|
+
'checked',
|
|
98
|
+
'selected',
|
|
99
|
+
'expanded',
|
|
100
|
+
'focus',
|
|
101
|
+
'hover'
|
|
102
|
+
]);
|
|
103
|
+
/**
|
|
104
|
+
* The name a skin gives to the state of a control: of the states that hold, the first in `order`
|
|
105
|
+
* that the skin has a name for, and `default` when it has none. The usual order is the one a player
|
|
106
|
+
* reads a control in: unavailable, held, set, focused, pointed at. A state left out of `order` is
|
|
107
|
+
* never chosen.
|
|
108
|
+
*/
|
|
109
|
+
export function selectUiSkin(skin, state = {}, order = skinStates) {
|
|
110
|
+
const asked = order;
|
|
111
|
+
if (skin === null ||
|
|
112
|
+
typeof skin !== 'object' ||
|
|
113
|
+
typeof skin.default !== 'string' ||
|
|
114
|
+
state === null ||
|
|
115
|
+
typeof state !== 'object' ||
|
|
116
|
+
!Array.isArray(order) ||
|
|
117
|
+
asked.some((entry, index) => !skinStates.includes(entry) || asked.indexOf(entry) !== index))
|
|
118
|
+
invalid();
|
|
119
|
+
for (const entry of skinStates)
|
|
120
|
+
if (state[entry] !== undefined && typeof state[entry] !== 'boolean')
|
|
121
|
+
invalid();
|
|
122
|
+
for (const entry of asked) {
|
|
123
|
+
const named = skin[entry];
|
|
124
|
+
if (state[entry] === true && named !== undefined)
|
|
125
|
+
return named;
|
|
126
|
+
}
|
|
127
|
+
return skin.default;
|
|
128
|
+
}
|
|
129
|
+
export function requireUiTheme(value) {
|
|
130
|
+
if (value !== undefined && !themes.has(value))
|
|
131
|
+
invalid();
|
|
132
|
+
}
|
|
133
|
+
export function sameThemeMetrics(a, b) {
|
|
134
|
+
return (a === undefined ? '[{},{}]' : themes.get(a)) === (b === undefined ? '[{},{}]' : themes.get(b));
|
|
135
|
+
}
|
|
136
|
+
export function captureThemeNode(value) {
|
|
137
|
+
const raw = record(value, ['fill', 'padding', 'gap']), result = Object.create(null);
|
|
138
|
+
for (const key of Object.keys(raw))
|
|
139
|
+
result[key] = name(raw[key]);
|
|
140
|
+
return freeze(result);
|
|
141
|
+
}
|
|
142
|
+
/** Resolve a captured numeric tree without callbacks or resource acquisition. */
|
|
143
|
+
export function applyUiTheme(tree, bindings, theme) {
|
|
144
|
+
if (theme === undefined || bindings.size === 0)
|
|
145
|
+
return tree;
|
|
146
|
+
function resolve(group, key) {
|
|
147
|
+
const value = group[key];
|
|
148
|
+
if (value === undefined)
|
|
149
|
+
throw new EgretError('UI_THEME_TOKEN_MISSING');
|
|
150
|
+
return value;
|
|
151
|
+
}
|
|
152
|
+
function copy(node) {
|
|
153
|
+
const binding = bindings.get(node.id);
|
|
154
|
+
return {
|
|
155
|
+
...node,
|
|
156
|
+
...(binding?.fill === undefined
|
|
157
|
+
? {}
|
|
158
|
+
: { fill: { color: resolve(theme.colors, binding.fill), alpha: node.fill?.alpha ?? 1 } }),
|
|
159
|
+
...(binding?.padding === undefined ? {} : { padding: resolve(theme.spacing, binding.padding) }),
|
|
160
|
+
...(binding?.gap === undefined ? {} : { gap: resolve(theme.spacing, binding.gap) }),
|
|
161
|
+
...(node.children === undefined ? {} : { children: node.children.map(copy) })
|
|
162
|
+
};
|
|
163
|
+
}
|
|
164
|
+
return captureUiLayout(copy(tree.root));
|
|
165
|
+
}
|
|
166
|
+
//# sourceMappingURL=theme.js.map
|