@mitodl/smoot-design 0.0.0-355a925

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

@@ -0,0 +1,151 @@
+import * as React from "react";
+import { colors } from "./colors";
+import { RiCloseLine } from "@remixicon/react";
+const chipComponent = {
+    defaultProps: {
+        size: "medium",
+        color: "default",
+        variant: "outlined",
+        deleteIcon: React.createElement(RiCloseLine, { "aria-hidden": "true" }),
+    },
+    styleOverrides: {
+        root: {
+            borderRadius: "100vh",
+            borderWidth: "1px",
+        },
+        deleteIcon: {
+            "&:hover": {
+                color: "inherit",
+            },
+            "&.MuiChip-deleteIconLarge": {
+                width: "16px",
+                height: "16px",
+            },
+            "&.MuiChip-deleteIconMedium": {
+                width: "14px",
+                height: "14px",
+            },
+            margin: "0 -2px 0 8px",
+            color: "inherit",
+        },
+        icon: {
+            margin: "0 8px 0 -2px",
+            color: "inherit",
+            "&.MuiChip-iconLarge": {
+                width: "16px",
+                height: "16px",
+            },
+            "&.MuiChip-iconMedium": {
+                width: "14px",
+                height: "14px",
+            },
+        },
+    },
+    variants: [
+        {
+            props: { size: "medium" },
+            style: ({ theme }) => (Object.assign(Object.assign({}, theme.typography.body3), { boxSizing: "border-box", height: "24px", paddingRight: "12px", paddingLeft: "12px", ".MuiChip-label": {
+                    paddingLeft: "0px",
+                    paddingRight: "0px",
+                } })),
+        },
+        {
+            props: { size: "large" },
+            style: ({ theme }) => (Object.assign(Object.assign({}, theme.typography.body2), { height: "32px", paddingLeft: "16px", paddingRight: "16px", ".MuiChip-label": {
+                    paddingLeft: "0px",
+                    paddingRight: "0px",
+                } })),
+        },
+        {
+            props: { variant: "outlined" },
+            style: {
+                borderColor: colors.silverGrayLight,
+                color: colors.darkGray1,
+                "&.Mui-focusVisible": {
+                    backgroundColor: "transparent",
+                },
+                "&.MuiChip-clickable:hover, &.MuiChip-deletable:hover": {
+                    color: colors.darkGray1,
+                    borderColor: colors.silverGrayDark,
+                    backgroundColor: "transparent", // mui has a default background color for hover
+                },
+            },
+        },
+        {
+            props: { variant: "outlinedWhite" },
+            style: {
+                backgroundColor: "white",
+                border: "1px solid",
+                borderColor: colors.silverGrayLight,
+                color: colors.darkGray1,
+                "&.Mui-focusVisible": {
+                    backgroundColor: "white",
+                },
+                "&.MuiChip-clickable:hover, &.MuiChip-deletable:hover": {
+                    color: colors.darkGray1,
+                    borderColor: colors.silverGrayDark,
+                    backgroundColor: "white", // mui has a default background color hover
+                },
+            },
+        },
+        {
+            props: { variant: "gray" },
+            style: {
+                backgroundColor: colors.lightGray2,
+                border: "none",
+                color: colors.darkGray2,
+                "&.Mui-focusVisible": {
+                    backgroundColor: colors.lightGray2,
+                },
+                "&.MuiChip-clickable:hover, &.MuiChip-deletable:hover": {
+                    color: colors.darkGray1,
+                    backgroundColor: colors.silverGrayLight,
+                },
+            },
+        },
+        {
+            props: { variant: "dark" },
+            style: {
+                backgroundColor: colors.silverGrayDark,
+                border: "none",
+                color: colors.white,
+                "&.Mui-focusVisible": {
+                    backgroundColor: colors.silverGrayDark,
+                },
+                "&.MuiChip-clickable:hover, &.MuiChip-deletable:hover": {
+                    backgroundColor: colors.darkGray1,
+                },
+            },
+        },
+        {
+            props: { variant: "darker" },
+            style: {
+                backgroundColor: colors.darkGray2,
+                border: `1px solid ${colors.darkGray1}`,
+                color: colors.white,
+                "&.Mui-focusVisible": {
+                    backgroundColor: colors.darkGray2,
+                },
+                "&.MuiChip-clickable:hover, &.MuiChip-deletable:hover": {
+                    backgroundColor: colors.black,
+                    border: `1px solid ${colors.silverGray}`,
+                },
+            },
+        },
+        {
+            props: { variant: "filled" },
+            style: {
+                backgroundColor: colors.mitRed,
+                border: "none",
+                color: colors.white,
+                "&.Mui-focusVisible": {
+                    backgroundColor: colors.mitRed,
+                },
+                "&.MuiChip-clickable:hover, &.MuiChip-deletable:hover": {
+                    backgroundColor: colors.red,
+                },
+            },
+        },
+    ],
+};
+export { chipComponent };

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

@@ -0,0 +1,32 @@
+declare const colors: {
+    mitRed: string;
+    brightRed: string;
+    black: string;
+    white: string;
+    darkGray2: string;
+    darkGray1: string;
+    silverGrayDark: string;
+    silverGray: string;
+    silverGrayLight: string;
+    lightGray2: string;
+    lightGray1: string;
+    navGray: string;
+    darkPink: string;
+    pink: string;
+    lightPink: string;
+    darkPurple: string;
+    purple: string;
+    lightPurple: string;
+    darkBlue: string;
+    blue: string;
+    lightBlue: string;
+    darkGreen: string;
+    green: string;
+    lightGreen: string;
+    darkRed: string;
+    red: string;
+    lightRed: string;
+    orange: string;
+    yellow: string;
+};
+export { colors };

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 {};