@mitodl/smoot-design 0.0.0-preview215f7ae3fa

package/dist/esm/components/AiChat/types.d.ts

@@ -0,0 +1,45 @@
+type Role = "assistant" | "user";
+type ChatMessage = {
+    id: string;
+    content: string;
+    role: Role;
+};
+type RequestOpts = {
+    apiUrl: string;
+    /**
+     * Transforms array of chat messages into request body. Messages
+     * are ordered oldest to newest.
+     *
+     * JSON.stringify is applied to the return value.
+     */
+    transformBody?: (messages: ChatMessage[]) => unknown;
+    /**
+     * Extra options to pass to fetch.
+     *
+     * If headers are specified, they will override the headersOpts.
+     */
+    fetchOpts?: RequestInit;
+    /**
+     * Extra headers to pass to fetch.
+     */
+    headersOpts?: HeadersInit;
+};
+type AiChatProps = {
+    className?: string;
+    initialMessages: Omit<ChatMessage, "id">[];
+    conversationStarters?: {
+        content: string;
+    }[];
+    requestOpts: RequestOpts;
+    parseContent?: (content: unknown) => string;
+    /**
+     * A message to display while the component is in a loading state.
+     *
+     * Identical consecutive messages may not be read on some screen readers.
+     */
+    srLoadingMessages?: {
+        delay: number;
+        text: string;
+    }[];
+};
+export type { RequestOpts, AiChatProps, ChatMessage };

package/dist/esm/components/AiChat/types.js

@@ -0,0 +1,2 @@
+// Some of these are based on (compatible, but simplfied / restricted) versions of ai/react types.
+export {};

package/dist/esm/components/AiChat/utils.d.ts

@@ -0,0 +1,9 @@
+import { UseChatOptions } from "ai/react";
+import type { RequestOpts } from "./types";
+declare const useAiChat: (requestOpts: RequestOpts, opts: UseChatOptions) => import("@ai-sdk/react").UseChatHelpers & {
+    addToolResult: ({ toolCallId, result, }: {
+        toolCallId: string;
+        result: any;
+    }) => void;
+};
+export { useAiChat };

package/dist/esm/components/AiChat/utils.js

@@ -0,0 +1,28 @@
+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 { useChat } from "ai/react";
+import { useMemo } from "react";
+const identity = (x) => x;
+const getFetcher = (requestOpts) => (url, opts) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    if (typeof (opts === null || opts === void 0 ? void 0 : opts.body) !== "string") {
+        console.error("Unexpected body type.");
+        return window.fetch(url, opts);
+    }
+    const messages = JSON.parse(opts === null || opts === void 0 ? void 0 : opts.body).messages;
+    const transformBody = (_a = requestOpts.transformBody) !== null && _a !== void 0 ? _a : identity;
+    const options = Object.assign(Object.assign(Object.assign({}, opts), { body: JSON.stringify(transformBody(messages)), headers: Object.assign(Object.assign(Object.assign({}, opts === null || opts === void 0 ? void 0 : opts.headers), { "Content-Type": "application/json" }), requestOpts.headersOpts) }), requestOpts.fetchOpts);
+    return fetch(url, options);
+});
+const useAiChat = (requestOpts, opts) => {
+    const fetcher = useMemo(() => getFetcher(requestOpts), [requestOpts]);
+    return useChat(Object.assign({ api: requestOpts.apiUrl, streamProtocol: "text", fetch: fetcher }, opts));
+};
+export { useAiChat };

package/dist/esm/components/Button/ActionButton.d.ts

@@ -0,0 +1,30 @@
+import * as React from "react";
+import { DEFAULT_PROPS } from "./Button";
+import type { ButtonStyleProps } from "./Button";
+import type { LinkAdapterPropsOverrides } from "../LinkAdapter/LinkAdapter";
+type ActionButtonStyleProps = Omit<ButtonStyleProps, "startIcon" | "endIcon">;
+type ActionButtonProps = ActionButtonStyleProps & React.ComponentProps<"button">;
+/**
+ * A button that should contain a remixicon icon and nothing else.
+ * See [ActionButton docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-actionbutton--docs).
+ *
+ * See also:
+ * - [ActionButtonLink](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-actionbutton--docs#links)
+ * - [Button](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs) for text buttons
+ */
+declare const ActionButton: import("@emotion/styled").StyledComponent<Omit<ActionButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement> & {
+    theme?: import("@emotion/react").Theme;
+}, {}, {}>;
+type ActionButtonLinkProps = ActionButtonStyleProps & React.ComponentProps<"a"> & {
+    Component?: React.ElementType;
+} & LinkAdapterPropsOverrides;
+/**
+ * See [ActionButtonLink docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-actionbutton--docs#links)
+ */
+declare const ActionButtonLink: import("@emotion/styled").StyledComponent<Omit<ActionButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement> & {
+    theme?: import("@emotion/react").Theme;
+} & ActionButtonStyleProps & React.ClassAttributes<HTMLAnchorElement> & React.AnchorHTMLAttributes<HTMLAnchorElement> & {
+    Component?: React.ElementType;
+} & LinkAdapterPropsOverrides, {}, {}>;
+export { ActionButton, ActionButtonLink, DEFAULT_PROPS };
+export type { ActionButtonProps, ActionButtonLinkProps };

package/dist/esm/components/Button/ActionButton.js

@@ -0,0 +1,68 @@
+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 styled from "@emotion/styled";
+import { pxToRem } from "../ThemeProvider/typography";
+import { ButtonRoot, ButtonLinkRoot, RESPONSIVE_SIZES, DEFAULT_PROPS, } from "./Button";
+const actionStyles = (size) => {
+    return {
+        minWidth: "auto",
+        padding: 0,
+        height: {
+            small: "32px",
+            medium: "40px",
+            large: "48px",
+        }[size],
+        width: {
+            small: "32px",
+            medium: "40px",
+            large: "48px",
+        }[size],
+        "& svg, & .MuiSvgIcon-root": {
+            width: "1em",
+            height: "1em",
+            fontSize: pxToRem({
+                small: 20,
+                medium: 24,
+                large: 32,
+            }[size]),
+        },
+    };
+};
+/**
+ * A button that should contain a remixicon icon and nothing else.
+ * See [ActionButton docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-actionbutton--docs).
+ *
+ * See also:
+ * - [ActionButtonLink](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-actionbutton--docs#links)
+ * - [Button](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs) for text buttons
+ */
+const ActionButton = styled(React.forwardRef(function Root(props, ref) {
+    return React.createElement(ButtonRoot, Object.assign({ ref: ref, type: "button" }, props));
+}))(({ size = DEFAULT_PROPS.size, responsive, theme }) => {
+    return [
+        actionStyles(size),
+        responsive && {
+            [theme.breakpoints.down("sm")]: actionStyles(RESPONSIVE_SIZES[size]),
+        },
+    ];
+});
+ActionButton.displayName = "ActionButton";
+/**
+ * See [ActionButtonLink docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-actionbutton--docs#links)
+ */
+const ActionButtonLink = ActionButton.withComponent((_a) => {
+    var { Component } = _a, props = __rest(_a, ["Component"]);
+    return React.createElement(ButtonLinkRoot, Object.assign({ Component: Component }, props));
+});
+ActionButtonLink.displayName = "ActionButtonLink";
+export { ActionButton, ActionButtonLink, DEFAULT_PROPS };

package/dist/esm/components/Button/ActionButton.stories.d.ts

@@ -0,0 +1,15 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { ActionButton } from "./ActionButton";
+declare const meta: Meta<typeof ActionButton>;
+export default meta;
+type Story = StoryObj<typeof ActionButton>;
+export declare const VariantsAndEdge: Story;
+/**
+ * `ActionButtonLink` is styled as a `ActionButton` that renders an anchor tag.
+ *
+ * To use a custom link component (E.g. `Link` from `react-router` or `next/link`),
+ * pass it as the `Component` prop. Alternatively, customize the project-wide
+ * default link adapter via [Theme's LinkAdapter](../?path=/docs/smoot-design-themeprovider--docs)
+ */
+export declare const Links: Story;
+export declare const Showcase: Story;

package/dist/esm/components/Button/ActionButton.stories.js

@@ -0,0 +1,113 @@
+import * as React from "react";
+import { ActionButton, ActionButtonLink, DEFAULT_PROPS } from "./ActionButton";
+import Grid from "@mui/material/Grid2";
+import Stack from "@mui/material/Stack";
+import { RiArrowLeftLine, RiDeleteBinLine, RiTestTubeLine, } from "@remixicon/react";
+import { fn } from "@storybook/test";
+import { enumValues } from "../../story-utils";
+const ICONS = {
+    None: undefined,
+    ArrowBackIcon: React.createElement(RiArrowLeftLine, null),
+    DeleteIcon: React.createElement(RiDeleteBinLine, null),
+    TestTubeIcon: React.createElement(RiTestTubeLine, null),
+};
+const VARIANTS = enumValues({
+    primary: true,
+    secondary: true,
+    tertiary: true,
+    bordered: true,
+    text: true,
+    unstable_noBorder: true,
+    unstable_inverted: true,
+    unstable_success: true,
+});
+const STABLE_VARIANTS = VARIANTS.filter((v) => !v.startsWith("unstable"));
+const SIZES = enumValues({
+    small: true,
+    medium: true,
+    large: true,
+});
+const EDGES = enumValues({
+    circular: true,
+    rounded: true,
+    none: true,
+});
+const meta = {
+    title: "smoot-design/ActionButton",
+    component: ActionButton,
+    argTypes: {
+        variant: {
+            control: { type: "select" },
+            table: {
+                defaultValue: { summary: DEFAULT_PROPS.variant },
+            },
+        },
+        size: {
+            control: { type: "select" },
+            table: {
+                defaultValue: { summary: DEFAULT_PROPS.size },
+            },
+        },
+        edge: {
+            control: { type: "select" },
+            table: {
+                defaultValue: { summary: DEFAULT_PROPS.edge },
+            },
+        },
+    },
+    args: {
+        onClick: fn(),
+    },
+};
+export default meta;
+export const VariantsAndEdge = {
+    render: (args) => (React.createElement(React.Fragment, null,
+        React.createElement(Stack, { direction: "row", gap: 2, sx: { my: 2 } },
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "none", variant: "primary" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "none", variant: "secondary" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "none", variant: "tertiary" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "none", variant: "bordered" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "none", variant: "text" }), ICONS.DeleteIcon)),
+        React.createElement(Stack, { direction: "row", gap: 2, sx: { my: 2 } },
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "rounded", variant: "primary" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "rounded", variant: "secondary" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "rounded", variant: "tertiary" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "rounded", variant: "bordered" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "rounded", variant: "text" }), ICONS.DeleteIcon)),
+        React.createElement(Stack, { direction: "row", gap: 2, sx: { my: 2 } },
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "circular", variant: "primary" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "circular", variant: "secondary" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "circular", variant: "tertiary" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "circular", variant: "bordered" }), ICONS.DeleteIcon),
+            React.createElement(ActionButton, Object.assign({}, args, { edge: "circular", variant: "text" }), ICONS.DeleteIcon)))),
+    tags: ["main"],
+};
+/**
+ * `ActionButtonLink` is styled as a `ActionButton` that renders an anchor tag.
+ *
+ * To use a custom link component (E.g. `Link` from `react-router` or `next/link`),
+ * pass it as the `Component` prop. Alternatively, customize the project-wide
+ * default link adapter via [Theme's LinkAdapter](../?path=/docs/smoot-design-themeprovider--docs)
+ */
+export const Links = {
+    render: () => (React.createElement(Stack, { direction: "row", gap: 2, sx: { my: 2 } },
+        React.createElement(ActionButtonLink, { href: "#fake", variant: "primary" }, ICONS.DeleteIcon),
+        React.createElement(ActionButtonLink, { href: "#fake", variant: "secondary" }, ICONS.DeleteIcon),
+        React.createElement(ActionButtonLink, { href: "#fake", variant: "tertiary" }, ICONS.DeleteIcon),
+        React.createElement(ActionButtonLink, { href: "#fake", variant: "bordered" }, ICONS.DeleteIcon),
+        React.createElement(ActionButtonLink, { href: "#fake", variant: "text" }, ICONS.DeleteIcon))),
+};
+export const Showcase = {
+    render: (args) => (React.createElement(Grid, { container: true, sx: { maxWidth: "750px" }, rowGap: 2 }, STABLE_VARIANTS.flatMap((variant) => EDGES.flatMap((edge) => (React.createElement(React.Fragment, { key: `${variant}-${edge}` },
+        React.createElement(Grid, { size: { xs: 12, sm: 3 }, alignItems: "center" },
+            React.createElement("code", null,
+                "variant=",
+                variant,
+                React.createElement("br", null),
+                "edge=",
+                edge)),
+        SIZES.flatMap((size) => Object.entries(ICONS)
+            .filter(([_key, icon]) => icon)
+            .map(([iconKey, icon]) => (React.createElement(Grid, { size: { xs: 4, sm: 1 }, key: `${size}-${iconKey}` },
+            React.createElement(ActionButton, Object.assign({ variant: variant, edge: edge, size: size }, args), icon))))))))))),
+};

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

@@ -0,0 +1,56 @@
+import * as React from "react";
+import { LinkAdapterPropsOverrides } from "../LinkAdapter/LinkAdapter";
+type ButtonVariant = "primary" | "secondary" | "tertiary" | "text" | "bordered" | "unstable_noBorder" | "unstable_inverted" | "unstable_success";
+type ButtonSize = "small" | "medium" | "large";
+type ButtonEdge = "circular" | "rounded" | "none";
+type ButtonStyleProps = {
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+    edge?: ButtonEdge;
+    /**
+     * Display an icon before the button text
+     */
+    startIcon?: React.ReactNode;
+    /**
+     * Display an icon after the button text.
+     */
+    endIcon?: React.ReactNode;
+    /**
+     * If true (default: `false`), the button will become one size smaller at the
+     * `sm` breakpoint.
+     *  - large -> medium
+     *  - medium -> small
+     *  - small -> small
+     */
+    responsive?: boolean;
+    color?: "secondary";
+};
+declare const DEFAULT_PROPS: Required<Omit<ButtonStyleProps, "startIcon" | "endIcon" | "color">>;
+declare const RESPONSIVE_SIZES: Record<ButtonSize, ButtonSize>;
+declare const ButtonRoot: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+} & ButtonStyleProps, React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, {}>;
+declare const ButtonLinkRoot: import("@emotion/styled").StyledComponent<Omit<React.ClassAttributes<HTMLAnchorElement> & React.AnchorHTMLAttributes<HTMLAnchorElement> & {
+    Component?: React.ElementType;
+} & LinkAdapterPropsOverrides, "ref"> & React.RefAttributes<HTMLAnchorElement> & {
+    theme?: import("@emotion/react").Theme;
+} & ButtonStyleProps, {}, {}>;
+type ButtonProps = ButtonStyleProps & React.ComponentProps<"button">;
+/**
+ * Our standard button component. See [Button Docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs).
+ *
+ * See also:
+ * - [ButtonLink](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs#links)
+ * - [ActionButton](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-actionbutton--docs) for icon-only uses
+ */
+declare const Button: React.ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+type ButtonLinkProps = ButtonStyleProps & React.ComponentProps<"a"> & {
+    Component?: React.ElementType;
+} & LinkAdapterPropsOverrides;
+/**
+ * See [ButtonLink docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs#links)
+ */
+declare const ButtonLink: React.ForwardRefExoticComponent<Omit<ButtonLinkProps, "ref"> & React.RefAttributes<HTMLAnchorElement>>;
+export { Button, ButtonLink, ButtonRoot, DEFAULT_PROPS, ButtonLinkRoot, RESPONSIVE_SIZES, };
+export type { ButtonProps, ButtonLinkProps, ButtonStyleProps, ButtonSize };

package/dist/esm/components/Button/Button.js

@@ -0,0 +1,265 @@
+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 styled from "@emotion/styled";
+import { css } from "@emotion/react";
+import { pxToRem } from "../ThemeProvider/typography";
+import { LinkAdapter, } from "../LinkAdapter/LinkAdapter";
+const styleProps = {
+    variant: true,
+    size: true,
+    edge: true,
+    startIcon: true,
+    endIcon: true,
+    responsive: true,
+    color: true,
+};
+const shouldForwardButtonProp = (prop) => !styleProps[prop];
+const DEFAULT_PROPS = {
+    variant: "primary",
+    size: "medium",
+    edge: "rounded",
+    responsive: false,
+};
+const BORDER_WIDTHS = {
+    small: 1,
+    medium: 1,
+    large: 2,
+};
+const RESPONSIVE_SIZES = {
+    small: "small",
+    medium: "small",
+    large: "medium",
+};
+const sizeStyles = (size, hasBorder, theme) => {
+    const paddingAdjust = hasBorder ? BORDER_WIDTHS[size] : 0;
+    return [
+        {
+            boxSizing: "border-box",
+            borderWidth: BORDER_WIDTHS[size],
+        },
+        size === "large" && Object.assign({ padding: `${14 - paddingAdjust}px 24px` }, theme.typography.buttonLarge),
+        size === "medium" && Object.assign({ padding: `${11 - paddingAdjust}px 16px` }, theme.typography.button),
+        size === "small" && Object.assign({ padding: `${8 - paddingAdjust}px 12px` }, theme.typography.buttonSmall),
+    ];
+};
+const buttonStyles = (props) => {
+    const { size, variant, edge, theme, color, responsive } = Object.assign(Object.assign({}, DEFAULT_PROPS), props);
+    const { colors } = theme.custom;
+    const hasBorder = variant === "secondary" || variant === "bordered";
+    return css([
+        {
+            color: theme.palette.text.primary,
+            textAlign: "center",
+            // display
+            display: "inline-flex",
+            justifyContent: "center",
+            alignItems: "center",
+            // transitions
+            transition: `background ${theme.transitions.duration.short}ms`,
+            // cursor
+            cursor: "pointer",
+            ":disabled": {
+                cursor: "default",
+            },
+            minWidth: "100px",
+        },
+        ...sizeStyles(size, hasBorder, theme),
+        // responsive
+        responsive && {
+            [theme.breakpoints.down("sm")]: sizeStyles(RESPONSIVE_SIZES[size], hasBorder, theme),
+        },
+        // variant
+        variant === "primary" && {
+            backgroundColor: colors.mitRed,
+            color: colors.white,
+            border: "none",
+            /* Shadow/04dp */
+            boxShadow: "0px 2px 4px 0px rgba(37, 38, 43, 0.10), 0px 3px 8px 0px rgba(37, 38, 43, 0.12)",
+            ":hover:not(:disabled)": {
+                backgroundColor: colors.red,
+                boxShadow: "none",
+            },
+            ":disabled": {
+                backgroundColor: colors.silverGray,
+                boxShadow: "none",
+            },
+        },
+        variant === "unstable_success" && {
+            backgroundColor: colors.darkGreen,
+            color: colors.white,
+            border: "none",
+            /* Shadow/04dp */
+            boxShadow: "0px 2px 4px 0px rgba(37, 38, 43, 0.10), 0px 3px 8px 0px rgba(37, 38, 43, 0.12)",
+            ":hover:not(:disabled)": {
+                backgroundColor: colors.darkGreen,
+                boxShadow: "none",
+            },
+            ":disabled": {
+                backgroundColor: colors.silverGray,
+                boxShadow: "none",
+            },
+        },
+        variant === "secondary" && {
+            color: colors.red,
+            backgroundColor: "transparent",
+            borderColor: "currentcolor",
+            borderStyle: "solid",
+            ":hover:not(:disabled)": {
+                // brightRed at 0.06 alpha
+                backgroundColor: "rgba(255, 20, 35, 0.06)",
+            },
+            ":disabled": {
+                color: colors.silverGray,
+            },
+        },
+        variant === "text" && {
+            backgroundColor: "transparent",
+            borderStyle: "none",
+            color: colors.darkGray2,
+            ":hover:not(:disabled)": {
+                // darkGray1 at 6% alpha
+                backgroundColor: "rgba(64, 70, 76, 0.06)",
+            },
+            ":disabled": {
+                color: colors.silverGray,
+            },
+        },
+        variant === "bordered" && {
+            backgroundColor: colors.white,
+            color: colors.silverGrayDark,
+            border: `1px solid ${colors.silverGrayLight}`,
+            ":hover:not(:disabled)": {
+                backgroundColor: colors.lightGray1,
+                color: colors.darkGray2,
+            },
+            ":disabled": {
+                backgroundColor: colors.lightGray2,
+                border: `1px solid ${colors.lightGray2}`,
+                color: colors.silverGrayDark,
+            },
+        },
+        variant === "unstable_noBorder" && {
+            backgroundColor: colors.white,
+            color: colors.darkGray2,
+            border: "none",
+            ":hover:not(:disabled)": {
+                // darkGray1 at 6% alpha
+                backgroundColor: "rgba(64, 70, 76, 0.06)",
+            },
+            ":disabled": {
+                color: colors.silverGray,
+            },
+        },
+        variant === "tertiary" && {
+            color: colors.darkGray2,
+            border: "none",
+            backgroundColor: colors.lightGray2,
+            ":hover:not(:disabled)": {
+                backgroundColor: colors.white,
+            },
+            ":disabled": {
+                backgroundColor: colors.lightGray2,
+                color: colors.silverGrayLight,
+            },
+        },
+        variant === "unstable_inverted" && {
+            backgroundColor: colors.white,
+            color: colors.mitRed,
+            borderColor: colors.mitRed,
+            borderStyle: "solid",
+        },
+        // edge
+        edge === "rounded" && {
+            borderRadius: "4px",
+        },
+        edge === "circular" && {
+            // Pill-shaped buttons... Overlapping border radius get clipped to pill.
+            borderRadius: "100vh",
+        },
+        // color
+        color === "secondary" && {
+            color: theme.custom.colors.silverGray,
+            borderColor: theme.custom.colors.silverGray,
+            ":hover:not(:disabled)": {
+                backgroundColor: theme.custom.colors.lightGray1,
+            },
+        },
+    ]);
+};
+const ButtonRoot = styled("button", {
+    shouldForwardProp: shouldForwardButtonProp,
+})(buttonStyles);
+const ButtonLinkRoot = styled(LinkAdapter, {
+    shouldForwardProp: shouldForwardButtonProp,
+})(buttonStyles);
+const IconContainer = styled.span(({ size, side }) => [
+    {
+        height: "1em",
+        display: "flex",
+        alignItems: "center",
+    },
+    side === "start" && {
+        /**
+         * The negative margin is to counteract the padding on the button itself.
+         * Without icons, the left space is 24/16/12 px.
+         * With icons, the left space is 20/12/8 px.
+         */
+        marginLeft: "-4px",
+        marginRight: "8px",
+    },
+    side === "end" && {
+        marginLeft: "8px",
+        marginRight: "-4px",
+    },
+    {
+        "& svg, & .MuiSvgIcon-root": {
+            width: "1em",
+            height: "1em",
+            fontSize: pxToRem({
+                small: 16,
+                medium: 20,
+                large: 24,
+            }[size]),
+        },
+    },
+]);
+const ButtonInner = (props) => {
+    const { children, size = DEFAULT_PROPS.size } = props;
+    return (React.createElement(React.Fragment, null,
+        props.startIcon ? (React.createElement(IconContainer, { size: size, side: "start" }, props.startIcon)) : null,
+        children,
+        props.endIcon ? (React.createElement(IconContainer, { size: size, side: "end" }, props.endIcon)) : null));
+};
+/**
+ * Our standard button component. See [Button Docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs).
+ *
+ * See also:
+ * - [ButtonLink](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs#links)
+ * - [ActionButton](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-actionbutton--docs) for icon-only uses
+ */
+const Button = React.forwardRef((_a, ref) => {
+    var { children } = _a, props = __rest(_a, ["children"]);
+    return (React.createElement(ButtonRoot, Object.assign({ ref: ref, type: "button" }, props),
+        React.createElement(ButtonInner, Object.assign({}, props), children)));
+});
+Button.displayName = "Button";
+/**
+ * See [ButtonLink docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs#links)
+ */
+const ButtonLink = React.forwardRef((_a, ref) => {
+    var { children, Component } = _a, props = __rest(_a, ["children", "Component"]);
+    return (React.createElement(ButtonLinkRoot, Object.assign({ Component: Component, ref: ref }, props),
+        React.createElement(ButtonInner, Object.assign({}, props), children)));
+});
+ButtonLink.displayName = "ButtonLink";
+export { Button, ButtonLink, ButtonRoot, DEFAULT_PROPS, ButtonLinkRoot, RESPONSIVE_SIZES, };

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

@@ -0,0 +1,17 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { Button } from "./Button";
+declare const meta: Meta<typeof Button>;
+export default meta;
+type Story = StoryObj<typeof Button>;
+export declare const VariantsAndEdge: Story;
+export declare const Sizes: Story;
+export declare const WithIcons: Story;
+/**
+ * `ButtonLink` is a styled `Button` that renders an anchor tag.
+ *
+ * To use a custom link component (E.g. `Link` from `react-router` or `next/link`),
+ * pass it as the `Component` prop. Alternatively, customize the project-wide
+ * default link adapter via [Theme's LinkAdapter](../?path=/docs/smoot-design-themeprovider--docs)
+ */
+export declare const Links: Story;
+export declare const Showcase: Story;