@mitodl/smoot-design 0.0.0-0a23f44

package/dist/cjs/components/VisuallyHidden/VisuallyHidden.d.ts

@@ -0,0 +1,24 @@
+/**
+ * VisuallyHidden is a utility component that hides its children from sighted
+ * users, but keeps them accessible to screen readers.
+ *
+ * Often, screenreader-only content can be handled with an `aria-label`. However,
+ * occasionally we need actual elements.
+ *
+ * Example:
+ *  - a visually hidden aria-live section that reads announcements that
+ *    isual users can ascertain in some other way.
+ *  - a visually hidden Heading for a section whose purpose is clear for sighted users
+ *  - a visually hidden description used for aria-describeddby
+ *     - There is an aria-description attribute that can be used to provide a
+ *       without an actual element on the page. However, it is introduced in
+ *       ARIA 1.3 (working draft), not compatible with some screen readers, and
+ *       flagged problematic by our linting.
+ *
+ * The CSS here is based on https://inclusive-components.design/tooltips-toggletips/
+ */
+declare const VisuallyHidden: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, {}>;
+export { VisuallyHidden };

package/dist/cjs/components/VisuallyHidden/VisuallyHidden.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VisuallyHidden = void 0;
+const styled_1 = require("@emotion/styled");
+/**
+ * VisuallyHidden is a utility component that hides its children from sighted
+ * users, but keeps them accessible to screen readers.
+ *
+ * Often, screenreader-only content can be handled with an `aria-label`. However,
+ * occasionally we need actual elements.
+ *
+ * Example:
+ *  - a visually hidden aria-live section that reads announcements that
+ *    isual users can ascertain in some other way.
+ *  - a visually hidden Heading for a section whose purpose is clear for sighted users
+ *  - a visually hidden description used for aria-describeddby
+ *     - There is an aria-description attribute that can be used to provide a
+ *       without an actual element on the page. However, it is introduced in
+ *       ARIA 1.3 (working draft), not compatible with some screen readers, and
+ *       flagged problematic by our linting.
+ *
+ * The CSS here is based on https://inclusive-components.design/tooltips-toggletips/
+ */
+const VisuallyHidden = styled_1.default.span({
+    clipPath: "inset(100%)",
+    clip: "rect(1px, 1px, 1px, 1px)",
+    height: "1px",
+    overflow: "hidden",
+    position: "absolute",
+    whiteSpace: "nowrap",
+    width: "1px",
+});
+exports.VisuallyHidden = VisuallyHidden;

package/dist/cjs/components/VisuallyHidden/VisuallyHidden.stories.d.ts

@@ -0,0 +1,6 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { VisuallyHidden } from "./VisuallyHidden";
+declare const meta: Meta<typeof VisuallyHidden>;
+export default meta;
+type Story = StoryObj<typeof VisuallyHidden>;
+export declare const ScreenreaderOnly: Story;

package/dist/cjs/components/VisuallyHidden/VisuallyHidden.stories.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScreenreaderOnly = void 0;
+const VisuallyHidden_1 = require("./VisuallyHidden");
+const meta = {
+    title: "smoot-design/VisuallyHidden",
+    component: VisuallyHidden_1.VisuallyHidden,
+    args: {
+        children: "Not visible, but screen readers can still read this text.",
+    },
+};
+exports.default = meta;
+exports.ScreenreaderOnly = {};

package/dist/cjs/components/internal/FormHelpers/FormHelpers.d.ts

@@ -0,0 +1,39 @@
+import * as React from "react";
+declare const Description: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+} & {
+    error?: boolean;
+}, React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+type ControlLabelProps = {
+    htmlFor: string;
+    label: React.ReactNode;
+    required?: boolean;
+    id?: string;
+    fullWidth?: boolean;
+};
+declare const ControlLabel: React.FC<ControlLabelProps>;
+type FormFieldWrapperProps = {
+    label: React.ReactNode;
+    required?: boolean;
+    helpText?: string;
+    error?: boolean;
+    errorText?: string;
+    className?: string;
+    fullWidth?: boolean;
+    /**
+     * The id of the input element. If not provided, a unique id will be generated.
+     */
+    id?: string;
+    children: (childProps: {
+        id: string;
+        required?: boolean;
+        error?: boolean;
+        fullWidth?: boolean;
+        labelId: string;
+        "aria-describedby"?: string;
+    }) => React.ReactNode;
+};
+declare const FormFieldWrapper: React.FC<FormFieldWrapperProps>;
+export { FormFieldWrapper, ControlLabel, Description };
+export type { FormFieldWrapperProps, ControlLabelProps };

package/dist/cjs/components/internal/FormHelpers/FormHelpers.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Description = exports.ControlLabel = exports.FormFieldWrapper = void 0;
+const React = require("react");
+const styled_1 = require("@emotion/styled");
+const react_1 = require("@remixicon/react");
+const Typography_1 = require("@mui/material/Typography");
+const Required = styled_1.default.span(({ theme }) => ({
+    color: theme.custom.colors.lightRed,
+    marginLeft: "4px",
+}));
+const Description = styled_1.default.div(({ theme, error }) => [
+    Object.assign(Object.assign({}, theme.typography.body2), { color: error
+            ? theme.custom.colors.lightRed
+            : theme.custom.colors.silverGrayDark }),
+    error && {
+        textIndent: "-24px",
+        paddingLeft: "24px",
+        "> svg:first-of-type": {
+            marginRight: "4px",
+            transform: "translateY(2px)",
+            width: "18px",
+            height: "18px",
+            position: "relative",
+            top: "2px",
+        },
+    },
+]);
+exports.Description = Description;
+const Container = styled_1.default.div(({ fullWidth }) => [
+    {
+        display: "inline-flex",
+        flexDirection: "column",
+        alignItems: "start",
+        "> *:not(:last-child)": {
+            marginBottom: "4px",
+        },
+    },
+    fullWidth && {
+        width: "100%",
+    },
+]);
+const ControlLabel = ({ htmlFor, label, required, id, fullWidth, }) => {
+    return (React.createElement(Typography_1.default, { id: id, component: "label", htmlFor: htmlFor, variant: "subtitle2", sx: { marginBottom: "4px", width: fullWidth ? "100%" : "auto" } },
+        label,
+        required ? React.createElement(Required, { "aria-hidden": "true" }, "*") : null));
+};
+exports.ControlLabel = ControlLabel;
+const FormFieldWrapper = ({ label, required, helpText, error, errorText, className, fullWidth, id, children, }) => {
+    const fallbackInputId = React.useId();
+    const inputId = id || fallbackInputId;
+    const helpId = React.useId();
+    const errorId = React.useId();
+    const labelId = React.useId();
+    /**
+     * aria-errormessage would be more semantic for the error message but has
+     * somewhat limited support. See https://github.com/w3c/aria/issues/2048 for
+     * some related information.
+     */
+    const describedBy = [helpText && helpId, error && errorText && errorId]
+        .filter(Boolean)
+        .join(" ") || undefined;
+    return (React.createElement(Container, { className: className, fullWidth: fullWidth },
+        React.createElement(ControlLabel, { htmlFor: inputId, id: labelId, label: label, required: required, fullWidth: fullWidth }),
+        children({
+            id: inputId,
+            error,
+            required,
+            labelId,
+            fullWidth,
+            "aria-describedby": describedBy,
+        }),
+        helpText && React.createElement(Description, { id: helpId }, helpText),
+        error && errorText && (React.createElement(Description, { id: errorId, error: true },
+            React.createElement(react_1.RiErrorWarningLine, { fontSize: "inherit" }),
+            errorText))));
+};
+exports.FormFieldWrapper = FormFieldWrapper;

package/dist/cjs/components/internal/FormHelpers/FormHelpers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/components/internal/FormHelpers/FormHelpers.test.js

@@ -0,0 +1,93 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const React = require("react");
+const react_1 = require("@testing-library/react");
+const FormHelpers_1 = require("./FormHelpers");
+const ThemeProvider_1 = require("../../../components/ThemeProvider/ThemeProvider");
+const en_1 = require("@faker-js/faker/locale/en");
+const assertDescription = ({ text, total, exists, }) => {
+    var _a;
+    const input = react_1.screen.getByRole("textbox");
+    const describedBy = input.getAttribute("aria-describedby");
+    const descriptionIds = (_a = describedBy === null || describedBy === void 0 ? void 0 : describedBy.split(" ")) !== null && _a !== void 0 ? _a : [];
+    if (total === 0) {
+        expect(describedBy).toBe(null);
+    }
+    expect(descriptionIds.length).toBe(total);
+    const description = react_1.screen.queryByText(text);
+    expect(!!description).toBe(exists);
+    if (exists) {
+        expect(description).toBeInTheDocument();
+        expect(descriptionIds).toContain(description === null || description === void 0 ? void 0 : description.id);
+    }
+};
+describe("FormFieldWrapper", () => {
+    const setup = (props) => {
+        const defaults = {
+            name: "test-name",
+            value: "test-value",
+            label: "test-label",
+        };
+        const { rerender: _rerender } = (0, react_1.render)(React.createElement(FormHelpers_1.FormFieldWrapper, Object.assign({}, defaults, props), (_a) => {
+            var { error, labelId, fullWidth } = _a, childProps = __rest(_a, ["error", "labelId", "fullWidth"]);
+            return (React.createElement("input", Object.assign({}, childProps)));
+        }), {
+            wrapper: ThemeProvider_1.ThemeProvider,
+        });
+        const rerender = (newProps) => {
+            _rerender(React.createElement(FormHelpers_1.FormFieldWrapper, Object.assign({}, defaults, newProps), (_a) => {
+                var { error, labelId, fullWidth } = _a, childProps = __rest(_a, ["error", "labelId", "fullWidth"]);
+                return (React.createElement("input", Object.assign({}, childProps)));
+            }));
+        };
+        return { rerender };
+    };
+    it("Labels the input", () => {
+        const label = en_1.faker.lorem.words();
+        setup({ label });
+        const input = react_1.screen.getByRole("textbox", { name: label });
+        expect(input).toBeInstanceOf(HTMLInputElement);
+    });
+    it("Has a description only if description provided", () => {
+        const label = en_1.faker.lorem.words();
+        const helpText = en_1.faker.lorem.words();
+        const { rerender } = setup({ label, helpText });
+        assertDescription({ text: helpText, total: 1, exists: true });
+        rerender({ label });
+        assertDescription({ text: helpText, total: 0, exists: false });
+    });
+    it("Has an error message only if errorText provided AND error=true", () => {
+        const label = en_1.faker.lorem.words();
+        const errorText = en_1.faker.lorem.words();
+        const { rerender } = setup({ label, errorText, error: true });
+        assertDescription({ text: errorText, total: 1, exists: true });
+        rerender({ label, errorText });
+        assertDescription({ text: errorText, total: 0, exists: false });
+        rerender({ label, error: true });
+        assertDescription({ text: errorText, total: 0, exists: false });
+        rerender({ label, errorText, error: true });
+        assertDescription({ text: errorText, total: 1, exists: true });
+    });
+    it("Shows both description and errormessage if both provided and error", () => {
+        const label = en_1.faker.lorem.words();
+        const errorText = en_1.faker.lorem.words();
+        const helpText = en_1.faker.lorem.words();
+        const { rerender } = setup({ label, errorText, helpText });
+        assertDescription({ text: helpText, total: 1, exists: true });
+        assertDescription({ text: errorText, total: 1, exists: false });
+        rerender({ label, errorText, helpText, error: true });
+        assertDescription({ text: helpText, total: 2, exists: true });
+        assertDescription({ text: errorText, total: 2, exists: true });
+    });
+});

package/dist/cjs/index.d.ts

@@ -0,0 +1,25 @@
+export { default as styled } from "@emotion/styled";
+export { css, Global } from "@emotion/react";
+export { ThemeProvider, createTheme, } from "./components/ThemeProvider/ThemeProvider";
+export { Alert } from "./components/Alert/Alert";
+export type { AlertProps } from "./components/Alert/Alert";
+export { Button, ButtonLoadingIcon, ButtonLink, } from "./components/Button/Button";
+export type { ButtonProps, ButtonLinkProps } from "./components/Button/Button";
+export { ActionButton, ActionButtonLink, } from "./components/Button/ActionButton";
+export type { ActionButtonProps, ActionButtonLinkProps, } from "./components/Button/ActionButton";
+export type { LinkAdapterPropsOverrides } from "./components/LinkAdapter/LinkAdapter";
+export { Input, AdornmentButton } from "./components/Input/Input";
+export type { InputProps, AdornmentButtonProps } from "./components/Input/Input";
+export { TextField } from "./components/TextField/TextField";
+export type { TextFieldProps } from "./components/TextField/TextField";
+export { Checkbox, childCheckboxStyles } from "./components/Checkbox/Checkbox";
+export type { CheckboxProps } from "./components/Checkbox/Checkbox";
+export { CheckboxChoiceField } from "./components/CheckboxChoiceField/CheckboxChoiceField";
+export type { CheckboxChoiceFieldProps } from "./components/CheckboxChoiceField/CheckboxChoiceField";
+export { RadioChoiceField, BooleanRadioChoiceField, } from "./components/RadioChoiceField/RadioChoiceField";
+export type { RadioChoiceFieldProps, BooleanRadioChoiceFieldProps, } from "./components/RadioChoiceField/RadioChoiceField";
+export { SrAnnouncer } from "./components/SrAnnouncer/SrAnnouncer";
+export type { SrAnnouncerProps } from "./components/SrAnnouncer/SrAnnouncer";
+export { TabButton, TabButtonLink, TabButtonList, } from "./components/TabButtons/TabButtonList";
+export { VERSION } from "./VERSION";
+export { VisuallyHidden } from "./components/VisuallyHidden/VisuallyHidden";

package/dist/cjs/index.js

@@ -0,0 +1,44 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VisuallyHidden = exports.VERSION = exports.TabButtonList = exports.TabButtonLink = exports.TabButton = exports.SrAnnouncer = exports.BooleanRadioChoiceField = exports.RadioChoiceField = exports.CheckboxChoiceField = exports.childCheckboxStyles = exports.Checkbox = exports.TextField = exports.AdornmentButton = exports.Input = exports.ActionButtonLink = exports.ActionButton = exports.ButtonLink = exports.ButtonLoadingIcon = exports.Button = exports.Alert = exports.createTheme = exports.ThemeProvider = exports.Global = exports.css = exports.styled = void 0;
+var styled_1 = require("@emotion/styled");
+Object.defineProperty(exports, "styled", { enumerable: true, get: function () { return styled_1.default; } });
+var react_1 = require("@emotion/react");
+Object.defineProperty(exports, "css", { enumerable: true, get: function () { return react_1.css; } });
+Object.defineProperty(exports, "Global", { enumerable: true, get: function () { return react_1.Global; } });
+var ThemeProvider_1 = require("./components/ThemeProvider/ThemeProvider");
+Object.defineProperty(exports, "ThemeProvider", { enumerable: true, get: function () { return ThemeProvider_1.ThemeProvider; } });
+Object.defineProperty(exports, "createTheme", { enumerable: true, get: function () { return ThemeProvider_1.createTheme; } });
+var Alert_1 = require("./components/Alert/Alert");
+Object.defineProperty(exports, "Alert", { enumerable: true, get: function () { return Alert_1.Alert; } });
+var Button_1 = require("./components/Button/Button");
+Object.defineProperty(exports, "Button", { enumerable: true, get: function () { return Button_1.Button; } });
+Object.defineProperty(exports, "ButtonLoadingIcon", { enumerable: true, get: function () { return Button_1.ButtonLoadingIcon; } });
+Object.defineProperty(exports, "ButtonLink", { enumerable: true, get: function () { return Button_1.ButtonLink; } });
+var ActionButton_1 = require("./components/Button/ActionButton");
+Object.defineProperty(exports, "ActionButton", { enumerable: true, get: function () { return ActionButton_1.ActionButton; } });
+Object.defineProperty(exports, "ActionButtonLink", { enumerable: true, get: function () { return ActionButton_1.ActionButtonLink; } });
+var Input_1 = require("./components/Input/Input");
+Object.defineProperty(exports, "Input", { enumerable: true, get: function () { return Input_1.Input; } });
+Object.defineProperty(exports, "AdornmentButton", { enumerable: true, get: function () { return Input_1.AdornmentButton; } });
+var TextField_1 = require("./components/TextField/TextField");
+Object.defineProperty(exports, "TextField", { enumerable: true, get: function () { return TextField_1.TextField; } });
+var Checkbox_1 = require("./components/Checkbox/Checkbox");
+Object.defineProperty(exports, "Checkbox", { enumerable: true, get: function () { return Checkbox_1.Checkbox; } });
+Object.defineProperty(exports, "childCheckboxStyles", { enumerable: true, get: function () { return Checkbox_1.childCheckboxStyles; } });
+var CheckboxChoiceField_1 = require("./components/CheckboxChoiceField/CheckboxChoiceField");
+Object.defineProperty(exports, "CheckboxChoiceField", { enumerable: true, get: function () { return CheckboxChoiceField_1.CheckboxChoiceField; } });
+var RadioChoiceField_1 = require("./components/RadioChoiceField/RadioChoiceField");
+Object.defineProperty(exports, "RadioChoiceField", { enumerable: true, get: function () { return RadioChoiceField_1.RadioChoiceField; } });
+Object.defineProperty(exports, "BooleanRadioChoiceField", { enumerable: true, get: function () { return RadioChoiceField_1.BooleanRadioChoiceField; } });
+var SrAnnouncer_1 = require("./components/SrAnnouncer/SrAnnouncer");
+Object.defineProperty(exports, "SrAnnouncer", { enumerable: true, get: function () { return SrAnnouncer_1.SrAnnouncer; } });
+var TabButtonList_1 = require("./components/TabButtons/TabButtonList");
+Object.defineProperty(exports, "TabButton", { enumerable: true, get: function () { return TabButtonList_1.TabButton; } });
+Object.defineProperty(exports, "TabButtonLink", { enumerable: true, get: function () { return TabButtonList_1.TabButtonLink; } });
+Object.defineProperty(exports, "TabButtonList", { enumerable: true, get: function () { return TabButtonList_1.TabButtonList; } });
+var VERSION_1 = require("./VERSION");
+Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return VERSION_1.VERSION; } });
+var VisuallyHidden_1 = require("./components/VisuallyHidden/VisuallyHidden");
+Object.defineProperty(exports, "VisuallyHidden", { enumerable: true, get: function () { return VisuallyHidden_1.VisuallyHidden; } });

package/dist/cjs/jest-setup.d.ts

@@ -0,0 +1 @@
+import "@testing-library/jest-dom";

package/dist/cjs/jest-setup.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("@testing-library/jest-dom");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const failOnConsole = require("jest-fail-on-console");
+failOnConsole();
+beforeAll(() => {
+    const scrollBy = jest.fn();
+    HTMLElement.prototype.scrollBy = scrollBy;
+});
+afterEach(() => {
+    /**
+     * Clear all mock call counts between tests.
+     * This does NOT clear mock implementations.
+     * Mock implementations are always cleared between test files.
+     */
+    jest.clearAllMocks();
+});

package/dist/cjs/jsdom-extended.d.ts

@@ -0,0 +1,6 @@
+import { TestEnvironment } from "jest-environment-jsdom";
+import { EnvironmentContext, JestEnvironmentConfig } from "@jest/environment";
+declare class JSDOMEnvironmentExtended extends TestEnvironment {
+    constructor(config: JestEnvironmentConfig, context: EnvironmentContext);
+}
+export default JSDOMEnvironmentExtended;

package/dist/cjs/jsdom-extended.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Jest environment extended with Web APIs para tranbajar con MSW
+const jest_environment_jsdom_1 = require("jest-environment-jsdom");
+class JSDOMEnvironmentExtended extends jest_environment_jsdom_1.TestEnvironment {
+    constructor(config, context) {
+        super(config, context);
+        this.global.TransformStream = TransformStream;
+        this.global.ReadableStream = ReadableStream;
+        this.global.Response = Response;
+        this.global.TextDecoderStream = TextDecoderStream;
+    }
+}
+exports.default = JSDOMEnvironmentExtended;

package/dist/cjs/story-utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A type helper just to make sure an array contains union values.
+ */
+declare const enumValues: <T extends string | undefined>(obj: Record<NonNullable<T>, unknown>) => NonNullable<T>[];
+declare const gitLink: (filepath: string) => string;
+export { enumValues, gitLink };

package/dist/cjs/story-utils/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gitLink = exports.enumValues = void 0;
+/**
+ * A type helper just to make sure an array contains union values.
+ */
+const enumValues = (obj) => {
+    return Object.keys(obj);
+};
+exports.enumValues = enumValues;
+const gitLink = (filepath) => {
+    if (!filepath.startsWith("src/")) {
+        throw new Error(`Invalid filepath: ${filepath}\nShould start with "src/"`);
+    }
+    return `https://github.com/mitodl/smoot-design/blob/${process.env.STORYBOOK_GIT_SHA}/${filepath}`;
+};
+exports.gitLink = gitLink;

package/dist/cjs/utils/composeRefs.d.ts

@@ -0,0 +1,7 @@
+import type { MutableRefObject, ForwardedRef, RefCallback } from "react";
+/**
+ * Compose 2+ refs. Useful when a reusable component needs a ref itself, but
+ * consumers may also need the ref.
+ */
+declare const composeRefs: <T>(...refs: (ForwardedRef<T> | MutableRefObject<T | undefined> | RefCallback<T>)[]) => RefCallback<T>;
+export { composeRefs };

package/dist/cjs/utils/composeRefs.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeRefs = void 0;
+/**
+ * Compose 2+ refs. Useful when a reusable component needs a ref itself, but
+ * consumers may also need the ref.
+ */
+const composeRefs = (...refs) => {
+    return (value) => {
+        refs.forEach((ref) => {
+            if (typeof ref === "function") {
+                ref(value);
+            }
+            else if (ref) {
+                ref.current = value;
+            }
+        });
+    };
+};
+exports.composeRefs = composeRefs;

package/dist/cjs/utils/composeRefs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/utils/composeRefs.test.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const React = require("react");
+const composeRefs_1 = require("./composeRefs");
+const react_1 = require("@testing-library/react");
+describe("composeRefs", () => {
+    test("Composing object + fn ref", () => {
+        const objRef1 = React.createRef();
+        const objRef2 = React.createRef();
+        const fnRef1 = jest.fn();
+        const fnRef2 = jest.fn();
+        (0, react_1.render)(React.createElement("div", { "data-testid": "my-div", ref: (0, composeRefs_1.composeRefs)(objRef1, objRef2, fnRef1, fnRef2) }));
+        const el = react_1.screen.getByTestId("my-div");
+        expect(objRef1.current).toBe(el);
+        expect(objRef2.current).toBe(el);
+        expect(fnRef1).toHaveBeenCalledWith(el);
+        expect(fnRef2).toHaveBeenCalledWith(el);
+    });
+});

package/dist/cjs/utils/retryingFetch.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A wrapper around fetch that retries the request on certain error codes.
+ *
+ * By default:
+ *
+ * Requests will be retried if max retries not exceeded and :
+ *  - The status code is >= 400 AND NOT in the NO_RETRY_ERROR_CODES list,
+ *  - OR the request promise rejected (network error)
+ *
+ * The retry delay is exponential, 1s, 2s, 4s, 8s, ... maxing at 30s.
+ *
+ * Maximum retries is 3.
+ *
+ * NOTE:
+ *  - When NODE_ENV="test", the maximum retries is set 0 by default but can be
+ *  set via the TEST_ENV_MAX_RETRIES environment variable.
+ */
+declare const retryingFetch: ((input: RequestInfo | URL, init?: RequestInit) => Promise<Response>) & typeof globalThis.fetch;
+export default retryingFetch;

package/dist/cjs/utils/retryingFetch.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const MAX_RETRIES = 3;
+const NO_RETRY_ERROR_CODES = [400, 401, 403, 404, 405, 409, 422];
+const BASE_RETRY_DELAY = process.env.NODE_ENV === "test" ? 10 : 1000;
+// This is a workaround to ensure retryingFetch uses MSW's fetch version in tests.
+// See https://github.com/jonbern/fetch-retry/issues/95#issuecomment-2613990480
+const fetch = (...args) => window.fetch(...args);
+// From https://github.com/jonbern/fetch-retry/blob/master/index.js
+const fetchRetry = (fetch, { retryDelay, retryOn }) => {
+    return (input, init) => {
+        return new Promise((resolve, reject) => {
+            const wrappedFetch = (attempt) => {
+                const _input = typeof Request !== "undefined" && input instanceof Request
+                    ? input.clone()
+                    : input;
+                fetch(_input, init)
+                    .then((response) => {
+                    try {
+                        Promise.resolve(retryOn(attempt, null, response))
+                            .then((retryOnResponse) => {
+                            if (retryOnResponse) {
+                                retry(attempt, null, response);
+                            }
+                            else {
+                                resolve(response);
+                            }
+                        })
+                            .catch(reject);
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                })
+                    .catch((error) => {
+                    try {
+                        Promise.resolve(retryOn(attempt, error, null))
+                            .then((retryOnResponse) => {
+                            if (retryOnResponse) {
+                                retry(attempt, error, null);
+                            }
+                            else {
+                                reject(error);
+                            }
+                        })
+                            .catch((error) => {
+                            reject(error);
+                        });
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                });
+            };
+            const retry = (attempt, error, response) => {
+                const delay = retryDelay(attempt, error, response);
+                setTimeout(() => {
+                    wrappedFetch(++attempt);
+                }, delay);
+            };
+            wrappedFetch(0);
+        });
+    };
+};
+/**
+ * A wrapper around fetch that retries the request on certain error codes.
+ *
+ * By default:
+ *
+ * Requests will be retried if max retries not exceeded and :
+ *  - The status code is >= 400 AND NOT in the NO_RETRY_ERROR_CODES list,
+ *  - OR the request promise rejected (network error)
+ *
+ * The retry delay is exponential, 1s, 2s, 4s, 8s, ... maxing at 30s.
+ *
+ * Maximum retries is 3.
+ *
+ * NOTE:
+ *  - When NODE_ENV="test", the maximum retries is set 0 by default but can be
+ *  set via the TEST_ENV_MAX_RETRIES environment variable.
+ */
+const retryingFetch = fetchRetry(fetch, {
+    retryDelay: (attempt, _error, _response) => {
+        return Math.min(BASE_RETRY_DELAY * Math.pow(2, attempt), 30000);
+    },
+    retryOn: (attempt, _error, response) => {
+        if (attempt >= MAX_RETRIES) {
+            return false;
+        }
+        if (response) {
+            if (response.status < 400)
+                return false;
+            return !NO_RETRY_ERROR_CODES.includes(response.status);
+        }
+        return true;
+    },
+});
+exports.default = retryingFetch;

package/dist/cjs/utils/retryingFetch.test.d.ts

@@ -0,0 +1 @@
+export {};