react-native-nitro-pose-exercises 1.0.2

package/nitrogen/generated/shared/c++/RepData.hpp

@@ -0,0 +1,97 @@
+///
+/// RepData.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `AngleSnapshot` to properly resolve imports.
+namespace margelo::nitro::nitroposeexercises { struct AngleSnapshot; }
+
+#include "AngleSnapshot.hpp"
+#include <vector>
+
+namespace margelo::nitro::nitroposeexercises {
+
+  /**
+   * A struct which can be represented as a JavaScript object (RepData).
+   */
+  struct RepData final {
+  public:
+    double repNumber     SWIFT_PRIVATE;
+    double durationMs     SWIFT_PRIVATE;
+    double formScore     SWIFT_PRIVATE;
+    std::vector<AngleSnapshot> angles     SWIFT_PRIVATE;
+
+  public:
+    RepData() = default;
+    explicit RepData(double repNumber, double durationMs, double formScore, std::vector<AngleSnapshot> angles): repNumber(repNumber), durationMs(durationMs), formScore(formScore), angles(angles) {}
+
+  public:
+    friend bool operator==(const RepData& lhs, const RepData& rhs) = default;
+  };
+
+} // namespace margelo::nitro::nitroposeexercises
+
+namespace margelo::nitro {
+
+  // C++ RepData <> JS RepData (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroposeexercises::RepData> final {
+    static inline margelo::nitro::nitroposeexercises::RepData fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroposeexercises::RepData(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "repNumber"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "durationMs"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "formScore"))),
+        JSIConverter<std::vector<margelo::nitro::nitroposeexercises::AngleSnapshot>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "angles")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroposeexercises::RepData& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "repNumber"), JSIConverter<double>::toJSI(runtime, arg.repNumber));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "durationMs"), JSIConverter<double>::toJSI(runtime, arg.durationMs));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "formScore"), JSIConverter<double>::toJSI(runtime, arg.formScore));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "angles"), JSIConverter<std::vector<margelo::nitro::nitroposeexercises::AngleSnapshot>>::toJSI(runtime, arg.angles));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "repNumber")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "durationMs")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "formScore")))) return false;
+      if (!JSIConverter<std::vector<margelo::nitro::nitroposeexercises::AngleSnapshot>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "angles")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/SessionResult.hpp

@@ -0,0 +1,108 @@
+///
+/// SessionResult.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `FormFeedback` to properly resolve imports.
+namespace margelo::nitro::nitroposeexercises { struct FormFeedback; }
+// Forward declaration of `AngleSnapshot` to properly resolve imports.
+namespace margelo::nitro::nitroposeexercises { struct AngleSnapshot; }
+
+#include "FormFeedback.hpp"
+#include <vector>
+#include "AngleSnapshot.hpp"
+
+namespace margelo::nitro::nitroposeexercises {
+
+  /**
+   * A struct which can be represented as a JavaScript object (SessionResult).
+   */
+  struct SessionResult final {
+  public:
+    double totalReps     SWIFT_PRIVATE;
+    double totalDurationMs     SWIFT_PRIVATE;
+    double averageRepDurationMs     SWIFT_PRIVATE;
+    double averageFormScore     SWIFT_PRIVATE;
+    std::vector<FormFeedback> formViolations     SWIFT_PRIVATE;
+    std::vector<AngleSnapshot> angleHistory     SWIFT_PRIVATE;
+
+  public:
+    SessionResult() = default;
+    explicit SessionResult(double totalReps, double totalDurationMs, double averageRepDurationMs, double averageFormScore, std::vector<FormFeedback> formViolations, std::vector<AngleSnapshot> angleHistory): totalReps(totalReps), totalDurationMs(totalDurationMs), averageRepDurationMs(averageRepDurationMs), averageFormScore(averageFormScore), formViolations(formViolations), angleHistory(angleHistory) {}
+
+  public:
+    friend bool operator==(const SessionResult& lhs, const SessionResult& rhs) = default;
+  };
+
+} // namespace margelo::nitro::nitroposeexercises
+
+namespace margelo::nitro {
+
+  // C++ SessionResult <> JS SessionResult (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroposeexercises::SessionResult> final {
+    static inline margelo::nitro::nitroposeexercises::SessionResult fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroposeexercises::SessionResult(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalReps"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalDurationMs"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "averageRepDurationMs"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "averageFormScore"))),
+        JSIConverter<std::vector<margelo::nitro::nitroposeexercises::FormFeedback>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "formViolations"))),
+        JSIConverter<std::vector<margelo::nitro::nitroposeexercises::AngleSnapshot>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "angleHistory")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroposeexercises::SessionResult& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "totalReps"), JSIConverter<double>::toJSI(runtime, arg.totalReps));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "totalDurationMs"), JSIConverter<double>::toJSI(runtime, arg.totalDurationMs));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "averageRepDurationMs"), JSIConverter<double>::toJSI(runtime, arg.averageRepDurationMs));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "averageFormScore"), JSIConverter<double>::toJSI(runtime, arg.averageFormScore));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "formViolations"), JSIConverter<std::vector<margelo::nitro::nitroposeexercises::FormFeedback>>::toJSI(runtime, arg.formViolations));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "angleHistory"), JSIConverter<std::vector<margelo::nitro::nitroposeexercises::AngleSnapshot>>::toJSI(runtime, arg.angleHistory));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalReps")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalDurationMs")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "averageRepDurationMs")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "averageFormScore")))) return false;
+      if (!JSIConverter<std::vector<margelo::nitro::nitroposeexercises::FormFeedback>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "formViolations")))) return false;
+      if (!JSIConverter<std::vector<margelo::nitro::nitroposeexercises::AngleSnapshot>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "angleHistory")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/SessionStatus.hpp

@@ -0,0 +1,88 @@
+///
+/// SessionStatus.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::nitroposeexercises {
+
+  /**
+   * An enum which can be represented as a JavaScript union (SessionStatus).
+   */
+  enum class SessionStatus {
+    IDLE      SWIFT_NAME(idle) = 0,
+    COUNTDOWN      SWIFT_NAME(countdown) = 1,
+    ACTIVE      SWIFT_NAME(active) = 2,
+    PAUSED      SWIFT_NAME(paused) = 3,
+    COMPLETED      SWIFT_NAME(completed) = 4,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::nitroposeexercises
+
+namespace margelo::nitro {
+
+  // C++ SessionStatus <> JS SessionStatus (union)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroposeexercises::SessionStatus> final {
+    static inline margelo::nitro::nitroposeexercises::SessionStatus fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("idle"): return margelo::nitro::nitroposeexercises::SessionStatus::IDLE;
+        case hashString("countdown"): return margelo::nitro::nitroposeexercises::SessionStatus::COUNTDOWN;
+        case hashString("active"): return margelo::nitro::nitroposeexercises::SessionStatus::ACTIVE;
+        case hashString("paused"): return margelo::nitro::nitroposeexercises::SessionStatus::PAUSED;
+        case hashString("completed"): return margelo::nitro::nitroposeexercises::SessionStatus::COMPLETED;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum SessionStatus - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::nitroposeexercises::SessionStatus arg) {
+      switch (arg) {
+        case margelo::nitro::nitroposeexercises::SessionStatus::IDLE: return JSIConverter<std::string>::toJSI(runtime, "idle");
+        case margelo::nitro::nitroposeexercises::SessionStatus::COUNTDOWN: return JSIConverter<std::string>::toJSI(runtime, "countdown");
+        case margelo::nitro::nitroposeexercises::SessionStatus::ACTIVE: return JSIConverter<std::string>::toJSI(runtime, "active");
+        case margelo::nitro::nitroposeexercises::SessionStatus::PAUSED: return JSIConverter<std::string>::toJSI(runtime, "paused");
+        case margelo::nitro::nitroposeexercises::SessionStatus::COMPLETED: return JSIConverter<std::string>::toJSI(runtime, "completed");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert SessionStatus to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("idle"):
+        case hashString("countdown"):
+        case hashString("active"):
+        case hashString("paused"):
+        case hashString("completed"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -0,0 +1,187 @@
+{
+  "name": "react-native-nitro-pose-exercises",
+  "version": "1.0.2",
+  "description": "Real-time on-device exercise tracking for React Native. Rep counting, form validation, and skeleton overlay powered by MediaPipe Pose Landmarker and VisionCamera v5 via Nitro Modules.",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "nitrogen",
+    "nitro.json",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-nitro-pose-exercises-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "nitrogen": "nitrogen",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version",
+    "web": "vite",
+    "build:web": "vite build"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Gautham495/react-native-nitro-pose-exercises.git"
+  },
+  "author": "Gautham495 <kinggautham495@gmail.com> (https://github.com/Gautham495)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Gautham495/react-native-nitro-pose-exercises/issues"
+  },
+  "homepage": "https://github.com/Gautham495/react-native-nitro-pose-exercises#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^20.5.0",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@jest/globals": "^30.0.0",
+    "@react-native/babel-preset": "0.85.0",
+    "@react-native/eslint-config": "0.85.0",
+    "@react-native/jest-preset": "0.85.0",
+    "@release-it/conventional-changelog": "^10.0.6",
+    "@types/react": "^19.2.0",
+    "commitlint": "^20.5.0",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^30.3.0",
+    "lefthook": "^2.1.4",
+    "nitrogen": "^0.35.7",
+    "prettier": "^3.8.1",
+    "react": "19.2.3",
+    "react-native": "0.85.0",
+    "react-native-builder-bob": "^0.41.0",
+    "react-native-nitro-modules": "^0.35.7",
+    "react-native-svg": "^15.15.5",
+    "react-native-vision-camera": "^5.0.10",
+    "react-native-vision-camera-worklets": "^5.0.10",
+    "react-native-worklets": "^0.8.3",
+    "release-it": "^19.2.4",
+    "turbo": "^2.8.21",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "*",
+    "react-native-reanimated": "*",
+    "react-native-vision-camera": "*",
+    "react-native-vision-camera-worklets": "*",
+    "react-native-worklets": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "custom",
+        {
+          "script": "nitrogen",
+          "clean": "nitrogen/"
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "@react-native/jest-preset",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "nitro-module",
+    "languages": "kotlin-swift",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it",
+      "vite"
+    ],
+    "version": "0.62.0"
+  }
+}

package/src/NitroPoseExercises.nitro.ts

@@ -0,0 +1,155 @@
+import { type HybridObject, NitroModules } from 'react-native-nitro-modules';
+
+import { type Frame } from 'react-native-vision-camera';
+
+// ─── Enums & Types ───────────────────────────────────────────
+
+type ExerciseType = 'rep' | 'hold' | 'flow';
+
+type ExercisePhase = 'up' | 'down' | 'hold' | 'transition' | 'unknown';
+
+type FormSeverity = 'info' | 'warning' | 'error';
+
+type SessionStatus = 'idle' | 'countdown' | 'active' | 'paused' | 'completed';
+
+// ─── Landmark ────────────────────────────────────────────────
+
+interface Landmark {
+  x: number;
+  y: number;
+  z: number;
+  visibility: number;
+}
+
+// ─── Exercise Config (passed from JS) ────────────────────────
+
+interface AngleDefinition {
+  name: string;
+  landmarkA: number; // landmark index (0-32)
+  landmarkB: number; // vertex of the angle
+  landmarkC: number;
+}
+
+interface PhaseThreshold {
+  phase: ExercisePhase;
+  angleName: string;
+  minAngle: number;
+  maxAngle: number;
+}
+
+interface FormRule {
+  name: string;
+  message: string;
+  severity: FormSeverity;
+  angleName: string;
+  minAngle: number;
+  maxAngle: number;
+}
+
+interface ExerciseConfig {
+  name: string;
+  type: ExerciseType;
+  angles: AngleDefinition[];
+  phases: PhaseThreshold[];
+  repSequence: ExercisePhase[]; // e.g. ['up', 'down', 'up'] for a push-up rep
+  formRules: FormRule[];
+  holdDurationMs: number; // for hold-based exercises
+}
+
+// ─── Callback Payloads ───────────────────────────────────────
+
+interface RepData {
+  repNumber: number;
+  durationMs: number;
+  formScore: number; // 0-100
+  angles: AngleSnapshot[];
+}
+
+interface AngleSnapshot {
+  name: string;
+  value: number;
+}
+
+interface FormFeedback {
+  ruleName: string;
+  message: string;
+  severity: FormSeverity;
+}
+
+interface HoldProgress {
+  elapsedMs: number;
+  targetMs: number;
+  stability: number; // 0-100, how steady they are
+}
+
+interface SessionResult {
+  totalReps: number;
+  totalDurationMs: number;
+  averageRepDurationMs: number;
+  averageFormScore: number;
+  formViolations: FormFeedback[];
+  angleHistory: AngleSnapshot[]; // min/max per angle
+}
+
+// ─── The HybridObject ────────────────────────────────────────
+
+interface NitroPoseExercises extends HybridObject<{
+  ios: 'swift';
+  android: 'kotlin';
+}> {
+  // Lifecycle
+  initialize(modelPath: string): Promise<void>;
+  release(): void;
+
+  // Exercise setup
+  loadExercise(config: ExerciseConfig): void;
+
+  // Session control
+  readonly status: SessionStatus;
+
+  // Process a VisionCamera frame — called from frame processor worklet
+  processFrame(frame: Frame): void;
+
+  // Callbacks (set from JS side)
+  onRepComplete: ((data: RepData) => void) | undefined;
+  onPhaseChange: ((phase: ExercisePhase) => void) | undefined;
+  onFormFeedback: ((feedback: FormFeedback) => void) | undefined;
+  onHoldProgress: ((progress: HoldProgress) => void) | undefined;
+  onPoseLost: (() => void) | undefined;
+  onPoseRegained: (() => void) | undefined;
+  onSessionComplete: ((result: SessionResult) => void) | undefined;
+
+  // State (readable from JS for UI)
+  readonly currentPhase: ExercisePhase;
+  readonly repCount: number;
+  readonly landmarks: Landmark[];
+
+  // Session control
+  startSession(targetReps: number, countdownSeconds: number): void;
+  pauseSession(): void;
+  resumeSession(): void;
+  stopSession(): void;
+}
+
+const nitroPoseExercises =
+  NitroModules.createHybridObject<NitroPoseExercises>('PoseExercise');
+
+export { nitroPoseExercises };
+
+export type {
+  NitroPoseExercises,
+  ExerciseConfig,
+  ExerciseType,
+  ExercisePhase,
+  FormSeverity,
+  SessionStatus,
+  Landmark,
+  AngleDefinition,
+  PhaseThreshold,
+  FormRule,
+  RepData,
+  AngleSnapshot,
+  FormFeedback,
+  HoldProgress,
+  SessionResult,
+};