v3.0.0

3.0.0 (2026-09-25)

⚠ BREAKING CHANGES

• face: Video(face_orientation=...) is replaced by
  Video(face_stages=[...]); FrameResult.face_orientation (list of dicts) is replaced
  by FrameResult.faces (a face Result); Detection.Face is removed in favour of
  pt.Face; detectors expose a public task attribute instead of _task;
  Models.Pose3D.FaceOrientation moved to Models.Face.Orientation;
  FaceOrientation.predict(source, bboxes) is now predict(source, faces), it no
  longer takes verbose/**kwargs, and its head-pose values change with the new
  crop; custom rppg_roi objects must accept skin_mask(frame, boxes=None).
• pose: WholeBody keypoints 40-49 and 59-70 swap their left/right names
  (face_left_eyebrow_* <-> face_right_eyebrow_, face_left_eye_ <-> face_right_eye_*).

Features

• face: face analysis as core face stages, face signals and Video support (b358381)

Bug Fixes

• pose: name WholeBody face keypoints by the subject's side (642e522)
• video: run every configured detector, keep the exact frame rate, accept Path sources (312fb1d)