fix: secondary y axis match and visibility when faceted

[FBumann]

Summary by CodeRabbit

• Bug Fixes

  • Secondary y-axis titles in multi-facet plots now display on the rightmost axis for improved clarity.

• Documentation

  • Updated documentation to reflect current functionality.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

The PR modifies secondary y-axis title placement and configuration in multi-faceted plots. Changes ensure axis titles appear on the rightmost secondary axis instead of the first one, with corresponding adjustments to axis anchoring, visibility controls, and layout linkage logic. Documentation and test expectations are updated accordingly.

Changes

Cohort / File(s)	Summary
Documentation README.md	Removed mention of add_trace() from the bullet under "Figure utilities (facet/animation-aware)".
Core Implementation xarray_plotly/figures.py	Refactored secondary y-axis configuration in add_secondary_y: added logic to identify rightmost x-axis and primary y-axis, introduced rightmost_secondary_y tracking, reworked axis anchoring via x_for_y mapping, added showticklabels visibility control (enabled only on rightmost axis), implemented matches parameter for consistent scaling across non-rightmost axes, and restricted title assignment to the rightmost secondary axis.
Tests tests/test_figures.py	Updated test expectations for multi-facet secondary y-axis title placement: changed expected axis from yaxis4 (first secondary) to yaxis6 (rightmost secondary).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• feat: add figure combination utilities (overlay, add_secondary_y, update_traces) #16: Directly related; both PRs modify the same add_secondary_y function in xarray_plotly/figures.py and its associated tests, touching overlapping axis-mapping and configuration logic.

Poem

🐰 With axes aligned from left to right,
The rightmost title shines so bright,
Multi-facets dance in perfect grace,
Each secondary finds its place! ✨

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}