[Feat]: Add option to base AutoHeight on slides in view

[davidjerleke]

Which variants of Embla Carousel are relevant to this feature request?

• embla-carousel (Core)
• embla-carousel-react
• embla-carousel-vue
• embla-carousel-svelte
• embla-carousel-autoplay
• embla-carousel-auto-scroll
• embla-carousel-solid
• embla-carousel-auto-height
• embla-carousel-class-names
• embla-carousel-fade
• embla-carousel-docs (Documentation)
• embla-carousel-docs (Generator)

Feature description

The auto-height plugin already supports using slides in view to calculate height via the heightEvent: 'slidesinview' option. However, this isn't clearly documented.

I propose we clarify this in the plugin documentation (e.g., README or docs site), with an example and an explanation of when to use each heightEvent mode:

• select: Uses the selected snap group
• slidesinview: Uses all currently visible slides

This would help developers understand how to enable this behavior without having to dive into plugin source code.

Additional Context

Here's the option from Options.ts:

export type OptionsType = CreateOptionsType<{
  heightEvent: 'select' | 'slidesinview'
}>

And in the plugin:

function getSlideIndexes(): number[] {
  if (isEventSelect) return slideGroupBySnap[emblaApi.selectedSnap()]
  return emblaApi.slidesInView()
}

Before submitting

• I've made research efforts and searched the documentation
• I've searched for existing issues
• I agree to follow this project's Contributing Guidelines for feature requests

[davidjerleke]

• Solved in f2be58e.