ConstParsed document; it is only read.
OptionalskeletonId: string
Id copied verbatim to the returned skeleton; defaults to "skeleton" and is not validated here.
The skeleton with bones in first-claim order, or null when no skin joint maps to the required hips slot.
Retarget a parsed glTF's skins onto a normalized humanoid IAutoMovieSkeleton by matching joint names to AutoMovieHumanoidBone slots.
This naming-based mapper currently has test callers in this repository. Production motion adoption uses an explicit mapping against inspected nodes, so this export does not establish a production rig-inference flow.
Every skin is read in document order and the first joint to claim a slot keeps it, because exporters bind clothes, hair and accessories as separate skins in no guaranteed order and the body rig must be found wherever it sits. A joint name maps through the supported Blender-style, Mixamo, VRM-style and Unreal mannequin aliases; fingers, eyes and jaw are not mapped.
The hierarchy is rebuilt over mapped joints only: a bone's parent is its nearest mapped ancestor in the node tree, and the local TRS of every skipped helper node between them composes into the bone's rest, because IAutoMovieBone.rest is relative to
parentand a dropped helper offset or roll would misplace every bone beneath it. With finite unit-quaternion TRS inputs, composition represents the affine product up to floating-point rounding when each helper scale commutes with its child rotation; otherwise it drops shear. This mapper does not admit or normalize raw node TRS. A root bone keeps its own local TRS, since armature and scene transforms belong to the imported object rather than the skeleton. Bones carry no constraint.