@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,173 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Many asset files in one: models, pictures and sounds a level needs, fetched
|
|
3
|
+
// as one file instead of hundreds, or a part of it at a time where the host
|
|
4
|
+
// serves byte ranges. The file is a short header, a JSON index of names,
|
|
5
|
+
// offsets, sizes, types and checksums, and the bytes of every entry one after
|
|
6
|
+
// the other. `writeAssetBundle` makes one (in a build script or a page), and
|
|
7
|
+
// `readAssetBundleIndex` with `sliceAssetBundle` read one; the browser kit
|
|
8
|
+
// fetches them.
|
|
9
|
+
import { EgretError } from '@egret/runtime';
|
|
10
|
+
const MAGIC = [0x45, 0x47, 0x50, 0x4b]; // EGPK
|
|
11
|
+
const HEADER = 12;
|
|
12
|
+
const MAX_ENTRIES = 65536;
|
|
13
|
+
const MAX_INDEX = 16 * 1024 * 1024;
|
|
14
|
+
const ALIGN = 4;
|
|
15
|
+
const codecs = globalThis;
|
|
16
|
+
const fail = (code, detail) => {
|
|
17
|
+
throw new EgretError(code, { cause: new TypeError(detail) });
|
|
18
|
+
};
|
|
19
|
+
/** FNV-1a over the bytes, as eight hex digits. */
|
|
20
|
+
export function assetBundleCheck(bytes) {
|
|
21
|
+
let h = 0x811c9dc5;
|
|
22
|
+
for (let i = 0; i < bytes.length; i++)
|
|
23
|
+
h = Math.imul(h ^ bytes[i], 0x01000193);
|
|
24
|
+
return (h >>> 0).toString(16).padStart(8, '0');
|
|
25
|
+
}
|
|
26
|
+
/** One file holding every input, in the order given, each starting at a multiple of four bytes. */
|
|
27
|
+
export function writeAssetBundle(inputs) {
|
|
28
|
+
if (!Array.isArray(inputs) || inputs.length === 0 || inputs.length > MAX_ENTRIES)
|
|
29
|
+
fail('ASSET_BUNDLE_INVALID', 'entries');
|
|
30
|
+
const names = new Set();
|
|
31
|
+
for (const input of inputs) {
|
|
32
|
+
if (!input ||
|
|
33
|
+
typeof input.name !== 'string' ||
|
|
34
|
+
!/^[A-Za-z0-9_.\-]+(?:\/[A-Za-z0-9_.\-]+)*$/.test(input.name) ||
|
|
35
|
+
input.name.split('/').some(part => part === '.' || part === '..') ||
|
|
36
|
+
input.name.length > 512)
|
|
37
|
+
fail('ASSET_BUNDLE_INVALID', 'name ' + String(input?.name));
|
|
38
|
+
if (names.has(input.name))
|
|
39
|
+
fail('ASSET_BUNDLE_INVALID', 'duplicate ' + input.name);
|
|
40
|
+
names.add(input.name);
|
|
41
|
+
if (!(input.bytes instanceof Uint8Array))
|
|
42
|
+
fail('ASSET_BUNDLE_INVALID', 'bytes of ' + input.name);
|
|
43
|
+
if (input.type !== undefined && (typeof input.type !== 'string' || input.type.length > 200))
|
|
44
|
+
fail('ASSET_BUNDLE_INVALID', 'type of ' + input.name);
|
|
45
|
+
if (input.tags !== undefined && (!Array.isArray(input.tags) || !input.tags.every(t => typeof t === 'string')))
|
|
46
|
+
fail('ASSET_BUNDLE_INVALID', 'tags of ' + input.name);
|
|
47
|
+
}
|
|
48
|
+
// The index records offsets, which depend on its own length: lay it out until the length settles.
|
|
49
|
+
let dataOffset = HEADER, indexBytes = new Uint8Array(0), entries = [];
|
|
50
|
+
for (let round = 0; round < 4; round++) {
|
|
51
|
+
let at = dataOffset;
|
|
52
|
+
entries = inputs.map(input => {
|
|
53
|
+
const entry = {
|
|
54
|
+
name: input.name,
|
|
55
|
+
offset: at,
|
|
56
|
+
size: input.bytes.length,
|
|
57
|
+
type: input.type ?? 'application/octet-stream',
|
|
58
|
+
tags: [...(input.tags ?? [])],
|
|
59
|
+
check: assetBundleCheck(input.bytes)
|
|
60
|
+
};
|
|
61
|
+
at += Math.ceil(input.bytes.length / ALIGN) * ALIGN;
|
|
62
|
+
return entry;
|
|
63
|
+
});
|
|
64
|
+
const index = { version: 1, size: at, dataOffset, entries };
|
|
65
|
+
indexBytes = new codecs.TextEncoder().encode(JSON.stringify(index));
|
|
66
|
+
const next = Math.ceil((HEADER + indexBytes.length) / ALIGN) * ALIGN;
|
|
67
|
+
if (next === dataOffset)
|
|
68
|
+
break;
|
|
69
|
+
dataOffset = next;
|
|
70
|
+
}
|
|
71
|
+
if (indexBytes.length > MAX_INDEX)
|
|
72
|
+
fail('ASSET_BUNDLE_INVALID', 'index too large');
|
|
73
|
+
const last = entries[entries.length - 1];
|
|
74
|
+
const total = last.offset + Math.ceil(last.size / ALIGN) * ALIGN;
|
|
75
|
+
const out = new Uint8Array(total);
|
|
76
|
+
const view = new DataView(out.buffer);
|
|
77
|
+
out.set(MAGIC, 0);
|
|
78
|
+
view.setUint32(4, 1, true);
|
|
79
|
+
view.setUint32(8, indexBytes.length, true);
|
|
80
|
+
out.set(indexBytes, HEADER);
|
|
81
|
+
inputs.forEach((input, i) => out.set(input.bytes, entries[i].offset));
|
|
82
|
+
return out;
|
|
83
|
+
}
|
|
84
|
+
/** How many bytes from the start must be read to know the index's length: the header. */
|
|
85
|
+
export const ASSET_BUNDLE_HEADER_BYTES = HEADER;
|
|
86
|
+
/** The index length a header gives, so a reader can ask for exactly the bytes of the index. */
|
|
87
|
+
export function readAssetBundleHeader(head) {
|
|
88
|
+
if (!(head instanceof Uint8Array) || head.length < HEADER || MAGIC.some((b, i) => head[i] !== b))
|
|
89
|
+
fail('ASSET_BUNDLE_FORMAT_INVALID', 'not a bundle');
|
|
90
|
+
const view = new DataView(head.buffer, head.byteOffset, head.byteLength);
|
|
91
|
+
if (view.getUint32(4, true) !== 1)
|
|
92
|
+
fail('ASSET_BUNDLE_FORMAT_INVALID', 'version');
|
|
93
|
+
const indexBytes = view.getUint32(8, true);
|
|
94
|
+
if (indexBytes < 2 || indexBytes > MAX_INDEX)
|
|
95
|
+
fail('ASSET_BUNDLE_FORMAT_INVALID', 'index length');
|
|
96
|
+
return { indexBytes };
|
|
97
|
+
}
|
|
98
|
+
/** The index of a bundle from its first bytes: at least the header and the index. */
|
|
99
|
+
export function readAssetBundleIndex(head) {
|
|
100
|
+
const { indexBytes } = readAssetBundleHeader(head);
|
|
101
|
+
if (head.length < HEADER + indexBytes)
|
|
102
|
+
fail('ASSET_BUNDLE_FORMAT_INVALID', 'index cut short');
|
|
103
|
+
let index;
|
|
104
|
+
try {
|
|
105
|
+
index = JSON.parse(new codecs.TextDecoder('utf-8', { fatal: true }).decode(head.subarray(HEADER, HEADER + indexBytes)));
|
|
106
|
+
}
|
|
107
|
+
catch (cause) {
|
|
108
|
+
throw new EgretError('ASSET_BUNDLE_FORMAT_INVALID', { cause });
|
|
109
|
+
}
|
|
110
|
+
if (!index ||
|
|
111
|
+
index.version !== 1 ||
|
|
112
|
+
!Number.isSafeInteger(index.size) ||
|
|
113
|
+
!Number.isSafeInteger(index.dataOffset) ||
|
|
114
|
+
index.dataOffset < HEADER + indexBytes ||
|
|
115
|
+
!Array.isArray(index.entries) ||
|
|
116
|
+
index.entries.length > MAX_ENTRIES)
|
|
117
|
+
fail('ASSET_BUNDLE_FORMAT_INVALID', 'index');
|
|
118
|
+
let end = index.dataOffset;
|
|
119
|
+
const names = new Set();
|
|
120
|
+
for (const entry of index.entries) {
|
|
121
|
+
if (typeof entry?.name !== 'string' ||
|
|
122
|
+
names.has(entry.name) ||
|
|
123
|
+
!Number.isSafeInteger(entry.offset) ||
|
|
124
|
+
!Number.isSafeInteger(entry.size) ||
|
|
125
|
+
entry.offset < end ||
|
|
126
|
+
entry.size < 0 ||
|
|
127
|
+
entry.offset + entry.size > index.size ||
|
|
128
|
+
typeof entry.type !== 'string' ||
|
|
129
|
+
!Array.isArray(entry.tags) ||
|
|
130
|
+
typeof entry.check !== 'string')
|
|
131
|
+
fail('ASSET_BUNDLE_FORMAT_INVALID', 'entry ' + String(entry?.name));
|
|
132
|
+
names.add(entry.name);
|
|
133
|
+
end = entry.offset + entry.size;
|
|
134
|
+
}
|
|
135
|
+
return Object.freeze({
|
|
136
|
+
...index,
|
|
137
|
+
entries: Object.freeze(index.entries.map(e => Object.freeze({ ...e, tags: Object.freeze([...e.tags]) })))
|
|
138
|
+
});
|
|
139
|
+
}
|
|
140
|
+
/**
|
|
141
|
+
* The bytes of one entry from bytes of the bundle that start at `start` (0 for the whole file), checked against
|
|
142
|
+
* the index. The result shares memory with `bytes`.
|
|
143
|
+
*/
|
|
144
|
+
export function sliceAssetBundle(index, name, bytes, start = 0) {
|
|
145
|
+
const entry = index.entries.find(e => e.name === name);
|
|
146
|
+
if (!entry)
|
|
147
|
+
return fail('ASSET_BUNDLE_ENTRY_MISSING', name);
|
|
148
|
+
const from = entry.offset - start;
|
|
149
|
+
if (from < 0 || from + entry.size > bytes.length)
|
|
150
|
+
fail('ASSET_BUNDLE_RANGE_INVALID', name);
|
|
151
|
+
const slice = bytes.subarray(from, from + entry.size);
|
|
152
|
+
if (assetBundleCheck(slice) !== entry.check)
|
|
153
|
+
fail('ASSET_BUNDLE_CHECK_FAILED', name);
|
|
154
|
+
return slice;
|
|
155
|
+
}
|
|
156
|
+
/** Ranges of the file that hold the named entries, joined where they touch or lie within `gap` bytes. */
|
|
157
|
+
export function planAssetBundleRanges(index, names, gap = 64 * 1024) {
|
|
158
|
+
const wanted = names.map(name => index.entries.find(e => e.name === name) ?? fail('ASSET_BUNDLE_ENTRY_MISSING', name));
|
|
159
|
+
wanted.sort((a, b) => a.offset - b.offset);
|
|
160
|
+
const ranges = [];
|
|
161
|
+
for (const entry of wanted) {
|
|
162
|
+
const last = ranges[ranges.length - 1];
|
|
163
|
+
const end = entry.offset + entry.size;
|
|
164
|
+
if (last && entry.offset - last.end <= gap) {
|
|
165
|
+
last.end = Math.max(last.end, end);
|
|
166
|
+
last.names.push(entry.name);
|
|
167
|
+
}
|
|
168
|
+
else
|
|
169
|
+
ranges.push({ start: entry.offset, end, names: [entry.name] });
|
|
170
|
+
}
|
|
171
|
+
return ranges;
|
|
172
|
+
}
|
|
173
|
+
//# sourceMappingURL=assetBundle.js.map
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { Scope } from '@egret/runtime';
|
|
2
|
+
import type { AssetGroupOperations } from '@egret/runtime';
|
|
3
|
+
import type { Diagnostic } from '@egret/contracts';
|
|
4
|
+
import type { AssetGroup } from './assetGroupTypes.js';
|
|
5
|
+
export interface AssetGroupContext {
|
|
6
|
+
assertOpen(): void;
|
|
7
|
+
isEngineScope(scope: unknown): scope is Scope;
|
|
8
|
+
report(diagnostic: Diagnostic): void;
|
|
9
|
+
captureCleanup(cause: unknown): void;
|
|
10
|
+
}
|
|
11
|
+
export interface AssetGroupOwner {
|
|
12
|
+
create<T>(scope: unknown, refs: unknown, options: unknown): AssetGroup<T>;
|
|
13
|
+
close(): void;
|
|
14
|
+
}
|
|
15
|
+
/** Admission is inert; clear busy before activation can invoke any provider. */
|
|
16
|
+
export declare function createAssetGroupOwner(context: AssetGroupContext, operations: AssetGroupOperations): AssetGroupOwner;
|
|
17
|
+
//# sourceMappingURL=assetGroup.d.ts.map
|
|
@@ -0,0 +1,332 @@
|
|
|
1
|
+
import { CancellationController, EgretError, Scope } from '@egret/runtime';
|
|
2
|
+
const APPLY = Reflect.apply;
|
|
3
|
+
const FREEZE = Object.freeze;
|
|
4
|
+
const IS_ARRAY = Array.isArray;
|
|
5
|
+
const HAS_OWN = Object.prototype.hasOwnProperty;
|
|
6
|
+
const PROMISE_THEN = Promise.prototype.then;
|
|
7
|
+
const SCOPE_STATE = Object.getOwnPropertyDescriptor(Scope.prototype, 'state').get;
|
|
8
|
+
const SCOPE_USE = Scope.prototype.use;
|
|
9
|
+
const ABORT = CancellationController.prototype.abort;
|
|
10
|
+
/** Genuine membership precedes captured state reads, including admission reentry. */
|
|
11
|
+
function assertLifetime(context, scope) {
|
|
12
|
+
context.assertOpen();
|
|
13
|
+
if (!context.isEngineScope(scope))
|
|
14
|
+
throw new EgretError('ASSET_GROUP_SCOPE_INVALID');
|
|
15
|
+
if (APPLY(SCOPE_STATE, scope, []) !== 'open')
|
|
16
|
+
throw new EgretError('SCOPE_CLOSED');
|
|
17
|
+
}
|
|
18
|
+
/** Both successful reads and thrown undefined recheck Engine then Scope first. */
|
|
19
|
+
function callerRead(read, code, context, scope) {
|
|
20
|
+
let value;
|
|
21
|
+
let failed = false;
|
|
22
|
+
let cause;
|
|
23
|
+
try {
|
|
24
|
+
value = read();
|
|
25
|
+
}
|
|
26
|
+
catch (failure) {
|
|
27
|
+
failed = true;
|
|
28
|
+
cause = failure;
|
|
29
|
+
}
|
|
30
|
+
assertLifetime(context, scope);
|
|
31
|
+
if (failed)
|
|
32
|
+
throw new EgretError(code, { cause });
|
|
33
|
+
return value;
|
|
34
|
+
}
|
|
35
|
+
function admitRefs(context, scope, refs) {
|
|
36
|
+
if (!callerRead(() => IS_ARRAY(refs), 'ASSET_GROUP_REFS_INVALID', context, scope))
|
|
37
|
+
throw new EgretError('ASSET_GROUP_REFS_INVALID');
|
|
38
|
+
const array = refs;
|
|
39
|
+
const length = callerRead(() => array.length, 'ASSET_GROUP_REFS_INVALID', context, scope);
|
|
40
|
+
if (!Number.isInteger(length) || length < 0 || length > 128)
|
|
41
|
+
throw new EgretError('ASSET_GROUP_REFS_INVALID');
|
|
42
|
+
const snapshot = [];
|
|
43
|
+
for (let index = 0; index < length; index++) {
|
|
44
|
+
// Own-position proxy traps are caller reads too; inherited refs fill no hole.
|
|
45
|
+
const own = callerRead(() => APPLY(HAS_OWN, array, [index]), 'ASSET_GROUP_REFS_INVALID', context, scope);
|
|
46
|
+
if (!own)
|
|
47
|
+
throw new EgretError('ASSET_GROUP_REFS_INVALID');
|
|
48
|
+
snapshot.push(callerRead(() => array[index], 'ASSET_GROUP_REFS_INVALID', context, scope));
|
|
49
|
+
}
|
|
50
|
+
return FREEZE(snapshot);
|
|
51
|
+
}
|
|
52
|
+
function admitConcurrency(context, scope, options) {
|
|
53
|
+
if (options === undefined)
|
|
54
|
+
return 4;
|
|
55
|
+
if (typeof options !== 'object' || options === null)
|
|
56
|
+
throw new EgretError('ASSET_GROUP_OPTIONS_INVALID');
|
|
57
|
+
if (callerRead(() => IS_ARRAY(options), 'ASSET_GROUP_OPTIONS_INVALID', context, scope))
|
|
58
|
+
throw new EgretError('ASSET_GROUP_OPTIONS_INVALID');
|
|
59
|
+
const requested = callerRead(() => options.concurrency, 'ASSET_GROUP_OPTIONS_INVALID', context, scope);
|
|
60
|
+
const concurrency = requested === undefined ? 4 : requested;
|
|
61
|
+
if (typeof concurrency !== 'number' || !Number.isInteger(concurrency) || concurrency < 1 || concurrency > 16)
|
|
62
|
+
throw new EgretError('ASSET_GROUP_OPTIONS_INVALID');
|
|
63
|
+
return concurrency;
|
|
64
|
+
}
|
|
65
|
+
/** This is an observation-order choice, never a synthesized acquisition failure. */
|
|
66
|
+
function disposalCause(record) {
|
|
67
|
+
try {
|
|
68
|
+
record.context.assertOpen();
|
|
69
|
+
}
|
|
70
|
+
catch (cause) {
|
|
71
|
+
return cause;
|
|
72
|
+
}
|
|
73
|
+
const scope = record.scope;
|
|
74
|
+
if (scope !== undefined && APPLY(SCOPE_STATE, scope, []) !== 'open')
|
|
75
|
+
return new EgretError('SCOPE_CLOSED');
|
|
76
|
+
return undefined;
|
|
77
|
+
}
|
|
78
|
+
function reportCleanup(record, cause) {
|
|
79
|
+
record.context.captureCleanup(cause);
|
|
80
|
+
record.context.report({ code: 'ASSET_GROUP_CLEANUP_FAILED', phase: 'assets', severity: 'error', cause });
|
|
81
|
+
}
|
|
82
|
+
/** Consume routing and member borrows before cancellation/disposal can reenter. */
|
|
83
|
+
function commitTerminal(record, state, cause) {
|
|
84
|
+
if (record.state === 'failed' || record.state === 'disposed')
|
|
85
|
+
return undefined;
|
|
86
|
+
const pending = record.state === 'pending';
|
|
87
|
+
record.state = state;
|
|
88
|
+
const error = new EgretError(state === 'failed' ? 'ASSET_GROUP_ACQUIRE_FAILED' : 'ASSET_GROUP_DISPOSED', { cause });
|
|
89
|
+
if (pending)
|
|
90
|
+
record.rejectReady(error);
|
|
91
|
+
record.refs = undefined;
|
|
92
|
+
record.scope = undefined;
|
|
93
|
+
record.facade = undefined;
|
|
94
|
+
record.owner?.delete(record);
|
|
95
|
+
record.owner = undefined;
|
|
96
|
+
const members = record.members;
|
|
97
|
+
record.members = [];
|
|
98
|
+
return { record, error, members };
|
|
99
|
+
}
|
|
100
|
+
function releaseMember(record, lease) {
|
|
101
|
+
try {
|
|
102
|
+
record.operations.releaseGroupLease(lease);
|
|
103
|
+
}
|
|
104
|
+
catch (cause) {
|
|
105
|
+
reportCleanup(record, cause);
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
/** Manager-caught provider faults keep its ASSET_CLEANUP_FAILED diagnostic. */
|
|
109
|
+
function runCleanup(snapshot) {
|
|
110
|
+
const { record, error, members } = snapshot;
|
|
111
|
+
try {
|
|
112
|
+
APPLY(ABORT, record.controller, [error]);
|
|
113
|
+
}
|
|
114
|
+
catch (cause) {
|
|
115
|
+
reportCleanup(record, cause);
|
|
116
|
+
}
|
|
117
|
+
for (let index = members.length - 1; index >= 0; index--) {
|
|
118
|
+
const member = members[index];
|
|
119
|
+
if (member !== undefined)
|
|
120
|
+
releaseMember(record, member);
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
function terminate(record, state, cause) {
|
|
124
|
+
const snapshot = commitTerminal(record, state, cause);
|
|
125
|
+
if (snapshot !== undefined)
|
|
126
|
+
runCleanup(snapshot);
|
|
127
|
+
}
|
|
128
|
+
function requirePendingLifetime(record) {
|
|
129
|
+
if (record.state !== 'pending')
|
|
130
|
+
return false;
|
|
131
|
+
try {
|
|
132
|
+
assertLifetime(record.context, record.scope);
|
|
133
|
+
return true;
|
|
134
|
+
}
|
|
135
|
+
catch (cause) {
|
|
136
|
+
terminate(record, 'disposed', cause);
|
|
137
|
+
return false;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
function fulfillMember(record, index, lease) {
|
|
141
|
+
if (!requirePendingLifetime(record)) {
|
|
142
|
+
releaseMember(record, lease);
|
|
143
|
+
return;
|
|
144
|
+
}
|
|
145
|
+
try {
|
|
146
|
+
record.operations.claimGroupLease(lease, record.facade);
|
|
147
|
+
}
|
|
148
|
+
catch (cause) {
|
|
149
|
+
// Commit failure first, then retire the unpublished lease alongside known members.
|
|
150
|
+
terminate(record, 'failed', cause);
|
|
151
|
+
releaseMember(record, lease);
|
|
152
|
+
return;
|
|
153
|
+
}
|
|
154
|
+
record.members[index] = lease;
|
|
155
|
+
record.completed++;
|
|
156
|
+
if (record.completed === record.members.length) {
|
|
157
|
+
record.state = 'ready';
|
|
158
|
+
record.refs = undefined;
|
|
159
|
+
record.resolveReady(FREEZE(record.members.slice()));
|
|
160
|
+
return;
|
|
161
|
+
}
|
|
162
|
+
schedule(record);
|
|
163
|
+
}
|
|
164
|
+
function rejectMember(record, cause) {
|
|
165
|
+
if (!requirePendingLifetime(record))
|
|
166
|
+
return;
|
|
167
|
+
terminate(record, 'failed', cause);
|
|
168
|
+
}
|
|
169
|
+
/** Reserve before acquire; a synchronous provider may already close this group. */
|
|
170
|
+
function startMember(record, index, ref) {
|
|
171
|
+
record.outstanding++;
|
|
172
|
+
let active = true;
|
|
173
|
+
const retireSlot = () => {
|
|
174
|
+
if (!active)
|
|
175
|
+
return;
|
|
176
|
+
active = false;
|
|
177
|
+
record.outstanding--;
|
|
178
|
+
};
|
|
179
|
+
try {
|
|
180
|
+
const promise = record.operations.acquire(ref, { signal: record.controller.signal });
|
|
181
|
+
const continuation = APPLY(PROMISE_THEN, promise, [
|
|
182
|
+
(lease) => {
|
|
183
|
+
retireSlot();
|
|
184
|
+
fulfillMember(record, index, lease);
|
|
185
|
+
},
|
|
186
|
+
(cause) => {
|
|
187
|
+
retireSlot();
|
|
188
|
+
rejectMember(record, cause);
|
|
189
|
+
}
|
|
190
|
+
]);
|
|
191
|
+
// Consume even an unexpected internal handler throw without a detached rejection.
|
|
192
|
+
void APPLY(PROMISE_THEN, continuation, [
|
|
193
|
+
undefined,
|
|
194
|
+
(cause) => {
|
|
195
|
+
retireSlot();
|
|
196
|
+
rejectMember(record, cause);
|
|
197
|
+
}
|
|
198
|
+
]);
|
|
199
|
+
}
|
|
200
|
+
catch (cause) {
|
|
201
|
+
retireSlot();
|
|
202
|
+
rejectMember(record, cause);
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
/** The window bounds this group's unsettled acquisitions, not provider activity. */
|
|
206
|
+
function schedule(record) {
|
|
207
|
+
if (record.scheduling || record.state !== 'pending')
|
|
208
|
+
return;
|
|
209
|
+
record.scheduling = true;
|
|
210
|
+
try {
|
|
211
|
+
while (record.state === 'pending' && record.outstanding < record.concurrency) {
|
|
212
|
+
if (!requirePendingLifetime(record))
|
|
213
|
+
return;
|
|
214
|
+
const refs = record.refs;
|
|
215
|
+
if (record.nextIndex === refs.length)
|
|
216
|
+
return;
|
|
217
|
+
const index = record.nextIndex++;
|
|
218
|
+
startMember(record, index, refs[index]);
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
finally {
|
|
222
|
+
record.scheduling = false;
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
function makeRecord(context, operations, scope, refs, concurrency) {
|
|
226
|
+
let resolveReady;
|
|
227
|
+
let rejectReady;
|
|
228
|
+
const ready = new Promise((resolve, reject) => {
|
|
229
|
+
resolveReady = resolve;
|
|
230
|
+
rejectReady = reject;
|
|
231
|
+
});
|
|
232
|
+
// Own the rejection from creation, including disposal during the first loader.
|
|
233
|
+
void APPLY(PROMISE_THEN, ready, [undefined, () => { }]);
|
|
234
|
+
return {
|
|
235
|
+
context,
|
|
236
|
+
operations,
|
|
237
|
+
scope,
|
|
238
|
+
refs,
|
|
239
|
+
concurrency,
|
|
240
|
+
ready,
|
|
241
|
+
resolveReady,
|
|
242
|
+
rejectReady,
|
|
243
|
+
controller: new CancellationController(),
|
|
244
|
+
members: Array(refs.length),
|
|
245
|
+
owner: undefined,
|
|
246
|
+
facade: undefined,
|
|
247
|
+
state: 'pending',
|
|
248
|
+
nextIndex: 0,
|
|
249
|
+
outstanding: 0,
|
|
250
|
+
completed: 0,
|
|
251
|
+
scheduling: false
|
|
252
|
+
};
|
|
253
|
+
}
|
|
254
|
+
function makeHandle(record) {
|
|
255
|
+
function assertReceiver(receiver) {
|
|
256
|
+
if (receiver !== group)
|
|
257
|
+
throw new EgretError('ASSET_GROUP_INVALID');
|
|
258
|
+
}
|
|
259
|
+
const group = FREEZE({
|
|
260
|
+
get state() {
|
|
261
|
+
assertReceiver(this);
|
|
262
|
+
return record.state;
|
|
263
|
+
},
|
|
264
|
+
get ready() {
|
|
265
|
+
assertReceiver(this);
|
|
266
|
+
return record.ready;
|
|
267
|
+
},
|
|
268
|
+
dispose() {
|
|
269
|
+
assertReceiver(this);
|
|
270
|
+
terminate(record, 'disposed', disposalCause(record));
|
|
271
|
+
}
|
|
272
|
+
});
|
|
273
|
+
record.facade = group;
|
|
274
|
+
return group;
|
|
275
|
+
}
|
|
276
|
+
/** Admission is inert; clear busy before activation can invoke any provider. */
|
|
277
|
+
export function createAssetGroupOwner(context, operations) {
|
|
278
|
+
const records = new Set();
|
|
279
|
+
let admissionBusy = false;
|
|
280
|
+
return FREEZE({
|
|
281
|
+
create(scope, refs, options) {
|
|
282
|
+
assertLifetime(context, scope);
|
|
283
|
+
if (admissionBusy)
|
|
284
|
+
throw new EgretError('ASSET_GROUP_REENTRANT');
|
|
285
|
+
admissionBusy = true;
|
|
286
|
+
let record;
|
|
287
|
+
let group;
|
|
288
|
+
try {
|
|
289
|
+
const snapshot = admitRefs(context, scope, refs);
|
|
290
|
+
const concurrency = admitConcurrency(context, scope, options);
|
|
291
|
+
operations.admitGroupRefs(snapshot);
|
|
292
|
+
record = makeRecord(context, operations, scope, snapshot, concurrency);
|
|
293
|
+
group = makeHandle(record);
|
|
294
|
+
try {
|
|
295
|
+
APPLY(SCOPE_USE, scope, [group]);
|
|
296
|
+
assertLifetime(context, scope);
|
|
297
|
+
}
|
|
298
|
+
catch (cause) {
|
|
299
|
+
terminate(record, 'disposed', cause);
|
|
300
|
+
throw cause;
|
|
301
|
+
}
|
|
302
|
+
record.owner = records;
|
|
303
|
+
records.add(record);
|
|
304
|
+
}
|
|
305
|
+
finally {
|
|
306
|
+
admissionBusy = false;
|
|
307
|
+
}
|
|
308
|
+
if (record.members.length === 0) {
|
|
309
|
+
if (requirePendingLifetime(record)) {
|
|
310
|
+
record.state = 'ready';
|
|
311
|
+
record.refs = undefined;
|
|
312
|
+
record.resolveReady(FREEZE([]));
|
|
313
|
+
}
|
|
314
|
+
}
|
|
315
|
+
else
|
|
316
|
+
schedule(record);
|
|
317
|
+
return group;
|
|
318
|
+
},
|
|
319
|
+
close() {
|
|
320
|
+
// Every pending/ready group is terminal before the first abort/release hook.
|
|
321
|
+
const snapshots = [];
|
|
322
|
+
for (const record of records) {
|
|
323
|
+
const snapshot = commitTerminal(record, 'disposed', new EgretError('ENGINE_CLOSED'));
|
|
324
|
+
if (snapshot !== undefined)
|
|
325
|
+
snapshots.push(snapshot);
|
|
326
|
+
}
|
|
327
|
+
for (const snapshot of snapshots)
|
|
328
|
+
runCleanup(snapshot);
|
|
329
|
+
}
|
|
330
|
+
});
|
|
331
|
+
}
|
|
332
|
+
//# sourceMappingURL=assetGroup.js.map
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { AssetLease } from '@egret/runtime';
|
|
2
|
+
declare const assetGroupBrand: unique symbol;
|
|
3
|
+
/** Whether an asset group is loading, ready, failed or disposed. */
|
|
4
|
+
export type AssetGroupState = 'pending' | 'ready' | 'failed' | 'disposed';
|
|
5
|
+
/** How many of a group's assets load at once. */
|
|
6
|
+
export interface AssetGroupOptions {
|
|
7
|
+
readonly concurrency?: number;
|
|
8
|
+
}
|
|
9
|
+
/** One opaque cleanup owner; members remain borrowed genuine invariant leases. */
|
|
10
|
+
export interface AssetGroup<T> {
|
|
11
|
+
readonly [assetGroupBrand]: true;
|
|
12
|
+
readonly state: AssetGroupState;
|
|
13
|
+
readonly ready: Promise<readonly AssetLease<T>[]>;
|
|
14
|
+
dispose(): void;
|
|
15
|
+
}
|
|
16
|
+
export {};
|
|
17
|
+
//# sourceMappingURL=assetGroupTypes.d.ts.map
|
package/dist/audio.d.ts
ADDED
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
/** Optional sound for a 2D game, free of the DOM; importing it creates no output and starts no work. */
|
|
2
|
+
export { createAudioMixer } from './audioMixer.js';
|
|
3
|
+
export type { AudioBackend, AudioBackendBus, AudioBackendSound, AudioBackendStart, AudioBackendVoice, AudioBus, AudioBusOptions, AudioBusSnapshot, AudioEndReason, AudioFade, AudioMixer, AudioMixerOptions, AudioMixerSnapshot, AudioMixerState, AudioMusicOptions, AudioPlayOptions, AudioSound, AudioVoice, AudioVoiceState } from './audioTypes.js';
|
|
4
|
+
//# sourceMappingURL=audio.d.ts.map
|
package/dist/audio.js
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import type { AudioMixer, AudioSound, AudioVoice } from './audioTypes.js';
|
|
2
|
+
/** A named sound effect: its takes, its bus and volume, and how often and how many at once it plays. */
|
|
3
|
+
export interface AudioCueDefinition {
|
|
4
|
+
/** The takes; one is chosen each time. */
|
|
5
|
+
readonly sounds: readonly AudioSound[];
|
|
6
|
+
/** Defaults to the mixer's effects bus. */
|
|
7
|
+
readonly bus?: string;
|
|
8
|
+
/** Volume, as one number or a range that each play picks within. Defaults to 1. */
|
|
9
|
+
readonly volume?: number | readonly [number, number];
|
|
10
|
+
/** Rate (pitch and speed), as one number or a range. Defaults to 1. */
|
|
11
|
+
readonly rate?: number | readonly [number, number];
|
|
12
|
+
/** Seconds that must pass before the cue sounds again; plays inside it are skipped. Defaults to 0. */
|
|
13
|
+
readonly cooldown?: number;
|
|
14
|
+
/** At most this many voices of the cue at once; the oldest gives its place. Defaults to 4. */
|
|
15
|
+
readonly maxVoices?: number;
|
|
16
|
+
}
|
|
17
|
+
/** How one play of a cue differs: its volume, pan and rate. */
|
|
18
|
+
export interface AudioCuePlayOptions {
|
|
19
|
+
/** Multiplies the cue's volume, as for distance. */
|
|
20
|
+
readonly volume?: number;
|
|
21
|
+
readonly pan?: number;
|
|
22
|
+
/** Multiplies the chosen rate. */
|
|
23
|
+
readonly rate?: number;
|
|
24
|
+
}
|
|
25
|
+
/** Sound effects by name, each with its takes, cool-down and voice limit. */
|
|
26
|
+
export interface AudioCues {
|
|
27
|
+
/** Plays a take of the cue, or nothing when it is cooling down. */
|
|
28
|
+
play(name: string, options?: AudioCuePlayOptions): AudioVoice | undefined;
|
|
29
|
+
/** Stops every voice of a cue. */
|
|
30
|
+
stop(name: string, fade?: number): void;
|
|
31
|
+
readonly names: readonly string[];
|
|
32
|
+
}
|
|
33
|
+
/** The clock and the random numbers cues choose by; give your own for tests and replays. */
|
|
34
|
+
export interface AudioCuesOptions {
|
|
35
|
+
/** Seconds now; `performance.now()` by default. Tests and replays give their own clock. */
|
|
36
|
+
readonly now?: () => number;
|
|
37
|
+
/** Numbers from 0 to 1 for choosing takes and ranges; `Math.random` by default. */
|
|
38
|
+
readonly random?: () => number;
|
|
39
|
+
}
|
|
40
|
+
/** Names the sound effects of a game over `mixer`. */
|
|
41
|
+
export declare function createAudioCues(mixer: AudioMixer, cues: Readonly<Record<string, AudioCueDefinition>>, options?: AudioCuesOptions): AudioCues;
|
|
42
|
+
/**
|
|
43
|
+
* 16-bit PCM WAV bytes from channels of samples between -1 and 1, all the same length. The mixer decodes them
|
|
44
|
+
* like a file, so sounds a game synthesised can be played, mixed and limited like recorded ones.
|
|
45
|
+
*/
|
|
46
|
+
export declare function encodeWav(channels: readonly Float32Array[], sampleRate: number): Uint8Array<ArrayBuffer>;
|
|
47
|
+
//# sourceMappingURL=audioCues.d.ts.map
|