\n
\n\n\n\n```\n\n`GSCarousel` is exposed as a global factory. You can call it with a CSS selector\nstring or a real element:\n\n```js\nnew GSCarousel('.my-carousel', { slidesToShow: 3 });\nnew GSCarousel(document.querySelector('.my-carousel'), { slidesToShow: 3 });\n```\n\nThe bundle also registers a **jQuery plugin** and an **`HTMLElement.prototype`** adapter — both create the carousel exactly like the factory and register it in `window.GSCarouselConfigue`:\n\n```js\n// jQuery (when jQuery is present on the page)\n$('.my-carousel').GSCarousel({ slidesToShow: 3, loop: true });\n\n// HTMLElement.prototype\ndocument.querySelector('.my-carousel').GSCarousel({ slidesToShow: 3 });\n```\n\n> `window.GSCarousel(...)` accepts a selector **or** a real element, so the jQuery / prototype adapters (which pass the element) work the same. (`detect()` / `detectAll()` prototype helpers are also present for internal use.)\n\n### The instance registry — `window.GSCarouselConfigue`\n\nEvery carousel registers itself in `window.GSCarouselConfigue.references` under its\n`reference` key. Look up a live instance and call its imperative methods:\n\n```js\nnew GSCarousel('.my-carousel', { reference: 'main' });\n\nconst instance = window.GSCarouselConfigue.instance('main');\ninstance.next(); // advance\ninstance.goTo(2); // jump to slide index 2\ninstance.refresh(); // full rebuild (re-resolve params + re-render)\ninstance.destroy(); // tear down (clears timers, observers, clones, listeners)\n```\n\n`window.GSCarouselConfigue` shape:\n\n| Member | Type | Description |\n|---|---|---|\n| `references` | `Array<{ key: string; ref: Ref }>` | All registered instances. |\n| `instance(key)` | `(key: string) => Ref \\| undefined` | Look up an instance's runtime `Ref` by its `reference` key. |\n\n## Usage — React\n\n```tsx\nimport GSCarousel from '@get-set/gs-carousel';\n\nexport default function Gallery() {\n return (\n \n
\n\n ![](\"1.jpg\")
\n ![](\"2.jpg\")
\n ![](\"3.jpg\")
\n
\n \n \n \n ![](\"/1.jpg\")
\n ![](\"/2.jpg\")
\n ![](\"/3.jpg\")
\n