@rcarls/rc-carousel 0.1.0

package/dist/custom-elements.json

@@ -0,0 +1,937 @@
+{
+  "schemaVersion": "1.0.0",
+  "readme": "",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "src/define.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "rc-carousel-item",
+          "declaration": {
+            "name": "RCCarouselItem",
+            "module": "/src/index.js"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "rc-carousel",
+          "declaration": {
+            "name": "RCCarousel",
+            "module": "/src/index.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/index.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/rc-carousel-item.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/rc-carousel.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/rc-carousel-item.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "One slide of an `rc-carousel`. Participates directly in the parent's\nscroll-snap track as a grid-auto-flow child — `rc-carousel-item` owns its\nown snap alignment and accessibility state, but authored content (an\n`<img>` with real alt text, arbitrary markup) stays exactly as slotted,\nnever cloned or re-parented, so it remains directly available to forms,\nlabels, and assistive technology.\n\nWhile off-screen (not the intersecting slide, including a partially\nvisible peek), the slide is marked `aria-hidden` and `inert`: it stays\nvisually and pointer-interactively present as a peek affordance, but\ndrops out of the accessibility tree and the Tab sequence, so a slide's\ninteractive descendants (a button, a link) can't be reached by keyboard\nor announced by a screen reader until their slide is actually active.",
+          "name": "RCCarouselItem",
+          "cssProperties": [
+            {
+              "description": "Slide foreground color.",
+              "name": "--rc-carousel-item-color",
+              "default": "CanvasText"
+            },
+            {
+              "description": "Snap alignment within the track. Override for a center-aligned layout.",
+              "name": "--rc-carousel-item-scroll-snap-align",
+              "default": "start"
+            },
+            {
+              "description": "Slide surface background, e.g. for an MD3 card-like slide shape.",
+              "name": "--rc-carousel-item-background",
+              "default": "transparent"
+            },
+            {
+              "description": "Slide corner radius.",
+              "name": "--rc-carousel-item-border-radius",
+              "default": "0"
+            },
+            {
+              "description": "Overflow behavior for slotted content that exceeds the slide's own box. `hidden` clips to the corner radius (matching media-item slides); text-heavy slides that need their own internal scroll may want `auto` instead.",
+              "name": "--rc-carousel-item-overflow",
+              "default": "hidden"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Slide content.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "_internals",
+              "type": {
+                "text": "ElementInternals"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_intersectionObserver",
+              "type": {
+                "text": "IntersectionObserver | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "position",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "\"N of M\" position assigned by the parent `rc-carousel`. Internal\nintegration point, not a public API — see the `@attr` note above."
+            },
+            {
+              "kind": "method",
+              "name": "_syncDefaultLabel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_observeIntersection",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "description": "Observes intersection against the parent carousel's own scroll\ncontainer (not the viewport — a slide can be viewport-visible yet\nstill clipped/off-screen within the track on a page where the\ncarousel isn't the whole viewport). Reads `trackElement` off the\nparent `rc-carousel`, an internal integration point rather than a\npublic API — awaits the parent's own first render first, since a\nslotted item's `connectedCallback` isn't guaranteed to run after its\nhost's, and `trackElement` only exists once the host has rendered."
+            },
+            {
+              "kind": "field",
+              "name": "role",
+              "type": {
+                "text": "string"
+              },
+              "default": "'group'"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "rc-carousel-item",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RCCarouselItem",
+          "declaration": {
+            "name": "RCCarouselItem",
+            "module": "src/rc-carousel-item.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/rc-carousel.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "WAI-ARIA APG carousel pattern built on native CSS scroll-snap. One\n`rc-carousel-item` per slide, swiped or paged between; the track's own\nnative scroll-snap settling (not a hand-rolled drag simulation) is the\nprimary interaction, per this monorepo's \"build on native browser\nbehavior\" principle.\n\n`activeIndex` is a controlled/uncontrolled property, mirroring\n`rc-adaptive-menu`'s `open`/`defaultOpen` pair: leave it unset for\nuncontrolled usage (`default-active-index` seeds the initial slide),\nor set it directly to drive the carousel externally — a settle from\nswipe, a keyboard action, or the imperative API all report back through\n`rc-carousel-change` rather than silently self-correcting a controlled\nvalue out from under the consumer.\n\nPrevious/next navigation and a slide picker are both opt-in\n(`navigation`/`pagination`), following the WAI-ARIA APG carousel\npattern's \"grouped\" (non-tab) picker style deliberately: the tabbed\n`role=\"tabpanel\"` variant requires cross-references between light-DOM\nslides and shadow-DOM tab buttons that, in comparable shadow-DOM\ncarousels, has hit real accessibility-tooling failures across the\nshadow boundary (including non-recognition by some screen readers\nentirely). `loop` wraps seamlessly via cloned lead/trail slides rather\nthan a discontinuous jump back to the other end.",
+          "name": "RCCarousel",
+          "cssProperties": [
+            {
+              "description": "Carousel foreground color.",
+              "name": "--rc-carousel-color",
+              "default": "CanvasText"
+            },
+            {
+              "description": "Space between slides.",
+              "name": "--rc-carousel-gap",
+              "default": "8px"
+            },
+            {
+              "description": "Rendered size of each slide along the scroll axis. Set this directly or from a consumer container query to coordinate hero and multi-browse layouts.",
+              "name": "--rc-carousel-slide-size",
+              "default": "calc(100% - 4rem)"
+            },
+            {
+              "description": "Previous/next button diameter.",
+              "name": "--rc-carousel-navigation-button-size",
+              "default": "40px"
+            },
+            {
+              "description": "Previous/next button background.",
+              "name": "--rc-carousel-navigation-button-background",
+              "default": "color-mix(in srgb, CanvasText 12%, transparent)"
+            },
+            {
+              "description": "Previous/next button icon color.",
+              "name": "--rc-carousel-navigation-button-color",
+              "default": "CanvasText"
+            },
+            {
+              "description": "Previous/next button inset from the track edge.",
+              "name": "--rc-carousel-navigation-inset",
+              "default": "8px"
+            },
+            {
+              "description": "Slide-picker dot diameter.",
+              "name": "--rc-carousel-pagination-item-size",
+              "default": "8px"
+            },
+            {
+              "description": "Inactive slide-picker dot color.",
+              "name": "--rc-carousel-pagination-item-color",
+              "default": "color-mix(in srgb, CanvasText 40%, transparent)"
+            },
+            {
+              "description": "Active slide-picker dot color.",
+              "name": "--rc-carousel-pagination-item-active-color",
+              "default": "Highlight"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The scrollable slide track.",
+              "name": "track"
+            },
+            {
+              "description": "Previous/next button wrapper.",
+              "name": "navigation"
+            },
+            {
+              "description": "A previous or next button.",
+              "name": "navigation-button"
+            },
+            {
+              "description": "The previous button specifically.",
+              "name": "navigation-button-previous"
+            },
+            {
+              "description": "The next button specifically.",
+              "name": "navigation-button-next"
+            },
+            {
+              "description": "Slide-picker button group wrapper.",
+              "name": "pagination"
+            },
+            {
+              "description": "A slide-picker button.",
+              "name": "pagination-item"
+            },
+            {
+              "description": "The active slide's picker button.",
+              "name": "pagination-item-active"
+            }
+          ],
+          "slots": [
+            {
+              "description": "One or more `rc-carousel-item` elements.",
+              "name": ""
+            },
+            {
+              "description": "Optional icon for the previous button, replacing the default chevron. Only rendered when `navigation` is set.",
+              "name": "previous-icon"
+            },
+            {
+              "description": "Optional icon for the next button, replacing the default chevron. Only rendered when `navigation` is set.",
+              "name": "next-icon"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "_internals",
+              "type": {
+                "text": "ElementInternals"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_trackEl",
+              "type": {
+                "text": "HTMLDivElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_slotEl",
+              "type": {
+                "text": "HTMLSlotElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_items",
+              "type": {
+                "text": "RCCarouselItem[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_cloneItems",
+              "type": {
+                "text": "RCCarouselItem[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_mounted",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_suppressSync",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_pendingInstant",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_settleTimer",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "loop",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Wraps past the first/last slide back to the other end, seamlessly.",
+              "attribute": "loop",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "navigation",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows previous/next buttons.",
+              "attribute": "navigation",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "pagination",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows a slide-picker button group.",
+              "attribute": "pagination",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "mouseDragging",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enables click-and-drag scrolling with a mouse — native scroll-snap\ntouch physics already cover touch/pen, but a mouse has no built-in\nequivalent. Off by default.",
+              "attribute": "mouse-dragging",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_dragging",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_dragStartLeft",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "_suppressNextClick",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_dragController",
+              "privacy": "protected",
+              "readonly": true,
+              "default": "new DragGestureController(this, { target: () => this._trackEl ?? null, axis: 'x', activation: 'axis', canStart: (event) => this.mouseDragging && event.pointerType === 'mouse', onStart: () => { this._dragging = true; this._dragStartLeft = this._trackEl?.scrollLeft ?? 0; this._suppressNextClick = true; // Imperative, not reactive-class-driven: this must land before // onMove's very first scrollLeft write below, and a Lit re-render // (triggered by _dragging above) is a whole render pass too late for // that — with scroll-snap-type still active, the browser eagerly // resnaps a plain scrollLeft assignment straight back to the // nearest snap point, same as it would any other programmatic // scroll with no notion this is \"mid-gesture\". if (this._trackEl) { this._trackEl.style.scrollSnapType = 'none'; } }, onMove: (detail) => { if (this._trackEl) { this._trackEl.scrollLeft = this._dragStartLeft - detail.deltaX; } }, onEnd: (detail) => this._endDrag(detail), onCancel: (detail) => this._endDrag(detail), })",
+              "description": "Drives `scrollLeft` directly from pointer deltas while `mouseDragging`\nis on. `activation: 'axis'` (not `'immediate'`) means a plain click\nnever activates a drag at all — it requires clearing\n`activationDistance` (8px) of movement first — but a *real* drag still\nends in a native `click` on release, on whatever's under the pointer,\nwhich `_suppressNextClick` swallows so dragging across an unrelated\nlink or button inside a slide doesn't activate it (the same edge case\nShoelace's own `sl-carousel` handles for exactly this reason)."
+            },
+            {
+              "kind": "field",
+              "name": "_busy",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_activeIndex",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_defaultActiveIndex",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "_uncontrolledActiveIndex",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_activeIndexInitialized",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "activeIndex",
+              "type": {
+                "text": "number"
+              },
+              "description": "Controls the active slide. Host writes are silent.",
+              "attribute": "active-index"
+            },
+            {
+              "kind": "field",
+              "name": "defaultActiveIndex",
+              "type": {
+                "text": "number"
+              },
+              "description": "Initial active slide for uncontrolled usage.",
+              "attribute": "default-active-index"
+            },
+            {
+              "kind": "field",
+              "name": "trackElement",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "description": "The scroll-snap track element. Internal integration point consumed by\n`rc-carousel-item`'s IntersectionObserver (its `root` must be this\ntrack, not the viewport, so peeking/clipped-but-viewport-visible\nslides are still correctly detected as off-screen) — not a public API.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "next",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Moves to the next slide."
+            },
+            {
+              "kind": "method",
+              "name": "previous",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Moves to the previous slide."
+            },
+            {
+              "kind": "method",
+              "name": "goToIndex",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "instant",
+                  "default": "false"
+                }
+              ],
+              "description": "Moves directly to a slide index."
+            },
+            {
+              "kind": "method",
+              "name": "_step",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "delta",
+                  "type": {
+                    "text": "1 | -1"
+                  }
+                },
+                {
+                  "name": "trigger",
+                  "type": {
+                    "text": "RCCarouselChangeTrigger"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_canStep",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "delta",
+                  "type": {
+                    "text": "1 | -1"
+                  }
+                }
+              ],
+              "description": "Whether a previous/next button (or an equivalent keyboard action)\ncurrently has anywhere to go — always true when `loop` is set and\nthere's more than one slide."
+            },
+            {
+              "kind": "method",
+              "name": "_clampIndex",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Wraps when `loop` is set, otherwise clamps to the real slide range.\nWrapping here covers button/keyboard navigation; a swipe wraps\nseamlessly through `_trackSlots`'s cloned lead/trail slides instead,\nsince that needs the clones' own track positions, not just an index."
+            },
+            {
+              "kind": "method",
+              "name": "_snapPoints",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_trackSlots",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "{ point: number; index: number; isClone: boolean }[]"
+                }
+              },
+              "description": "Every scrollable track position in rendered order, including cloned\nlead/trail slides when `loop` is on — `[lastClone, item0, ..., itemN-1,\nfirstClone]`. Each slot reports which real slide index it represents\n(a clone mirrors the real slide it duplicates), so both scrolling to\nan index and reading back a settled scroll position can stay in terms\nof real indices while the clones do the seamless-wrap work."
+            },
+            {
+              "kind": "method",
+              "name": "_itemStep",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_setActiveIndex",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "trigger",
+                  "type": {
+                    "text": "RCCarouselChangeTrigger"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_scrollToIndex",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "instant",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_onSlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_directItems",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "RCCarouselItem[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_setItemPositions",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_syncItems",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Prepending/appending the loop clones below is itself a light-DOM\nmutation on this host, which re-fires `slotchange` (asynchronously) —\n`_onSlotChange` calls back into this method, so a naive unconditional\nremove-then-recreate would recreate a fresh pair of clones on every\npass forever. Clones are always excluded from `nextItems`, so the\nreal item list is byte-for-byte identical on that re-entrant pass;\nonly rebuild clone DOM when either the real items or the desired\nclone presence has actually changed, so the re-entrant pass is a\ntrue no-op and the recursion terminates."
+            },
+            {
+              "kind": "method",
+              "name": "_addClones",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Clones the first and last slide and prepends/appends them\n(`data-clone=\"<real index>\"` marks them, excluded from `_items` and\nfrom position numbering) so the track has real scrollable content\npast both visual ends. `_trackSlots`/`_commitSettledIndex` detect\nwhen a clone settles and instantly re-anchor to the real slide it\nmirrors — Shoelace's proven technique for a seamless infinite swipe,\nrather than a discontinuous index-modulo jump back to the other end."
+            },
+            {
+              "kind": "method",
+              "name": "_sanitizeClone",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "$clone",
+                  "type": {
+                    "text": "RCCarouselItem"
+                  }
+                }
+              ],
+              "description": "Keeps visual loop clones out of forms, focus order, and the accessibility tree."
+            },
+            {
+              "kind": "method",
+              "name": "_removeClones",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_endDrag",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "detail",
+                  "type": {
+                    "text": "DragGestureDetail"
+                  }
+                }
+              ],
+              "description": "On release, a fast enough flick pre-nudges `scrollLeft` to the next\nsnap point in the drag direction (a \"decisive swipe\" — mirroring\n`rc-bottom-sheet`'s own velocity-vs-nearest-point settle heuristic,\nadapted from \"jump to the extreme end\" for a 2-point sheet to \"advance\none further point\" for a carousel that can have many). Either way,\nthis hands off to the same debounced settle path a native swipe\nalready goes through — our own `scrollLeft` writes during the drag\nalready fired real `scroll` events, so `_onScroll` just needs to run\nits usual timer to pick up wherever things ended."
+            },
+            {
+              "kind": "field",
+              "name": "_onScroll",
+              "privacy": "private",
+              "description": "Debounced, not per-frame: `_scrollToIndex`'s own smooth scroll fires\nmany `scroll` events while still mid-flight, and reading the settled\nindex from an in-progress position would report the wrong slide and\nimmediately fight the very scroll driving it. Waiting for scrolling to\nactually stop (swipe release or animation end) avoids that oscillation."
+            },
+            {
+              "kind": "field",
+              "name": "_commitSettledIndex",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_onNavigate",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_onTrackClickCapture",
+              "privacy": "private",
+              "description": "A real drag still ends in a native `click` on release (browsers fire\none on pointerup as long as pointerdown/pointerup share a target),\nlanding on whatever's currently under the pointer — which, mid-drag,\nis often unrelated slide content the user was scrolling past, not\nclicking. Capturing and swallowing exactly one click right after a\ndrag activated (`_suppressNextClick`, set in the drag controller's\n`onStart`) stops that from reaching a link/button inside a slide."
+            },
+            {
+              "kind": "method",
+              "name": "_paginationButtons",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLButtonElement[]"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_onPaginationFocus",
+              "privacy": "private",
+              "description": "Hand-rolled roving tabindex for the pagination row, not\n`RovingTabIndexMixin`: that mixin collects items from a real\n`slotchange`-firing `<slot>`, matching its intended use (consumer-\nauthored, slotted content, like `rc-toolbar`'s buttons) — these\nbuttons are shadow-DOM content this component renders itself, so\nthere's no slot to collect from. The pattern is otherwise the same\none the mixin itself implements: exactly one button is a tab stop,\narrow keys move focus among them (not activeIndex — matching\nrc-toolbar's own \"arrows move focus, Enter/Space activates\" model,\nnot a tablist's auto-activate-on-arrow), and focus keeps tabindex in\nsync wherever it lands (click, Tab, or a `.focus()` call below)."
+            },
+            {
+              "kind": "field",
+              "name": "_onPaginationNavigate",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_initPaginationTabIndex",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "One-time tabindex seed for pagination buttons that have never\nreceived focus yet (matching `activeIndex`, the sane default) —\n`_onPaginationFocus` takes over from there. Safe to call on every\nrender: a no-op once every button already has some tabindex value."
+            },
+            {
+              "kind": "field",
+              "name": "role",
+              "type": {
+                "text": "string"
+              },
+              "default": "'group'"
+            }
+          ],
+          "events": [
+            {
+              "name": "rc-carousel-change",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fires when the active slide changes, from a swipe settling, a keyboard action, or the imperative API. `detail: { index, trigger: 'swipe'|'button'|'keyboard'|'api' }`"
+            }
+          ],
+          "attributes": [
+            {
+              "description": "Controls the active slide. Host writes are silent.",
+              "name": "active-index",
+              "type": {
+                "text": "number"
+              },
+              "fieldName": "activeIndex"
+            },
+            {
+              "description": "Initial active slide for uncontrolled usage.",
+              "name": "default-active-index",
+              "type": {
+                "text": "number"
+              },
+              "fieldName": "defaultActiveIndex"
+            },
+            {
+              "description": "Wraps past the first/last slide back to the other end, seamlessly.",
+              "name": "loop",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "loop"
+            },
+            {
+              "description": "Shows previous/next buttons.",
+              "name": "navigation",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "navigation"
+            },
+            {
+              "description": "Shows a slide-picker button group.",
+              "name": "pagination",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "pagination"
+            },
+            {
+              "description": "Enables click-and-drag scrolling with a mouse — native scroll-snap\ntouch physics already cover touch/pen, but a mouse has no built-in\nequivalent. Off by default.",
+              "name": "mouse-dragging",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "mouseDragging"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "rc-carousel",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RCCarousel",
+          "declaration": {
+            "name": "RCCarousel",
+            "module": "src/rc-carousel.ts"
+          }
+        }
+      ]
+    }
+  ]
+}