react-native-nitro-pose-exercises 1.1.6 → 1.1.8

package/nitrogen/generated/ios/swift/HybridNitroPoseExercisesSpec_cxx.swift

@@ -353,6 +353,70 @@ open class HybridNitroPoseExercisesSpec_cxx {
     }
   }
   
+  public final var onPostureLost: bridge.std__optional_std__function_void____ {
+    @inline(__always)
+    get {
+      return { () -> bridge.std__optional_std__function_void____ in
+        if let __unwrappedValue = self.__implementation.onPostureLost {
+          return bridge.create_std__optional_std__function_void____({ () -> bridge.Func_void in
+            let __closureWrapper = Func_void(__unwrappedValue)
+            return bridge.create_Func_void(__closureWrapper.toUnsafe())
+          }())
+        } else {
+          return .init()
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__implementation.onPostureLost = { () -> (() -> Void)? in
+        if bridge.has_value_std__optional_std__function_void____(newValue) {
+          let __unwrapped = bridge.get_std__optional_std__function_void____(newValue)
+          return { () -> () -> Void in
+            let __wrappedFunction = bridge.wrap_Func_void(__unwrapped)
+            return { () -> Void in
+              __wrappedFunction.call()
+            }
+          }()
+        } else {
+          return nil
+        }
+      }()
+    }
+  }
+  
+  public final var onPostureRegained: bridge.std__optional_std__function_void____ {
+    @inline(__always)
+    get {
+      return { () -> bridge.std__optional_std__function_void____ in
+        if let __unwrappedValue = self.__implementation.onPostureRegained {
+          return bridge.create_std__optional_std__function_void____({ () -> bridge.Func_void in
+            let __closureWrapper = Func_void(__unwrappedValue)
+            return bridge.create_Func_void(__closureWrapper.toUnsafe())
+          }())
+        } else {
+          return .init()
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__implementation.onPostureRegained = { () -> (() -> Void)? in
+        if bridge.has_value_std__optional_std__function_void____(newValue) {
+          let __unwrapped = bridge.get_std__optional_std__function_void____(newValue)
+          return { () -> () -> Void in
+            let __wrappedFunction = bridge.wrap_Func_void(__unwrapped)
+            return { () -> Void in
+              __wrappedFunction.call()
+            }
+          }()
+        } else {
+          return nil
+        }
+      }()
+    }
+  }
+  
   public final var currentPhase: Int32 {
     @inline(__always)
     get {
@@ -480,4 +544,16 @@ open class HybridNitroPoseExercisesSpec_cxx {
       return bridge.create_Result_void_(__exceptionPtr)
     }
   }
+  
+  @inline(__always)
+  public final func isReady() -> bridge.Result_bool_ {
+    do {
+      let __result = try self.__implementation.isReady()
+      let __resultCpp = __result
+      return bridge.create_Result_bool_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_bool_(__exceptionPtr)
+    }
+  }
 }

package/nitrogen/generated/ios/swift/PostureFamily.swift

@@ -0,0 +1,60 @@
+///
+/// PostureFamily.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+/**
+ * Represents the JS union `PostureFamily`, backed by a C++ enum.
+ */
+public typealias PostureFamily = margelo.nitro.nitroposeexercises.PostureFamily
+
+public extension PostureFamily {
+  /**
+   * Get a PostureFamily for the given String value, or
+   * return `nil` if the given value was invalid/unknown.
+   */
+  init?(fromString string: String) {
+    switch string {
+      case "horizontalProne":
+        self = .horizontalprone
+      case "standingUpright":
+        self = .standingupright
+      case "seated":
+        self = .seated
+      case "inverted":
+        self = .inverted
+      case "sidePlank":
+        self = .sideplank
+      case "supine":
+        self = .supine
+      case "none":
+        self = .none
+      default:
+        return nil
+    }
+  }
+
+  /**
+   * Get the String value this PostureFamily represents.
+   */
+  var stringValue: String {
+    switch self {
+      case .horizontalprone:
+        return "horizontalProne"
+      case .standingupright:
+        return "standingUpright"
+      case .seated:
+        return "seated"
+      case .inverted:
+        return "inverted"
+      case .sideplank:
+        return "sidePlank"
+      case .supine:
+        return "supine"
+      case .none:
+        return "none"
+    }
+  }
+}

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

@@ -0,0 +1,76 @@
+///
+/// CameraAngleType.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 (CameraAngleType).
+   */
+  enum class CameraAngleType {
+    SIDE      SWIFT_NAME(side) = 0,
+    FRONT      SWIFT_NAME(front) = 1,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::nitroposeexercises
+
+namespace margelo::nitro {
+
+  // C++ CameraAngleType <> JS CameraAngleType (union)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroposeexercises::CameraAngleType> final {
+    static inline margelo::nitro::nitroposeexercises::CameraAngleType 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("side"): return margelo::nitro::nitroposeexercises::CameraAngleType::SIDE;
+        case hashString("front"): return margelo::nitro::nitroposeexercises::CameraAngleType::FRONT;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum CameraAngleType - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::nitroposeexercises::CameraAngleType arg) {
+      switch (arg) {
+        case margelo::nitro::nitroposeexercises::CameraAngleType::SIDE: return JSIConverter<std::string>::toJSI(runtime, "side");
+        case margelo::nitro::nitroposeexercises::CameraAngleType::FRONT: return JSIConverter<std::string>::toJSI(runtime, "front");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert CameraAngleType 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("side"):
+        case hashString("front"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -38,6 +38,10 @@ namespace margelo::nitro::nitroposeexercises { struct PhaseThreshold; }
 namespace margelo::nitro::nitroposeexercises { enum class ExercisePhase; }
 // Forward declaration of `FormRule` to properly resolve imports.
 namespace margelo::nitro::nitroposeexercises { struct FormRule; }
+// Forward declaration of `PostureFamily` to properly resolve imports.
+namespace margelo::nitro::nitroposeexercises { enum class PostureFamily; }
+// Forward declaration of `CameraAngleType` to properly resolve imports.
+namespace margelo::nitro::nitroposeexercises { enum class CameraAngleType; }
 
 #include <string>
 #include "ExerciseType.hpp"
@@ -46,6 +50,8 @@ namespace margelo::nitro::nitroposeexercises { struct FormRule; }
 #include "PhaseThreshold.hpp"
 #include "ExercisePhase.hpp"
 #include "FormRule.hpp"
+#include "PostureFamily.hpp"
+#include "CameraAngleType.hpp"
 
 namespace margelo::nitro::nitroposeexercises {
 
@@ -61,10 +67,13 @@ namespace margelo::nitro::nitroposeexercises {
     std::vector<ExercisePhase> repSequence     SWIFT_PRIVATE;
     std::vector<FormRule> formRules     SWIFT_PRIVATE;
     double holdDurationMs     SWIFT_PRIVATE;
+    PostureFamily postureFamily     SWIFT_PRIVATE;
+    double visibilityThreshold     SWIFT_PRIVATE;
+    CameraAngleType cameraAngle     SWIFT_PRIVATE;
 
   public:
     ExerciseConfig() = default;
-    explicit ExerciseConfig(std::string name, ExerciseType type, std::vector<AngleDefinition> angles, std::vector<PhaseThreshold> phases, std::vector<ExercisePhase> repSequence, std::vector<FormRule> formRules, double holdDurationMs): name(name), type(type), angles(angles), phases(phases), repSequence(repSequence), formRules(formRules), holdDurationMs(holdDurationMs) {}
+    explicit ExerciseConfig(std::string name, ExerciseType type, std::vector<AngleDefinition> angles, std::vector<PhaseThreshold> phases, std::vector<ExercisePhase> repSequence, std::vector<FormRule> formRules, double holdDurationMs, PostureFamily postureFamily, double visibilityThreshold, CameraAngleType cameraAngle): name(name), type(type), angles(angles), phases(phases), repSequence(repSequence), formRules(formRules), holdDurationMs(holdDurationMs), postureFamily(postureFamily), visibilityThreshold(visibilityThreshold), cameraAngle(cameraAngle) {}
 
   public:
     friend bool operator==(const ExerciseConfig& lhs, const ExerciseConfig& rhs) = default;
@@ -86,7 +95,10 @@ namespace margelo::nitro {
         JSIConverter<std::vector<margelo::nitro::nitroposeexercises::PhaseThreshold>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "phases"))),
         JSIConverter<std::vector<margelo::nitro::nitroposeexercises::ExercisePhase>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "repSequence"))),
         JSIConverter<std::vector<margelo::nitro::nitroposeexercises::FormRule>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "formRules"))),
-        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "holdDurationMs")))
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "holdDurationMs"))),
+        JSIConverter<margelo::nitro::nitroposeexercises::PostureFamily>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "postureFamily"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "visibilityThreshold"))),
+        JSIConverter<margelo::nitro::nitroposeexercises::CameraAngleType>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "cameraAngle")))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroposeexercises::ExerciseConfig& arg) {
@@ -98,6 +110,9 @@ namespace margelo::nitro {
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "repSequence"), JSIConverter<std::vector<margelo::nitro::nitroposeexercises::ExercisePhase>>::toJSI(runtime, arg.repSequence));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "formRules"), JSIConverter<std::vector<margelo::nitro::nitroposeexercises::FormRule>>::toJSI(runtime, arg.formRules));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "holdDurationMs"), JSIConverter<double>::toJSI(runtime, arg.holdDurationMs));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "postureFamily"), JSIConverter<margelo::nitro::nitroposeexercises::PostureFamily>::toJSI(runtime, arg.postureFamily));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "visibilityThreshold"), JSIConverter<double>::toJSI(runtime, arg.visibilityThreshold));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "cameraAngle"), JSIConverter<margelo::nitro::nitroposeexercises::CameraAngleType>::toJSI(runtime, arg.cameraAngle));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -115,6 +130,9 @@ namespace margelo::nitro {
       if (!JSIConverter<std::vector<margelo::nitro::nitroposeexercises::ExercisePhase>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "repSequence")))) return false;
       if (!JSIConverter<std::vector<margelo::nitro::nitroposeexercises::FormRule>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "formRules")))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "holdDurationMs")))) return false;
+      if (!JSIConverter<margelo::nitro::nitroposeexercises::PostureFamily>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "postureFamily")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "visibilityThreshold")))) return false;
+      if (!JSIConverter<margelo::nitro::nitroposeexercises::CameraAngleType>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "cameraAngle")))) return false;
       return true;
     }
   };

package/nitrogen/generated/shared/c++/HybridNitroPoseExercisesSpec.cpp

@@ -29,6 +29,10 @@ namespace margelo::nitro::nitroposeexercises {
       prototype.registerHybridSetter("onPoseRegained", &HybridNitroPoseExercisesSpec::setOnPoseRegained);
       prototype.registerHybridGetter("onSessionComplete", &HybridNitroPoseExercisesSpec::getOnSessionComplete);
       prototype.registerHybridSetter("onSessionComplete", &HybridNitroPoseExercisesSpec::setOnSessionComplete);
+      prototype.registerHybridGetter("onPostureLost", &HybridNitroPoseExercisesSpec::getOnPostureLost);
+      prototype.registerHybridSetter("onPostureLost", &HybridNitroPoseExercisesSpec::setOnPostureLost);
+      prototype.registerHybridGetter("onPostureRegained", &HybridNitroPoseExercisesSpec::getOnPostureRegained);
+      prototype.registerHybridSetter("onPostureRegained", &HybridNitroPoseExercisesSpec::setOnPostureRegained);
       prototype.registerHybridGetter("currentPhase", &HybridNitroPoseExercisesSpec::getCurrentPhase);
       prototype.registerHybridGetter("repCount", &HybridNitroPoseExercisesSpec::getRepCount);
       prototype.registerHybridGetter("landmarks", &HybridNitroPoseExercisesSpec::getLandmarks);
@@ -40,6 +44,7 @@ namespace margelo::nitro::nitroposeexercises {
       prototype.registerHybridMethod("pauseSession", &HybridNitroPoseExercisesSpec::pauseSession);
       prototype.registerHybridMethod("resumeSession", &HybridNitroPoseExercisesSpec::resumeSession);
       prototype.registerHybridMethod("stopSession", &HybridNitroPoseExercisesSpec::stopSession);
+      prototype.registerHybridMethod("isReady", &HybridNitroPoseExercisesSpec::isReady);
     });
   }
 

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

@@ -90,6 +90,10 @@ namespace margelo::nitro::nitroposeexercises {
       virtual void setOnPoseRegained(const std::optional<std::function<void()>>& onPoseRegained) = 0;
       virtual std::optional<std::function<void(const SessionResult& /* result */)>> getOnSessionComplete() = 0;
       virtual void setOnSessionComplete(const std::optional<std::function<void(const SessionResult& /* result */)>>& onSessionComplete) = 0;
+      virtual std::optional<std::function<void()>> getOnPostureLost() = 0;
+      virtual void setOnPostureLost(const std::optional<std::function<void()>>& onPostureLost) = 0;
+      virtual std::optional<std::function<void()>> getOnPostureRegained() = 0;
+      virtual void setOnPostureRegained(const std::optional<std::function<void()>>& onPostureRegained) = 0;
       virtual ExercisePhase getCurrentPhase() = 0;
       virtual double getRepCount() = 0;
       virtual std::vector<Landmark> getLandmarks() = 0;
@@ -104,6 +108,7 @@ namespace margelo::nitro::nitroposeexercises {
       virtual void pauseSession() = 0;
       virtual void resumeSession() = 0;
       virtual void stopSession() = 0;
+      virtual bool isReady() = 0;
 
     protected:
       // Hybrid Setup

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

@@ -0,0 +1,96 @@
+///
+/// PostureFamily.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 (PostureFamily).
+   */
+  enum class PostureFamily {
+    HORIZONTALPRONE      SWIFT_NAME(horizontalprone) = 0,
+    STANDINGUPRIGHT      SWIFT_NAME(standingupright) = 1,
+    SEATED      SWIFT_NAME(seated) = 2,
+    INVERTED      SWIFT_NAME(inverted) = 3,
+    SIDEPLANK      SWIFT_NAME(sideplank) = 4,
+    SUPINE      SWIFT_NAME(supine) = 5,
+    NONE      SWIFT_NAME(none) = 6,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::nitroposeexercises
+
+namespace margelo::nitro {
+
+  // C++ PostureFamily <> JS PostureFamily (union)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroposeexercises::PostureFamily> final {
+    static inline margelo::nitro::nitroposeexercises::PostureFamily 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("horizontalProne"): return margelo::nitro::nitroposeexercises::PostureFamily::HORIZONTALPRONE;
+        case hashString("standingUpright"): return margelo::nitro::nitroposeexercises::PostureFamily::STANDINGUPRIGHT;
+        case hashString("seated"): return margelo::nitro::nitroposeexercises::PostureFamily::SEATED;
+        case hashString("inverted"): return margelo::nitro::nitroposeexercises::PostureFamily::INVERTED;
+        case hashString("sidePlank"): return margelo::nitro::nitroposeexercises::PostureFamily::SIDEPLANK;
+        case hashString("supine"): return margelo::nitro::nitroposeexercises::PostureFamily::SUPINE;
+        case hashString("none"): return margelo::nitro::nitroposeexercises::PostureFamily::NONE;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum PostureFamily - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::nitroposeexercises::PostureFamily arg) {
+      switch (arg) {
+        case margelo::nitro::nitroposeexercises::PostureFamily::HORIZONTALPRONE: return JSIConverter<std::string>::toJSI(runtime, "horizontalProne");
+        case margelo::nitro::nitroposeexercises::PostureFamily::STANDINGUPRIGHT: return JSIConverter<std::string>::toJSI(runtime, "standingUpright");
+        case margelo::nitro::nitroposeexercises::PostureFamily::SEATED: return JSIConverter<std::string>::toJSI(runtime, "seated");
+        case margelo::nitro::nitroposeexercises::PostureFamily::INVERTED: return JSIConverter<std::string>::toJSI(runtime, "inverted");
+        case margelo::nitro::nitroposeexercises::PostureFamily::SIDEPLANK: return JSIConverter<std::string>::toJSI(runtime, "sidePlank");
+        case margelo::nitro::nitroposeexercises::PostureFamily::SUPINE: return JSIConverter<std::string>::toJSI(runtime, "supine");
+        case margelo::nitro::nitroposeexercises::PostureFamily::NONE: return JSIConverter<std::string>::toJSI(runtime, "none");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert PostureFamily 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("horizontalProne"):
+        case hashString("standingUpright"):
+        case hashString("seated"):
+        case hashString("inverted"):
+        case hashString("sidePlank"):
+        case hashString("supine"):
+        case hashString("none"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-pose-exercises",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "Real-time on-device exercise tracking for React Native. Rep counting, form validation, and skeleton overlay powered by Apple Vision (iOS) and Google ML Kit (Android) with VisionCamera v5 via Nitro Modules.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/NitroPoseExercises.nitro.ts

@@ -12,6 +12,17 @@ type FormSeverity = 'info' | 'warning' | 'error';
 
 type SessionStatus = 'idle' | 'countdown' | 'active' | 'paused' | 'completed';
 
+type CameraAngleType = 'side' | 'front';
+
+type PostureFamily =
+  | 'horizontalProne'
+  | 'standingUpright'
+  | 'seated'
+  | 'inverted'
+  | 'sidePlank'
+  | 'supine'
+  | 'none';
+
 // ─── Landmark ────────────────────────────────────────────────
 
 interface Landmark {
@@ -54,6 +65,9 @@ interface ExerciseConfig {
   repSequence: ExercisePhase[]; // e.g. ['up', 'down', 'up'] for a push-up rep
   formRules: FormRule[];
   holdDurationMs: number; // for hold-based exercises
+  postureFamily: PostureFamily; // ← new
+  visibilityThreshold: number; // ← new, 0.0–1.0; suggested 0.3
+  cameraAngle: CameraAngleType; // 'side' | 'front';
 }
 
 // ─── Callback Payloads ───────────────────────────────────────
@@ -118,6 +132,8 @@ interface NitroPoseExercises extends HybridObject<{
   onPoseLost: (() => void) | undefined;
   onPoseRegained: (() => void) | undefined;
   onSessionComplete: ((result: SessionResult) => void) | undefined;
+  onPostureLost: (() => void) | undefined;
+  onPostureRegained: (() => void) | undefined;
 
   // State (readable from JS for UI)
   readonly currentPhase: ExercisePhase;
@@ -129,6 +145,8 @@ interface NitroPoseExercises extends HybridObject<{
   pauseSession(): void;
   resumeSession(): void;
   stopSession(): void;
+
+  isReady(): boolean;
 }
 
 const nitroPoseExercises =
@@ -152,4 +170,5 @@ export type {
   FormFeedback,
   HoldProgress,
   SessionResult,
+  PostureFamily,
 };

package/src/config/bicep-curl.ts

@@ -7,6 +7,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const BICEP_CURL_CONFIG: ExerciseConfig = {
   name: 'Bicep Curl',
   type: 'rep',
+  postureFamily: 'standingUpright',
+  visibilityThreshold: 0.2,
+  cameraAngle: 'front',
   angles: [
     {
       name: 'leftElbow',

package/src/config/boat-pose.ts

@@ -3,6 +3,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const BOAT_POSE_CONFIG: ExerciseConfig = {
   name: 'Boat Pose (Navasana)',
   type: 'hold',
+  postureFamily: 'seated',
+  visibilityThreshold: 0.3,
+  cameraAngle: 'side',
   angles: [
     { name: 'hipFlexion', landmarkA: 11, landmarkB: 23, landmarkC: 25 },
     { name: 'kneeAngle', landmarkA: 23, landmarkB: 25, landmarkC: 27 },

package/src/config/bow-pose.ts

@@ -2,6 +2,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const BOW_POSE_CONFIG: ExerciseConfig = {
   name: 'Bow Pose (Dhanurasana)',
   type: 'hold',
+  postureFamily: 'horizontalProne',
+  visibilityThreshold: 0.25,
+  cameraAngle: 'side',
   angles: [
     { name: 'kneeAngle', landmarkA: 23, landmarkB: 25, landmarkC: 27 },
     { name: 'shoulderExtension', landmarkA: 23, landmarkB: 11, landmarkC: 15 },

package/src/config/bridge-pose.ts

@@ -3,6 +3,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const BRIDGE_POSE_CONFIG: ExerciseConfig = {
   name: 'Bridge Pose (Setu Bandhasana)',
   type: 'hold',
+  postureFamily: 'supine',
+  visibilityThreshold: 0.3,
+  cameraAngle: 'side',
   angles: [
     { name: 'hipExtension', landmarkA: 11, landmarkB: 23, landmarkC: 25 },
     { name: 'kneeAngle', landmarkA: 23, landmarkB: 25, landmarkC: 27 },

package/src/config/calf-raise.ts

@@ -3,6 +3,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const CALF_RAISE_CONFIG: ExerciseConfig = {
   name: 'Calf Raise',
   type: 'rep',
+  postureFamily: 'standingUpright',
+  visibilityThreshold: 0.2,
+  cameraAngle: 'front',
   angles: [
     { name: 'leftAnkle', landmarkA: 25, landmarkB: 27, landmarkC: 31 },
     { name: 'rightAnkle', landmarkA: 26, landmarkB: 28, landmarkC: 32 },

package/src/config/camel-pose.ts

@@ -2,6 +2,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const CAMEL_POSE_CONFIG: ExerciseConfig = {
   name: 'Camel Pose (Ustrasana)',
   type: 'hold',
+  postureFamily: 'seated',
+  visibilityThreshold: 0.3,
+  cameraAngle: 'side',
   angles: [
     { name: 'hipExtension', landmarkA: 11, landmarkB: 23, landmarkC: 25 },
     { name: 'kneeAngle', landmarkA: 23, landmarkB: 25, landmarkC: 27 },

package/src/config/chair-pose.ts

@@ -8,6 +8,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const CHAIR_POSE_CONFIG: ExerciseConfig = {
   name: 'Chair Pose (Utkatasana)',
   type: 'hold',
+  postureFamily: 'standingUpright',
+  visibilityThreshold: 0.4,
+  cameraAngle: 'side',
   angles: [
     {
       name: 'leftKnee',

package/src/config/childs-pose.ts

@@ -2,6 +2,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const CHILDS_POSE_CONFIG: ExerciseConfig = {
   name: "Child's Pose (Balasana)",
   type: 'hold',
+  postureFamily: 'seated',
+  visibilityThreshold: 0.3,
+  cameraAngle: 'side',
   angles: [
     { name: 'hipFold', landmarkA: 11, landmarkB: 23, landmarkC: 25 },
     { name: 'kneeAngle', landmarkA: 23, landmarkB: 25, landmarkC: 27 },

package/src/config/cobra-pose.ts

@@ -8,6 +8,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const COBRA_POSE_CONFIG: ExerciseConfig = {
   name: 'Cobra Pose (Bhujangasana)',
   type: 'hold',
+  postureFamily: 'horizontalProne',
+  visibilityThreshold: 0.25,
+  cameraAngle: 'side',
   angles: [
     {
       name: 'leftElbow',

package/src/config/cobra-wings.ts

@@ -2,6 +2,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const COBRA_WINGS_CONFIG: ExerciseConfig = {
   name: 'Cobra Wings',
   type: 'rep',
+  postureFamily: 'horizontalProne',
+  visibilityThreshold: 0.25,
+  cameraAngle: 'side',
   angles: [
     { name: 'hipExtension', landmarkA: 11, landmarkB: 23, landmarkC: 25 },
     { name: 'leftShoulder', landmarkA: 23, landmarkB: 11, landmarkC: 13 },

package/src/config/dead-lift.ts

@@ -3,6 +3,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const DEADLIFT_CONFIG: ExerciseConfig = {
   name: 'Deadlift',
   type: 'rep',
+  postureFamily: 'standingUpright',
+  visibilityThreshold: 0.3,
+  cameraAngle: 'side',
   angles: [
     { name: 'leftHip', landmarkA: 11, landmarkB: 23, landmarkC: 25 },
     { name: 'rightHip', landmarkA: 12, landmarkB: 24, landmarkC: 26 },

package/src/config/downward-dog.ts

@@ -9,6 +9,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const DOWNWARD_DOG_CONFIG: ExerciseConfig = {
   name: 'Downward Dog (Adho Mukha Svanasana)',
   type: 'hold',
+  postureFamily: 'inverted',
+  visibilityThreshold: 0.3,
+  cameraAngle: 'side',
   angles: [
     {
       name: 'hipAngle',

package/src/config/extended-side-angle.ts

@@ -2,6 +2,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const EXTENDED_SIDE_ANGLE_CONFIG: ExerciseConfig = {
   name: 'Extended Side Angle (Utthita Parsvakonasana)',
   type: 'hold',
+  postureFamily: 'standingUpright',
+  visibilityThreshold: 0.4,
+  cameraAngle: 'front',
   angles: [
     { name: 'frontKnee', landmarkA: 23, landmarkB: 25, landmarkC: 27 },
     { name: 'backLeg', landmarkA: 24, landmarkB: 26, landmarkC: 28 },

package/src/config/fish-pose.ts

@@ -3,6 +3,9 @@ import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
 export const FISH_POSE_CONFIG: ExerciseConfig = {
   name: 'Fish Pose (Matsyasana)',
   type: 'hold',
+  postureFamily: 'supine',
+  visibilityThreshold: 0.3,
+  cameraAngle: 'side',
   angles: [
     { name: 'chestOpen', landmarkA: 11, landmarkB: 23, landmarkC: 25 },
     { name: 'legs', landmarkA: 23, landmarkB: 25, landmarkC: 27 },

package/src/config/front-raise.ts

@@ -1,7 +1,11 @@
 import type { ExerciseConfig } from '../NitroPoseExercises.nitro';
+
 export const FRONT_RAISE_CONFIG: ExerciseConfig = {
   name: 'Front Raise',
   type: 'rep',
+  postureFamily: 'standingUpright',
+  visibilityThreshold: 0.2,
+  cameraAngle: 'side',
   angles: [
     {
       name: 'leftShoulderFlexion',