feat: add _iter_all_traces helper and rewrite manipulation notebook

[FBumann]

Summary

• Add internal _iter_all_traces(fig) helper to iterate over all traces including animation frames
• Refactor update_traces() and _style_traces_as_bars() to use the new helper
• Rewrite manipulation.ipynb to use xpx() with a 4D DataArray demonstrating:
  • Standard Plotly methods (layout, axes, traces)
  • Faceted plots with facet_col/facet_row
  • Animation pain point and update_traces solution
  • Unified hover pattern
  • Facets + animation combined

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation

  • Completely revised manipulation examples notebook with updated data structures and comprehensive guidance on applying figure modifications using standard Plotly methods and xarray-plotly utilities
  • Enhanced documentation for animation-aware updates and faceted plots

• Refactor

  • Improved internal animation frame iteration mechanism for more consistent trace updates across all animation frames

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

[coderabbitai]

📝 Walkthrough

Walkthrough

The pull request refactors a documentation notebook to demonstrate xarray-plotly with a 4D dataset example while introducing a centralized helper function for iterating over traces across animation frames, replacing duplicated iteration logic.

Changes

Cohort / File(s)	Summary
Documentation Example Notebook docs/examples/manipulation.ipynb	Restructured notebook content and data setup: replaced 2D sample data with 4D DataArray (scenario × metric × year × country from Gapminder), updated imports to use config, update_traces, xpx, and rewrote narrative sections and code examples to emphasize standard Plotly methods and xarray-plotly helpers. Minor Python version reference bump from 3.11.0 to 3.12.0.
Trace Iteration Refactoring xarray_plotly/figures.py, xarray_plotly/plotting.py	Introduced _iter_all_traces() helper function in figures.py to centralize iteration over all traces including animation frames, and refactored update_traces() to use this iterator with conditional selector-based filtering. Updated plotting.py to use _iter_all_traces() in _style_traces_as_bars() instead of manual trace collection.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 A notebook reborn with fourfold arrays,
Traces now dance through animation's maze,
Helpers unite what was scattered before,
xpx-powered plots and so much more! 📊✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main changes: introducing a new _iter_all_traces helper function and comprehensively rewriting the manipulation notebook with updated examples and documentation.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ 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.}