join: label-based DataFrame join

join(left, right, options?) aligns two DataFrames by their index labels (or a key column). Unlike the general-purpose merge(), join() defaults to a left join on index — the idiomatic way to combine DataFrames that already share an index.