@mitodl/smoot-design 0.0.0-7bc0c0f

package/dist/esm/components/ThemeProvider/colors.js

@@ -0,0 +1,32 @@
+const colors = {
+    mitRed: "#750014",
+    brightRed: "#FF1423",
+    black: "#000000",
+    white: "#FFFFFF",
+    darkGray2: "#212326",
+    darkGray1: "#40464C",
+    silverGrayDark: "#626A73",
+    silverGray: "#8B959E",
+    silverGrayLight: "#B8C2CC",
+    lightGray2: "#DDE1E6",
+    lightGray1: "#F3F4F8",
+    navGray: "#303337",
+    darkPink: "#750062",
+    pink: "#FF14F0",
+    lightPink: "#FFB3FF",
+    darkPurple: "#3E006B",
+    purple: "#93F",
+    lightPurple: "#BFB3FF",
+    darkBlue: "#002896",
+    blue: "#1966FF",
+    lightBlue: "#99EBFF",
+    darkGreen: "#004D1A",
+    green: "#00AD00",
+    lightGreen: "#AF3",
+    darkRed: "#83192A",
+    red: "#A31F34",
+    lightRed: "#D02E44",
+    orange: "#FAB005",
+    yellow: "#FFEB00",
+};
+export { colors };

package/dist/esm/components/ThemeProvider/typography.d.ts

@@ -0,0 +1,18 @@
+import type { ThemeOptions } from "@mui/material/styles";
+/**
+ * This function converts from pixels to rems, assuming a base font size of 16px
+ * (which is the default for most modern browsers).
+ *
+ * Using this function, we can:
+ * - match desgins that are in pixels for default font size
+ * - allow users to scale the font size up or down by chaning base font size.
+ *
+ * For example, a Chrome user might specify a base font size of 20px ("large")
+ * in their browser settings. Then, `pxToRem(32)` would actually be 40px for
+ * that user.
+ */
+declare const pxToRem: (px: number) => string;
+declare const globalSettings: ThemeOptions["typography"];
+declare const component: NonNullable<ThemeOptions["components"]>["MuiTypography"];
+declare const typography: import("@mui/material/styles").TypographyVariants;
+export { globalSettings, component, pxToRem, typography };

package/dist/esm/components/ThemeProvider/typography.js

@@ -0,0 +1,167 @@
+import { createTheme } from "@mui/material/styles";
+const fontWeights = {
+    text: {
+        roman: 400,
+        medium: 500,
+        bold: 700,
+    },
+};
+/**
+ * This function converts from pixels to rems, assuming a base font size of 16px
+ * (which is the default for most modern browsers).
+ *
+ * Using this function, we can:
+ * - match desgins that are in pixels for default font size
+ * - allow users to scale the font size up or down by chaning base font size.
+ *
+ * For example, a Chrome user might specify a base font size of 20px ("large")
+ * in their browser settings. Then, `pxToRem(32)` would actually be 40px for
+ * that user.
+ */
+const pxToRem = (px) => `${px / 16}rem`;
+const globalSettings = {
+    // Note: Figma calls this "Neue Haas Grotesk Text", but that is incorrect based on Adobe's font family.
+    fontFamily: "neue-haas-grotesk-text, sans-serif",
+    fontWeightLight: fontWeights.text.roman,
+    fontWeightRegular: fontWeights.text.roman,
+    fontWeightMedium: fontWeights.text.medium,
+    fontWeightBold: fontWeights.text.bold,
+    h1: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.bold,
+        fontStyle: "normal",
+        fontSize: pxToRem(52),
+        lineHeight: pxToRem(60),
+    },
+    h2: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.bold,
+        fontStyle: "normal",
+        fontSize: pxToRem(34),
+        lineHeight: pxToRem(40),
+    },
+    h3: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.bold,
+        fontStyle: "normal",
+        fontSize: pxToRem(28),
+        lineHeight: pxToRem(36),
+    },
+    h4: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.bold,
+        fontStyle: "normal",
+        fontSize: pxToRem(24),
+        lineHeight: pxToRem(30),
+    },
+    h5: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.medium,
+        fontStyle: "normal",
+        fontSize: pxToRem(18),
+        lineHeight: pxToRem(22),
+    },
+    subtitle1: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.medium,
+        fontStyle: "normal",
+        fontSize: pxToRem(16),
+        lineHeight: pxToRem(20),
+    },
+    subtitle2: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.medium,
+        fontStyle: "normal",
+        fontSize: pxToRem(14),
+        lineHeight: pxToRem(18),
+    },
+    subtitle3: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.medium,
+        fontStyle: "normal",
+        fontSize: pxToRem(12),
+        lineHeight: pxToRem(16),
+    },
+    subtitle4: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.medium,
+        fontStyle: "normal",
+        fontSize: pxToRem(10),
+        lineHeight: pxToRem(14),
+    },
+    body1: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.roman,
+        fontStyle: "normal",
+        fontSize: pxToRem(16),
+        lineHeight: pxToRem(20),
+    },
+    body2: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.roman,
+        fontStyle: "normal",
+        fontSize: pxToRem(14),
+        lineHeight: pxToRem(18),
+    },
+    body3: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.roman,
+        fontStyle: "normal",
+        fontSize: pxToRem(12),
+        lineHeight: pxToRem(16),
+    },
+    body4: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.roman,
+        fontStyle: "normal",
+        fontSize: pxToRem(10),
+        lineHeight: pxToRem(14),
+    },
+    buttonLarge: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.medium,
+        fontStyle: "normal",
+        fontSize: pxToRem(16),
+        lineHeight: pxToRem(20),
+    },
+    button: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.medium,
+        fontStyle: "normal",
+        fontSize: pxToRem(14),
+        lineHeight: pxToRem(18),
+        textTransform: "none",
+    },
+    buttonSmall: {
+        fontFamily: "neue-haas-grotesk-text, sans-serif",
+        fontWeight: fontWeights.text.medium,
+        fontStyle: "normal",
+        fontSize: pxToRem(12),
+        lineHeight: pxToRem(16),
+    },
+};
+const component = {
+    defaultProps: {
+        variantMapping: {
+            h1: "span",
+            h2: "span",
+            h3: "span",
+            h4: "span",
+            h5: "span",
+            body1: "p",
+            body2: "p",
+            body3: "p",
+            body4: "p",
+            subtitle1: "p",
+            subtitle2: "p",
+            subtitle3: "p",
+            subtitle4: "p",
+            button: "span",
+        },
+    },
+};
+const { typography } = createTheme({
+    typography: globalSettings,
+    custom: {},
+});
+export { globalSettings, component, pxToRem, typography };

package/dist/esm/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/esm/components/VisuallyHidden/VisuallyHidden.js

@@ -0,0 +1,30 @@
+import styled from "@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.span({
+    clipPath: "inset(100%)",
+    clip: "rect(1px, 1px, 1px, 1px)",
+    height: "1px",
+    overflow: "hidden",
+    position: "absolute",
+    whiteSpace: "nowrap",
+    width: "1px",
+});
+export { VisuallyHidden };

package/dist/esm/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/esm/components/VisuallyHidden/VisuallyHidden.stories.js

@@ -0,0 +1,10 @@
+import { VisuallyHidden } from "./VisuallyHidden";
+const meta = {
+    title: "smoot-design/VisuallyHidden",
+    component: VisuallyHidden,
+    args: {
+        children: "Not visible, but screen readers can still read this text.",
+    },
+};
+export default meta;
+export const ScreenreaderOnly = {};

package/dist/esm/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/esm/components/internal/FormHelpers/FormHelpers.js

@@ -0,0 +1,73 @@
+import * as React from "react";
+import styled from "@emotion/styled";
+import { RiErrorWarningLine } from "@remixicon/react";
+import Typography from "@mui/material/Typography";
+const Required = styled.span(({ theme }) => ({
+    color: theme.custom.colors.lightRed,
+    marginLeft: "4px",
+}));
+const Description = styled.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",
+        },
+    },
+]);
+const Container = styled.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, { id: id, component: "label", htmlFor: htmlFor, variant: "subtitle2", sx: { marginBottom: "4px", width: fullWidth ? "100%" : "auto" } },
+        label,
+        required ? React.createElement(Required, { "aria-hidden": "true" }, "*") : null));
+};
+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(RiErrorWarningLine, { fontSize: "inherit" }),
+            errorText))));
+};
+export { FormFieldWrapper, ControlLabel, Description };

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

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

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

@@ -0,0 +1,91 @@
+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;
+};
+import * as React from "react";
+import { render, screen } from "@testing-library/react";
+import { FormFieldWrapper } from "./FormHelpers";
+import { ThemeProvider } from "../../../components/ThemeProvider/ThemeProvider";
+import { faker } from "@faker-js/faker/locale/en";
+const assertDescription = ({ text, total, exists, }) => {
+    var _a;
+    const input = 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 = 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 } = render(React.createElement(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,
+        });
+        const rerender = (newProps) => {
+            _rerender(React.createElement(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 = faker.lorem.words();
+        setup({ label });
+        const input = screen.getByRole("textbox", { name: label });
+        expect(input).toBeInstanceOf(HTMLInputElement);
+    });
+    it("Has a description only if description provided", () => {
+        const label = faker.lorem.words();
+        const helpText = 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 = faker.lorem.words();
+        const errorText = 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 = faker.lorem.words();
+        const errorText = faker.lorem.words();
+        const helpText = 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/esm/index.d.ts

@@ -0,0 +1,16 @@
+export { default as styled } from "@emotion/styled";
+export { css, Global } from "@emotion/react";
+export { ThemeProvider, createTheme, } from "./components/ThemeProvider/ThemeProvider";
+export { Button, 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 } from "./components/Input/Input";
+export type { InputProps } from "./components/Input/Input";
+export { TextField } from "./components/TextField/TextField";
+export type { TextFieldProps } from "./components/TextField/TextField";
+export { SrAnnouncer } from "./components/SrAnnouncer/SrAnnouncer";
+export type { SrAnnouncerProps } from "./components/SrAnnouncer/SrAnnouncer";
+export { TabButton, TabButtonLink, TabButtonList, } from "./components/TabButtons/TabButtonList";
+export { VisuallyHidden } from "./components/VisuallyHidden/VisuallyHidden";

package/dist/esm/index.js

@@ -0,0 +1,11 @@
+"use client";
+export { default as styled } from "@emotion/styled";
+export { css, Global } from "@emotion/react";
+export { ThemeProvider, createTheme, } from "./components/ThemeProvider/ThemeProvider";
+export { Button, ButtonLink } from "./components/Button/Button";
+export { ActionButton, ActionButtonLink, } from "./components/Button/ActionButton";
+export { Input } from "./components/Input/Input";
+export { TextField } from "./components/TextField/TextField";
+export { SrAnnouncer } from "./components/SrAnnouncer/SrAnnouncer";
+export { TabButton, TabButtonLink, TabButtonList, } from "./components/TabButtons/TabButtonList";
+export { VisuallyHidden } from "./components/VisuallyHidden/VisuallyHidden";

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

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

package/dist/esm/jest-setup.js

@@ -0,0 +1,16 @@
+import "@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/esm/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/esm/jsdom-extended.js

@@ -0,0 +1,12 @@
+// Jest environment extended with Web APIs para tranbajar con MSW
+import { TestEnvironment } from "jest-environment-jsdom";
+class JSDOMEnvironmentExtended extends TestEnvironment {
+    constructor(config, context) {
+        super(config, context);
+        this.global.TransformStream = TransformStream;
+        this.global.ReadableStream = ReadableStream;
+        this.global.Response = Response;
+        this.global.TextDecoderStream = TextDecoderStream;
+    }
+}
+export default JSDOMEnvironmentExtended;

package/dist/esm/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/esm/story-utils/index.js

@@ -0,0 +1,13 @@
+/**
+ * A type helper just to make sure an array contains union values.
+ */
+const enumValues = (obj) => {
+    return Object.keys(obj);
+};
+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}`;
+};
+export { enumValues, gitLink };

package/dist/esm/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/esm/utils/composeRefs.js

@@ -0,0 +1,17 @@
+/**
+ * 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;
+            }
+        });
+    };
+};
+export { composeRefs };

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

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

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

@@ -0,0 +1,17 @@
+import * as React from "react";
+import { composeRefs } from "./composeRefs";
+import { render, screen } from "@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();
+        render(React.createElement("div", { "data-testid": "my-div", ref: composeRefs(objRef1, objRef2, fnRef1, fnRef2) }));
+        const el = screen.getByTestId("my-div");
+        expect(objRef1.current).toBe(el);
+        expect(objRef2.current).toBe(el);
+        expect(fnRef1).toHaveBeenCalledWith(el);
+        expect(fnRef2).toHaveBeenCalledWith(el);
+    });
+});

package/dist/esm/utils/useDevCheckStable.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Emits `console.error` if two subsequent values of `jsonSerializable` serialize
+ * to the same thing but are different references.
+ *
+ * This hook does NOT run in production.
+ */
+declare const useDevCheckStable: (jsonSerializable: unknown, msg?: string) => void;
+export { useDevCheckStable };