cores/face/__init__.py

"""
Face Core — shared face detection/recognition/analysis helpers.

Consolidates:
  - Box-format conversions (xywh <-> xyxy <-> face_recognition tuple)
  - Embedding distance metrics (cosine, euclidean)
  - Gallery matching (find best match in a name->embeddings dict)
  - Face-crop extraction with margin
  - Face quality analysis (blur, size, pose, orientation) — Phase 11
  - Face clustering + duplicate elimination — Phase 11
"""

from cores.face.helpers import (
    xywh_to_xyxy,
    xyxy_to_xywh,
    xywh_to_face_recognition_tuple,
    cosine_similarity,
    euclidean_distance,
    best_match,
    extract_face_crops,
)
from cores.face.analysis import (
    blur_score,
    is_blurry,
    face_size,
    face_size_label,
    estimate_pose_landmark,
    estimate_pose_bbox,
    face_orientation,
    face_quality_score,
    select_best_face,
    cluster_faces,
    find_duplicate_faces,
)

__all__ = [
    # helpers
    "xywh_to_xyxy", "xyxy_to_xywh", "xywh_to_face_recognition_tuple",
    "cosine_similarity", "euclidean_distance", "best_match", "extract_face_crops",
    # analysis (Phase 11)
    "blur_score", "is_blurry", "face_size", "face_size_label",
    "estimate_pose_landmark", "estimate_pose_bbox",
    "face_orientation", "face_quality_score",
    "select_best_face", "cluster_faces", "find_duplicate_faces",
]