Implement wrap around feature for mo.carousel()

[andrewsoonqn]

📝 Summary

This PR implements wrap around functionality to mo.carousel() such that a carousel can be allowed to jump back to the start of the array when scrolling beyond the last item (or vice versa, back to last item from the first by clicking the left arrow)

Fixes #5001

🔍 Description of Changes

• Added wrapAround prop to SlideComponent. This will be used to set Swiper's loop property, which directly gives the ability to wrap around.
• wrapAround is always True when using CarouselPlugin

Demo:

Screen.Recording.2026-01-08.at.16.57.57.mov

Note:

• did not implement new tests: assumed no extra tests needed as no existing tests for mo.carousel() were found to be added onto

📋 Checklist

• I have read the contributor guidelines.
• For large changes, or changes that affect the public API: this change was discussed or approved through an issue, on Discord, or the community discussions (Please provide a link if applicable).
• I have added tests for the changes made.
• I have run the code and verified that it works as expected.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
marimo-docs	Ready	Preview, Comment	Jan 8, 2026 9:01am

[github-actions]

All contributors have signed the CLA ✍️ ✅
_{Posted by the CLA Assistant Lite bot.}

[andrewsoonqn]

I have read the CLA Document and I hereby sign the CLA

[Copilot]

Pull request overview

This PR implements wrap around functionality for mo.carousel(), allowing carousels to loop back to the start when navigating beyond the last item (or to the last item from the first).

• Added a wrapAround parameter to mo.carousel() to enable/disable wrap around behavior
• Integrated Swiper's loop property to implement the wrap around feature
• Handled the incompatibility between Swiper's virtual and loop properties by conditionally disabling virtual mode when wrap around is enabled

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
marimo/_plugins/stateless/carousel.py	Added wrapAround parameter to the carousel function and passed it to the frontend via build_stateless_plugin
frontend/src/plugins/layout/carousel/CarouselPlugin.tsx	Added wrapAround field to the Data interface and validator schema
frontend/src/components/slides/slides-component.tsx	Implemented wrap around logic by conditionally enabling Swiper's loop property and disabling virtual mode when loop is active

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Light2Dark]

hi @andrewsoonqn , I left a comment on the issue, I dont think we need to update the backend code

[akshayka]

Thanks for the contribution! Let's not add an argument to the carousel Python function, however. The carousel should just always wrap; wrapping should not be configurable

[github-actions]

🚀 Development release published. You may be able to view the changes at https://marimo.app?v=0.18.5-dev183