react-native-webgpu 0.14.0 → 0.14.1

package/cpp/rnwgpu/api/DestroyedError.h

@@ -0,0 +1,26 @@
+#pragma once
+
+#include <string>
+
+#include "webgpu/webgpu_cpp.h"
+
+namespace rnwgpu {
+
+// 'GPUSharedFence "label"', or just the class name when unlabeled.
+inline std::string describeDestroyed(const char *className,
+                                     const std::string &label) {
+  return label.empty() ? std::string(className)
+                       : std::string(className) + " \"" + label + "\"";
+}
+
+// Reports a use of a destroyed object the way Dawn reports an invalid one: a
+// validation error, caught by error scopes or else delivered to the device's
+// uncapturederror event.
+inline void reportDestroyedUse(wgpu::Device &device, const char *className,
+                               const std::string &label, const char *method) {
+  auto message = "Destroyed " + describeDestroyed(className, label) +
+                 " used in " + method + "().";
+  device.InjectError(wgpu::ErrorType::Validation, message.c_str());
+}
+
+} // namespace rnwgpu

package/cpp/rnwgpu/api/GPUDevice.cpp

@@ -345,14 +345,21 @@ std::shared_ptr<GPUSharedTextureMemory> GPUDevice::importSharedTextureMemory(
 #endif
 
   auto memory = _instance.ImportSharedTextureMemory(&desc);
-  if (memory == nullptr) {
-    throw std::runtime_error("GPUDevice::importSharedTextureMemory(): "
-                             "ImportSharedTextureMemory returned null - is the "
-                             "'shared-texture-memory-iosurface' (Apple) or "
-                             "'shared-texture-memory-ahardware-buffer' "
-                             "(Android) feature enabled on the device?");
-  }
-  return std::make_shared<GPUSharedTextureMemory>(std::move(memory),
+  // Dawn reports a failed import (feature missing, unusable handle) as a
+  // validation error and returns an error object rather than null, with no
+  // format in its properties: the format getter of any texture created from
+  // it would throw. Fail the import instead.
+  wgpu::SharedTextureMemoryProperties properties{};
+  if (memory == nullptr ||
+      memory.GetProperties(&properties) != wgpu::Status::Success ||
+      properties.format == wgpu::TextureFormat::Undefined) {
+    throw std::runtime_error(
+        "GPUDevice::importSharedTextureMemory(): the import failed - is the "
+        "'shared-texture-memory-iosurface' (Apple) or "
+        "'shared-texture-memory-ahardware-buffer' (Android) feature enabled "
+        "on the device, and the handle a usable IOSurface / AHardwareBuffer?");
+  }
+  return std::make_shared<GPUSharedTextureMemory>(_instance, std::move(memory),
                                                   std::move(label));
 }
 
@@ -402,7 +409,8 @@ std::shared_ptr<GPUSharedFence> GPUDevice::importSharedFence(
         "GPUDevice::importSharedFence(): ImportSharedFence returned null - is "
         "the matching 'shared-fence-*' feature enabled on the device?");
   }
-  return std::make_shared<GPUSharedFence>(std::move(fence), std::move(label));
+  return std::make_shared<GPUSharedFence>(_instance, std::move(fence),
+                                          std::move(label));
 }
 
 async::AsyncTaskHandle GPUDevice::createComputePipelineAsync(

package/cpp/rnwgpu/api/GPUSharedFence.cpp

@@ -3,6 +3,8 @@
 #include <cstdint>
 #include <string>
 
+#include "DestroyedError.h"
+
 #if defined(__ANDROID__)
 #include <fcntl.h>
 #endif
@@ -32,10 +34,30 @@ std::string sharedFenceTypeToString(wgpu::SharedFenceType type) {
   }
 }
 
+// Dawn reports a fence it can't export (an invalid one) as a validation error
+// and leaves the type at 0. Fail the call too, like a destroyed fence does,
+// rather than returning a record with no type and no handle.
+void throwIfNotExported(jsi::Runtime &runtime,
+                        const wgpu::SharedFenceExportInfo &info) {
+  if (info.type == wgpu::SharedFenceType(0)) {
+    throw jsi::JSError(runtime, "GPUSharedFence::export() failed");
+  }
+}
+
 } // namespace
 
+void GPUSharedFence::injectDestroyedError(const char *method) {
+  reportDestroyedUse(_device, CLASS_NAME, _label, method);
+}
+
 jsi::Value GPUSharedFence::exportInfo(jsi::Runtime &runtime, const jsi::Value &,
                                       const jsi::Value *, size_t) {
+  // Fails like an export Dawn rejects: a validation error, then the throw.
+  if (!_instance) {
+    injectDestroyedError("export");
+    throw jsi::JSError(runtime,
+                       "GPUSharedFence::export(): the fence was destroyed");
+  }
   wgpu::SharedFenceExportInfo info{};
   uint64_t handle = 0;
 
@@ -44,25 +66,30 @@ jsi::Value GPUSharedFence::exportInfo(jsi::Runtime &runtime, const jsi::Value &,
   wgpu::SharedFenceMTLSharedEventExportInfo mtlInfo{};
   info.nextInChain = &mtlInfo;
   _instance.ExportInfo(&info);
+  throwIfNotExported(runtime, info);
   handle = reinterpret_cast<uint64_t>(mtlInfo.sharedEvent);
 #elif defined(__ANDROID__)
-  // Android: the handle is an OS file descriptor (sync_fd). Dawn's ExportInfo returns a BORROWED fd — it is
-  // owned by the SharedFence and closed when the fence is destroyed. This exported handle is documented as
-  // caller-owned (the caller must close() it), so dup() it. Without the dup the same fd is closed twice —
-  // once by the caller and once by Dawn on fence destruction — tripping Android's fdsan (double-close abort).
+  // Android: the handle is an OS file descriptor (sync_fd). Dawn's ExportInfo
+  // returns a BORROWED fd — it is owned by the SharedFence and closed when the
+  // fence is destroyed. This exported handle is documented as caller-owned (the
+  // caller must close() it), so dup() it. Without the dup the same fd is closed
+  // twice — once by the caller and once by Dawn on fence destruction — tripping
+  // Android's fdsan (double-close abort).
   wgpu::SharedFenceSyncFDExportInfo fdInfo{};
   info.nextInChain = &fdInfo;
   _instance.ExportInfo(&info);
-  int exportedFd =
-      fdInfo.handle >= 0 ? ::fcntl(fdInfo.handle, F_DUPFD_CLOEXEC, 0) : fdInfo.handle;
+  throwIfNotExported(runtime, info);
+  int exportedFd = fdInfo.handle >= 0
+                       ? ::fcntl(fdInfo.handle, F_DUPFD_CLOEXEC, 0)
+                       : fdInfo.handle;
   handle = static_cast<uint64_t>(static_cast<uint32_t>(exportedFd));
 #else
-// react-native-webgpu only targets Apple (Metal) and Android (Vulkan). On any
-// other platform there is no native handle convention to expose, so fail loudly
-// rather than handing back a meaningless handle of 0.
-throw jsi::JSError(runtime,
-                    "GPUSharedFence::export(): unsupported platform (only "
-                    "Apple/Metal and Android/Vulkan are supported)");
+  // react-native-webgpu only targets Apple (Metal) and Android (Vulkan). On any
+  // other platform there is no native handle convention to expose, so fail
+  // loudly rather than handing back a meaningless handle of 0.
+  throw jsi::JSError(runtime,
+                     "GPUSharedFence::export(): unsupported platform (only "
+                     "Apple/Metal and Android/Vulkan are supported)");
 #endif
 
   jsi::Object result(runtime);

package/cpp/rnwgpu/api/GPUSharedFence.h

@@ -17,9 +17,10 @@ class GPUSharedFence : public NativeObject<GPUSharedFence> {
 public:
   static constexpr const char *CLASS_NAME = "GPUSharedFence";
 
-  explicit GPUSharedFence(wgpu::SharedFence instance, std::string label)
-      : NativeObject(CLASS_NAME), _instance(std::move(instance)),
-        _label(std::move(label)) {}
+  explicit GPUSharedFence(wgpu::Device device, wgpu::SharedFence instance,
+                          std::string label)
+      : NativeObject(CLASS_NAME), _device(std::move(device)),
+        _instance(std::move(instance)), _label(std::move(label)) {}
 
 public:
   std::string getBrand() { return CLASS_NAME; }
@@ -33,19 +34,35 @@ public:
   std::string getLabel() { return _label; }
   void setLabel(const std::string &label) {
     _label = label;
-    _instance.SetLabel(_label.c_str());
+    if (_instance) {
+      _instance.SetLabel(_label.c_str());
+    }
   }
 
+  // Releases the fence now (closing its sync fd on Android) rather than when
+  // the JS object is garbage collected, which a runtime making fences every
+  // frame may not do for a while. Dawn keeps its own reference as long as it
+  // needs the fence (a beginAccess wait). A later use is a validation error
+  // and a throw.
+  void destroy() { _instance = nullptr; }
+
   static void definePrototype(jsi::Runtime &runtime, jsi::Object &prototype) {
     installGetter(runtime, prototype, "__brand", &GPUSharedFence::getBrand);
     installMethod(runtime, prototype, "export", &GPUSharedFence::exportInfo);
+    installMethod(runtime, prototype, "destroy", &GPUSharedFence::destroy);
     installGetterSetter(runtime, prototype, "label", &GPUSharedFence::getLabel,
                         &GPUSharedFence::setLabel);
   }
 
   inline wgpu::SharedFence get() { return _instance; }
 
+  // Reports a use of the destroyed fence the way Dawn reports an invalid
+  // object: a validation error, caught by error scopes or else delivered to
+  // the device's uncapturederror event.
+  void injectDestroyedError(const char *method);
+
 private:
+  wgpu::Device _device;
   wgpu::SharedFence _instance;
   std::string _label;
 };

package/cpp/rnwgpu/api/GPUSharedTextureMemory.cpp

@@ -1,15 +1,62 @@
 #include "GPUSharedTextureMemory.h"
 
+#include <algorithm>
 #include <memory>
 #include <stdexcept>
 #include <string>
 
 #include "Convertors.h"
+#include "DestroyedError.h"
 
 namespace rnwgpu {
 
+void GPUSharedTextureMemory::destroy() {
+  if (!_instance) {
+    return;
+  }
+  (void)_instance.GetProperties(&_properties);
+  if (!_accessed.empty()) {
+    // Dawn's contract is an endAccess() for every beginAccess(), but Dawn
+    // doesn't check it when the memory goes away. Report the misuse; the
+    // access itself is left as is (ending it would hand its fences to no one).
+    auto message = "Destroyed " + describeDestroyed(CLASS_NAME, _label) +
+                   " with an access still open: call endAccess() first.";
+    _device.InjectError(wgpu::ErrorType::Validation, message.c_str());
+    _accessed.clear();
+  }
+  _instance = nullptr;
+}
+
+void GPUSharedTextureMemory::injectDestroyedError(const char *method) {
+  reportDestroyedUse(_device, CLASS_NAME, _label, method);
+}
+
 std::shared_ptr<GPUTexture> GPUSharedTextureMemory::createTexture(
     std::optional<std::shared_ptr<GPUTextureDescriptor>> descriptor) {
+  if (!_instance) {
+    // Like a texture Dawn can't create from the memory: the validation error
+    // says why, and the texture is an error texture. As Dawn does, it is
+    // described by the caller's descriptor, or else by the memory's
+    // properties. It owns no GPU memory, so it reports no memory pressure.
+    injectDestroyedError("createTexture");
+    wgpu::TextureDescriptor desc{};
+    std::string label;
+    if (descriptor.has_value() && descriptor.value() != nullptr) {
+      Convertor conv;
+      if (!conv(desc, descriptor.value())) {
+        throw std::runtime_error(
+            "GPUSharedTextureMemory::createTexture(): Error with "
+            "GPUTextureDescriptor");
+      }
+      label = descriptor.value()->label.value_or("");
+    } else {
+      desc.usage = _properties.usage;
+      desc.size = _properties.size;
+      desc.format = _properties.format;
+    }
+    return std::make_shared<GPUTexture>(_device.CreateErrorTexture(&desc),
+                                        std::move(label), false);
+  }
   if (!descriptor.has_value() || descriptor.value() == nullptr) {
     auto texture = _instance.CreateTexture();
     return std::make_shared<GPUTexture>(texture, "");
@@ -34,6 +81,12 @@ void GPUSharedTextureMemory::beginAccess(
     throw std::runtime_error(
         "GPUSharedTextureMemory::beginAccess(): texture is null");
   }
+  // Fails like an access Dawn rejects: a validation error, then the throw.
+  if (!_instance) {
+    injectDestroyedError("beginAccess");
+    throw std::runtime_error(
+        "GPUSharedTextureMemory::beginAccess(): the memory was destroyed");
+  }
   wgpu::SharedTextureMemoryBeginAccessDescriptor desc{};
   desc.initialized = initialized;
   desc.concurrentRead = false;
@@ -45,7 +98,13 @@ void GPUSharedTextureMemory::beginAccess(
   if (fences.has_value()) {
     for (const auto &state : *fences) {
       if (state && state->fence) {
-        rawFences.push_back(state->fence->get());
+        auto fence = state->fence->get();
+        if (!fence) {
+          state->fence->injectDestroyedError("beginAccess");
+          throw std::runtime_error(
+              "GPUSharedTextureMemory::beginAccess(): a fence was destroyed");
+        }
+        rawFences.push_back(std::move(fence));
         values.push_back(state->signaledValue);
       }
     }
@@ -53,10 +112,12 @@ void GPUSharedTextureMemory::beginAccess(
   if (!rawFences.empty()) {
     desc.fenceCount = rawFences.size();
     desc.fences = rawFences.data();
+    desc.signaledValueCount = values.size();
     desc.signaledValues = values.data();
   } else {
     desc.fenceCount = 0;
     desc.fences = nullptr;
+    desc.signaledValueCount = 0;
     desc.signaledValues = nullptr;
   }
 
@@ -78,6 +139,7 @@ void GPUSharedTextureMemory::beginAccess(
   if (status != wgpu::Status::Success) {
     throw std::runtime_error("GPUSharedTextureMemory::beginAccess() failed");
   }
+  _accessed.push_back(texture->get());
 }
 
 jsi::Value GPUSharedTextureMemory::endAccess(jsi::Runtime &runtime,
@@ -88,6 +150,12 @@ jsi::Value GPUSharedTextureMemory::endAccess(jsi::Runtime &runtime,
     throw jsi::JSError(
         runtime, "GPUSharedTextureMemory::endAccess(): expected (texture)");
   }
+  if (!_instance) {
+    injectDestroyedError("endAccess");
+    throw jsi::JSError(
+        runtime,
+        "GPUSharedTextureMemory::endAccess(): the memory was destroyed");
+  }
   auto texture = GPUTexture::fromValue(runtime, args[0]);
 
   wgpu::SharedTextureMemoryEndAccessState state{};
@@ -104,18 +172,26 @@ jsi::Value GPUSharedTextureMemory::endAccess(jsi::Runtime &runtime,
   if (status != wgpu::Status::Success) {
     throw jsi::JSError(runtime, "GPUSharedTextureMemory::endAccess() failed");
   }
+  auto ended = texture->get();
+  _accessed.erase(std::remove_if(_accessed.begin(), _accessed.end(),
+                                 [&](const wgpu::Texture &accessed) {
+                                   return accessed.Get() == ended.Get();
+                                 }),
+                  _accessed.end());
 
   // Copy each wgpu::SharedFence (ref-counted) into its own GPUSharedFence
   // wrapper before `state` is destroyed.
   jsi::Array fences(runtime, state.fenceCount);
   for (size_t i = 0; i < state.fenceCount; i++) {
     wgpu::SharedFence fence = state.fences[i];
-    auto wrapper = std::make_shared<GPUSharedFence>(std::move(fence), "");
+    auto wrapper =
+        std::make_shared<GPUSharedFence>(_device, std::move(fence), "");
     jsi::Object entry(runtime);
     entry.setProperty(runtime, "fence",
                       GPUSharedFence::create(runtime, std::move(wrapper)));
-    entry.setProperty(runtime, "signaledValue",
-                      jsi::BigInt::fromUint64(runtime, state.signaledValues[i]));
+    entry.setProperty(
+        runtime, "signaledValue",
+        jsi::BigInt::fromUint64(runtime, state.signaledValues[i]));
     fences.setValueAtIndex(runtime, i, std::move(entry));
   }
 

package/cpp/rnwgpu/api/GPUSharedTextureMemory.h

@@ -23,16 +23,17 @@ class GPUSharedTextureMemory : public NativeObject<GPUSharedTextureMemory> {
 public:
   static constexpr const char *CLASS_NAME = "GPUSharedTextureMemory";
 
-  explicit GPUSharedTextureMemory(wgpu::SharedTextureMemory instance,
+  explicit GPUSharedTextureMemory(wgpu::Device device,
+                                  wgpu::SharedTextureMemory instance,
                                   std::string label)
-      : NativeObject(CLASS_NAME), _instance(std::move(instance)),
-        _label(std::move(label)) {}
+      : NativeObject(CLASS_NAME), _device(std::move(device)),
+        _instance(std::move(instance)), _label(std::move(label)) {}
 
 public:
   std::string getBrand() { return CLASS_NAME; }
 
-  std::shared_ptr<GPUTexture>
-  createTexture(std::optional<std::shared_ptr<GPUTextureDescriptor>> descriptor);
+  std::shared_ptr<GPUTexture> createTexture(
+      std::optional<std::shared_ptr<GPUTextureDescriptor>> descriptor);
 
   // Optional `fences` are wait fences: Dawn waits for each to reach its
   // signaledValue before writing the surface. Throws on failure.
@@ -48,9 +49,17 @@ public:
   std::string getLabel() { return _label; }
   void setLabel(const std::string &label) {
     _label = label;
-    _instance.SetLabel(_label.c_str());
+    if (_instance) {
+      _instance.SetLabel(_label.c_str());
+    }
   }
 
+  // Releases the memory now (the imported native buffer and Dawn's import of
+  // it) rather than when the JS object is garbage collected. End the access
+  // first (destroying during one is a validation error), and destroy the
+  // textures created from it: they keep what they use until then.
+  void destroy();
+
   static void definePrototype(jsi::Runtime &runtime, jsi::Object &prototype) {
     installGetter(runtime, prototype, "__brand",
                   &GPUSharedTextureMemory::getBrand);
@@ -60,6 +69,8 @@ public:
                   &GPUSharedTextureMemory::beginAccess);
     installMethod(runtime, prototype, "endAccess",
                   &GPUSharedTextureMemory::endAccess);
+    installMethod(runtime, prototype, "destroy",
+                  &GPUSharedTextureMemory::destroy);
     installGetterSetter(runtime, prototype, "label",
                         &GPUSharedTextureMemory::getLabel,
                         &GPUSharedTextureMemory::setLabel);
@@ -68,7 +79,19 @@ public:
   inline const wgpu::SharedTextureMemory get() { return _instance; }
 
 private:
+  // Reports a use of the destroyed memory the way Dawn reports an invalid
+  // object: a validation error, caught by error scopes or else delivered to
+  // the device's uncapturederror event.
+  void injectDestroyedError(const char *method);
+
+  wgpu::Device _device;
   wgpu::SharedTextureMemory _instance;
+  // Kept by destroy(): like Dawn, createTexture() describes the error texture
+  // it then returns with them.
+  wgpu::SharedTextureMemoryProperties _properties;
+  // The textures with an access begun and not yet ended, so destroy() can
+  // report an access left open. Dawn doesn't track that across a release.
+  std::vector<wgpu::Texture> _accessed;
   std::string _label;
 };
 

package/lib/typescript/src/types.d.ts

@@ -95,6 +95,7 @@ export interface GPUSharedFence {
     readonly __brand: "GPUSharedFence";
     label: string;
     export(): GPUSharedFenceExportInfo;
+    destroy(): void;
 }
 export interface GPUSharedFenceState {
     fence: GPUSharedFence;
@@ -114,6 +115,7 @@ export interface GPUSharedTextureMemory {
     createTexture(descriptor?: GPUTextureDescriptor): GPUTexture;
     beginAccess(texture: GPUTexture, initialized: boolean, fences?: GPUSharedFenceState[]): void;
     endAccess(texture: GPUTexture): GPUSharedTextureMemoryEndAccessState;
+    destroy(): void;
 }
 export {};
 //# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-webgpu",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "React Native WebGPU",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -82,7 +82,7 @@
     "clang-format": "^1.8.0",
     "del-cli": "^5.1.0",
     "eslint": "9.35.0",
-    "eslint-config-react-native-wcandillon": "5.0.0",
+    "eslint-config-react-native-wcandillon": "5.0.1",
     "eslint-plugin-import": "2.32.0",
     "eslint-plugin-jest": "^28.8.2",
     "eslint-plugin-prettier": "^5.2.1",

package/src/types.ts

@@ -204,10 +204,17 @@ export interface GPUSharedFenceExportInfo {
 export interface GPUSharedFence {
   readonly __brand: "GPUSharedFence";
   label: string;
+  // Throws, after a validation error says why, if the fence was destroyed or
+  // Dawn can't export it.
   export(): GPUSharedFenceExportInfo;
+  // Releases the fence now (closing its sync fd on Android) rather than when
+  // the object is garbage collected. A later use is a validation error, and
+  // export() and beginAccess() then throw.
+  destroy(): void;
 }
 
-// A fence and the timeline value to wait for (0n for binary sync-fd fences).
+// A fence and the timeline value to wait for. Binary fences (sync-fd on
+// Vulkan) must use 1n: Dawn rejects any other value.
 export interface GPUSharedFenceState {
   fence: GPUSharedFence;
   signaledValue: bigint;
@@ -252,4 +259,10 @@ export interface GPUSharedTextureMemory {
   // Ends the access and returns the fences Dawn produced for it. Throws if the
   // access could not be ended.
   endAccess(texture: GPUTexture): GPUSharedTextureMemoryEndAccessState;
+  // Releases the memory (the imported native buffer) now rather than when the
+  // object is garbage collected. End the access first (a destroy() during one
+  // is a validation error, and the access stays open) and destroy the textures
+  // created from it. A later use is a validation error: createTexture() then
+  // returns an invalid texture, beginAccess() and endAccess() throw.
+  destroy(): void;
 }