@salt-ds/embla-carousel 0.0.0-snapshot-20250627090641

package/CHANGELOG.md

@@ -0,0 +1,161 @@
+# @salt-ds/embla-carousel
+
+## 0.0.0-snapshot-20250627090641
+
+### Patch Changes
+
+- e8d4fd7: ### Summary
+
+  The `Carousel` component has been moved from the Lab package to its own package, `@salt-ds/embla-carousel`.
+  Initially released as a pre-release in Lab, the Carousel was not fully featured. We have now pivoted to treating Carousel as a pattern using embla, that can compose Salt components as its slides.
+
+  [embla](https://www.embla-carousel.com) is a headless open-source carousel library offering a comprehensive set of features and an extensible API.
+
+  ### Migration Guide
+
+  To allow consumers to manage their own version of `embla`, it is defined as a peer dependency.
+
+  To migrate from the current Lab version of `Carousel`:
+
+  1. Define `embla-carousel-react` in your package.json.
+
+  ```diff
+  "dependencies": {
+  +  "embla-carousel-react": "^8.6.0",
+  }
+  ```
+
+  2. update your imports.
+
+  ```diff
+  import {
+    Carousel,
+  - CarouselControls,
+  + CarouselNextButton,
+  + CarouselPreviousButton,
+  + CarouselProgressLabel,
+  - CarouselSlide,
+  + CarouselCard,
+  - CarouselSlider,
+  + CarouselSlides
+  -} from "@salt-ds/lab";
+  +} from "@salt-ds/embla-carousel";
+  ```
+
+  ### Key Changes
+
+  - `CarouselControls` has been broken into `CarouselPreviousButton`, `CarouselNextButton`, and `CarouselProgressLabel` for composability.
+  - `CarouselSlide` has been renamed to `CarouselCard`. While `CarouselCard` is a predefined slide, you can also create custom slides.
+  - `CarouselSlider` has been renamed to `CarouselSlides`.
+
+  Example Update:
+
+  ```diff
+    const slideId = useId();
+
+  - <Carousel controlsPlacement="bottom">
+  + <Carousel>
+  -   <CarouselControls />
+  +   <CarouselPreviousButton />
+  +   <CarouselNextButton />
+  +   <CarouselProgressLabel />
+  -   <CarouselSlider>
+  +   <CarouselSlides>
+      {
+        slides.map((slide, index) => (
+  -         <CarouselSlide
+  +         <CarouselCard
+              key={`${slideId}-${index}`}
+  +           id={`${slideId}-${index}`}
+              appearance={appearance}
+              header={<H3>{slide.title}</H3>}
+              media={
+              <img
+                 className="carousel-image-placeholder"
+                 alt="stock content to show carousel slide"
+                 src={slide.image}
+              />}
+              actions={withActions && <Link href="#">{slide.link}</Link>}
+           >
+              <Text>{slide.content}</Text>
+           </CarouselCard>
+    ))
+    }
+  -   </CarouselSlider>
+  +   </CarouselSlides>
+  </Carousel>
+  ```
+
+  ### Additional Configuration/Control of Carousel
+
+  The Carousel can be configured using the Embla API.
+
+  To configure embla, pass `emblaOptions` or `emblaPlugins` to the Carousel.
+
+  To control the behavior of the Carousel through the embla API, obtain a reference to the embla API through the `setApiRef` prop.
+
+  ```
+  const [emblaApi, setEmblaApi] = useState<CarouselEmblaApiType | null>(null);
+
+  const slideId = useId();
+  const { matchedBreakpoints } = useBreakpoint();
+  const isMobile = matchedBreakpoints.indexOf("sm") === -1;
+
+  useEffect(() => {
+    if (!emblaApi) {
+      return;
+    }
+
+    const logSnappedSlide = () => {
+      const snappedSlideIndex = emblaApi.selectedScrollSnap();
+      console.log(
+        `Slide ${snappedSlideIndex !== undefined ? snappedSlideIndex + 1 : undefined} is snapped into view.`,
+      );
+    };
+
+    emblaApi.on("select", logSnappedSlide);
+
+    // Cleanup listener on component unmount
+    return () => {
+      emblaApi.off("select", logSnappedSlide);
+    };
+  }, [emblaApi]);
+
+  return (
+    <Carousel
+      aria-label="Account overview"
+      getEmblaApi={setEmblaApi}
+    >
+      <CarouselSlides>
+        {slides.map((index) => (
+          <div
+            aria-label={`Example slide ${index + 1}`}
+            aria-roledescription="slide"
+            key={`${slideId}-${slide.title.replace(/ /g, "-")}-${index}`}
+            id={`${slideId}-${slide.title.replace(/ /g, "-")}-${index}`}
+          >
+              {index + 1}
+          </div>
+        ))}
+      </CarouselSlides>
+    </Carousel>
+  );
+  ```
+
+  Due to the challenges of making an accessible carousel, please read the documentation to understand the responsibilities that come with usage.
+
+  `Carousel` remains in a pre-release state for this release and subject to feedback will be promoted to stable in a forthcoming release.
+
+  ### Additional components
+
+  - `CarouselTabList`: A tablist for navigating between slides.
+  - `CarouselTab`: A tab button used by `CarouselTabList`.
+  - `CarouselAutoplayIndicator`: An animated countdown indicator for autoplay functionality.
+  - `CarouselAnnouncementPlugin`: A plugin for announcing slide changes to assistive technologies.
+
+- Updated dependencies [62975de]
+- Updated dependencies [73ccf6b]
+- Updated dependencies [95dd874]
+- Updated dependencies [c93c943]
+- Updated dependencies [104d776]
+  - @salt-ds/core@0.0.0-snapshot-20250627090641

package/README.md

@@ -0,0 +1,3 @@
+# Carousel pattern
+
+Based on [embla](https://www.embla-carousel.com/)

package/css/salt-embla-carousel.css

@@ -0,0 +1,155 @@
+/* src/Carousel.css */
+.saltCarousel {
+  --saltCarousel-slide-height: 310px;
+  --saltCarousel-slide-spacing: var(--salt-spacing-100);
+  --saltCarousel-slide-size: 100%;
+  display: flex;
+  flex-direction: column;
+  gap: var(--salt-spacing-100);
+  margin: auto;
+}
+
+/* src/CarouselAutoplayIndicator.css */
+.saltCarouselAutoplayIndicator {
+  --salt-carousel-svg-circumference: 0;
+  display: flex;
+  align-self: center;
+}
+.saltCarouselAutoplayIndicatorSVG {
+  transform: rotate(-90deg);
+}
+.saltCarouselAutoplayIndicatorSVG-track {
+  fill: none;
+  stroke: var(--salt-accent-foreground);
+}
+.saltCarouselAutoplayIndicatorSVG-bar {
+  fill: none;
+  stroke: var(--salt-accent-background);
+  stroke-dasharray: var(--salt-carousel-svg-circumference);
+  stroke-dashoffset: var(--salt-carousel-svg-circumference);
+  animation: indicatorAnimation 0.5s linear;
+  animation-play-state: paused;
+}
+@keyframes indicatorAnimation {
+  from {
+    stroke-dashoffset: var(--salt-carousel-svg-circumference);
+  }
+  to {
+    stroke-dashoffset: 0;
+  }
+}
+
+/* src/CarouselCard.css */
+.saltCarouselCard {
+  display: flex;
+  transform: translate3d(0, 0, 0);
+  flex: 0 0 var(--saltCarousel-slide-size);
+  min-width: 0;
+  padding-left: var(--saltCarousel-slide-spacing);
+  box-sizing: border-box;
+}
+.saltCarouselCard-content {
+  display: flex;
+  user-select: none;
+  overflow: hidden;
+  flex-direction: column;
+  gap: var(--salt-spacing-200);
+  flex-grow: 1;
+}
+.saltCarouselCard-body {
+  display: flex;
+  overflow: hidden;
+  flex-direction: column;
+  gap: var(--salt-spacing-200);
+  flex-grow: 1;
+  padding: 0 var(--salt-spacing-200) var(--salt-spacing-200) var(--salt-spacing-200);
+}
+.saltCarouselCard-content h2,
+.saltCarouselCard-content h3 {
+  margin: 0;
+}
+.saltCarouselCard[data-visibility=off-screen] a {
+  visibility: hidden;
+}
+.saltCarouselCard-bordered {
+  background: var(--salt-container-primary-background);
+  border: var(--salt-size-border) var(--salt-container-borderStyle) var(--salt-container-primary-borderColor);
+  border-radius: var(--salt-palette-corner, 0);
+}
+
+/* src/CarouselProgressLabel.css */
+.saltCarouselTabList.saltText {
+  font-weight: var(--salt-palette-text-body-fontWeight-strong);
+}
+
+/* src/CarouselSlides.css */
+.saltCarouselSlides {
+  overflow: hidden;
+}
+.saltCarouselSlides-container {
+  display: flex;
+  touch-action: pan-y pinch-zoom;
+  margin-left: calc(var(--saltCarousel-slide-spacing) * -1);
+}
+
+/* src/CarouselTab.css */
+.saltCarouselTab {
+  position: relative;
+  width: var(--salt-size-selectable);
+  height: var(--salt-size-selectable);
+  border: none;
+  box-shadow: inset 0 0 0 var(--salt-size-border) var(--salt-selectable-borderColor);
+  -webkit-tap-highlight-color: var(--salt-selectable-borderColor-hover);
+  -webkit-appearance: none;
+  appearance: none;
+  background-color: transparent;
+  touch-action: manipulation;
+  display: inline-flex;
+  text-decoration: none;
+  cursor: pointer;
+  padding: 0;
+  margin: 0;
+  align-items: center;
+  justify-content: center;
+  border-radius: var(--salt-palette-corner-strongest);
+  transition: box-shadow var(--salt-duration-perceptible) ease-in-out;
+}
+.saltCarouselTab:after {
+  content: "";
+  position: absolute;
+  width: var(--salt-size-selectable);
+  height: var(--salt-size-selectable);
+  border-radius: 50%;
+  background-color: transparent;
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+}
+.saltCarouselTab:focus-visible {
+  outline-style: var(--salt-focused-outlineStyle);
+  outline-width: var(--salt-focused-outlineWidth);
+  outline-color: var(--salt-focused-outlineColor);
+  outline-offset: var(--salt-focused-outlineOffset);
+  background: var(--salt-selectable-background-hover);
+  border-color: var(--salt-selectable-borderColor-hover);
+}
+.saltCarouselTab-selected {
+  box-shadow: inset 0 0 0 var(--salt-size-selectable) var(--salt-selectable-borderColor-selected);
+}
+
+/* src/CarouselTabList.css */
+.saltCarouselTabList {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: flex-end;
+  align-items: center;
+  gap: var(--salt-spacing-200);
+}
+.saltCarouselTabList:focus-visible {
+  outline-style: var(--salt-focused-outlineStyle);
+  outline-width: var(--salt-focused-outlineWidth);
+  outline-offset: var(--salt-focused-outlineOffset);
+  outline-color: var(--salt-focused-outlineColor);
+}
+
+/* src/cd851d81-d6a7-4108-95c8-d10689f569ce.css */

package/dist-cjs/Carousel.css.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var css_248z = ".saltCarousel {\n  --saltCarousel-slide-height: 310px;\n  --saltCarousel-slide-spacing: var(--salt-spacing-100);\n  --saltCarousel-slide-size: 100%;\n  display: flex;\n  flex-direction: column;\n  gap: var(--salt-spacing-100);\n  margin: auto;\n}\n";
+
+module.exports = css_248z;
+//# sourceMappingURL=Carousel.css.js.map

package/dist-cjs/Carousel.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Carousel.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist-cjs/Carousel.js

@@ -0,0 +1,53 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var core = require('@salt-ds/core');
+var styles = require('@salt-ds/styles');
+var window = require('@salt-ds/window');
+var clsx = require('clsx');
+var useEmblaCarousel = require('embla-carousel-react');
+var react = require('react');
+var Carousel$1 = require('./Carousel.css.js');
+var CarouselContext = require('./CarouselContext.js');
+
+const withBaseName = core.makePrefixer("saltCarousel");
+const Carousel = react.forwardRef(
+  function Carousel2({
+    children,
+    className,
+    emblaOptions = {},
+    emblaPlugins = [],
+    getEmblaApi,
+    ...rest
+  }, ref) {
+    const targetWindow = window.useWindow();
+    styles.useComponentCssInjection({
+      testId: "salt-carousel",
+      css: Carousel$1,
+      window: targetWindow
+    });
+    const [emblaRef, emblaApi] = useEmblaCarousel(emblaOptions, [
+      ...emblaPlugins
+    ]);
+    react.useEffect(() => {
+      if (emblaApi) {
+        getEmblaApi == null ? void 0 : getEmblaApi(emblaApi);
+      }
+      return void 0;
+    }, [emblaApi]);
+    return /* @__PURE__ */ jsxRuntime.jsx(CarouselContext.CarouselContext.Provider, { value: { emblaApi, emblaRef }, children: /* @__PURE__ */ jsxRuntime.jsx(
+      "section",
+      {
+        "aria-roledescription": "carousel",
+        role: "region",
+        className: clsx.clsx(withBaseName(), className),
+        ref,
+        ...rest,
+        children
+      }
+    ) });
+  }
+);
+
+exports.Carousel = Carousel;
+//# sourceMappingURL=Carousel.js.map

package/dist-cjs/Carousel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Carousel.js","sources":["../src/Carousel.tsx"],"sourcesContent":["import { makePrefixer } from \"@salt-ds/core\";\nimport { useComponentCssInjection } from \"@salt-ds/styles\";\nimport { useWindow } from \"@salt-ds/window\";\nimport { clsx } from \"clsx\";\nimport useEmblaCarousel, {\n  type UseEmblaCarouselType,\n} from \"embla-carousel-react\";\nimport { type ComponentPropsWithoutRef, forwardRef, useEffect } from \"react\";\nimport carouselCss from \"./Carousel.css\";\nimport { CarouselContext } from \"./CarouselContext\";\n\nconst withBaseName = makePrefixer(\"saltCarousel\");\n\nexport type CarouselEmblaRefType = UseEmblaCarouselType[0];\nexport type CarouselEmblaApiType = UseEmblaCarouselType[1];\n\ntype UseCarouselParameters = Parameters<typeof useEmblaCarousel>;\nexport type CarouselOptions = UseCarouselParameters[0];\nexport type CarouselPlugin = UseCarouselParameters[1];\n\n/**\n * Props for the Carousel component.\n * Pass a ref to the carousel to get it to return a reference to the embla API\n */\nexport interface CarouselProps extends ComponentPropsWithoutRef<\"section\"> {\n  /**\n   * Options to configure the Embla Carousel.\n   * These options are passed directly to the Embla Carousel instance.\n   */\n  emblaOptions?: CarouselOptions;\n\n  /**\n   * Plugins to enhance the functionality of the Embla Carousel.\n   * These options are passed directly to the Embla Carousel instance.\n   */\n  emblaPlugins?: CarouselPlugin;\n  /** Get embla API as ref, use this to manage the state of the Carousel */\n  getEmblaApi?: (embla: CarouselEmblaApiType) => void;\n}\n\nexport const Carousel = forwardRef<HTMLElement, CarouselProps>(\n  function Carousel(\n    {\n      children,\n      className,\n      emblaOptions = {},\n      emblaPlugins = [],\n      getEmblaApi,\n      ...rest\n    },\n    ref,\n  ) {\n    const targetWindow = useWindow();\n    useComponentCssInjection({\n      testId: \"salt-carousel\",\n      css: carouselCss,\n      window: targetWindow,\n    });\n\n    const [emblaRef, emblaApi] = useEmblaCarousel(emblaOptions, [\n      ...emblaPlugins,\n    ]);\n\n    useEffect(() => {\n      if (emblaApi) {\n        getEmblaApi?.(emblaApi);\n      }\n      return undefined;\n    }, [emblaApi]);\n\n    return (\n      <CarouselContext.Provider value={{ emblaApi, emblaRef }}>\n        <section\n          aria-roledescription=\"carousel\"\n          role=\"region\"\n          className={clsx(withBaseName(), className)}\n          ref={ref}\n          {...rest}\n        >\n          {children}\n        </section>\n      </CarouselContext.Provider>\n    );\n  },\n);\n"],"names":["makePrefixer","forwardRef","Carousel","useWindow","useComponentCssInjection","carouselCss","useEffect","jsx","CarouselContext","clsx"],"mappings":";;;;;;;;;;;;AAWA,MAAM,YAAA,GAAeA,kBAAa,cAAc,CAAA;AA6BzC,MAAM,QAAW,GAAAC,gBAAA;AAAA,EACtB,SAASC,SACP,CAAA;AAAA,IACE,QAAA;AAAA,IACA,SAAA;AAAA,IACA,eAAe,EAAC;AAAA,IAChB,eAAe,EAAC;AAAA,IAChB,WAAA;AAAA,IACA,GAAG;AAAA,KAEL,GACA,EAAA;AACA,IAAA,MAAM,eAAeC,gBAAU,EAAA;AAC/B,IAAyBC,+BAAA,CAAA;AAAA,MACvB,MAAQ,EAAA,eAAA;AAAA,MACR,GAAK,EAAAC,UAAA;AAAA,MACL,MAAQ,EAAA;AAAA,KACT,CAAA;AAED,IAAA,MAAM,CAAC,QAAA,EAAU,QAAQ,CAAA,GAAI,iBAAiB,YAAc,EAAA;AAAA,MAC1D,GAAG;AAAA,KACJ,CAAA;AAED,IAAAC,eAAA,CAAU,MAAM;AACd,MAAA,IAAI,QAAU,EAAA;AACZ,QAAc,WAAA,IAAA,IAAA,GAAA,MAAA,GAAA,WAAA,CAAA,QAAA,CAAA;AAAA;AAEhB,MAAO,OAAA,MAAA;AAAA,KACT,EAAG,CAAC,QAAQ,CAAC,CAAA;AAEb,IACE,uBAAAC,cAAA,CAACC,gCAAgB,QAAhB,EAAA,EAAyB,OAAO,EAAE,QAAA,EAAU,UAC3C,EAAA,QAAA,kBAAAD,cAAA;AAAA,MAAC,SAAA;AAAA,MAAA;AAAA,QACC,sBAAqB,EAAA,UAAA;AAAA,QACrB,IAAK,EAAA,QAAA;AAAA,QACL,SAAW,EAAAE,SAAA,CAAK,YAAa,EAAA,EAAG,SAAS,CAAA;AAAA,QACzC,GAAA;AAAA,QACC,GAAG,IAAA;AAAA,QAEH;AAAA;AAAA,KAEL,EAAA,CAAA;AAAA;AAGN;;;;"}

package/dist-cjs/CarouselAnnouncementPlugin.js

@@ -0,0 +1,55 @@
+'use strict';
+
+var core = require('@salt-ds/core');
+var react = require('react');
+
+const getSlideLabel = (slideElement, slideIndex, slideCount) => {
+  let description = slideElement == null ? void 0 : slideElement.getAttribute("aria-label");
+  if (!description) {
+    const labelledById = slideElement == null ? void 0 : slideElement.getAttribute("aria-labelledby");
+    if (labelledById) {
+      const labelledByElement = document.getElementById(labelledById);
+      description = (labelledByElement == null ? void 0 : labelledByElement.textContent) || "No description available";
+    } else {
+      description = "No description available";
+    }
+  }
+  return `slide ${slideIndex + 1} of ${slideCount}. ${description}`;
+};
+function CarouselAnnouncement(userOptions = {}) {
+  let emblaApi;
+  const { announce } = core.useAriaAnnouncer();
+  const handleSettle = react.useCallback(
+    (emblaApi2) => {
+      var _a;
+      const slideCount = (emblaApi2 == null ? void 0 : emblaApi2.slideNodes().length) ?? 0;
+      const slideIndexInView = ((_a = emblaApi2 == null ? void 0 : emblaApi2.slidesInView()) == null ? void 0 : _a[0]) ?? 0;
+      const slideElement = emblaApi2 == null ? void 0 : emblaApi2.slideNodes()[slideIndexInView];
+      const slideLabel = getSlideLabel(
+        slideElement,
+        slideIndexInView,
+        slideCount
+      );
+      announce(slideLabel);
+    },
+    [announce]
+  );
+  function init(emblaApiInstance) {
+    emblaApi = emblaApiInstance;
+    emblaApi.on("settle", handleSettle);
+  }
+  function destroy() {
+    emblaApi.off("settle", handleSettle);
+  }
+  const self = {
+    name: "announcement",
+    options: userOptions,
+    init,
+    destroy
+  };
+  return self;
+}
+
+exports.CarouselAnnouncement = CarouselAnnouncement;
+exports.getSlideLabel = getSlideLabel;
+//# sourceMappingURL=CarouselAnnouncementPlugin.js.map

package/dist-cjs/CarouselAnnouncementPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CarouselAnnouncementPlugin.js","sources":["../src/CarouselAnnouncementPlugin.ts"],"sourcesContent":["import { useAriaAnnouncer } from \"@salt-ds/core\";\nimport type {\n  CreateOptionsType,\n  CreatePluginType,\n  EmblaCarouselType,\n} from \"embla-carousel\";\nimport { useCallback } from \"react\";\n\ndeclare module \"embla-carousel\" {\n  interface EmblaPluginsType {\n    announcement: CarouselAnnouncementType;\n  }\n}\n\n/**\n * Type definition for the parameters of the getSlideLabel function.\n */\nexport type GetSlideLabelProps = (\n  /**\n   * The HTML element representing the slide.\n   */\n  slideElement: HTMLElement,\n\n  /**\n   * The index of the slide within the carousel.\n   */\n  slideIndex: number,\n\n  /**\n   * The total number of slides in the carousel.\n   */\n  slideCount: number,\n) => string;\n\n/**\n * Generates a label for a carousel slide based on ARIA attributes.\n *\n * @param props - The properties required to generate the slide description.\n * @returns A string description of the slide, including its position and ARIA label or text content.\n */\nexport const getSlideLabel: GetSlideLabelProps = (\n  slideElement,\n  slideIndex,\n  slideCount,\n): string => {\n  let description = slideElement?.getAttribute(\"aria-label\");\n  if (!description) {\n    const labelledById = slideElement?.getAttribute(\"aria-labelledby\");\n    if (labelledById) {\n      const labelledByElement = document.getElementById(labelledById);\n      description =\n        labelledByElement?.textContent || \"No description available\";\n    } else {\n      description = \"No description available\";\n    }\n  }\n  return `slide ${slideIndex + 1} of ${slideCount}. ${description}`;\n};\n\n// biome-ignore lint/complexity/noBannedTypes: Replicated from embla docs/code\ntype OptionsType = CreateOptionsType<{}>;\n// biome-ignore lint/complexity/noBannedTypes: Replicated from embla docs/code\nexport type CarouselAnnouncementType = CreatePluginType<{}, OptionsType>;\n\nexport type CarouselAnnouncementOptionsType =\n  CarouselAnnouncementType[\"options\"];\n\nexport function CarouselAnnouncement(\n  userOptions: CarouselAnnouncementOptionsType = {},\n): CarouselAnnouncementType {\n  let emblaApi: EmblaCarouselType;\n\n  const { announce } = useAriaAnnouncer();\n\n  const handleSettle = useCallback(\n    (emblaApi: EmblaCarouselType) => {\n      const slideCount = emblaApi?.slideNodes().length ?? 0;\n      const slideIndexInView = emblaApi?.slidesInView()?.[0] ?? 0;\n      const slideElement = emblaApi?.slideNodes()[slideIndexInView];\n\n      const slideLabel = getSlideLabel(\n        slideElement,\n        slideIndexInView,\n        slideCount,\n      );\n      announce(slideLabel);\n    },\n    [announce],\n  );\n\n  function init(emblaApiInstance: EmblaCarouselType): void {\n    emblaApi = emblaApiInstance;\n    emblaApi.on(\"settle\", handleSettle);\n  }\n\n  function destroy(): void {\n    emblaApi.off(\"settle\", handleSettle);\n  }\n\n  const self: CarouselAnnouncementType = {\n    name: \"announcement\",\n    options: userOptions,\n    init,\n    destroy,\n  };\n  return self;\n}\n"],"names":["useAriaAnnouncer","useCallback","emblaApi"],"mappings":";;;;;AAwCO,MAAM,aAAoC,GAAA,CAC/C,YACA,EAAA,UAAA,EACA,UACW,KAAA;AACX,EAAI,IAAA,WAAA,GAAc,6CAAc,YAAa,CAAA,YAAA,CAAA;AAC7C,EAAA,IAAI,CAAC,WAAa,EAAA;AAChB,IAAM,MAAA,YAAA,GAAe,6CAAc,YAAa,CAAA,iBAAA,CAAA;AAChD,IAAA,IAAI,YAAc,EAAA;AAChB,MAAM,MAAA,iBAAA,GAAoB,QAAS,CAAA,cAAA,CAAe,YAAY,CAAA;AAC9D,MAAA,WAAA,GAAA,CACE,uDAAmB,WAAe,KAAA,0BAAA;AAAA,KAC/B,MAAA;AACL,MAAc,WAAA,GAAA,0BAAA;AAAA;AAChB;AAEF,EAAA,OAAO,SAAS,UAAa,GAAA,CAAC,CAAO,IAAA,EAAA,UAAU,KAAK,WAAW,CAAA,CAAA;AACjE;AAUgB,SAAA,oBAAA,CACd,WAA+C,GAAA,EACrB,EAAA;AAC1B,EAAI,IAAA,QAAA;AAEJ,EAAM,MAAA,EAAE,QAAS,EAAA,GAAIA,qBAAiB,EAAA;AAEtC,EAAA,MAAM,YAAe,GAAAC,iBAAA;AAAA,IACnB,CAACC,SAAgC,KAAA;AA3ErC,MAAA,IAAA,EAAA;AA4EM,MAAA,MAAM,UAAaA,GAAAA,CAAAA,SAAAA,IAAA,IAAAA,GAAAA,MAAAA,GAAAA,SAAAA,CAAU,aAAa,MAAU,KAAA,CAAA;AACpD,MAAA,MAAM,qBAAmB,EAAAA,GAAAA,SAAAA,IAAA,gBAAAA,SAAU,CAAA,YAAA,EAAA,KAAV,mBAA2B,CAAM,CAAA,KAAA,CAAA;AAC1D,MAAA,MAAM,YAAeA,GAAAA,SAAAA,IAAA,IAAAA,GAAAA,MAAAA,GAAAA,SAAAA,CAAU,UAAa,EAAA,CAAA,gBAAA,CAAA;AAE5C,MAAA,MAAM,UAAa,GAAA,aAAA;AAAA,QACjB,YAAA;AAAA,QACA,gBAAA;AAAA,QACA;AAAA,OACF;AACA,MAAA,QAAA,CAAS,UAAU,CAAA;AAAA,KACrB;AAAA,IACA,CAAC,QAAQ;AAAA,GACX;AAEA,EAAA,SAAS,KAAK,gBAA2C,EAAA;AACvD,IAAW,QAAA,GAAA,gBAAA;AACX,IAAS,QAAA,CAAA,EAAA,CAAG,UAAU,YAAY,CAAA;AAAA;AAGpC,EAAA,SAAS,OAAgB,GAAA;AACvB,IAAS,QAAA,CAAA,GAAA,CAAI,UAAU,YAAY,CAAA;AAAA;AAGrC,EAAA,MAAM,IAAiC,GAAA;AAAA,IACrC,IAAM,EAAA,cAAA;AAAA,IACN,OAAS,EAAA,WAAA;AAAA,IACT,IAAA;AAAA,IACA;AAAA,GACF;AACA,EAAO,OAAA,IAAA;AACT;;;;;"}

package/dist-cjs/CarouselAutoplayIndicator.css.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var css_248z = ".saltCarouselAutoplayIndicator {\n  --salt-carousel-svg-circumference: 0;\n  display: flex;\n  align-self: center;\n}\n\n.saltCarouselAutoplayIndicatorSVG {\n  transform: rotate(-90deg);\n}\n\n.saltCarouselAutoplayIndicatorSVG-track {\n  fill: none;\n  stroke: var(--salt-accent-foreground);\n}\n\n.saltCarouselAutoplayIndicatorSVG-bar {\n  fill: none;\n  stroke: var(--salt-accent-background);\n  stroke-dasharray: var(--salt-carousel-svg-circumference);\n  stroke-dashoffset: var(--salt-carousel-svg-circumference);\n  animation: indicatorAnimation 0.5s linear;\n  animation-play-state: paused;\n}\n\n@keyframes indicatorAnimation {\n  from {\n    stroke-dashoffset: var(--salt-carousel-svg-circumference);\n  }\n  to {\n    stroke-dashoffset: 0;\n  }\n}\n";
+
+module.exports = css_248z;
+//# sourceMappingURL=CarouselAutoplayIndicator.css.js.map

package/dist-cjs/CarouselAutoplayIndicator.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CarouselAutoplayIndicator.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist-cjs/CarouselAutoplayIndicator.js

@@ -0,0 +1,82 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var core = require('@salt-ds/core');
+var styles = require('@salt-ds/styles');
+var window = require('@salt-ds/window');
+var clsx = require('classnames');
+var react = require('react');
+var CarouselAutoplayIndicator$1 = require('./CarouselAutoplayIndicator.css.js');
+var CarouselAutoplayIndicatorSVG = require('./CarouselAutoplayIndicatorSVG.js');
+
+const withBaseName = core.makePrefixer("saltCarouselAutoplayIndicator");
+const sizeAndStrokeWidthMapping = {
+  high: { size: 10, strokeWidth: 2 },
+  medium: { size: 12, strokeWidth: 2 },
+  low: { size: 14, strokeWidth: 2 },
+  touch: { size: 16, strokeWidth: 2 }
+};
+const CarouselAutoplayIndicator = react.forwardRef(({ className, duration, slideIndex, isPlaying, children, ...props }, ref) => {
+  const targetWindow = window.useWindow();
+  styles.useComponentCssInjection({
+    testId: "salt-carousel-autoplay-indicator",
+    css: CarouselAutoplayIndicator$1,
+    window: targetWindow
+  });
+  const barRef = react.useRef(null);
+  const animationFrameId = react.useRef(null);
+  const density = core.useDensity();
+  const { size, strokeWidth } = sizeAndStrokeWidthMapping[density];
+  const radius = (size - strokeWidth) / 2;
+  const circumference = 2 * Math.PI * radius;
+  react.useEffect(() => {
+    if (barRef.current) {
+      animationFrameId.current = requestAnimationFrame(() => {
+        if (!barRef.current) {
+          return;
+        }
+        barRef.current.style.animation = "none";
+        barRef.current.style.strokeDashoffset = `${circumference}`;
+        animationFrameId.current = requestAnimationFrame(() => {
+          if (!barRef.current) {
+            return;
+          }
+          barRef.current.style.animation = `indicatorAnimation ${duration}ms linear`;
+          barRef.current.style.animationPlayState = isPlaying ? "running" : "paused";
+        });
+      });
+    }
+    return () => {
+      if (animationFrameId.current !== null) {
+        cancelAnimationFrame(animationFrameId.current);
+        animationFrameId.current = null;
+      }
+    };
+  }, [circumference, duration, slideIndex, isPlaying]);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "div",
+    {
+      ref,
+      style: {
+        width: size,
+        height: size,
+        // @ts-ignore
+        "--salt-carousel-svg-circumference": circumference
+      },
+      className: clsx(withBaseName(), className),
+      ...props,
+      children: /* @__PURE__ */ jsxRuntime.jsx(
+        CarouselAutoplayIndicatorSVG.CarouselAutoplayIndicatorSVG,
+        {
+          size,
+          strokeWidth,
+          barRef,
+          radius
+        }
+      )
+    }
+  );
+});
+
+exports.CarouselAutoplayIndicator = CarouselAutoplayIndicator;
+//# sourceMappingURL=CarouselAutoplayIndicator.js.map

package/dist-cjs/CarouselAutoplayIndicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CarouselAutoplayIndicator.js","sources":["../src/CarouselAutoplayIndicator.tsx"],"sourcesContent":["import { makePrefixer, useDensity } from \"@salt-ds/core\";\nimport { useComponentCssInjection } from \"@salt-ds/styles\";\nimport { useWindow } from \"@salt-ds/window\";\nimport clsx from \"classnames\";\nimport {\n  type ComponentPropsWithoutRef,\n  forwardRef,\n  useEffect,\n  useRef,\n} from \"react\";\nimport carouselAutoplayIndicator from \"./CarouselAutoplayIndicator.css\";\nimport { CarouselAutoplayIndicatorSVG } from \"./CarouselAutoplayIndicatorSVG\";\n\nexport interface CarouselAutoplayIndicatorProps\n  extends ComponentPropsWithoutRef<\"div\"> {\n  /**\n   * Duration of each slide in milliseconds.\n   */\n  duration: number;\n  /**\n   * Index of slide currently displayed.\n   */\n  slideIndex: number;\n  /**\n   * If `true`, the indicator is animated to visualize the time until the next slide.\n   */\n  isPlaying: boolean;\n}\n\nconst withBaseName = makePrefixer(\"saltCarouselAutoplayIndicator\");\n\nconst sizeAndStrokeWidthMapping = {\n  high: { size: 10, strokeWidth: 2 },\n  medium: { size: 12, strokeWidth: 2 },\n  low: { size: 14, strokeWidth: 2 },\n  touch: { size: 16, strokeWidth: 2 },\n};\n\nexport const CarouselAutoplayIndicator = forwardRef<\n  HTMLDivElement,\n  CarouselAutoplayIndicatorProps\n>(({ className, duration, slideIndex, isPlaying, children, ...props }, ref) => {\n  const targetWindow = useWindow();\n  useComponentCssInjection({\n    testId: \"salt-carousel-autoplay-indicator\",\n    css: carouselAutoplayIndicator,\n    window: targetWindow,\n  });\n\n  const barRef = useRef<SVGCircleElement | null>(null);\n  const animationFrameId = useRef<number | null>(null);\n\n  const density = useDensity();\n  const { size, strokeWidth } = sizeAndStrokeWidthMapping[density];\n  const radius = (size - strokeWidth) / 2;\n  const circumference = 2 * Math.PI * radius;\n\n  useEffect(() => {\n    if (barRef.current) {\n      animationFrameId.current = requestAnimationFrame(() => {\n        if (!barRef.current) {\n          return;\n        }\n        barRef.current.style.animation = \"none\"; // Reset animation\n        barRef.current.style.strokeDashoffset = `${circumference}`;\n        animationFrameId.current = requestAnimationFrame(() => {\n          if (!barRef.current) {\n            return;\n          }\n          barRef.current.style.animation = `indicatorAnimation ${duration}ms linear`;\n          barRef.current.style.animationPlayState = isPlaying\n            ? \"running\"\n            : \"paused\";\n        });\n      });\n    }\n\n    return () => {\n      if (animationFrameId.current !== null) {\n        cancelAnimationFrame(animationFrameId.current);\n        animationFrameId.current = null;\n      }\n    };\n  }, [circumference, duration, slideIndex, isPlaying]);\n\n  return (\n    <div\n      ref={ref}\n      style={{\n        width: size,\n        height: size,\n        // @ts-ignore\n        \"--salt-carousel-svg-circumference\": circumference,\n      }}\n      className={clsx(withBaseName(), className)}\n      {...props}\n    >\n      <CarouselAutoplayIndicatorSVG\n        size={size}\n        strokeWidth={strokeWidth}\n        barRef={barRef}\n        radius={radius}\n      />\n    </div>\n  );\n});\n"],"names":["makePrefixer","forwardRef","useWindow","useComponentCssInjection","carouselAutoplayIndicator","useRef","useDensity","useEffect","jsx","CarouselAutoplayIndicatorSVG"],"mappings":"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"}

package/dist-cjs/CarouselAutoplayIndicatorSVG.js

@@ -0,0 +1,54 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var core = require('@salt-ds/core');
+var clsx = require('classnames');
+var react = require('react');
+
+const withBaseName = core.makePrefixer("saltCarouselAutoplayIndicatorSVG");
+const CarouselAutoplayIndicatorSVG = react.forwardRef(
+  ({
+    barRef,
+    className,
+    radius,
+    size,
+    strokeWidth
+  }, ref) => {
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "svg",
+      {
+        className: clsx(withBaseName(), className),
+        width: size,
+        height: size,
+        "aria-hidden": true,
+        ref,
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "circle",
+            {
+              className: withBaseName("track"),
+              cx: size / 2,
+              cy: size / 2,
+              r: radius,
+              strokeWidth
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "circle",
+            {
+              ref: barRef,
+              className: withBaseName("bar"),
+              cx: size / 2,
+              cy: size / 2,
+              r: radius,
+              strokeWidth
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+
+exports.CarouselAutoplayIndicatorSVG = CarouselAutoplayIndicatorSVG;
+//# sourceMappingURL=CarouselAutoplayIndicatorSVG.js.map

package/dist-cjs/CarouselAutoplayIndicatorSVG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CarouselAutoplayIndicatorSVG.js","sources":["../src/CarouselAutoplayIndicatorSVG.tsx"],"sourcesContent":["import { makePrefixer } from \"@salt-ds/core\";\nimport clsx from \"classnames\";\nimport { type SVGAttributes, forwardRef } from \"react\";\nconst withBaseName = makePrefixer(\"saltCarouselAutoplayIndicatorSVG\");\n\nexport interface CarouselAutoplayIndicatorSVGProps\n  extends SVGAttributes<SVGSVGElement> {\n  /**\n   * Class name to apply to the SVG element.\n   */\n  className?: string;\n  /**\n   * Ref to attach to progress indicator element\n   */\n  barRef: React.Ref<SVGCircleElement>;\n  /**\n   * Size of the SVG in pixels.\n   */\n  size: number;\n  /**\n   * Stroke width of the progress indicator in pixels.\n   */\n  strokeWidth: number;\n  /**\n   * Radius of the progress indicator circle.\n   */\n  radius: number;\n}\n\nexport const CarouselAutoplayIndicatorSVG = forwardRef<\n  SVGSVGElement,\n  CarouselAutoplayIndicatorSVGProps\n>(\n  (\n    {\n      barRef,\n      className,\n      radius,\n      size,\n      strokeWidth,\n    }: CarouselAutoplayIndicatorSVGProps,\n    ref,\n  ) => {\n    return (\n      <svg\n        className={clsx(withBaseName(), className)}\n        width={size}\n        height={size}\n        aria-hidden\n        ref={ref}\n      >\n        <circle\n          className={withBaseName(\"track\")}\n          cx={size / 2}\n          cy={size / 2}\n          r={radius}\n          strokeWidth={strokeWidth}\n        />\n        <circle\n          ref={barRef}\n          className={withBaseName(\"bar\")}\n          cx={size / 2}\n          cy={size / 2}\n          r={radius}\n          strokeWidth={strokeWidth}\n        />\n      </svg>\n    );\n  },\n);\n"],"names":["makePrefixer","forwardRef","jsxs","jsx"],"mappings":";;;;;;;AAGA,MAAM,YAAA,GAAeA,kBAAa,kCAAkC,CAAA;AA0B7D,MAAM,4BAA+B,GAAAC,gBAAA;AAAA,EAI1C,CACE;AAAA,IACE,MAAA;AAAA,IACA,SAAA;AAAA,IACA,MAAA;AAAA,IACA,IAAA;AAAA,IACA;AAAA,KAEF,GACG,KAAA;AACH,IACE,uBAAAC,eAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,SAAW,EAAA,IAAA,CAAK,YAAa,EAAA,EAAG,SAAS,CAAA;AAAA,QACzC,KAAO,EAAA,IAAA;AAAA,QACP,MAAQ,EAAA,IAAA;AAAA,QACR,aAAW,EAAA,IAAA;AAAA,QACX,GAAA;AAAA,QAEA,QAAA,EAAA;AAAA,0BAAAC,cAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,SAAA,EAAW,aAAa,OAAO,CAAA;AAAA,cAC/B,IAAI,IAAO,GAAA,CAAA;AAAA,cACX,IAAI,IAAO,GAAA,CAAA;AAAA,cACX,CAAG,EAAA,MAAA;AAAA,cACH;AAAA;AAAA,WACF;AAAA,0BACAA,cAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,GAAK,EAAA,MAAA;AAAA,cACL,SAAA,EAAW,aAAa,KAAK,CAAA;AAAA,cAC7B,IAAI,IAAO,GAAA,CAAA;AAAA,cACX,IAAI,IAAO,GAAA,CAAA;AAAA,cACX,CAAG,EAAA,MAAA;AAAA,cACH;AAAA;AAAA;AACF;AAAA;AAAA,KACF;AAAA;AAGN;;;;"}

package/dist-cjs/CarouselCard.css.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var css_248z = ".saltCarouselCard {\n  display: flex;\n  transform: translate3d(0, 0, 0);\n  flex: 0 0 var(--saltCarousel-slide-size);\n  min-width: 0;\n  padding-left: var(--saltCarousel-slide-spacing);\n  box-sizing: border-box;\n}\n\n.saltCarouselCard-content {\n  display: flex;\n  user-select: none;\n  overflow: hidden;\n  flex-direction: column;\n  gap: var(--salt-spacing-200);\n  flex-grow: 1;\n}\n\n.saltCarouselCard-body {\n  display: flex;\n  overflow: hidden;\n  flex-direction: column;\n  gap: var(--salt-spacing-200);\n  flex-grow: 1;\n  padding: 0 var(--salt-spacing-200) var(--salt-spacing-200) var(--salt-spacing-200);\n}\n\n.saltCarouselCard-content h2,\n.saltCarouselCard-content h3 {\n  margin: 0;\n}\n\n.saltCarouselCard[data-visibility=\"off-screen\"] a {\n  visibility: hidden;\n}\n\n.saltCarouselCard-bordered {\n  background: var(--salt-container-primary-background);\n  border: var(--salt-size-border) var(--salt-container-borderStyle) var(--salt-container-primary-borderColor);\n  border-radius: var(--salt-palette-corner, 0);\n}\n";
+
+module.exports = css_248z;
+//# sourceMappingURL=CarouselCard.css.js.map

package/dist-cjs/CarouselCard.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CarouselCard.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}