@mitodl/smoot-design 0.0.0-355a925

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

@@ -0,0 +1,116 @@
+import * as React from "react";
+import type { InputBaseProps } from "@mui/material/InputBase";
+import type { Theme } from "@mui/material/styles";
+type Size = "small" | "medium" | "large" | "chat" | "hero";
+type CustomInputProps = {
+    /**
+     * If true, the input will display one size smaller at mobile breakpoint.
+     */
+    responsive?: boolean;
+};
+type MuiDocOverride = {
+    size?: Size;
+    /**
+     * Slot for icon adornments.
+     *
+     * If the icon is a button, use `AdornmentButton` component.
+     */
+    startAdornment?: React.ReactNode;
+    /**
+     * Slot for icon adornments.
+     *
+     * If the icon is a button, use `AdornmentButton` component.
+     */
+    endAdornment?: React.ReactNode;
+};
+type InputProps = CustomInputProps & MuiDocOverride & Omit<InputBaseProps, "color" | keyof MuiDocOverride>;
+/**
+ * Base styles for Input and Select components. Includes border, color, hover effects.
+ */
+declare const baseInputStyles: (theme: Theme) => {
+    backgroundColor: string;
+    color: string;
+    borderColor: string;
+    borderWidth: string;
+    borderStyle: string;
+    borderRadius: string;
+    overflow: string;
+    "&.Mui-disabled": {
+        backgroundColor: string;
+    };
+    "&:hover:not(.Mui-disabled):not(.Mui-focused)": {
+        borderColor: string;
+    };
+    "&.Mui-focused": {
+        /**
+         * When change border width, it affects either the elements outside of it or
+         * inside based on the border-box setting.
+         *
+         * Instead of changing the border width, we hide the border and change width
+         * using outline.
+         */
+        borderColor: string;
+        outline: string;
+        outlineOffset: string;
+    };
+    "&.Mui-error": {
+        borderColor: string;
+        outlineColor: string;
+    };
+    "& input::placeholder, textarea::placeholder": {
+        color: string;
+        opacity: number;
+    };
+    "& input:placeholder-shown, textarea:placeholder-shown": {
+        textOverflow: string;
+    };
+    "& textarea": {
+        paddingTop: string;
+        paddingBottom: string;
+    };
+    "&.MuiInputBase-adornedStart": {
+        paddingLeft: string;
+        input: {
+            paddingLeft: string;
+        };
+    };
+    "&.MuiInputBase-adornedEnd": {
+        paddingRight: string;
+        input: {
+            paddingRight: string;
+        };
+    };
+};
+/**
+ * Use `Input` for a visually unlabelled input field. If used, it should still
+ * have an accessible label, e.g., provided via `aria-label`.
+ * For a labeled input field, use `TextField`. instead.
+ *
+ * **Note:** This component is a styled version of MUI's `InputBase`. See
+ * MUI's documentation for full info.
+ *
+ * - [Smoot Design Input Documentation](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-input--docs)
+ * - [InputBase Documentation](https://mui.com/api/input-base/)
+ */
+declare const Input: React.FC<InputProps>;
+declare const AdornmentButtonStyled: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme;
+    as?: React.ElementType;
+}, React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, {}>;
+type AdornmentButtonProps = React.ComponentProps<typeof AdornmentButtonStyled>;
+/**
+ * Button to be used with `startAdornment` and `endAdornment` props on Input and
+ * TextField components. AdornmentButton takes care of positioning and other
+ * styling concerns.
+ *
+ * NOTES:
+ *  - It is generally expected that the content of the AdornmentButton is a
+ *    Remix Icon component. https://remixicon.com/
+ *  - By default, the AdornmentButton calls `preventDefault` on `mouseDown`
+ *    events. This prevents the button from stealing focus from the input on
+ *    click. The button is still focusable via keyboard events. You can override
+ *    this behavior by passing your own `onMouseDown` handler.
+ */
+declare const AdornmentButton: React.FC<AdornmentButtonProps>;
+export { AdornmentButton, Input, baseInputStyles };
+export type { InputProps, AdornmentButtonProps };

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

@@ -0,0 +1,232 @@
+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 InputBase from "@mui/material/InputBase";
+import classnames from "classnames";
+const defaultProps = {
+    size: "medium",
+    multiline: false,
+};
+const responsiveSize = {
+    small: "small",
+    medium: "small",
+    large: "medium",
+    chat: "chat",
+    hero: "large",
+};
+const sizeStyles = ({ size, theme, multiline }) => css([
+    (size === "small" || size === "medium") && Object.assign({}, theme.typography.body2),
+    (size === "large" || size === "chat" || size === "hero") && Object.assign({ ".remixicon": {
+            width: "24px",
+            height: "24px",
+        } }, theme.typography.body1),
+    size === "medium" && {
+        paddingLeft: "12px",
+        paddingRight: "12px",
+    },
+    size === "small" &&
+        !multiline && {
+        height: "32px",
+    },
+    size === "medium" &&
+        !multiline && {
+        height: "40px",
+    },
+    size === "large" &&
+        !multiline && {
+        height: "48px",
+    },
+    size === "chat" &&
+        !multiline && {
+        height: "56px",
+    },
+    size === "hero" &&
+        !multiline && {
+        height: "72px",
+    },
+    size === "small" && {
+        padding: "0 8px",
+        ".Mit-AdornmentButton": {
+            width: "32px",
+            ".remixicon": {
+                width: "16px",
+                height: "16px",
+            },
+        },
+    },
+    size === "medium" && {
+        padding: "0 12px",
+        ".Mit-AdornmentButton": {
+            width: "40px",
+            ".remixicon": {
+                width: "20px",
+                height: "20px",
+            },
+        },
+    },
+    size === "large" && {
+        padding: "0 16px",
+        ".Mit-AdornmentButton": {
+            width: "48px",
+        },
+    },
+    size === "chat" && {
+        padding: "0 16px",
+        borderRadius: "8px",
+        borderColor: theme.custom.colors.silverGrayLight,
+        backgroundColor: theme.custom.colors.white,
+        ".Mit-AdornmentButton": {
+            padding: "0 16px",
+        },
+    },
+    size === "hero" && {
+        padding: "0 24px",
+        ".Mit-AdornmentButton": {
+            width: "72px",
+        },
+    },
+]);
+/**
+ * Base styles for Input and Select components. Includes border, color, hover effects.
+ */
+const baseInputStyles = (theme) => ({
+    backgroundColor: "white",
+    color: theme.custom.colors.darkGray2,
+    borderColor: theme.custom.colors.silverGrayLight,
+    borderWidth: "1px",
+    borderStyle: "solid",
+    borderRadius: "4px",
+    overflow: "hidden",
+    "&.Mui-disabled": {
+        backgroundColor: theme.custom.colors.lightGray1,
+    },
+    "&:hover:not(.Mui-disabled):not(.Mui-focused)": {
+        borderColor: theme.custom.colors.darkGray2,
+    },
+    "&.Mui-focused": {
+        /**
+         * When change border width, it affects either the elements outside of it or
+         * inside based on the border-box setting.
+         *
+         * Instead of changing the border width, we hide the border and change width
+         * using outline.
+         */
+        borderColor: "transparent",
+        outline: "2px solid currentcolor",
+        outlineOffset: "-2px",
+    },
+    "&.Mui-error": {
+        borderColor: theme.custom.colors.red,
+        outlineColor: theme.custom.colors.red,
+    },
+    "& input::placeholder, textarea::placeholder": {
+        color: theme.custom.colors.silverGrayDark,
+        opacity: 1, // some browsers apply opacity to placeholder text
+    },
+    "& input:placeholder-shown, textarea:placeholder-shown": {
+        textOverflow: "ellipsis",
+    },
+    "& textarea": {
+        paddingTop: "8px",
+        paddingBottom: "8px",
+    },
+    "&.MuiInputBase-adornedStart": {
+        paddingLeft: "0",
+        input: {
+            paddingLeft: "8px",
+        },
+    },
+    "&.MuiInputBase-adornedEnd": {
+        paddingRight: "0",
+        input: {
+            paddingRight: "8px",
+        },
+    },
+});
+const noForward = Object.keys({
+    responsive: true,
+});
+/**
+ * Use `Input` for a visually unlabelled input field. If used, it should still
+ * have an accessible label, e.g., provided via `aria-label`.
+ * For a labeled input field, use `TextField`. instead.
+ *
+ * **Note:** This component is a styled version of MUI's `InputBase`. See
+ * MUI's documentation for full info.
+ *
+ * - [Smoot Design Input Documentation](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-input--docs)
+ * - [InputBase Documentation](https://mui.com/api/input-base/)
+ */
+const Input = styled(InputBase, {
+    shouldForwardProp: (prop) => !noForward.includes(prop),
+})(({ theme, size = defaultProps.size, multiline, responsive }) => [
+    baseInputStyles(theme),
+    sizeStyles({ size, theme, multiline }),
+    responsive && {
+        [theme.breakpoints.down("sm")]: sizeStyles({
+            size: responsiveSize[size],
+            theme,
+            multiline,
+        }),
+    },
+]);
+const AdornmentButtonStyled = styled.button(({ theme, disabled }) => (Object.assign(Object.assign({}, theme.typography.button), { 
+    // display
+    display: "flex", flexShrink: 0, justifyContent: "center", alignItems: "center", 
+    // background and border
+    border: "none", background: "transparent", transition: `background ${theme.transitions.duration.short}ms`, 
+    // cursor
+    cursor: disabled ? "default" : "pointer", ":disabled": {
+        cursor: "default",
+        svg: {
+            fill: theme.custom.colors.silverGray,
+        },
+    }, ":hover": {
+        background: disabled ? "inherit" : "rgba(0, 0, 0, 0.06)",
+    }, color: theme.custom.colors.silverGray, ".MuiInputBase-root:hover &": {
+        color: "inherit",
+    }, ".MuiInputBase-root.Mui-focused &": {
+        color: "inherit",
+    }, ".MuiInputBase-root.Mui-disabled &": {
+        color: "inherit",
+    }, height: "100%" })));
+const noFocus = (e) => e.preventDefault();
+/**
+ * Button to be used with `startAdornment` and `endAdornment` props on Input and
+ * TextField components. AdornmentButton takes care of positioning and other
+ * styling concerns.
+ *
+ * NOTES:
+ *  - It is generally expected that the content of the AdornmentButton is a
+ *    Remix Icon component. https://remixicon.com/
+ *  - By default, the AdornmentButton calls `preventDefault` on `mouseDown`
+ *    events. This prevents the button from stealing focus from the input on
+ *    click. The button is still focusable via keyboard events. You can override
+ *    this behavior by passing your own `onMouseDown` handler.
+ */
+const AdornmentButton = (_a) => {
+    var { className } = _a, others = __rest(_a, ["className"]);
+    return (React.createElement(AdornmentButtonStyled
+    /**
+     * If the input is focused and user clicks the AdornmentButton, we don't
+     * want to steal focus from the input.
+     */
+    , Object.assign({ 
+        /**
+         * If the input is focused and user clicks the AdornmentButton, we don't
+         * want to steal focus from the input.
+         */
+        onMouseDown: noFocus, className: classnames("Mit-AdornmentButton", className) }, others)));
+};
+export { AdornmentButton, Input, baseInputStyles };

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

@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { Input } from "./Input";
+declare const meta: Meta<typeof Input>;
+export default meta;
+type Story = StoryObj<typeof Input>;
+export declare const Sizes: Story;
+/**
+ * **Note:** Adornments should be wrapped in an `AdornmentButton` component.
+ *
+ * ```tsx
+ * <Input startAdornment={
+ *  <AdornmentButton>
+ *    <RiSearchLine />
+ *  </AdornmentButton>
+ * } {...otherProps} />
+ * ```
+ */
+export declare const Adornments: Story;
+export declare const States: Story;

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));
+});
+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;