@nayan-ui/engine 1.0.0-beta.3 → 1.0.0-beta.5

package/native/cpp/generated/NayanEngineSpecJSI.h

@@ -70,12 +70,14 @@ protected:
     methodMap_["shapePrepare"] = MethodMetadata {.argCount = 3, .invoker = __shapePrepare};
     methodMap_["solidPrepare"] = MethodMetadata {.argCount = 2, .invoker = __solidPrepare};
     methodMap_["modelLoad"] = MethodMetadata {.argCount = 3, .invoker = __modelLoad};
+    methodMap_["modelLoadAsync"] = MethodMetadata {.argCount = 3, .invoker = __modelLoadAsync};
     methodMap_["modelVertices"] = MethodMetadata {.argCount = 1, .invoker = __modelVertices};
     methodMap_["modelIndices"] = MethodMetadata {.argCount = 1, .invoker = __modelIndices};
     methodMap_["modelSize"] = MethodMetadata {.argCount = 1, .invoker = __modelSize};
     methodMap_["modelTexture"] = MethodMetadata {.argCount = 1, .invoker = __modelTexture};
     methodMap_["meshAlias"] = MethodMetadata {.argCount = 1, .invoker = __meshAlias};
     methodMap_["meshCreate"] = MethodMetadata {.argCount = 2, .invoker = __meshCreate};
+    methodMap_["renderModel"] = MethodMetadata {.argCount = 3, .invoker = __renderModel};
     methodMap_["pathExtrude"] = MethodMetadata {.argCount = 4, .invoker = __pathExtrude};
     methodMap_["geometrySmoothNormals"] = MethodMetadata {.argCount = 2, .invoker = __geometrySmoothNormals};
     methodMap_["geometrySolid"] = MethodMetadata {.argCount = 1, .invoker = __geometrySolid};
@@ -83,9 +85,11 @@ protected:
     methodMap_["geometryFaceOutward"] = MethodMetadata {.argCount = 2, .invoker = __geometryFaceOutward};
     methodMap_["geometryPlace"] = MethodMetadata {.argCount = 8, .invoker = __geometryPlace};
     methodMap_["textureLoad"] = MethodMetadata {.argCount = 1, .invoker = __textureLoad};
+    methodMap_["textureLoadAsync"] = MethodMetadata {.argCount = 1, .invoker = __textureLoadAsync};
     methodMap_["texturePixels"] = MethodMetadata {.argCount = 1, .invoker = __texturePixels};
     methodMap_["textureSize"] = MethodMetadata {.argCount = 1, .invoker = __textureSize};
     methodMap_["fontLoad"] = MethodMetadata {.argCount = 4, .invoker = __fontLoad};
+    methodMap_["fontLoadAsync"] = MethodMetadata {.argCount = 4, .invoker = __fontLoadAsync};
     methodMap_["fontGlyphs"] = MethodMetadata {.argCount = 1, .invoker = __fontGlyphs};
     methodMap_["loadError"] = MethodMetadata {.argCount = 0, .invoker = __loadError};
     methodMap_["generateBuiltinMeshes"] = MethodMetadata {.argCount = 0, .invoker = __generateBuiltinMeshes};
@@ -94,6 +98,11 @@ protected:
     methodMap_["renderMeshIndices"] = MethodMetadata {.argCount = 1, .invoker = __renderMeshIndices};
     methodMap_["renderMesh"] = MethodMetadata {.argCount = 5, .invoker = __renderMesh};
     methodMap_["renderFrame"] = MethodMetadata {.argCount = 9, .invoker = __renderFrame};
+    methodMap_["publishFrame"] = MethodMetadata {.argCount = 9, .invoker = __publishFrame};
+    methodMap_["renderStats"] = MethodMetadata {.argCount = 1, .invoker = __renderStats};
+    methodMap_["hasFrameClock"] = MethodMetadata {.argCount = 0, .invoker = __hasFrameClock};
+    methodMap_["startFrames"] = MethodMetadata {.argCount = 2, .invoker = __startFrames};
+    methodMap_["stopFrames"] = MethodMetadata {.argCount = 1, .invoker = __stopFrames};
     methodMap_["renderOverlay"] = MethodMetadata {.argCount = 8, .invoker = __renderOverlay};
     methodMap_["renderError"] = MethodMetadata {.argCount = 0, .invoker = __renderError};
     methodMap_["renderBackend"] = MethodMetadata {.argCount = 0, .invoker = __renderBackend};
@@ -101,6 +110,7 @@ protected:
     methodMap_["drawingCommand"] = MethodMetadata {.argCount = 2, .invoker = __drawingCommand};
     methodMap_["drawingDestroy"] = MethodMetadata {.argCount = 1, .invoker = __drawingDestroy};
     methodMap_["audioLoad"] = MethodMetadata {.argCount = 1, .invoker = __audioLoad};
+    methodMap_["audioLoadAsync"] = MethodMetadata {.argCount = 1, .invoker = __audioLoadAsync};
     methodMap_["audioPlay"] = MethodMetadata {.argCount = 5, .invoker = __audioPlay};
     methodMap_["audioStop"] = MethodMetadata {.argCount = 1, .invoker = __audioStop};
     methodMap_["audioSetVolume"] = MethodMetadata {.argCount = 1, .invoker = __audioSetVolume};
@@ -573,6 +583,16 @@ private:
       count <= 2 ? throw jsi::JSError(rt, "Expected argument in position 2 to be passed") : args[2].asNumber());
   }
 
+  static jsi::Value __modelLoadAsync(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+    static_assert(
+      bridging::getParameterCount(&T::modelLoadAsync) == 4,
+      "Expected modelLoadAsync(...) to have 4 parameters");
+    return bridging::callFromJs<jsi::Value>(rt, &T::modelLoadAsync,  static_cast<NativeNayanEngineCxxSpec*>(&turboModule)->jsInvoker_, static_cast<T*>(&turboModule),
+      count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asObject(rt),
+      count <= 1 ? throw jsi::JSError(rt, "Expected argument in position 1 to be passed") : args[1].asBool(),
+      count <= 2 ? throw jsi::JSError(rt, "Expected argument in position 2 to be passed") : args[2].asNumber());
+  }
+
   static jsi::Value __modelVertices(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
     static_assert(
       bridging::getParameterCount(&T::modelVertices) == 2,
@@ -622,6 +642,16 @@ private:
       count <= 1 ? throw jsi::JSError(rt, "Expected argument in position 1 to be passed") : args[1].asObject(rt));
   }
 
+  static jsi::Value __renderModel(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+    static_assert(
+      bridging::getParameterCount(&T::renderModel) == 4,
+      "Expected renderModel(...) to have 4 parameters");
+    return bridging::callFromJs<bool>(rt, &T::renderModel,  static_cast<NativeNayanEngineCxxSpec*>(&turboModule)->jsInvoker_, static_cast<T*>(&turboModule),
+      count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asNumber(),
+      count <= 1 ? throw jsi::JSError(rt, "Expected argument in position 1 to be passed") : args[1].asNumber(),
+      count <= 2 ? throw jsi::JSError(rt, "Expected argument in position 2 to be passed") : args[2].asNumber());
+  }
+
   static jsi::Value __pathExtrude(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
     static_assert(
       bridging::getParameterCount(&T::pathExtrude) == 5,
@@ -694,6 +724,14 @@ private:
       count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asObject(rt));
   }
 
+  static jsi::Value __textureLoadAsync(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+    static_assert(
+      bridging::getParameterCount(&T::textureLoadAsync) == 2,
+      "Expected textureLoadAsync(...) to have 2 parameters");
+    return bridging::callFromJs<jsi::Value>(rt, &T::textureLoadAsync,  static_cast<NativeNayanEngineCxxSpec*>(&turboModule)->jsInvoker_, static_cast<T*>(&turboModule),
+      count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asObject(rt));
+  }
+
   static jsi::Value __texturePixels(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
     static_assert(
       bridging::getParameterCount(&T::texturePixels) == 2,
@@ -721,6 +759,17 @@ private:
       count <= 3 ? throw jsi::JSError(rt, "Expected argument in position 3 to be passed") : args[3].asNumber());
   }
 
+  static jsi::Value __fontLoadAsync(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+    static_assert(
+      bridging::getParameterCount(&T::fontLoadAsync) == 5,
+      "Expected fontLoadAsync(...) to have 5 parameters");
+    return bridging::callFromJs<jsi::Value>(rt, &T::fontLoadAsync,  static_cast<NativeNayanEngineCxxSpec*>(&turboModule)->jsInvoker_, static_cast<T*>(&turboModule),
+      count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asObject(rt),
+      count <= 1 ? throw jsi::JSError(rt, "Expected argument in position 1 to be passed") : args[1].asNumber(),
+      count <= 2 ? throw jsi::JSError(rt, "Expected argument in position 2 to be passed") : args[2].asString(rt),
+      count <= 3 ? throw jsi::JSError(rt, "Expected argument in position 3 to be passed") : args[3].asNumber());
+  }
+
   static jsi::Value __fontGlyphs(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
     static_assert(
       bridging::getParameterCount(&T::fontGlyphs) == 2,
@@ -794,6 +843,54 @@ private:
       count <= 8 ? throw jsi::JSError(rt, "Expected argument in position 8 to be passed") : args[8].asNumber());
   }
 
+  static jsi::Value __publishFrame(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+    static_assert(
+      bridging::getParameterCount(&T::publishFrame) == 10,
+      "Expected publishFrame(...) to have 10 parameters");
+    return bridging::callFromJs<double>(rt, &T::publishFrame,  static_cast<NativeNayanEngineCxxSpec*>(&turboModule)->jsInvoker_, static_cast<T*>(&turboModule),
+      count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asNumber(),
+      count <= 1 ? throw jsi::JSError(rt, "Expected argument in position 1 to be passed") : args[1].asObject(rt),
+      count <= 2 ? throw jsi::JSError(rt, "Expected argument in position 2 to be passed") : args[2].asObject(rt),
+      count <= 3 ? throw jsi::JSError(rt, "Expected argument in position 3 to be passed") : args[3].asObject(rt),
+      count <= 4 ? throw jsi::JSError(rt, "Expected argument in position 4 to be passed") : args[4].asObject(rt),
+      count <= 5 ? throw jsi::JSError(rt, "Expected argument in position 5 to be passed") : args[5].asObject(rt),
+      count <= 6 ? throw jsi::JSError(rt, "Expected argument in position 6 to be passed") : args[6].asNumber(),
+      count <= 7 ? throw jsi::JSError(rt, "Expected argument in position 7 to be passed") : args[7].asObject(rt),
+      count <= 8 ? throw jsi::JSError(rt, "Expected argument in position 8 to be passed") : args[8].asNumber());
+  }
+
+  static jsi::Value __renderStats(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+    static_assert(
+      bridging::getParameterCount(&T::renderStats) == 2,
+      "Expected renderStats(...) to have 2 parameters");
+    return bridging::callFromJs<jsi::Array>(rt, &T::renderStats,  static_cast<NativeNayanEngineCxxSpec*>(&turboModule)->jsInvoker_, static_cast<T*>(&turboModule),
+      count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asNumber());
+  }
+
+  static jsi::Value __hasFrameClock(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* /*args*/, size_t /*count*/) {
+    static_assert(
+      bridging::getParameterCount(&T::hasFrameClock) == 1,
+      "Expected hasFrameClock(...) to have 1 parameters");
+    return bridging::callFromJs<bool>(rt, &T::hasFrameClock,  static_cast<NativeNayanEngineCxxSpec*>(&turboModule)->jsInvoker_, static_cast<T*>(&turboModule));
+  }
+
+  static jsi::Value __startFrames(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+    static_assert(
+      bridging::getParameterCount(&T::startFrames) == 3,
+      "Expected startFrames(...) to have 3 parameters");
+    bridging::callFromJs<void>(rt, &T::startFrames,  static_cast<NativeNayanEngineCxxSpec*>(&turboModule)->jsInvoker_, static_cast<T*>(&turboModule),
+      count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asNumber(),
+      count <= 1 ? throw jsi::JSError(rt, "Expected argument in position 1 to be passed") : args[1].asObject(rt).asFunction(rt));return jsi::Value::undefined();
+  }
+
+  static jsi::Value __stopFrames(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+    static_assert(
+      bridging::getParameterCount(&T::stopFrames) == 2,
+      "Expected stopFrames(...) to have 2 parameters");
+    bridging::callFromJs<void>(rt, &T::stopFrames,  static_cast<NativeNayanEngineCxxSpec*>(&turboModule)->jsInvoker_, static_cast<T*>(&turboModule),
+      count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asNumber());return jsi::Value::undefined();
+  }
+
   static jsi::Value __renderOverlay(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
     static_assert(
       bridging::getParameterCount(&T::renderOverlay) == 9,
@@ -858,6 +955,14 @@ private:
       count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asObject(rt));
   }
 
+  static jsi::Value __audioLoadAsync(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+    static_assert(
+      bridging::getParameterCount(&T::audioLoadAsync) == 2,
+      "Expected audioLoadAsync(...) to have 2 parameters");
+    return bridging::callFromJs<jsi::Value>(rt, &T::audioLoadAsync,  static_cast<NativeNayanEngineCxxSpec*>(&turboModule)->jsInvoker_, static_cast<T*>(&turboModule),
+      count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asObject(rt));
+  }
+
   static jsi::Value __audioPlay(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
     static_assert(
       bridging::getParameterCount(&T::audioPlay) == 6,

package/native/ios/NayanEngineSurface.mm

@@ -1,5 +1,6 @@
 // The EngineSurface view: a CAMetalLayer the Rust renderer draws into with Metal. JS refers to it by
-// `surfaceId`; frames are drawn from the JS thread by NativeNayanEngine.renderFrame.
+// `surfaceId`. A display link asks the game for each frame on the JS thread (`deliverFrame`); the
+// frames it publishes are drawn on the engine's render thread.
 #import <QuartzCore/CAMetalLayer.h>
 #import <QuartzCore/CADisplayLink.h>
 #import <React/RCTViewManager.h>
@@ -7,6 +8,10 @@
 
 #include <engine_core.h>
 
+namespace facebook::react {
+void deliverFrame(int surface, double timeMs); // NayanEngineModule.cpp
+}
+
 @interface NayanEngineSurfaceView : UIView <UIGestureRecognizerDelegate>
 @property (nonatomic, assign) NSInteger surfaceId;
 @property (nonatomic, assign) NSInteger drawingId;
@@ -18,6 +23,7 @@
 @implementation NayanEngineSurfaceView {
   BOOL _attached;
   CADisplayLink *_drawingClock;
+  CADisplayLink *_clock;
   UITouch *_drawingTouch;
   UIPinchGestureRecognizer *_drawingPinch;
   UIPanGestureRecognizer *_drawingPan;
@@ -47,6 +53,8 @@
     [self addGestureRecognizer:_drawingPan];
     [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(stopDrawingClock) name:UIApplicationWillResignActiveNotification object:nil];
     [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(startDrawingClock) name:UIApplicationDidBecomeActiveNotification object:nil];
+    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(stopClock) name:UIApplicationWillResignActiveNotification object:nil];
+    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(startClock) name:UIApplicationDidBecomeActiveNotification object:nil];
     self.layer.opaque = YES;
   }
   return self;
@@ -74,10 +82,12 @@
                   (int32_t)_surfaceId, (__bridge void *)self.layer, (uint32_t)(size.width * scale), (uint32_t)(size.height * scale)) == 1;
   if (_drawingId >= 0) engine_drawing_invalidate((int32_t)_drawingId);
   [self startDrawingClock];
+  [self startClock];
 }
 
 - (void)detach
 {
+  [self stopClock];
   [self stopDrawingClock];
   if (_attached) {
     engine_render_detach((int32_t)_surfaceId);
@@ -126,6 +136,25 @@
   _drawingBackground = value;
   if (_drawingId >= 0) engine_drawing_invalidate((int32_t)_drawingId);
 }
+/**
+ * The game's display clock: once per refresh while the surface is attached, on screen and the app is
+ * active, the engine is asked for its next frame on the JS thread. 60 a second, also on ProMotion
+ * screens, so a JS game loop isn't run twice as often.
+ */
+- (void)startClock {
+  if (_clock != nil || _surfaceId < 0 || self.window == nil || !_attached || UIApplication.sharedApplication.applicationState != UIApplicationStateActive) return;
+  _clock = [CADisplayLink displayLinkWithTarget:self selector:@selector(tick:)];
+  if (@available(iOS 15.0, *)) _clock.preferredFrameRateRange = CAFrameRateRangeMake(30, 60, 60);
+  else _clock.preferredFramesPerSecond = 60;
+  [_clock addToRunLoop:NSRunLoop.mainRunLoop forMode:NSRunLoopCommonModes];
+}
+- (void)stopClock {
+  [_clock invalidate];
+  _clock = nil;
+}
+- (void)tick:(CADisplayLink *)link {
+  if (_surfaceId >= 0) facebook::react::deliverFrame((int)_surfaceId, link.timestamp * 1000.0);
+}
 - (void)startDrawingClock {
   if (_drawingClock != nil || _drawingId < 0 || self.window == nil || !_attached || UIApplication.sharedApplication.applicationState != UIApplicationStateActive) return;
   _drawingClock = [CADisplayLink displayLinkWithTarget:self selector:@selector(presentDrawing)];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nayan-ui/engine",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.5",
   "description": "Fast 3D game engine for React and React Native: Rust and wgpu rendering, Rapier physics, animation, particle effects, audio, haptics and drawing.",
   "keywords": [
     "3d",
@@ -25,7 +25,7 @@
     "webgpu",
     "wgpu"
   ],
-  "homepage": "https://www.nayanui.com/engine",
+  "homepage": "https://www.nayanui.com/game-engine",
   "bugs": {
     "url": "https://github.com/ursnj/nayan-ui/issues"
   },

package/src/native/spec/NativeNayanEngine.ts

@@ -100,6 +100,8 @@ export interface Spec extends TurboModule {
   shapePrepare(vertices: Object, indices: Object, options: string): number;
   solidPrepare(recipe: string, options: string): number;
   modelLoad(data: Object, center: boolean, fit: number): number;
+  /** `modelLoad` on a background native thread (the data is copied first): resolves to the mesh id, or -1. */
+  modelLoadAsync(data: Object, center: boolean, fit: number): Promise<number>;
   /** 11 floats per vertex (position, normal, color, uv); aliases native memory. */
   modelVertices(mesh: number): Object;
   /** u32 triangle indices; aliases native memory. */
@@ -112,6 +114,11 @@ export interface Spec extends TurboModule {
   meshAlias(base: number): number;
   /** Registers geometry (copied): 11 floats per vertex, u32 triangle indices. Returns the mesh id, or -1. */
   meshCreate(vertices: Object, indices: Object): number;
+  /**
+   * Hands a core model's own geometry (from `meshCreate`, `modelLoad`, a font) to the renderer, in
+   * Rust: nothing is copied through JS. `texture` -1 for none. False if the mesh is unknown.
+   */
+  renderModel(mesh: number, texture: number, shine: number): boolean;
   /**
    * Fills 2D contours ([x, y] f32 pairs, `counts[k]` points per contour) by the non-zero or even-odd
    * rule and extrudes them `depth` deep. Returns an ArrayBuffer of 11 floats per vertex (unindexed).
@@ -141,12 +148,16 @@ export interface Spec extends TurboModule {
   ): void;
   /** Decodes a PNG/JPEG ArrayBuffer. Returns the texture id, or -1. */
   textureLoad(data: Object): number;
+  /** `textureLoad` on a background native thread: resolves to the texture id, or -1. */
+  textureLoadAsync(data: Object): Promise<number>;
   /** RGBA8 pixels, top row first; aliases native memory. */
   texturePixels(texture: number): Object;
   /** [width, height]. */
   textureSize(texture: number): Array<number>;
   /** Builds extruded glyph meshes for `chars`. Returns the font id, or -1. */
   fontLoad(data: Object, depth: number, chars: string, weight: number): number;
+  /** `fontLoad` (outlines and glyph meshes) on a background native thread: resolves to the font id, or -1. */
+  fontLoadAsync(data: Object, depth: number, chars: string, weight: number): Promise<number>;
   /** [codepoint, mesh (-1 = nothing drawn), advance, ...] followed by the cap height. */
   fontGlyphs(font: number): Array<number>;
   /** Why the last model / texture / font / alias load failed ("" after a success). */
@@ -182,6 +193,32 @@ export interface Spec extends TurboModule {
     viewProj: Object,
     world: number
   ): number;
+  /**
+   * `renderFrame`'s arguments, but the frame is copied and drawn on the native render thread: returns
+   * at once, with `viewProj` written. 1 once the surface has presented a frame, 0 before, -1 if the
+   * last frame failed (see `renderError`).
+   */
+  publishFrame(
+    surface: number,
+    frame: Object,
+    matrices: Object,
+    colors: Object,
+    regions: Object,
+    ranges: Object,
+    count: number,
+    viewProj: Object,
+    world: number
+  ): number;
+  /** [frames presented, smoothed render milliseconds] for a surface drawn by the render thread. */
+  renderStats(surface: number): Array<number>;
+  /** True where the platform drives frames from its display clock (`startFrames`); else use requestAnimationFrame. */
+  hasFrameClock(): boolean;
+  /**
+   * Calls `onFrame` on the JS thread once per display refresh while the surface is attached and
+   * visible, with the frame time in milliseconds. A frame JS hasn't started yet isn't queued again.
+   */
+  startFrames(surface: number, onFrame: (timeMs: number) => void): void;
+  stopFrames(surface: number): void;
   /**
    * The screen-space overlay drawn over surface `surface` from its next frame on, copied from a world's
    * buffers. In points: x right and y up from the view's top-left (on screen y <= 0), z toward the
@@ -210,6 +247,8 @@ export interface Spec extends TurboModule {
   // Audio (global)
   /** Decodes a WAV ArrayBuffer. Returns a sound id, or -1. */
   audioLoad(data: Object): number;
+  /** `audioLoad` on a background native thread: resolves to the sound id, or -1. */
+  audioLoadAsync(data: Object): Promise<number>;
   /** Returns a voice id (> 0), or 0 if nothing played. */
   audioPlay(sound: number, volume: number, pan: number, pitch: number, loop: boolean): number;
   audioStop(voice: number): void;