@rabbitio/ui-kit 1.0.0-beta.11 → 1.0.0-beta.111

package/src/ui-kit/components/molecules/ColoredNotice/ColoredNotice.jsx

@@ -0,0 +1,52 @@
+import React from "react";
+import PropTypes from "prop-types";
+
+import s from "./colored-notice.module.scss";
+
+import { Button } from "../../atoms/buttons/Button/Button";
+
+export const COLORED_NOTICE_COLORS = {
+    DEFAULT: "default",
+    GREEN: "green",
+    RED: "red",
+    ORANGE: "orange",
+};
+
+/**
+ * ColoredNotice component displays a notice with optional text and a button.
+ *
+ * @component
+ * @param {Object} props - The component props.
+ * @param {string} [props.text] - The text to be displayed in the notice.
+ * @param {string} [props.buttonTitle] - The title of the button.
+ * @param {string} [props.color=COLORED_NOTICE_COLORS.DEFAULT] - Sets the background color of the notice. Acceptable values are: 'default', 'green', 'red', or 'orange'.
+ * @returns {JSX.Element} The ColoredNotice component.
+ */
+export const ColoredNotice = ({
+    text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor.",
+    buttonTitle,
+    onButtonClick = () => {},
+    color = COLORED_NOTICE_COLORS.DEFAULT,
+}) => {
+    return (
+        <div className={s["colored-notice"] + (color === COLORED_NOTICE_COLORS.DEFAULT ? "" : " " + s[color])}>
+            <p className={s["colored-notice-text"]}>{text}</p>
+            {buttonTitle ? (
+                <Button mode="primary" size="sm" content={buttonTitle} loader={false} onClick={onButtonClick} />
+            ) : null}
+        </div>
+    );
+};
+
+ColoredNotice.propTypes = {
+    text: PropTypes.string,
+    buttonTitle: PropTypes.string,
+    onButtonClick: PropTypes.func,
+    color: PropTypes.oneOf(Object.values(COLORED_NOTICE_COLORS)),
+};
+
+ColoredNotice.defaultProps = {
+    text: "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor.",
+    onButtonClick: () => {},
+    color: COLORED_NOTICE_COLORS.DEFAULT,
+};

package/src/ui-kit/components/molecules/ColoredNotice/colored-notice.module.scss

@@ -0,0 +1,36 @@
+@use "../../../assets/styles/index" as *;
+
+.colored-notice {
+    display: flex;
+    align-items: flex-start;
+    flex-direction: column;
+    gap: Margin("3");
+    justify-content: space-between;
+    padding: Padding("5");
+    border-radius: $borderRadius;
+    background-color: LightColor(army-20);
+    width: 100%;
+    box-shadow: 0px 0px 0px 1px rgba(SolidColor("army"), 0.1) inset;
+    color: SolidColor("tosca");
+
+    &.green {
+        background-color: LightColor("green-20");
+        color: SolidColor("green");
+    }
+    &.red {
+        background-color: LightColor("red-20");
+        color: SolidColor("red");
+        box-shadow: 0px 0px 0px 1px rgba(SolidColor("red"), 0.1) inset;
+    }
+    &.orange {
+        background-color: LightColor("orange-20");
+        color: SolidColor("orange");
+        box-shadow: 0px 0px 0px 1px rgba(SolidColor("orange"), 0.1) inset;
+    }
+
+    &-text {
+        color: inherit;
+        margin: 0;
+        text-align: left;
+    }
+}

package/src/ui-kit/components/molecules/LineWithIconLink/LineWithIconLink.jsx

@@ -0,0 +1,35 @@
+import React from "react";
+import PropTypes from "prop-types";
+
+import s from "./line-with-icon-link.module.scss";
+
+/**
+ * Renders a line with text and an accompanying icon that serves as a link.
+ *
+ * @param {Object} props - Component props.
+ * @param {string} props.text - Text to be displayed.
+ * @param {string} props.icon - URL of the icon image.
+ * @param {string} props.url - Target URL that the icon link points to.
+ */
+export const LineWithIconLink = ({ text, icon, url }) => {
+    return (
+        <div className={s["line-with-icon-link"]}>
+            <h5 className={s["line-with-icon-link-text"]}>{text}</h5>
+            <a href={url} target="_blank" rel="noopener noreferrer" className={"line-with-icon-link-icon"}>
+                <img src={icon} alt="Link Icon" loading="lazy" />
+            </a>
+        </div>
+    );
+};
+
+LineWithIconLink.propTypes = {
+    text: PropTypes.string.isRequired,
+    icon: PropTypes.string.isRequired,
+    url: PropTypes.string.isRequired,
+};
+
+LineWithIconLink.defaultProps = {
+    text: "",
+    icon: "",
+    url: "",
+};

package/src/ui-kit/components/molecules/LineWithIconLink/line-with-icon-link.module.scss

@@ -0,0 +1,25 @@
+@use "../../../assets/styles/index" as *;
+
+.line-with-icon-link {
+    display: flex;
+    align-items: center;
+    // font-family: NunitoSans;
+
+    &-text {
+        white-space: nowrap;
+        text-overflow: ellipsis;
+        overflow: hidden;
+        font-weight: $bold;
+        margin-right: Margin("4");
+    }
+
+    &-icon {
+        @extend %hover-state;
+        display: flex;
+        align-items: center;
+
+        img {
+            width: 24px;
+        }
+    }
+}

package/src/ui-kit/components/molecules/LogoCarousel/LogoCarousel.jsx

@@ -0,0 +1,74 @@
+import React, { useEffect, useRef, useState } from "react";
+import PropTypes from "prop-types";
+
+import s from "./logo-carousel.module.scss";
+
+/**
+ * LogoCarousel component renders a set of logos in a sliding carousel.
+ *
+ * @component
+ *
+ * @param {Object} props - The props object for this component.
+ * @param {Array<{logo: string, url: string}>} props.logos - Array of objects representing logos and their corresponding URLs.
+ * @param {boolean} props.grayscale - Enable the grayscale mode for the logos.
+ */
+export const LogoCarousel = ({ logos, grayscale = false }) => {
+    const [multiplier, setMultiplier] = useState();
+    const [width, setWidth] = useState(0);
+
+    const wrapperRef = useRef();
+
+    useEffect(() => {
+        const resizeObserver = new ResizeObserver(entries => entries.map(entry => setWidth(entry.contentRect.width)));
+        if (wrapperRef.current) resizeObserver.observe(wrapperRef.current);
+        return () => {
+            if (wrapperRef.current) resizeObserver.unobserve(wrapperRef.current);
+        };
+    }, []);
+
+    useEffect(() => {
+        setMultiplier(wrapperRef.current.clientWidth / 120);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [wrapperRef, wrapperRef?.current?.clientWidth, logos, width]);
+
+    return (
+        <div className={s["logo-carousel"]}>
+            <div
+                className={s["logo-carousel-wrapper"]}
+                ref={wrapperRef}
+                style={{ animationDuration: multiplier + "s" }}
+            >
+                {[...Array(2)].map((z, i) => (
+                    <div className={s["logo-carousel-slide"]} key={"logo-carousel-slide-" + i}>
+                        {logos.map((item, index) => (
+                            <a
+                                key={"logo-carousel-slide-" + i + "-" + index}
+                                className={[item?.url ? s["clickable"] : null, grayscale ? s["grayscale"] : null].join(
+                                    " "
+                                )}
+                                href={item?.url}
+                                target="_blank"
+                            >
+                                <img src={item.logo} alt="logo" loading="lazy" />
+                            </a>
+                        ))}
+                    </div>
+                ))}
+            </div>
+        </div>
+    );
+};
+
+LogoCarousel.propTypes = {
+    logos: PropTypes.arrayOf(
+        PropTypes.shape({
+            logo: PropTypes.string.isRequired,
+            url: PropTypes.string,
+        })
+    ).isRequired,
+    grayscale: PropTypes.bool,
+};
+
+LogoCarousel.defaultProps = {
+    grayscale: false,
+};

package/src/ui-kit/components/molecules/LogoCarousel/logo-carousel.module.scss

@@ -0,0 +1,106 @@
+@use "../../../assets/styles/index" as *;
+
+@keyframes slide {
+    from {
+        transform: translateX(0);
+    }
+    to {
+        transform: translateX(-50%);
+    }
+}
+
+@keyframes easeIn {
+    from {
+        opacity: 0;
+    }
+    to {
+        opacity: 1;
+    }
+}
+
+.logo-carousel {
+    $height: clamp(30px, 5vw, 35px);
+    $margin: clamp(30px, 5vw, 40px);
+
+    overflow: hidden;
+    position: relative;
+    width: 100%;
+    box-sizing: border-box;
+    mask-image: linear-gradient(
+        90deg,
+        rgba(0, 0, 0, 0) 0%,
+        rgba(0, 0, 0, 1) 60px,
+        rgba(0, 0, 0, 1) calc(100% - 60px),
+        rgba(0, 0, 0, 0) 100%
+    );
+    display: flex;
+    height: $height;
+
+    &-wrapper {
+        display: flex;
+        align-items: center;
+        justify-content: flex-start;
+        animation-name: slide;
+        animation-iteration-count: infinite;
+        animation-timing-function: linear;
+    }
+
+    &:hover &-wrapper {
+        animation-play-state: paused;
+    }
+
+    &-slide {
+        display: inline-block;
+        display: inherit;
+        align-items: inherit;
+        justify-content: inherit;
+        gap: $margin;
+        padding-right: $margin;
+
+        a {
+            display: flex;
+            align-items: center;
+
+            &.clickable {
+                transition: 0.2s $transitionEaseOut;
+                transform: scale(1);
+
+                @media (hover: hover) {
+                    &:hover {
+                        transform: scale(1.02);
+                    }
+                }
+
+                &:active {
+                    transition: 0.02s $transitionEaseOut;
+                    transform: scale(0.99);
+                }
+            }
+
+            &.grayscale {
+                transition: 0.2s all $transitionEaseOut;
+                filter: grayscale(1) brightness(1.5) contrast(0.1) sepia(1) hue-rotate(160deg) grayscale(0.5);
+                opacity: 0.3;
+
+                @media (hover: hover) {
+                    &:hover {
+                        filter: grayscale(0) contrast(1);
+                        opacity: 1;
+                    }
+                }
+
+                &:active {
+                    transition: 0.02s $transitionEaseOut;
+                    filter: grayscale(0) contrast(1);
+                    opacity: 1;
+                }
+            }
+
+            img {
+                height: $height;
+                animation: easeIn 1s $transitionEaseOut both;
+                animation-delay: 1s;
+            }
+        }
+    }
+}

package/src/ui-kit/components/molecules/SearchableCoinsList/SearchableCoinsList.jsx

@@ -0,0 +1,114 @@
+import React, { useEffect, useState } from "react";
+import PropTypes from "prop-types";
+
+import { useReferredState } from "../../../hooks/useReferredState";
+import { searchCoins } from "../../../utils/searchCoins";
+
+/**
+ * A component that displays a list of coins that can be searched and filtered.
+ *
+ * @param {Object} props - The properties object.
+ * @param {{ ticker:string, tickerPrintable: string, latinName: string }[]} props.coinsList - The list of all available coins.
+ * @param {Array<{ ticker: string, component: React.Component }>} props.coinsBundle - The bundle of coin components to be displayed.
+ * @param {string} props.searchQuery - The search query to filter coins.
+ * @param {boolean} props.partialLoadingEnabled - Determines if partial loading is enabled.
+ * @param {number} props.partialLoadingIncrement - The increment of coins to load when loading more.
+ * @param {Function} props.onListUpdated - Callback when the list of displayed coins is updated.
+ * @param {Function} props.setIsListFull - Callback to set if the list is fully displayed.
+ * @param {Function} props.setIsSearchResultEmpty - Callback to set if the search result is empty.
+ * @param {number} props.triggerLoadMoreCoins - Triggers loading more coins.
+ */
+export const SearchableCoinsList = ({
+    coinsList,
+    coinsBundle,
+    searchQuery,
+    partialLoadingEnabled = true,
+    partialLoadingIncrement = 100,
+    onListUpdated = () => {},
+    setIsListFull = () => {},
+    setIsSearchResultEmpty = () => {},
+    triggerLoadMoreCoins,
+}) => {
+    const [filteredCoins, setFilteredCoins] = useState([]);
+    const [limitedCoinsNumber, setLimitedCoinsNumber] = useReferredState(0);
+    const [displayedCoins, setDisplayedCoins] = useState([]);
+
+    const handleSearchAsset = value => {
+        if (value !== "") {
+            setFilteredCoins(
+                searchCoins(
+                    coinsList.map(coin => ({
+                        name: coin.latinName,
+                        tickerFull: coin.ticker,
+                        tickerShort: coin.tickerPrintable,
+                        coinToReturn: coin,
+                    })),
+                    value
+                )
+            );
+        } else {
+            setFilteredCoins(coinsList); // Reset to original list if search term is empty
+        }
+    };
+
+    const updateDisplayedCoins = () => {
+        const fullList = limitedCoinsNumber.current >= filteredCoins.length;
+        setDisplayedCoins(fullList ? filteredCoins : filteredCoins.slice(0, limitedCoinsNumber.current));
+        setIsListFull(fullList);
+    };
+
+    const displayMoreCoins = () => {
+        setLimitedCoinsNumber(prev => prev + partialLoadingIncrement);
+        updateDisplayedCoins();
+    };
+
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    useEffect(() => onListUpdated(), [displayedCoins]);
+
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    useEffect(() => displayMoreCoins(), [triggerLoadMoreCoins]);
+
+    useEffect(() => {
+        if (filteredCoins?.length > partialLoadingIncrement && partialLoadingEnabled) {
+            setLimitedCoinsNumber(partialLoadingIncrement);
+            updateDisplayedCoins();
+        } else {
+            setLimitedCoinsNumber(0);
+            setDisplayedCoins(filteredCoins);
+            setIsListFull(true);
+        }
+        setIsSearchResultEmpty(filteredCoins?.length === 0 && searchQuery !== "");
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [filteredCoins]);
+
+    useEffect(() => {
+        if (coinsBundle != null) handleSearchAsset(searchQuery);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [coinsList, searchQuery]);
+
+    return displayedCoins?.map((coin, i) => {
+        const bundle = coinsBundle.find(bundleItem => bundleItem.ticker === coin.ticker);
+        const Item = bundle.component;
+        return <Item key={"searchable-coins-list-" + bundle.ticker + "-" + i} />;
+    });
+};
+
+SearchableCoinsList.propTypes = {
+    coinsList: PropTypes.array.isRequired,
+    coinsBundle: PropTypes.array.isRequired,
+    searchQuery: PropTypes.string.isRequired,
+    partialLoadingEnabled: PropTypes.bool,
+    partialLoadingIncrement: PropTypes.number,
+    onListUpdated: PropTypes.func,
+    setIsListFull: PropTypes.func,
+    setIsSearchResultEmpty: PropTypes.func,
+    triggerLoadMoreCoins: PropTypes.number,
+};
+
+SearchableCoinsList.defaultProps = {
+    partialLoadingEnabled: true,
+    partialLoadingIncrement: 100,
+    onListUpdated: () => {},
+    setIsListFull: () => {},
+    setIsSearchResultEmpty: () => {},
+};

package/src/ui-kit/components/molecules/TitledLineWithIconLink/TitledLineWithIconLink.jsx

@@ -0,0 +1,32 @@
+import React from "react";
+import PropTypes from "prop-types";
+
+import { TitleBox } from "../../atoms/TitleBox/TitleBox.jsx";
+import { LineWithIconLink } from "../LineWithIconLink/LineWithIconLink.jsx";
+
+/**
+ * TitledLineWithIconLink component renders a title box with a text line that includes an icon with a clickable link.
+ *
+ * @component
+ * @param {Object} props - The props object.
+ * @param {string} props.title - The title to display in the TitleBox.
+ * @param {string} props.text - The text to display in the LineWithIconLink.
+ * @param {string} props.icon - The icon to display next to the text in the LineWithIconLink.
+ * @param {string} props.url - The URL for the LineWithIconLink.
+ */
+export const TitledLineWithIconLink = ({ title, text, icon, url }) => {
+    return (
+        <TitleBox title={title}>
+            <LineWithIconLink text={text} icon={icon} url={url} />
+        </TitleBox>
+    );
+};
+
+TitledLineWithIconLink.propTypes = {
+    title: PropTypes.string.isRequired,
+    text: PropTypes.string.isRequired,
+    icon: PropTypes.string.isRequired,
+    url: PropTypes.string.isRequired,
+};
+
+TitledLineWithIconLink.defaultProps = {};

package/src/ui-kit/components/organisms/CoinPickerDialogStep/CoinPickerDialogStep.jsx

@@ -0,0 +1,66 @@
+import React from "react";
+
+import { CoinPicker } from "../../molecules/CoinPicker/CoinPicker.jsx";
+import { DialogStep } from "../Dialog/DialogStep/DialogStep.jsx";
+
+import { DIALOG_SIZES } from "../Dialog/Dialog.jsx";
+
+// TODO: [dev] add JSDoc
+export const CoinPickerDialogStep = ({
+    stepName,
+    controls,
+    title,
+    subtitle,
+    handleCoinSelection = () => {},
+    cornerBackButtonTitle,
+    cornerBackButtonClick = null,
+    confirmButtonText,
+    confirmButtonClick,
+    showCornerBackButton,
+    mode,
+    allCoins,
+    initiallyEnabledCoinsList,
+    triggerToReloadData,
+    search,
+    searchAdaptive,
+    loadCoinsAndContent,
+    showRequestMissingCoinsInfoMessage,
+    coinToIconPaths = coin => ({
+        assetIconSrc: undefined,
+        assetIconProtocolSrc: undefined,
+    }),
+    supportUrl,
+    texts,
+}) => {
+    return (
+        <DialogStep
+            controls={controls}
+            stepName={stepName}
+            title={title}
+            subtitle={subtitle}
+            cornerBackButtonTitle={cornerBackButtonTitle}
+            cornerBackButtonClick={cornerBackButtonClick}
+            confirmButtonText={confirmButtonText}
+            confirmButtonClick={confirmButtonClick}
+            showCornerBackButton={showCornerBackButton}
+            headerTitleLeft={true}
+            subtitleSmallMargin={true}
+            width={controls ? DIALOG_SIZES.largePlus.width : null}
+        >
+            <CoinPicker
+                mode={mode}
+                allCoins={allCoins}
+                initiallyEnabledCoinsList={initiallyEnabledCoinsList}
+                handleClick={ticker => handleCoinSelection(ticker)}
+                triggerToReloadData={triggerToReloadData}
+                search={search}
+                searchAdaptive={searchAdaptive}
+                loadCoinsAndContent={loadCoinsAndContent}
+                showRequestMissingCoinsInfoMessage={showRequestMissingCoinsInfoMessage}
+                coinToIconPaths={coinToIconPaths}
+                supportUrl={supportUrl}
+                texts={texts}
+            />
+        </DialogStep>
+    );
+};