expo-gl 11.4.0 → 12.0.0

package/.clang-format

@@ -0,0 +1,87 @@
+---
+AccessModifierOffset: -1
+AlignAfterOpenBracket: AlwaysBreak
+AlignConsecutiveAssignments: false
+AlignConsecutiveDeclarations: false
+AlignEscapedNewlinesLeft: true
+AlignOperands:   false
+AlignTrailingComments: false
+AllowAllParametersOfDeclarationOnNextLine: false
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: true
+AlwaysBreakTemplateDeclarations: true
+BinPackArguments: false
+BinPackParameters: false
+BraceWrapping:
+  AfterClass:      false
+  AfterControlStatement: false
+  AfterEnum:       false
+  AfterFunction:   false
+  AfterNamespace:  false
+  AfterObjCDeclaration: false
+  AfterStruct:     false
+  AfterUnion:      false
+  BeforeCatch:     false
+  BeforeElse:      false
+  IndentBraces:    false
+BreakBeforeBinaryOperators: None
+BreakBeforeBraces: Attach
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializersBeforeComma: false
+BreakAfterJavaFieldAnnotations: false
+BreakStringLiterals: false
+ColumnLimit:     100
+CommentPragmas:  '^ IWYU pragma:'
+ConstructorInitializerAllOnOneLineOrOnePerLine: true
+ConstructorInitializerIndentWidth: 4
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: true
+DerivePointerAlignment: false
+DisableFormat:   false
+ForEachMacros:   [ FOR_EACH_RANGE, FOR_EACH, ]
+IncludeCategories:
+  - Regex:           '^<.*\.h(pp)?>'
+    Priority:        1
+  - Regex:           '^<.*'
+    Priority:        2
+  - Regex:           '.*'
+    Priority:        3
+IndentCaseLabels: true
+IndentWidth:     2
+IndentWrappedFunctionNames: false
+KeepEmptyLinesAtTheStartOfBlocks: false
+MacroBlockBegin: ''
+MacroBlockEnd:   ''
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None
+ObjCBlockIndentWidth: 2
+ObjCSpaceAfterProperty: false
+ObjCSpaceBeforeProtocolList: false
+PenaltyBreakBeforeFirstCallParameter: 1
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakString: 1000
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 200
+PointerAlignment: Right
+ReflowComments:  true
+SortIncludes:    true
+SpaceAfterCStyleCast: false
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeParens: ControlStatements
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles:  false
+SpacesInContainerLiterals: true
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+Standard:        Cpp11
+TabWidth:        8
+UseTab:          Never
+...

package/CHANGELOG.md

@@ -10,6 +10,26 @@
 
 ### 💡 Others
 
+## 12.0.0 — 2022-10-25
+
+### 🛠 Breaking changes
+
+- Bumped iOS deployment target to 13.0 and deprecated support for iOS 12. ([#18873](https://github.com/expo/expo/pull/18873) by [@tsapeta](https://github.com/tsapeta))
+
+### 🐛 Bug fixes
+
+- Use shared C++ runtime to reduce library size on Android. ([#19372](https://github.com/expo/expo/pull/19372) by [@kudo](https://github.com/kudo))
+
+### 💡 Others
+
+- Merge `GLViewProps` and `BaseGLViewProps` into one type - `GLViewProps`. ([#18322](https://github.com/expo/expo/pull/18322) by [@Simek](https://github.com/Simek))
+- Rename Web-specific prop types from `GLViewProps` to `GLViewWebProps`. ([#18322](https://github.com/expo/expo/pull/18322) by [@Simek](https://github.com/Simek))
+- Merge `expo-gl-cpp` package into `expo-gl`. ([#18875](https://github.com/expo/expo/pull/18875) by [@wkozyra95](https://github.com/wkozyra95))
+
+### ⚠️ Notices
+
+- Added support for React Native 0.70.x. ([#19261](https://github.com/expo/expo/pull/19261) by [@kudo](https://github.com/kudo))
+
 ## 11.4.0 — 2022-07-07
 
 ### 🐛 Bug fixes

package/{ios/EXGL.podspec → EXGL.podspec}

@@ -1,6 +1,6 @@
 require 'json'
 
-package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 
 Pod::Spec.new do |s|
   s.name            = 'EXGL'
@@ -10,17 +10,22 @@ Pod::Spec.new do |s|
   s.license         = package['license']
   s.author          = package['author']
   s.homepage        = package['homepage']
-  s.platform        = :ios, '12.0'
+  s.platform        = :ios, '13.0'
   s.source          = { git: 'https://github.com/expo/expo-gl.git' }
   s.static_framework = true
 
   s.dependency 'ExpoModulesCore'
-  s.dependency 'EXGL_CPP'
+  s.dependency 'React-jsi'
+
+  s.compiler_flags = '-x objective-c++ -std=c++1z'
+  s.pod_target_xcconfig = {
+    'GCC_PREPROCESSOR_DEFINITIONS' => '$(inherited) GLES_SILENCE_DEPRECATION=1'
+  }
 
   if !$ExpoUseSources&.include?(package['name']) && ENV['EXPO_USE_SOURCE'].to_i == 0 && File.exist?("#{s.name}.xcframework") && Gem::Version.new(Pod::VERSION) >= Gem::Version.new('1.10.0')
-    s.source_files = "#{s.name}/**/*.h"
+    s.source_files = "ios/**/*.h"
     s.vendored_frameworks = "#{s.name}.xcframework"
   else
-    s.source_files = "#{s.name}/**/*.{h,m,mm}"
+    s.source_files = "ios/**/*.{h,m,mm}", "common/**/*.{h,cpp,def}"
   end
 end

package/README.md

@@ -15,10 +15,6 @@ For [managed](https://docs.expo.dev/versions/latest/introduction/managed-vs-bare
 
 For bare React Native projects, you must ensure that you have [installed and configured the `expo` package](https://docs.expo.dev/bare/installing-expo-modules/) before continuing.
 
-### Install expo-gl-cpp
-
-expo-gl requires that you also install and configure [expo-gl-cpp](https://github.com/expo/expo/tree/main/packages/expo-gl-cpp).
-
 ### Add the package to your npm dependencies
 
 ```

package/android/CMakeLists.txt

@@ -0,0 +1,59 @@
+cmake_minimum_required(VERSION 3.4.1)
+
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 17)
+
+set(PACKAGE_NAME "expo-gl")
+set(BUILD_DIR ${CMAKE_SOURCE_DIR}/build)
+set(COMMON_DIR ${CMAKE_SOURCE_DIR}/../common)
+
+add_library(
+    ${PACKAGE_NAME} SHARED
+    ${COMMON_DIR}/EXGLNativeApi.cpp
+    ${COMMON_DIR}/EXGLNativeApi.h
+    ${COMMON_DIR}/EXGLImageUtils.cpp
+    ${COMMON_DIR}/EXGLImageUtils.h
+    ${COMMON_DIR}/EXGLNativeContext.cpp
+    ${COMMON_DIR}/EXGLNativeContext.h
+    ${COMMON_DIR}/EXGLContextManager.cpp
+    ${COMMON_DIR}/EXGLContextManager.h
+    ${COMMON_DIR}/EXWebGLMethods.cpp
+    ${COMMON_DIR}/EXWebGLMethods.h
+    ${COMMON_DIR}/EXWebGLRenderer.cpp
+    ${COMMON_DIR}/EXWebGLRenderer.h
+    ${COMMON_DIR}/EXTypedArrayApi.cpp
+    ${COMMON_DIR}/EXTypedArrayApi.h
+    ./src/main/cpp/EXGLJniApi.cpp)
+
+# Extracted AAR: ${BUILD_DIR}/react-native-0*/jni/${ANDROID_ABI}
+file(GLOB LIBRN_DIR "${RN_SO_DIR}/${ANDROID_ABI}")
+if(NOT LIBRN_DIR)
+    # If /${ANDROID_ABI} dir not found, then ${RN_SO_DIR} is probably:
+    # ReactAndroid/build/react-ndk/exported
+    file(GLOB LIBRN_DIR "${RN_SO_DIR}")
+endif()
+
+target_include_directories(
+    ${PACKAGE_NAME} PRIVATE "${REACT_NATIVE_DIR}/ReactCommon/jsi"
+                            "${COMMON_DIR}")
+
+find_library(
+    JSI_LIB jsi
+    PATHS ${LIBRN_DIR}
+    NO_CMAKE_FIND_ROOT_PATH)
+
+find_library(LOG_LIB log)
+find_library(GLES_LIB GLESv3)
+
+target_compile_options(
+    ${PACKAGE_NAME}
+    PRIVATE -O2
+            -fexceptions
+            -frtti
+            -Wall
+            -Wextra
+            -Wno-unused-parameter
+            -Wshorten-64-to-32
+            -Wstrict-prototypes)
+target_link_libraries(${PACKAGE_NAME} ${JSI_LIB} ${LOG_LIB} ${GLES_LIB} android)

package/android/build.gradle

@@ -1,9 +1,22 @@
+import java.nio.file.Paths
+
 apply plugin: 'com.android.library'
 apply plugin: 'kotlin-android'
 apply plugin: 'maven-publish'
 
 group = 'host.exp.exponent'
-version = '11.4.0'
+version = '12.0.0'
+
+def REACT_NATIVE_DIR = new File(["node", "--print", "require.resolve('react-native/package.json')"].execute(null, rootDir).text.trim()).parent
+def RN_BUILD_FROM_SOURCE = findProject(":ReactAndroid") != null
+def RN_SO_DIR = RN_BUILD_FROM_SOURCE
+    ? Paths.get(findProject(":ReactAndroid").getProjectDir().toString(), "build", "intermediates", "library_*", "*", "jni")
+    : "${buildDir}/react-native-0*/jni"
+def RN_AAR_DIR = "${REACT_NATIVE_DIR}/android"
+def reactNativeArchitectures() {
+    def value = project.getProperties().get("reactNativeArchitectures")
+    return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
 
 buildscript {
   def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
@@ -61,6 +74,13 @@ afterEvaluate {
 android {
   compileSdkVersion safeExtGet("compileSdkVersion", 31)
 
+  if (rootProject.hasProperty("ndkPath")) {
+    ndkPath rootProject.ext.ndkPath
+  }
+  if (rootProject.hasProperty("ndkVersion")) {
+    ndkVersion rootProject.ext.ndkVersion
+  }
+
   compileOptions {
     sourceCompatibility JavaVersion.VERSION_11
     targetCompatibility JavaVersion.VERSION_11
@@ -74,11 +94,35 @@ android {
     minSdkVersion safeExtGet("minSdkVersion", 21)
     targetSdkVersion safeExtGet("targetSdkVersion", 31)
     versionCode 31
-    versionName "11.4.0"
+    versionName "12.0.0"
+
+    externalNativeBuild {
+      cmake {
+        abiFilters (*reactNativeArchitectures())
+        arguments "-DANDROID_STL=c++_shared",
+          "-DREACT_NATIVE_DIR=${REACT_NATIVE_DIR}",
+          "-DRN_SO_DIR=${RN_SO_DIR}"
+      }
+    }
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "./CMakeLists.txt"
+    }
+  }
+
+  packagingOptions {
+    // Gradle will add cmake target dependencies into packaging.
+    excludes = [
+        "**/libc++_shared.so",
+        "**/libjsi.so",
+    ]
   }
 
-  sourceSets.main {
-    jni.srcDirs = []
+  configurations {
+    extractHeaders
+    extractJNI
   }
 
   lintOptions {
@@ -86,9 +130,78 @@ android {
   }
 }
 
+repositories {
+  mavenCentral()
+}
+
 dependencies {
-  implementation project(':expo-gl-cpp')
+  compileOnly 'com.facebook.soloader:soloader:0.8.2'
   implementation project(':expo-modules-core')
 
   implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:${getKotlinVersion()}"
 }
+
+def extractReactNativeAAR = { buildType ->
+  def suffix = buildType == 'Debug' ? '-debug' : '-release'
+  def rnAARs = fileTree(RN_AAR_DIR).matching { include "**/react-native/**/*${suffix}.aar" }
+  if (rnAARs.isEmpty()) {
+    rnAARs = fileTree(RN_AAR_DIR).matching { include "**/react-native/**/*.aar" }
+  }
+  if (rnAARs.any()) {
+    // node_modules/react-native has a .aar, extract headers
+    if (rnAARs.size() > 1) {
+      logger.error("More than one React Native AAR file has been found:")
+      rnAARs.each {println(it) }
+      throw new GradleException("Multiple React Native AARs found:\n${rnAARs.join("\n")}" +
+          "\nRemove the old ones and try again")
+    }
+  }
+  def rnAAR = rnAARs.singleFile
+  def file = rnAAR.absoluteFile
+  def packageName = file.name.tokenize('-')[0]
+  copy {
+    from zipTree(file)
+    into "$buildDir/$file.name"
+    include "jni/**/*"
+  }
+}
+
+task extractReactNativeAARRelease {
+  doLast {
+    extractReactNativeAAR('Release')
+  }
+}
+
+task extractReactNativeAARDebug {
+  doLast {
+    extractReactNativeAAR('Debug')
+  }
+}
+
+task extractJNIFiles {
+  doLast {
+    configurations.extractJNI.files.each {
+      def file = it.absoluteFile
+      copy {
+        from zipTree(file)
+        into "$buildDir/$file.name"
+        include "jni/**/*"
+      }
+    }
+  }
+}
+
+tasks.whenTaskAdded { task ->
+  if (!task.name.contains("Clean") && (task.name.contains('externalNativeBuild') || task.name.startsWith('configureCMake'))) {
+    def buildType = task.name.endsWith('Debug') ? 'Debug' : 'Release'
+    task.dependsOn(extractJNIFiles)
+    if (RN_BUILD_FROM_SOURCE) {
+      task.dependsOn(":ReactAndroid:copy${buildType}JniLibsProjectOnly")
+    } else {
+      task.dependsOn("extractReactNativeAAR${buildType}")
+    }
+  } else if (task.name.startsWith('generateJsonModel') && RN_BUILD_FROM_SOURCE) {
+    def buildType = task.name.endsWith('Debug') ? 'Debug' : 'Release'
+    task.dependsOn(":ReactAndroid:copy${buildType}JniLibsProjectOnly")
+  }
+}

package/android/src/main/cpp/EXGLJniApi.cpp

@@ -0,0 +1,91 @@
+#include <stdint.h>
+
+#include <jni.h>
+#include <thread>
+#include <android/log.h>
+
+#include <jsi/jsi.h>
+#include "EXGLNativeApi.h"
+#include "EXPlatformUtils.h"
+
+extern "C" {
+
+// JNIEnv is valid only inside the same thread that it was passed from
+// to support worklet we need register it from UI thread
+thread_local JNIEnv* threadLocalEnv;
+
+JNIEXPORT jint JNICALL
+Java_expo_modules_gl_cpp_EXGL_EXGLContextCreate
+(JNIEnv *env, jclass clazz) {
+  return EXGLContextCreate();
+}
+
+JNIEXPORT void JNICALL
+Java_expo_modules_gl_cpp_EXGL_EXGLContextPrepare
+(JNIEnv *env, jclass clazz, jlong jsiPtr, jint exglCtxId, jobject glContext) {
+  threadLocalEnv = env;
+  jclass GLContextClass = env->GetObjectClass(glContext);
+  jobject glContextRef = env->NewGlobalRef(glContext);
+  jmethodID flushMethodRef = env->GetMethodID(GLContextClass, "flush", "()V");
+
+  std::function<void(void)> flushMethod = [glContextRef, flushMethodRef] {
+    threadLocalEnv->CallVoidMethod(glContextRef, flushMethodRef);
+  };
+  EXGLContextPrepare((void*) jsiPtr, exglCtxId, flushMethod);
+}
+
+JNIEXPORT void JNICALL
+Java_expo_modules_gl_cpp_EXGL_EXGLContextDestroy
+(JNIEnv *env, jclass clazz, jint exglCtxId) {
+  EXGLContextDestroy(exglCtxId);
+}
+
+JNIEXPORT void JNICALL
+Java_expo_modules_gl_cpp_EXGL_EXGLContextFlush
+(JNIEnv *env, jclass clazz, jint exglCtxId) {
+  EXGLContextFlush(exglCtxId);
+}
+
+JNIEXPORT jint JNICALL
+Java_expo_modules_gl_cpp_EXGL_EXGLContextCreateObject
+(JNIEnv *env, jclass clazz, jint exglCtxId) {
+  return EXGLContextCreateObject(exglCtxId);
+}
+
+JNIEXPORT void JNICALL
+Java_expo_modules_gl_cpp_EXGL_EXGLContextDestroyObject
+(JNIEnv *env, jclass clazz, jint exglCtxId, jint exglObjId) {
+  EXGLContextDestroyObject(exglCtxId, exglObjId);
+}
+
+JNIEXPORT void JNICALL
+Java_expo_modules_gl_cpp_EXGL_EXGLContextMapObject
+(JNIEnv *env, jclass clazz, jint exglCtxId, jint exglObjId, jint glObj) {
+  EXGLContextMapObject(exglCtxId, exglObjId, glObj);
+}
+
+JNIEXPORT jint JNICALL
+Java_expo_modules_gl_cpp_EXGL_EXGLContextGetObject
+(JNIEnv *env, jclass clazz, jint exglCtxId, jint exglObjId) {
+  return EXGLContextGetObject(exglCtxId, exglObjId);
+}
+
+JNIEXPORT void JNICALL
+Java_expo_modules_gl_cpp_EXGL_EXGLRegisterThread
+(JNIEnv *env, jclass clazz) {
+  threadLocalEnv = env;
+}
+
+JNIEXPORT bool JNICALL
+Java_expo_modules_gl_cpp_EXGL_EXGLContextNeedsRedraw
+(JNIEnv *env, jclass clazz, jint exglCtxId) {
+  return EXGLContextNeedsRedraw(exglCtxId);
+}
+
+JNIEXPORT void JNICALL
+Java_expo_modules_gl_cpp_EXGL_EXGLContextDrawEnded
+(JNIEnv *env, jclass clazz, jint exglCtxId) {
+  EXGLContextDrawEnded(exglCtxId);
+}
+
+}

package/android/src/main/java/expo/modules/gl/cpp/EXGL.java

@@ -0,0 +1,23 @@
+package expo.modules.gl.cpp;
+
+import com.facebook.soloader.SoLoader;
+
+// Java bindings for EXGLNativeApi.h interface
+public class EXGL {
+  static {
+    SoLoader.loadLibrary("expo-gl");
+  }
+  public static native int EXGLContextCreate();
+  public static native void EXGLContextPrepare(long jsCtxPtr, int exglCtxId, Object glContext);
+
+  public static native void EXGLContextDestroy(int exglCtxId);
+  public static native void EXGLContextFlush(int exglCtxId);
+
+  public static native int EXGLContextCreateObject(int exglCtxId);
+  public static native void EXGLContextDestroyObject(int exglCtxId, int exglObjId);
+  public static native void EXGLContextMapObject(int exglCtxId, int exglObjId, int glObj);
+  public static native int EXGLContextGetObject(int exglCtxId, int exglObjId);
+  public static native void EXGLRegisterThread();
+  public static native boolean EXGLContextNeedsRedraw(int exglCtxId);
+  public static native void EXGLContextDrawEnded(int exglCtxId);
+}

package/build/GLView.d.ts

@@ -1,33 +1,38 @@
 import * as React from 'react';
-import { ComponentOrHandle, SurfaceCreateEvent, GLSnapshot, ExpoWebGLRenderingContext, SnapshotOptions, BaseGLViewProps } from './GLView.types';
-export interface WebGLObject {
+import { ComponentOrHandle, SurfaceCreateEvent, GLSnapshot, ExpoWebGLRenderingContext, SnapshotOptions, GLViewProps } from './GLView.types';
+export declare type WebGLObject = {
     id: number;
-}
-export declare type GLViewProps = {
-    /**
-     * Called when the OpenGL context is created, with the context object as a parameter. The context
-     * object has an API mirroring WebGL's WebGLRenderingContext.
-     */
-    onContextCreate(gl: ExpoWebGLRenderingContext): void;
-    /**
-     * [iOS only] Number of samples for Apple's built-in multisampling.
-     */
-    msaaSamples: number;
-    /**
-     * A ref callback for the native GLView
-     */
-    nativeRef_EXPERIMENTAL?(callback: ComponentOrHandle | null): any;
-} & BaseGLViewProps;
+};
 /**
- * A component that acts as an OpenGL render target
+ * A View that acts as an OpenGL ES render target. On mounting, an OpenGL ES context is created.
+ * Its drawing buffer is presented as the contents of the View every frame.
  */
 export declare class GLView extends React.Component<GLViewProps> {
     static NativeView: any;
     static defaultProps: {
         msaaSamples: number;
     };
+    /**
+     * Imperative API that creates headless context which is devoid of underlying view.
+     * It's useful for headless rendering or in case you want to keep just one context per application and share it between multiple components.
+     * It is slightly faster than usual context as it doesn't swap framebuffers and doesn't present them on the canvas,
+     * however it may require you to take a snapshot in order to present its results.
+     * Also, keep in mind that you need to set up a viewport and create your own framebuffer and texture that you will be drawing to, before you take a snapshot.
+     * @return A promise that resolves to WebGL context object. See [WebGL API](#webgl-api) for more details.
+     */
     static createContextAsync(): Promise<ExpoWebGLRenderingContext>;
+    /**
+     * Destroys given context.
+     * @param exgl WebGL context to destroy.
+     * @return A promise that resolves to boolean value that is `true` if given context existed and has been destroyed successfully.
+     */
     static destroyContextAsync(exgl?: ExpoWebGLRenderingContext | number): Promise<boolean>;
+    /**
+     * Takes a snapshot of the framebuffer and saves it as a file to app's cache directory.
+     * @param exgl WebGL context to take a snapshot from.
+     * @param options
+     * @return A promise that resolves to `GLSnapshot` object.
+     */
     static takeSnapshotAsync(exgl?: ExpoWebGLRenderingContext | number, options?: SnapshotOptions): Promise<GLSnapshot>;
     static getWorkletContext: (contextId: number) => ExpoWebGLRenderingContext | undefined;
     nativeRef: ComponentOrHandle;
@@ -38,6 +43,11 @@ export declare class GLView extends React.Component<GLViewProps> {
     startARSessionAsync(): Promise<any>;
     createCameraTextureAsync(cameraRefOrHandle: ComponentOrHandle): Promise<WebGLTexture>;
     destroyObjectAsync(glObject: WebGLObject): Promise<boolean>;
+    /**
+     * Same as static [`takeSnapshotAsync()`](#glviewtakesnapshotasyncgl-options),
+     * but uses WebGL context that is associated with the view on which the method is called.
+     * @param options
+     */
     takeSnapshotAsync(options?: SnapshotOptions): Promise<GLSnapshot>;
 }
 //# sourceMappingURL=GLView.d.ts.map

package/build/GLView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GLView.d.ts","sourceRoot":"","sources":["../src/GLView.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,yBAAyB,EACzB,eAAe,EACf,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;CACZ;AAMD,oBAAY,WAAW,GAAG;IACxB;;;OAGG;IACH,eAAe,CAAC,EAAE,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAErD;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,sBAAsB,CAAC,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,OAAE;CAC7D,GAAG,eAAe,CAAC;AAIpB;;GAEG;AACH,qBAAa,MAAO,SAAQ,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC;IACtD,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC;IAEvB,MAAM,CAAC,YAAY;;MAEjB;WAEW,kBAAkB,IAAI,OAAO,CAAC,yBAAyB,CAAC;WAKxD,mBAAmB,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;WAKhF,iBAAiB,CAC5B,IAAI,CAAC,EAAE,yBAAyB,GAAG,MAAM,EACzC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;IAKtB,MAAM,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,yBAAyB,GAAG,SAAS,CACrD;IAEjC,SAAS,EAAE,iBAAiB,CAAQ;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,MAAM;IA0BN,aAAa,cAAe,iBAAiB,KAAG,IAAI,CAKlD;IAEF,gBAAgB,mCAAoC,kBAAkB,KAAG,IAAI,CAQ3E;IAEI,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC;IAOnC,wBAAwB,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAmBrF,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAO3D,iBAAiB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAO5E"}
+{"version":3,"file":"GLView.d.ts","sourceRoot":"","sources":["../src/GLView.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,yBAAyB,EACzB,eAAe,EACf,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAIxB,oBAAY,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AASF;;;GAGG;AACH,qBAAa,MAAO,SAAQ,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC;IACtD,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC;IAEvB,MAAM,CAAC,YAAY;;MAEjB;IAEF;;;;;;;OAOG;WACU,kBAAkB,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAKrE;;;;OAIG;WACU,mBAAmB,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7F;;;;;OAKG;WACU,iBAAiB,CAC5B,IAAI,CAAC,EAAE,yBAAyB,GAAG,MAAM,EACzC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;IAKtB,MAAM,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,yBAAyB,GAAG,SAAS,CACrD;IAEjC,SAAS,EAAE,iBAAiB,CAAQ;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,MAAM;IA0BN,aAAa,cAAe,iBAAiB,KAAG,IAAI,CAKlD;IAEF,gBAAgB,mCAAoC,kBAAkB,KAAG,IAAI,CAQ3E;IAGI,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC;IAQnC,wBAAwB,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAoBrF,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAOjE;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAO5E"}

package/build/GLView.js

@@ -5,22 +5,43 @@ import { configureLogging } from './GLUtils';
 import { createWorkletContextProvider } from './GLWorkletContextProvider';
 const { ExponentGLObjectManager, ExponentGLViewManager } = NativeModulesProxy;
 const NativeView = requireNativeViewManager('ExponentGLView');
+// @needsAudit
 /**
- * A component that acts as an OpenGL render target
+ * A View that acts as an OpenGL ES render target. On mounting, an OpenGL ES context is created.
+ * Its drawing buffer is presented as the contents of the View every frame.
  */
 export class GLView extends React.Component {
     static NativeView;
     static defaultProps = {
         msaaSamples: 4,
     };
+    /**
+     * Imperative API that creates headless context which is devoid of underlying view.
+     * It's useful for headless rendering or in case you want to keep just one context per application and share it between multiple components.
+     * It is slightly faster than usual context as it doesn't swap framebuffers and doesn't present them on the canvas,
+     * however it may require you to take a snapshot in order to present its results.
+     * Also, keep in mind that you need to set up a viewport and create your own framebuffer and texture that you will be drawing to, before you take a snapshot.
+     * @return A promise that resolves to WebGL context object. See [WebGL API](#webgl-api) for more details.
+     */
     static async createContextAsync() {
         const { exglCtxId } = await ExponentGLObjectManager.createContextAsync();
         return getGl(exglCtxId);
     }
+    /**
+     * Destroys given context.
+     * @param exgl WebGL context to destroy.
+     * @return A promise that resolves to boolean value that is `true` if given context existed and has been destroyed successfully.
+     */
     static async destroyContextAsync(exgl) {
         const exglCtxId = getContextId(exgl);
         return ExponentGLObjectManager.destroyContextAsync(exglCtxId);
     }
+    /**
+     * Takes a snapshot of the framebuffer and saves it as a file to app's cache directory.
+     * @param exgl WebGL context to take a snapshot from.
+     * @param options
+     * @return A promise that resolves to `GLSnapshot` object.
+     */
     static async takeSnapshotAsync(exgl, options = {}) {
         const exglCtxId = getContextId(exgl);
         return ExponentGLObjectManager.takeSnapshotAsync(exglCtxId, options);
@@ -54,12 +75,14 @@ export class GLView extends React.Component {
             this.props.onContextCreate(gl);
         }
     };
+    // @docsMissing
     async startARSessionAsync() {
         if (!ExponentGLViewManager.startARSessionAsync) {
             throw new UnavailabilityError('expo-gl', 'startARSessionAsync');
         }
         return await ExponentGLViewManager.startARSessionAsync(findNodeHandle(this.nativeRef));
     }
+    // @docsMissing
     async createCameraTextureAsync(cameraRefOrHandle) {
         if (!ExponentGLObjectManager.createCameraTextureAsync) {
             throw new UnavailabilityError('expo-gl', 'createCameraTextureAsync');
@@ -72,12 +95,18 @@ export class GLView extends React.Component {
         const { exglObjId } = await ExponentGLObjectManager.createCameraTextureAsync(exglCtxId, cameraTag);
         return { id: exglObjId };
     }
+    // @docsMissing
     async destroyObjectAsync(glObject) {
         if (!ExponentGLObjectManager.destroyObjectAsync) {
             throw new UnavailabilityError('expo-gl', 'destroyObjectAsync');
         }
         return await ExponentGLObjectManager.destroyObjectAsync(glObject.id);
     }
+    /**
+     * Same as static [`takeSnapshotAsync()`](#glviewtakesnapshotasyncgl-options),
+     * but uses WebGL context that is associated with the view on which the method is called.
+     * @param options
+     */
     async takeSnapshotAsync(options = {}) {
         if (!GLView.takeSnapshotAsync) {
             throw new UnavailabilityError('expo-gl', 'takeSnapshotAsync');