@mitodl/smoot-design 0.0.0-1967631

package/dist/esm/components/Input/Input.stories.js

@@ -0,0 +1,132 @@
+import * as React from "react";
+import { Input, AdornmentButton } from "./Input";
+import Stack from "@mui/material/Stack";
+import Grid from "@mui/material/Grid2";
+import { RiCalendarLine, RiCloseLine, RiSearchLine } from "@remixicon/react";
+import { fn } from "@storybook/test";
+import { enumValues } from "../../story-utils";
+import Typography from "@mui/material/Typography";
+const SIZES = enumValues({
+    small: true,
+    medium: true,
+    large: true,
+    chat: true,
+    hero: true,
+});
+const ADORNMENTS = {
+    None: undefined,
+    SearchIcon: (React.createElement(AdornmentButton, null,
+        React.createElement(RiSearchLine, null))),
+    CalendarTodayIcon: (React.createElement(AdornmentButton, null,
+        React.createElement(RiCalendarLine, null))),
+    CloseIcon: (React.createElement(AdornmentButton, null,
+        React.createElement(RiCloseLine, null))),
+    "Close and Calendar": (React.createElement(React.Fragment, null,
+        React.createElement(AdornmentButton, null,
+            React.createElement(RiCloseLine, null)),
+        React.createElement(AdornmentButton, null,
+            React.createElement(RiCalendarLine, null)))),
+};
+const meta = {
+    title: "smoot-design/Input",
+    component: Input,
+    argTypes: {
+        startAdornment: {
+            options: Object.keys(ADORNMENTS),
+            mapping: ADORNMENTS,
+            control: { type: "select" },
+        },
+        endAdornment: {
+            options: Object.keys(ADORNMENTS),
+            mapping: ADORNMENTS,
+            control: { type: "select" },
+        },
+    },
+    args: {
+        onChange: fn(),
+        value: "some value",
+        placeholder: "placeholder",
+    },
+};
+export default meta;
+export const Sizes = {
+    render: (args) => {
+        return (React.createElement(Stack, { direction: "row", gap: 1 },
+            React.createElement(Input, Object.assign({ size: "small" }, args)),
+            React.createElement(Input, Object.assign({ size: "medium" }, args)),
+            React.createElement(Input, Object.assign({ size: "large" }, args)),
+            React.createElement(Input, Object.assign({ size: "hero" }, args))));
+    },
+};
+/**
+ * **Note:** Adornments should be wrapped in an `AdornmentButton` component.
+ *
+ * ```tsx
+ * <Input startAdornment={
+ *  <AdornmentButton>
+ *    <RiSearchLine />
+ *  </AdornmentButton>
+ * } {...otherProps} />
+ * ```
+ */
+export const Adornments = {
+    render: (args) => {
+        const adornments = [
+            { startAdornment: ADORNMENTS.SearchIcon },
+            { endAdornment: ADORNMENTS.CloseIcon },
+            {
+                startAdornment: ADORNMENTS.SearchIcon,
+                endAdornment: ADORNMENTS["Close and Calendar"],
+            },
+        ];
+        return (React.createElement(Grid, { container: true, maxWidth: "1400px", spacing: 2 }, Object.values(adornments).flatMap((props, i) => SIZES.map((size) => {
+            return (React.createElement(Grid, { size: { xs: 3 }, key: `${i}-${size}` },
+                React.createElement(Input, Object.assign({}, args, { size: size }, props))));
+        }))));
+    },
+    argTypes: {
+        startAdornment: { table: { disable: true } },
+        endAdornment: { table: { disable: true } },
+    },
+};
+export const States = {
+    render: (args) => {
+        return (React.createElement(Grid, { container: true, spacing: 2, alignItems: "center", maxWidth: "400px" },
+            React.createElement(Grid, { size: { xs: 4 } },
+                React.createElement(Typography, null, "Placeholder")),
+            React.createElement(Grid, { size: { xs: 8 } },
+                React.createElement(Input, Object.assign({}, args, { value: "" }))),
+            React.createElement(Grid, { size: { xs: 4 } },
+                React.createElement(Typography, null, "Default")),
+            React.createElement(Grid, { size: { xs: 8 } },
+                React.createElement(Input, Object.assign({}, args))),
+            React.createElement(Grid, { size: { xs: 4 } },
+                React.createElement(Typography, null, "Initially Focused")),
+            React.createElement(Grid, { size: { xs: 8 } },
+                React.createElement(Input
+                // This is a story just demonstrating the autofocus prop
+                // eslint-disable-next-line jsx-a11y/no-autofocus
+                , Object.assign({ 
+                    // This is a story just demonstrating the autofocus prop
+                    // eslint-disable-next-line jsx-a11y/no-autofocus
+                    autoFocus: true }, args))),
+            React.createElement(Grid, { size: { xs: 4 } },
+                React.createElement(Typography, null, "Error")),
+            React.createElement(Grid, { size: { xs: 8 } },
+                React.createElement(Input, Object.assign({}, args, { error: true }))),
+            React.createElement(Grid, { size: { xs: 4 } },
+                React.createElement(Typography, null, "Disabled")),
+            React.createElement(Grid, { size: { xs: 8 } },
+                React.createElement(Input, Object.assign({}, args, { disabled: true })))));
+    },
+    args: {
+        placeholder: "This is placeholder text.",
+        value: "Some value",
+    },
+    argTypes: {
+        placeholder: { table: { disable: true } },
+        value: { table: { disable: true } },
+        error: { table: { disable: true } },
+        disabled: { table: { disable: true } },
+    },
+};

package/dist/esm/components/Input/Input.test.d.ts

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

package/dist/esm/components/Input/Input.test.js

@@ -0,0 +1,30 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as React from "react";
+import { render, screen } from "@testing-library/react";
+import user from "@testing-library/user-event";
+import { Input, AdornmentButton } from "./Input";
+import { ThemeProvider } from "../ThemeProvider/ThemeProvider";
+describe("AdornmentButton", () => {
+    it("Does not steal focus from input when clicked", () => __awaiter(void 0, void 0, void 0, function* () {
+        const onClick = jest.fn();
+        render(React.createElement(Input, { endAdornment: React.createElement(AdornmentButton, { onClick: onClick }, "Test") }), { wrapper: ThemeProvider });
+        const input = screen.getByRole("textbox");
+        const button = screen.getByRole("button", { name: "Test" });
+        yield user.click(input);
+        expect(input).toHaveFocus();
+        yield user.click(button);
+        expect(input).toHaveFocus();
+        expect(onClick).toHaveBeenCalledTimes(1);
+        // But it should still be focusable via keyboard
+        yield user.tab();
+        expect(button).toHaveFocus();
+    }));
+});

package/dist/esm/components/LinkAdapter/LinkAdapter.d.ts

@@ -0,0 +1,23 @@
+import * as React from "react";
+/**
+ * LinkAdapterPropsOverrides can be used with module augmentation to provide
+ * extra props to ButtonLink.
+ *
+ * For example, in a NextJS App, you might set `next/link` as your default
+ * Link implementation, and use LinkAdapterPropsOverrides to provide
+ * `next/link`-specific props.
+ */
+interface LinkAdapterPropsOverrides {
+}
+type LinkAdapterProps = React.ComponentProps<"a"> & {
+    Component?: React.ElementType;
+} & LinkAdapterPropsOverrides;
+/**
+ * Overrideable link component.
+ * - If `Component` is provided, renders as `Component`
+ * - else, if `theme.custom.LinkAdapter` is provided, renders as `theme.custom.LinkAdapter`
+ * - else, renders as `a` tag
+ */
+declare const LinkAdapter: React.ForwardRefExoticComponent<Omit<LinkAdapterProps, "ref"> & React.RefAttributes<HTMLAnchorElement>>;
+export { LinkAdapter };
+export type { LinkAdapterPropsOverrides, LinkAdapterProps };

package/dist/esm/components/LinkAdapter/LinkAdapter.js

@@ -0,0 +1,31 @@
+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 { useTheme } from "@emotion/react";
+import styled from "@emotion/styled";
+const PlainLink = styled.a({
+    color: "inherit",
+    textDecoration: "none",
+});
+/**
+ * Overrideable link component.
+ * - If `Component` is provided, renders as `Component`
+ * - else, if `theme.custom.LinkAdapter` is provided, renders as `theme.custom.LinkAdapter`
+ * - else, renders as `a` tag
+ */
+const LinkAdapter = React.forwardRef(function LinkAdapter(_a, ref) {
+    var { Component } = _a, props = __rest(_a, ["Component"]);
+    const theme = useTheme();
+    const LinkComponent = Component !== null && Component !== void 0 ? Component : theme.custom.LinkAdapter;
+    return (React.createElement(PlainLink, Object.assign({ as: LinkComponent, ref: ref }, props), props.children));
+});
+export { LinkAdapter };

package/dist/esm/components/ScrollSnap/ScrollSnap.d.ts

@@ -0,0 +1,19 @@
+import * as React from "react";
+type ScrollSnapProps = {
+    /**
+     * Tolerance within which scroll will be considered "at the bottom" of the element.
+     */
+    threshold?: number;
+    /**
+     * Content to be displayed
+     */
+    children: React.ReactNode;
+    className?: string;
+};
+/**
+ * Component that automatically scrolls to the bottom of the element when new
+ * content is added, unless the user has scrolled up.
+ */
+declare const ScrollSnap: React.ForwardRefExoticComponent<ScrollSnapProps & React.RefAttributes<HTMLDivElement>>;
+export { ScrollSnap };
+export type { ScrollSnapProps };

package/dist/esm/components/ScrollSnap/ScrollSnap.js

@@ -0,0 +1,56 @@
+import { composeRefs } from "../../utils/composeRefs";
+import styled from "@emotion/styled";
+import * as React from "react";
+/**
+ * Returns the distance between visible content and the bottom of the element.
+ */
+const distanceFromBottom = (el) => {
+    return el.scrollHeight - el.clientHeight - el.scrollTop;
+};
+/**
+ * Scrolls to the bottom of the element.
+ */
+const scrollToBottom = (el) => {
+    el.scrollTop = el.scrollHeight;
+};
+const Scroller = styled.div({
+    overflow: "auto",
+});
+/**
+ * Component that automatically scrolls to the bottom of the element when new
+ * content is added, unless the user has scrolled up.
+ */
+const ScrollSnap = React.forwardRef(function ScrollSnap({ children, threshold = 2, className }, ref) {
+    const el = React.useRef(null);
+    // `content` a delayed version of children to allow measuring scroll position
+    // using the old children.
+    const [content, setContent] = React.useState(children);
+    const wasAtBottom = React.useRef(null);
+    /**
+     * The next two effects:
+     * 1. Check if the element is at the bottom.
+     * 2. Then set children -> content
+     * 3. Then scroll to bottom (if needed)
+     *
+     * In this way, we can measure the scroll position before the new content is set.
+     *
+     * In React 19, this started requiring useLayoutEffect.
+     */
+    React.useLayoutEffect(() => {
+        if (!el.current)
+            return;
+        wasAtBottom.current = distanceFromBottom(el.current) < threshold;
+        setContent(children);
+    }, [children, threshold]);
+    React.useLayoutEffect(() => {
+        if (!el.current)
+            return;
+        const atBottom = distanceFromBottom(el.current) < threshold;
+        if (wasAtBottom.current && !atBottom) {
+            scrollToBottom(el.current);
+            wasAtBottom.current = null;
+        }
+    }, [content, threshold]);
+    return (React.createElement(Scroller, { className: className, ref: composeRefs(el, ref) }, content));
+});
+export { ScrollSnap };

package/dist/esm/components/ScrollSnap/ScrollSnap.stories.d.ts

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

package/dist/esm/components/ScrollSnap/ScrollSnap.stories.js

@@ -0,0 +1,40 @@
+import * as React from "react";
+import { ScrollSnap } from "./ScrollSnap";
+import styled from "@emotion/styled";
+import { faker } from "@faker-js/faker/locale/en";
+import { useInterval } from "../../utils/useInterval";
+import Slider from "@mui/material/Slider";
+import Stack from "@mui/material/Stack";
+import Typography from "@mui/material/Typography";
+import { Button } from "../Button/Button";
+const Scroller = styled(ScrollSnap)({
+    width: "200px",
+    height: "350px",
+    border: "1pt solid black",
+});
+const meta = {
+    title: "smoot-design/ScrollSnap",
+    component: ScrollSnap,
+    render: function Render(args) {
+        const MAX = 3000;
+        const [updateInterval, setUpdateInterval] = React.useState(MAX);
+        const [children, setChildren] = React.useState(faker.lorem.sentence());
+        const appendText = () => setChildren((current) => {
+            return `${current} ${faker.lorem.sentence()}`;
+        });
+        useInterval(() => {
+            appendText();
+        }, updateInterval === MAX ? null : updateInterval);
+        return (React.createElement(Stack, { gap: "12px", alignItems: "start" },
+            React.createElement(Typography, null, "Update interval (ms)"),
+            React.createElement(Slider, { sx: { width: "350px" }, marks: [
+                    { value: 100, label: "0.1s" },
+                    { value: 2000, label: "2s" },
+                    { value: MAX, label: "off" },
+                ], value: updateInterval, min: 100, max: MAX, onChange: (_e, val) => setUpdateInterval(val) }),
+            React.createElement(Scroller, Object.assign({}, args), children),
+            React.createElement(Button, { onClick: appendText }, "Append Sentence")));
+    },
+};
+export default meta;
+export const Chat = {};

package/dist/esm/components/ScrollSnap/useScrollSnap.d.ts

@@ -0,0 +1,6 @@
+declare const useScrollSnap: ({ scrollElement, contentElement, threshold, }: {
+    scrollElement: HTMLElement | null;
+    contentElement?: HTMLElement | null;
+    threshold?: number;
+}) => void;
+export { useScrollSnap };

package/dist/esm/components/ScrollSnap/useScrollSnap.js

@@ -0,0 +1,33 @@
+import { useEffect } from "react";
+/**
+ * Returns the distance between visible content and the bottom of the element.
+ */
+const distanceFromBottom = (el) => {
+    return el.scrollHeight - el.clientHeight - el.scrollTop;
+};
+/**
+ * Scrolls to the bottom of the element.
+ */
+const scrollToBottom = (el) => {
+    el.scrollTop = el.scrollHeight;
+};
+const useScrollSnap = ({ scrollElement, contentElement, threshold = 2, }) => {
+    useEffect(() => {
+        const onGrow = () => {
+            if (!scrollElement)
+                return;
+            if (distanceFromBottom(scrollElement) < threshold) {
+                scrollToBottom(scrollElement);
+            }
+        };
+        onGrow();
+        const resizeObserver = new ResizeObserver(onGrow);
+        if (contentElement) {
+            resizeObserver.observe(contentElement);
+        }
+        return () => {
+            resizeObserver.disconnect();
+        };
+    }, [scrollElement, contentElement, threshold]);
+};
+export { useScrollSnap };

package/dist/esm/components/SrAnnouncer/SrAnnouncer.d.ts

@@ -0,0 +1,25 @@
+import * as React from "react";
+type SrAnnouncerProps = {
+    /**
+     * Message text to be read to user.
+     *
+     * Cannot contain HTML elements—only text.
+     */
+    message: string;
+    /**
+     * Messages to display while the component is in a loading state.
+     *
+     * Identical consecutive messages may not be read on some screen readers.
+     */
+    loadingMessages?: {
+        delay: number;
+        text: string;
+    }[];
+    isLoading: boolean;
+};
+/**
+ * A component that announces messages to screen readers as they come in.
+ */
+declare const SrAnnouncer: React.FC<SrAnnouncerProps>;
+export { SrAnnouncer };
+export type { SrAnnouncerProps };

package/dist/esm/components/SrAnnouncer/SrAnnouncer.js

@@ -0,0 +1,40 @@
+import * as React from "react";
+import { VisuallyHidden } from "../VisuallyHidden/VisuallyHidden";
+import { useEffect } from "react";
+import { useDevCheckStable } from "../../utils/useDevCheckStable";
+const DEFAULT_PROPS = {
+    loadingMessages: [
+        { delay: 1500, text: "Loading" },
+        { delay: 4000, text: "Still loading" },
+    ],
+};
+/**
+ * A component that announces messages to screen readers as they come in.
+ */
+const SrAnnouncer = ({ message, isLoading, loadingMessages = DEFAULT_PROPS.loadingMessages, }) => {
+    var _a;
+    const [loadingMsgIndex, setLoadingMsgIndex] = React.useState(-1);
+    /**
+     * If loadingMessages changes, the timeouts are reset.
+     * Desirable if the change is real, undesirable if it's a mistake (e.g., by
+     * passing an array literal as a prop).
+     */
+    useDevCheckStable(loadingMessages, "SrAnnouncer: loadingMessages changed (by ===) unexpectedly. This may interfere with loading message visibility");
+    useEffect(() => {
+        setLoadingMsgIndex(-1);
+    }, [isLoading, loadingMessages]);
+    useEffect(() => {
+        const next = loadingMessages[loadingMsgIndex + 1];
+        if (!isLoading || !next)
+            return () => { };
+        const id = setTimeout(() => {
+            setLoadingMsgIndex(loadingMsgIndex + 1);
+        }, next.delay);
+        return () => {
+            clearTimeout(id);
+        };
+    }, [isLoading, loadingMsgIndex, loadingMessages]);
+    const loadingTxt = (_a = loadingMessages[loadingMsgIndex]) === null || _a === void 0 ? void 0 : _a.text;
+    return (React.createElement(VisuallyHidden, { "aria-atomic": "true", "aria-live": "polite" }, isLoading ? loadingTxt : message));
+};
+export { SrAnnouncer };

package/dist/esm/components/SrAnnouncer/SrAnnouncer.stories.d.ts

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

package/dist/esm/components/SrAnnouncer/SrAnnouncer.stories.js

@@ -0,0 +1,41 @@
+import * as React from "react";
+import { SrAnnouncer } from "./SrAnnouncer";
+import styled from "@emotion/styled";
+const Container = styled.div(({ forceVisible }) => [
+    forceVisible && {
+        width: "100% !important",
+        height: "100px !important",
+        "& > *:first-of-type": {
+            width: "unset !important",
+            height: "unset !important",
+            clipPath: "none !important",
+            clip: "unset !important",
+            position: "unset !important",
+        },
+    },
+]);
+const meta = {
+    title: "smoot-design/ScreenreaderAnnouncer",
+    component: SrAnnouncer,
+    decorators: function Decorator(Story) {
+        const [forceVisible, setForceVisible] = React.useState(true);
+        return (React.createElement(React.Fragment, null,
+            React.createElement("label", null,
+                "Force Visible:",
+                React.createElement("input", { type: "checkbox", checked: forceVisible, onChange: (e) => setForceVisible(e.target.checked) }),
+                React.createElement("p", null, "By default, the content of this story is visually hidden.")),
+            React.createElement("hr", null),
+            React.createElement(Container, { forceVisible: forceVisible },
+                React.createElement(Story, null))));
+    },
+    args: {
+        message: "A message to read to user",
+        isLoading: true,
+        loadingMessages: [
+            { delay: 1000, text: "Loading" },
+            { delay: 3000, text: "Still loading" },
+        ],
+    },
+};
+export default meta;
+export const ScreenreaderAnnouncements = {};

package/dist/esm/components/SrAnnouncer/SrAnnouncer.test.d.ts

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

package/dist/esm/components/SrAnnouncer/SrAnnouncer.test.js

@@ -0,0 +1,60 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as React from "react";
+import { render, act } from "@testing-library/react";
+import { SrAnnouncer } from "./SrAnnouncer";
+const sleep = (ms) => {
+    act(() => {
+        jest.advanceTimersByTime(ms);
+    });
+};
+describe("SrAnnouncer", () => {
+    beforeEach(() => {
+        jest.useFakeTimers();
+        jest.clearAllTimers();
+    });
+    test("Renders a message when not loading", () => {
+        const { container } = render(React.createElement(SrAnnouncer, { message: "Hello, world!", isLoading: false }));
+        expect(container.textContent).toBe("Hello, world!");
+    });
+    test("Renders a loading message when loading", () => __awaiter(void 0, void 0, void 0, function* () {
+        const loadingMessages = [
+            { delay: 100, text: "Loading 1" },
+            { delay: 200, text: "Loading 2" },
+        ];
+        const { container, rerender } = render(React.createElement(SrAnnouncer, { message: "Hello, world!", loadingMessages: loadingMessages, isLoading: true }));
+        expect(container.textContent).toBe("");
+        sleep(100);
+        expect(container.textContent).toBe("Loading 1");
+        sleep(100);
+        expect(container.textContent).toBe("Loading 1");
+        sleep(100);
+        expect(container.textContent).toBe("Loading 2");
+        sleep(1000);
+        expect(container.textContent).toBe("Loading 2");
+        rerender(React.createElement(SrAnnouncer, { message: "Hello, world!", loadingMessages: loadingMessages, isLoading: false }));
+        expect(container.textContent).toBe("Hello, world!");
+        rerender(React.createElement(SrAnnouncer, { message: "Hello, world!", loadingMessages: loadingMessages, isLoading: true }));
+        expect(container.textContent).toBe("");
+        sleep(100);
+        expect(container.textContent).toBe("Loading 1");
+        sleep(100);
+        expect(container.textContent).toBe("Loading 1");
+        sleep(100);
+        expect(container.textContent).toBe("Loading 2");
+    }));
+    test("Warns if loadingMessages changes unexpectedly", () => {
+        const error = jest.spyOn(console, "error").mockImplementation(() => { });
+        const { rerender } = render(React.createElement(SrAnnouncer, { message: "Hello, world!", isLoading: true }));
+        rerender(React.createElement(SrAnnouncer, { message: "Hello, world!", isLoading: true, loadingMessages: [{ delay: 100, text: "Loading" }] }));
+        expect(error).toHaveBeenCalled();
+        error.mockRestore();
+    });
+});

package/dist/esm/components/TabButtons/TabButtonList.d.ts

@@ -0,0 +1,25 @@
+import * as React from "react";
+import type { TabProps } from "@mui/material/Tab";
+import type { TabListProps } from "@mui/lab/TabList";
+import type { ButtonLinkProps } from "../Button/Button";
+type StyleVariant = "chat";
+type TabButtonListProps = TabListProps & {
+    styleVariant?: StyleVariant;
+};
+declare const TabButtonList: React.FC<TabButtonListProps>;
+declare const TabLinkInner: React.ForwardRefExoticComponent<Omit<ButtonLinkProps, "ref"> & React.RefAttributes<HTMLAnchorElement>>;
+type TabButtonProps = Omit<TabProps<"button">, "color"> & {
+    styleVariant?: StyleVariant;
+};
+/**
+ * Wrapper around [MUI Tab](https://mui.com/material-ui/api/tab/) using our
+ * Button as the `component` implementation.
+ */
+declare const TabButton: (props: TabButtonProps) => React.JSX.Element;
+/**
+ * Wrapper around [MUI Tab](https://mui.com/material-ui/api/tab/) using our
+ * ButtonLink as the `component` implementation.
+ */
+declare const TabButtonLink: ({ ...props }: TabProps<typeof TabLinkInner>) => React.JSX.Element;
+export { TabButtonList, TabButton, TabButtonLink };
+export type { TabButtonListProps, TabButtonProps };