@arc-ui/community-components 0.1.0

package/src/components/PromoListing/PromoListing.tsx

@@ -0,0 +1,153 @@
+import React, { useId } from "react";
+import classNames from "classnames";
+
+import { ArcSizeBreakpointsL } from "@arc-ui/tokens-arc";
+
+import { Carousel } from "@arc-ui/components/dist/Carousel";
+import { useMediaQuery } from "@arc-ui/components/dist/use-media-query";
+
+import { SectionHeading, type SectionHeadingProps } from "../SectionHeading";
+
+import {
+  MediaCard,
+  type MediaCardProps,
+} from "@arc-ui/components/dist/MediaCard";
+
+import {
+  ImpactCard,
+  type ImpactCardProps,
+} from "@arc-ui/components/dist/ImpactCard";
+
+import {
+  InformationCard,
+  type InformationCardProps,
+} from "@arc-ui/components/dist/InformationCard";
+
+import {
+  TypographyCard,
+  type TypographyCardProps,
+} from "@arc-ui/components/dist/TypographyCard";
+
+import styles from "./PromoListing.module.css";
+
+/**
+ * Use `PromoListing` to give supporting information about a page or proposition in the form of the card components (`ImpactCard`, `InformationCard`, `MediaCard` and `TypographyCard`).
+ */
+export const PromoListing: React.FC<PromoListingProps> = ({
+  heading,
+  content,
+  isCarousel,
+  cards,
+  headingLevel,
+  columns = "2",
+}) => {
+  const id = useId();
+
+  const isMinWidthArcBreakpointL = useMediaQuery(
+    `(min-width: ${ArcSizeBreakpointsL})`,
+  );
+
+  const columnCount = isMinWidthArcBreakpointL ? columns : 2;
+
+  const getCard = (card: PromoListCard) => (
+    <>
+      {card.type === "media-card" && <MediaCard {...card} />}
+      {card.type === "impact-card" && <ImpactCard {...card} />}
+      {card.type === "information-card" && <InformationCard {...card} />}
+      {card.type === "typography-card" && <TypographyCard {...card} />}
+    </>
+  );
+
+  return (
+    <div className={styles.PromoListing}>
+      <SectionHeading
+        isPadded
+        data-testid="PromoListing-header"
+        heading={heading}
+        headingLevel={headingLevel}
+        content={content}
+      />
+
+      {isCarousel && !isMinWidthArcBreakpointL ? (
+        <Carousel
+          itemsPerSlide={1}
+          responsive={{
+            s: {
+              itemsToScroll: 1,
+              isPartialVisible: false,
+              itemsPerSlide: 2,
+            },
+            m: {
+              itemsToScroll: 1,
+              isPartialVisible: true,
+              itemsPerSlide: 2,
+            },
+          }}
+        >
+          {cards?.map((card: PromoListCard, i) => (
+            <div key={`card-${id}-${i}`} className={styles.carouselSlide}>
+              {getCard(card)}
+            </div>
+          ))}
+        </Carousel>
+      ) : (
+        <div
+          className={classNames(
+            styles.cardGrid,
+            styles[`cardGrid${columnCount}Columns`],
+            styles[`cardGrid${cards.length}Cards`],
+          )}
+        >
+          {cards?.map((card: PromoListCard, index) => (
+            <div
+              data-testid={`promoList-card${index}`}
+              className={classNames(styles.promoListingContainer)}
+              key={index}
+            >
+              {getCard(card)}
+            </div>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+};
+
+interface PromoListMediaCard extends MediaCardProps {
+  type: "media-card";
+}
+
+interface PromoListImpactCard extends ImpactCardProps {
+  type: "impact-card";
+}
+
+interface PromoListInformationCard extends InformationCardProps {
+  type: "information-card";
+}
+
+interface PromoListTypographyCard extends TypographyCardProps {
+  type: "typography-card";
+}
+
+type PromoListCard =
+  | PromoListMediaCard
+  | PromoListInformationCard
+  | PromoListTypographyCard
+  | PromoListImpactCard;
+
+export interface PromoListingProps extends SectionHeadingProps {
+  /**
+   * Cards for the PromoListing.
+   */
+  cards: PromoListCard[];
+
+  /**
+   * Shows cards in a carousel on devices below 1024px if true.
+   */
+  isCarousel?: true;
+
+  /**
+   * Number of columns for desktop breakpoints. "2" and "3" column options available.
+   */
+  columns?: "2" | "3";
+}

package/src/components/PromoListing/index.ts

@@ -0,0 +1 @@
+export { PromoListing, type PromoListingProps } from "./PromoListing";

package/src/components/Quote/Quote.module.css

@@ -0,0 +1,60 @@
+@import url("@arc-ui/tokens-arc/dist/custom-media.css");
+
+.blockQuote {
+  font-size: 36px;
+  font-style: normal;
+  font-weight: 500;
+  margin: 0;
+}
+
+.quoteContent {
+  line-height: 44px; /* 114.286% */
+  margin: 0;
+  padding-block: 32px;
+}
+
+.quoteDefault {
+  color: #5514b4; /* TODO: This needs to be tokenized */
+  fill: #5514b4; /* TODO: This needs to be tokenized */
+}
+
+.quoteSecondary {
+  color: #434343; /* TODO: This needs to be tokenized */
+  fill: #434343; /* TODO: This needs to be tokenized */
+}
+
+.quoteIcon {
+  height: 76.471px;
+  width: 100px;
+}
+
+svg {
+  padding: 0;
+}
+
+@media (--arc-custom-media-min-width-m-px) {
+  .blockQuote {
+    font-size: 40px;
+  }
+
+  .quoteContent {
+    line-height: 48px; /* 114.286% */
+  }
+}
+
+@media (--arc-custom-media-min-width-l-px) {
+  .quoteIcon {
+    height: 95.588px;
+    width: 125px;
+  }
+}
+
+@media (--arc-custom-media-min-width-xl-px) {
+  .blockQuote {
+    font-size: 56px;
+  }
+
+  .quoteContent {
+    line-height: 64px; /* 114.286% */
+  }
+}

package/src/components/Quote/Quote.tsx

@@ -0,0 +1,57 @@
+import React from "react";
+import classNames from "classnames";
+
+import { filterDataAttrs } from "@arc-ui/community-utils/filter-data-attrs";
+
+import { Author } from "../Author";
+import { AuthorProps } from "../Author/Author";
+
+import styles from "./Quote.module.css";
+
+/**
+ * Use `Quote` where a quote or testimonial from an existing customer or stakeholder would help build trust and credibility with potential new customers. It's commonly used on product pages where customers would learn about a product or service that we offer.*/
+export const Quote: React.FC<QuoteProps> = ({
+  author,
+  styling = "Default",
+  content,
+  citeUrl,
+  ...props
+}) => {
+  return (
+    <div
+      className="community-component--quote"
+      data-testid="quote-test"
+      {...filterDataAttrs(props)}
+    >
+      <blockquote
+        data-testid="style-test"
+        className={classNames(styles.blockQuote, styles[`quote${styling}`])}
+        cite={citeUrl}
+      >
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          viewBox="0 0 100 77"
+          className={styles.quoteIcon}
+          aria-hidden="true"
+        >
+          <path d="M21.8085 76.4706C15.9574 76.4706 10.8156 74.2732 6.38298 69.8783C2.12766 65.4834 0 58.979 0 50.3651C0 40.5206 3.10284 31.1156 9.30851 22.1501C15.6915 13.1846 25.3546 5.80122 38.2979 0L44.1489 11.3387C37.4113 14.3272 31.7376 18.0189 27.1277 22.4138C22.5177 26.6329 19.6809 31.4672 18.617 36.9168C19.8582 36.741 21.0106 36.6531 22.0745 36.6531C27.7482 36.6531 32.4468 38.499 36.1702 42.1907C40.0709 45.8824 42.0213 50.7167 42.0213 56.6937C42.0213 62.4949 39.9823 67.2414 35.9043 70.9331C32.0035 74.6247 27.305 76.4706 21.8085 76.4706ZM77.6596 76.4706C71.8085 76.4706 66.6667 74.2732 62.234 69.8783C57.9787 65.4834 55.8511 58.979 55.8511 50.3651C55.8511 40.5206 58.9539 31.1156 65.1596 22.1501C71.5425 13.1846 81.2057 5.80122 94.1489 0L100 11.3387C93.2624 14.3272 87.5886 18.0189 82.9787 22.4138C78.3688 26.6329 75.5319 31.4672 74.4681 36.9168C75.7092 36.741 76.8617 36.6531 77.9255 36.6531C83.5993 36.6531 88.2979 38.499 92.0213 42.1907C95.922 45.8824 97.8723 50.7167 97.8723 56.6937C97.8723 62.4949 95.8333 67.2414 91.7553 70.9331C87.8546 74.6247 83.156 76.4706 77.6596 76.4706Z" />
+        </svg>
+        <p className={styles.quoteContent}>{content}</p>
+      </blockquote>
+      {author && (
+        <Author
+          name={author.name}
+          title={author.title}
+          avatar={author.avatar}
+        />
+      )}
+    </div>
+  );
+};
+
+export interface QuoteProps {
+  styling?: "Default" | "Secondary";
+  content: string;
+  author?: AuthorProps;
+  citeUrl?: string;
+}

package/src/components/Quote/index.ts

@@ -0,0 +1 @@
+export { Quote, type QuoteProps } from "./Quote";

package/src/components/SectionHeading/SectionHeading.module.css

@@ -0,0 +1,34 @@
+@import url("@arc-ui/tokens-arc/dist/custom-media.css");
+
+.section-header--padded {
+  padding-bottom: 40px;
+  width: auto;
+}
+
+@media (--arc-custom-media-min-width-s-px) {
+  .section-header--padded {
+    min-width: 588px;
+    width: auto;
+  }
+}
+
+@media (--arc-custom-media-min-width-m-px) {
+  .section-header--padded {
+    min-width: 720px;
+    padding: 0 186px 40px 0;
+  }
+}
+
+@media (--arc-custom-media-min-width-l-px) {
+  .section-header--padded {
+    min-width: 960px;
+    padding: 0 246px 40px 0;
+  }
+}
+
+@media (--arc-custom-media-min-width-xl-px) {
+  .section-header--padded {
+    min-width: 1216px;
+    padding: 0 312px 40px 0;
+  }
+}

package/src/components/SectionHeading/SectionHeading.tsx

@@ -0,0 +1,65 @@
+import React from "react";
+import classNames from "classnames";
+
+import { filterDataAttrs } from "@arc-ui/community-utils/filter-data-attrs";
+
+import { Heading, type HeadingLevel } from "@arc-ui/components/dist/Heading";
+import { Text } from "@arc-ui/components/dist/Text";
+import { VerticalSpace } from "@arc-ui/components/dist/VerticalSpace";
+
+import styles from "./SectionHeading.module.css";
+
+export const SectionHeading: React.FC<SectionHeadingProps> = ({
+  heading,
+  content,
+  id,
+  isPadded = false,
+  headingLevel = "2",
+  ...props
+}) => (
+  <div
+    className={classNames({
+      [styles["section-header--padded"]]: isPadded,
+    })}
+    {...filterDataAttrs(props)}
+  >
+    <Heading level={headingLevel} id={id} size="xl">
+      {heading}
+    </Heading>
+    {content && (
+      <>
+        <VerticalSpace size="24" />
+        <Text size="l" elementType="p">
+          {content}
+        </Text>
+      </>
+    )}
+  </div>
+);
+
+export interface SectionHeadingProps {
+  /**
+   * heading for `SectionHeading`.
+   */
+  heading: string;
+
+  /**
+   * Adds padding to `SectionHeading`.
+   */
+  isPadded?: boolean;
+
+  /**
+   * Determine a heading level for `SectionHeading`.
+   */
+  headingLevel?: HeadingLevel;
+
+  /**
+   * Text content for `SectionHeading`.
+   */
+  content?: string;
+
+  /**
+   * Id content for `SectionHeading`.
+   */
+  id?: string;
+}

package/src/components/SectionHeading/index.ts

@@ -0,0 +1 @@
+export { SectionHeading, type SectionHeadingProps } from "./SectionHeading";

package/src/components/Statistics/Statistics.module.css

@@ -0,0 +1,25 @@
+/* stylelint-disable selector-pseudo-class-no-unknown */
+/* stylelint-disable no-descending-specificity */
+
+@import url("@arc-ui/tokens-arc/dist/custom-media.css");
+
+.list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+:global(.arc a).mutedText,
+.mutedText {
+  color: var(--sem-color-text-primary-light-subtle);
+}
+
+.statWrapper {
+  margin-bottom: -12px;
+}
+
+@media (--arc-custom-media-min-width-s-px) {
+  .statWrapper {
+    margin-bottom: 0;
+  }
+}

package/src/components/Statistics/Statistics.tsx

@@ -0,0 +1,97 @@
+import React, { useId } from "react";
+
+import { Columns } from "@arc-ui/components/dist/Columns";
+import { Rule } from "@arc-ui/components/dist/Rule";
+import { Text } from "@arc-ui/components/dist/Text";
+import { Align } from "@arc-ui/components/dist/Align";
+import { Heading } from "@arc-ui/components/dist/Heading";
+import { VerticalSpace } from "@arc-ui/components/dist/VerticalSpace";
+
+import { SectionHeading, type SectionHeadingProps } from "../SectionHeading";
+
+import styles from "./Statistics.module.css";
+
+import { getLinkProps } from "./helpers/get-link-props";
+import { type Statistic } from "./types/statistic";
+
+export const Statistics: React.FC<StatisticsProps> = ({
+  headingLevel,
+  heading,
+  content,
+  statistics,
+}) => {
+  const id = useId();
+
+  return (
+    <Columns>
+      <Columns.Col spanM={9}>
+        <SectionHeading
+          heading={heading}
+          headingLevel={headingLevel}
+          content={content}
+        />
+        <VerticalSpace size="16" />
+      </Columns.Col>
+      <Columns.Col spanL={9}>
+        <ul className={styles.list}>
+          {statistics.map(({ stat, copy, link, source, sourceUrl }, i) => (
+            <li key={`statistic-${id}-${i}`}>
+              {i !== 0 && (
+                <>
+                  <VerticalSpace size="24" sizeS="32" sizeXL="40" />
+                  <Rule />
+                  <VerticalSpace size="24" sizeS="32" sizeXL="40" />
+                </>
+              )}
+              <Columns>
+                <Columns.Col spanS={6} spanM={8}>
+                  <Align vertical="center">
+                    <div className={styles.statWrapper}>
+                      <Heading color="brand" size="xxl">
+                        {stat}
+                      </Heading>
+                    </div>
+                  </Align>
+                </Columns.Col>
+                <Columns.Col spanS={6} spanM={4}>
+                  <Text>{copy}</Text>
+                  {link && (
+                    <>
+                      <VerticalSpace size="12" />
+                      <a
+                        href={link.href}
+                        aria-label={link.ariaLabel}
+                        {...getLinkProps(link)}
+                      >
+                        {link.text}
+                      </a>
+                    </>
+                  )}
+                  {source && (
+                    <>
+                      <VerticalSpace size="12" />
+                      <Text size="xs">
+                        <span className={styles.mutedText}>{source}</span>
+                      </Text>
+                    </>
+                  )}
+                  {sourceUrl && (
+                    <Text size="xs">
+                      <a className={styles.mutedText} href={sourceUrl}>
+                        {sourceUrl}
+                      </a>
+                    </Text>
+                  )}
+                </Columns.Col>
+              </Columns>
+            </li>
+          ))}
+        </ul>
+      </Columns.Col>
+    </Columns>
+  );
+};
+
+export interface StatisticsProps extends Omit<SectionHeadingProps, "isPadded"> {
+  statistics: Statistic[];
+}

package/src/components/Statistics/helpers/get-link-props.ts

@@ -0,0 +1,11 @@
+import { type StatisticlLink } from "../types/statistic-link";
+
+export const getLinkProps: (
+  link: StatisticlLink,
+) => React.AnchorHTMLAttributes<HTMLAnchorElement> = (link) =>
+  link.openInNewTab
+    ? {
+        rel: "noreferrer",
+        target: "_blank",
+      }
+    : {};

package/src/components/Statistics/index.ts

@@ -0,0 +1 @@
+export { Statistics, type StatisticsProps } from "./Statistics";

package/src/components/Statistics/types/statistic-link.ts

@@ -0,0 +1,6 @@
+export interface StatisticlLink {
+  text: string;
+  href: string;
+  openInNewTab?: boolean;
+  ariaLabel?: string;
+}

package/src/components/Statistics/types/statistic.ts

@@ -0,0 +1,9 @@
+import { type StatisticlLink } from "./statistic-link";
+
+export interface Statistic {
+  stat: string;
+  copy: string;
+  link?: StatisticlLink;
+  source?: string;
+  sourceUrl?: string;
+}

package/src/components/Summary/Summary.module.css

@@ -0,0 +1,31 @@
+@import url("@arc-ui/tokens-arc/dist/custom-media.css");
+
+.ruleContainer {
+  flex: 0 1 auto;
+  padding: 24px;
+}
+
+/* stylelint-disable-next-line selector-pseudo-class-no-unknown */
+.ruleContainer :global(.arc-Rule) {
+  margin: 0;
+}
+
+@media (--arc-custom-media-min-width-s-px) {
+  .row {
+    display: grid;
+    grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr) auto minmax(
+        0,
+        1fr
+      );
+  }
+}
+
+@media (--arc-custom-media-min-width-l-px) {
+  .ruleContainer {
+    padding: 12px 48px;
+  }
+
+  .row {
+    padding: 0 24px;
+  }
+}

package/src/components/Summary/Summary.tsx

@@ -0,0 +1,65 @@
+import React from "react";
+
+import { ArcSizeBreakpointsS } from "@arc-ui/tokens-arc";
+
+import { Heading, type HeadingLevel } from "@arc-ui/components/dist/Heading";
+import { Text } from "@arc-ui/components/dist/Text";
+import { Box } from "@arc-ui/components/dist/Box";
+import { Rule } from "@arc-ui/components/dist/Rule";
+import { VerticalSpace } from "@arc-ui/components/dist/VerticalSpace";
+import { useMediaQuery } from "@arc-ui/components/dist/use-media-query";
+
+import styles from "./Summary.module.css";
+
+export const Summary: React.FC<SummaryProps> = ({
+  content,
+  headingLevel = "3",
+}) => {
+  const isMinWidthArcBreakpointS = useMediaQuery(
+    `(min-width: ${ArcSizeBreakpointsS})`,
+  );
+
+  return (
+    <Box isBorderRadius borderWidth="thin" padding="24">
+      <div className={styles.row}>
+        {content.map(({ heading, text }, i) => (
+          <>
+            <div className={styles.col}>
+              <Heading size="s" level={headingLevel}>
+                {heading}
+              </Heading>
+              <VerticalSpace size="8" />
+              <Text size="s">{text}</Text>
+            </div>
+            {i !== content.length - 1 && (
+              <div className={styles.ruleContainer}>
+                <Rule
+                  orientation={
+                    isMinWidthArcBreakpointS ? "vertical" : "horizontal"
+                  }
+                />
+              </div>
+            )}
+          </>
+        ))}
+      </div>
+    </Box>
+  );
+};
+
+interface SummaryContent {
+  heading: string;
+  text: string;
+}
+
+export interface SummaryProps {
+  /**
+   * Content for <Summary />
+   */
+  content: [SummaryContent, SummaryContent, SummaryContent];
+
+  /**
+   * Determine a heading level for each column.
+   */
+  headingLevel?: HeadingLevel;
+}

package/src/components/Summary/index.ts

@@ -0,0 +1 @@
+export { Summary, type SummaryProps } from "./Summary";

package/src/components/index.ts

@@ -0,0 +1,11 @@
+export { Accordion } from "./Accordion";
+export { Author } from "./Author";
+export { CopyLead } from "./CopyLead";
+export { DownloadList } from "./DownloadList";
+export { FeaturePost } from "./FeaturePost";
+export { Highlights } from "./Highlights";
+export { PromoListing } from "./PromoListing";
+export { Quote } from "./Quote";
+export { Summary } from "./Summary";
+export { Statistics } from "./Statistics";
+export { BannerWithTabs } from "./BannerWithTabs";

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from "./components";
+
+// TODO
+// replace build utils
+// replace arc ui helpers

package/src/types/file-types.d.ts

@@ -0,0 +1,9 @@
+declare module "*.jpg";
+declare module "*.png";
+declare module "*.mp4";
+declare module "*.svg";
+
+declare module "*.css" {
+  const classes: { [key: string]: string };
+  export default classes;
+}

package/stylelint.config.js

@@ -0,0 +1,4 @@
+/** @type {import('stylelint').Config} */
+export default {
+  extends: ["@arc-ui/community-css-config/stylelint"],
+};

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "@arc-ui/community-typescript-config/base.json",
+  "include": ["src"],
+  "compilerOptions": {
+    "rootDir": "src",
+    "baseUrl": "./",
+    "lib": ["dom", "esnext"],
+    "jsx": "react",
+    "declaration": false
+  }
+}