Struct PathStats 

struct PathStats {
    is_explicit: bool,
    is_leaf: bool,
    expected_leaf_type: JsonNativeType,
    seen_count: usize,
    conflicts: bool,
}

Aggregated observations for one JSON path.

Schema inference first seeds the map with explicit paths, then walks all input values once. Objects, including empty objects, are non-leaf paths; every other non-null value is a leaf. The first dynamic observation fixes the path role and exact leaf type. A later role or type mismatch sets PathStats::conflicts permanently. Missing paths and null values do not affect the statistics.

After collection, dynamic leaves are ranked by PathStats::seen_count. A candidate is rejected when it or any parent path conflicts, so candidate selection never rescans the input values.

Fields

is_explicit: bool

Whether the path came from a type hint and is already part of the output schema.

is_leaf: bool

Whether the path is a non-object value rather than an object prefix.

expected_leaf_type: JsonNativeType

Exact type required for a leaf; unused non-leaf paths keep JsonNativeType::Null.

seen_count: usize

Number of compatible observations used to rank dynamic leaves.

conflicts: bool

Whether the path has ever had inconsistent roles or leaf types.