
### dataHook
- type: string
- description: Applies a data-hook HTML attribute that can be used in the tests.
### className
- type: string
- description: Specifies a CSS class name to be appended to the component's root element.
- internal
### images
- type: CarouselImage[]
- description: Defines an array of objects where each contains the `src` of an image (in `<img src="your_src" />`).
### imagesPosition
- type: string | number | string & {}
- description: Sets the image's position.
### imagesFit
- type: "none" | "-moz-initial" | "inherit" | "initial" | "revert" | "revert-layer" | "unset" | "contain" | "fill" | "cover" | "scale-down"
- description: Sets the image's fit.
### children
- type: ReactNode
- description: Accepts any component as a child item. Most commonly used to display `<Card/>`,  `<Image/>` or video files.
### buttonSkin
- type: "standard" | "light" | "premium" | "inverted" | "transparent"
- description: Sets the skin of the control (next / previous) buttons.
### showControlsShadow
- type: boolean
- description: Drops a shadow below the control buttons.
### infinite
- type: boolean
- description: Loops images endlessly.
### autoplay
- type: boolean
- description: Auto-plays images.
### dots
- type: boolean
- description: Controls if the bottom dots are visible or hidden.
### variableWidth
- type: boolean
- description: Shows one slide at a time (default) or stacks one slide after another horizontally.
### initialSlideIndex
- type: number
- description: Sets the slide to start a presentation with.
### afterChange
- type: (currentSlide: number) => void
- description: Index change callback. `index => ...`
### beforeChange
- type: (currentSlide: number, nextSlide: number) => void
- description: Index change callback. `(oldIndex, newIndex) => ...`
### controlsPosition
- type: "none" | "bottom" | "overlay" | "sides"
- description: Sets the control buttons' position.
### controlsSize
- type: "tiny" | "small" | "medium" | "large"
- description: Sets the control buttons' size.
### controlsStartEnd
- type: "disabled" | "hidden"
- description: Controls if the next / previous control buttons are visible, hidden or disabled at the start and end of the slideshow.
### gradientColor
- type: string
- description: Controls gradient color when controlsPosition set to overlay.
- default: white
### gradient
- type: boolean
- description: Enables gradient on when controlsPosition set to overlay.
- default: false
### slideSpacing
- type: number
- description: Number of pixels dividing between slides.
### animationDuration
- type: number
- description: Animation duration in milliseconds.
### align
- type: "center" | "start" | "end"
- description: Defines how slides align relative to the viewport.
When set, this takes full control of slide positioning and `startEndOffset` is ignored.
If neither `align` nor `startEndOffset` is provided, defaults to `'start'`.
- default: 'start'
### slidingType
- type: number | "align-to-start" | "reveal-one" | "reveal-chunk"
- description: Specifies how many slides advance per navigation action.
### startEndOffset
- type: number
- description: Number of pixels for showing "peeking" cards on the edges of the carousel.
Adds visible offset at the start and end of the carousel to hint at more content.
Only takes effect when `align` is not explicitly set. If `align` is provided,
this prop is ignored. Use one or the other, not both.
### ref
- type: null | string | (instance: CarouselHandle | null) => void | RefObject<CarouselHandle>
- description: Allows getting a ref to the component instance.
Once the component unmounts, React will set `ref.current` to `null`
(or call the ref with `null` if you passed a callback ref).

