@hashicorp/react-components 0.0.0-nightly.ad81ac2 → 0.0.0-nightly.b154bf4

package/src/components/card/primitives.tsx

@@ -1,177 +0,0 @@
-/**
- * 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-hds/src/components/card'
-import { TextPlus } from '@hashicorp/react-hds/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,
-			'aria-label': ariaLabel,
-		} = 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={ariaLabel ?? 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 (
-		<div className={s.meta} data-testid="wpl-card-meta">
-			<TextPlus.Label>
-				{items.map((item, stableIdx) => {
-					const isLastItem = stableIdx === items.length - 1
-					return (
-						<>
-							{item}
-							{!isLastItem ? (
-								<span className={s.metaSeparator} aria-hidden={true}>
-									|
-								</span>
-							) : null}
-						</>
-					)
-				})}
-			</TextPlus.Label>
-		</div>
-	)
-}
-
-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

@@ -1,51 +0,0 @@
-/**
- * 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

@@ -1,48 +0,0 @@
-/**
- * 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).toHaveTextContent(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

@@ -1,40 +0,0 @@
-/**
- * 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
-	isExternal?: CardProps['isExternal']
-}
-
-export function ResourceCard({
-	heading,
-	date,
-	category,
-	link,
-	productBadges,
-	thumbnail,
-	isExternal,
-}: ResourceCardProps) {
-	const meta: string[] = date ? [date, category] : [category]
-
-	return (
-		<UnifiedCard
-			heading={heading}
-			link={link}
-			meta={meta}
-			productBadges={productBadges}
-			thumbnail={thumbnail}
-			isExternal={isExternal}
-		/>
-	)
-}

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

@@ -1,145 +0,0 @@
-/**
- * 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

@@ -1,66 +0,0 @@
-/**
- * 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
-	extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
-	withArrow?: boolean
-	heading: string
-	link: string
-	clickHandler?: () => void
-	isExternal?: boolean
-	hasBorder?: boolean
-}
-
-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.spec.tsx

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

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

@@ -1,58 +0,0 @@
-/**
- * Copyright (c) HashiCorp, Inc.
- * SPDX-License-Identifier: MPL-2.0
- */
-
-import type { ReactNode } from 'react'
-import Badge from '@hashicorp/react-hds/src/components/badge'
-import * as CardPrimitives from '../primitives'
-import type { CardProps } from '../types'
-
-export interface UnifiedCardProps extends CardProps {
-	badges?: (string | [ReactNode, string])[]
-}
-
-export function UnifiedCard({
-	heading,
-	meta,
-	link,
-	productBadges,
-	badges,
-	thumbnail,
-	withArrow = false,
-	isExternal = false,
-	className,
-	'aria-label': ariaLabel,
-}: UnifiedCardProps) {
-	return (
-		<CardPrimitives.Card
-			heading={heading}
-			link={link}
-			withArrow={withArrow}
-			isExternal={isExternal}
-			className={className}
-			aria-label={ariaLabel ?? heading}
-		>
-			{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>
-	)
-}

package/src/components/intro/index.tsx

@@ -1,82 +0,0 @@
-/**
- * Copyright (c) HashiCorp, Inc.
- * SPDX-License-Identifier: MPL-2.0
- */
-
-import classNames from 'classnames'
-import type { IntroProps } from './types'
-import Actions from '../actions'
-import s from './style.module.css'
-
-export default function Intro({
-	appearance = 'light',
-	textAlignment = 'left',
-	eyebrow,
-	heading,
-	headingElement: HeadingElement = 'h2',
-	headingSize = 2,
-	description,
-	actions,
-}: IntroProps) {
-	const headingSizeClassname = `g-type-display-${headingSize}`
-	const descriptionSizeClassname =
-		headingSize === 1 ? 'g-type-body-large' : 'g-type-body'
-	const descriptionClassName = classNames(
-		s.description,
-		descriptionSizeClassname
-	)
-	return (
-		<div
-			className={classNames(s.intro, s[appearance], s[textAlignment])}
-			data-testid="intro"
-		>
-			{eyebrow ? <p className={s.eyebrow}>{eyebrow}</p> : null}
-			<HeadingElement className={classNames(s.heading, headingSizeClassname)}>
-				{heading}
-			</HeadingElement>
-			<Description className={descriptionClassName}>{description}</Description>
-			{actions && actions.ctas && actions.ctas.length > 0 ? (
-				<div className={s.actions}>
-					<Actions
-						appearance={appearance}
-						layout={actions.layout}
-						alignment={textAlignment}
-						theme={actions.theme}
-						size={actions.size}
-						ctas={actions.ctas}
-					/>
-				</div>
-			) : null}
-		</div>
-	)
-}
-
-const containsHTML = (str: string) => /<[a-z][\s\S]*>/i.test(str)
-
-function Description({
-	className,
-	children,
-}: {
-	className: string
-	children: IntroProps['description']
-}) {
-	// ReactNode
-	if (typeof children === 'object') {
-		return <div className={className}>{children}</div>
-	}
-
-	// HTML String
-	if (typeof children === 'string' && containsHTML(children)) {
-		return (
-			<div
-				dangerouslySetInnerHTML={{
-					__html: children,
-				}}
-				className={className}
-			/>
-		)
-	}
-
-	// String
-	return <p className={className}>{children}</p>
-}