@hashicorp/react-components 0.0.0-canary.06ed51b

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

@@ -0,0 +1,24 @@
+import classNames from 'classnames'
+import s from './style.module.css'
+
+export interface NavColumnProps {
+	className?: string
+	children: React.ReactNode
+	hasSidePanel?: boolean
+}
+
+export default function Column({
+	className,
+	children,
+	hasSidePanel,
+}: NavColumnProps) {
+	return (
+		<div
+			className={classNames(s.column, className, {
+				[s.hasSide]: hasSidePanel,
+			})}
+		>
+			{children}
+		</div>
+	)
+}

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

@@ -0,0 +1,24 @@
+@custom-media --dev-dot-viewport (min-width: 1210px);
+
+.column {
+	position: relative;
+	display: flex;
+	flex-direction: column;
+	justify-content: flex-start;
+	min-width: 190px;
+	padding: 0;
+	margin: 0 var(--hdsplus-spacing-05);
+	border-radius: var(--hdsplus-spacing-03);
+
+	@media (--large) {
+		&:not(.hasSide) {
+			margin: 0;
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		&.hasSide {
+			margin: 0;
+		}
+	}
+}

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

@@ -0,0 +1,4 @@
+import Root from './root'
+import Column from './column'
+
+export { Root, Column }

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

@@ -0,0 +1,20 @@
+import classNames from 'classnames'
+import s from './style.module.css'
+
+interface RootProps {
+	className?: string
+	children: React.ReactNode
+	hasSidePanel?: boolean
+}
+
+export default function Root({ className, children, hasSidePanel }: RootProps) {
+	return (
+		<div
+			className={classNames(s.root, className, {
+				[s.hasSide]: hasSidePanel,
+			})}
+		>
+			{children}
+		</div>
+	)
+}

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

@@ -0,0 +1,30 @@
+@custom-media --dev-dot-viewport (min-width: 1210px);
+
+.root {
+	width: 100%;
+	display: flex;
+	flex-direction: column;
+	justify-content: space-between;
+	/* stylelint-disable-next-line unit-no-unknown */
+	min-height: calc(100dvh - var(--hdsplus-spacing-12));
+
+	@media (--large) {
+		&:not(.hasSide) {
+			justify-content: flex-start;
+			height: 100%;
+			min-height: fit-content;
+			padding: var(--hdsplus-spacing-05) var(--hdsplus-spacing-04);
+			gap: var(--hdsplus-spacing-04);
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		&.hasSide {
+			justify-content: flex-start;
+			height: 100%;
+			min-height: fit-content;
+			padding: var(--hdsplus-spacing-05) var(--hdsplus-spacing-04);
+			gap: var(--hdsplus-spacing-04);
+		}
+	}
+}

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

@@ -0,0 +1,86 @@
+import { useCallback } from 'react'
+import classNames from 'classnames'
+import { v } from '../../../../lib/v'
+import Link from 'next/link'
+import { parseUrl } from '../../../../lib/parse-url'
+import { trackNavClickEvent } from '../../../../lib/track-nav-click-event'
+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
+	hasSidePanel?: boolean
+}
+
+export default function Promo({
+	title,
+	description,
+	linkUrl,
+	linkTitle,
+	slug,
+	icon,
+	theme,
+	hasSidePanel,
+}: 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={classNames(s.promo, {
+				[s.hasSide]: hasSidePanel,
+				[s.noSide]: !hasSidePanel,
+			})}
+		>
+			{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,113 @@
+@custom-media --dev-dot-viewport (min-width: 1210px);
+
+.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) {
+		&.noSide {
+			margin: 0;
+			width: min-content;
+			min-width: 100%;
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		&.hasSide {
+			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) {
+		@nest .noSide & {
+			display: block;
+			margin-top: 3px;
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		@nest .hasSide & {
+			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,170 @@
+import { CSSProperties } from 'react'
+import classNames from 'classnames'
+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 '../../../lib/parse-url'
+import { trackNavClickEvent } from '../../../lib/track-nav-click-event'
+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'],
+	['HCP Vault Secrets', 'vault-secrets'],
+	['HCP Vault Radar', 'vault-radar'],
+])
+
+const PRODUCT_LOGO_EXCEPTION_CLASSNAMES = {
+	'HCP Vault Secrets': 'hcpVaultSecrets',
+	'HCP Vault Radar': 'hcpVaultRadar',
+}
+
+export interface ProductsPanelProps {
+	productCategories: any
+	promo?: PromoProps
+	sidePanel?: {
+		label: string
+		navItems: {
+			icon: string
+			title: string
+			description: string
+			url: string
+		}[]
+	}
+}
+
+const ProductPanel = ({
+	productCategories,
+	promo,
+	sidePanel,
+}: ProductsPanelProps) => {
+	return (
+		<NavPanel.Root
+			className={classNames(s.productPanel, {
+				[s.hasSide]: sidePanel,
+				[s.noSide]: !sidePanel,
+			})}
+			hasSidePanel={Boolean(sidePanel)}
+		>
+			<div className={s.mainPanel}>
+				<NavPanel.Column hasSidePanel={Boolean(sidePanel)}>
+					<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}
+										// Dynamically calculate row count based on number of items divided by expected columns
+										style={
+											{
+												'--row-count-above-mobile': Math.ceil(
+													products.length / 2
+												),
+											} as CSSProperties
+										}
+									>
+										{products.map((product) => {
+											return (
+												<li key={product.url}>
+													<NavProduct {...product} />
+												</li>
+											)
+										})}
+									</ul>
+								</li>
+							)
+						})}
+					</ul>
+				</NavPanel.Column>
+				{promo ? <Promo {...promo} hasSidePanel={Boolean(sidePanel)} /> : null}
+			</div>
+
+			{sidePanel ? (
+				<NavPanel.Column className={s.sidePanel}>
+					<TextPlus.Body size="200" weight="semibold">
+						{sidePanel.label}
+					</TextPlus.Body>
+
+					{/* ! TODO Replace the below list with the <LinkList /> component, 
+						That component will require a refactor to support greater customization 
+						Ticket:
+						https://app.asana.com/0/1206176289707208/1208162145034615/f
+						*/}
+					<ul className={s.sidePanelItems}>
+						{sidePanel.navItems.map(({ icon, title, description, url }) => {
+							return (
+								<li key={title}>
+									<Link href={parseUrl(url).href} className={s.sidePanelItem}>
+										<div className={s.iconBackground}>
+											<FlightIcon
+												size={16}
+												name={icon}
+												color="var(--token-color-foreground-faint)"
+											/>
+										</div>
+										<div className={s.sidePanelItemContent}>
+											<TextPlus.Body size="200" weight="semibold" tag="span">
+												{title}
+											</TextPlus.Body>
+											<span className={s.sidePanelItemDesc}>{description}</span>
+										</div>
+									</Link>
+								</li>
+							)
+						})}
+					</ul>
+				</NavPanel.Column>
+			) : 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'}
+							className={
+								PRODUCT_LOGO_EXCEPTION_CLASSNAMES[product]
+									? s[PRODUCT_LOGO_EXCEPTION_CLASSNAMES[product]]
+									: undefined
+							}
+						/>
+					</div>
+					<div className={s.productTextContent}>
+						<span>{product}</span>
+						<span className={s.productDesc}>{description}</span>
+					</div>
+				</div>
+			</Link>
+		</NavigationMenu.Link>
+	)
+}
+
+export default ProductPanel