@hashicorp/react-components 0.0.0-nightly.4494e70 → 0.0.0-nightly.47d1fb8

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

@@ -1,31 +1,39 @@
 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 { vercelSplit } from '../../../../lib/v'
+import Link from 'next/link'
+import { getLocalizedLinkProps } from '../../../../lib/get-localized-link-props'
+import { trackNavClickEvent } from '../../../../lib/track-nav-click-event'
+import FlightIcon from '../flight-icon'
 import * as NavigationMenu from '@radix-ui/react-navigation-menu'
 import s from './style.module.css'
 
 export interface PromoProps {
+	locale?: string
 	title: string
+	titleLinkUrl?: string
 	description: string
 	linkUrl: string
 	linkTitle: string
 	slug?: string
 	icon?: string
 	theme: string
+	hasSidePanel?: boolean
+	isPromoOnTop?: boolean
 }
 
 export default function Promo({
+	locale,
 	title,
+	titleLinkUrl,
 	description,
 	linkUrl,
 	linkTitle,
 	slug,
 	icon,
 	theme,
+	hasSidePanel,
+	isPromoOnTop = false,
 }: PromoProps) {
 	const handleClick = useCallback((title, linkUrl, linkTitle, slug) => {
 		if (window && window.analytics) {
@@ -40,32 +48,51 @@ export default function Promo({
 	}, [])
 
 	return (
-		<div className={s.promo}>
+		<div
+			className={classNames(s.promo, {
+				[s.hasSide]: hasSidePanel,
+				[s.noSide]: !hasSidePanel,
+				[s.topPromo]: isPromoOnTop,
+			})}
+		>
 			{icon && (
 				<div
 					className={classNames(s.icon, {
-						[s.hashidays]: v(theme) === 'hashidays',
-						[s.hashiconf]: v(theme) === 'hashiconf',
+						[s.hashidays]: vercelSplit(theme) === 'hashidays',
+						[s.hashiconf]: vercelSplit(theme) === 'hashiconf',
 					})}
 				>
-					<FlightIcon name={v(icon)} />
+					<FlightIcon name={vercelSplit(icon)} />
 				</div>
 			)}
 			<div className={s.rightContent}>
 				<div>
-					<div
-						className={classNames(s.title, {
-							[s.hashidays]: v(theme) === 'hashidays',
-							[s.hashiconf]: v(theme) === 'hashiconf',
-						})}
-					>
-						{title}
-					</div>
+					{titleLinkUrl ? (
+						<a
+							className={classNames(s.title, s.link, {
+								[s.hashidays]: vercelSplit(theme) === 'hashidays',
+								[s.hashiconf]: vercelSplit(theme) === 'hashiconf',
+							})}
+							href={titleLinkUrl}
+						>
+							{title}
+						</a>
+					) : (
+						<div
+							className={classNames(s.title, {
+								[s.hashidays]: vercelSplit(theme) === 'hashidays',
+								[s.hashiconf]: vercelSplit(theme) === 'hashiconf',
+							})}
+						>
+							{title}
+						</div>
+					)}
 					<div className={s.description}>{description}</div>
 				</div>
 				<NavigationMenu.Link asChild>
 					<Link
-						href={parseUrl(linkUrl).href}
+						locale={locale ? locale : undefined}
+						{...getLocalizedLinkProps(linkUrl, locale)}
 						className={s.link}
 						onClickCapture={() => handleClick(title, linkUrl, linkTitle, slug)}
 					>

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

@@ -1,61 +1,97 @@
+@custom-media --dev-dot-viewport (min-width: 924px);
+
 .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);
+	border-radius: var(--mds-spacing-01);
+	border: 1px solid var(--mds-color-border-faint);
+	background-color: var(--mds-color-surface-faint);
+	padding: var(--mds-spacing-05) var(--mds-spacing-08) var(--mds-spacing-06)
+		var(--mds-spacing-08);
 	flex-direction: row;
-	gap: var(--hdsplus-spacing-04);
-	margin: var(--hdsplus-spacing-05);
+	gap: var(--mds-spacing-04);
+	margin: var(--mds-spacing-07);
+	margin-bottom: var(--mds-spacing-09);
 
 	@media (--large) {
-		margin: 0;
-		width: min-content;
-		min-width: 100%;
+		&.topPromo {
+			margin-bottom: var(--mds-spacing-05);
+		}
+		&.noSide {
+			margin: 0;
+			width: min-content;
+			min-width: 100%;
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		&.topPromo {
+			margin-bottom: var(--mds-spacing-05);
+		}
+		&.hasSide {
+			&.topPromo {
+				margin-bottom: var(--mds-spacing-05);
+			}
+
+			margin: 0;
+			width: min-content;
+			min-width: 100%;
+		}
 	}
 }
 
+.topPromo {
+	margin-bottom: 0;
+}
+
 .rightContent {
 	display: flex;
 	flex-wrap: wrap;
-	gap: var(--hdsplus-spacing-03);
+	gap: var(--mds-spacing-03);
 	width: 100%;
 	justify-content: space-between;
 }
 
 .title {
-	font-weight: var(--font-weight-semi-bold);
+	font-weight: var(--mds-typography-font-weight-semibold);
 }
 
 .description {
-	font-size: var(--hdsplus-typography-body-200-font-size);
-	font-weight: var(--token-typography-font-weight-regular);
-	margin-top: var(--hdsplus-spacing-01);
+	font-size: var(--mds-typography-body-200-font-size);
+	font-weight: var(--mds-typography-font-weight-regular);
+	margin-top: var(--mds-spacing-01);
 }
 
 .icon {
 	display: none;
 
 	@media (--large) {
-		display: block;
-		margin-top: 3px;
+		@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);
+	color: var(--mds-color-foreground-strong);
 	display: flex;
 	flex-direction: row;
 	align-items: center;
-	gap: var(--hdsplus-spacing-02);
+	gap: var(--mds-spacing-02);
 
 	&:hover {
 		text-decoration: underline;
 	}
 
 	&:focus {
-		outline: 2px solid var(--token-color-focus-action-internal);
+		outline: 2px solid var(--mds-color-focus-action-internal);
 		outline-style: auto;
 	}
 }
@@ -79,14 +115,14 @@
 .hashiconf {
 	background: linear-gradient(
 		to right,
-		var(--token-color-terraform-foreground),
-		var(--token-color-vagrant-foreground)
+		var(--mds-color-terraform-foreground),
+		var(--mds-color-vagrant-foreground)
 	);
 	-webkit-background-clip: text;
 	-webkit-text-fill-color: transparent;
 	max-width: fit-content;
 
 	& svg {
-		color: var(--token-color-terraform-foreground);
+		color: var(--mds-color-terraform-foreground);
 	}
 }

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

@@ -0,0 +1,34 @@
+import classNames from 'classnames'
+import { type ReactNode, type HTMLAttributes } from 'react'
+
+type TextSize = '200' | '300' | '400'
+type TextWeight = 'regular' | 'medium' | 'semibold' | 'bold'
+
+interface TextProps extends HTMLAttributes<HTMLSpanElement> {
+	size?: TextSize
+	weight?: TextWeight
+	children: ReactNode
+}
+
+const Text = ({
+	size = '300',
+	weight,
+	children,
+	className,
+	...rest
+}: TextProps) => {
+	return (
+		<span
+			className={classNames(
+				`mds-typography-body-${size}`,
+				weight && `mds-typography-font-weight-${weight}`,
+				className
+			)}
+			{...rest}
+		>
+			{children}
+		</span>
+	)
+}
+
+export { Text }

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

@@ -1,16 +1,19 @@
+import classNames from 'classnames'
 import Link from 'next/link'
 import * as NavPanel from '../components/panel'
 import Promo, { type PromoProps } from '../components/promo'
+import { getLocalizedLinkProps } from '../../../lib/get-localized-link-props'
 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 FlightIcon from '../components/flight-icon'
+import { Text } from '../components/text'
+import { trackNavClickEvent } from '../../../lib/track-nav-click-event'
 import * as NavigationMenu from '@radix-ui/react-navigation-menu'
+import { LinkListProps } from '../components/link-list'
+import NavLink from '../components/link'
 import s from './style.module.css'
 
 const PRODUCT_LOGO_MAP = new Map([
-	['Terraform', 'terraform-fill-color'],
+	['Terraform', 'terraform-fill'],
 	['Packer', 'packer-fill-color'],
 	['Vault', 'vault-fill-color'],
 	['Boundary', 'boundary-fill-color'],
@@ -18,52 +21,158 @@ const PRODUCT_LOGO_MAP = new Map([
 	['Nomad', 'nomad-fill-color'],
 	['Waypoint', 'waypoint-fill-color'],
 	['Vagrant', 'vagrant-fill-color'],
+	['HCP Vault Secrets', 'vault-secrets'],
+	['HCP Vault Radar', 'vault-radar'],
 ])
 
-interface ProductsPanelProps {
-	productCategories: any
+const PRODUCT_LOGO_EXCEPTION_CLASSNAMES = {
+	Terraform: 'terraform',
+	'HCP Vault Secrets': 'hcpVaultSecrets',
+	'HCP Vault Radar': 'hcpVaultRadar',
+}
+
+export type ProductCategoriesProps = Array<{
+	title: string
+	group?: LinkListProps['links'][0]
+	products: NavProductProps[]
+}>
+
+export interface ProductsPanelProps {
+	locale?: string
+	productCategories: ProductCategoriesProps
 	promo?: PromoProps
+	sidePanel?: {
+		label: string
+		navItems: {
+			icon: string
+			title: string
+			description: string
+			url: string
+		}[]
+	}
+	isPromoOnTop?: boolean
 }
 
-const ProductPanel = ({ productCategories, promo }: ProductsPanelProps) => {
+const ProductPanel = ({
+	locale,
+	productCategories,
+	promo,
+	sidePanel,
+	isPromoOnTop = false,
+}: 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>
-										)
+		<NavPanel.Root
+			className={classNames(s.productPanel, {
+				[s.hasSide]: sidePanel,
+				[s.noSide]: !sidePanel,
+				[s.topPromo]: isPromoOnTop,
+			})}
+			hasSidePanel={Boolean(sidePanel)}
+		>
+			<div className={s.mainPanel}>
+				{promo && isPromoOnTop ? (
+					<Promo
+						{...promo}
+						hasSidePanel={Boolean(sidePanel)}
+						isPromoOnTop={isPromoOnTop}
+					/>
+				) : null}
+				<NavPanel.Column hasSidePanel={Boolean(sidePanel)}>
+					<ul className={s.productCategories}>
+						{productCategories.map(({ group, title, products }) => {
+							return (
+								<li
+									key={title}
+									className={classNames(s.productCategory, {
+										[s.productCategoryHasGroup]: group,
 									})}
-								</ul>
-							</li>
-						)
-					})}
-				</ul>
-			</NavPanel.Column>
-			{promo ? <Promo {...promo} /> : null}
+								>
+									{group ? (
+										<NavLink {...group} className={s.productGroupLink} />
+									) : (
+										<Text className={s.eyebrow}>{title}</Text>
+									)}
+									<ul className={s.productList}>
+										{products.map((product) => {
+											return (
+												<li key={product.url}>
+													<NavProduct locale={locale} {...product} />
+												</li>
+											)
+										})}
+									</ul>
+								</li>
+							)
+						})}
+					</ul>
+				</NavPanel.Column>
+				{promo && !isPromoOnTop ? (
+					<Promo {...promo} hasSidePanel={Boolean(sidePanel)} />
+				) : null}
+			</div>
+
+			{sidePanel ? (
+				<NavPanel.Column className={s.sidePanel}>
+					<Text size="200" weight="semibold" className={s.sidePanelText}>
+						{sidePanel.label}
+					</Text>
+
+					{/* ! 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
+										aria-label={`${title} - ${description}`}
+										{...getLocalizedLinkProps(url, locale)}
+										locale={locale ? locale : undefined}
+										className={classNames(s.sidePanelItem, s.focusIndicator)}
+									>
+										<div className={s.iconBackground}>
+											<FlightIcon
+												name={icon}
+												color="var(--mds-color-foreground-faint)"
+											/>
+										</div>
+										<div className={s.sidePanelItemContent}>
+											<Text
+												size="200"
+												weight="semibold"
+												className={s.sidePanelText}
+											>
+												{title}
+											</Text>
+											<span className={s.sidePanelItemDesc}>{description}</span>
+										</div>
+									</Link>
+								</li>
+							)
+						})}
+					</ul>
+				</NavPanel.Column>
+			) : null}
 		</NavPanel.Root>
 	)
 }
 
 export interface NavProductProps {
+	locale?: string
 	url: string
 	product: Products | string
 	description: string
 }
 
-function NavProduct({ url, product, description }: NavProductProps) {
+function NavProduct({ locale, url, product, description }: NavProductProps) {
 	return (
 		<NavigationMenu.Link asChild>
 			<Link
-				href={parseUrl(url).href}
+				aria-label={`${product} - ${description}`}
+				{...getLocalizedLinkProps(url, locale)}
+				locale={locale ? locale : undefined}
 				onClickCapture={() => {
 					trackNavClickEvent(product, url, 'products')
 				}}
@@ -73,6 +182,11 @@ function NavProduct({ url, product, description }: NavProductProps) {
 					<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}>