reshaped 3.3.11 → 3.3.13

package/dist/components/Card/tests/Card.test.stories.d.ts

@@ -0,0 +1,35 @@
+import React from "react";
+import { StoryObj } from "@storybook/react";
+import { fn } from "@storybook/test";
+declare const _default: {
+    title: string;
+    component: React.ForwardRefExoticComponent<{
+        padding?: import("../../../types/global").Responsive<number>;
+        bleed?: import("../../../types/global").Responsive<number>;
+        selected?: boolean;
+        elevated?: boolean;
+        children?: React.ReactNode;
+        onClick?: import("../../Actionable").ActionableProps["onClick"];
+        href?: string;
+        as?: keyof React.JSX.IntrinsicElements | undefined;
+        className?: import("../../../types/global").ClassName;
+        attributes?: (import("../../../types/global").Attributes<keyof React.JSX.IntrinsicElements> & ((import("../../../types/global").Attributes<"button"> & Omit<React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "children" | "ref" | "style" | "form" | "slot" | "title" | "disabled" | "color" | "className" | "hidden" | "content" | "aria-orientation" | "role" | "suppressHydrationWarning" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "value" | "dir" | "name" | "key" | "accessKey" | "autoCapitalize" | "autoFocus" | "contentEditable" | "contextMenu" | "draggable" | "enterKeyHint" | "nonce" | "spellCheck" | "translate" | "radioGroup" | "about" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "popover" | "popoverTargetAction" | "popoverTarget" | "inert" | "inputMode" | "is" | "onToggle" | "type" | "id" | "lang" | "tabIndex" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onResize" | "onResizeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onBeforeToggle" | "onTransitionCancel" | "onTransitionCancelCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "onTransitionRun" | "onTransitionRunCapture" | "onTransitionStart" | "onTransitionStartCapture"> & {
+            ref?: React.RefObject<HTMLButtonElement | HTMLAnchorElement | null>;
+        }) | undefined)) | undefined;
+    } & Pick<import("../../View").ViewProps, "height"> & React.RefAttributes<HTMLElement>>;
+    parameters: {
+        iframe: {
+            url: string;
+        };
+        chromatic: {
+            disableSnapshot: boolean;
+        };
+    };
+};
+export default _default;
+export declare const onClick: StoryObj<{
+    handleClick: ReturnType<typeof fn>;
+}>;
+export declare const href: StoryObj;
+export declare const as: StoryObj;
+export declare const className: StoryObj;

package/dist/components/Card/tests/Card.test.stories.js

@@ -0,0 +1,54 @@
+import React from "react";
+import { expect, fn, userEvent } from "@storybook/test";
+import Card from "../index.js";
+export default {
+    title: "Components/Card/tests",
+    component: Card,
+    parameters: {
+        iframe: {
+            url: "https://reshaped.so/docs/components/card",
+        },
+        chromatic: { disableSnapshot: true },
+    },
+};
+export const onClick = {
+    name: "onClick",
+    args: {
+        handleClick: fn(),
+    },
+    render: (args) => <Card onClick={args.handleClick}>Trigger</Card>,
+    play: async ({ canvas, args }) => {
+        const { handleClick } = args;
+        const el = canvas.getAllByRole("button")[0];
+        await userEvent.click(el);
+        expect(handleClick).toHaveBeenCalledTimes(1);
+        expect(handleClick).toHaveBeenCalledWith(expect.objectContaining({ target: el }));
+    },
+};
+export const href = {
+    name: "href",
+    render: () => <Card href="https://reshaped.so">Trigger</Card>,
+    play: async ({ canvas }) => {
+        const el = canvas.getByRole("link");
+        expect(el).toHaveAttribute("href", "https://reshaped.so");
+    },
+};
+export const as = {
+    name: "as",
+    render: () => <Card as="span" attributes={{ "data-testid": "root" }}/>,
+    play: ({ canvas }) => {
+        const root = canvas.getByTestId("root");
+        expect(root.tagName).toBe("SPAN");
+    },
+};
+export const className = {
+    name: "className, attributes",
+    render: () => (<div data-testid="root">
+			<Card className="test-classname" attributes={{ id: "test-id" }}/>
+		</div>),
+    play: async ({ canvas }) => {
+        const root = canvas.getByTestId("root").firstChild;
+        expect(root).toHaveClass("test-classname");
+        expect(root).toHaveAttribute("id", "test-id");
+    },
+};

package/dist/components/Carousel/Carousel.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
-import { classNames, responsiveVariables, responsiveClassNames, debounceHandler, } from "../../utilities/helpers.js";
+import { classNames, responsiveVariables, responsiveClassNames, throttleHandler, } from "../../utilities/helpers.js";
 import View from "../View/index.js";
 import useRTL from "../../hooks/useRTL.js";
 import useIsomorphicLayoutEffect from "../../hooks/useIsomorphicLayoutEffect.js";
@@ -9,7 +9,9 @@ import CarouselControl from "./CarouselControl.js";
 import * as T from "./Carousel.types.js";
 import s from "./Carousel.module.css";
 const Carousel = (props) => {
-    const { children, gap = 3, visibleItems, bleed, navigationDisplay, instanceRef, className, attributes, } = props;
+    const { children, gap = 3, visibleItems, bleed, navigationDisplay, onChange, instanceRef, className, attributes, } = props;
+    const currentIndexRef = React.useRef(0);
+    const itemRefs = React.useRef([]);
     const [mounted, setMounted] = React.useState(false);
     const [scrollPosition, setScrollPosition] = React.useState(0);
     const [isRTL] = useRTL();
@@ -21,9 +23,20 @@ const Carousel = (props) => {
         });
     }
     const rootClassNames = classNames(s.root, className, ...responsiveClassNames(s, "--bleed", typeof bleed === "number" ? true : bleedClassNames));
-    const handleScroll = debounceHandler((event) => {
+    const handleItemRef = (el, index) => {
+        itemRefs.current[index] = el;
+        // TODO: Enable in React v19 since it introduced refs cleanup
+        // return () => {
+        // 	itemRefs.current[index] = null;
+        // };
+    };
+    const handleScroll = throttleHandler((event) => {
         const el = event.target;
+        const firstVisibleIndex = getFirstVisibleIndex();
         setScrollPosition(el.scrollLeft);
+        if (currentIndexRef.current !== firstVisibleIndex)
+            onChange?.({ index: firstVisibleIndex });
+        currentIndexRef.current = firstVisibleIndex;
     }, 16);
     const getItemsGap = () => {
         const style = getComputedStyle(scrollElRef.current);
@@ -31,6 +44,40 @@ const Carousel = (props) => {
         const xGap = style.gap.split(" ")[0];
         return Number(xGap.replace("px", ""));
     };
+    const getFirstVisibleIndex = () => {
+        let resultIndex = 0;
+        let sizeCalc = 0;
+        const scrollEl = scrollElRef.current;
+        if (!scrollEl)
+            return resultIndex;
+        const scrollValue = isRTL ? -scrollEl.scrollLeft : scrollEl.scrollLeft;
+        const gap = getItemsGap();
+        itemRefs.current.some((el, index) => {
+            if (!el)
+                return false;
+            const visible = sizeCalc + el.clientWidth / 2 >= scrollValue;
+            if (visible) {
+                resultIndex = index;
+                return true;
+            }
+            sizeCalc += el?.clientWidth + gap;
+            return false;
+        });
+        return resultIndex;
+    };
+    const navigateTo = (index) => {
+        const scrollEl = scrollElRef.current;
+        const el = itemRefs.current[index];
+        if (!el)
+            return;
+        scrollEl.scrollTo({
+            // Browsers mirror offsetLeft value but we need to also keep the target element on the other side of the container
+            // so adding addition calculations for the width of the content outside the target el
+            left: isRTL ? el.offsetLeft - (scrollEl.clientWidth - el.clientWidth) : el.offsetLeft,
+            top: 0,
+            behavior: "smooth",
+        });
+    };
     const navigateRight = () => {
         const scrollEl = scrollElRef.current;
         scrollEl.scrollBy({
@@ -52,6 +99,7 @@ const Carousel = (props) => {
     React.useImperativeHandle(instanceRef, () => ({
         navigateBack,
         navigateForward,
+        navigateTo,
     }));
     /**
      * Changing flag here since scroll ref changing won't rerender the controls and show them after SSR
@@ -63,6 +111,6 @@ const Carousel = (props) => {
             ...responsiveVariables("--rs-carousel-items", visibleItems),
             ...responsiveVariables("--rs-carousel-bleed", bleed),
             ...attributes?.style,
-        }, children: [navigationDisplay !== "hidden" && (_jsxs(_Fragment, { children: [_jsx(CarouselControl, { isRTL: isRTL, type: T.ControlType.back, scrollElRef: scrollElRef, scrollPosition: scrollPosition, onClick: navigateBack, mounted: mounted }), _jsx(CarouselControl, { isRTL: isRTL, type: T.ControlType.forward, scrollElRef: scrollElRef, scrollPosition: scrollPosition, onClick: navigateForward, mounted: mounted })] })), _jsx(View, { as: "ul", direction: "row", wrap: false, gap: gap, className: s.scroll, attributes: { ref: scrollElRef, onScroll: handleScroll }, children: React.Children.map(children, (child) => (_jsx(View.Item, { className: s.item, as: "li", children: child }))) })] }));
+        }, children: [navigationDisplay !== "hidden" && (_jsxs(_Fragment, { children: [_jsx(CarouselControl, { isRTL: isRTL, type: T.ControlType.back, scrollElRef: scrollElRef, scrollPosition: scrollPosition, onClick: navigateBack, mounted: mounted }), _jsx(CarouselControl, { isRTL: isRTL, type: T.ControlType.forward, scrollElRef: scrollElRef, scrollPosition: scrollPosition, onClick: navigateForward, mounted: mounted })] })), _jsx(View, { as: "ul", direction: "row", wrap: false, gap: gap, className: s.scroll, attributes: { ref: scrollElRef, onScroll: handleScroll }, children: React.Children.map(children, (child, index) => (_jsx(View.Item, { className: s.item, as: "li", attributes: { ref: (el) => handleItemRef(el, index) }, children: child }))) })] }));
 };
 export default Carousel;

package/dist/components/Carousel/Carousel.types.d.ts

@@ -3,6 +3,7 @@ import type * as G from "../../types/global";
 export type Instance = {
     navigateBack: () => void;
     navigateForward: () => void;
+    navigateTo: (index: number) => void;
 } | undefined;
 export declare enum ControlType {
     back = "back",
@@ -23,6 +24,9 @@ export type Props = {
     bleed?: G.Responsive<number>;
     navigationDisplay?: "hidden";
     instanceRef?: React.Ref<Instance>;
+    onChange?: (args: {
+        index: number;
+    }) => void;
     className?: G.ClassName;
     attributes?: G.Attributes<"div">;
 };

package/dist/components/Carousel/CarouselControl.js

@@ -37,6 +37,6 @@ const CarouselControl = (props) => {
                 clearTimeout(timer);
         };
     }, [scrollPosition, scrollElRef, mounted, isNext]);
-    return (_jsx("div", { className: controlClassNames, "aria-hidden": "true", children: _jsx(Button, { onClick: onClick, icon: isDisplayedAsNext ? IconChevronRight : IconChevronLeft, rounded: true, variant: "outline", elevated: true, attributes: { "aria-disabled": !visible } }) }));
+    return (_jsx("div", { className: controlClassNames, children: _jsx(Button, { onClick: onClick, icon: isDisplayedAsNext ? IconChevronRight : IconChevronLeft, rounded: true, variant: "outline", elevated: true, attributes: { "aria-disabled": !visible, "aria-hidden": true } }) }));
 };
 export default CarouselControl;

package/dist/components/Carousel/tests/Carousel.stories.d.ts

@@ -1,15 +1,34 @@
 import React from "react";
+import { StoryObj } from "@storybook/react";
+import { fn } from "@storybook/test";
 declare const _default: {
     title: string;
     component: (props: import("./..").CarouselProps) => React.JSX.Element;
     parameters: {
+        a11y: {
+            disable: boolean;
+        };
         iframe: {
             url: string;
         };
     };
 };
 export default _default;
-export declare const visibleItems: () => React.JSX.Element;
-export declare const gap: () => React.JSX.Element;
-export declare const bleed: () => React.JSX.Element;
-export declare const navigation: () => React.JSX.Element;
+export declare const base: StoryObj;
+export declare const visibleItems: {
+    name: string;
+    render: () => React.JSX.Element;
+};
+export declare const gap: {
+    name: string;
+    render: () => React.JSX.Element;
+};
+export declare const bleed: {
+    name: string;
+    render: () => React.JSX.Element;
+};
+export declare const navigationDisplay: StoryObj;
+export declare const instanceRef: StoryObj<{
+    handleChange: ReturnType<typeof fn>;
+}>;
+export declare const className: StoryObj;

package/dist/components/Carousel/tests/Carousel.stories.js

@@ -1,4 +1,5 @@
 import React from "react";
+import { expect, fn, userEvent, waitFor } from "@storybook/test";
 import { Example, Placeholder } from "../../../utilities/storybook/index.js";
 import Carousel from "../index.js";
 import Button from "../../Button/index.js";
@@ -7,121 +8,217 @@ export default {
     title: "Components/Carousel",
     component: Carousel,
     parameters: {
+        // Skip because of the aria-hidden applied to buttons, they're replaced by screen reader navigation
+        a11y: {
+            disable: true,
+        },
         iframe: {
             url: "https://reshaped.so/docs/components/carousel",
         },
     },
 };
-export const visibleItems = () => (<Example>
-		<Example.Item title="visibleItems: 3">
-			<Carousel visibleItems={3}>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-			</Carousel>
-		</Example.Item>
+export const base = {
+    name: "base",
+    render: () => (<Carousel attributes={{ "data-testid": "test-id" }} visibleItems={3}>
+			<Placeholder h={100}>Content</Placeholder>
+			<Placeholder h={100}>Content</Placeholder>
+			<Placeholder h={100}>Content</Placeholder>
+			<Placeholder h={100}>Content</Placeholder>
+			<Placeholder h={100}>Content</Placeholder>
+			<Placeholder h={100}>Content</Placeholder>
+		</Carousel>),
+    play: async ({ canvas }) => {
+        const root = canvas.getByTestId("test-id");
+        const items = canvas.getAllByText("Content");
+        const buttons = root.querySelectorAll("button");
+        expect(root).toBeInTheDocument();
+        expect(root.tagName).toBe("SECTION");
+        expect(items).toHaveLength(6);
+        expect(buttons).toHaveLength(2);
+    },
+};
+export const visibleItems = {
+    name: "visibleItems",
+    render: () => (<Example>
+			<Example.Item title="visibleItems: 3">
+				<Carousel visibleItems={3}>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+				</Carousel>
+			</Example.Item>
 
-		<Example.Item title={["responsive visibleItems", "[s] 2", "[m+] 3"]}>
-			<Carousel visibleItems={{ s: 2, m: 3 }}>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-			</Carousel>
-		</Example.Item>
+			<Example.Item title={["responsive visibleItems", "s: 2, m+ 3"]}>
+				<Carousel visibleItems={{ s: 2, m: 3 }}>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+				</Carousel>
+			</Example.Item>
 
-		<Example.Item title="visibleItems: auto">
-			<Carousel>
-				<Placeholder h={100}/>
-				<Placeholder h={100} w={200}/>
-				<Placeholder h={100} w={300}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-			</Carousel>
-		</Example.Item>
-	</Example>);
-export const gap = () => (<Example>
-		<Example.Item title="gap: 2, visibleItems 3">
-			<Carousel visibleItems={3} gap={2}>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-			</Carousel>
-		</Example.Item>
+			<Example.Item title="visibleItems: auto">
+				<Carousel>
+					<Placeholder h={100}/>
+					<Placeholder h={100} w={200}/>
+					<Placeholder h={100} w={300}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+				</Carousel>
+			</Example.Item>
+		</Example>),
+};
+export const gap = {
+    name: "gap",
+    render: () => (<Example>
+			<Example.Item title="gap: 2, visibleItems 3">
+				<Carousel visibleItems={3} gap={2}>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+				</Carousel>
+			</Example.Item>
 
-		<Example.Item title={["responsive gap, visibleItems: 3", "[s] 2", "[l] 8"]}>
-			<Carousel visibleItems={3} gap={{ s: 2, l: 8 }}>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-			</Carousel>
-		</Example.Item>
-	</Example>);
-export const bleed = () => (<Example>
-		<Example.Item title="bleed: 4, visibleItems: 3">
-			<Carousel visibleItems={3} bleed={4}>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-			</Carousel>
-		</Example.Item>
+			<Example.Item title={["gap: responsive, visibleItems: 3", "s: 2, l: 8"]}>
+				<Carousel visibleItems={3} gap={{ s: 2, l: 8 }}>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+				</Carousel>
+			</Example.Item>
+		</Example>),
+};
+export const bleed = {
+    name: "bleed",
+    render: () => (<Example>
+			<Example.Item title="bleed: 4, visibleItems: 3">
+				<Carousel visibleItems={3} bleed={4}>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+				</Carousel>
+			</Example.Item>
 
-		<Example.Item title={["responsive bleed, visibleItems: 3", "[s] 4, [l+] 0"]}>
-			<Carousel visibleItems={3} bleed={{ s: 4, l: 0 }}>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-			</Carousel>
-		</Example.Item>
-	</Example>);
-const RefDemo = () => {
-    const carouselRef = React.useRef(null);
-    return (<View gap={3}>
-			<View gap={3} direction="row">
-				<Button onClick={() => carouselRef.current?.navigateBack()}>Back</Button>
-				<Button onClick={() => carouselRef.current?.navigateForward()}>Forward</Button>
-			</View>
-			<Carousel visibleItems={2} instanceRef={carouselRef} navigationDisplay="hidden">
+			<Example.Item title={["responsive bleed, visibleItems: 3", "[s] 4, [l+] 0"]}>
+				<Carousel visibleItems={3} bleed={{ s: 4, l: 0 }}>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+				</Carousel>
+			</Example.Item>
+		</Example>),
+};
+export const navigationDisplay = {
+    name: "navigationDisplay",
+    render: () => (<Example>
+			<Example.Item title="navigationDisplay: hidden">
+				<Carousel visibleItems={3} navigationDisplay="hidden" attributes={{ "data-testid": "test-id" }}>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+					<Placeholder h={100}/>
+				</Carousel>
+			</Example.Item>
+		</Example>),
+    play: async ({ canvas }) => {
+        const root = canvas.getByTestId("test-id");
+        const buttons = root.querySelectorAll("button");
+        expect(buttons).toHaveLength(0);
+    },
+};
+export const instanceRef = {
+    name: "instanceRef, onChange",
+    args: {
+        handleChange: fn(),
+    },
+    render: (args) => {
+        const carouselRef = React.useRef(null);
+        const [index, setIndex] = React.useState(0);
+        return (<Example>
+				<Example.Item title="instanceRef, onChange">
+					<View gap={3}>
+						<View gap={3} direction="row" align="center">
+							<Button onClick={() => carouselRef.current?.navigateBack()}>Back</Button>
+							<Button onClick={() => carouselRef.current?.navigateForward()}>Forward</Button>
+							<Button onClick={() => carouselRef.current?.navigateTo(3)}>To 3</Button>
+							<View.Item>Index: {index}</View.Item>
+						</View>
+						<Carousel visibleItems={2} instanceRef={carouselRef} navigationDisplay="hidden" onChange={(changeArgs) => {
+                args.handleChange(changeArgs);
+                setIndex(changeArgs.index);
+            }}>
+							<Placeholder h={100}>Item 0</Placeholder>
+							<Placeholder h={100}>Item 1</Placeholder>
+							<Placeholder h={100}>Item 2</Placeholder>
+							<Placeholder h={100}>Item 3</Placeholder>
+							<Placeholder h={100}>Item 4</Placeholder>
+							<Placeholder h={100}>Item 5</Placeholder>
+						</Carousel>
+					</View>
+				</Example.Item>
+			</Example>);
+    },
+    play: async ({ canvas, args }) => {
+        const buttons = canvas.getAllByRole("button");
+        const backButton = buttons[0];
+        const forwardButton = buttons[1];
+        const toButton = buttons[2];
+        await userEvent.click(forwardButton);
+        await waitFor(() => {
+            expect(args.handleChange).toHaveBeenCalledWith({ index: 1 });
+            expect(args.handleChange).toHaveBeenCalledWith({ index: 2 });
+            expect(args.handleChange).not.toHaveBeenCalledWith({ index: 3 });
+        });
+        args.handleChange.mockClear();
+        await userEvent.click(backButton);
+        await waitFor(() => {
+            expect(args.handleChange).toHaveBeenCalledWith({ index: 0 });
+            expect(args.handleChange).toHaveBeenCalledWith({ index: 1 });
+        });
+        args.handleChange.mockClear();
+        await userEvent.click(toButton);
+        await waitFor(() => {
+            expect(args.handleChange).toHaveBeenCalledWith({ index: 1 });
+            expect(args.handleChange).toHaveBeenCalledWith({ index: 2 });
+            expect(args.handleChange).toHaveBeenCalledWith({ index: 3 });
+        });
+    },
+};
+export const className = {
+    name: "className, attributes",
+    render: () => (<div data-testid="root">
+			<Carousel visibleItems={2} className="test-classname" attributes={{ id: "test-id" }}>
+				<Placeholder h={100}>Item 0</Placeholder>
 				<Placeholder h={100}>Item 1</Placeholder>
 				<Placeholder h={100}>Item 2</Placeholder>
 				<Placeholder h={100}>Item 3</Placeholder>
 				<Placeholder h={100}>Item 4</Placeholder>
 				<Placeholder h={100}>Item 5</Placeholder>
-				<Placeholder h={100}>Item 6</Placeholder>
 			</Carousel>
-		</View>);
+		</div>),
+    play: async ({ canvas }) => {
+        const root = canvas.getByTestId("root").firstChild;
+        expect(root).toHaveClass("test-classname");
+        expect(root).toHaveAttribute("id", "test-id");
+    },
 };
-export const navigation = () => (<Example>
-		<Example.Item title="navigation: hidden">
-			<Carousel visibleItems={3} navigationDisplay="hidden">
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-				<Placeholder h={100}/>
-			</Carousel>
-		</Example.Item>
-
-		<Example.Item title="navigation: external">
-			<RefDemo />
-		</Example.Item>
-	</Example>);

package/dist/components/Checkbox/tests/Checkbox.test.stories.d.ts

@@ -0,0 +1,25 @@
+import { StoryObj } from "@storybook/react";
+import { fn } from "@storybook/test";
+declare const _default: {
+    title: string;
+    component: (props: import("./..").CheckboxProps) => import("react").JSX.Element;
+    parameters: {
+        iframe: {
+            url: string;
+        };
+        chromatic: {
+            disableSnapshot: boolean;
+        };
+    };
+};
+export default _default;
+export declare const render: StoryObj;
+export declare const checked: StoryObj<{
+    handleChange: ReturnType<typeof fn>;
+}>;
+export declare const defaultChecked: StoryObj<{
+    handleChange: ReturnType<typeof fn>;
+}>;
+export declare const disabled: StoryObj;
+export declare const indeterminate: StoryObj;
+export declare const className: StoryObj;