@shopify/react-native-skia 2.9.1 → 2.10.0

package/cpp/rnwgpu/api/descriptors/Unions.h

@@ -2,7 +2,7 @@
 
 #include <string>
 
-#include "jsi2/EnumMapper.h"
+#include "jsi/EnumMapper.h"
 #include "rnwgpu/api/External.h"
 #include "webgpu/webgpu_cpp.h"
 

package/cpp/rnwgpu/async/AsyncTaskHandle.cpp

@@ -6,7 +6,7 @@
 
 #include <ReactCommon/CallInvoker.h>
 
-#include "jsi2/Promise.h"
+#include "jsi/Promise.h"
 
 #include "RuntimeContext.h"
 
@@ -96,11 +96,11 @@ void AsyncTaskHandle::State::schedule(Action action) {
   auto self = shared_from_this();
 
   if (!keepPumping) {
-    // Spontaneous task (e.g. device.lost): not driven by the ProcessEvents pump.
-    // Settle on the owning runtime's JS thread via its CallInvoker, which is
-    // wired only for the main JS runtime. A device created on a worklet runtime
-    // has no invoker, so its device.lost is dropped (best-effort; see the
-    // Threading model). invokeAsync runs the closure on the main JS thread,
+    // Spontaneous task (e.g. device.lost): not driven by the ProcessEvents
+    // pump. Settle on the owning runtime's JS thread via its CallInvoker, which
+    // is wired only for the main JS runtime. A device created on a worklet
+    // runtime has no invoker, so its device.lost is dropped (best-effort; see
+    // the Threading model). invokeAsync runs the closure on the main JS thread,
     // where promiseRef->runtime lives for a main-runtime device.
     auto invoker = context->callInvoker();
     if (invoker) {
@@ -119,21 +119,20 @@ void AsyncTaskHandle::State::schedule(Action action) {
 
   // Pumping task (request/response op). The resolve/reject callback may fire on
   // a thread that is NOT the owning runtime's thread: with a shared
-  // wgpu::Instance, another runtime's ProcessEvents() pump can consume this Dawn
-  // event. Touching the Promise's runtime off-thread would corrupt Hermes. So we
-  // deposit the actual settle (the only JSI-touching work) into the owning
-  // context's mailbox; the context drains it on its own thread during its next
-  // tick. The deposited closure captures only C++ state and runs no JSI until
-  // drained, so depositing from any thread is safe.
-  context->postSettle(
-      [self, action = std::move(action), promiseRef]() mutable {
-        action(promiseRef->runtime, *promiseRef);
-        if (self->context) {
-          self->context->onTaskSettled(/*keepPumping=*/true);
-        }
-        std::lock_guard<std::mutex> lock(self->mutex);
-        self->keepAlive.reset();
-      });
+  // wgpu::Instance, another runtime's ProcessEvents() pump can consume this
+  // Dawn event. Touching the Promise's runtime off-thread would corrupt Hermes.
+  // So we deposit the actual settle (the only JSI-touching work) into the
+  // owning context's mailbox; the context drains it on its own thread during
+  // its next tick. The deposited closure captures only C++ state and runs no
+  // JSI until drained, so depositing from any thread is safe.
+  context->postSettle([self, action = std::move(action), promiseRef]() mutable {
+    action(promiseRef->runtime, *promiseRef);
+    if (self->context) {
+      self->context->onTaskSettled(/*keepPumping=*/true);
+    }
+    std::lock_guard<std::mutex> lock(self->mutex);
+    self->keepAlive.reset();
+  });
 }
 
 AsyncTaskHandle::ResolveFunction

package/lib/commonjs/external/reanimated/renderHelpers.d.ts

@@ -1 +1,16 @@
 export declare let HAS_REANIMATED_3: boolean;
+/**
+ * True when the worklets-based Reanimated integration is available
+ * (Reanimated 4 with react-native-worklets providing
+ * registerCustomSerializable). Skia objects use the JSI NativeState pattern
+ * and can only be transferred to worklet runtimes through a custom
+ * serializer, so on native the Reanimated integration requires Reanimated 4 —
+ * Reanimated 3 is not supported.
+ */
+export declare let HAS_REANIMATED_4: boolean;
+/**
+ * Major version of the installed react-native-reanimated package, or null if
+ * it is not installed. Used to give actionable diagnostics when the
+ * integration cannot be enabled.
+ */
+export declare let REANIMATED_VERSION_MAJOR: number | null;

package/lib/commonjs/external/reanimated/renderHelpers.js

@@ -3,8 +3,25 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.HAS_REANIMATED_3 = void 0;
+exports.REANIMATED_VERSION_MAJOR = exports.HAS_REANIMATED_4 = exports.HAS_REANIMATED_3 = void 0;
 let HAS_REANIMATED_3 = exports.HAS_REANIMATED_3 = false;
+
+/**
+ * True when the worklets-based Reanimated integration is available
+ * (Reanimated 4 with react-native-worklets providing
+ * registerCustomSerializable). Skia objects use the JSI NativeState pattern
+ * and can only be transferred to worklet runtimes through a custom
+ * serializer, so on native the Reanimated integration requires Reanimated 4 —
+ * Reanimated 3 is not supported.
+ */
+let HAS_REANIMATED_4 = exports.HAS_REANIMATED_4 = false;
+
+/**
+ * Major version of the installed react-native-reanimated package, or null if
+ * it is not installed. Used to give actionable diagnostics when the
+ * integration cannot be enabled.
+ */
+let REANIMATED_VERSION_MAJOR = exports.REANIMATED_VERSION_MAJOR = null;
 try {
   // This logic is convoluted but necessary
   // In most systems, `require("react-native-reanimated")` throws an error, all is well.
@@ -15,6 +32,18 @@ try {
   if (reanimatedVersion && (reanimatedVersion >= "3.0.0" || reanimatedVersion.includes("3.0.0-"))) {
     exports.HAS_REANIMATED_3 = HAS_REANIMATED_3 = true;
   }
+  const majorVersion = parseInt(reanimatedVersion.split(".")[0], 10);
+  if (!isNaN(majorVersion)) {
+    exports.REANIMATED_VERSION_MAJOR = REANIMATED_VERSION_MAJOR = majorVersion;
+  }
+  if (majorVersion >= 4) {
+    try {
+      const worklets = require("react-native-worklets");
+      exports.HAS_REANIMATED_4 = HAS_REANIMATED_4 = typeof worklets.registerCustomSerializable === "function";
+    } catch (e) {
+      // react-native-worklets not installed
+    }
+  }
 } catch (e) {
   // do nothing
 }

package/lib/commonjs/external/reanimated/renderHelpers.js.map

@@ -1 +1 @@
-{"version":3,"names":["HAS_REANIMATED_3","exports","reanimatedVersion","require","version","includes","e"],"sources":["renderHelpers.ts"],"sourcesContent":["export let HAS_REANIMATED_3 = false;\n\ntry {\n  // This logic is convoluted but necessary\n  // In most systems, `require(\"react-native-reanimated\")` throws an error, all is well.\n  // In webpack, in some configuration it will return an empty object.\n  // So it will not throw an error and we need to check the version to know if it's there.\n  const reanimatedVersion =\n    require(\"react-native-reanimated/package.json\").version;\n  require(\"react-native-reanimated\");\n  if (\n    reanimatedVersion &&\n    (reanimatedVersion >= \"3.0.0\" || reanimatedVersion.includes(\"3.0.0-\"))\n  ) {\n    HAS_REANIMATED_3 = true;\n  }\n} catch (e) {\n  // do nothing\n}\n"],"mappings":";;;;;;AAAO,IAAIA,gBAAgB,GAAAC,OAAA,CAAAD,gBAAA,GAAG,KAAK;AAEnC,IAAI;EACF;EACA;EACA;EACA;EACA,MAAME,iBAAiB,GACrBC,OAAO,CAAC,sCAAsC,CAAC,CAACC,OAAO;EACzDD,OAAO,CAAC,yBAAyB,CAAC;EAClC,IACED,iBAAiB,KAChBA,iBAAiB,IAAI,OAAO,IAAIA,iBAAiB,CAACG,QAAQ,CAAC,QAAQ,CAAC,CAAC,EACtE;IACAJ,OAAA,CAAAD,gBAAA,GAAAA,gBAAgB,GAAG,IAAI;EACzB;AACF,CAAC,CAAC,OAAOM,CAAC,EAAE;EACV;AAAA","ignoreList":[]}
+{"version":3,"names":["HAS_REANIMATED_3","exports","HAS_REANIMATED_4","REANIMATED_VERSION_MAJOR","reanimatedVersion","require","version","includes","majorVersion","parseInt","split","isNaN","worklets","registerCustomSerializable","e"],"sources":["renderHelpers.ts"],"sourcesContent":["export let HAS_REANIMATED_3 = false;\n\n/**\n * True when the worklets-based Reanimated integration is available\n * (Reanimated 4 with react-native-worklets providing\n * registerCustomSerializable). Skia objects use the JSI NativeState pattern\n * and can only be transferred to worklet runtimes through a custom\n * serializer, so on native the Reanimated integration requires Reanimated 4 —\n * Reanimated 3 is not supported.\n */\nexport let HAS_REANIMATED_4 = false;\n\n/**\n * Major version of the installed react-native-reanimated package, or null if\n * it is not installed. Used to give actionable diagnostics when the\n * integration cannot be enabled.\n */\nexport let REANIMATED_VERSION_MAJOR: number | null = null;\n\ntry {\n  // This logic is convoluted but necessary\n  // In most systems, `require(\"react-native-reanimated\")` throws an error, all is well.\n  // In webpack, in some configuration it will return an empty object.\n  // So it will not throw an error and we need to check the version to know if it's there.\n  const reanimatedVersion =\n    require(\"react-native-reanimated/package.json\").version;\n  require(\"react-native-reanimated\");\n  if (\n    reanimatedVersion &&\n    (reanimatedVersion >= \"3.0.0\" || reanimatedVersion.includes(\"3.0.0-\"))\n  ) {\n    HAS_REANIMATED_3 = true;\n  }\n  const majorVersion = parseInt(reanimatedVersion.split(\".\")[0], 10);\n  if (!isNaN(majorVersion)) {\n    REANIMATED_VERSION_MAJOR = majorVersion;\n  }\n  if (majorVersion >= 4) {\n    try {\n      const worklets = require(\"react-native-worklets\");\n      HAS_REANIMATED_4 =\n        typeof worklets.registerCustomSerializable === \"function\";\n    } catch (e) {\n      // react-native-worklets not installed\n    }\n  }\n} catch (e) {\n  // do nothing\n}\n"],"mappings":";;;;;;AAAO,IAAIA,gBAAgB,GAAAC,OAAA,CAAAD,gBAAA,GAAG,KAAK;;AAEnC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,IAAIE,gBAAgB,GAAAD,OAAA,CAAAC,gBAAA,GAAG,KAAK;;AAEnC;AACA;AACA;AACA;AACA;AACO,IAAIC,wBAAuC,GAAAF,OAAA,CAAAE,wBAAA,GAAG,IAAI;AAEzD,IAAI;EACF;EACA;EACA;EACA;EACA,MAAMC,iBAAiB,GACrBC,OAAO,CAAC,sCAAsC,CAAC,CAACC,OAAO;EACzDD,OAAO,CAAC,yBAAyB,CAAC;EAClC,IACED,iBAAiB,KAChBA,iBAAiB,IAAI,OAAO,IAAIA,iBAAiB,CAACG,QAAQ,CAAC,QAAQ,CAAC,CAAC,EACtE;IACAN,OAAA,CAAAD,gBAAA,GAAAA,gBAAgB,GAAG,IAAI;EACzB;EACA,MAAMQ,YAAY,GAAGC,QAAQ,CAACL,iBAAiB,CAACM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;EAClE,IAAI,CAACC,KAAK,CAACH,YAAY,CAAC,EAAE;IACxBP,OAAA,CAAAE,wBAAA,GAAAA,wBAAwB,GAAGK,YAAY;EACzC;EACA,IAAIA,YAAY,IAAI,CAAC,EAAE;IACrB,IAAI;MACF,MAAMI,QAAQ,GAAGP,OAAO,CAAC,uBAAuB,CAAC;MACjDJ,OAAA,CAAAC,gBAAA,GAAAA,gBAAgB,GACd,OAAOU,QAAQ,CAACC,0BAA0B,KAAK,UAAU;IAC7D,CAAC,CAAC,OAAOC,CAAC,EAAE;MACV;IAAA;EAEJ;AACF,CAAC,CAAC,OAAOA,CAAC,EAAE;EACV;AAAA","ignoreList":[]}

package/lib/commonjs/skia/NativeSetup.js

@@ -2,6 +2,7 @@
 
 var _Platform = require("../Platform");
 var _NativeSkiaModule = _interopRequireDefault(require("../specs/NativeSkiaModule"));
+var _SkiaWorkletSerialization = require("./SkiaWorkletSerialization");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 if (_Platform.Platform.OS !== "web" && global.SkiaApi == null) {
   // Initialize RN Skia
@@ -13,5 +14,8 @@ if (_Platform.Platform.OS !== "web" && global.SkiaApi == null) {
   if (result !== true) {
     throw new Error(`Native Skia Module failed to correctly install JSI Bindings! Result: ${result}`);
   }
+  // Skia objects use the JSI NativeState pattern and need a custom
+  // serializer to be transferable to worklet runtimes (Reanimated).
+  (0, _SkiaWorkletSerialization.registerSkiaWorkletSerialization)();
 }
 //# sourceMappingURL=NativeSetup.js.map

package/lib/commonjs/skia/NativeSetup.js.map

@@ -1 +1 @@
-{"version":3,"names":["_Platform","require","_NativeSkiaModule","_interopRequireDefault","e","__esModule","default","Platform","OS","global","SkiaApi","SkiaModule","NativeSkiaModule","install","Error","result"],"sources":["NativeSetup.ts"],"sourcesContent":["import { Platform } from \"../Platform\";\nimport NativeSkiaModule from \"../specs/NativeSkiaModule\";\n\nif (Platform.OS !== \"web\" && global.SkiaApi == null) {\n  // Initialize RN Skia\n  const SkiaModule = NativeSkiaModule;\n  if (SkiaModule == null || typeof SkiaModule.install !== \"function\") {\n    throw new Error(\n      \"Native RNSkia Module cannot be found! Make sure you correctly \" +\n        \"installed native dependencies and rebuilt your app.\"\n    );\n  }\n  const result = SkiaModule.install();\n  if (result !== true) {\n    throw new Error(\n      `Native Skia Module failed to correctly install JSI Bindings! Result: ${result}`\n    );\n  }\n}\n"],"mappings":";;AAAA,IAAAA,SAAA,GAAAC,OAAA;AACA,IAAAC,iBAAA,GAAAC,sBAAA,CAAAF,OAAA;AAAyD,SAAAE,uBAAAC,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAEzD,IAAIG,kBAAQ,CAACC,EAAE,KAAK,KAAK,IAAIC,MAAM,CAACC,OAAO,IAAI,IAAI,EAAE;EACnD;EACA,MAAMC,UAAU,GAAGC,yBAAgB;EACnC,IAAID,UAAU,IAAI,IAAI,IAAI,OAAOA,UAAU,CAACE,OAAO,KAAK,UAAU,EAAE;IAClE,MAAM,IAAIC,KAAK,CACb,gEAAgE,GAC9D,qDACJ,CAAC;EACH;EACA,MAAMC,MAAM,GAAGJ,UAAU,CAACE,OAAO,CAAC,CAAC;EACnC,IAAIE,MAAM,KAAK,IAAI,EAAE;IACnB,MAAM,IAAID,KAAK,CACb,wEAAwEC,MAAM,EAChF,CAAC;EACH;AACF","ignoreList":[]}
+{"version":3,"names":["_Platform","require","_NativeSkiaModule","_interopRequireDefault","_SkiaWorkletSerialization","e","__esModule","default","Platform","OS","global","SkiaApi","SkiaModule","NativeSkiaModule","install","Error","result","registerSkiaWorkletSerialization"],"sources":["NativeSetup.ts"],"sourcesContent":["import { Platform } from \"../Platform\";\nimport NativeSkiaModule from \"../specs/NativeSkiaModule\";\n\nimport { registerSkiaWorkletSerialization } from \"./SkiaWorkletSerialization\";\n\nif (Platform.OS !== \"web\" && global.SkiaApi == null) {\n  // Initialize RN Skia\n  const SkiaModule = NativeSkiaModule;\n  if (SkiaModule == null || typeof SkiaModule.install !== \"function\") {\n    throw new Error(\n      \"Native RNSkia Module cannot be found! Make sure you correctly \" +\n        \"installed native dependencies and rebuilt your app.\"\n    );\n  }\n  const result = SkiaModule.install();\n  if (result !== true) {\n    throw new Error(\n      `Native Skia Module failed to correctly install JSI Bindings! Result: ${result}`\n    );\n  }\n  // Skia objects use the JSI NativeState pattern and need a custom\n  // serializer to be transferable to worklet runtimes (Reanimated).\n  registerSkiaWorkletSerialization();\n}\n"],"mappings":";;AAAA,IAAAA,SAAA,GAAAC,OAAA;AACA,IAAAC,iBAAA,GAAAC,sBAAA,CAAAF,OAAA;AAEA,IAAAG,yBAAA,GAAAH,OAAA;AAA8E,SAAAE,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAE9E,IAAIG,kBAAQ,CAACC,EAAE,KAAK,KAAK,IAAIC,MAAM,CAACC,OAAO,IAAI,IAAI,EAAE;EACnD;EACA,MAAMC,UAAU,GAAGC,yBAAgB;EACnC,IAAID,UAAU,IAAI,IAAI,IAAI,OAAOA,UAAU,CAACE,OAAO,KAAK,UAAU,EAAE;IAClE,MAAM,IAAIC,KAAK,CACb,gEAAgE,GAC9D,qDACJ,CAAC;EACH;EACA,MAAMC,MAAM,GAAGJ,UAAU,CAACE,OAAO,CAAC,CAAC;EACnC,IAAIE,MAAM,KAAK,IAAI,EAAE;IACnB,MAAM,IAAID,KAAK,CACb,wEAAwEC,MAAM,EAChF,CAAC;EACH;EACA;EACA;EACA,IAAAC,0DAAgC,EAAC,CAAC;AACpC","ignoreList":[]}

package/lib/commonjs/skia/SkiaWorkletSerialization.d.ts

@@ -0,0 +1 @@
+export declare const registerSkiaWorkletSerialization: () => void;

package/lib/commonjs/skia/SkiaWorkletSerialization.js

@@ -0,0 +1,66 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.registerSkiaWorkletSerialization = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+/**
+ * Skia and WebGPU API objects are implemented with the JSI NativeState
+ * pattern: plain JS objects with a shared prototype and native state
+ * attached. Worklets cannot serialize such objects by default (the prototype
+ * would be lost when moving them to another runtime), so we register a
+ * Custom Serializable that:
+ *
+ * - determine: detects native objects via the `__box` method installed on
+ *   every Skia and WebGPU prototype (plain objects never reach the
+ *   custom-serializable path, so this cannot misfire on user data).
+ * - pack: boxes the object into a HostObject wrapper that carries the native
+ *   state and the class brand. HostObjects are transferred by reference.
+ * - unpack: unboxes on the target runtime, re-installing the class prototype
+ *   there and re-attaching the same native state.
+ *
+ * See cpp/jsi/BoxedNativeObject.h for the native side.
+ *
+ * `react-native-worklets` (Reanimated 4) is required for this to work —
+ * without it, Skia and WebGPU objects cannot be captured in worklets or
+ * stored in shared values.
+ */
+
+const determine = value => {
+  "worklet";
+
+  return typeof value.__box === "function";
+};
+const pack = value => {
+  "worklet";
+
+  return value.__box();
+};
+const unpack = packed => {
+  "worklet";
+
+  return packed.unbox();
+};
+const registerSkiaWorkletSerialization = () => {
+  try {
+    const worklets = require("react-native-worklets");
+    if (typeof worklets.registerCustomSerializable === "function") {
+      worklets.registerCustomSerializable({
+        name: "ReactNativeSkia",
+        determine,
+        pack,
+        unpack
+      });
+    } else {
+      console.error("React Native Skia requires react-native-worklets >= 0.7.0 " + "(registerCustomSerializable) to use Skia objects inside worklets. " + "Please upgrade react-native-worklets and react-native-reanimated.");
+    }
+  } catch (e) {
+    // react-native-worklets is not installed. This is fine for apps that do
+    // not use Reanimated: Skia objects simply cannot be used inside worklets
+    // or shared values in this configuration.
+  }
+};
+exports.registerSkiaWorkletSerialization = registerSkiaWorkletSerialization;
+//# sourceMappingURL=SkiaWorkletSerialization.js.map

package/lib/commonjs/skia/SkiaWorkletSerialization.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["determine","value","__box","pack","unpack","packed","unbox","registerSkiaWorkletSerialization","worklets","require","registerCustomSerializable","name","console","error","e","exports"],"sources":["SkiaWorkletSerialization.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Skia and WebGPU API objects are implemented with the JSI NativeState\n * pattern: plain JS objects with a shared prototype and native state\n * attached. Worklets cannot serialize such objects by default (the prototype\n * would be lost when moving them to another runtime), so we register a\n * Custom Serializable that:\n *\n * - determine: detects native objects via the `__box` method installed on\n *   every Skia and WebGPU prototype (plain objects never reach the\n *   custom-serializable path, so this cannot misfire on user data).\n * - pack: boxes the object into a HostObject wrapper that carries the native\n *   state and the class brand. HostObjects are transferred by reference.\n * - unpack: unboxes on the target runtime, re-installing the class prototype\n *   there and re-attaching the same native state.\n *\n * See cpp/jsi/BoxedNativeObject.h for the native side.\n *\n * `react-native-worklets` (Reanimated 4) is required for this to work —\n * without it, Skia and WebGPU objects cannot be captured in worklets or\n * stored in shared values.\n */\n\ninterface BoxedNativeObject {\n  unbox: () => object;\n  __boxedNativeObject: true;\n}\n\nconst determine = (value: object): value is object => {\n  \"worklet\";\n  return typeof (value as any).__box === \"function\";\n};\n\nconst pack = (value: object): BoxedNativeObject => {\n  \"worklet\";\n  return (value as any).__box();\n};\n\nconst unpack = (packed: BoxedNativeObject): object => {\n  \"worklet\";\n  return packed.unbox();\n};\n\nexport const registerSkiaWorkletSerialization = () => {\n  try {\n    const worklets = require(\"react-native-worklets\");\n    if (typeof worklets.registerCustomSerializable === \"function\") {\n      worklets.registerCustomSerializable({\n        name: \"ReactNativeSkia\",\n        determine,\n        pack,\n        unpack,\n      });\n    } else {\n      console.error(\n        \"React Native Skia requires react-native-worklets >= 0.7.0 \" +\n          \"(registerCustomSerializable) to use Skia objects inside worklets. \" +\n          \"Please upgrade react-native-worklets and react-native-reanimated.\"\n      );\n    }\n  } catch (e) {\n    // react-native-worklets is not installed. This is fine for apps that do\n    // not use Reanimated: Skia objects simply cannot be used inside worklets\n    // or shared values in this configuration.\n  }\n};\n"],"mappings":";;;;;;AAAA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA,MAAMA,SAAS,GAAIC,KAAa,IAAsB;EACpD,SAAS;;EACT,OAAO,OAAQA,KAAK,CAASC,KAAK,KAAK,UAAU;AACnD,CAAC;AAED,MAAMC,IAAI,GAAIF,KAAa,IAAwB;EACjD,SAAS;;EACT,OAAQA,KAAK,CAASC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAME,MAAM,GAAIC,MAAyB,IAAa;EACpD,SAAS;;EACT,OAAOA,MAAM,CAACC,KAAK,CAAC,CAAC;AACvB,CAAC;AAEM,MAAMC,gCAAgC,GAAGA,CAAA,KAAM;EACpD,IAAI;IACF,MAAMC,QAAQ,GAAGC,OAAO,CAAC,uBAAuB,CAAC;IACjD,IAAI,OAAOD,QAAQ,CAACE,0BAA0B,KAAK,UAAU,EAAE;MAC7DF,QAAQ,CAACE,0BAA0B,CAAC;QAClCC,IAAI,EAAE,iBAAiB;QACvBX,SAAS;QACTG,IAAI;QACJC;MACF,CAAC,CAAC;IACJ,CAAC,MAAM;MACLQ,OAAO,CAACC,KAAK,CACX,4DAA4D,GAC1D,oEAAoE,GACpE,mEACJ,CAAC;IACH;EACF,CAAC,CAAC,OAAOC,CAAC,EAAE;IACV;IACA;IACA;EAAA;AAEJ,CAAC;AAACC,OAAA,CAAAR,gCAAA,GAAAA,gCAAA","ignoreList":[]}

package/lib/commonjs/sksg/Container.native.js

@@ -79,10 +79,29 @@ class NativeReanimatedContainer extends _StaticContainer.Container {
     }
   }
 }
+let hasWarnedAboutReanimatedSupport = false;
+const reanimatedSupportError = () => {
+  if (_renderHelpers.REANIMATED_VERSION_MAJOR !== null && _renderHelpers.REANIMATED_VERSION_MAJOR >= 4) {
+    return "React Native Skia requires react-native-worklets >= 0.7.0 for its " + "Reanimated integration on native platforms. Reanimated 4 is " + "installed, but react-native-worklets is missing or too old. " + "Please install or upgrade react-native-worklets.";
+  }
+  return "React Native Skia requires Reanimated 4 (react-native-worklets >= " + "0.7.0) for its Reanimated integration on native platforms. " + "Reanimated 3 is not supported anymore: Skia objects cannot be used " + "inside worklets or shared values with it. " + "Please upgrade to react-native-reanimated >= 4.0.0.";
+};
 const createContainer = (Skia, nativeId) => {
-  if (_renderHelpers.HAS_REANIMATED_3 && nativeId !== -1) {
+  if (_renderHelpers.HAS_REANIMATED_4 && nativeId !== -1) {
     return new NativeReanimatedContainer(Skia, nativeId);
   } else {
+    if (_renderHelpers.HAS_REANIMATED_3 && !_renderHelpers.HAS_REANIMATED_4) {
+      const message = reanimatedSupportError();
+      if (__DEV__) {
+        // Fail loudly in development — a silent fallback to static rendering
+        // would only be noticed as frozen animations.
+        throw new Error(message);
+      }
+      if (!hasWarnedAboutReanimatedSupport) {
+        hasWarnedAboutReanimatedSupport = true;
+        console.error(`${message} Falling back to static rendering (animations will not run).`);
+      }
+    }
     return new _StaticContainer.StaticContainer(Skia, nativeId);
   }
 };

package/lib/commonjs/sksg/Container.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["_ReanimatedProxy","_interopRequireDefault","require","_renderHelpers","_ReanimatedRecorder","_StaticContainer","_Visitor","e","__esModule","default","_defineProperty","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","SkiaViewApi","globalThis","nativeDrawOnscreen","nativeId","recorder","picture","play","setJsiProperty","NativeReanimatedContainer","Container","constructor","Skia","Picture","MakePicture","unmount","mapperId","Rea","stopMapper","redraw","unmounted","ReanimatedRecorder","visit","root","sharedValues","getSharedValues","sharedRecorder","getRecorder","runOnUI","length","startMapper","applyUpdates","createContainer","HAS_REANIMATED_3","StaticContainer","exports"],"sources":["Container.native.ts"],"sourcesContent":["import Rea from \"../external/reanimated/ReanimatedProxy\";\nimport type { Skia, SkPicture } from \"../skia/types\";\nimport { HAS_REANIMATED_3 } from \"../external/reanimated/renderHelpers\";\nimport type { JsiRecorder } from \"../skia/types/Recorder\";\n\nimport { ReanimatedRecorder } from \"./Recorder/ReanimatedRecorder\";\nimport { Container, StaticContainer } from \"./StaticContainer\";\nimport { visit } from \"./Recorder/Visitor\";\n\nimport \"../skia/NativeSetup\";\nimport \"../views/api\";\n\n// create local reference for `strictGlobal` option in Worklets\nconst { SkiaViewApi } = globalThis;\n\nconst nativeDrawOnscreen = (\n  nativeId: number,\n  recorder: JsiRecorder,\n  picture: SkPicture\n) => {\n  \"worklet\";\n\n  //const start = performance.now();\n  recorder.play(picture);\n  //const end = performance.now();\n  //console.log(\"Recording time: \", end - start);\n  SkiaViewApi.setJsiProperty(nativeId, \"picture\", picture);\n};\n\nclass NativeReanimatedContainer extends Container {\n  private mapperId: number | null = null;\n  private picture: SkPicture;\n\n  constructor(\n    Skia: Skia,\n    private nativeId: number\n  ) {\n    super(Skia);\n    this.picture = Skia.Picture.MakePicture(null)!;\n  }\n\n  unmount() {\n    super.unmount();\n    if (this.mapperId !== null) {\n      // The mapper closure retains the recorder and its resources (e.g.\n      // images) on the UI runtime and keeps updating the picture of an\n      // unmounted view — stop it or it leaks for the lifetime of the app.\n      Rea.stopMapper(this.mapperId);\n      this.mapperId = null;\n    }\n  }\n\n  redraw() {\n    if (this.mapperId !== null) {\n      Rea.stopMapper(this.mapperId);\n      this.mapperId = null;\n    }\n    if (this.unmounted) {\n      return;\n    }\n    const recorder = new ReanimatedRecorder(this.Skia);\n    const { nativeId, picture } = this;\n    visit(recorder, this.root);\n    const sharedValues = recorder.getSharedValues();\n    const sharedRecorder = recorder.getRecorder();\n    // Draw first frame\n    Rea.runOnUI(() => {\n      \"worklet\";\n      nativeDrawOnscreen(nativeId, sharedRecorder, picture);\n    })();\n    // Animate\n    if (sharedValues.length > 0) {\n      this.mapperId = Rea.startMapper(() => {\n        \"worklet\";\n        sharedRecorder.applyUpdates(sharedValues);\n        nativeDrawOnscreen(nativeId, sharedRecorder, picture);\n      }, sharedValues);\n    }\n  }\n}\n\nexport const createContainer = (Skia: Skia, nativeId: number) => {\n  if (HAS_REANIMATED_3 && nativeId !== -1) {\n    return new NativeReanimatedContainer(Skia, nativeId);\n  } else {\n    return new StaticContainer(Skia, nativeId);\n  }\n};\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_ReanimatedProxy","_interopRequireDefault","require","_renderHelpers","_ReanimatedRecorder","_StaticContainer","_Visitor","e","__esModule","default","_defineProperty","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","SkiaViewApi","globalThis","nativeDrawOnscreen","nativeId","recorder","picture","play","setJsiProperty","NativeReanimatedContainer","Container","constructor","Skia","Picture","MakePicture","unmount","mapperId","Rea","stopMapper","redraw","unmounted","ReanimatedRecorder","visit","root","sharedValues","getSharedValues","sharedRecorder","getRecorder","runOnUI","length","startMapper","applyUpdates","hasWarnedAboutReanimatedSupport","reanimatedSupportError","REANIMATED_VERSION_MAJOR","createContainer","HAS_REANIMATED_4","HAS_REANIMATED_3","message","__DEV__","Error","console","error","StaticContainer","exports"],"sources":["Container.native.ts"],"sourcesContent":["import Rea from \"../external/reanimated/ReanimatedProxy\";\nimport type { Skia, SkPicture } from \"../skia/types\";\nimport {\n  HAS_REANIMATED_3,\n  HAS_REANIMATED_4,\n  REANIMATED_VERSION_MAJOR,\n} from \"../external/reanimated/renderHelpers\";\nimport type { JsiRecorder } from \"../skia/types/Recorder\";\n\nimport { ReanimatedRecorder } from \"./Recorder/ReanimatedRecorder\";\nimport { Container, StaticContainer } from \"./StaticContainer\";\nimport { visit } from \"./Recorder/Visitor\";\n\nimport \"../skia/NativeSetup\";\nimport \"../views/api\";\n\n// create local reference for `strictGlobal` option in Worklets\nconst { SkiaViewApi } = globalThis;\n\nconst nativeDrawOnscreen = (\n  nativeId: number,\n  recorder: JsiRecorder,\n  picture: SkPicture\n) => {\n  \"worklet\";\n\n  //const start = performance.now();\n  recorder.play(picture);\n  //const end = performance.now();\n  //console.log(\"Recording time: \", end - start);\n  SkiaViewApi.setJsiProperty(nativeId, \"picture\", picture);\n};\n\nclass NativeReanimatedContainer extends Container {\n  private mapperId: number | null = null;\n  private picture: SkPicture;\n\n  constructor(\n    Skia: Skia,\n    private nativeId: number\n  ) {\n    super(Skia);\n    this.picture = Skia.Picture.MakePicture(null)!;\n  }\n\n  unmount() {\n    super.unmount();\n    if (this.mapperId !== null) {\n      // The mapper closure retains the recorder and its resources (e.g.\n      // images) on the UI runtime and keeps updating the picture of an\n      // unmounted view — stop it or it leaks for the lifetime of the app.\n      Rea.stopMapper(this.mapperId);\n      this.mapperId = null;\n    }\n  }\n\n  redraw() {\n    if (this.mapperId !== null) {\n      Rea.stopMapper(this.mapperId);\n      this.mapperId = null;\n    }\n    if (this.unmounted) {\n      return;\n    }\n    const recorder = new ReanimatedRecorder(this.Skia);\n    const { nativeId, picture } = this;\n    visit(recorder, this.root);\n    const sharedValues = recorder.getSharedValues();\n    const sharedRecorder = recorder.getRecorder();\n    // Draw first frame\n    Rea.runOnUI(() => {\n      \"worklet\";\n      nativeDrawOnscreen(nativeId, sharedRecorder, picture);\n    })();\n    // Animate\n    if (sharedValues.length > 0) {\n      this.mapperId = Rea.startMapper(() => {\n        \"worklet\";\n        sharedRecorder.applyUpdates(sharedValues);\n        nativeDrawOnscreen(nativeId, sharedRecorder, picture);\n      }, sharedValues);\n    }\n  }\n}\n\nlet hasWarnedAboutReanimatedSupport = false;\n\nconst reanimatedSupportError = () => {\n  if (REANIMATED_VERSION_MAJOR !== null && REANIMATED_VERSION_MAJOR >= 4) {\n    return (\n      \"React Native Skia requires react-native-worklets >= 0.7.0 for its \" +\n      \"Reanimated integration on native platforms. Reanimated 4 is \" +\n      \"installed, but react-native-worklets is missing or too old. \" +\n      \"Please install or upgrade react-native-worklets.\"\n    );\n  }\n  return (\n    \"React Native Skia requires Reanimated 4 (react-native-worklets >= \" +\n    \"0.7.0) for its Reanimated integration on native platforms. \" +\n    \"Reanimated 3 is not supported anymore: Skia objects cannot be used \" +\n    \"inside worklets or shared values with it. \" +\n    \"Please upgrade to react-native-reanimated >= 4.0.0.\"\n  );\n};\n\nexport const createContainer = (Skia: Skia, nativeId: number) => {\n  if (HAS_REANIMATED_4 && nativeId !== -1) {\n    return new NativeReanimatedContainer(Skia, nativeId);\n  } else {\n    if (HAS_REANIMATED_3 && !HAS_REANIMATED_4) {\n      const message = reanimatedSupportError();\n      if (__DEV__) {\n        // Fail loudly in development — a silent fallback to static rendering\n        // would only be noticed as frozen animations.\n        throw new Error(message);\n      }\n      if (!hasWarnedAboutReanimatedSupport) {\n        hasWarnedAboutReanimatedSupport = true;\n        console.error(\n          `${message} Falling back to static rendering (animations will not run).`\n        );\n      }\n    }\n    return new StaticContainer(Skia, nativeId);\n  }\n};\n"],"mappings":"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","ignoreList":[]}

package/lib/module/external/reanimated/renderHelpers.d.ts

@@ -1 +1,16 @@
 export declare let HAS_REANIMATED_3: boolean;
+/**
+ * True when the worklets-based Reanimated integration is available
+ * (Reanimated 4 with react-native-worklets providing
+ * registerCustomSerializable). Skia objects use the JSI NativeState pattern
+ * and can only be transferred to worklet runtimes through a custom
+ * serializer, so on native the Reanimated integration requires Reanimated 4 —
+ * Reanimated 3 is not supported.
+ */
+export declare let HAS_REANIMATED_4: boolean;
+/**
+ * Major version of the installed react-native-reanimated package, or null if
+ * it is not installed. Used to give actionable diagnostics when the
+ * integration cannot be enabled.
+ */
+export declare let REANIMATED_VERSION_MAJOR: number | null;

package/lib/module/external/reanimated/renderHelpers.js

@@ -1,4 +1,21 @@
 export let HAS_REANIMATED_3 = false;
+
+/**
+ * True when the worklets-based Reanimated integration is available
+ * (Reanimated 4 with react-native-worklets providing
+ * registerCustomSerializable). Skia objects use the JSI NativeState pattern
+ * and can only be transferred to worklet runtimes through a custom
+ * serializer, so on native the Reanimated integration requires Reanimated 4 —
+ * Reanimated 3 is not supported.
+ */
+export let HAS_REANIMATED_4 = false;
+
+/**
+ * Major version of the installed react-native-reanimated package, or null if
+ * it is not installed. Used to give actionable diagnostics when the
+ * integration cannot be enabled.
+ */
+export let REANIMATED_VERSION_MAJOR = null;
 try {
   // This logic is convoluted but necessary
   // In most systems, `require("react-native-reanimated")` throws an error, all is well.
@@ -9,6 +26,18 @@ try {
   if (reanimatedVersion && (reanimatedVersion >= "3.0.0" || reanimatedVersion.includes("3.0.0-"))) {
     HAS_REANIMATED_3 = true;
   }
+  const majorVersion = parseInt(reanimatedVersion.split(".")[0], 10);
+  if (!isNaN(majorVersion)) {
+    REANIMATED_VERSION_MAJOR = majorVersion;
+  }
+  if (majorVersion >= 4) {
+    try {
+      const worklets = require("react-native-worklets");
+      HAS_REANIMATED_4 = typeof worklets.registerCustomSerializable === "function";
+    } catch (e) {
+      // react-native-worklets not installed
+    }
+  }
 } catch (e) {
   // do nothing
 }

package/lib/module/external/reanimated/renderHelpers.js.map

@@ -1 +1 @@
-{"version":3,"names":["HAS_REANIMATED_3","reanimatedVersion","require","version","includes","e"],"sources":["renderHelpers.ts"],"sourcesContent":["export let HAS_REANIMATED_3 = false;\n\ntry {\n  // This logic is convoluted but necessary\n  // In most systems, `require(\"react-native-reanimated\")` throws an error, all is well.\n  // In webpack, in some configuration it will return an empty object.\n  // So it will not throw an error and we need to check the version to know if it's there.\n  const reanimatedVersion =\n    require(\"react-native-reanimated/package.json\").version;\n  require(\"react-native-reanimated\");\n  if (\n    reanimatedVersion &&\n    (reanimatedVersion >= \"3.0.0\" || reanimatedVersion.includes(\"3.0.0-\"))\n  ) {\n    HAS_REANIMATED_3 = true;\n  }\n} catch (e) {\n  // do nothing\n}\n"],"mappings":"AAAA,OAAO,IAAIA,gBAAgB,GAAG,KAAK;AAEnC,IAAI;EACF;EACA;EACA;EACA;EACA,MAAMC,iBAAiB,GACrBC,OAAO,CAAC,sCAAsC,CAAC,CAACC,OAAO;EACzDD,OAAO,CAAC,yBAAyB,CAAC;EAClC,IACED,iBAAiB,KAChBA,iBAAiB,IAAI,OAAO,IAAIA,iBAAiB,CAACG,QAAQ,CAAC,QAAQ,CAAC,CAAC,EACtE;IACAJ,gBAAgB,GAAG,IAAI;EACzB;AACF,CAAC,CAAC,OAAOK,CAAC,EAAE;EACV;AAAA","ignoreList":[]}
+{"version":3,"names":["HAS_REANIMATED_3","HAS_REANIMATED_4","REANIMATED_VERSION_MAJOR","reanimatedVersion","require","version","includes","majorVersion","parseInt","split","isNaN","worklets","registerCustomSerializable","e"],"sources":["renderHelpers.ts"],"sourcesContent":["export let HAS_REANIMATED_3 = false;\n\n/**\n * True when the worklets-based Reanimated integration is available\n * (Reanimated 4 with react-native-worklets providing\n * registerCustomSerializable). Skia objects use the JSI NativeState pattern\n * and can only be transferred to worklet runtimes through a custom\n * serializer, so on native the Reanimated integration requires Reanimated 4 —\n * Reanimated 3 is not supported.\n */\nexport let HAS_REANIMATED_4 = false;\n\n/**\n * Major version of the installed react-native-reanimated package, or null if\n * it is not installed. Used to give actionable diagnostics when the\n * integration cannot be enabled.\n */\nexport let REANIMATED_VERSION_MAJOR: number | null = null;\n\ntry {\n  // This logic is convoluted but necessary\n  // In most systems, `require(\"react-native-reanimated\")` throws an error, all is well.\n  // In webpack, in some configuration it will return an empty object.\n  // So it will not throw an error and we need to check the version to know if it's there.\n  const reanimatedVersion =\n    require(\"react-native-reanimated/package.json\").version;\n  require(\"react-native-reanimated\");\n  if (\n    reanimatedVersion &&\n    (reanimatedVersion >= \"3.0.0\" || reanimatedVersion.includes(\"3.0.0-\"))\n  ) {\n    HAS_REANIMATED_3 = true;\n  }\n  const majorVersion = parseInt(reanimatedVersion.split(\".\")[0], 10);\n  if (!isNaN(majorVersion)) {\n    REANIMATED_VERSION_MAJOR = majorVersion;\n  }\n  if (majorVersion >= 4) {\n    try {\n      const worklets = require(\"react-native-worklets\");\n      HAS_REANIMATED_4 =\n        typeof worklets.registerCustomSerializable === \"function\";\n    } catch (e) {\n      // react-native-worklets not installed\n    }\n  }\n} catch (e) {\n  // do nothing\n}\n"],"mappings":"AAAA,OAAO,IAAIA,gBAAgB,GAAG,KAAK;;AAEnC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,IAAIC,gBAAgB,GAAG,KAAK;;AAEnC;AACA;AACA;AACA;AACA;AACA,OAAO,IAAIC,wBAAuC,GAAG,IAAI;AAEzD,IAAI;EACF;EACA;EACA;EACA;EACA,MAAMC,iBAAiB,GACrBC,OAAO,CAAC,sCAAsC,CAAC,CAACC,OAAO;EACzDD,OAAO,CAAC,yBAAyB,CAAC;EAClC,IACED,iBAAiB,KAChBA,iBAAiB,IAAI,OAAO,IAAIA,iBAAiB,CAACG,QAAQ,CAAC,QAAQ,CAAC,CAAC,EACtE;IACAN,gBAAgB,GAAG,IAAI;EACzB;EACA,MAAMO,YAAY,GAAGC,QAAQ,CAACL,iBAAiB,CAACM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;EAClE,IAAI,CAACC,KAAK,CAACH,YAAY,CAAC,EAAE;IACxBL,wBAAwB,GAAGK,YAAY;EACzC;EACA,IAAIA,YAAY,IAAI,CAAC,EAAE;IACrB,IAAI;MACF,MAAMI,QAAQ,GAAGP,OAAO,CAAC,uBAAuB,CAAC;MACjDH,gBAAgB,GACd,OAAOU,QAAQ,CAACC,0BAA0B,KAAK,UAAU;IAC7D,CAAC,CAAC,OAAOC,CAAC,EAAE;MACV;IAAA;EAEJ;AACF,CAAC,CAAC,OAAOA,CAAC,EAAE;EACV;AAAA","ignoreList":[]}

package/lib/module/skia/NativeSetup.js

@@ -1,5 +1,6 @@
 import { Platform } from "../Platform";
 import NativeSkiaModule from "../specs/NativeSkiaModule";
+import { registerSkiaWorkletSerialization } from "./SkiaWorkletSerialization";
 if (Platform.OS !== "web" && global.SkiaApi == null) {
   // Initialize RN Skia
   const SkiaModule = NativeSkiaModule;
@@ -10,5 +11,8 @@ if (Platform.OS !== "web" && global.SkiaApi == null) {
   if (result !== true) {
     throw new Error(`Native Skia Module failed to correctly install JSI Bindings! Result: ${result}`);
   }
+  // Skia objects use the JSI NativeState pattern and need a custom
+  // serializer to be transferable to worklet runtimes (Reanimated).
+  registerSkiaWorkletSerialization();
 }
 //# sourceMappingURL=NativeSetup.js.map

package/lib/module/skia/NativeSetup.js.map

@@ -1 +1 @@
-{"version":3,"names":["Platform","NativeSkiaModule","OS","global","SkiaApi","SkiaModule","install","Error","result"],"sources":["NativeSetup.ts"],"sourcesContent":["import { Platform } from \"../Platform\";\nimport NativeSkiaModule from \"../specs/NativeSkiaModule\";\n\nif (Platform.OS !== \"web\" && global.SkiaApi == null) {\n  // Initialize RN Skia\n  const SkiaModule = NativeSkiaModule;\n  if (SkiaModule == null || typeof SkiaModule.install !== \"function\") {\n    throw new Error(\n      \"Native RNSkia Module cannot be found! Make sure you correctly \" +\n        \"installed native dependencies and rebuilt your app.\"\n    );\n  }\n  const result = SkiaModule.install();\n  if (result !== true) {\n    throw new Error(\n      `Native Skia Module failed to correctly install JSI Bindings! Result: ${result}`\n    );\n  }\n}\n"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,aAAa;AACtC,OAAOC,gBAAgB,MAAM,2BAA2B;AAExD,IAAID,QAAQ,CAACE,EAAE,KAAK,KAAK,IAAIC,MAAM,CAACC,OAAO,IAAI,IAAI,EAAE;EACnD;EACA,MAAMC,UAAU,GAAGJ,gBAAgB;EACnC,IAAII,UAAU,IAAI,IAAI,IAAI,OAAOA,UAAU,CAACC,OAAO,KAAK,UAAU,EAAE;IAClE,MAAM,IAAIC,KAAK,CACb,gEAAgE,GAC9D,qDACJ,CAAC;EACH;EACA,MAAMC,MAAM,GAAGH,UAAU,CAACC,OAAO,CAAC,CAAC;EACnC,IAAIE,MAAM,KAAK,IAAI,EAAE;IACnB,MAAM,IAAID,KAAK,CACb,wEAAwEC,MAAM,EAChF,CAAC;EACH;AACF","ignoreList":[]}
+{"version":3,"names":["Platform","NativeSkiaModule","registerSkiaWorkletSerialization","OS","global","SkiaApi","SkiaModule","install","Error","result"],"sources":["NativeSetup.ts"],"sourcesContent":["import { Platform } from \"../Platform\";\nimport NativeSkiaModule from \"../specs/NativeSkiaModule\";\n\nimport { registerSkiaWorkletSerialization } from \"./SkiaWorkletSerialization\";\n\nif (Platform.OS !== \"web\" && global.SkiaApi == null) {\n  // Initialize RN Skia\n  const SkiaModule = NativeSkiaModule;\n  if (SkiaModule == null || typeof SkiaModule.install !== \"function\") {\n    throw new Error(\n      \"Native RNSkia Module cannot be found! Make sure you correctly \" +\n        \"installed native dependencies and rebuilt your app.\"\n    );\n  }\n  const result = SkiaModule.install();\n  if (result !== true) {\n    throw new Error(\n      `Native Skia Module failed to correctly install JSI Bindings! Result: ${result}`\n    );\n  }\n  // Skia objects use the JSI NativeState pattern and need a custom\n  // serializer to be transferable to worklet runtimes (Reanimated).\n  registerSkiaWorkletSerialization();\n}\n"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,aAAa;AACtC,OAAOC,gBAAgB,MAAM,2BAA2B;AAExD,SAASC,gCAAgC,QAAQ,4BAA4B;AAE7E,IAAIF,QAAQ,CAACG,EAAE,KAAK,KAAK,IAAIC,MAAM,CAACC,OAAO,IAAI,IAAI,EAAE;EACnD;EACA,MAAMC,UAAU,GAAGL,gBAAgB;EACnC,IAAIK,UAAU,IAAI,IAAI,IAAI,OAAOA,UAAU,CAACC,OAAO,KAAK,UAAU,EAAE;IAClE,MAAM,IAAIC,KAAK,CACb,gEAAgE,GAC9D,qDACJ,CAAC;EACH;EACA,MAAMC,MAAM,GAAGH,UAAU,CAACC,OAAO,CAAC,CAAC;EACnC,IAAIE,MAAM,KAAK,IAAI,EAAE;IACnB,MAAM,IAAID,KAAK,CACb,wEAAwEC,MAAM,EAChF,CAAC;EACH;EACA;EACA;EACAP,gCAAgC,CAAC,CAAC;AACpC","ignoreList":[]}

package/lib/module/skia/SkiaWorkletSerialization.d.ts

@@ -0,0 +1 @@
+export declare const registerSkiaWorkletSerialization: () => void;

package/lib/module/skia/SkiaWorkletSerialization.js

@@ -0,0 +1,59 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+/**
+ * Skia and WebGPU API objects are implemented with the JSI NativeState
+ * pattern: plain JS objects with a shared prototype and native state
+ * attached. Worklets cannot serialize such objects by default (the prototype
+ * would be lost when moving them to another runtime), so we register a
+ * Custom Serializable that:
+ *
+ * - determine: detects native objects via the `__box` method installed on
+ *   every Skia and WebGPU prototype (plain objects never reach the
+ *   custom-serializable path, so this cannot misfire on user data).
+ * - pack: boxes the object into a HostObject wrapper that carries the native
+ *   state and the class brand. HostObjects are transferred by reference.
+ * - unpack: unboxes on the target runtime, re-installing the class prototype
+ *   there and re-attaching the same native state.
+ *
+ * See cpp/jsi/BoxedNativeObject.h for the native side.
+ *
+ * `react-native-worklets` (Reanimated 4) is required for this to work —
+ * without it, Skia and WebGPU objects cannot be captured in worklets or
+ * stored in shared values.
+ */
+
+const determine = value => {
+  "worklet";
+
+  return typeof value.__box === "function";
+};
+const pack = value => {
+  "worklet";
+
+  return value.__box();
+};
+const unpack = packed => {
+  "worklet";
+
+  return packed.unbox();
+};
+export const registerSkiaWorkletSerialization = () => {
+  try {
+    const worklets = require("react-native-worklets");
+    if (typeof worklets.registerCustomSerializable === "function") {
+      worklets.registerCustomSerializable({
+        name: "ReactNativeSkia",
+        determine,
+        pack,
+        unpack
+      });
+    } else {
+      console.error("React Native Skia requires react-native-worklets >= 0.7.0 " + "(registerCustomSerializable) to use Skia objects inside worklets. " + "Please upgrade react-native-worklets and react-native-reanimated.");
+    }
+  } catch (e) {
+    // react-native-worklets is not installed. This is fine for apps that do
+    // not use Reanimated: Skia objects simply cannot be used inside worklets
+    // or shared values in this configuration.
+  }
+};
+//# sourceMappingURL=SkiaWorkletSerialization.js.map

package/lib/module/skia/SkiaWorkletSerialization.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["determine","value","__box","pack","unpack","packed","unbox","registerSkiaWorkletSerialization","worklets","require","registerCustomSerializable","name","console","error","e"],"sources":["SkiaWorkletSerialization.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Skia and WebGPU API objects are implemented with the JSI NativeState\n * pattern: plain JS objects with a shared prototype and native state\n * attached. Worklets cannot serialize such objects by default (the prototype\n * would be lost when moving them to another runtime), so we register a\n * Custom Serializable that:\n *\n * - determine: detects native objects via the `__box` method installed on\n *   every Skia and WebGPU prototype (plain objects never reach the\n *   custom-serializable path, so this cannot misfire on user data).\n * - pack: boxes the object into a HostObject wrapper that carries the native\n *   state and the class brand. HostObjects are transferred by reference.\n * - unpack: unboxes on the target runtime, re-installing the class prototype\n *   there and re-attaching the same native state.\n *\n * See cpp/jsi/BoxedNativeObject.h for the native side.\n *\n * `react-native-worklets` (Reanimated 4) is required for this to work —\n * without it, Skia and WebGPU objects cannot be captured in worklets or\n * stored in shared values.\n */\n\ninterface BoxedNativeObject {\n  unbox: () => object;\n  __boxedNativeObject: true;\n}\n\nconst determine = (value: object): value is object => {\n  \"worklet\";\n  return typeof (value as any).__box === \"function\";\n};\n\nconst pack = (value: object): BoxedNativeObject => {\n  \"worklet\";\n  return (value as any).__box();\n};\n\nconst unpack = (packed: BoxedNativeObject): object => {\n  \"worklet\";\n  return packed.unbox();\n};\n\nexport const registerSkiaWorkletSerialization = () => {\n  try {\n    const worklets = require(\"react-native-worklets\");\n    if (typeof worklets.registerCustomSerializable === \"function\") {\n      worklets.registerCustomSerializable({\n        name: \"ReactNativeSkia\",\n        determine,\n        pack,\n        unpack,\n      });\n    } else {\n      console.error(\n        \"React Native Skia requires react-native-worklets >= 0.7.0 \" +\n          \"(registerCustomSerializable) to use Skia objects inside worklets. \" +\n          \"Please upgrade react-native-worklets and react-native-reanimated.\"\n      );\n    }\n  } catch (e) {\n    // react-native-worklets is not installed. This is fine for apps that do\n    // not use Reanimated: Skia objects simply cannot be used inside worklets\n    // or shared values in this configuration.\n  }\n};\n"],"mappings":"AAAA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA,MAAMA,SAAS,GAAIC,KAAa,IAAsB;EACpD,SAAS;;EACT,OAAO,OAAQA,KAAK,CAASC,KAAK,KAAK,UAAU;AACnD,CAAC;AAED,MAAMC,IAAI,GAAIF,KAAa,IAAwB;EACjD,SAAS;;EACT,OAAQA,KAAK,CAASC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAME,MAAM,GAAIC,MAAyB,IAAa;EACpD,SAAS;;EACT,OAAOA,MAAM,CAACC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,OAAO,MAAMC,gCAAgC,GAAGA,CAAA,KAAM;EACpD,IAAI;IACF,MAAMC,QAAQ,GAAGC,OAAO,CAAC,uBAAuB,CAAC;IACjD,IAAI,OAAOD,QAAQ,CAACE,0BAA0B,KAAK,UAAU,EAAE;MAC7DF,QAAQ,CAACE,0BAA0B,CAAC;QAClCC,IAAI,EAAE,iBAAiB;QACvBX,SAAS;QACTG,IAAI;QACJC;MACF,CAAC,CAAC;IACJ,CAAC,MAAM;MACLQ,OAAO,CAACC,KAAK,CACX,4DAA4D,GAC1D,oEAAoE,GACpE,mEACJ,CAAC;IACH;EACF,CAAC,CAAC,OAAOC,CAAC,EAAE;IACV;IACA;IACA;EAAA;AAEJ,CAAC","ignoreList":[]}

package/lib/module/sksg/Container.native.js

@@ -2,7 +2,7 @@ function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import Rea from "../external/reanimated/ReanimatedProxy";
-import { HAS_REANIMATED_3 } from "../external/reanimated/renderHelpers";
+import { HAS_REANIMATED_3, HAS_REANIMATED_4, REANIMATED_VERSION_MAJOR } from "../external/reanimated/renderHelpers";
 import { ReanimatedRecorder } from "./Recorder/ReanimatedRecorder";
 import { Container, StaticContainer } from "./StaticContainer";
 import { visit } from "./Recorder/Visitor";
@@ -73,10 +73,29 @@ class NativeReanimatedContainer extends Container {
     }
   }
 }
+let hasWarnedAboutReanimatedSupport = false;
+const reanimatedSupportError = () => {
+  if (REANIMATED_VERSION_MAJOR !== null && REANIMATED_VERSION_MAJOR >= 4) {
+    return "React Native Skia requires react-native-worklets >= 0.7.0 for its " + "Reanimated integration on native platforms. Reanimated 4 is " + "installed, but react-native-worklets is missing or too old. " + "Please install or upgrade react-native-worklets.";
+  }
+  return "React Native Skia requires Reanimated 4 (react-native-worklets >= " + "0.7.0) for its Reanimated integration on native platforms. " + "Reanimated 3 is not supported anymore: Skia objects cannot be used " + "inside worklets or shared values with it. " + "Please upgrade to react-native-reanimated >= 4.0.0.";
+};
 export const createContainer = (Skia, nativeId) => {
-  if (HAS_REANIMATED_3 && nativeId !== -1) {
+  if (HAS_REANIMATED_4 && nativeId !== -1) {
     return new NativeReanimatedContainer(Skia, nativeId);
   } else {
+    if (HAS_REANIMATED_3 && !HAS_REANIMATED_4) {
+      const message = reanimatedSupportError();
+      if (__DEV__) {
+        // Fail loudly in development — a silent fallback to static rendering
+        // would only be noticed as frozen animations.
+        throw new Error(message);
+      }
+      if (!hasWarnedAboutReanimatedSupport) {
+        hasWarnedAboutReanimatedSupport = true;
+        console.error(`${message} Falling back to static rendering (animations will not run).`);
+      }
+    }
     return new StaticContainer(Skia, nativeId);
   }
 };

package/lib/module/sksg/Container.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["Rea","HAS_REANIMATED_3","ReanimatedRecorder","Container","StaticContainer","visit","SkiaViewApi","globalThis","nativeDrawOnscreen","nativeId","recorder","picture","play","setJsiProperty","NativeReanimatedContainer","constructor","Skia","_defineProperty","Picture","MakePicture","unmount","mapperId","stopMapper","redraw","unmounted","root","sharedValues","getSharedValues","sharedRecorder","getRecorder","runOnUI","length","startMapper","applyUpdates","createContainer"],"sources":["Container.native.ts"],"sourcesContent":["import Rea from \"../external/reanimated/ReanimatedProxy\";\nimport type { Skia, SkPicture } from \"../skia/types\";\nimport { HAS_REANIMATED_3 } from \"../external/reanimated/renderHelpers\";\nimport type { JsiRecorder } from \"../skia/types/Recorder\";\n\nimport { ReanimatedRecorder } from \"./Recorder/ReanimatedRecorder\";\nimport { Container, StaticContainer } from \"./StaticContainer\";\nimport { visit } from \"./Recorder/Visitor\";\n\nimport \"../skia/NativeSetup\";\nimport \"../views/api\";\n\n// create local reference for `strictGlobal` option in Worklets\nconst { SkiaViewApi } = globalThis;\n\nconst nativeDrawOnscreen = (\n  nativeId: number,\n  recorder: JsiRecorder,\n  picture: SkPicture\n) => {\n  \"worklet\";\n\n  //const start = performance.now();\n  recorder.play(picture);\n  //const end = performance.now();\n  //console.log(\"Recording time: \", end - start);\n  SkiaViewApi.setJsiProperty(nativeId, \"picture\", picture);\n};\n\nclass NativeReanimatedContainer extends Container {\n  private mapperId: number | null = null;\n  private picture: SkPicture;\n\n  constructor(\n    Skia: Skia,\n    private nativeId: number\n  ) {\n    super(Skia);\n    this.picture = Skia.Picture.MakePicture(null)!;\n  }\n\n  unmount() {\n    super.unmount();\n    if (this.mapperId !== null) {\n      // The mapper closure retains the recorder and its resources (e.g.\n      // images) on the UI runtime and keeps updating the picture of an\n      // unmounted view — stop it or it leaks for the lifetime of the app.\n      Rea.stopMapper(this.mapperId);\n      this.mapperId = null;\n    }\n  }\n\n  redraw() {\n    if (this.mapperId !== null) {\n      Rea.stopMapper(this.mapperId);\n      this.mapperId = null;\n    }\n    if (this.unmounted) {\n      return;\n    }\n    const recorder = new ReanimatedRecorder(this.Skia);\n    const { nativeId, picture } = this;\n    visit(recorder, this.root);\n    const sharedValues = recorder.getSharedValues();\n    const sharedRecorder = recorder.getRecorder();\n    // Draw first frame\n    Rea.runOnUI(() => {\n      \"worklet\";\n      nativeDrawOnscreen(nativeId, sharedRecorder, picture);\n    })();\n    // Animate\n    if (sharedValues.length > 0) {\n      this.mapperId = Rea.startMapper(() => {\n        \"worklet\";\n        sharedRecorder.applyUpdates(sharedValues);\n        nativeDrawOnscreen(nativeId, sharedRecorder, picture);\n      }, sharedValues);\n    }\n  }\n}\n\nexport const createContainer = (Skia: Skia, nativeId: number) => {\n  if (HAS_REANIMATED_3 && nativeId !== -1) {\n    return new NativeReanimatedContainer(Skia, nativeId);\n  } else {\n    return new StaticContainer(Skia, nativeId);\n  }\n};\n"],"mappings":";;;AAAA,OAAOA,GAAG,MAAM,wCAAwC;AAExD,SAASC,gBAAgB,QAAQ,sCAAsC;AAGvE,SAASC,kBAAkB,QAAQ,+BAA+B;AAClE,SAASC,SAAS,EAAEC,eAAe,QAAQ,mBAAmB;AAC9D,SAASC,KAAK,QAAQ,oBAAoB;AAE1C,OAAO,qBAAqB;AAC5B,OAAO,cAAc;;AAErB;AACA,MAAM;EAAEC;AAAY,CAAC,GAAGC,UAAU;AAElC,MAAMC,kBAAkB,GAAGA,CACzBC,QAAgB,EAChBC,QAAqB,EACrBC,OAAkB,KACf;EACH,SAAS;;EAET;EACAD,QAAQ,CAACE,IAAI,CAACD,OAAO,CAAC;EACtB;EACA;EACAL,WAAW,CAACO,cAAc,CAACJ,QAAQ,EAAE,SAAS,EAAEE,OAAO,CAAC;AAC1D,CAAC;AAED,MAAMG,yBAAyB,SAASX,SAAS,CAAC;EAIhDY,WAAWA,CACTC,IAAU,EACFP,QAAgB,EACxB;IACA,KAAK,CAACO,IAAI,CAAC;IAAC,KAFJP,QAAgB,GAAhBA,QAAgB;IAAAQ,eAAA,mBALQ,IAAI;IAAAA,eAAA;IAQpC,IAAI,CAACN,OAAO,GAAGK,IAAI,CAACE,OAAO,CAACC,WAAW,CAAC,IAAI,CAAE;EAChD;EAEAC,OAAOA,CAAA,EAAG;IACR,KAAK,CAACA,OAAO,CAAC,CAAC;IACf,IAAI,IAAI,CAACC,QAAQ,KAAK,IAAI,EAAE;MAC1B;MACA;MACA;MACArB,GAAG,CAACsB,UAAU,CAAC,IAAI,CAACD,QAAQ,CAAC;MAC7B,IAAI,CAACA,QAAQ,GAAG,IAAI;IACtB;EACF;EAEAE,MAAMA,CAAA,EAAG;IACP,IAAI,IAAI,CAACF,QAAQ,KAAK,IAAI,EAAE;MAC1BrB,GAAG,CAACsB,UAAU,CAAC,IAAI,CAACD,QAAQ,CAAC;MAC7B,IAAI,CAACA,QAAQ,GAAG,IAAI;IACtB;IACA,IAAI,IAAI,CAACG,SAAS,EAAE;MAClB;IACF;IACA,MAAMd,QAAQ,GAAG,IAAIR,kBAAkB,CAAC,IAAI,CAACc,IAAI,CAAC;IAClD,MAAM;MAAEP,QAAQ;MAAEE;IAAQ,CAAC,GAAG,IAAI;IAClCN,KAAK,CAACK,QAAQ,EAAE,IAAI,CAACe,IAAI,CAAC;IAC1B,MAAMC,YAAY,GAAGhB,QAAQ,CAACiB,eAAe,CAAC,CAAC;IAC/C,MAAMC,cAAc,GAAGlB,QAAQ,CAACmB,WAAW,CAAC,CAAC;IAC7C;IACA7B,GAAG,CAAC8B,OAAO,CAAC,MAAM;MAChB,SAAS;;MACTtB,kBAAkB,CAACC,QAAQ,EAAEmB,cAAc,EAAEjB,OAAO,CAAC;IACvD,CAAC,CAAC,CAAC,CAAC;IACJ;IACA,IAAIe,YAAY,CAACK,MAAM,GAAG,CAAC,EAAE;MAC3B,IAAI,CAACV,QAAQ,GAAGrB,GAAG,CAACgC,WAAW,CAAC,MAAM;QACpC,SAAS;;QACTJ,cAAc,CAACK,YAAY,CAACP,YAAY,CAAC;QACzClB,kBAAkB,CAACC,QAAQ,EAAEmB,cAAc,EAAEjB,OAAO,CAAC;MACvD,CAAC,EAAEe,YAAY,CAAC;IAClB;EACF;AACF;AAEA,OAAO,MAAMQ,eAAe,GAAGA,CAAClB,IAAU,EAAEP,QAAgB,KAAK;EAC/D,IAAIR,gBAAgB,IAAIQ,QAAQ,KAAK,CAAC,CAAC,EAAE;IACvC,OAAO,IAAIK,yBAAyB,CAACE,IAAI,EAAEP,QAAQ,CAAC;EACtD,CAAC,MAAM;IACL,OAAO,IAAIL,eAAe,CAACY,IAAI,EAAEP,QAAQ,CAAC;EAC5C;AACF,CAAC","ignoreList":[]}
+{"version":3,"names":["Rea","HAS_REANIMATED_3","HAS_REANIMATED_4","REANIMATED_VERSION_MAJOR","ReanimatedRecorder","Container","StaticContainer","visit","SkiaViewApi","globalThis","nativeDrawOnscreen","nativeId","recorder","picture","play","setJsiProperty","NativeReanimatedContainer","constructor","Skia","_defineProperty","Picture","MakePicture","unmount","mapperId","stopMapper","redraw","unmounted","root","sharedValues","getSharedValues","sharedRecorder","getRecorder","runOnUI","length","startMapper","applyUpdates","hasWarnedAboutReanimatedSupport","reanimatedSupportError","createContainer","message","__DEV__","Error","console","error"],"sources":["Container.native.ts"],"sourcesContent":["import Rea from \"../external/reanimated/ReanimatedProxy\";\nimport type { Skia, SkPicture } from \"../skia/types\";\nimport {\n  HAS_REANIMATED_3,\n  HAS_REANIMATED_4,\n  REANIMATED_VERSION_MAJOR,\n} from \"../external/reanimated/renderHelpers\";\nimport type { JsiRecorder } from \"../skia/types/Recorder\";\n\nimport { ReanimatedRecorder } from \"./Recorder/ReanimatedRecorder\";\nimport { Container, StaticContainer } from \"./StaticContainer\";\nimport { visit } from \"./Recorder/Visitor\";\n\nimport \"../skia/NativeSetup\";\nimport \"../views/api\";\n\n// create local reference for `strictGlobal` option in Worklets\nconst { SkiaViewApi } = globalThis;\n\nconst nativeDrawOnscreen = (\n  nativeId: number,\n  recorder: JsiRecorder,\n  picture: SkPicture\n) => {\n  \"worklet\";\n\n  //const start = performance.now();\n  recorder.play(picture);\n  //const end = performance.now();\n  //console.log(\"Recording time: \", end - start);\n  SkiaViewApi.setJsiProperty(nativeId, \"picture\", picture);\n};\n\nclass NativeReanimatedContainer extends Container {\n  private mapperId: number | null = null;\n  private picture: SkPicture;\n\n  constructor(\n    Skia: Skia,\n    private nativeId: number\n  ) {\n    super(Skia);\n    this.picture = Skia.Picture.MakePicture(null)!;\n  }\n\n  unmount() {\n    super.unmount();\n    if (this.mapperId !== null) {\n      // The mapper closure retains the recorder and its resources (e.g.\n      // images) on the UI runtime and keeps updating the picture of an\n      // unmounted view — stop it or it leaks for the lifetime of the app.\n      Rea.stopMapper(this.mapperId);\n      this.mapperId = null;\n    }\n  }\n\n  redraw() {\n    if (this.mapperId !== null) {\n      Rea.stopMapper(this.mapperId);\n      this.mapperId = null;\n    }\n    if (this.unmounted) {\n      return;\n    }\n    const recorder = new ReanimatedRecorder(this.Skia);\n    const { nativeId, picture } = this;\n    visit(recorder, this.root);\n    const sharedValues = recorder.getSharedValues();\n    const sharedRecorder = recorder.getRecorder();\n    // Draw first frame\n    Rea.runOnUI(() => {\n      \"worklet\";\n      nativeDrawOnscreen(nativeId, sharedRecorder, picture);\n    })();\n    // Animate\n    if (sharedValues.length > 0) {\n      this.mapperId = Rea.startMapper(() => {\n        \"worklet\";\n        sharedRecorder.applyUpdates(sharedValues);\n        nativeDrawOnscreen(nativeId, sharedRecorder, picture);\n      }, sharedValues);\n    }\n  }\n}\n\nlet hasWarnedAboutReanimatedSupport = false;\n\nconst reanimatedSupportError = () => {\n  if (REANIMATED_VERSION_MAJOR !== null && REANIMATED_VERSION_MAJOR >= 4) {\n    return (\n      \"React Native Skia requires react-native-worklets >= 0.7.0 for its \" +\n      \"Reanimated integration on native platforms. Reanimated 4 is \" +\n      \"installed, but react-native-worklets is missing or too old. \" +\n      \"Please install or upgrade react-native-worklets.\"\n    );\n  }\n  return (\n    \"React Native Skia requires Reanimated 4 (react-native-worklets >= \" +\n    \"0.7.0) for its Reanimated integration on native platforms. \" +\n    \"Reanimated 3 is not supported anymore: Skia objects cannot be used \" +\n    \"inside worklets or shared values with it. \" +\n    \"Please upgrade to react-native-reanimated >= 4.0.0.\"\n  );\n};\n\nexport const createContainer = (Skia: Skia, nativeId: number) => {\n  if (HAS_REANIMATED_4 && nativeId !== -1) {\n    return new NativeReanimatedContainer(Skia, nativeId);\n  } else {\n    if (HAS_REANIMATED_3 && !HAS_REANIMATED_4) {\n      const message = reanimatedSupportError();\n      if (__DEV__) {\n        // Fail loudly in development — a silent fallback to static rendering\n        // would only be noticed as frozen animations.\n        throw new Error(message);\n      }\n      if (!hasWarnedAboutReanimatedSupport) {\n        hasWarnedAboutReanimatedSupport = true;\n        console.error(\n          `${message} Falling back to static rendering (animations will not run).`\n        );\n      }\n    }\n    return new StaticContainer(Skia, nativeId);\n  }\n};\n"],"mappings":";;;AAAA,OAAOA,GAAG,MAAM,wCAAwC;AAExD,SACEC,gBAAgB,EAChBC,gBAAgB,EAChBC,wBAAwB,QACnB,sCAAsC;AAG7C,SAASC,kBAAkB,QAAQ,+BAA+B;AAClE,SAASC,SAAS,EAAEC,eAAe,QAAQ,mBAAmB;AAC9D,SAASC,KAAK,QAAQ,oBAAoB;AAE1C,OAAO,qBAAqB;AAC5B,OAAO,cAAc;;AAErB;AACA,MAAM;EAAEC;AAAY,CAAC,GAAGC,UAAU;AAElC,MAAMC,kBAAkB,GAAGA,CACzBC,QAAgB,EAChBC,QAAqB,EACrBC,OAAkB,KACf;EACH,SAAS;;EAET;EACAD,QAAQ,CAACE,IAAI,CAACD,OAAO,CAAC;EACtB;EACA;EACAL,WAAW,CAACO,cAAc,CAACJ,QAAQ,EAAE,SAAS,EAAEE,OAAO,CAAC;AAC1D,CAAC;AAED,MAAMG,yBAAyB,SAASX,SAAS,CAAC;EAIhDY,WAAWA,CACTC,IAAU,EACFP,QAAgB,EACxB;IACA,KAAK,CAACO,IAAI,CAAC;IAAC,KAFJP,QAAgB,GAAhBA,QAAgB;IAAAQ,eAAA,mBALQ,IAAI;IAAAA,eAAA;IAQpC,IAAI,CAACN,OAAO,GAAGK,IAAI,CAACE,OAAO,CAACC,WAAW,CAAC,IAAI,CAAE;EAChD;EAEAC,OAAOA,CAAA,EAAG;IACR,KAAK,CAACA,OAAO,CAAC,CAAC;IACf,IAAI,IAAI,CAACC,QAAQ,KAAK,IAAI,EAAE;MAC1B;MACA;MACA;MACAvB,GAAG,CAACwB,UAAU,CAAC,IAAI,CAACD,QAAQ,CAAC;MAC7B,IAAI,CAACA,QAAQ,GAAG,IAAI;IACtB;EACF;EAEAE,MAAMA,CAAA,EAAG;IACP,IAAI,IAAI,CAACF,QAAQ,KAAK,IAAI,EAAE;MAC1BvB,GAAG,CAACwB,UAAU,CAAC,IAAI,CAACD,QAAQ,CAAC;MAC7B,IAAI,CAACA,QAAQ,GAAG,IAAI;IACtB;IACA,IAAI,IAAI,CAACG,SAAS,EAAE;MAClB;IACF;IACA,MAAMd,QAAQ,GAAG,IAAIR,kBAAkB,CAAC,IAAI,CAACc,IAAI,CAAC;IAClD,MAAM;MAAEP,QAAQ;MAAEE;IAAQ,CAAC,GAAG,IAAI;IAClCN,KAAK,CAACK,QAAQ,EAAE,IAAI,CAACe,IAAI,CAAC;IAC1B,MAAMC,YAAY,GAAGhB,QAAQ,CAACiB,eAAe,CAAC,CAAC;IAC/C,MAAMC,cAAc,GAAGlB,QAAQ,CAACmB,WAAW,CAAC,CAAC;IAC7C;IACA/B,GAAG,CAACgC,OAAO,CAAC,MAAM;MAChB,SAAS;;MACTtB,kBAAkB,CAACC,QAAQ,EAAEmB,cAAc,EAAEjB,OAAO,CAAC;IACvD,CAAC,CAAC,CAAC,CAAC;IACJ;IACA,IAAIe,YAAY,CAACK,MAAM,GAAG,CAAC,EAAE;MAC3B,IAAI,CAACV,QAAQ,GAAGvB,GAAG,CAACkC,WAAW,CAAC,MAAM;QACpC,SAAS;;QACTJ,cAAc,CAACK,YAAY,CAACP,YAAY,CAAC;QACzClB,kBAAkB,CAACC,QAAQ,EAAEmB,cAAc,EAAEjB,OAAO,CAAC;MACvD,CAAC,EAAEe,YAAY,CAAC;IAClB;EACF;AACF;AAEA,IAAIQ,+BAA+B,GAAG,KAAK;AAE3C,MAAMC,sBAAsB,GAAGA,CAAA,KAAM;EACnC,IAAIlC,wBAAwB,KAAK,IAAI,IAAIA,wBAAwB,IAAI,CAAC,EAAE;IACtE,OACE,oEAAoE,GACpE,8DAA8D,GAC9D,8DAA8D,GAC9D,kDAAkD;EAEtD;EACA,OACE,oEAAoE,GACpE,6DAA6D,GAC7D,qEAAqE,GACrE,4CAA4C,GAC5C,qDAAqD;AAEzD,CAAC;AAED,OAAO,MAAMmC,eAAe,GAAGA,CAACpB,IAAU,EAAEP,QAAgB,KAAK;EAC/D,IAAIT,gBAAgB,IAAIS,QAAQ,KAAK,CAAC,CAAC,EAAE;IACvC,OAAO,IAAIK,yBAAyB,CAACE,IAAI,EAAEP,QAAQ,CAAC;EACtD,CAAC,MAAM;IACL,IAAIV,gBAAgB,IAAI,CAACC,gBAAgB,EAAE;MACzC,MAAMqC,OAAO,GAAGF,sBAAsB,CAAC,CAAC;MACxC,IAAIG,OAAO,EAAE;QACX;QACA;QACA,MAAM,IAAIC,KAAK,CAACF,OAAO,CAAC;MAC1B;MACA,IAAI,CAACH,+BAA+B,EAAE;QACpCA,+BAA+B,GAAG,IAAI;QACtCM,OAAO,CAACC,KAAK,CACX,GAAGJ,OAAO,8DACZ,CAAC;MACH;IACF;IACA,OAAO,IAAIjC,eAAe,CAACY,IAAI,EAAEP,QAAQ,CAAC;EAC5C;AACF,CAAC","ignoreList":[]}

package/lib/typescript/lib/commonjs/external/reanimated/renderHelpers.d.ts

@@ -1,2 +1,4 @@
 export const __esModule: boolean;
 export const HAS_REANIMATED_3: any;
+export const HAS_REANIMATED_4: any;
+export const REANIMATED_VERSION_MAJOR: any;

package/lib/typescript/lib/commonjs/skia/SkiaWorkletSerialization.d.ts

@@ -0,0 +1,2 @@
+export const __esModule: boolean;
+export function registerSkiaWorkletSerialization(): void;

package/lib/typescript/lib/module/external/reanimated/renderHelpers.d.ts

@@ -1 +1,16 @@
 export let HAS_REANIMATED_3: boolean;
+/**
+ * True when the worklets-based Reanimated integration is available
+ * (Reanimated 4 with react-native-worklets providing
+ * registerCustomSerializable). Skia objects use the JSI NativeState pattern
+ * and can only be transferred to worklet runtimes through a custom
+ * serializer, so on native the Reanimated integration requires Reanimated 4 —
+ * Reanimated 3 is not supported.
+ */
+export let HAS_REANIMATED_4: boolean;
+/**
+ * Major version of the installed react-native-reanimated package, or null if
+ * it is not installed. Used to give actionable diagnostics when the
+ * integration cannot be enabled.
+ */
+export let REANIMATED_VERSION_MAJOR: null;

package/lib/typescript/lib/module/skia/SkiaWorkletSerialization.d.ts

@@ -0,0 +1 @@
+export function registerSkiaWorkletSerialization(): void;