@shopify/react-native-skia 2.6.4 → 2.6.5

package/lib/module/web/LoadSkiaWeb.js.map

@@ -1 +1 @@
-{"version":3,"names":["CanvasKitInit","ckSharedPromise","LoadSkiaWeb","opts","_ckSharedPromise","global","CanvasKit","undefined","LoadSkia"],"sources":["LoadSkiaWeb.tsx"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/ban-ts-comment\n// @ts-ignore\nimport CanvasKitInit from \"canvaskit-wasm/bin/full/canvaskit\";\nimport type {\n  CanvasKit as CanvasKitType,\n  CanvasKitInitOptions,\n} from \"canvaskit-wasm\";\n\ndeclare global {\n  var CanvasKit: CanvasKitType;\n}\n\nlet ckSharedPromise: Promise<CanvasKitType>;\n\nexport const LoadSkiaWeb = async (opts?: CanvasKitInitOptions) => {\n  if (global.CanvasKit !== undefined) {\n    return;\n  }\n  ckSharedPromise = ckSharedPromise ?? CanvasKitInit(opts);\n  const CanvasKit = await ckSharedPromise;\n  // The CanvasKit API is stored on the global object and used\n  // to create the JsiSKApi in the Skia.web.ts file.\n  global.CanvasKit = CanvasKit;\n};\n\n// We keep this function for backward compatibility\nexport const LoadSkia = LoadSkiaWeb;\n"],"mappings":"AAAA;AACA;AACA,OAAOA,aAAa,MAAM,mCAAmC;AAU7D,IAAIC,eAAuC;AAE3C,OAAO,MAAMC,WAAW,GAAG,MAAOC,IAA2B,IAAK;EAAA,IAAAC,gBAAA;EAChE,IAAIC,MAAM,CAACC,SAAS,KAAKC,SAAS,EAAE;IAClC;EACF;EACAN,eAAe,IAAAG,gBAAA,GAAGH,eAAe,cAAAG,gBAAA,cAAAA,gBAAA,GAAIJ,aAAa,CAACG,IAAI,CAAC;EACxD,MAAMG,SAAS,GAAG,MAAML,eAAe;EACvC;EACA;EACAI,MAAM,CAACC,SAAS,GAAGA,SAAS;AAC9B,CAAC;;AAED;AACA,OAAO,MAAME,QAAQ,GAAGN,WAAW","ignoreList":[]}
+{"version":3,"names":["CanvasKitInit","ckSharedPromise","LoadSkiaWeb","opts","global","CanvasKit","undefined","LoadSkia"],"sources":["LoadSkiaWeb.tsx"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/ban-ts-comment\n// @ts-ignore\nimport CanvasKitInit from \"canvaskit-wasm/bin/full/canvaskit\";\nimport type {\n  CanvasKit as CanvasKitType,\n  CanvasKitInitOptions,\n} from \"canvaskit-wasm\";\n\ndeclare global {\n  var CanvasKit: CanvasKitType;\n}\n\nlet ckSharedPromise: Promise<CanvasKitType>;\n\nexport const LoadSkiaWeb = async (opts?: CanvasKitInitOptions) => {\n  if (global.CanvasKit !== undefined) {\n    return;\n  }\n  ckSharedPromise = ckSharedPromise ?? CanvasKitInit(opts);\n  const CanvasKit = await ckSharedPromise;\n  // The CanvasKit API is stored on the global object and used\n  // to create the JsiSKApi in the Skia.web.ts file.\n  global.CanvasKit = CanvasKit;\n};\n\n// We keep this function for backward compatibility\nexport const LoadSkia = LoadSkiaWeb;\n"],"mappings":"AAAA;AACA;AACA,OAAOA,aAAa,MAAM,mCAAmC;AAU7D,IAAIC,eAAuC;AAE3C,OAAO,MAAMC,WAAW,GAAG,MAAOC,IAA2B,IAAK;EAChE,IAAIC,MAAM,CAACC,SAAS,KAAKC,SAAS,EAAE;IAClC;EACF;EACAL,eAAe,GAAGA,eAAe,aAAfA,eAAe,cAAfA,eAAe,GAAID,aAAa,CAACG,IAAI,CAAC;EACxD,MAAME,SAAS,GAAG,MAAMJ,eAAe;EACvC;EACA;EACAG,MAAM,CAACC,SAAS,GAAGA,SAAS;AAC9B,CAAC;;AAED;AACA,OAAO,MAAME,QAAQ,GAAGL,WAAW","ignoreList":[]}

package/lib/typescript/lib/commonjs/skia/types/WebGPU.d.ts

@@ -0,0 +1 @@
+export const __esModule: boolean;

package/lib/typescript/lib/commonjs/skia/web/JsiSkNativeBufferFactory.d.ts

@@ -1,6 +1,7 @@
 export const __esModule: boolean;
 export class JsiSkNativeBufferFactory extends _Host.Host {
     MakeFromImage(image: any): OffscreenCanvas;
+    MakeTestBuffer(width: any, height: any): OffscreenCanvas;
     Release(_nativeBuffer: any): void;
 }
 import _Host = require("./Host");

package/lib/typescript/lib/module/skia/types/WebGPU.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/typescript/lib/module/skia/types/index.d.ts

@@ -27,6 +27,7 @@ export * from "./TextBlob";
 export * from "./Paragraph";
 export * from "./Matrix4";
 export * from "./NativeBuffer";
+export * from "./WebGPU";
 export * from "./Recorder";
 export * from "./Video";
 export * from "./Skottie";

package/lib/typescript/lib/module/skia/web/JsiSkNativeBufferFactory.d.ts

@@ -1,5 +1,6 @@
 export class JsiSkNativeBufferFactory extends Host {
     MakeFromImage(image: any): OffscreenCanvas;
+    MakeTestBuffer(width: any, height: any): OffscreenCanvas;
     Release(_nativeBuffer: any): void;
 }
 import { Host } from "./Host";

package/lib/typescript/src/skia/types/NativeBuffer/NativeBufferFactory.d.ts

@@ -14,7 +14,16 @@ export interface NativeBufferFactory {
      */
     MakeFromImage: (image: SkImage) => NativeBuffer;
     /**
-     * Release a native buffer that was created with `MakeFromImage`.
+     * Create a native buffer of the given size filled with a procedural test
+     * pattern (RGB gradient + diagonal stripes), entirely on the CPU. Useful for
+     * examples and tests that need a buffer to feed into
+     * `GPUDevice.importExternalTexture` without a camera/video source. Release it
+     * with `Release`.
+     */
+    MakeTestBuffer: (width: number, height: number) => NativeBuffer;
+    /**
+     * Release a native buffer that was created with `MakeFromImage` or
+     * `MakeTestBuffer`.
      */
     Release: (nativeBuffer: NativeBuffer) => void;
 }

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

@@ -0,0 +1,88 @@
+import type { NativeBuffer } from "./NativeBuffer";
+/**
+ * Descriptor for {@link GPUDevice.importExternalTexture} when the source is a
+ * Skia NativeBuffer (Skia has no WebCodecs `VideoFrame`).
+ *
+ * `source` is the handle returned by `Skia.NativeBuffer.MakeFromImage`: a
+ * `CVPixelBufferRef` on Apple, an `AHardwareBuffer*` on Android. The caller
+ * owns its lifetime (release it with `Skia.NativeBuffer.Release`) and must keep
+ * it alive until the imported texture is destroyed.
+ */
+export interface SkiaGPUExternalTextureDescriptor extends GPUObjectDescriptorBase {
+    source: NativeBuffer;
+    /** Rotation applied while sampling, in degrees. One of 0 | 90 | 180 | 270. */
+    rotation?: number;
+    /** Mirror horizontally while sampling. */
+    mirrored?: boolean;
+}
+/**
+ * Descriptor for {@link GPUDevice.importSharedTextureMemory}. `handle` is the
+ * NativeBuffer returned by `Skia.NativeBuffer.MakeFromImage` (see
+ * {@link SkiaGPUExternalTextureDescriptor} for the platform-specific types and
+ * lifetime rules).
+ */
+export interface GPUSharedTextureMemoryDescriptor extends GPUObjectDescriptorBase {
+    handle: NativeBuffer;
+}
+/**
+ * Shared texture memory imported from a platform native buffer via
+ * {@link GPUDevice.importSharedTextureMemory}. Create a texture that aliases
+ * the memory, then bracket the GPU work that touches it with
+ * {@link GPUSharedTextureMemory.beginAccess} / {@link GPUSharedTextureMemory.endAccess}.
+ */
+export interface GPUSharedTextureMemory extends GPUObjectBase {
+    /** Create a texture that aliases the shared memory. */
+    createTexture(descriptor?: GPUTextureDescriptor): GPUTexture;
+    /**
+     * Acquire the memory for GPU access. `initialized` marks whether the existing
+     * contents should be preserved (pass `true` for an already-rendered frame).
+     * Returns `false` if access could not be acquired.
+     */
+    beginAccess(texture: GPUTexture, initialized: boolean): boolean;
+    /**
+     * Release the memory after the GPU work that accessed it has been submitted.
+     * Returns `false` on failure.
+     */
+    endAccess(texture: GPUTexture): boolean;
+}
+/**
+ * Dawn-specific toggles, passed via {@link GPUDeviceDescriptor.dawnToggles} to
+ * `adapter.requestDevice`. This is a non-spec, Dawn-only extension; see Dawn's
+ * toggle list for valid names.
+ */
+export interface GPUDawnTogglesDescriptor {
+    enabledToggles?: string[];
+    disabledToggles?: string[];
+}
+declare global {
+    interface GPUDeviceDescriptor {
+        /** Dawn-specific toggles (Skia/Graphite extension, non-spec). */
+        dawnToggles?: GPUDawnTogglesDescriptor;
+    }
+    interface GPUExternalTexture {
+        /**
+         * Skia extension: end the imported buffer's shared-memory access window and
+         * release the underlying resources. Call right after the `queue.submit()`
+         * that sampled this texture (never before). Idempotent, and also runs at
+         * garbage collection as a fallback.
+         */
+        destroy(): void;
+    }
+    interface GPUDevice {
+        /**
+         * Skia extension: import a NativeBuffer (from
+         * `Skia.NativeBuffer.MakeFromImage`) as a {@link GPUExternalTexture}, sampled
+         * with `texture_external` in WGSL. The returned texture owns the
+         * shared-memory access window; call `destroy()` on it after the sampling
+         * `queue.submit()`.
+         */
+        importExternalTexture(descriptor: SkiaGPUExternalTextureDescriptor): GPUExternalTexture;
+        /**
+         * Skia extension: import a NativeBuffer (from
+         * `Skia.NativeBuffer.MakeFromImage`) as {@link GPUSharedTextureMemory}, the
+         * lower-level path that lets you create an aliasing texture and manage the
+         * begin/end access window yourself.
+         */
+        importSharedTextureMemory(descriptor: GPUSharedTextureMemoryDescriptor): GPUSharedTextureMemory;
+    }
+}

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

@@ -30,6 +30,7 @@ export * from "./Size";
 export * from "./Paragraph";
 export * from "./Matrix4";
 export * from "./NativeBuffer";
+export * from "./WebGPU";
 export * from "./Recorder";
 export * from "./Video";
 export * from "./Skottie";

package/lib/typescript/src/skia/web/JsiSkNativeBufferFactory.d.ts

@@ -4,5 +4,6 @@ import { Host } from "./Host";
 export declare class JsiSkNativeBufferFactory extends Host implements NativeBufferFactory {
     constructor(CanvasKit: CanvasKit);
     MakeFromImage(image: SkImage): NativeBuffer;
+    MakeTestBuffer(width: number, height: number): NativeBuffer;
     Release(_nativeBuffer: NativeBuffer): void;
 }

package/package.json

@@ -5,11 +5,10 @@
     "provenance": true
   },
   "bin": {
-    "install-skia": "scripts/install-libs.js",
     "setup-skia-web": "scripts/setup-canvaskit.js"
   },
   "title": "React Native Skia",
-  "version": "2.6.4",
+  "version": "2.6.5",
   "description": "High-performance React Native Graphics using Skia",
   "main": "lib/module/index.js",
   "react-native": "src/index.ts",
@@ -17,7 +16,6 @@
   "types": "lib/typescript/index.d.ts",
   "files": [
     "scripts/setup-canvaskit.js",
-    "scripts/install-libs.js",
     "src/**",
     "lib/**",
     "!**/__tests__/**",
@@ -37,7 +35,6 @@
     "dist/**"
   ],
   "scripts": {
-    "postinstall": "node scripts/install-libs.js",
     "lint": "eslint . --ext .ts,.tsx  --max-warnings 0 --cache --fix",
     "tsc": "tsc --noEmit",
     "test": "jest",
@@ -47,8 +44,8 @@
     "clean-skia": "yarn rimraf ./libs && yarn rimraf ../../externals/skia/out",
     "build-skia": "tsx ./scripts/build-skia.ts",
     "copy-skia-headers": "tsx ./scripts/copy-skia-headers.ts",
+    "install-skia": "tsx ./scripts/install-skia.ts",
     "install-skia-graphite": "tsx ./scripts/install-skia-graphite.ts",
-    "install-skia": "node scripts/install-libs.js",
     "clang-format": "yarn clang-format-ios && yarn clang-format-android && yarn clang-format-common",
     "clang-format-ios": "find apple/ -iname '*.h' -o -iname '*.mm' -o -iname '*.cpp' | xargs clang-format -i",
     "clang-format-android": "find android/cpp/ -iname '*.h' -o -iname '*.m' -o -iname '*.cpp' | xargs clang-format -i",
@@ -92,8 +89,13 @@
     }
   },
   "devDependencies": {
-    "@babel/plugin-proposal-nullish-coalescing-operator": "7.18.6",
+    "@babel/plugin-transform-class-properties": "^7.28.0",
     "@babel/plugin-transform-explicit-resource-management": "^7.28.0",
+    "@babel/plugin-transform-nullish-coalescing-operator": "^7.28.0",
+    "@babel/preset-env": "^7.28.0",
+    "@babel/preset-flow": "^7.28.0",
+    "@babel/preset-react": "^7.28.0",
+    "@babel/preset-typescript": "^7.28.0",
     "@blazediff/core": "^1.4.0",
     "@semantic-release/commit-analyzer": "^13.0.0",
     "@semantic-release/exec": "^7.0.3",
@@ -121,11 +123,11 @@
     "rimraf": "3.0.2",
     "semantic-release": "^24.1.0",
     "semantic-release-yarn": "^3.0.2",
-    "tar": "^7.5.11",
+    "tar": "^7.5.16",
     "ts-jest": "29.4.3",
     "tsx": "^4.21.0",
     "typescript": "^5.2.2",
-    "ws": "8.20.1"
+    "ws": "8.21.0"
   },
   "dependencies": {
     "canvaskit-wasm": "0.41.0",

package/react-native-skia.podspec

@@ -1,6 +1,7 @@
 # @shopify/react-native-skia.podspec
 
 require "json"
+require "fileutils"
 
 package = JSON.parse(File.read(File.join(__dir__, "package.json")))
 
@@ -8,6 +9,55 @@ package = JSON.parse(File.read(File.join(__dir__, "package.json")))
 use_graphite = File.exist?(File.join(__dir__, 'libs', '.graphite'))
 puts "-- SK_GRAPHITE: #{use_graphite ? 'ON' : 'OFF'} (detected via libs/.graphite marker file)"
 
+# Resolve a node package directory using Node's own module resolution
+# (mirrors `require.resolve(pkg/package.json)`). Returns nil if it can't be found.
+# Defined as a lambda (not a `def`) because CocoaPods evaluates the podspec inside
+# the `Pod` module, where top-level methods are not reachable at the call site.
+resolve_node_package = lambda do |name, base_dir|
+  script = "process.stdout.write(require('path').dirname(require.resolve('#{name}/package.json')))"
+  dir = Dir.chdir(base_dir) { `node -e "#{script}" 2>/dev/null`.strip }
+  dir.empty? ? nil : dir
+end
+
+# Copy the prebuilt xcframeworks from the Skia npm packages into libs/<platform>.
+#
+# This replaces what the old npm `postinstall` script used to do. We do it here, at
+# `pod install` time, so we no longer rely on a lifecycle script. CocoaPods always
+# re-evaluates the podspec for path-based pods, so this runs on every install; to keep
+# it cache-friendly we stamp the copied package version into libs/<platform>/.version
+# and skip the copy when it already matches. On a version bump the frameworks are
+# re-copied and CocoaPods picks up the change. This is best-effort: if `pod install`
+# does not detect the change, a clean reinstall fixes it (acceptable until the upcoming
+# Swift Package Manager migration).
+install_apple_skia_libs = lambda do |base_dir|
+  { 'ios' => 'react-native-skia-apple-ios',
+    'macos' => 'react-native-skia-apple-macos',
+    'tvos' => 'react-native-skia-apple-tvos' }.each do |platform, pkg_name|
+    pkg_dir = resolve_node_package.call(pkg_name, base_dir)
+    next if pkg_dir.nil?
+
+    src = File.join(pkg_dir, 'libs')
+    next unless Dir.exist?(src) && !Dir.glob(File.join(src, '*.xcframework')).empty?
+
+    version = JSON.parse(File.read(File.join(pkg_dir, 'package.json')))['version'].to_s
+    dest = File.join(base_dir, 'libs', platform)
+    marker = File.join(dest, '.version')
+
+    # Already up to date: leave the files untouched so CocoaPods keeps its cache.
+    next if File.exist?(marker) && File.read(marker).strip == version
+
+    Pod::UI.puts "react-native-skia: installing #{platform} Skia frameworks (#{version})"
+    FileUtils.rm_rf(dest)
+    FileUtils.mkdir_p(dest)
+    Dir.glob(File.join(src, '*.xcframework')).each { |xcf| FileUtils.cp_r(xcf, dest) }
+    File.write(marker, version)
+  end
+end
+
+# Graphite downloads its binaries directly into libs/; only the default build needs
+# the npm packages copied in.
+install_apple_skia_libs.call(__dir__) unless use_graphite
+
 # Set preprocessor definitions based on GRAPHITE flag
 preprocessor_defs = use_graphite ?
   '$(inherited) SK_GRAPHITE=1 SK_IMAGE_READ_PIXELS_DISABLE_LEGACY_API=1 SK_DISABLE_LEGACY_SHAPER_FACTORY=1' :
@@ -21,22 +71,24 @@ framework_names = ['libskia', 'libsvg', 'libskshaper', 'libskparagraph',
 # Add Dawn library for Graphite builds (contains dawn::native symbols)
 framework_names += ['libdawn_combined'] if use_graphite
 
-# Verify that prebuilt binaries have been installed by the postinstall script
+# Verify that the prebuilt binaries are available (copied in above, or downloaded by
+# install-skia-graphite for Graphite builds).
 unless Dir.exist?(File.join(__dir__, 'libs', 'ios')) && Dir.exist?(File.join(__dir__, 'libs', 'macos'))
   Pod::UI.warn "#{'-' * 72}"
   Pod::UI.warn "react-native-skia: Skia prebuilt binaries not found in libs/!"
   Pod::UI.warn ""
-  Pod::UI.warn "Run the following command to install them:"
-  Pod::UI.warn "  npx install-skia"
+  Pod::UI.warn "Make sure dependencies are installed (yarn install / npm install) so that"
+  Pod::UI.warn "the react-native-skia-apple-* packages are present, then run `pod install` again."
   Pod::UI.warn "#{'-' * 72}"
-  raise "react-native-skia: Skia prebuilt binaries not found. Run `npx install-skia` to fix this."
+  raise "react-native-skia: Skia prebuilt binaries not found. Run `yarn install` then `pod install` to fix this."
 end
 
 # Build platform-specific framework paths (relative to pod's libs directory)
-# xcframeworks are copied into libs/ by the npm postinstall script (scripts/install-libs.js)
+# xcframeworks are copied into libs/ by install_apple_skia_libs above (default build)
+# or downloaded by install-skia-graphite (Graphite build).
 ios_frameworks = framework_names.map { |f| "libs/ios/#{f}.xcframework" }
 osx_frameworks = framework_names.map { |f| "libs/macos/#{f}.xcframework" }
-# tvOS frameworks - check if libs/tvos/ exists (populated by postinstall before pod install runs)
+# tvOS frameworks - check if libs/tvos/ exists (only populated for the default build)
 tvos_frameworks = if use_graphite || !Dir.exist?(File.join(__dir__, 'libs', 'tvos'))
   []
 else
@@ -65,7 +117,7 @@ Pod::Spec.new do |s|
     'GCC_PREPROCESSOR_DEFINITIONS' => preprocessor_defs,
     'CLANG_CXX_LANGUAGE_STANDARD' => 'c++17',
     'DEFINES_MODULE' => 'YES',
-    "HEADER_SEARCH_PATHS" => '"$(PODS_TARGET_SRCROOT)/cpp/"/** "$(PODS_TARGET_SRCROOT)/cpp" "$(PODS_TARGET_SRCROOT)/cpp/skia" "$(PODS_TARGET_SRCROOT)/cpp/jsi2" "$(PODS_TARGET_SRCROOT)/cpp/rnwgpu" "$(PODS_TARGET_SRCROOT)/cpp/rnwgpu/api" "$(PODS_TARGET_SRCROOT)/cpp/rnwgpu/api/descriptors" "$(PODS_TARGET_SRCROOT)/cpp/rnwgpu/async" "$(PODS_TARGET_SRCROOT)/cpp/dawn/include"'
+    "HEADER_SEARCH_PATHS" => '"$(PODS_TARGET_SRCROOT)/cpp"/** "$(PODS_TARGET_SRCROOT)/cpp" "$(PODS_TARGET_SRCROOT)/cpp/skia" "$(PODS_TARGET_SRCROOT)/cpp/dawn/include"'
   }
 
   s.frameworks = ['MetalKit', 'AVFoundation', 'AVKit', 'CoreMedia']

package/src/skia/types/NativeBuffer/NativeBufferFactory.ts

@@ -40,7 +40,16 @@ export interface NativeBufferFactory {
    */
   MakeFromImage: (image: SkImage) => NativeBuffer;
   /**
-   * Release a native buffer that was created with `MakeFromImage`.
+   * Create a native buffer of the given size filled with a procedural test
+   * pattern (RGB gradient + diagonal stripes), entirely on the CPU. Useful for
+   * examples and tests that need a buffer to feed into
+   * `GPUDevice.importExternalTexture` without a camera/video source. Release it
+   * with `Release`.
+   */
+  MakeTestBuffer: (width: number, height: number) => NativeBuffer;
+  /**
+   * Release a native buffer that was created with `MakeFromImage` or
+   * `MakeTestBuffer`.
    */
   Release: (nativeBuffer: NativeBuffer) => void;
 }

package/src/skia/types/WebGPU.ts

@@ -0,0 +1,108 @@
+import type { NativeBuffer } from "./NativeBuffer";
+
+// Skia's Graphite/Dawn backend extends the standard WebGPU API (typed by
+// @webgpu/types) with a few Skia- and Dawn-specific entry points. These are
+// only available on native (SK_GRAPHITE) builds, reachable through
+// `Skia.getDevice()`.
+//
+// The exported interfaces below describe the descriptors and objects those
+// entry points use; the `declare global` block augments the standard WebGPU
+// interfaces so the new methods are typed without casting to `any`.
+
+/**
+ * Descriptor for {@link GPUDevice.importExternalTexture} when the source is a
+ * Skia NativeBuffer (Skia has no WebCodecs `VideoFrame`).
+ *
+ * `source` is the handle returned by `Skia.NativeBuffer.MakeFromImage`: a
+ * `CVPixelBufferRef` on Apple, an `AHardwareBuffer*` on Android. The caller
+ * owns its lifetime (release it with `Skia.NativeBuffer.Release`) and must keep
+ * it alive until the imported texture is destroyed.
+ */
+export interface SkiaGPUExternalTextureDescriptor extends GPUObjectDescriptorBase {
+  source: NativeBuffer;
+  /** Rotation applied while sampling, in degrees. One of 0 | 90 | 180 | 270. */
+  rotation?: number;
+  /** Mirror horizontally while sampling. */
+  mirrored?: boolean;
+}
+
+/**
+ * Descriptor for {@link GPUDevice.importSharedTextureMemory}. `handle` is the
+ * NativeBuffer returned by `Skia.NativeBuffer.MakeFromImage` (see
+ * {@link SkiaGPUExternalTextureDescriptor} for the platform-specific types and
+ * lifetime rules).
+ */
+export interface GPUSharedTextureMemoryDescriptor extends GPUObjectDescriptorBase {
+  handle: NativeBuffer;
+}
+
+/**
+ * Shared texture memory imported from a platform native buffer via
+ * {@link GPUDevice.importSharedTextureMemory}. Create a texture that aliases
+ * the memory, then bracket the GPU work that touches it with
+ * {@link GPUSharedTextureMemory.beginAccess} / {@link GPUSharedTextureMemory.endAccess}.
+ */
+export interface GPUSharedTextureMemory extends GPUObjectBase {
+  /** Create a texture that aliases the shared memory. */
+  createTexture(descriptor?: GPUTextureDescriptor): GPUTexture;
+  /**
+   * Acquire the memory for GPU access. `initialized` marks whether the existing
+   * contents should be preserved (pass `true` for an already-rendered frame).
+   * Returns `false` if access could not be acquired.
+   */
+  beginAccess(texture: GPUTexture, initialized: boolean): boolean;
+  /**
+   * Release the memory after the GPU work that accessed it has been submitted.
+   * Returns `false` on failure.
+   */
+  endAccess(texture: GPUTexture): boolean;
+}
+
+/**
+ * Dawn-specific toggles, passed via {@link GPUDeviceDescriptor.dawnToggles} to
+ * `adapter.requestDevice`. This is a non-spec, Dawn-only extension; see Dawn's
+ * toggle list for valid names.
+ */
+export interface GPUDawnTogglesDescriptor {
+  enabledToggles?: string[];
+  disabledToggles?: string[];
+}
+
+declare global {
+  interface GPUDeviceDescriptor {
+    /** Dawn-specific toggles (Skia/Graphite extension, non-spec). */
+    dawnToggles?: GPUDawnTogglesDescriptor;
+  }
+
+  interface GPUExternalTexture {
+    /**
+     * Skia extension: end the imported buffer's shared-memory access window and
+     * release the underlying resources. Call right after the `queue.submit()`
+     * that sampled this texture (never before). Idempotent, and also runs at
+     * garbage collection as a fallback.
+     */
+    destroy(): void;
+  }
+
+  interface GPUDevice {
+    /**
+     * Skia extension: import a NativeBuffer (from
+     * `Skia.NativeBuffer.MakeFromImage`) as a {@link GPUExternalTexture}, sampled
+     * with `texture_external` in WGSL. The returned texture owns the
+     * shared-memory access window; call `destroy()` on it after the sampling
+     * `queue.submit()`.
+     */
+    importExternalTexture(
+      descriptor: SkiaGPUExternalTextureDescriptor
+    ): GPUExternalTexture;
+    /**
+     * Skia extension: import a NativeBuffer (from
+     * `Skia.NativeBuffer.MakeFromImage`) as {@link GPUSharedTextureMemory}, the
+     * lower-level path that lets you create an aliasing texture and manage the
+     * begin/end access window yourself.
+     */
+    importSharedTextureMemory(
+      descriptor: GPUSharedTextureMemoryDescriptor
+    ): GPUSharedTextureMemory;
+  }
+}

package/src/skia/types/index.ts

@@ -30,6 +30,7 @@ export * from "./Size";
 export * from "./Paragraph";
 export * from "./Matrix4";
 export * from "./NativeBuffer";
+export * from "./WebGPU";
 export * from "./Recorder";
 export * from "./Video";
 export * from "./Skottie";

package/src/skia/web/JsiSkNativeBufferFactory.ts

@@ -25,6 +25,26 @@ export class JsiSkNativeBufferFactory
     return canvas;
   }
 
+  MakeTestBuffer(width: number, height: number): NativeBuffer {
+    const pixels = new Uint8ClampedArray(width * height * 4);
+    for (let y = 0; y < height; y++) {
+      for (let x = 0; x < width; x++) {
+        const i = (y * width + x) * 4;
+        pixels[i + 0] = Math.floor((x * 255) / Math.max(width - 1, 1));
+        pixels[i + 1] = Math.floor((y * 255) / Math.max(height - 1, 1));
+        pixels[i + 2] = (x + y) & 0x20 ? 220 : 30;
+        pixels[i + 3] = 0xff;
+      }
+    }
+    const canvas = new OffscreenCanvas(width, height);
+    const ctx = canvas.getContext("2d");
+    if (!ctx) {
+      throw new Error("Failed to get 2d context from canvas");
+    }
+    ctx.putImageData(new ImageData(pixels, width, height), 0, 0);
+    return canvas;
+  }
+
   Release(_nativeBuffer: NativeBuffer) {
     // it's a noop on Web
   }

package/src/skia/web/JsiSkPath.ts

@@ -447,7 +447,10 @@ export class JsiSkPath
   }
 
   simplify() {
-    warnDeprecatedPathMethod("simplify", "Use Skia.Path.Simplify(path) instead.");
+    warnDeprecatedPathMethod(
+      "simplify",
+      "Use Skia.Path.Simplify(path) instead."
+    );
     const path = this.asPath();
     const result = path.makeSimplified();
     path.delete();
@@ -500,7 +503,10 @@ export class JsiSkPath
   }
 
   stroke(opts?: StrokeOpts) {
-    warnDeprecatedPathMethod("stroke", "Use Skia.Path.Stroke(path, opts) instead.");
+    warnDeprecatedPathMethod(
+      "stroke",
+      "Use Skia.Path.Stroke(path, opts) instead."
+    );
     const path = this.asPath();
     const result = path.makeStroked(
       opts === undefined

package/scripts/install-libs.js

@@ -1,133 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-
-const path = require("path");
-const fs = require("fs");
-
-const useGraphite =
-  process.env.SK_GRAPHITE === "1" ||
-  (process.env.SK_GRAPHITE || "").toLowerCase() === "true";
-const prefix = useGraphite ? "react-native-skia-graphite" : "react-native-skia";
-const libsDir = path.join(__dirname, "..", "libs");
-
-function copySync(src, dest, options) {
-  if (!src.includes("*")) {
-    return fs.cpSync(src, dest, options);
-  }
-
-  const wildcardSplit = src.split("*");
-  const basePath = wildcardSplit[0];
-  const files = fs.readdirSync(basePath);
-  files
-    .filter((file) => file.endsWith(wildcardSplit[1]))
-    .forEach((file) => {
-      return fs.cpSync(
-        path.join(basePath, file),
-        path.join(dest, file),
-        options
-      );
-    });
-}
-
-// --- Apple platforms ---
-
-let iosPackage, macosPackage;
-try {
-  iosPackage = path.dirname(
-    require.resolve(prefix + "-apple-ios/package.json")
-  );
-  macosPackage = path.dirname(
-    require.resolve(prefix + "-apple-macos/package.json")
-  );
-} catch (e) {
-  console.error(
-    "ERROR: Could not find " +
-      prefix +
-      "-apple-ios or " +
-      prefix +
-      "-apple-macos"
-  );
-  console.error("Make sure you have run yarn install or npm install");
-  process.exit(1);
-}
-
-// Verify xcframeworks exist in the iOS package
-const iosXcf = path.join(iosPackage, "libs");
-if (
-  !fs.existsSync(iosXcf) ||
-  !fs.readdirSync(iosXcf).some((f) => f.endsWith(".xcframework"))
-) {
-  console.error(
-    "ERROR: Skia prebuilt binaries not found in " + prefix + "-apple-ios!"
-  );
-  process.exit(1);
-}
-
-console.log("-- Skia iOS package: " + iosPackage);
-console.log("-- Skia macOS package: " + macosPackage);
-
-// Clean and copy Apple frameworks
-fs.rmSync(path.join(libsDir, "ios"), { recursive: true, force: true });
-fs.rmSync(path.join(libsDir, "macos"), { recursive: true, force: true });
-fs.rmSync(path.join(libsDir, "tvos"), { recursive: true, force: true });
-fs.mkdirSync(path.join(libsDir, "ios"), { recursive: true });
-fs.mkdirSync(path.join(libsDir, "macos"), { recursive: true });
-
-copySync(iosPackage + "/libs/*.xcframework", path.join(libsDir, "ios"), {
-  recursive: true,
-});
-copySync(macosPackage + "/libs/*.xcframework", path.join(libsDir, "macos"), {
-  recursive: true,
-});
-
-// Handle tvOS (non-Graphite only)
-if (!useGraphite) {
-  try {
-    const tvosPackage = path.dirname(
-      require.resolve(prefix + "-apple-tvos/package.json")
-    );
-    console.log("-- Skia tvOS package: " + tvosPackage);
-    fs.mkdirSync(path.join(libsDir, "tvos"), { recursive: true });
-    copySync(tvosPackage + "/libs/*.xcframework", path.join(libsDir, "tvos"), {
-      recursive: true,
-    });
-  } catch (e) {
-    console.log("-- tvOS package not found, skipping");
-  }
-}
-
-console.log("-- Copied Apple xcframeworks to libs/");
-
-// --- Android ---
-
-const androidPackageName = useGraphite
-  ? "react-native-skia-graphite-android"
-  : "react-native-skia-android";
-
-let androidPackage;
-try {
-  androidPackage = path.dirname(
-    require.resolve(androidPackageName + "/package.json")
-  );
-} catch (e) {
-  console.error("ERROR: Could not find " + androidPackageName);
-  console.error("Make sure you have run yarn install or npm install");
-  process.exit(1);
-}
-
-const androidSrcLibs = path.join(androidPackage, "libs");
-if (!fs.existsSync(androidSrcLibs)) {
-  console.error(
-    "ERROR: Skia prebuilt binaries not found in " + androidPackageName + "!"
-  );
-  process.exit(1);
-}
-
-console.log("-- Skia Android package: " + androidPackage);
-
-// Copy Android libs (per-ABI static libraries)
-const androidDest = path.join(libsDir, "android");
-fs.rmSync(androidDest, { recursive: true, force: true });
-copySync(androidSrcLibs, androidDest, { recursive: true });
-
-console.log("-- Copied Android libs to libs/android/");