fix: requested changes

Author: NorbertKlockiewicz

apps/computer-vision/app/object_detection_live/index.tsx

@@ -42,7 +42,6 @@ export default function ObjectDetectionLiveScreen() {
   useEffect(() => {
     setGlobalGenerating(model.isGenerating);
   }, [model.isGenerating, setGlobalGenerating]);
-
   const [detectionCount, setDetectionCount] = useState(0);
   const [fps, setFps] = useState(0);
   const lastFrameTimeRef = useRef(Date.now());

docs/docs/05-utilities/04-error-handling.md

@@ -83,14 +83,15 @@ These errors occur when trying to perform operations on a model in an invalid st
 
 These errors occur when invalid configuration or input is provided.
 
-| Error Code             | Description                          | When It Occurs                                                            | How to Handle                                        |
-| ---------------------- | ------------------------------------ | ------------------------------------------------------------------------- | ---------------------------------------------------- |
-| `InvalidConfig`        | Configuration parameters are invalid | Setting parameters outside valid ranges (e.g., `topp` outside [0, 1])     | Check parameter constraints and provide valid values |
-| `InvalidUserInput`     | Input provided to API is invalid     | Passing empty arrays, null values, or malformed data to methods           | Validate input before calling methods                |
-| `InvalidModelSource`   | Model source type is invalid         | Providing wrong type for model source (e.g., object when string expected) | Ensure model source matches expected type            |
-| `LanguageNotSupported` | Language not supported by model      | Passing unsupported language to multilingual OCR or Speech-to-Text models | Use a supported language or different model          |
-| `WrongDimensions`      | Input tensor dimensions don't match  | Providing input with incorrect shape for the model                        | Check model's expected input dimensions              |
-| `UnexpectedNumInputs`  | Wrong number of inputs provided      | Passing more or fewer inputs than model expects                           | Match the number of inputs to model metadata         |
+| Error Code             | Description                          | When It Occurs                                                                          | How to Handle                                            |
+| ---------------------- | ------------------------------------ | --------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| `InvalidConfig`        | Configuration parameters are invalid | Setting parameters outside valid ranges (e.g., `topp` outside [0, 1])                   | Check parameter constraints and provide valid values     |
+| `InvalidUserInput`     | Input provided to API is invalid     | Passing empty arrays, null values, or malformed data to methods                         | Validate input before calling methods                    |
+| `InvalidModelSource`   | Model source type is invalid         | Providing wrong type for model source (e.g., object when string expected)               | Ensure model source matches expected type                |
+| `LanguageNotSupported` | Language not supported by model      | Passing unsupported language to multilingual OCR or Speech-to-Text models               | Use a supported language or different model              |
+| `PlatformNotSupported` | Current platform is not supported    | Using features (e.g., camera frame processing) on an unsupported platform or OS version | Ensure you're running on a supported platform/OS version |
+| `WrongDimensions`      | Input tensor dimensions don't match  | Providing input with incorrect shape for the model                                      | Check model's expected input dimensions                  |
+| `UnexpectedNumInputs`  | Wrong number of inputs provided      | Passing more or fewer inputs than model expects                                         | Match the number of inputs to model metadata             |
 
 ### File Operations Errors
 

packages/react-native-executorch/src/hooks/computer_vision/useObjectDetection.ts

@@ -20,5 +20,5 @@ export const useObjectDetection = ({
     module: ObjectDetectionModule,
     model,
     preventLoad: preventLoad,
-  }) as ObjectDetectionType;
+  });
 };

packages/react-native-executorch/src/hooks/useModule.ts

@@ -2,6 +2,8 @@ import { useEffect, useState } from 'react';
 import { RnExecutorchErrorCode } from '../errors/ErrorCodes';
 import { RnExecutorchError, parseUnknownError } from '../errors/errorUtils';
 
+type RunOnFrame<M> = M extends { runOnFrame: infer R } ? R : never;
+
 interface Module {
   load: (...args: any[]) => Promise<void>;
   forward: (...args: any[]) => Promise<any>;
@@ -31,7 +33,7 @@ export const useModule = <
   const [isGenerating, setIsGenerating] = useState(false);
   const [downloadProgress, setDownloadProgress] = useState(0);
   const [moduleInstance] = useState(() => new module());
-  const [runOnFrame, setRunOnFrame] = useState<any>(null);
+  const [runOnFrame, setRunOnFrame] = useState<RunOnFrame<M> | null>(null);
 
   useEffect(() => {
     if (preventLoad) return;
@@ -48,9 +50,21 @@ export const useModule = <
         });
         if (isMounted) setIsReady(true);
 
-        // Use "state trick" to make the worklet serializable for VisionCamera
+        // VisionCamera worklets run on a separate JS thread and can only capture
+        // serializable values (plain functions, primitives). The module instance
+        // is a class object and is not serializable, so accessing runOnFrame
+        // directly inside a worklet would fail at runtime.
+        //
+        // By extracting the method and storing it in React state, it becomes a
+        // standalone function reference that the worklet thread can capture and
+        // call safely.
+        //
+        // Note: setState(fn) triggers React's updater form — it calls fn(prevState)
+        // and stores the return value, not fn itself. Since runOnFrame is a function,
+        // we wrap it: setState(() => worklet) so React stores the worklet as the
+        // state value rather than invoking it.
         if ('runOnFrame' in moduleInstance) {
-          const worklet = moduleInstance.runOnFrame;
+          const worklet = moduleInstance.runOnFrame as RunOnFrame<M>;
           if (worklet) {
             setRunOnFrame(() => worklet);
           }

packages/react-native-executorch/src/types/common.ts

@@ -169,7 +169,7 @@ export type Triple<T> = readonly [T, T, T];
  * };
  * ```
  */
-export interface PixelData extends Omit<TensorPtr, 'dataPtr' | 'scalarType'> {
+export interface PixelData extends Pick<TensorPtr, 'sizes'> {
   /**
    * RGB pixel data as Uint8Array.
    * Expected format: RGB (3 channels), not RGBA or BGRA.