@pose-tracker/react-native-pose-estimation-light 0.3.2 → 0.3.3

package/README.md

@@ -36,10 +36,10 @@ package stays tiny.
 download at session start.  
 **Choose light** when app install / OTA size matters and devices are online.
 
-Full comparison: [LIGHT_SDK.md](docs/LIGHT_SDK.md).
+Full comparison: [LIGHT_SDK.md](../../docs/LIGHT_SDK.md).
 
 **Agents:** shared UX/API/bugfixes → mirror to offline (or ask first). See
-[`DUAL_SDK_CHANGES.md`](docs/DUAL_SDK_CHANGES.md).
+[`DUAL_SDK_CHANGES.md`](../../docs/DUAL_SDK_CHANGES.md).
 
 ## Install
 
@@ -54,10 +54,10 @@ npx expo install react-native-webview expo-camera
 > **Offline sibling:** [`@pose-tracker/react-native-pose-estimation`](https://www.npmjs.com/package/@pose-tracker/react-native-pose-estimation)
 
 **Required:** host app must declare camera permissions — see
-[PERMISSIONS.md](docs/PERMISSIONS.md).
+[PERMISSIONS.md](../../docs/PERMISSIONS.md).
 
 **Media inputs (v0.2):** camera (default), uploaded video, still image — host
-picks the file. See [MEDIA_SOURCES.md](docs/MEDIA_SOURCES.md) and
+picks the file. See [MEDIA_SOURCES.md](../../docs/MEDIA_SOURCES.md) and
 https://docs.posetracker.com/media-sources.
 
 ## Quick start (keypoints — needs network, no API key)
@@ -144,11 +144,11 @@ Same contract as the offline SDK / web tracking URL:
 
 | Doc | Topic |
 |-----|--------|
-| [LIGHT_SDK.md](docs/LIGHT_SDK.md) | Offline vs light, sizes, model URL |
-| [PERMISSIONS.md](docs/PERMISSIONS.md) | Camera permission setup (required) |
-| [PRELOAD.md](docs/PRELOAD.md) | Preload / warm-up / lifecycle |
-| [FEATURES.md](docs/FEATURES.md) | Plan gating, watermark, loading text |
-| [EVENTS.md](docs/EVENTS.md) | Typed events + classic `onMessage` |
+| [LIGHT_SDK.md](../../docs/LIGHT_SDK.md) | Offline vs light, sizes, model URL |
+| [PERMISSIONS.md](../../docs/PERMISSIONS.md) | Camera permission setup (required) |
+| [PRELOAD.md](../../docs/PRELOAD.md) | Preload / warm-up / lifecycle |
+| [FEATURES.md](../../docs/FEATURES.md) | Plan gating, watermark, loading text |
+| [EVENTS.md](../../docs/EVENTS.md) | Typed events + classic `onMessage` |
 
 ## FAQ
 

package/lib/engineChannel.d.ts

@@ -8,7 +8,7 @@
  */
 export type EngineChannel = 'v3' | 'v4';
 /** Wellness ids with no V3 FSM. */
-export declare const V4_ONLY_EXERCISE_IDS: readonly ["shoulder_roll", "shoulder_deep_breath", "chair_forward_fold", "chair_side_stretch"];
+export declare const V4_ONLY_EXERCISE_IDS: readonly ["shoulder_roll", "shoulder_deep_breath", "chair_forward_fold", "chair_side_stretch", "back_flexibility_test"];
 /** Existing jump handlers — not V4 JSON. */
 export declare const JUMP_EXERCISE_IDS: readonly ["jump_analysis", "air_time_jump"];
 export declare const PRODUCTION_SQUAT_IDS: readonly ["squat", "face_squat"];

package/lib/engineChannel.js

@@ -12,6 +12,7 @@ exports.V4_ONLY_EXERCISE_IDS = [
     'shoulder_deep_breath',
     'chair_forward_fold',
     'chair_side_stretch',
+    'back_flexibility_test',
 ];
 /** Existing jump handlers — not V4 JSON. */
 exports.JUMP_EXERCISE_IDS = ['jump_analysis', 'air_time_jump'];

package/lib/events/classicMessage.js

@@ -116,6 +116,7 @@ function toClassicNativeMessage(event) {
                 ...(event.referenceScore != null
                     ? { reference_score: { overallScore: event.referenceScore } }
                     : {}),
+                ...(event.analysis != null ? { analysis: event.analysis } : {}),
                 timestampMs: event.timestampMs,
             };
         case 'posture':
@@ -160,6 +161,8 @@ function toClassicNativeMessage(event) {
                 grade: event.grade,
                 history: event.history,
                 durationMs: event.durationMs,
+                ...(event.disclaimer != null ? { disclaimer: event.disclaimer } : {}),
+                ...(event.method != null ? { method: event.method } : {}),
                 timestampMs: event.timestampMs,
             };
         // Custom jump exercises: the classic contract already uses these exact

package/lib/sdkVersion.d.ts

@@ -1,2 +1,2 @@
 /** AUTO-GENERATED by scripts/sync-sdk-version.mjs — do not edit. */
-export declare const SDK_VERSION = "0.3.2";
+export declare const SDK_VERSION = "0.3.3";

package/lib/sdkVersion.js

@@ -2,4 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
 /** AUTO-GENERATED by scripts/sync-sdk-version.mjs — do not edit. */
-exports.SDK_VERSION = '0.3.2';
+exports.SDK_VERSION = '0.3.3';

package/lib/types/events.d.ts

@@ -111,7 +111,7 @@ export interface AnglesEvent {
  * Letter grade for a 0–100 form score (GitBook / Front BaseExercise):
  * A ≥ 90, B ≥ 80, C ≥ 70, D ≥ 60, F < 60.
  */
-export type FormGrade = 'A' | 'B' | 'C' | 'D' | 'F';
+export type FormGrade = 'A' | 'B' | 'C' | 'D' | 'E' | 'F';
 /** Valid `minGrade` filter values (F is not a valid minGrade config). */
 export type MinGrade = 'A' | 'B' | 'C' | 'D';
 /**
@@ -125,6 +125,30 @@ export interface CounterFormScore {
     average: number;
     grade: FormGrade;
 }
+/**
+ * Per-rep report for a physical test (back flexibility). Present only when the
+ * movement declares `report`. Disclaimer stays in this object, not in `interpretation.text`.
+ */
+export interface MovementAnalysis {
+    opinion?: boolean;
+    method?: string;
+    disclaimer?: string;
+    peaks?: Record<string, number>;
+    camera?: {
+        placement?: string;
+        bias?: number;
+        ratio?: number;
+    };
+    ankle_above_sole?: number;
+    knee_locked?: boolean;
+    leg_straight?: boolean;
+    shank_vertical?: boolean;
+    interpretation?: {
+        tone: 'strong' | 'partial' | 'limited';
+        title: string;
+        text: string;
+    };
+}
 export interface CounterEvent {
     type: 'counter';
     count: number;
@@ -136,6 +160,8 @@ export interface CounterEvent {
     formScore?: CounterFormScore;
     /** Similarity score vs. reference movement for the last rep, when a reference is active. */
     referenceScore?: number;
+    /** Physical-test report: peaks, camera, flags, interpretation, disclaimer. */
+    analysis?: MovementAnalysis;
     timestampMs: number;
 }
 export interface PostureEvent {
@@ -209,6 +235,7 @@ export interface RepSummary {
     formScore: number;
     durationMs: number;
     referenceScore?: number;
+    analysis?: MovementAnalysis;
 }
 export interface ExerciseSummaryEvent {
     type: 'exercise_summary';
@@ -219,6 +246,9 @@ export interface ExerciseSummaryEvent {
     grade: FormGrade;
     history: RepSummary[];
     durationMs: number;
+    /** Set when the movement emits a report. Kept out of interpretation text. */
+    disclaimer?: string;
+    method?: string;
     timestampMs: number;
 }
 export interface VisibleHipsInfo {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pose-tracker/react-native-pose-estimation-light",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Human pose estimation SDK for React Native (light / online) — MoveNet Lightning via CDN + model URL each session, no bundled weights. iOS & Android (Expo Go). Optional API-key exercise engine.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/engineChannel.ts

@@ -14,6 +14,7 @@ export const V4_ONLY_EXERCISE_IDS = [
   'shoulder_deep_breath',
   'chair_forward_fold',
   'chair_side_stretch',
+  'back_flexibility_test',
 ] as const;
 
 /** Existing jump handlers — not V4 JSON. */

package/src/events/classicMessage.ts

@@ -129,6 +129,7 @@ export function toClassicNativeMessage(
         ...(event.referenceScore != null
           ? { reference_score: { overallScore: event.referenceScore } }
           : {}),
+        ...(event.analysis != null ? { analysis: event.analysis } : {}),
         timestampMs: event.timestampMs,
       };
     case 'posture':
@@ -173,6 +174,8 @@ export function toClassicNativeMessage(
         grade: event.grade,
         history: event.history,
         durationMs: event.durationMs,
+        ...(event.disclaimer != null ? { disclaimer: event.disclaimer } : {}),
+        ...(event.method != null ? { method: event.method } : {}),
         timestampMs: event.timestampMs,
       };
     // Custom jump exercises: the classic contract already uses these exact

package/src/sdkVersion.ts

@@ -1,2 +1,2 @@
 /** AUTO-GENERATED by scripts/sync-sdk-version.mjs — do not edit. */
-export const SDK_VERSION = '0.3.2';
+export const SDK_VERSION = '0.3.3';

package/src/types/events.ts

@@ -149,7 +149,7 @@ export interface AnglesEvent {
  * Letter grade for a 0–100 form score (GitBook / Front BaseExercise):
  * A ≥ 90, B ≥ 80, C ≥ 70, D ≥ 60, F < 60.
  */
-export type FormGrade = 'A' | 'B' | 'C' | 'D' | 'F';
+export type FormGrade = 'A' | 'B' | 'C' | 'D' | 'E' | 'F';
 
 /** Valid `minGrade` filter values (F is not a valid minGrade config). */
 export type MinGrade = 'A' | 'B' | 'C' | 'D';
@@ -166,6 +166,23 @@ export interface CounterFormScore {
   grade: FormGrade;
 }
 
+/**
+ * Per-rep report for a physical test (back flexibility). Present only when the
+ * movement declares `report`. Disclaimer stays in this object, not in `interpretation.text`.
+ */
+export interface MovementAnalysis {
+  opinion?: boolean;
+  method?: string;
+  disclaimer?: string;
+  peaks?: Record<string, number>;
+  camera?: { placement?: string; bias?: number; ratio?: number };
+  ankle_above_sole?: number;
+  knee_locked?: boolean;
+  leg_straight?: boolean;
+  shank_vertical?: boolean;
+  interpretation?: { tone: 'strong' | 'partial' | 'limited'; title: string; text: string };
+}
+
 export interface CounterEvent {
   type: 'counter';
   count: number;
@@ -177,6 +194,8 @@ export interface CounterEvent {
   formScore?: CounterFormScore;
   /** Similarity score vs. reference movement for the last rep, when a reference is active. */
   referenceScore?: number;
+  /** Physical-test report: peaks, camera, flags, interpretation, disclaimer. */
+  analysis?: MovementAnalysis;
   timestampMs: number;
 }
 
@@ -253,6 +272,7 @@ export interface RepSummary {
   formScore: number;
   durationMs: number;
   referenceScore?: number;
+  analysis?: MovementAnalysis;
 }
 
 export interface ExerciseSummaryEvent {
@@ -264,6 +284,9 @@ export interface ExerciseSummaryEvent {
   grade: FormGrade;
   history: RepSummary[];
   durationMs: number;
+  /** Set when the movement emits a report. Kept out of interpretation text. */
+  disclaimer?: string;
+  method?: string;
   timestampMs: number;
 }