Module profile 

Rig profiles: checks never reference bone names, they reference roles. A profile maps roles to name matchers; built-ins cover the common rigs and auto-detection scores every built-in by resolved-role coverage. A check whose required roles do not resolve reports a typed coverage gap — never a false failure.

Structs

ResolvedRoles

Role → bone resolution for one skeleton.

RigProfile

A named set of role-to-bone-name matchers.

Enums

NameMatcher

How a role’s bone is found by name. Matching also tries a namespace-stripped variant of each bone name ("ns:Hips" → "Hips").

ResolutionOutcome

Typed overall result of resolving a configured rig.

Role

Semantic bone roles used by checks and measurements.

RoleResolutionPolicy

Stable explanation of how one resolved role matched its delivered bone name.

Functions

builtin_profiles

The built-in profiles.

detect_profile

Auto-detect a built-in profile, preserving the historical optional API. Use detect_profile_detailed when a caller needs the typed outcome.

detect_profile_detailed

Auto-detect with a typed result. A profile must resolve at least two roles; equal best candidates are refused rather than chosen by declaration order.

resolve_configured_roles

Resolve a configured rig profile and apply inline role overrides.

resolve_named

Resolve a profile by name, or auto-detect for "auto".

resolve_named_detailed

Resolve a profile by name, or auto-detect for "auto", retaining a typed ambiguity or coverage result for callers that publish it.