@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,539 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import { EgretError } from '@egret/runtime';
|
|
3
|
+
const rules = Object.freeze({
|
|
4
|
+
group: { leaf: false, named: false, fields: ['disabled'] },
|
|
5
|
+
image: { leaf: true, named: true, fields: [] },
|
|
6
|
+
text: { leaf: true, named: true, fields: [] },
|
|
7
|
+
button: { leaf: true, named: true, fields: ['disabled', 'expanded'] },
|
|
8
|
+
checkbox: { leaf: true, named: true, fields: ['disabled', 'checked'] },
|
|
9
|
+
switch: { leaf: true, named: true, fields: ['disabled', 'checked'] },
|
|
10
|
+
radiogroup: { leaf: false, named: false, fields: ['disabled'] },
|
|
11
|
+
radio: { leaf: true, named: true, inside: 'radiogroup', fields: ['disabled', 'checked', 'position'] },
|
|
12
|
+
listbox: { leaf: false, named: false, fields: ['disabled', 'multiple'] },
|
|
13
|
+
option: { leaf: true, named: true, inside: 'listbox', fields: ['disabled', 'selected', 'position'] },
|
|
14
|
+
list: { leaf: false, named: false, fields: [] },
|
|
15
|
+
listitem: { leaf: false, named: false, inside: 'list', fields: ['position'] },
|
|
16
|
+
scrollbar: { leaf: true, named: true, fields: ['disabled', 'range', 'orientation', 'controls'] },
|
|
17
|
+
slider: { leaf: true, named: true, fields: ['disabled', 'range', 'orientation'] },
|
|
18
|
+
spinbutton: { leaf: true, named: true, fields: ['disabled', 'range'] },
|
|
19
|
+
progressbar: { leaf: true, named: true, fields: ['range'] },
|
|
20
|
+
tablist: { leaf: false, named: false, fields: ['disabled', 'orientation'] },
|
|
21
|
+
tab: { leaf: true, named: true, inside: 'tablist', fields: ['disabled', 'selected', 'position', 'controls'] },
|
|
22
|
+
tabpanel: { leaf: false, named: true, fields: [] },
|
|
23
|
+
menu: { leaf: false, named: false, fields: ['disabled', 'orientation'] },
|
|
24
|
+
menuitem: { leaf: true, named: true, inside: 'menu', fields: ['disabled', 'position'] },
|
|
25
|
+
dialog: { leaf: false, named: true, fields: ['modal'] },
|
|
26
|
+
textbox: { leaf: true, named: true, fields: ['disabled', 'value', 'multiline'] },
|
|
27
|
+
// A message that is said when it changes. Its name is the message, and it is there, empty, before the first one.
|
|
28
|
+
status: { leaf: true, named: false, fields: [] },
|
|
29
|
+
alert: { leaf: true, named: false, fields: [] },
|
|
30
|
+
// Cells in rows and columns. A row is which row it is, and a cell which column it is in.
|
|
31
|
+
grid: { leaf: false, named: false, fields: ['disabled', 'multiple', 'extent'] },
|
|
32
|
+
// Rows are what is selected in a table, and cells in a board: either says so where it is the one.
|
|
33
|
+
row: { leaf: false, named: false, inside: 'grid', fields: ['disabled', 'selected', 'position'], loose: ['selected'] },
|
|
34
|
+
gridcell: {
|
|
35
|
+
leaf: true,
|
|
36
|
+
named: true,
|
|
37
|
+
inside: 'row',
|
|
38
|
+
fields: ['disabled', 'selected', 'position'],
|
|
39
|
+
loose: ['selected']
|
|
40
|
+
},
|
|
41
|
+
columnheader: { leaf: true, named: true, inside: 'row', fields: ['disabled', 'position', 'sort'] },
|
|
42
|
+
// The items of a tree are all inside the tree itself: how deep one is, is said by its level, so that the items of a list can be a tree.
|
|
43
|
+
tree: { leaf: false, named: false, fields: ['disabled', 'multiple'] },
|
|
44
|
+
treeitem: {
|
|
45
|
+
leaf: true,
|
|
46
|
+
named: true,
|
|
47
|
+
inside: 'tree',
|
|
48
|
+
fields: ['disabled', 'selected', 'expanded', 'position', 'level'],
|
|
49
|
+
loose: ['selected']
|
|
50
|
+
},
|
|
51
|
+
heading: { leaf: true, named: true, fields: ['level'] }
|
|
52
|
+
});
|
|
53
|
+
/** State that belongs to some roles only. A description that sets one its role does not have is refused. */
|
|
54
|
+
const particular = [
|
|
55
|
+
'disabled',
|
|
56
|
+
'checked',
|
|
57
|
+
'selected',
|
|
58
|
+
'expanded',
|
|
59
|
+
'modal',
|
|
60
|
+
'multiline',
|
|
61
|
+
'multiple',
|
|
62
|
+
'extent',
|
|
63
|
+
'sort',
|
|
64
|
+
'level',
|
|
65
|
+
'range',
|
|
66
|
+
'orientation',
|
|
67
|
+
'controls',
|
|
68
|
+
'position',
|
|
69
|
+
'value'
|
|
70
|
+
];
|
|
71
|
+
const offers = Object.freeze({
|
|
72
|
+
'': Object.freeze([]),
|
|
73
|
+
a: Object.freeze(['activate']),
|
|
74
|
+
f: Object.freeze(['focus']),
|
|
75
|
+
af: Object.freeze(['activate', 'focus'])
|
|
76
|
+
});
|
|
77
|
+
const finite = (value) => typeof value === 'number' && Number.isFinite(value);
|
|
78
|
+
const flag = (value) => value === undefined || typeof value === 'boolean';
|
|
79
|
+
const identifier = (value) => typeof value === 'string' && value.length >= 1 && value.length <= 128 && !value.includes('\0');
|
|
80
|
+
function sameNode(a, b) {
|
|
81
|
+
return (a.id === b.id &&
|
|
82
|
+
a.role === b.role &&
|
|
83
|
+
a.parent === b.parent &&
|
|
84
|
+
a.name === b.name &&
|
|
85
|
+
a.disabled === b.disabled &&
|
|
86
|
+
a.focused === b.focused &&
|
|
87
|
+
a.inert === b.inert &&
|
|
88
|
+
a.actions === b.actions &&
|
|
89
|
+
a.value === b.value &&
|
|
90
|
+
a.checked === b.checked &&
|
|
91
|
+
a.selected === b.selected &&
|
|
92
|
+
a.expanded === b.expanded &&
|
|
93
|
+
a.modal === b.modal &&
|
|
94
|
+
a.multiline === b.multiline &&
|
|
95
|
+
a.multiple === b.multiple &&
|
|
96
|
+
a.orientation === b.orientation &&
|
|
97
|
+
a.controls === b.controls &&
|
|
98
|
+
a.bounds.x === b.bounds.x &&
|
|
99
|
+
a.bounds.y === b.bounds.y &&
|
|
100
|
+
a.bounds.width === b.bounds.width &&
|
|
101
|
+
a.bounds.height === b.bounds.height &&
|
|
102
|
+
a.range?.now === b.range?.now &&
|
|
103
|
+
a.range?.min === b.range?.min &&
|
|
104
|
+
a.range?.max === b.range?.max &&
|
|
105
|
+
a.position?.index === b.position?.index &&
|
|
106
|
+
a.position?.size === b.position?.size &&
|
|
107
|
+
a.extent?.rows === b.extent?.rows &&
|
|
108
|
+
a.extent?.columns === b.extent?.columns &&
|
|
109
|
+
a.sort === b.sort &&
|
|
110
|
+
a.level === b.level);
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* The rectangle on the stage that encloses a display object and what it holds, for the bounds of
|
|
114
|
+
* a node. It is measured when it is called, so call it from `describe`.
|
|
115
|
+
*/
|
|
116
|
+
export function semanticBoundsOf(target) {
|
|
117
|
+
const local = target.getBounds(), right = local.x + local.width, bottom = local.y + local.height;
|
|
118
|
+
const corners = [
|
|
119
|
+
target.localToGlobal(local.x, local.y),
|
|
120
|
+
target.localToGlobal(right, local.y),
|
|
121
|
+
target.localToGlobal(right, bottom),
|
|
122
|
+
target.localToGlobal(local.x, bottom)
|
|
123
|
+
];
|
|
124
|
+
const xs = corners.map(point => point.x), ys = corners.map(point => point.y), x = Math.min(...xs), y = Math.min(...ys);
|
|
125
|
+
return Object.freeze({ x, y, width: Math.max(...xs) - x, height: Math.max(...ys) - y });
|
|
126
|
+
}
|
|
127
|
+
/** A semantic tree for the controls an application draws. It reads them; it holds no state of theirs. */
|
|
128
|
+
export function createUiSemantics(options = {}) {
|
|
129
|
+
if (options === null || typeof options !== 'object' || Array.isArray(options))
|
|
130
|
+
throw new EgretError('UI_SEMANTICS_OPTIONS');
|
|
131
|
+
const maxNodes = options.maxNodes ?? 256;
|
|
132
|
+
if (!Number.isInteger(maxNodes) || maxNodes < 1 || maxNodes > 4096)
|
|
133
|
+
throw new EgretError('UI_SEMANTICS_OPTIONS');
|
|
134
|
+
const entries = new Map(), roots = [];
|
|
135
|
+
const listeners = new Set(), closers = new Set();
|
|
136
|
+
let snapshot = Object.freeze({
|
|
137
|
+
revision: 0,
|
|
138
|
+
layoutRevision: undefined,
|
|
139
|
+
nodes: Object.freeze([]),
|
|
140
|
+
focused: undefined
|
|
141
|
+
});
|
|
142
|
+
/** The entry each published node was read from: an id may since have been removed and used again. */
|
|
143
|
+
let published = new Map();
|
|
144
|
+
let state = 'active', publishing = false, telling = false;
|
|
145
|
+
function open() {
|
|
146
|
+
if (state === 'closed')
|
|
147
|
+
throw new EgretError('UI_SEMANTICS_CLOSED');
|
|
148
|
+
if (publishing)
|
|
149
|
+
throw new EgretError('UI_SEMANTICS_REENTRANT');
|
|
150
|
+
}
|
|
151
|
+
function detach(entry) {
|
|
152
|
+
entry.attached = false;
|
|
153
|
+
entries.delete(entry.id);
|
|
154
|
+
for (const child of entry.children.splice(0))
|
|
155
|
+
detach(child);
|
|
156
|
+
}
|
|
157
|
+
function add(node) {
|
|
158
|
+
open();
|
|
159
|
+
if (node === null || typeof node !== 'object')
|
|
160
|
+
throw new EgretError('UI_SEMANTICS_OPTIONS');
|
|
161
|
+
const { id, role, parent: parentId, describe, onActivate, onFocus } = node;
|
|
162
|
+
if (!identifier(id) ||
|
|
163
|
+
typeof role !== 'string' ||
|
|
164
|
+
!Object.hasOwn(rules, role) ||
|
|
165
|
+
typeof describe !== 'function' ||
|
|
166
|
+
(parentId !== undefined && !identifier(parentId)) ||
|
|
167
|
+
(onActivate !== undefined && typeof onActivate !== 'function') ||
|
|
168
|
+
(onFocus !== undefined && typeof onFocus !== 'function'))
|
|
169
|
+
throw new EgretError('UI_SEMANTICS_OPTIONS');
|
|
170
|
+
if (entries.has(id))
|
|
171
|
+
throw new EgretError('UI_SEMANTICS_DUPLICATE');
|
|
172
|
+
const parent = parentId === undefined ? undefined : entries.get(parentId), rule = rules[role];
|
|
173
|
+
// A leaf is read as one thing, and a radio, an option or a list item means nothing outside its container.
|
|
174
|
+
if ((parentId !== undefined && parent === undefined) ||
|
|
175
|
+
(parent !== undefined && rules[parent.role].leaf) ||
|
|
176
|
+
(rule.inside !== undefined && parent?.role !== rule.inside))
|
|
177
|
+
throw new EgretError('UI_SEMANTICS_PARENT');
|
|
178
|
+
if (entries.size >= maxNodes)
|
|
179
|
+
throw new EgretError('UI_SEMANTICS_CAPACITY');
|
|
180
|
+
const entry = {
|
|
181
|
+
id,
|
|
182
|
+
role,
|
|
183
|
+
parent,
|
|
184
|
+
children: [],
|
|
185
|
+
describe,
|
|
186
|
+
onActivate,
|
|
187
|
+
onFocus,
|
|
188
|
+
attached: true,
|
|
189
|
+
handle: Object.freeze({
|
|
190
|
+
id,
|
|
191
|
+
role,
|
|
192
|
+
parent: parentId,
|
|
193
|
+
get attached() {
|
|
194
|
+
return entry.attached;
|
|
195
|
+
},
|
|
196
|
+
remove() {
|
|
197
|
+
if (!entry.attached)
|
|
198
|
+
return;
|
|
199
|
+
if (publishing)
|
|
200
|
+
throw new EgretError('UI_SEMANTICS_REENTRANT');
|
|
201
|
+
const siblings = entry.parent === undefined ? roots : entry.parent.children, index = siblings.indexOf(entry);
|
|
202
|
+
if (index >= 0)
|
|
203
|
+
siblings.splice(index, 1);
|
|
204
|
+
detach(entry);
|
|
205
|
+
}
|
|
206
|
+
})
|
|
207
|
+
};
|
|
208
|
+
entries.set(id, entry);
|
|
209
|
+
(parent === undefined ? roots : parent.children).push(entry);
|
|
210
|
+
return entry.handle;
|
|
211
|
+
}
|
|
212
|
+
/** One description, checked against its role. Undefined for a hidden node. */
|
|
213
|
+
function read(entry) {
|
|
214
|
+
let described;
|
|
215
|
+
try {
|
|
216
|
+
described = entry.describe();
|
|
217
|
+
}
|
|
218
|
+
catch (cause) {
|
|
219
|
+
throw new EgretError('UI_SEMANTICS_DESCRIBE_FAILED', { cause });
|
|
220
|
+
}
|
|
221
|
+
const refuse = (field) => new EgretError('UI_SEMANTICS_DESCRIPTION', { cause: new TypeError(entry.id + ': ' + field) });
|
|
222
|
+
if (described === null || typeof described !== 'object' || Array.isArray(described))
|
|
223
|
+
throw refuse('description');
|
|
224
|
+
const rule = rules[entry.role];
|
|
225
|
+
const { bounds, name = '', hidden, focused, order = 0, disabled, checked, selected, expanded, modal, multiline, multiple, extent, sort, level, range, orientation, controls, position, value } = described;
|
|
226
|
+
if (!flag(hidden))
|
|
227
|
+
throw refuse('hidden');
|
|
228
|
+
if (hidden === true)
|
|
229
|
+
return undefined;
|
|
230
|
+
for (const field of particular)
|
|
231
|
+
if (described[field] !== undefined && !rule.fields.includes(field))
|
|
232
|
+
throw refuse(field);
|
|
233
|
+
if (bounds === null ||
|
|
234
|
+
typeof bounds !== 'object' ||
|
|
235
|
+
!finite(bounds.x) ||
|
|
236
|
+
!finite(bounds.y) ||
|
|
237
|
+
!finite(bounds.width) ||
|
|
238
|
+
!finite(bounds.height) ||
|
|
239
|
+
bounds.width < 0 ||
|
|
240
|
+
bounds.height < 0)
|
|
241
|
+
throw refuse('bounds');
|
|
242
|
+
if (typeof name !== 'string' || name.length > 1024 || (rule.named && !/\S/.test(name)))
|
|
243
|
+
throw refuse('name');
|
|
244
|
+
if (!flag(focused))
|
|
245
|
+
throw refuse('focused');
|
|
246
|
+
if (!finite(order))
|
|
247
|
+
throw refuse('order');
|
|
248
|
+
if (!flag(disabled))
|
|
249
|
+
throw refuse('disabled');
|
|
250
|
+
if (!flag(expanded))
|
|
251
|
+
throw refuse('expanded');
|
|
252
|
+
if (!flag(modal))
|
|
253
|
+
throw refuse('modal');
|
|
254
|
+
if (!flag(multiline))
|
|
255
|
+
throw refuse('multiline');
|
|
256
|
+
if (!flag(multiple))
|
|
257
|
+
throw refuse('multiple');
|
|
258
|
+
const checkable = rule.fields.includes('checked');
|
|
259
|
+
if (checkable
|
|
260
|
+
? typeof checked !== 'boolean' && !(checked === 'mixed' && entry.role === 'checkbox')
|
|
261
|
+
: checked !== undefined)
|
|
262
|
+
throw refuse('checked');
|
|
263
|
+
if (rule.fields.includes('selected')
|
|
264
|
+
? typeof selected !== 'boolean' && !(selected === undefined && rule.loose?.includes('selected') === true)
|
|
265
|
+
: selected !== undefined)
|
|
266
|
+
throw refuse('selected');
|
|
267
|
+
if (sort !== undefined && sort !== 'ascending' && sort !== 'descending' && sort !== 'none')
|
|
268
|
+
throw refuse('sort');
|
|
269
|
+
// An item of a tree is at some depth. A heading has one of six ranks, or does not say.
|
|
270
|
+
if (entry.role === 'treeitem' || level !== undefined
|
|
271
|
+
? !Number.isSafeInteger(level) || level < 1 || (entry.role === 'heading' && level > 6)
|
|
272
|
+
: false)
|
|
273
|
+
throw refuse('level');
|
|
274
|
+
if (value !== undefined && (typeof value !== 'string' || value.length > 16384))
|
|
275
|
+
throw refuse('value');
|
|
276
|
+
// A scroll bar, a slider and a spin button are somewhere in their range. A progress bar without one shows work of unknown length.
|
|
277
|
+
const ranged = entry.role === 'scrollbar' || entry.role === 'slider' || entry.role === 'spinbutton';
|
|
278
|
+
if (ranged || range !== undefined
|
|
279
|
+
? range === null ||
|
|
280
|
+
typeof range !== 'object' ||
|
|
281
|
+
!finite(range.now) ||
|
|
282
|
+
!finite(range.min) ||
|
|
283
|
+
!finite(range.max) ||
|
|
284
|
+
range.min > range.now ||
|
|
285
|
+
range.now > range.max
|
|
286
|
+
: false)
|
|
287
|
+
throw refuse('range');
|
|
288
|
+
if (extent !== undefined &&
|
|
289
|
+
(extent === null ||
|
|
290
|
+
typeof extent !== 'object' ||
|
|
291
|
+
!Number.isSafeInteger(extent.rows) ||
|
|
292
|
+
!Number.isSafeInteger(extent.columns) ||
|
|
293
|
+
extent.rows < 1 ||
|
|
294
|
+
extent.columns < 1))
|
|
295
|
+
throw refuse('extent');
|
|
296
|
+
if (orientation !== undefined && orientation !== 'horizontal' && orientation !== 'vertical')
|
|
297
|
+
throw refuse('orientation');
|
|
298
|
+
if (controls !== undefined && (!identifier(controls) || controls === entry.id))
|
|
299
|
+
throw refuse('controls');
|
|
300
|
+
if (position !== undefined &&
|
|
301
|
+
(position === null ||
|
|
302
|
+
typeof position !== 'object' ||
|
|
303
|
+
!Number.isSafeInteger(position.index) ||
|
|
304
|
+
!Number.isSafeInteger(position.size) ||
|
|
305
|
+
position.index < 1 ||
|
|
306
|
+
position.index > position.size))
|
|
307
|
+
throw refuse('position');
|
|
308
|
+
return {
|
|
309
|
+
entry,
|
|
310
|
+
order,
|
|
311
|
+
node: {
|
|
312
|
+
id: entry.id,
|
|
313
|
+
role: entry.role,
|
|
314
|
+
parent: entry.parent?.id,
|
|
315
|
+
name,
|
|
316
|
+
bounds: Object.freeze({ x: bounds.x, y: bounds.y, width: bounds.width, height: bounds.height }),
|
|
317
|
+
disabled: disabled === true,
|
|
318
|
+
focused: focused === true,
|
|
319
|
+
actions: offers[(entry.onActivate === undefined ? '' : 'a') + (entry.onFocus === undefined ? '' : 'f')],
|
|
320
|
+
value: entry.role === 'textbox' ? (value ?? '') : undefined,
|
|
321
|
+
checked: checked,
|
|
322
|
+
selected,
|
|
323
|
+
expanded,
|
|
324
|
+
modal: entry.role === 'dialog' ? modal === true : undefined,
|
|
325
|
+
multiline: entry.role === 'textbox' ? multiline === true : undefined,
|
|
326
|
+
multiple: rule.fields.includes('multiple') ? multiple === true : undefined,
|
|
327
|
+
extent: extent === undefined
|
|
328
|
+
? undefined
|
|
329
|
+
: Object.freeze({ rows: extent.rows, columns: extent.columns }),
|
|
330
|
+
sort: sort,
|
|
331
|
+
level,
|
|
332
|
+
range: range === undefined
|
|
333
|
+
? undefined
|
|
334
|
+
: Object.freeze({ now: range.now, min: range.min, max: range.max }),
|
|
335
|
+
// A scroll bar stands beside what it scrolls and a menu lists its items downward; a slider and a row of tabs lie along the line they are read in.
|
|
336
|
+
orientation: rule.fields.includes('orientation')
|
|
337
|
+
? (orientation ??
|
|
338
|
+
(entry.role === 'scrollbar' || entry.role === 'menu' ? 'vertical' : 'horizontal'))
|
|
339
|
+
: undefined,
|
|
340
|
+
controls,
|
|
341
|
+
position: position === undefined
|
|
342
|
+
? undefined
|
|
343
|
+
: Object.freeze({ index: position.index, size: position.size })
|
|
344
|
+
}
|
|
345
|
+
};
|
|
346
|
+
}
|
|
347
|
+
function collect(siblings, into) {
|
|
348
|
+
const drafts = [];
|
|
349
|
+
// A snapshot of the list: a description may not change the tree, and is refused if it tries.
|
|
350
|
+
for (const entry of [...siblings]) {
|
|
351
|
+
const draft = read(entry);
|
|
352
|
+
if (draft !== undefined)
|
|
353
|
+
drafts.push(draft);
|
|
354
|
+
}
|
|
355
|
+
// The sort is stable: nodes of equal order stay in the order they were added.
|
|
356
|
+
drafts.sort((a, b) => a.order - b.order);
|
|
357
|
+
for (const draft of drafts) {
|
|
358
|
+
into.push(draft);
|
|
359
|
+
collect(draft.entry.children, into);
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
function publish(layoutRevision) {
|
|
363
|
+
open();
|
|
364
|
+
if (telling)
|
|
365
|
+
throw new EgretError('UI_SEMANTICS_REENTRANT');
|
|
366
|
+
if (layoutRevision !== undefined &&
|
|
367
|
+
(!Number.isSafeInteger(layoutRevision) ||
|
|
368
|
+
layoutRevision < 0 ||
|
|
369
|
+
(snapshot.layoutRevision !== undefined && layoutRevision < snapshot.layoutRevision)))
|
|
370
|
+
throw new EgretError('UI_SEMANTICS_REVISION');
|
|
371
|
+
const drafts = [];
|
|
372
|
+
publishing = true;
|
|
373
|
+
try {
|
|
374
|
+
collect(roots, drafts);
|
|
375
|
+
}
|
|
376
|
+
finally {
|
|
377
|
+
publishing = false;
|
|
378
|
+
}
|
|
379
|
+
const present = new Map(drafts.map(draft => [draft.entry.id, draft]));
|
|
380
|
+
// The modal dialog read last is the one in front. It, what is inside it and what it is inside stay live.
|
|
381
|
+
let modal;
|
|
382
|
+
for (const draft of drafts)
|
|
383
|
+
if (draft.node.modal === true)
|
|
384
|
+
modal = draft;
|
|
385
|
+
const live = new Set();
|
|
386
|
+
for (let entry = modal?.entry; entry !== undefined; entry = entry.parent)
|
|
387
|
+
live.add(entry);
|
|
388
|
+
const within = (entry) => {
|
|
389
|
+
for (let at = entry; at !== undefined; at = at.parent)
|
|
390
|
+
if (at === modal.entry)
|
|
391
|
+
return true;
|
|
392
|
+
return false;
|
|
393
|
+
};
|
|
394
|
+
const next = new Map(), nodes = [];
|
|
395
|
+
let focused, changed = drafts.length !== snapshot.nodes.length || layoutRevision !== snapshot.layoutRevision;
|
|
396
|
+
for (const [index, draft] of drafts.entries()) {
|
|
397
|
+
const inert = modal !== undefined && !live.has(draft.entry) && !within(draft.entry);
|
|
398
|
+
if (draft.node.controls !== undefined && !present.has(draft.node.controls))
|
|
399
|
+
throw new EgretError('UI_SEMANTICS_RELATION', { cause: new TypeError(draft.entry.id + ': controls') });
|
|
400
|
+
// A node a modal dialog has just made inert may still hold the keyboard focus, for the frame between the dialog
|
|
401
|
+
// opening and the application moving the focus into it: it is published without the focus, not refused.
|
|
402
|
+
const holds = draft.node.focused === true && !inert;
|
|
403
|
+
if (holds) {
|
|
404
|
+
// One node holds the focus.
|
|
405
|
+
if (focused !== undefined)
|
|
406
|
+
throw new EgretError('UI_SEMANTICS_FOCUS', { cause: new TypeError(draft.entry.id + ': focused') });
|
|
407
|
+
focused = draft.entry.id;
|
|
408
|
+
}
|
|
409
|
+
const fresh = {
|
|
410
|
+
...draft.node,
|
|
411
|
+
inert,
|
|
412
|
+
...(draft.node.focused && inert ? { focused: false } : {})
|
|
413
|
+
}, before = snapshot.nodes[index];
|
|
414
|
+
const node = before !== undefined && sameNode(before, fresh) ? before : Object.freeze(fresh);
|
|
415
|
+
if (node !== before)
|
|
416
|
+
changed = true;
|
|
417
|
+
nodes.push(node);
|
|
418
|
+
next.set(node.id, { node, entry: draft.entry });
|
|
419
|
+
}
|
|
420
|
+
published = next;
|
|
421
|
+
if (!changed)
|
|
422
|
+
return snapshot;
|
|
423
|
+
if (!Number.isSafeInteger(snapshot.revision + 1))
|
|
424
|
+
throw new EgretError('UI_SEMANTICS_EXHAUSTED');
|
|
425
|
+
const previous = snapshot;
|
|
426
|
+
snapshot = Object.freeze({ revision: previous.revision + 1, layoutRevision, nodes: Object.freeze(nodes), focused });
|
|
427
|
+
// Published before anyone is told: a listener that fails does not undo it.
|
|
428
|
+
let first, failed = false;
|
|
429
|
+
const rest = [];
|
|
430
|
+
telling = true;
|
|
431
|
+
try {
|
|
432
|
+
for (const listener of [...listeners]) {
|
|
433
|
+
if (state === 'closed')
|
|
434
|
+
break;
|
|
435
|
+
if (listeners.has(listener))
|
|
436
|
+
try {
|
|
437
|
+
listener(snapshot, previous);
|
|
438
|
+
}
|
|
439
|
+
catch (cause) {
|
|
440
|
+
if (failed)
|
|
441
|
+
rest.push(cause);
|
|
442
|
+
else {
|
|
443
|
+
failed = true;
|
|
444
|
+
first = cause;
|
|
445
|
+
}
|
|
446
|
+
}
|
|
447
|
+
}
|
|
448
|
+
}
|
|
449
|
+
finally {
|
|
450
|
+
telling = false;
|
|
451
|
+
}
|
|
452
|
+
if (failed)
|
|
453
|
+
throw new EgretError('UI_SEMANTICS_LISTENER_FAILED', { cause: first, cleanupErrors: rest });
|
|
454
|
+
return snapshot;
|
|
455
|
+
}
|
|
456
|
+
function perform(id, action) {
|
|
457
|
+
if (!identifier(id) || (action !== 'activate' && action !== 'focus'))
|
|
458
|
+
throw new EgretError('UI_SEMANTICS_OPTIONS');
|
|
459
|
+
if (state === 'closed')
|
|
460
|
+
return false;
|
|
461
|
+
if (publishing)
|
|
462
|
+
throw new EgretError('UI_SEMANTICS_REENTRANT');
|
|
463
|
+
const found = published.get(id);
|
|
464
|
+
if (found === undefined || !found.entry.attached || found.node.disabled || found.node.inert)
|
|
465
|
+
return false;
|
|
466
|
+
const handler = action === 'activate' ? found.entry.onActivate : found.entry.onFocus;
|
|
467
|
+
if (handler === undefined)
|
|
468
|
+
return false;
|
|
469
|
+
handler();
|
|
470
|
+
return true;
|
|
471
|
+
}
|
|
472
|
+
function dispose() {
|
|
473
|
+
if (state === 'closed')
|
|
474
|
+
return;
|
|
475
|
+
if (publishing)
|
|
476
|
+
throw new EgretError('UI_SEMANTICS_REENTRANT');
|
|
477
|
+
state = 'closed';
|
|
478
|
+
for (const entry of roots.splice(0))
|
|
479
|
+
detach(entry);
|
|
480
|
+
published = new Map();
|
|
481
|
+
listeners.clear();
|
|
482
|
+
const callbacks = [...closers];
|
|
483
|
+
closers.clear();
|
|
484
|
+
let first, failed = false;
|
|
485
|
+
const rest = [];
|
|
486
|
+
for (const callback of callbacks)
|
|
487
|
+
try {
|
|
488
|
+
callback();
|
|
489
|
+
}
|
|
490
|
+
catch (cause) {
|
|
491
|
+
if (failed)
|
|
492
|
+
rest.push(cause);
|
|
493
|
+
else {
|
|
494
|
+
failed = true;
|
|
495
|
+
first = cause;
|
|
496
|
+
}
|
|
497
|
+
}
|
|
498
|
+
if (failed)
|
|
499
|
+
throw new EgretError('UI_SEMANTICS_CLEANUP_FAILED', { cause: first, cleanupErrors: rest });
|
|
500
|
+
}
|
|
501
|
+
return Object.freeze({
|
|
502
|
+
get state() {
|
|
503
|
+
return state;
|
|
504
|
+
},
|
|
505
|
+
get snapshot() {
|
|
506
|
+
return snapshot;
|
|
507
|
+
},
|
|
508
|
+
get size() {
|
|
509
|
+
return entries.size;
|
|
510
|
+
},
|
|
511
|
+
add,
|
|
512
|
+
publish,
|
|
513
|
+
perform,
|
|
514
|
+
observe(listener) {
|
|
515
|
+
if (typeof listener !== 'function')
|
|
516
|
+
throw new EgretError('UI_SEMANTICS_OPTIONS');
|
|
517
|
+
if (state === 'closed')
|
|
518
|
+
return () => { };
|
|
519
|
+
listeners.add(listener);
|
|
520
|
+
return () => {
|
|
521
|
+
listeners.delete(listener);
|
|
522
|
+
};
|
|
523
|
+
},
|
|
524
|
+
onClose(listener) {
|
|
525
|
+
if (typeof listener !== 'function')
|
|
526
|
+
throw new EgretError('UI_SEMANTICS_OPTIONS');
|
|
527
|
+
if (state === 'closed') {
|
|
528
|
+
listener();
|
|
529
|
+
return () => { };
|
|
530
|
+
}
|
|
531
|
+
closers.add(listener);
|
|
532
|
+
return () => {
|
|
533
|
+
closers.delete(listener);
|
|
534
|
+
};
|
|
535
|
+
},
|
|
536
|
+
dispose
|
|
537
|
+
});
|
|
538
|
+
}
|
|
539
|
+
//# sourceMappingURL=semanticTree.js.map
|