@pose-tracker/pose-estimation-web 0.2.0 → 0.3.1

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as _tensorflow_tfjs from '@tensorflow/tfjs';
 
 /** Bumped with package.json version (keep in sync). */
-declare const SDK_VERSION = "0.2.0";
+declare const SDK_VERSION = "0.3.1";
 declare const SDK_NAME: "posetracker-web";
 
 /**
@@ -132,6 +132,8 @@ interface EngineBundleDescriptor {
     minSdkVersion: string;
     /** True when the version sent in `localVersions.engine` is already current. */
     upToDate?: boolean;
+    /** Which interpreter this descriptor is. Absent on older backends = v3. */
+    channel?: 'v3' | 'v4';
 }
 interface PoseRuntimePartDescriptor {
     /** Download URL of this part (`GET /api/sdk/pose-runtime?part=...&v=...`). */
@@ -172,6 +174,11 @@ interface ConfigureRequest {
         poseRuntime?: string | null;
         engine?: string | null;
     };
+    /**
+     * Which remote engine to download. New SDKs send `'v4'` by default.
+     * Omitted (0.2.x) still means V3 on the server. `'v3'` forces the FSM bundle.
+     */
+    engineChannel?: 'v3' | 'v4';
 }
 interface PlanInfo {
     plan: string;
@@ -202,6 +209,32 @@ interface SdkManifest {
     expiresAt: number;
 }
 
+/**
+ * Engine channel + production squat lock.
+ *
+ * Default handshake is V4 except unlabeled squat / face_squat (V3 FSM).
+ * Explicit `engine: 'v4'` is the only way to run the V4 catalog squat.
+ * Explicit `engine: 'v3'` keeps the full V3 bundle.
+ * See posetracker-rn-sdk/engine/v4/catalog/SQUAT_PRODUCTION.md
+ */
+type EngineChannel = 'v3' | 'v4';
+/** Movements that exist only in the V4 catalog (not in V3 FSM / Strapi). */
+declare const V4_ONLY_EXERCISE_IDS: readonly ["shoulder_roll", "shoulder_deep_breath", "chair_forward_fold", "chair_side_stretch"];
+declare const PRODUCTION_SQUAT_IDS: readonly ["squat", "face_squat"];
+declare function isProductionSquatId(exerciseId?: string | null): boolean;
+/** Handshake default is V4. Pass `'v3'` to force the V3 bundle. */
+declare function normalizeEngineChannel(raw?: string | null): EngineChannel;
+/**
+ * Session interpreter for this id. Production squat stays V3 unless `engine`
+ * is explicitly `'v4'`. Other ids follow the handshake (default V4).
+ */
+declare function resolveMovementEngine(opts?: {
+    engine?: string | null;
+    exercise?: string | null;
+    userExercise?: boolean;
+}): EngineChannel;
+declare function requiresEngineV4(exerciseId: string): boolean;
+
 /**
  * Handshake client: `configure(apiToken)` → Strapi `SdkManifest`.
  * Same endpoint as RN light; `targetPlatform: 'web'`, `sdkName: posetracker-web`.
@@ -213,6 +246,12 @@ interface ConfigureOptions {
     poseModelProfile?: PoseModelProfile;
     locale?: string;
     localVersions?: ConfigureRequest['localVersions'];
+    /**
+     * Remote engine channel. Default `'v4'`. Pass `'v3'` for the production FSM
+     * bundle. Unlabeled `startExercise('squat')` stays on the V3 squat FSM even
+     * on the V4 channel unless `engine` is explicitly `'v4'`.
+     */
+    engine?: EngineChannel;
 }
 declare class ConfigureError extends Error {
     readonly code: 'invalid_token' | 'quota_exceeded' | 'network' | 'internal';
@@ -679,6 +718,11 @@ interface EngineSessionOptions {
     minGrade?: MinGrade;
     /** Emission flags — engines older than 1.1.0 ignore them (client re-filters). */
     features?: EngineSessionFeatures;
+    /**
+     * Run the V4 catalog squat instead of the production V3 FSM.
+     * Set when the host passed `engine: 'v4'` explicitly.
+     */
+    v4CatalogSquat?: boolean;
 }
 interface EngineSession {
     /** Feed one estimated pose; the session emits events through the sink. */
@@ -716,6 +760,13 @@ interface PoseTrackerEngine {
     createSession(options: EngineSessionOptions, emit: EventSink): EngineSession;
     /** Engine >= 1.2.0: custom exercises shipped in the bundle (jump analysis…). */
     listCustomExercises?(): CustomExerciseDescriptor[];
+    /** Engine V4 catalog (opt-in channel). Absent on V3 bundles. */
+    listExercises?(): Array<{
+        id: string;
+        displayName: string;
+        type: string;
+        description?: string;
+    }>;
     /** Engine >= 1.2.0: start a custom exercise session (placement + jump_* events). */
     createCustomSession?(options: CustomSessionOptions, emit: EventSink): EngineSession;
 }
@@ -1008,6 +1059,12 @@ interface PoseTrackerClientOptions extends ConfigureOptions {
     /** Convenience with `source: 'video' | 'image'` (string / File / Blob). */
     sourceUrl?: string;
     sourceFile?: File | Blob;
+    /**
+     * Still-image inference. Default `single`: one full-frame SinglePose pass
+     * (no EMA / no ROI). `tracked`: treat analyze() as video frames — EMA +
+     * previous-pose crop so each shot can refine the last skeleton.
+     */
+    stillMode?: 'single' | 'tracked';
 }
 /** @deprecated Prefer PoseTrackerClientOptions — kept for vanilla DX. */
 type PoseTrackerOptions = PoseTrackerClientOptions;
@@ -1108,8 +1165,11 @@ declare class PoseTrackerClient {
     dispose(): Promise<void>;
     configure(apiToken?: string): Promise<boolean>;
     getAvailableExercises(): ExerciseConfig[];
+    getEngineChannel(): EngineChannel;
+    private v4ExerciseConfig;
     getAvailableCustomExercises(): CustomExerciseDescriptor[];
     startExercise(exerciseId: string, options?: StartExerciseOptions): void;
+    private beginEngineSession;
     private startCustomExercise;
     stopExercise(): void;
     getCurrentExerciseId(): string | null;
@@ -1161,6 +1221,9 @@ interface Letterbox {
     drawH: number;
     vw: number;
     vh: number;
+    /** Window top-left in original media pixels (still-image video simulation). */
+    originX?: number;
+    originY?: number;
 }
 interface DetectorFrameResult {
     /** Raw model output used for skeleton mapping (MoveNet: Float32Array length 51). */
@@ -1191,7 +1254,11 @@ interface PoseDetectorAdapter {
         facingMode: 'user' | 'environment';
         displayWidth: number;
         displayHeight: number;
+        /** EMA across frames. Default true. Stills may pass true to simulate a short clip. */
+        temporalSmooth?: boolean;
     }): Promise<DetectorFrameResult | null>;
+    /** Optional: clear temporal filters when the media source changes. */
+    resetTemporal?(): void;
     dispose(): void;
 }
 interface CreateAdapterContext {
@@ -1211,6 +1278,9 @@ declare class MoveNetGraphAdapter implements PoseDetectorAdapter {
     private offscreen;
     private offCtx;
     private smoothed;
+    private lastVideoKps;
+    private stillPass;
+    private inferLb;
     private letterbox;
     constructor(ctx: CreateAdapterContext);
     getBackend(): string | null;
@@ -1222,7 +1292,10 @@ declare class MoveNetGraphAdapter implements PoseDetectorAdapter {
         facingMode: 'user' | 'environment';
         displayWidth: number;
         displayHeight: number;
+        temporalSmooth?: boolean;
     }): Promise<DetectorFrameResult | null>;
+    /** Clear EMA state (call when the still / clip changes). */
+    resetTemporal(): void;
     dispose(): void;
 }
 /** Map video keypoints → object-fit:cover display pixels for drawing. */
@@ -1251,7 +1324,10 @@ declare class BlazePoseAdapter implements PoseDetectorAdapter {
         facingMode: 'user' | 'environment';
         displayWidth: number;
         displayHeight: number;
+        temporalSmooth?: boolean;
     }): Promise<DetectorFrameResult | null>;
+    /** Clear cached ROI / landmark filters (call when the still changes). */
+    resetTemporal(): void;
     dispose(): void;
 }
 
@@ -1411,4 +1487,4 @@ declare function findExerciseByIdOrAlias<T extends {
     id: string;
 }>(exerciseId: string, exercises: readonly T[]): T | undefined;
 
-export { type AccelerationDiagnostics, type AccelerationState, type AngleValue, type AnglesEvent, BRAND_COLORS, BlazePoseAdapter, type BlazePoseModelType, COCO_KEYPOINT_NAMES, COMBINED_REFERENCE_EXERCISE_MESSAGE, type CameraFacingMode, type CameraOptions, type CameraPoseSource, type ClassicMessageListener, type ClassicNativeMessage, type CocoKeypointName, type ColdStartMode, ConfigureError, type ConfigureOptions, type ConfigureRequest, type CounterEvent, type CounterFormScore, type CustomExerciseDescriptor, type CustomSessionOptions, DEFAULT_BASE_URL, DEFAULT_FEATURES, DEFAULT_LOADING_TEXT, DEFAULT_MOVENET_LIGHTNING_URL, DEFAULT_SKELETON, DEFAULT_SKELETON_DEFINITION, type DetectorFrameResult, type DiagnosticListener, EXERCISE_ALIASES, type EngineBundleDescriptor, type EngineLoadResult, EngineLoader, type EngineLoaderOptions, type EngineSession, type EngineSessionFeatures, type EngineSessionOptions, type ErrorEvent, type EventSink, type ExerciseConfig, type ExerciseSummaryEvent, FREE_PLAN_FEATURES_MESSAGE, type FetchSkeletonOptions, type FileStore, type FormGrade, type FormScoreEvent, INVALID_TOKEN_MESSAGE, type ImagePoseSource, type InferenceRuntime, type InitialPosture, type InitializationEvent, type InitializationStep, type JumpCalibrationEvent, type JumpDiscardedEvent, type JumpHeightEvent, type JumpResultEvent, type JumpStartedEvent, type JumpSummaryEntry, type JumpSummaryEvent, type KeyValueStore, type Keypoint, type KeypointName, type KeypointsEvent, type MinGrade, type ModelDescriptor, type ModelFormat, type ModelsByProfile, MoveNetGraphAdapter, type MovementDefinition, type MovementRecommendation, type MovementStep, type MovementStepParameter, ONLINE_POSE_DETECTION_VERSION, ONLINE_TFJS_VERSION, POSETRACKER_LOGO_URL, type PerformanceWarningEvent, type PlanInfo, type Pose, PoseCamera, PoseCamera_mount, type PoseDetectionModule, type PoseDetectorAdapter, type PoseEstimateInput, type PoseModelAlias, type PoseModelKind, type PoseModelProfile, type PoseRuntimeDescriptor, type PoseRuntimePartDescriptor, type PoseSource, type PoseSourceProps, type PoseSourceType, type PoseTracker, type PoseTrackerCallbacks, PoseTrackerClient, type PoseTrackerClientOptions, type PoseTrackerEngine, type PoseTrackerEvent, type PoseTrackerEventListener, type PoseTrackerEventType, type PoseTrackerFeatures, type PoseTrackerMode, type PoseTrackerOptions, type PoseTrackerStatus, type PostureEvent, type PreloadOptions, type ProgressionEvent, type QualityChangedEvent, type RecommendationsEvent, type ReferenceMovementDescriptor, type RepSummary, type ResolvePoseModelOptions, type ResolvedFeatures, type ResolvedPoseModel, type RuntimeDownloadProgressEvent, SDK_NAME, SDK_VERSION, type SdkManifest, type SkeletonAnglesStyle, type SkeletonCirclesStyle, type SkeletonDefinition, SkeletonFetchError, type SkeletonLinesStyle, type StartExerciseOptions, type StatsEvent, type TfModule, type TfjsCdnUrls, TrackError, type TrackRequest, type TrackResponse, UsageTracker, type UsageTrackerOptions, type VideoPoseSource, type VisibleHipsInfo, type WarningEvent, configure, createLocalFileStore, createLocalKeyValueStore, createMemoryFileStore, createPoseAdapter, createPoseTracker, createWebFileStore, defaultPoseDetectionCdnUrl, defaultTfjsCdnUrls, drawSkeleton, featureNotSupportedMessage, fetchSkeletonDefinition, findExerciseByIdOrAlias, freeBlockedFeatures, initWebGlBackend, isPaidPlan, mapVideoKeypointsToDisplay, mountDomShell, normalizePoseSource, openCameraStream, resolveExerciseName, resolveFeatures, resolvePoseDetection, resolvePoseModel, resolveTf, shouldShowWatermark, stopMediaStream, toClassicNativeMessage };
+export { type AccelerationDiagnostics, type AccelerationState, type AngleValue, type AnglesEvent, BRAND_COLORS, BlazePoseAdapter, type BlazePoseModelType, COCO_KEYPOINT_NAMES, COMBINED_REFERENCE_EXERCISE_MESSAGE, type CameraFacingMode, type CameraOptions, type CameraPoseSource, type ClassicMessageListener, type ClassicNativeMessage, type CocoKeypointName, type ColdStartMode, ConfigureError, type ConfigureOptions, type ConfigureRequest, type CounterEvent, type CounterFormScore, type CustomExerciseDescriptor, type CustomSessionOptions, DEFAULT_BASE_URL, DEFAULT_FEATURES, DEFAULT_LOADING_TEXT, DEFAULT_MOVENET_LIGHTNING_URL, DEFAULT_SKELETON, DEFAULT_SKELETON_DEFINITION, type DetectorFrameResult, type DiagnosticListener, EXERCISE_ALIASES, type EngineBundleDescriptor, type EngineChannel, type EngineLoadResult, EngineLoader, type EngineLoaderOptions, type EngineSession, type EngineSessionFeatures, type EngineSessionOptions, type ErrorEvent, type EventSink, type ExerciseConfig, type ExerciseSummaryEvent, FREE_PLAN_FEATURES_MESSAGE, type FetchSkeletonOptions, type FileStore, type FormGrade, type FormScoreEvent, INVALID_TOKEN_MESSAGE, type ImagePoseSource, type InferenceRuntime, type InitialPosture, type InitializationEvent, type InitializationStep, type JumpCalibrationEvent, type JumpDiscardedEvent, type JumpHeightEvent, type JumpResultEvent, type JumpStartedEvent, type JumpSummaryEntry, type JumpSummaryEvent, type KeyValueStore, type Keypoint, type KeypointName, type KeypointsEvent, type MinGrade, type ModelDescriptor, type ModelFormat, type ModelsByProfile, MoveNetGraphAdapter, type MovementDefinition, type MovementRecommendation, type MovementStep, type MovementStepParameter, ONLINE_POSE_DETECTION_VERSION, ONLINE_TFJS_VERSION, POSETRACKER_LOGO_URL, PRODUCTION_SQUAT_IDS, type PerformanceWarningEvent, type PlanInfo, type Pose, PoseCamera, PoseCamera_mount, type PoseDetectionModule, type PoseDetectorAdapter, type PoseEstimateInput, type PoseModelAlias, type PoseModelKind, type PoseModelProfile, type PoseRuntimeDescriptor, type PoseRuntimePartDescriptor, type PoseSource, type PoseSourceProps, type PoseSourceType, type PoseTracker, type PoseTrackerCallbacks, PoseTrackerClient, type PoseTrackerClientOptions, type PoseTrackerEngine, type PoseTrackerEvent, type PoseTrackerEventListener, type PoseTrackerEventType, type PoseTrackerFeatures, type PoseTrackerMode, type PoseTrackerOptions, type PoseTrackerStatus, type PostureEvent, type PreloadOptions, type ProgressionEvent, type QualityChangedEvent, type RecommendationsEvent, type ReferenceMovementDescriptor, type RepSummary, type ResolvePoseModelOptions, type ResolvedFeatures, type ResolvedPoseModel, type RuntimeDownloadProgressEvent, SDK_NAME, SDK_VERSION, type SdkManifest, type SkeletonAnglesStyle, type SkeletonCirclesStyle, type SkeletonDefinition, SkeletonFetchError, type SkeletonLinesStyle, type StartExerciseOptions, type StatsEvent, type TfModule, type TfjsCdnUrls, TrackError, type TrackRequest, type TrackResponse, UsageTracker, type UsageTrackerOptions, V4_ONLY_EXERCISE_IDS, type VideoPoseSource, type VisibleHipsInfo, type WarningEvent, configure, createLocalFileStore, createLocalKeyValueStore, createMemoryFileStore, createPoseAdapter, createPoseTracker, createWebFileStore, defaultPoseDetectionCdnUrl, defaultTfjsCdnUrls, drawSkeleton, featureNotSupportedMessage, fetchSkeletonDefinition, findExerciseByIdOrAlias, freeBlockedFeatures, initWebGlBackend, isPaidPlan, isProductionSquatId, mapVideoKeypointsToDisplay, mountDomShell, normalizeEngineChannel, normalizePoseSource, openCameraStream, requiresEngineV4, resolveExerciseName, resolveFeatures, resolveMovementEngine, resolvePoseDetection, resolvePoseModel, resolveTf, shouldShowWatermark, stopMediaStream, toClassicNativeMessage };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as _tensorflow_tfjs from '@tensorflow/tfjs';
 
 /** Bumped with package.json version (keep in sync). */
-declare const SDK_VERSION = "0.2.0";
+declare const SDK_VERSION = "0.3.1";
 declare const SDK_NAME: "posetracker-web";
 
 /**
@@ -132,6 +132,8 @@ interface EngineBundleDescriptor {
     minSdkVersion: string;
     /** True when the version sent in `localVersions.engine` is already current. */
     upToDate?: boolean;
+    /** Which interpreter this descriptor is. Absent on older backends = v3. */
+    channel?: 'v3' | 'v4';
 }
 interface PoseRuntimePartDescriptor {
     /** Download URL of this part (`GET /api/sdk/pose-runtime?part=...&v=...`). */
@@ -172,6 +174,11 @@ interface ConfigureRequest {
         poseRuntime?: string | null;
         engine?: string | null;
     };
+    /**
+     * Which remote engine to download. New SDKs send `'v4'` by default.
+     * Omitted (0.2.x) still means V3 on the server. `'v3'` forces the FSM bundle.
+     */
+    engineChannel?: 'v3' | 'v4';
 }
 interface PlanInfo {
     plan: string;
@@ -202,6 +209,32 @@ interface SdkManifest {
     expiresAt: number;
 }
 
+/**
+ * Engine channel + production squat lock.
+ *
+ * Default handshake is V4 except unlabeled squat / face_squat (V3 FSM).
+ * Explicit `engine: 'v4'` is the only way to run the V4 catalog squat.
+ * Explicit `engine: 'v3'` keeps the full V3 bundle.
+ * See posetracker-rn-sdk/engine/v4/catalog/SQUAT_PRODUCTION.md
+ */
+type EngineChannel = 'v3' | 'v4';
+/** Movements that exist only in the V4 catalog (not in V3 FSM / Strapi). */
+declare const V4_ONLY_EXERCISE_IDS: readonly ["shoulder_roll", "shoulder_deep_breath", "chair_forward_fold", "chair_side_stretch"];
+declare const PRODUCTION_SQUAT_IDS: readonly ["squat", "face_squat"];
+declare function isProductionSquatId(exerciseId?: string | null): boolean;
+/** Handshake default is V4. Pass `'v3'` to force the V3 bundle. */
+declare function normalizeEngineChannel(raw?: string | null): EngineChannel;
+/**
+ * Session interpreter for this id. Production squat stays V3 unless `engine`
+ * is explicitly `'v4'`. Other ids follow the handshake (default V4).
+ */
+declare function resolveMovementEngine(opts?: {
+    engine?: string | null;
+    exercise?: string | null;
+    userExercise?: boolean;
+}): EngineChannel;
+declare function requiresEngineV4(exerciseId: string): boolean;
+
 /**
  * Handshake client: `configure(apiToken)` → Strapi `SdkManifest`.
  * Same endpoint as RN light; `targetPlatform: 'web'`, `sdkName: posetracker-web`.
@@ -213,6 +246,12 @@ interface ConfigureOptions {
     poseModelProfile?: PoseModelProfile;
     locale?: string;
     localVersions?: ConfigureRequest['localVersions'];
+    /**
+     * Remote engine channel. Default `'v4'`. Pass `'v3'` for the production FSM
+     * bundle. Unlabeled `startExercise('squat')` stays on the V3 squat FSM even
+     * on the V4 channel unless `engine` is explicitly `'v4'`.
+     */
+    engine?: EngineChannel;
 }
 declare class ConfigureError extends Error {
     readonly code: 'invalid_token' | 'quota_exceeded' | 'network' | 'internal';
@@ -679,6 +718,11 @@ interface EngineSessionOptions {
     minGrade?: MinGrade;
     /** Emission flags — engines older than 1.1.0 ignore them (client re-filters). */
     features?: EngineSessionFeatures;
+    /**
+     * Run the V4 catalog squat instead of the production V3 FSM.
+     * Set when the host passed `engine: 'v4'` explicitly.
+     */
+    v4CatalogSquat?: boolean;
 }
 interface EngineSession {
     /** Feed one estimated pose; the session emits events through the sink. */
@@ -716,6 +760,13 @@ interface PoseTrackerEngine {
     createSession(options: EngineSessionOptions, emit: EventSink): EngineSession;
     /** Engine >= 1.2.0: custom exercises shipped in the bundle (jump analysis…). */
     listCustomExercises?(): CustomExerciseDescriptor[];
+    /** Engine V4 catalog (opt-in channel). Absent on V3 bundles. */
+    listExercises?(): Array<{
+        id: string;
+        displayName: string;
+        type: string;
+        description?: string;
+    }>;
     /** Engine >= 1.2.0: start a custom exercise session (placement + jump_* events). */
     createCustomSession?(options: CustomSessionOptions, emit: EventSink): EngineSession;
 }
@@ -1008,6 +1059,12 @@ interface PoseTrackerClientOptions extends ConfigureOptions {
     /** Convenience with `source: 'video' | 'image'` (string / File / Blob). */
     sourceUrl?: string;
     sourceFile?: File | Blob;
+    /**
+     * Still-image inference. Default `single`: one full-frame SinglePose pass
+     * (no EMA / no ROI). `tracked`: treat analyze() as video frames — EMA +
+     * previous-pose crop so each shot can refine the last skeleton.
+     */
+    stillMode?: 'single' | 'tracked';
 }
 /** @deprecated Prefer PoseTrackerClientOptions — kept for vanilla DX. */
 type PoseTrackerOptions = PoseTrackerClientOptions;
@@ -1108,8 +1165,11 @@ declare class PoseTrackerClient {
     dispose(): Promise<void>;
     configure(apiToken?: string): Promise<boolean>;
     getAvailableExercises(): ExerciseConfig[];
+    getEngineChannel(): EngineChannel;
+    private v4ExerciseConfig;
     getAvailableCustomExercises(): CustomExerciseDescriptor[];
     startExercise(exerciseId: string, options?: StartExerciseOptions): void;
+    private beginEngineSession;
     private startCustomExercise;
     stopExercise(): void;
     getCurrentExerciseId(): string | null;
@@ -1161,6 +1221,9 @@ interface Letterbox {
     drawH: number;
     vw: number;
     vh: number;
+    /** Window top-left in original media pixels (still-image video simulation). */
+    originX?: number;
+    originY?: number;
 }
 interface DetectorFrameResult {
     /** Raw model output used for skeleton mapping (MoveNet: Float32Array length 51). */
@@ -1191,7 +1254,11 @@ interface PoseDetectorAdapter {
         facingMode: 'user' | 'environment';
         displayWidth: number;
         displayHeight: number;
+        /** EMA across frames. Default true. Stills may pass true to simulate a short clip. */
+        temporalSmooth?: boolean;
     }): Promise<DetectorFrameResult | null>;
+    /** Optional: clear temporal filters when the media source changes. */
+    resetTemporal?(): void;
     dispose(): void;
 }
 interface CreateAdapterContext {
@@ -1211,6 +1278,9 @@ declare class MoveNetGraphAdapter implements PoseDetectorAdapter {
     private offscreen;
     private offCtx;
     private smoothed;
+    private lastVideoKps;
+    private stillPass;
+    private inferLb;
     private letterbox;
     constructor(ctx: CreateAdapterContext);
     getBackend(): string | null;
@@ -1222,7 +1292,10 @@ declare class MoveNetGraphAdapter implements PoseDetectorAdapter {
         facingMode: 'user' | 'environment';
         displayWidth: number;
         displayHeight: number;
+        temporalSmooth?: boolean;
     }): Promise<DetectorFrameResult | null>;
+    /** Clear EMA state (call when the still / clip changes). */
+    resetTemporal(): void;
     dispose(): void;
 }
 /** Map video keypoints → object-fit:cover display pixels for drawing. */
@@ -1251,7 +1324,10 @@ declare class BlazePoseAdapter implements PoseDetectorAdapter {
         facingMode: 'user' | 'environment';
         displayWidth: number;
         displayHeight: number;
+        temporalSmooth?: boolean;
     }): Promise<DetectorFrameResult | null>;
+    /** Clear cached ROI / landmark filters (call when the still changes). */
+    resetTemporal(): void;
     dispose(): void;
 }
 
@@ -1411,4 +1487,4 @@ declare function findExerciseByIdOrAlias<T extends {
     id: string;
 }>(exerciseId: string, exercises: readonly T[]): T | undefined;
 
-export { type AccelerationDiagnostics, type AccelerationState, type AngleValue, type AnglesEvent, BRAND_COLORS, BlazePoseAdapter, type BlazePoseModelType, COCO_KEYPOINT_NAMES, COMBINED_REFERENCE_EXERCISE_MESSAGE, type CameraFacingMode, type CameraOptions, type CameraPoseSource, type ClassicMessageListener, type ClassicNativeMessage, type CocoKeypointName, type ColdStartMode, ConfigureError, type ConfigureOptions, type ConfigureRequest, type CounterEvent, type CounterFormScore, type CustomExerciseDescriptor, type CustomSessionOptions, DEFAULT_BASE_URL, DEFAULT_FEATURES, DEFAULT_LOADING_TEXT, DEFAULT_MOVENET_LIGHTNING_URL, DEFAULT_SKELETON, DEFAULT_SKELETON_DEFINITION, type DetectorFrameResult, type DiagnosticListener, EXERCISE_ALIASES, type EngineBundleDescriptor, type EngineLoadResult, EngineLoader, type EngineLoaderOptions, type EngineSession, type EngineSessionFeatures, type EngineSessionOptions, type ErrorEvent, type EventSink, type ExerciseConfig, type ExerciseSummaryEvent, FREE_PLAN_FEATURES_MESSAGE, type FetchSkeletonOptions, type FileStore, type FormGrade, type FormScoreEvent, INVALID_TOKEN_MESSAGE, type ImagePoseSource, type InferenceRuntime, type InitialPosture, type InitializationEvent, type InitializationStep, type JumpCalibrationEvent, type JumpDiscardedEvent, type JumpHeightEvent, type JumpResultEvent, type JumpStartedEvent, type JumpSummaryEntry, type JumpSummaryEvent, type KeyValueStore, type Keypoint, type KeypointName, type KeypointsEvent, type MinGrade, type ModelDescriptor, type ModelFormat, type ModelsByProfile, MoveNetGraphAdapter, type MovementDefinition, type MovementRecommendation, type MovementStep, type MovementStepParameter, ONLINE_POSE_DETECTION_VERSION, ONLINE_TFJS_VERSION, POSETRACKER_LOGO_URL, type PerformanceWarningEvent, type PlanInfo, type Pose, PoseCamera, PoseCamera_mount, type PoseDetectionModule, type PoseDetectorAdapter, type PoseEstimateInput, type PoseModelAlias, type PoseModelKind, type PoseModelProfile, type PoseRuntimeDescriptor, type PoseRuntimePartDescriptor, type PoseSource, type PoseSourceProps, type PoseSourceType, type PoseTracker, type PoseTrackerCallbacks, PoseTrackerClient, type PoseTrackerClientOptions, type PoseTrackerEngine, type PoseTrackerEvent, type PoseTrackerEventListener, type PoseTrackerEventType, type PoseTrackerFeatures, type PoseTrackerMode, type PoseTrackerOptions, type PoseTrackerStatus, type PostureEvent, type PreloadOptions, type ProgressionEvent, type QualityChangedEvent, type RecommendationsEvent, type ReferenceMovementDescriptor, type RepSummary, type ResolvePoseModelOptions, type ResolvedFeatures, type ResolvedPoseModel, type RuntimeDownloadProgressEvent, SDK_NAME, SDK_VERSION, type SdkManifest, type SkeletonAnglesStyle, type SkeletonCirclesStyle, type SkeletonDefinition, SkeletonFetchError, type SkeletonLinesStyle, type StartExerciseOptions, type StatsEvent, type TfModule, type TfjsCdnUrls, TrackError, type TrackRequest, type TrackResponse, UsageTracker, type UsageTrackerOptions, type VideoPoseSource, type VisibleHipsInfo, type WarningEvent, configure, createLocalFileStore, createLocalKeyValueStore, createMemoryFileStore, createPoseAdapter, createPoseTracker, createWebFileStore, defaultPoseDetectionCdnUrl, defaultTfjsCdnUrls, drawSkeleton, featureNotSupportedMessage, fetchSkeletonDefinition, findExerciseByIdOrAlias, freeBlockedFeatures, initWebGlBackend, isPaidPlan, mapVideoKeypointsToDisplay, mountDomShell, normalizePoseSource, openCameraStream, resolveExerciseName, resolveFeatures, resolvePoseDetection, resolvePoseModel, resolveTf, shouldShowWatermark, stopMediaStream, toClassicNativeMessage };
+export { type AccelerationDiagnostics, type AccelerationState, type AngleValue, type AnglesEvent, BRAND_COLORS, BlazePoseAdapter, type BlazePoseModelType, COCO_KEYPOINT_NAMES, COMBINED_REFERENCE_EXERCISE_MESSAGE, type CameraFacingMode, type CameraOptions, type CameraPoseSource, type ClassicMessageListener, type ClassicNativeMessage, type CocoKeypointName, type ColdStartMode, ConfigureError, type ConfigureOptions, type ConfigureRequest, type CounterEvent, type CounterFormScore, type CustomExerciseDescriptor, type CustomSessionOptions, DEFAULT_BASE_URL, DEFAULT_FEATURES, DEFAULT_LOADING_TEXT, DEFAULT_MOVENET_LIGHTNING_URL, DEFAULT_SKELETON, DEFAULT_SKELETON_DEFINITION, type DetectorFrameResult, type DiagnosticListener, EXERCISE_ALIASES, type EngineBundleDescriptor, type EngineChannel, type EngineLoadResult, EngineLoader, type EngineLoaderOptions, type EngineSession, type EngineSessionFeatures, type EngineSessionOptions, type ErrorEvent, type EventSink, type ExerciseConfig, type ExerciseSummaryEvent, FREE_PLAN_FEATURES_MESSAGE, type FetchSkeletonOptions, type FileStore, type FormGrade, type FormScoreEvent, INVALID_TOKEN_MESSAGE, type ImagePoseSource, type InferenceRuntime, type InitialPosture, type InitializationEvent, type InitializationStep, type JumpCalibrationEvent, type JumpDiscardedEvent, type JumpHeightEvent, type JumpResultEvent, type JumpStartedEvent, type JumpSummaryEntry, type JumpSummaryEvent, type KeyValueStore, type Keypoint, type KeypointName, type KeypointsEvent, type MinGrade, type ModelDescriptor, type ModelFormat, type ModelsByProfile, MoveNetGraphAdapter, type MovementDefinition, type MovementRecommendation, type MovementStep, type MovementStepParameter, ONLINE_POSE_DETECTION_VERSION, ONLINE_TFJS_VERSION, POSETRACKER_LOGO_URL, PRODUCTION_SQUAT_IDS, type PerformanceWarningEvent, type PlanInfo, type Pose, PoseCamera, PoseCamera_mount, type PoseDetectionModule, type PoseDetectorAdapter, type PoseEstimateInput, type PoseModelAlias, type PoseModelKind, type PoseModelProfile, type PoseRuntimeDescriptor, type PoseRuntimePartDescriptor, type PoseSource, type PoseSourceProps, type PoseSourceType, type PoseTracker, type PoseTrackerCallbacks, PoseTrackerClient, type PoseTrackerClientOptions, type PoseTrackerEngine, type PoseTrackerEvent, type PoseTrackerEventListener, type PoseTrackerEventType, type PoseTrackerFeatures, type PoseTrackerMode, type PoseTrackerOptions, type PoseTrackerStatus, type PostureEvent, type PreloadOptions, type ProgressionEvent, type QualityChangedEvent, type RecommendationsEvent, type ReferenceMovementDescriptor, type RepSummary, type ResolvePoseModelOptions, type ResolvedFeatures, type ResolvedPoseModel, type RuntimeDownloadProgressEvent, SDK_NAME, SDK_VERSION, type SdkManifest, type SkeletonAnglesStyle, type SkeletonCirclesStyle, type SkeletonDefinition, SkeletonFetchError, type SkeletonLinesStyle, type StartExerciseOptions, type StatsEvent, type TfModule, type TfjsCdnUrls, TrackError, type TrackRequest, type TrackResponse, UsageTracker, type UsageTrackerOptions, V4_ONLY_EXERCISE_IDS, type VideoPoseSource, type VisibleHipsInfo, type WarningEvent, configure, createLocalFileStore, createLocalKeyValueStore, createMemoryFileStore, createPoseAdapter, createPoseTracker, createWebFileStore, defaultPoseDetectionCdnUrl, defaultTfjsCdnUrls, drawSkeleton, featureNotSupportedMessage, fetchSkeletonDefinition, findExerciseByIdOrAlias, freeBlockedFeatures, initWebGlBackend, isPaidPlan, isProductionSquatId, mapVideoKeypointsToDisplay, mountDomShell, normalizeEngineChannel, normalizePoseSource, openCameraStream, requiresEngineV4, resolveExerciseName, resolveFeatures, resolveMovementEngine, resolvePoseDetection, resolvePoseModel, resolveTf, shouldShowWatermark, stopMediaStream, toClassicNativeMessage };