@hashicorp/react-components 0.0.0 → 1.0.1

package/src/components/nav-panel/components/promo/index.tsx

@@ -0,0 +1,79 @@
+import { useCallback } from 'react'
+import { trackNavClickEvent } from '../../../../../../../apps/www/layouts/standard/nav'
+import { v } from '@web/cms'
+import Link from 'next/link'
+import classNames from 'classnames'
+import { parseUrl } from '../../../../../../../apps/www/lib/parseUrl'
+import FlightIcon from '@hashicorp/react-design-system-components/src/components/flight-icon'
+import * as NavigationMenu from '@radix-ui/react-navigation-menu'
+import s from './style.module.css'
+
+export interface PromoProps {
+	title: string
+	description: string
+	linkUrl: string
+	linkTitle: string
+	slug?: string
+	icon?: string
+	theme: string
+}
+
+export default function Promo({
+	title,
+	description,
+	linkUrl,
+	linkTitle,
+	slug,
+	icon,
+	theme,
+}: PromoProps) {
+	const handleClick = useCallback((title, linkUrl, linkTitle, slug) => {
+		if (window && window.analytics) {
+			window.analytics.track('Nav Promo', {
+				url: linkUrl,
+				title: title,
+				callout: linkTitle,
+			})
+
+			trackNavClickEvent(title, linkUrl, slug)
+		}
+	}, [])
+
+	return (
+		<div className={s.promo}>
+			{icon && (
+				<div
+					className={classNames(s.icon, {
+						[s.hashidays]: v(theme) === 'hashidays',
+						[s.hashiconf]: v(theme) === 'hashiconf',
+					})}
+				>
+					<FlightIcon name={v(icon)} />
+				</div>
+			)}
+			<div className={s.rightContent}>
+				<div>
+					<div
+						className={classNames(s.title, {
+							[s.hashidays]: v(theme) === 'hashidays',
+							[s.hashiconf]: v(theme) === 'hashiconf',
+						})}
+					>
+						{title}
+					</div>
+					<div className={s.description}>{description}</div>
+				</div>
+				<NavigationMenu.Link asChild>
+					<Link
+						href={parseUrl(linkUrl).href}
+						className={s.link}
+						onClickCapture={() => handleClick(title, linkUrl, linkTitle, slug)}
+					>
+						{linkTitle}
+						<FlightIcon name="external-link" />
+					</Link>
+				</NavigationMenu.Link>
+			</div>
+		</div>
+	)
+}

package/src/components/nav-panel/components/promo/style.module.css

@@ -0,0 +1,92 @@
+.promo {
+	display: flex;
+	border-radius: var(--hdsplus-spacing-01);
+	border: 1px solid var(--token-color-border-faint);
+	background-color: var(--token-color-surface-faint);
+	padding: var(--hdsplus-spacing-05) var(--hdsplus-spacing-08)
+		var(--hdsplus-spacing-06) var(--hdsplus-spacing-08);
+	flex-direction: row;
+	gap: var(--hdsplus-spacing-04);
+	margin: var(--hdsplus-spacing-05);
+
+	@media (--large) {
+		margin: 0;
+		width: min-content;
+		min-width: 100%;
+	}
+}
+
+.rightContent {
+	display: flex;
+	flex-wrap: wrap;
+	gap: var(--hdsplus-spacing-03);
+	width: 100%;
+	justify-content: space-between;
+}
+
+.title {
+	font-weight: var(--font-weight-semi-bold);
+}
+
+.description {
+	font-size: var(--hdsplus-typography-body-200-font-size);
+	font-weight: var(--token-typography-font-weight-regular);
+	margin-top: var(--hdsplus-spacing-01);
+}
+
+.icon {
+	display: none;
+
+	@media (--large) {
+		display: block;
+		margin-top: 3px;
+	}
+}
+
+.link {
+	color: var(--token-color-foreground-strong);
+	display: flex;
+	flex-direction: row;
+	align-items: center;
+	gap: var(--hdsplus-spacing-02);
+
+	&:hover {
+		text-decoration: underline;
+	}
+
+	&:focus {
+		outline: 2px solid var(--token-color-focus-action-internal);
+		outline-style: auto;
+	}
+}
+
+.hashidays {
+	background: linear-gradient(
+		90deg,
+		#7b54b6 0%,
+		#4c69d8 74.77%,
+		#60d0dc 115.93%
+	);
+	-webkit-background-clip: text;
+	-webkit-text-fill-color: transparent;
+	max-width: fit-content;
+
+	& svg {
+		color: #7956b9;
+	}
+}
+
+.hashiconf {
+	background: linear-gradient(
+		to right,
+		var(--token-color-terraform-foreground),
+		var(--token-color-vagrant-foreground)
+	);
+	-webkit-background-clip: text;
+	-webkit-text-fill-color: transparent;
+	max-width: fit-content;
+
+	& svg {
+		color: var(--token-color-terraform-foreground);
+	}
+}

package/src/components/nav-panel/index.tsx

@@ -0,0 +1,6 @@
+import ProductPanel, { type NavProductProps } from './product-panel'
+import StandardPanel, { type NavItem } from './standard-panel'
+import { PromoProps } from './components/promo'
+
+export { ProductPanel, StandardPanel }
+export type { NavProductProps, PromoProps, NavItem }

package/src/components/nav-panel/product-panel/index.tsx

@@ -0,0 +1,88 @@
+import Link from 'next/link'
+import * as NavPanel from '../components/panel'
+import Promo, { type PromoProps } from '../components/promo'
+import { Products } from '@hashicorp/platform-product-meta'
+import FlightIcon from '@hashicorp/react-design-system-components/src/components/flight-icon'
+import { TextPlus } from '@hashicorp/react-design-system-components/src/components/text'
+import { parseUrl } from '../../../../../../apps/www/lib/parseUrl'
+import { trackNavClickEvent } from '../../../../../../apps/www/layouts/standard/nav'
+import * as NavigationMenu from '@radix-ui/react-navigation-menu'
+import s from './style.module.css'
+
+const PRODUCT_LOGO_MAP = new Map([
+	['Terraform', 'terraform-fill-color'],
+	['Packer', 'packer-fill-color'],
+	['Vault', 'vault-fill-color'],
+	['Boundary', 'boundary-fill-color'],
+	['Consul', 'consul-fill-color'],
+	['Nomad', 'nomad-fill-color'],
+	['Waypoint', 'waypoint-fill-color'],
+	['Vagrant', 'vagrant-fill-color'],
+])
+
+interface ProductsPanelProps {
+	productCategories: any
+	promo?: PromoProps
+}
+
+const ProductPanel = ({ productCategories, promo }: ProductsPanelProps) => {
+	return (
+		<NavPanel.Root>
+			<NavPanel.Column>
+				<ul className={s.productCategories}>
+					{productCategories.map(({ title, products }) => {
+						return (
+							<li key={title} className={s.productCategory}>
+								<TextPlus.Body className={s.eyebrow}>{title}</TextPlus.Body>
+								<ul className={s.productList}>
+									{products.map((product) => {
+										return (
+											<li key={product.url}>
+												<NavProduct {...product} />
+											</li>
+										)
+									})}
+								</ul>
+							</li>
+						)
+					})}
+				</ul>
+			</NavPanel.Column>
+			{promo ? <Promo {...promo} /> : null}
+		</NavPanel.Root>
+	)
+}
+
+export interface NavProductProps {
+	url: string
+	product: Products | string
+	description: string
+}
+
+function NavProduct({ url, product, description }: NavProductProps) {
+	return (
+		<NavigationMenu.Link asChild>
+			<Link
+				href={parseUrl(url).href}
+				onClickCapture={() => {
+					trackNavClickEvent(product, url, 'products')
+				}}
+				className={s.focusIndicator}
+			>
+				<div className={s.productWrapper}>
+					<div className={s.productLogo}>
+						<FlightIcon
+							name={PRODUCT_LOGO_MAP.get(product) ?? 'hashicorp-fill-color'}
+						/>
+					</div>
+					<div className={s.productTextContent}>
+						<span>{product}</span>
+						<span className={s.productDesc}>{description}</span>
+					</div>
+				</div>
+			</Link>
+		</NavigationMenu.Link>
+	)
+}
+
+export default ProductPanel

package/src/components/nav-panel/product-panel/style.module.css

@@ -0,0 +1,100 @@
+.productCategories {
+	list-style: none;
+	padding: 0;
+	display: grid;
+	margin: var(--hdsplus-spacing-06) 0 0;
+
+	@media (--large) {
+		margin: 0;
+	}
+}
+
+.productCategory {
+	display: flex;
+	flex-direction: column;
+	min-width: 160px;
+
+	&:first-child {
+		border-bottom: 1px solid var(--token-color-border-primary);
+		margin-bottom: var(--hdsplus-spacing-05);
+		padding-bottom: var(--hdsplus-spacing-05);
+	}
+}
+
+.eyebrow {
+	padding-bottom: var(--hdsplus-spacing-04);
+	color: var(--token-color-foreground-strong);
+	font-weight: var(--font-weight-semi-bold);
+
+	@media (--large) {
+		padding: 0 0 var(--hdsplus-spacing-01) var(--hdsplus-spacing-04);
+	}
+}
+
+.productList {
+	display: grid;
+	grid-template-columns: 1fr;
+	list-style: none;
+	margin: 0;
+	padding: 0;
+
+	@media (--large) {
+		grid-auto-flow: row;
+		grid-template-columns: repeat(2, 300px);
+		grid-template-rows: repeat(2, max-content);
+		gap: 0;
+	}
+}
+
+/* NavProduct styles */
+
+.productWrapper {
+	display: flex;
+	margin-bottom: var(--hdsplus-spacing-05);
+	gap: var(--hdsplus-spacing-05);
+
+	@media (--large) {
+		padding: var(--hdsplus-spacing-05);
+		margin-bottom: 0;
+
+		&:hover {
+			background-color: var(--token-color-surface-interactive-hover);
+			border-radius: var(--hdsplus-spacing-01);
+		}
+	}
+}
+
+.productLogo {
+	margin-top: 3px;
+
+	& svg {
+		height: 42px;
+		width: 42px;
+
+		@media (--large) {
+			height: var(--hdsplus-spacing-08);
+			width: var(--hdsplus-spacing-08);
+		}
+	}
+}
+
+.productTextContent {
+	display: flex;
+	flex-direction: column;
+	color: var(--token-color-foreground-strong);
+}
+
+.productDesc {
+	font-weight: 400;
+	font-size: 14px;
+	line-height: 20px;
+	letter-spacing: 0.0125em;
+	color: var(--token-color-foreground-faint);
+}
+
+.focusIndicator {
+	&:focus {
+		outline: 2px solid var(--token-color-focus-action-internal);
+		outline-style: auto;
+	}
+}

package/src/components/nav-panel/standard-panel/index.tsx

@@ -0,0 +1,44 @@
+import { trackNavClickEvent } from '../../../../../../apps/www/layouts/standard/nav'
+import * as NavPanel from '../components/panel'
+import LinkList, { type LinkListProps } from '../components/link-list'
+import Promo, { type PromoProps } from '../components/promo'
+import s from './style.module.css'
+
+export interface NavItem {
+	navItems: LinkListProps['links']
+}
+
+interface StandardPanelProps {
+	navData: NavItem[]
+	promo?: PromoProps
+	sectionName?: string
+}
+
+const StandardPanel = ({
+	navData,
+	promo,
+	sectionName = '',
+}: StandardPanelProps) => {
+	return (
+		<NavPanel.Root>
+			<div className={s.columns}>
+				{navData.map(({ navItems }, stableIdx) => {
+					return (
+						<NavPanel.Column key={stableIdx}>
+							<LinkList
+								links={navItems}
+								linkClickHandler={(text, href) => {
+									trackNavClickEvent(text, href, sectionName)
+								}}
+							/>
+						</NavPanel.Column>
+					)
+				})}
+			</div>
+
+			{promo ? <Promo {...promo} /> : null}
+		</NavPanel.Root>
+	)
+}
+
+export default StandardPanel

package/src/components/nav-panel/standard-panel/style.module.css

@@ -0,0 +1,11 @@
+.columns {
+	display: flex;
+	gap: var(--hdsplus-spacing-03);
+	flex-direction: column;
+	margin-top: var(--hdsplus-spacing-06);
+
+	@media (--large) {
+		flex-direction: row;
+		margin-top: 0;
+	}
+}

package/src/components/next-steps/index.tsx

@@ -0,0 +1,137 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+import { useState } from 'react'
+import Badge from '@hashicorp/react-badge'
+import classNames from 'classnames'
+import ExpandableArrow from '@hashicorp/react-expandable-arrow'
+import Intro from '../intro'
+import Link from 'next/link'
+import type { NextStepsProps } from './types'
+import StandaloneLink from '@hashicorp/react-design-system-components/src/components/standalone-link'
+import { IconArrowRight16 } from '@hashicorp/flight-icons/svg-react/arrow-right-16'
+import useProductMeta from '@hashicorp/platform-product-meta'
+import s from './style.module.css'
+
+export default function NextSteps({
+	appearance = 'light',
+	theme = 'hashicorp',
+	heading,
+	description,
+	steps,
+	cta,
+}: NextStepsProps) {
+	const { themeClass } = useProductMeta(theme)
+	return (
+		<section
+			className={classNames(s.nextSteps, s[appearance], themeClass)}
+			data-testid="next-steps"
+		>
+			<div className={s.container}>
+				<div className={s.content}>
+					<Intro
+						appearance={appearance}
+						heading={heading}
+						description={description}
+					/>
+				</div>
+				<div className={s.stepsWrapper}>
+					<ul className={s.stepsList}>
+						{steps.map((step, index) => {
+							const isFeatured = steps.length === 3 && index === 0
+							const variant = index === 0 ? 'primary' : 'secondary'
+							return (
+								<li
+									// eslint-disable-next-line react/no-array-index-key
+									key={index}
+									className={classNames(
+										s.stepsListItem,
+										isFeatured && s.stepsListItemFeature
+									)}
+								>
+									<Tile
+										badge={step.badge}
+										theme={theme}
+										variant={variant}
+										cta={{
+											title: step.cta.title,
+											url: step.cta.url,
+										}}
+										heading={step.heading}
+										description={step.description}
+									/>
+								</li>
+							)
+						})}
+					</ul>
+					{cta ? (
+						<div className={s.cta}>
+							<p className={s.ctaCopy}>{cta.copy}</p>
+							<StandaloneLink
+								href={cta.href}
+								text={cta.ctaText}
+								icon={
+									<IconArrowRight16
+										width="100%"
+										height="100%"
+										style={{ display: 'block' }}
+									/>
+								}
+								iconPosition="trailing"
+							/>
+						</div>
+					) : null}
+				</div>
+			</div>
+		</section>
+	)
+}
+
+function Tile({ theme, variant, heading, badge, description, cta }) {
+	const [isHovered, setIsHovered] = useState(false)
+	return (
+		<Link href={cta.url} legacyBehavior>
+			<a
+				className={classNames(s.tile, s[variant])}
+				onMouseOver={() => {
+					setIsHovered(true)
+				}}
+				onMouseOut={() => {
+					setIsHovered(false)
+				}}
+			>
+				<div className={s.tileInner}>
+					<h3 className={s.tileHeading}>
+						<span className={s.tileHeadingText}>{heading}</span>
+						{badge ? <BadgeWrapper theme={theme}>{badge}</BadgeWrapper> : null}
+					</h3>
+					{description ? (
+						<p className={s.tileDescription}>{description}</p>
+					) : null}
+					<span className={s.tileCta}>
+						<span className={s.tileCtaLabel}>{cta.title}</span>
+						<span className={s.tileCtaIcon}>
+							<ExpandableArrow expanded={isHovered} />
+						</span>
+					</span>
+				</div>
+				<span className={s.tileScrim} />
+			</a>
+		</Link>
+	)
+}
+
+const BadgeWrapper = ({ theme, children }) => {
+	const badgeTheme = theme === 'hashicorp' ? 'action' : theme
+	const page = theme === 'hashicorp' ? 'action' : 'actionFaint'
+
+	return (
+		<span className={s.tileBadge}>
+			<Badge theme={badgeTheme} page={page}>
+				{children}
+			</Badge>
+		</span>
+	)
+}