Function connect_path_elements 

pub fn connect_path_elements(
    tx: &mut Transaction,
    global_id: &str,
    relating: EntityId,
    related: EntityId,
    priorities: (&[i64], &[i64]),
    connection_types: (&str, &str),
) -> SpatialAuthoringResult<EntityId>

Stage an IfcRelConnectsPathElements.

Priorities rank which element wins where two path elements meet. NormalizedRelatingPriorities and its related twin bound every entry to 0..=100; an out-of-range entry is a ranking the schema cannot express, so it is refused rather than clamped.

IFC4 and IFC4X3 only: it writes their layout and leaves OwnerHistory $, which IFC2X3 requires. In IFC2X3 use connect_path_elements_with_owner_history, which binds the model’s declared release.

Errors

Refuses a malformed GlobalId, an element connected to itself, an unknown connection-type token, and a priority outside 0..=100.