@hashicorp/react-components 0.0.0-canary.57d393c

package/src/components/card/person-card/index.tsx

@@ -0,0 +1,93 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+import { memo, type ReactNode } from 'react'
+import { TextPlus } from '@hashicorp/react-design-system-components/src/components/text'
+import { IconGithub16 } from '@hashicorp/flight-icons/svg-react/github-16'
+import { IconTwitter16 } from '@hashicorp/flight-icons/svg-react/twitter-16'
+import { IconLinkedin16 } from '@hashicorp/flight-icons/svg-react/linkedin-16'
+import { IconLink16 } from '@hashicorp/flight-icons/svg-react/link-16'
+import { IconMail16 } from '@hashicorp/flight-icons/svg-react/mail-16'
+import type { ProductBadgesProps, ThumbnailProps } from '../types'
+import * as CardPrimitives from '../primitives'
+import s from './style.module.css'
+
+export interface PersonCardProps {
+	thumbnail: ThumbnailProps
+	link: string
+	name: string
+	location?: string
+	bio?: string
+	productBadges?: ProductBadgesProps['badges']
+}
+
+// Map of hostnames to icons.
+/* eslint-disable react/jsx-key */
+const iconMap = new Map<string, ReactNode>([
+	// null signals that we don't want to render any icon
+	['hashicorp.com', null],
+	[
+		'twitter.com',
+		<IconTwitter16 data-testid={'wpl-personcard-twitter-icon'} />,
+	],
+	['github.com', <IconGithub16 data-testid={'wpl-personcard-github-icon'} />],
+	[
+		'linkedin.com',
+		<IconLinkedin16 data-testid={'wpl-personcard-linkedin-icon'} />,
+	],
+	['mailto:', <IconMail16 data-testid={'wpl-personcard-mail-icon'} />],
+])
+/* eslint-enable react/jsx-key */
+
+const Icon = memo(function Icon({ url }: { url: string }) {
+	const { protocol, host } = new URL(url)
+	const icon = iconMap.get(protocol === 'mailto:' ? 'mailto:' : host)
+
+	// If the icon value is null, don't render an icon
+	if (icon === null) {
+		return null
+	}
+
+	// Render the icon or the default icon if the icon value is undefined
+	return (
+		<div className={s.thumbnailIcon}>
+			{icon ?? <IconLink16 data-testid={'wpl-personcard-link-icon'} />}
+		</div>
+	)
+})
+
+export function PersonCard({
+	link,
+	thumbnail,
+	name,
+	location,
+	bio,
+	productBadges,
+}: PersonCardProps) {
+	return (
+		<CardPrimitives.Card heading={name} link={link} withArrow={false}>
+			<div className={s.thumbnailContainer}>
+				<CardPrimitives.PersonThumbnail {...thumbnail} />
+				<Icon url={link} />
+			</div>
+			<CardPrimitives.Content>
+				<div>
+					<CardPrimitives.Heading>{name}</CardPrimitives.Heading>
+					{location ? (
+						<TextPlus.Body tag="p" size="200" className={s.location}>
+							{location}
+						</TextPlus.Body>
+					) : null}
+				</div>
+				{bio ? (
+					<CardPrimitives.Description>{bio}</CardPrimitives.Description>
+				) : null}
+				{productBadges && productBadges?.length > 0 ? (
+					<CardPrimitives.ProductBadges badges={productBadges} />
+				) : null}
+			</CardPrimitives.Content>
+		</CardPrimitives.Card>
+	)
+}

package/src/components/card/person-card/style.module.css

@@ -0,0 +1,33 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+.location {
+	margin: 0;
+	color: var(--token-color-foreground-faint);
+}
+
+.thumbnailContainer {
+	position: relative;
+}
+
+.thumbnailIcon {
+	--size: 40px;
+
+	position: absolute;
+	bottom: 20px;
+	right: 20px;
+	width: var(--size);
+	height: var(--size);
+	display: grid;
+	place-items: center;
+	border-radius: 9999px;
+	overflow: hidden;
+	background-color: white;
+	opacity: 0.5;
+
+	& svg {
+		position: relative;
+	}
+}

package/src/components/card/primitives.tsx

@@ -0,0 +1,176 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+import * as React from 'react'
+import classNames from 'classnames'
+import Image from 'next/image'
+import Link from 'next/link'
+import HDSCard from '@hashicorp/react-design-system-components/src/components/card'
+import { TextPlus } from '@hashicorp/react-design-system-components/src/components/text'
+import { IconArrowRight24 } from '@hashicorp/flight-icons/svg-react/arrow-right-24'
+import ProductBadge from '../product-badge'
+import type {
+	CardPrimitiveProps,
+	ThumbnailProps,
+	MetaProps,
+	ContentProps,
+	HeadingProps,
+	ProductBadgesProps,
+	DescriptionProps,
+} from './types'
+import s from './style.module.css'
+
+const Card = React.forwardRef<HTMLAnchorElement, CardPrimitiveProps>(
+	(props, ref) => {
+		const {
+			withArrow = true,
+			heading,
+			link,
+			clickHandler,
+			isExternal,
+			hasBorder = true,
+			children,
+			className,
+		} = props
+
+		const linkProps = isExternal
+			? { target: '_blank', rel: 'noopener noreferrer' }
+			: {}
+
+		return (
+			<HDSCard
+				level="mid"
+				levelHover="high"
+				className={classNames(s.card, className)}
+				overflow="hidden"
+				hasBorder={hasBorder}
+			>
+				<div className={s.contentContainer}>
+					{children}
+
+					<div className={s.cta} data-testid="wpl-card-cta">
+						{withArrow ? <IconArrowRight24 /> : null}
+					</div>
+
+					<Link
+						href={link}
+						ref={ref}
+						className={s.link}
+						aria-label={heading}
+						onClickCapture={clickHandler}
+						{...linkProps}
+					/>
+				</div>
+			</HDSCard>
+		)
+	}
+)
+
+function Thumbnail({ src, alt }: ThumbnailProps) {
+	return (
+		<div className={s.thumbnail} data-testid="wpl-card-thumbnail">
+			<div className={s.image}>
+				<Image src={src} alt={alt} width={800} height={450} />
+			</div>
+		</div>
+	)
+}
+
+function PersonThumbnail({ src, alt }: ThumbnailProps) {
+	return (
+		<div className={s.personThumbnail} data-testid="wpl-card-thumbnail">
+			<div className={s.image}>
+				<Image src={src} alt={alt} width={800} height={450} />
+			</div>
+		</div>
+	)
+}
+
+function LogoThumbnail({ src, alt }: ThumbnailProps) {
+	return (
+		<div className={s.logoThumbnail} data-testid="wpl-card-logo-thumbnail">
+			<div className={s.image}>
+				<Image src={src} alt={alt} width={800} height={450} />
+			</div>
+		</div>
+	)
+}
+
+function Meta({ items }: MetaProps) {
+	return (
+		<ul className={s.meta} data-testid="wpl-card-meta">
+			{items.map((item, stableIdx) => {
+				return (
+					// eslint-disable-next-line react/no-array-index-key
+					<li key={stableIdx}>
+						<TextPlus.Label>
+							{item}
+							{stableIdx < items.length - 1 ? (
+								<span className={s.metaSeparator} aria-hidden={true}>
+									|
+								</span>
+							) : null}
+						</TextPlus.Label>
+					</li>
+				)
+			})}
+		</ul>
+	)
+}
+
+function Content({ children }: ContentProps) {
+	return (
+		<div className={s.content} data-testid="wpl-card-content">
+			{children}
+		</div>
+	)
+}
+
+function Heading({ as = 'h2', children }: HeadingProps) {
+	return (
+		<TextPlus.DisplayExpressive tag={as} size="200" className={s.heading}>
+			{children}
+		</TextPlus.DisplayExpressive>
+	)
+}
+
+function ProductBadges({ badges, children }: ProductBadgesProps) {
+	return (
+		<div className={s.productBadges} data-testid="wpl-card-badges">
+			{badges.map((badge, stableIdx) => {
+				return (
+					<ProductBadge
+						// eslint-disable-next-line react/no-array-index-key
+						key={`product-badge-${stableIdx}`}
+						productName={badge}
+						hasDot={true}
+					/>
+				)
+			})}
+			{children}
+		</div>
+	)
+}
+
+function Description({ children }: DescriptionProps) {
+	return (
+		<TextPlus.Body tag="p" size="200" className={s.description}>
+			{children}
+		</TextPlus.Body>
+	)
+}
+
+Card.displayName = 'Card'
+export {
+	Card,
+	Thumbnail,
+	PersonThumbnail,
+	LogoThumbnail,
+	Meta,
+	Content,
+	Heading,
+	Description,
+	ProductBadges,
+}

package/src/components/card/promo-card/index.tsx

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+import * as CardPrimitives from '../primitives'
+import type { ThumbnailProps } from '../types'
+
+export interface PromoCardProps {
+	heading: string
+	description?: string
+	eyebrow?: string
+	link: string
+	clickHandler?: () => void
+	thumbnail?: ThumbnailProps
+	withArrow?: boolean
+	isExternal?: boolean
+	className?: string
+}
+
+export function PromoCard({
+	heading,
+	description,
+	eyebrow,
+	link,
+	clickHandler,
+	thumbnail,
+	withArrow = false,
+	isExternal = false,
+	className,
+}: PromoCardProps) {
+	return (
+		<CardPrimitives.Card
+			heading={heading}
+			link={link}
+			withArrow={withArrow}
+			isExternal={isExternal}
+			className={className}
+			clickHandler={clickHandler}
+		>
+			{thumbnail ? <CardPrimitives.Thumbnail {...thumbnail} /> : null}
+			<CardPrimitives.Content>
+				{eyebrow ? <CardPrimitives.Meta items={[eyebrow]} /> : null}
+				<CardPrimitives.Heading>{heading}</CardPrimitives.Heading>
+				{description ? (
+					<CardPrimitives.Description>{description}</CardPrimitives.Description>
+				) : null}
+			</CardPrimitives.Content>
+		</CardPrimitives.Card>
+	)
+}

package/src/components/card/resource-card/index.test.tsx

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+import { render, screen } from '@testing-library/react'
+import { ResourceCard } from '.'
+
+const defaultProps = {
+	link: 'https://hashicorp.com',
+	heading: 'Example heading',
+	date: 'August 15, 2022',
+	category: 'Category',
+	thumbnail: {
+		src: 'https://www.datocms-assets.com/19447/1648680074-screenshot-2022-03-31-at-00-40-47.png',
+		alt: 'HashiConf Europe 2022 Recap',
+	},
+}
+
+describe('<ResourceCard />', () => {
+	it('should render the provided date and category with separator', () => {
+		const expectedMeta = [defaultProps.date, defaultProps.category]
+
+		render(<ResourceCard {...defaultProps} />)
+
+		const metaElement = screen.getByTestId('wpl-card-meta')
+
+		expectedMeta.forEach((item) => {
+			expect(metaElement).toContainElement(screen.getByText(item))
+		})
+
+		expect(metaElement).toContainElement(screen.getByText('|'))
+	})
+
+	it('should not render the date if no date is provided', () => {
+		const defaultPropsWithoutDate = { ...defaultProps, date: '' }
+
+		render(<ResourceCard {...defaultPropsWithoutDate} />)
+
+		const metaElement = screen.getByTestId('wpl-card-meta')
+
+		expect(metaElement).toContainElement(
+			screen.getByText(defaultProps.category)
+		)
+
+		expect(metaElement).not.toContainElement(screen.queryByText('|'))
+	})
+})

package/src/components/card/resource-card/index.tsx

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+import type { CardProps, ThumbnailProps } from '../types'
+import { UnifiedCard } from '../unified-card'
+
+export interface ResourceCardProps {
+	heading: string
+	date?: string
+	category: string
+	link: string
+	productBadges?: CardProps['productBadges']
+	thumbnail: ThumbnailProps
+}
+
+export function ResourceCard({
+	heading,
+	date,
+	category,
+	link,
+	productBadges,
+	thumbnail,
+}: ResourceCardProps) {
+	const meta: string[] = date ? [date, category] : [category]
+
+	return (
+		<UnifiedCard
+			heading={heading}
+			link={link}
+			meta={meta}
+			productBadges={productBadges}
+			thumbnail={thumbnail}
+		/>
+	)
+}

package/src/components/card/style.module.css

@@ -0,0 +1,145 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+.card {
+	display: flex;
+	flex-direction: column;
+	flex-grow: 1;
+	transition: 0.2s ease;
+	transition-property: transform, box-shadow, border-color, background-color;
+
+	&:hover {
+		transform: translateY(-2px);
+
+		& .cta svg {
+			transform: translateX(2px);
+		}
+	}
+
+	&.dark {
+		& .thumbnail {
+			border-bottom: 0;
+		}
+	}
+
+	&:focus-within {
+		outline-color: var(--token-color-focus-action-external);
+		outline-width: 2px;
+		outline-style: solid;
+		outline-offset: 0;
+	}
+}
+
+.contentContainer {
+	display: flex;
+	flex-direction: column;
+	flex-grow: 1;
+	overflow: hidden;
+	position: relative;
+}
+
+.link {
+	position: absolute;
+	inset: 0;
+	outline: none;
+}
+
+.thumbnail {
+	& .image {
+		position: relative;
+		display: grid;
+		aspect-ratio: 16 / 9;
+		overflow: hidden;
+
+		& img {
+			object-fit: cover;
+			object-position: center;
+			width: 100%;
+			height: 100%;
+		}
+	}
+}
+
+.personThumbnail {
+	composes: thumbnail;
+	& .image {
+		aspect-ratio: 4 / 3;
+	}
+}
+
+.logoThumbnail {
+	composes: thumbnail;
+	padding: var(--hdsplus-spacing-07);
+
+	& .image {
+		aspect-ratio: none;
+
+		& img {
+			aspect-ratio: 16 / 9;
+			object-fit: contain;
+		}
+	}
+}
+
+.meta {
+	color: var(--token-color-foreground-faint);
+	text-transform: uppercase;
+	margin: 0;
+	display: flex;
+	flex-wrap: wrap;
+	list-style: none;
+	padding: 0;
+}
+
+.metaSeparator {
+	--padding-x: 12px;
+
+	padding-left: var(--padding-x);
+	padding-right: var(--padding-x);
+}
+
+.content {
+	display: flex;
+	flex-direction: column;
+	flex-grow: 1;
+	row-gap: 16px;
+	padding: 20px 20px 0 20px;
+}
+
+.heading {
+	font-weight: var(--token-typography-font-weight-bold);
+	color: var(--token-color-foreground-strong);
+	margin: 0;
+}
+
+.description {
+	color: var(--token-color-foreground-primary);
+	margin: 0;
+}
+
+.productBadges {
+	margin-top: auto;
+	display: flex;
+	flex-wrap: wrap;
+	gap: 8px;
+}
+
+.cta {
+	display: flex;
+	align-items: center;
+	justify-content: flex-end;
+	color: var(--token-color-foreground-primary);
+	padding: 8px 20px 20px 20px;
+	margin-top: auto;
+	transition: color 0.25s ease;
+
+	& svg {
+		transition: transform 0.25s ease;
+	}
+
+	&:empty {
+		padding-top: 0;
+	}
+}

package/src/components/card/types.ts

@@ -0,0 +1,66 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+import type { ReactNode } from 'react'
+import type { ProductBadgeProps } from '../product-badge'
+import type { NewsroomCardProps } from './newsroom-card'
+import type { PersonCardProps } from './person-card'
+import type { ResourceCardProps } from './resource-card'
+import type { UnifiedCardProps } from './unified-card'
+
+export interface BaseCardProps {
+	withArrow?: boolean
+	heading: string
+	link: string
+	clickHandler?: () => void
+	isExternal?: boolean
+	hasBorder?: boolean
+	className?: string
+}
+
+export interface CardPrimitiveProps extends BaseCardProps {
+	children: ReactNode
+}
+
+export interface ThumbnailProps {
+	src: string
+	alt: string
+}
+
+export interface MetaProps {
+	items: Array<string | ReactNode>
+}
+
+export interface ContentProps {
+	children: ReactNode
+}
+
+export interface HeadingProps {
+	as?: 'h2' | 'h3' | 'h4'
+	children: string
+}
+
+export interface ProductBadgesProps {
+	badges: Array<ProductBadgeProps['productName']>
+	children?: ReactNode
+}
+
+export interface DescriptionProps {
+	children: string
+}
+
+export interface CardProps extends BaseCardProps {
+	thumbnail?: ThumbnailProps
+	meta?: MetaProps['items']
+	description?: DescriptionProps['children']
+	productBadges?: ProductBadgesProps['badges']
+}
+
+export {
+	NewsroomCardProps,
+	PersonCardProps,
+	ResourceCardProps,
+	UnifiedCardProps,
+}

package/src/components/card/unified-card/index.tsx

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+import type { ReactNode } from 'react'
+import Badge from '@hashicorp/react-design-system-components/src/components/badge'
+import * as CardPrimitives from '../primitives'
+import type { CardProps, ThumbnailProps } from '../types'
+
+export interface UnifiedCardProps {
+	heading: string
+	meta?: string[]
+	link: string
+	productBadges?: CardProps['productBadges']
+	badges?: (string | [ReactNode, string])[]
+	thumbnail?: ThumbnailProps
+	withArrow?: boolean
+	isExternal?: boolean
+	className?: string
+}
+
+export function UnifiedCard({
+	heading,
+	meta,
+	link,
+	productBadges,
+	badges,
+	thumbnail,
+	withArrow = false,
+	isExternal = false,
+	className,
+}: UnifiedCardProps) {
+	return (
+		<CardPrimitives.Card
+			heading={heading}
+			link={link}
+			withArrow={withArrow}
+			isExternal={isExternal}
+			className={className}
+		>
+			{thumbnail ? <CardPrimitives.Thumbnail {...thumbnail} /> : null}
+			<CardPrimitives.Content>
+				{meta && meta.length > 0 ? <CardPrimitives.Meta items={meta} /> : null}
+				<CardPrimitives.Heading>{heading}</CardPrimitives.Heading>
+				{productBadges && productBadges?.length > 0 ? (
+					<CardPrimitives.ProductBadges badges={productBadges}>
+						{badges && badges.length > 0
+							? badges.map((badge, stableIdx) => {
+									if (Array.isArray(badge)) {
+										return (
+											<Badge key={stableIdx} icon={badge[0]} text={badge[1]} />
+										)
+									}
+
+									return <Badge key={stableIdx} text={badge} />
+							  })
+							: null}
+					</CardPrimitives.ProductBadges>
+				) : null}
+			</CardPrimitives.Content>
+		</CardPrimitives.Card>
+	)
+}