feat: Add peek props to carousel and update numDots calculation

[lgeggleston]

🔗 Linked issue

Relevant to https://energysage.atlassian.net/browse/CED-1974

❓ Type of change

• 📖 Documentation (updates to the documentation or readme)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

• Added peekDesktop and peekMobile props to EsCarousel because they were part of the design for the carousel on whole-home page, but also has come up before as something we want to support for more carousels
• Tweaked the numDots logic to take into account numScroll - the arrow placement was wonky when numScroll was not the same as numVisible

🥼 Testing

• "Customization" example on docs page http://localhost:8500/organisms/carousel
• Adding and removing one or both peek props; changing numScroll and numVisible at different viewports to test dots

🧐 Feedback Requested / Focus Areas

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.
• I have documented testing approach

[nathanielwarner]

👀

[nathanielwarner]

One other question- do we have a design for how the "peek" behavior should look? On https://www.energysage.com/whole-home/ it seems like the "peek" extends all the way to the edge of the screen, whereas here the amount needs to be hardcoded from the carousel it seems?

[lgeggleston]

One other question- do we have a design for how the "peek" behavior should look? On https://www.energysage.com/whole-home/ it seems like the "peek" extends all the way to the edge of the screen, whereas here the amount needs to be hardcoded from the carousel it seems?

@nathanielwarner Good question; the design wasn't put down in Figma but this did go through informal review with Asheeta - main answer in the case of whole-home is that the current design with centering/no container was itself a workaround, and Asheeta requested for the cut-off just on the rightmost card like this, as well as something that we might use for future carousels.

[nathanielwarner]

Looks good! Thanks for the info on the circular issue!