react-native-webgpu 0.5.16 → 0.5.17

package/README.md

@@ -1,416 +1,13 @@
 # React Native WebGPU
 
-React Native implementation of WebGPU using [Dawn](https://dawn.googlesource.com/dawn).  
+WebGPU for React Native, powered by Dawn.
 
-React Native WebGPU requires React Native 0.81 or newer. It doesn't support the legacy architecture.
+[wcandillon.github.io/react-native-webgpu](https://wcandillon.github.io/react-native-webgpu/)
 
-## Installation
+## Getting Started
 
-```
-npm install react-native-webgpu
-```
+[Installation instructions](https://wcandillon.github.io/react-native-webgpu/docs/getting-started/installation)
 
-> The package was previously published as `react-native-wgpu`. A shim with that name is still available and simply re-exports `react-native-webgpu`.
+## Contributing
 
-## With Expo
-
-Expo provides a React Native WebGPU template that works with React Three Fiber.
-This works on iOS, Android, and Web.
-
-```
-npx create-expo-app@latest -e with-webgpu
-```
-
-https://github.com/user-attachments/assets/efbd05f8-4ce0-46c2-919c-03e1095bc8ac
-
-Below are some examples from the [example app](/apps/example/).
-
-https://github.com/user-attachments/assets/116a41b2-2cf8-49f1-9f16-a5c83637c198
-
-Starting from `r168`, Three.js runs out of the box with React Native WebGPU.
-You need to have a slight modification of [the metro config](/apps/example/metro.config.js) to resolve Three.js to the WebGPU build.
-We also support [react-three-fiber](/apps/example/src/ThreeJS/Fiber.tsx); to make it work, patch `node_modules/@react-three/fiber/package.json` (for instance via `patch-package`) so that it resolves to the WebGPU entry point instead of the React Native bundle:
-
-```diff
-diff --git a/node_modules/@react-three/fiber/package.json b/node_modules/@react-three/fiber/package.json
-@@
--  "react-native": "native/dist/react-three-fiber-native.cjs.js",
-+  "react-native": "dist/react-three-fiber.cjs.js",
-```
-
-For model loading, we also need [the following polyfill](/apps/example/src/App.tsx#29).
-
-https://github.com/user-attachments/assets/5b49ef63-0a3c-4679-aeb5-e4b4dddfcc1d
-
-We also provide prebuilt binaries for visionOS and macOS.
-
-https://github.com/user-attachments/assets/2d5c618e-5b15-4cef-8558-d4ddf8c70667
-
-## Usage
-
-Usage is identical to Web.
-
-```tsx
-import React from "react";
-import { StyleSheet, View, PixelRatio } from "react-native";
-import { Canvas, CanvasRef } from "react-native-webgpu";
-
-import { redFragWGSL, triangleVertWGSL } from "./triangle";
-
-export function HelloTriangle() {
-  const ref = useRef<CanvasRef>(null);
-  useEffect(() => {
-    const helloTriangle = async () => {
-      const adapter = await navigator.gpu.requestAdapter();
-      if (!adapter) {
-        throw new Error("No adapter");
-      }
-      const device = await adapter.requestDevice();
-      const presentationFormat = navigator.gpu.getPreferredCanvasFormat();
-
-      const context = ref.current!.getContext("webgpu")!;
-      const canvas = context.canvas as HTMLCanvasElement;
-      canvas.width = canvas.clientWidth * PixelRatio.get();
-      canvas.height = canvas.clientHeight * PixelRatio.get();
-
-      if (!context) {
-        throw new Error("No context");
-      }
-
-      context.configure({
-        device,
-        format: presentationFormat,
-        alphaMode: "opaque",
-      });
-
-      const pipeline = device.createRenderPipeline({
-        layout: "auto",
-        vertex: {
-          module: device.createShaderModule({
-            code: triangleVertWGSL,
-          }),
-          entryPoint: "main",
-        },
-        fragment: {
-          module: device.createShaderModule({
-            code: redFragWGSL,
-          }),
-          entryPoint: "main",
-          targets: [
-            {
-              format: presentationFormat,
-            },
-          ],
-        },
-        primitive: {
-          topology: "triangle-list",
-        },
-      });
-
-      const commandEncoder = device.createCommandEncoder();
-
-      const textureView = context.getCurrentTexture().createView();
-
-      const renderPassDescriptor: GPURenderPassDescriptor = {
-        colorAttachments: [
-          {
-            view: textureView,
-            clearValue: [0, 0, 0, 1],
-            loadOp: "clear",
-            storeOp: "store",
-          },
-        ],
-      };
-
-      const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);
-      passEncoder.setPipeline(pipeline);
-      passEncoder.draw(3);
-      passEncoder.end();
-
-      device.queue.submit([commandEncoder.finish()]);
-
-      context.present();
-    };
-    helloTriangle();
-  }, [ref]);
-
-  return (
-    <View style={style.container}>
-      <Canvas ref={ref} style={style.webgpu} />
-    </View>
-  );
-}
-
-const style = StyleSheet.create({
-  container: {
-    flex: 1,
-  },
-  webgpu: {
-    flex: 1,
-  },
-});
-```
-
-## Example App
-
-To run the example app you first need to [install Dawn](#installing-dawn).
-
-From there you will be able to run the example app properly.
-
-## Similarities and Differences with the Web
-
-The API has been designed to be completely symmetric with the Web.  
-For instance, you can access the WebGPU context synchronously, as well as the canvas size.  
-Pixel density and canvas resizing are handled exactly like on the Web as well.
-
-```tsx
-// The default canvas size is not scaled to the device pixel ratio
-// When resizing the canvas, the clientWidth and clientHeight are updated automatically
-// This behaviour is symmetric to the Web
-const ctx = canvas.current.getContext("webgpu")!;
-ctx.canvas.width = ctx.canvas.clientWidth * PixelRatio.get();
-ctx.canvas.height = ctx.canvas.clientHeight * PixelRatio.get();
-```
-
-### Frame Scheduling
-
-In React Native, frame presentation is a manual operation: when you are ready to present a frame, call `present()` on the context after submitting your commands to the queue. This works the same on every runtime: the main JS runtime, the Reanimated UI runtime, and dedicated worklet runtimes (`createWorkletRuntime` / `runOnRuntime`, or a Vision Camera frame processor). `present()` runs synchronously on the calling thread, so the frame is presented from whichever thread did the rendering.
-
-```tsx
-// draw
-// submit to the queue
-device.queue.submit([commandEncoder.finish()]);
-// This method is React Native only
-context.present();
-```
-
-### Threading model
-
-react-native-webgpu can drive WebGPU from more than one JavaScript runtime: the main JS runtime, the Reanimated UI runtime, and dedicated worklet runtimes (`createWorkletRuntime` / `runOnRuntime`, or a Vision Camera frame processor).
-This module also works well with [Bundle Mode](https://docs.swmansion.com/react-native-worklets/docs/bundleMode/) and lets you run complex Three.js scenes on the UI thread or dedicated worklet threads.
-
-There is a caveat with `device.lost` and `uncapturederror`: they are only delivered on the main JS runtime. This is usually fine because the GPU device is typically created on the main JS thread and then sent to the UI or a dedicated worklet thread. However, if for some reason you create the device outside the main JS thread, beware that `device.lost` and `uncapturederror` won't fire.
-
-### Canvas Transparency
-
-On Android, the `alphaMode` property is ignored when configuring the canvas.
-To have a transparent canvas by default, use the `transparent` property.
-
-```tsx
-return (
-  <View style={style.container}>
-    <Canvas ref={ref} style={style.webgpu} transparent />
-  </View>
-);
-```
-
-### External Textures
-
-This module provides a `createImageBitmap` function that you can use in `copyExternalImageToTexture`.
-
-```tsx
-const url = Image.resolveAssetSource(require("./assets/image.png")).uri;
-const response = await fetch(url);
-const imageBitmap = await createImageBitmap(await response.blob());
-
-const texture = device.createTexture({
-  size: [imageBitmap.width, imageBitmap.height, 1],
-  format: "rgba8unorm",
-  usage:
-    GPUTextureUsage.TEXTURE_BINDING |
-    GPUTextureUsage.COPY_DST |
-    GPUTextureUsage.RENDER_ATTACHMENT,
-});
-device.queue.copyExternalImageToTexture(
-  { source: imageBitmap },
-  { texture },
-  [imageBitmap.width, imageBitmap.height],
-);
-```
-
-### Shared Texture Memory
-
-React Native WebGPU exposes Dawn's `SharedTextureMemory` so you can import a native pixel surface (an `IOSurface`-backed `CVPixelBuffer` on iOS, an `AHardwareBuffer` on Android) as a sampleable `GPUTexture` without copying pixels through the CPU. This is the path you want for camera frames, video frames, or anything coming out of a hardware producer.
-
-Like `importExternalTexture` on the web, this is **enabled by default**, there is nothing to request at device creation. The only thing to check is that the device supports it before importing. It always does on iOS/macOS; it can be missing on some Android drivers and emulators.
-
-```tsx
-import type { NativeVideoFrame } from "react-native-wgpu";
-
-const adapter = await navigator.gpu.requestAdapter();
-const device = await adapter!.requestDevice();
-
-// On by default when supported; this is the only check you need.
-if (!device.features.has("rnwebgpu/native-texture" as GPUFeatureName)) {
-  return; // rare: some Android drivers/emulators can't import native surfaces
-}
-
-// `frame` here is a NativeVideoFrame whose .handle is the native surface
-// (IOSurfaceRef / AHardwareBuffer*). NativeVideoFrames are produced by helpers
-// like RNWebGPU.createVideoPlayer or RNWebGPU.createTestVideoFrame, or by
-// any third-party module that hands you a compatible native pointer.
-const memory = device.importSharedTextureMemory({
-  handle: frame.handle,
-  label: "video-frame",
-});
-const texture = memory.createTexture();
-
-memory.beginAccess(texture, /* initialized */ true);
-// ... bind `texture` into a sampler and render normally ...
-memory.endAccess(texture);
-
-texture.destroy();
-frame.release();
-```
-
-`beginAccess`/`endAccess` bracket the GPU's read window on the shared surface. Pass `initialized: true` when the producer has already written meaningful pixels (the typical video/camera case) and `false` when the next pass will fully overwrite the texture.
-
-### Importing External Textures
-
-`GPUDevice.importExternalTexture` is the higher-level path for sampling a native surface. You hand it a `NativeVideoFrame` and get back a `GPUExternalTexture` that you bind as a `texture_external` and read with `textureSampleBaseClampToEdge`. It does two things for you on top of `SharedTextureMemory`:
-
-- **Color conversion.** Camera and video surfaces are usually biplanar YUV (NV12), not RGB. An external texture carries the YUV→RGB matrix and the source/destination color-space transfer functions, so on the supported paths the sampler returns ready-to-use RGB in hardware. With raw `SharedTextureMemory` you would sample the luma/chroma planes and do that conversion by hand in WGSL. This is the main reason to prefer it for camera and video frames.
-- **Lifecycle.** It owns the `SharedTextureMemory` + `createTexture` + `beginAccess`/`endAccess` sequence internally, so you just import the frame and `destroy()` the result.
-
-It builds on the same default-on capability as Shared Texture Memory above, so feature-detect the device the same way before importing.
-
-> **Android note:** the hardware YUV→RGB conversion is fully automatic on iOS (NV12 `IOSurface`). On Android, camera frames arrive as an _opaque_ YCbCr `AHardwareBuffer`, and Dawn's Vulkan path forces an identity (`RGB_IDENTITY`) sampler conversion, so the external sample comes back as raw `[Y, Cb, Cr]`. You still get the zero-copy import and the rotation/mirror transform, but you need to apply the YUV→RGB matrix yourself in the shader. See the `CAMERA_PRELUDE` in the [VisionCamera example](/apps/example/src/VisionCamera/shaders.ts) for a ready-made BT.709 decode.
-
-```tsx
-const adapter = await navigator.gpu.requestAdapter();
-const device = await adapter!.requestDevice();
-// Feature-detect as shown above before importing on unsupported hardware.
-
-const render = () => {
-  // A GPUExternalTexture expires once the queue work that used it is submitted,
-  // so re-import one every frame.
-  const externalTexture = device.importExternalTexture({
-    source: frame, // a NativeVideoFrame
-    label: "video-frame",
-  });
-
-  const bindGroup = device.createBindGroup({
-    layout: pipeline.getBindGroupLayout(0),
-    entries: [
-      { binding: 0, resource: externalTexture },
-      { binding: 1, resource: sampler },
-    ],
-  });
-
-  // ... encode a pass that samples `externalTexture`, then:
-  device.queue.submit([encoder.finish()]);
-  context.present();
-
-  // Release the surface's access window right after the submit that sampled it.
-  externalTexture.destroy();
-};
-```
-
-Camera frames arrive in the sensor's native orientation, so `importExternalTexture` also accepts non-spec `rotation` (`0` | `90` | `180` | `270`, in degrees) and `mirrored` (horizontal flip) options. Dawn bakes them into the sampling transform, so the shader sees an upright frame. They map directly onto VisionCamera's `frame.orientation` / `frame.isMirrored`.
-
-#### Calling `destroy()`
-
-A `GPUExternalTexture` keeps an open access window on the underlying native surface until the wrapper is destroyed. On the Web `importExternalTexture` is core and the lifetime is handled for you; here the window is tied to the JavaScript object's lifetime. Call `externalTexture.destroy()` right after the `queue.submit()` that sampled it (never before) to release the surface back to its producer immediately. `destroy()` is idempotent, and the surface is also released when the object is garbage-collected, but relying on GC can starve a producer's buffer pool (e.g. an `AVPlayer`'s recycled `IOSurface`s) and pile up GPU resources, so prefer the explicit call in a render loop.
-
-### Reanimated Integration
-
-React Native WebGPU supports running WebGPU rendering on the UI thread using [React Native Reanimated](https://docs.swmansion.com/react-native-reanimated/) and [React Native Worklets](https://github.com/margelo/react-native-worklets).
-
-First, install the optional peer dependencies:
-
-```sh
-npm install react-native-reanimated react-native-worklets
-```
-
-WebGPU objects are automatically registered for Worklets serialization when the module loads. You can pass WebGPU objects like `GPUDevice` and `GPUCanvasContext` directly to worklets.
-Call `installWebGPU()` once at the top of the worklet to install flag constants like `GPUBufferUsage`, `GPUTextureUsage`, and so on.
-
-```tsx
-import { Canvas, installWebGPU } from "react-native-webgpu";
-import { runOnUI } from "react-native-reanimated";
-
-const renderFrame = (device: GPUDevice, context: GPUCanvasContext) => {
-  "worklet";
-  installWebGPU();
-  // WebGPU constants are now available on this worklet thread
-  const buffer = device.createBuffer({
-    size,
-    usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ,
-  });
-  // WebGPU rendering code runs on the UI thread
-  const commandEncoder = device.createCommandEncoder();
-  // ... render ...
-  device.queue.submit([commandEncoder.finish()]);
-  context.present();
-};
-
-// Initialize WebGPU on main thread, then run on UI thread
-const device = await adapter.requestDevice();
-const context = canvasRef.current.getContext("webgpu");
-runOnUI(renderFrame)(device, context);
-```
-
-## Troubleshooting
-
-### iOS
-
-To run the React Native WebGPU project on the iOS simulator, you need to disable the Metal validation API.  
-In "Edit Scheme," uncheck "Metal Validation". Learn more [here](https://developer.apple.com/documentation/xcode/validating-your-apps-metal-api-usage/).
-
-<img width="1052" alt="Uncheck 'Metal Validation'" src="https://github.com/user-attachments/assets/2676e5cc-e351-4a97-bdc8-22cbd7df2ef2">
-
-## Library Development
-
-Make sure to check out the submodules:
-
-```
-git submodule update --init
-```
-
-Make sure you have all the tools required for building the Skia libraries (Android Studio, XCode, Ninja, CMake, Android NDK/build tools).
-
-### Installing Dawn
-
-There is an alternative way which is to install the prebuilt binaries from GitHub.
-
-```sh
-$ yarn
-$ cd packages/webgpu
-$ yarn install-dawn
-```
-
-### Building Dawn
-
-Alternatively, you can build Dawn locally.
-
-```sh
-yarn
-cd packages/webgpu
-yarn build-dawn
-```
-
-### Upgrading
-
-1. `git submodule update --remote`
-2. `yarn clean-dawn`
-3. `yarn build-dawn`
-
-### Codegen
-
-* `cd packages/webgpu && yarn codegen`
-
-### Testing
-
-In the `package` folder, to run the test against Chrome for reference:
-
-```
-yarn test:ref
-```
-
-To run the e2e test, open the example app on the e2e screen.  
-By default, it will try to connect to a localhost test server.  
-If you want to run the test suite on a physical device, you can modify the address [here](/apps/example/src/useClient.ts#L4).
-
-```
-yarn test
-```
+For detailed information on library development, building, testing, and contributing guidelines, please see [CONTRIBUTING.md](packages/webgpu/CONTRIBUTING.md).

package/apple/MetalLayerColorSpace.mm

@@ -0,0 +1,44 @@
+#import <CoreGraphics/CoreGraphics.h>
+#import <Foundation/Foundation.h>
+#import <QuartzCore/CAMetalLayer.h>
+#import <QuartzCore/CATransaction.h>
+
+#include "webgpu/webgpu_cpp.h"
+
+namespace rnwgpu {
+
+// WebGPU canvas values are sRGB-encoded regardless of the texture format
+// (GPUCanvasConfiguration.colorSpace defaults to "srgb"), so the same shader
+// output must display identically on bgra8unorm and rgba16float surfaces.
+// Core Animation interprets a float-format layer with a nil colorspace as
+// extended *linear* sRGB, which displays the same values noticeably brighter.
+// Tagging the layer as (gamma-encoded) extended sRGB matches the browser
+// behavior: identical colors, with the extra precision of float16.
+void applyCAMetalLayerColorSpace(void *nativeSurface,
+                                 wgpu::TextureFormat format) {
+  CALayer *layer = (__bridge CALayer *)nativeSurface;
+  if (![layer isKindOfClass:[CAMetalLayer class]]) {
+    return;
+  }
+  auto metalLayer = static_cast<CAMetalLayer *>(layer);
+  if (format == wgpu::TextureFormat::RGBA16Float) {
+    CGColorSpaceRef colorSpace =
+        CGColorSpaceCreateWithName(kCGColorSpaceExtendedSRGB);
+    metalLayer.colorspace = colorSpace;
+    CGColorSpaceRelease(colorSpace);
+  } else if (metalLayer.colorspace != nil) {
+    // Restore the default (no color matching) when reconfiguring back to an
+    // 8-bit format.
+    metalLayer.colorspace = nil;
+  }
+  // The change must be set synchronously so the first present already sees
+  // it, and it must reach the render server. On a non-main thread (RN JS or
+  // worklet runtime) the property lands in that thread's implicit
+  // CATransaction, which may never commit on threads without a spinning
+  // runloop, so flush it now. On the main thread the runloop commits it.
+  if (!NSThread.isMainThread) {
+    [CATransaction flush];
+  }
+}
+
+} // namespace rnwgpu

package/cpp/rnwgpu/SurfaceRegistry.h

@@ -15,6 +15,13 @@ void WaitForCommandsToBeScheduled(WGPUDevice device);
 
 namespace rnwgpu {
 
+#ifdef __APPLE__
+// Tags the CAMetalLayer with the colorspace matching the configured texture
+// format. Implemented in apple/MetalLayerColorSpace.mm.
+void applyCAMetalLayerColorSpace(void *nativeSurface,
+                                 wgpu::TextureFormat format);
+#endif
+
 struct NativeInfo {
   void *nativeSurface;
   int width;
@@ -187,6 +194,9 @@ private:
   void _configure() {
     if (surface) {
       surface.Configure(&config);
+#ifdef __APPLE__
+      applyCAMetalLayerColorSpace(nativeSurface, config.format);
+#endif
     } else {
       wgpu::TextureDescriptor textureDesc;
       textureDesc.format = config.format;

package/lib/commonjs/formats.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getPreferredHighBitDepthCanvasFormat = void 0;
+var _reactNative = require("react-native");
+/// <reference types="@webgpu/types" />
+
+// Non-spec helper: the canvas texture format most likely to reach the display
+// with more than 8 bits per channel on the current platform. The returned
+// format keeps standard (SDR) sRGB semantics: values are encoded exactly like
+// on an 8-bit canvas, only with more precision, so colors match across
+// formats. This is about bit depth, not HDR (no extended range).
+//
+// - Apple platforms: "rgba16float" (16-bit float per channel). The library
+//   tags the CAMetalLayer with the extended sRGB colorspace automatically so
+//   the values display identically to an 8-bit canvas.
+// - Android: "rgb10a2unorm". A float16 swapchain works but is tagged as an
+//   SDR sRGB layer, and SurfaceFlinger quantizes SDR layers to the display
+//   pipeline depth during composition, discarding the extra precision.
+//   RGBA_1010102 buffers keep SDR semantics and can pass through composition,
+//   including direct scanout on 10-bit panels. Requires the Vulkan surface to
+//   expose the 10-bit format (common on modern devices).
+// - Web: "rgba16float", the float canvas format supported by browsers.
+const getPreferredHighBitDepthCanvasFormat = () => {
+  return _reactNative.Platform.OS === "android" ? "rgb10a2unorm" : "rgba16float";
+};
+exports.getPreferredHighBitDepthCanvasFormat = getPreferredHighBitDepthCanvasFormat;
+//# sourceMappingURL=formats.js.map

package/lib/commonjs/formats.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","getPreferredHighBitDepthCanvasFormat","Platform","OS","exports"],"sourceRoot":"../../src","sources":["formats.ts"],"mappings":";;;;;;AAEA,IAAAA,YAAA,GAAAC,OAAA;AAFA;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,oCAAoC,GAAGA,CAAA,KAAwB;EAC1E,OAAOC,qBAAQ,CAACC,EAAE,KAAK,SAAS,GAAG,cAAc,GAAG,aAAa;AACnE,CAAC;AAACC,OAAA,CAAAH,oCAAA,GAAAA,oCAAA","ignoreList":[]}

package/lib/commonjs/main/index.js

@@ -74,6 +74,18 @@ Object.keys(_GPUDeviceProvider).forEach(function (key) {
     }
   });
 });
+var _formats = require("../formats");
+Object.keys(_formats).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _formats[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _formats[key];
+    }
+  });
+});
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const _installOk = _NativeWebGPUModule.default.install();
 (0, _external.registerWebGPUForReanimated)();

package/lib/commonjs/main/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_external","require","_NativeWebGPUModule","_interopRequireDefault","_Canvas","Object","keys","forEach","key","prototype","hasOwnProperty","call","_exportNames","exports","defineProperty","enumerable","get","_Offscreen","_WebGPUViewNativeComponent","_hooks","_GPUDeviceProvider","e","__esModule","default","_installOk","WebGPUModule","install","registerWebGPUForReanimated","RNWebGPU","navigator","gpu","userAgent","global","createImageBitmap","bind","console","warn"],"sourceRoot":"../../../src","sources":["main/index.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_external","require","_NativeWebGPUModule","_interopRequireDefault","_Canvas","Object","keys","forEach","key","prototype","hasOwnProperty","call","_exportNames","exports","defineProperty","enumerable","get","_Offscreen","_WebGPUViewNativeComponent","_hooks","_GPUDeviceProvider","_formats","e","__esModule","default","_installOk","WebGPUModule","install","registerWebGPUForReanimated","RNWebGPU","navigator","gpu","userAgent","global","createImageBitmap","bind","console","warn"],"sourceRoot":"../../../src","sources":["main/index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/main/index.web.js

@@ -59,4 +59,15 @@ Object.keys(_GPUDeviceProvider).forEach(function (key) {
     }
   });
 });
+var _formats = require("../formats");
+Object.keys(_formats).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formats[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _formats[key];
+    }
+  });
+});
 //# sourceMappingURL=index.web.js.map

package/lib/commonjs/main/index.web.js.map

@@ -1 +1 @@
-{"version":3,"names":["require","_Canvas","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_Offscreen","_WebGPUViewNativeComponent","_hooks","_GPUDeviceProvider"],"sourceRoot":"../../../src","sources":["main/index.web.tsx"],"mappings":";;;;;AAAAA,OAAA;AAEA,IAAAC,OAAA,GAAAD,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAF,OAAA,EAAAG,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAJ,OAAA,CAAAI,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAR,OAAA,CAAAI,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,UAAA,GAAAV,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAO,UAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,UAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,UAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,0BAAA,GAAAX,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAQ,0BAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,0BAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,0BAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,MAAA,GAAAZ,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAS,MAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,MAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,MAAA,CAAAP,GAAA;IAAA;EAAA;AAAA;AACA,IAAAQ,kBAAA,GAAAb,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAU,kBAAA,EAAAT,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAQ,kBAAA,CAAAR,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAI,kBAAA,CAAAR,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}
+{"version":3,"names":["require","_Canvas","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_Offscreen","_WebGPUViewNativeComponent","_hooks","_GPUDeviceProvider","_formats"],"sourceRoot":"../../../src","sources":["main/index.web.tsx"],"mappings":";;;;;AAAAA,OAAA;AAEA,IAAAC,OAAA,GAAAD,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAF,OAAA,EAAAG,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAJ,OAAA,CAAAI,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAR,OAAA,CAAAI,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,UAAA,GAAAV,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAO,UAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,UAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,UAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,0BAAA,GAAAX,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAQ,0BAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,0BAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,0BAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,MAAA,GAAAZ,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAS,MAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,MAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,MAAA,CAAAP,GAAA;IAAA;EAAA;AAAA;AACA,IAAAQ,kBAAA,GAAAb,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAU,kBAAA,EAAAT,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAQ,kBAAA,CAAAR,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAI,kBAAA,CAAAR,GAAA;IAAA;EAAA;AAAA;AACA,IAAAS,QAAA,GAAAd,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAW,QAAA,EAAAV,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAS,QAAA,CAAAT,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAK,QAAA,CAAAT,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/lib/module/formats.js

@@ -0,0 +1,24 @@
+/// <reference types="@webgpu/types" />
+
+import { Platform } from "react-native";
+
+// Non-spec helper: the canvas texture format most likely to reach the display
+// with more than 8 bits per channel on the current platform. The returned
+// format keeps standard (SDR) sRGB semantics: values are encoded exactly like
+// on an 8-bit canvas, only with more precision, so colors match across
+// formats. This is about bit depth, not HDR (no extended range).
+//
+// - Apple platforms: "rgba16float" (16-bit float per channel). The library
+//   tags the CAMetalLayer with the extended sRGB colorspace automatically so
+//   the values display identically to an 8-bit canvas.
+// - Android: "rgb10a2unorm". A float16 swapchain works but is tagged as an
+//   SDR sRGB layer, and SurfaceFlinger quantizes SDR layers to the display
+//   pipeline depth during composition, discarding the extra precision.
+//   RGBA_1010102 buffers keep SDR semantics and can pass through composition,
+//   including direct scanout on 10-bit panels. Requires the Vulkan surface to
+//   expose the 10-bit format (common on modern devices).
+// - Web: "rgba16float", the float canvas format supported by browsers.
+export const getPreferredHighBitDepthCanvasFormat = () => {
+  return Platform.OS === "android" ? "rgb10a2unorm" : "rgba16float";
+};
+//# sourceMappingURL=formats.js.map

package/lib/module/formats.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","getPreferredHighBitDepthCanvasFormat","OS"],"sourceRoot":"../../src","sources":["formats.ts"],"mappings":"AAAA;;AAEA,SAASA,QAAQ,QAAQ,cAAc;;AAEvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oCAAoC,GAAGA,CAAA,KAAwB;EAC1E,OAAOD,QAAQ,CAACE,EAAE,KAAK,SAAS,GAAG,cAAc,GAAG,aAAa;AACnE,CAAC","ignoreList":[]}

package/lib/module/main/index.js

@@ -5,6 +5,7 @@ export * from "../Offscreen";
 export * from "../WebGPUViewNativeComponent";
 export * from "../hooks";
 export * from "../GPUDeviceProvider";
+export * from "../formats";
 export { default as WebGPUModule } from "../NativeWebGPUModule";
 const _installOk = WebGPUModule.install();
 registerWebGPUForReanimated();

package/lib/module/main/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["registerWebGPUForReanimated","WebGPUModule","default","_installOk","install","RNWebGPU","navigator","gpu","userAgent","global","createImageBitmap","bind","console","warn"],"sourceRoot":"../../../src","sources":["main/index.tsx"],"mappings":"AAAA,SAASA,2BAA2B,QAAQ,aAAa;AACzD,OAAOC,YAAY,MAAM,uBAAuB;AAEhD,cAAc,WAAW;AACzB,cAAc,cAAc;AAC5B,cAAc,8BAA8B;AAC5C,cAAc,UAAU;AACxB,cAAc,sBAAsB;AAEpC,SAASC,OAAO,IAAID,YAAY,QAAQ,uBAAuB;AAE/D,MAAME,UAAU,GAAGF,YAAY,CAACG,OAAO,CAAC,CAAC;AAEzCJ,2BAA2B,CAAC,CAAC;AAE7B,IAAI,OAAOK,QAAQ,KAAK,WAAW,EAAE;EACnC,IAAI,CAACC,SAAS,EAAE;IACd;IACAA,SAAS,GAAG;MACVC,GAAG,EAAEF,QAAQ,CAACE,GAAG;MACjBC,SAAS,EAAE;IACb,CAAC;EACH,CAAC,MAAM;IACLF,SAAS,CAACC,GAAG,GAAGF,QAAQ,CAACE,GAAG;IAC5B,IAAI,OAAOD,SAAS,CAACE,SAAS,KAAK,QAAQ,EAAE;MAC3C,IAAI;QACF;QACA;QACAF,SAAS,CAACE,SAAS,GAAG,cAAc;MACtC,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;EACF;EACAC,MAAM,CAACC,iBAAiB,GACtBD,MAAM,CAACC,iBAAiB,IAAIL,QAAQ,CAACK,iBAAiB,CAACC,IAAI,CAACN,QAAQ,CAAC;AACzE,CAAC,MAAM;EACLO,OAAO,CAACC,IAAI,CACV,4CAA4CV,UAAU,uCACxD,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["registerWebGPUForReanimated","WebGPUModule","default","_installOk","install","RNWebGPU","navigator","gpu","userAgent","global","createImageBitmap","bind","console","warn"],"sourceRoot":"../../../src","sources":["main/index.tsx"],"mappings":"AAAA,SAASA,2BAA2B,QAAQ,aAAa;AACzD,OAAOC,YAAY,MAAM,uBAAuB;AAEhD,cAAc,WAAW;AACzB,cAAc,cAAc;AAC5B,cAAc,8BAA8B;AAC5C,cAAc,UAAU;AACxB,cAAc,sBAAsB;AACpC,cAAc,YAAY;AAE1B,SAASC,OAAO,IAAID,YAAY,QAAQ,uBAAuB;AAE/D,MAAME,UAAU,GAAGF,YAAY,CAACG,OAAO,CAAC,CAAC;AAEzCJ,2BAA2B,CAAC,CAAC;AAE7B,IAAI,OAAOK,QAAQ,KAAK,WAAW,EAAE;EACnC,IAAI,CAACC,SAAS,EAAE;IACd;IACAA,SAAS,GAAG;MACVC,GAAG,EAAEF,QAAQ,CAACE,GAAG;MACjBC,SAAS,EAAE;IACb,CAAC;EACH,CAAC,MAAM;IACLF,SAAS,CAACC,GAAG,GAAGF,QAAQ,CAACE,GAAG;IAC5B,IAAI,OAAOD,SAAS,CAACE,SAAS,KAAK,QAAQ,EAAE;MAC3C,IAAI;QACF;QACA;QACAF,SAAS,CAACE,SAAS,GAAG,cAAc;MACtC,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;EACF;EACAC,MAAM,CAACC,iBAAiB,GACtBD,MAAM,CAACC,iBAAiB,IAAIL,QAAQ,CAACK,iBAAiB,CAACC,IAAI,CAACN,QAAQ,CAAC;AACzE,CAAC,MAAM;EACLO,OAAO,CAACC,IAAI,CACV,4CAA4CV,UAAU,uCACxD,CAAC;AACH","ignoreList":[]}

package/lib/module/main/index.web.js

@@ -4,6 +4,7 @@ export * from "../Offscreen";
 export * from "../WebGPUViewNativeComponent";
 export * from "../hooks";
 export * from "../GPUDeviceProvider";
+export * from "../formats";
 
 // We don't need to set all global properties on web, webgpu is already available globally
 //# sourceMappingURL=index.web.js.map

package/lib/module/main/index.web.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["main/index.web.tsx"],"mappings":"AAAA,OAAO,yBAAyB;AAEhC,cAAc,WAAW;AACzB,cAAc,cAAc;AAC5B,cAAc,8BAA8B;AAC5C,cAAc,UAAU;AACxB,cAAc,sBAAsB;;AAEpC","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["main/index.web.tsx"],"mappings":"AAAA,OAAO,yBAAyB;AAEhC,cAAc,WAAW;AACzB,cAAc,cAAc;AAC5B,cAAc,8BAA8B;AAC5C,cAAc,UAAU;AACxB,cAAc,sBAAsB;AACpC,cAAc,YAAY;;AAE1B","ignoreList":[]}

package/lib/typescript/jest.config.d.ts

@@ -1,5 +1,6 @@
 export let preset: string;
 export let modulePathIgnorePatterns: string[];
+export let testPathIgnorePatterns: string[];
 export let globalSetup: string;
 export let globalTeardown: string;
 export let transform: {

package/lib/typescript/lib/commonjs/formats.d.ts

@@ -0,0 +1,3 @@
+export const __esModule: boolean;
+export function getPreferredHighBitDepthCanvasFormat(): "rgb10a2unorm" | "rgba16float";
+//# sourceMappingURL=formats.d.ts.map

package/lib/typescript/lib/commonjs/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../../commonjs/formats.js"],"names":[],"mappings":";AAyBA,uFAEC"}

package/lib/typescript/lib/module/formats.d.ts

@@ -0,0 +1,2 @@
+export function getPreferredHighBitDepthCanvasFormat(): "rgb10a2unorm" | "rgba16float";
+//# sourceMappingURL=formats.d.ts.map

package/lib/typescript/lib/module/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../../module/formats.js"],"names":[],"mappings":"AAoBO,uFAEN"}

package/lib/typescript/lib/module/main/index.d.ts

@@ -3,5 +3,6 @@ export * from "../Offscreen";
 export * from "../WebGPUViewNativeComponent";
 export * from "../hooks";
 export * from "../GPUDeviceProvider";
+export * from "../formats";
 export { default as WebGPUModule } from "../NativeWebGPUModule";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/lib/module/main/index.web.d.ts

@@ -3,4 +3,5 @@ export * from "../Offscreen";
 export * from "../WebGPUViewNativeComponent";
 export * from "../hooks";
 export * from "../GPUDeviceProvider";
+export * from "../formats";
 //# sourceMappingURL=index.web.d.ts.map

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

@@ -0,0 +1,2 @@
+export declare const getPreferredHighBitDepthCanvasFormat: () => GPUTextureFormat;
+//# sourceMappingURL=formats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../../src/formats.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,oCAAoC,QAAO,gBAEvD,CAAC"}

package/lib/typescript/src/main/index.d.ts

@@ -3,5 +3,6 @@ export * from "../Offscreen";
 export * from "../WebGPUViewNativeComponent";
 export * from "../hooks";
 export * from "../GPUDeviceProvider";
+export * from "../formats";
 export { default as WebGPUModule } from "../NativeWebGPUModule";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/main/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/main/index.tsx"],"names":[],"mappings":"AAGA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AAErC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/main/index.tsx"],"names":[],"mappings":"AAGA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/typescript/src/main/index.web.d.ts

@@ -4,4 +4,5 @@ export * from "../Offscreen";
 export * from "../WebGPUViewNativeComponent";
 export * from "../hooks";
 export * from "../GPUDeviceProvider";
+export * from "../formats";
 //# sourceMappingURL=index.web.d.ts.map

package/lib/typescript/src/main/index.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/main/index.web.tsx"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AAEjC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/main/index.web.tsx"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AAEjC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-webgpu",
-  "version": "0.5.16",
+  "version": "0.5.17",
   "description": "React Native WebGPU",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/formats.ts

@@ -0,0 +1,23 @@
+/// <reference types="@webgpu/types" />
+
+import { Platform } from "react-native";
+
+// Non-spec helper: the canvas texture format most likely to reach the display
+// with more than 8 bits per channel on the current platform. The returned
+// format keeps standard (SDR) sRGB semantics: values are encoded exactly like
+// on an 8-bit canvas, only with more precision, so colors match across
+// formats. This is about bit depth, not HDR (no extended range).
+//
+// - Apple platforms: "rgba16float" (16-bit float per channel). The library
+//   tags the CAMetalLayer with the extended sRGB colorspace automatically so
+//   the values display identically to an 8-bit canvas.
+// - Android: "rgb10a2unorm". A float16 swapchain works but is tagged as an
+//   SDR sRGB layer, and SurfaceFlinger quantizes SDR layers to the display
+//   pipeline depth during composition, discarding the extra precision.
+//   RGBA_1010102 buffers keep SDR semantics and can pass through composition,
+//   including direct scanout on 10-bit panels. Requires the Vulkan surface to
+//   expose the 10-bit format (common on modern devices).
+// - Web: "rgba16float", the float canvas format supported by browsers.
+export const getPreferredHighBitDepthCanvasFormat = (): GPUTextureFormat => {
+  return Platform.OS === "android" ? "rgb10a2unorm" : "rgba16float";
+};

package/src/main/index.tsx

@@ -6,6 +6,7 @@ export * from "../Offscreen";
 export * from "../WebGPUViewNativeComponent";
 export * from "../hooks";
 export * from "../GPUDeviceProvider";
+export * from "../formats";
 
 export { default as WebGPUModule } from "../NativeWebGPUModule";
 

package/src/main/index.web.tsx

@@ -5,5 +5,6 @@ export * from "../Offscreen";
 export * from "../WebGPUViewNativeComponent";
 export * from "../hooks";
 export * from "../GPUDeviceProvider";
+export * from "../formats";
 
 // We don't need to set all global properties on web, webgpu is already available globally