@hashicorp/react-components 0.0.0-nightly.976e6ae → 0.0.0-nightly.97eb452

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

@@ -1,10 +1,10 @@
 import { useCallback } from 'react'
 import classNames from 'classnames'
-import { v } from '../../../../lib/v'
+import { vercelSplit } 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 FlightIcon from '@hashicorp/react-hds/src/components/flight-icon'
 import * as NavigationMenu from '@radix-ui/react-navigation-menu'
 import s from './style.module.css'
 
@@ -16,6 +16,7 @@ export interface PromoProps {
 	slug?: string
 	icon?: string
 	theme: string
+	hasSidePanel?: boolean
 }
 
 export default function Promo({
@@ -26,6 +27,7 @@ export default function Promo({
 	slug,
 	icon,
 	theme,
+	hasSidePanel,
 }: PromoProps) {
 	const handleClick = useCallback((title, linkUrl, linkTitle, slug) => {
 		if (window && window.analytics) {
@@ -40,23 +42,28 @@ export default function Promo({
 	}, [])
 
 	return (
-		<div className={s.promo}>
+		<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',
+						[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',
+							[s.hashidays]: vercelSplit(theme) === 'hashidays',
+							[s.hashiconf]: vercelSplit(theme) === 'hashiconf',
 						})}
 					>
 						{title}

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

@@ -1,3 +1,5 @@
+@custom-media --dev-dot-viewport (min-width: 924px);
+
 .promo {
 	display: flex;
 	border-radius: var(--hdsplus-spacing-01);
@@ -7,12 +9,23 @@
 		var(--hdsplus-spacing-06) var(--hdsplus-spacing-08);
 	flex-direction: row;
 	gap: var(--hdsplus-spacing-04);
-	margin: var(--hdsplus-spacing-05);
+	margin: var(--hdsplus-spacing-07);
+	margin-bottom: var(--hdsplus-spacing-09);
 
 	@media (--large) {
-		margin: 0;
-		width: min-content;
-		min-width: 100%;
+		&.noSide {
+			margin: 0;
+			width: min-content;
+			min-width: 100%;
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		&.hasSide {
+			margin: 0;
+			width: min-content;
+			min-width: 100%;
+		}
 	}
 }
 
@@ -38,8 +51,17 @@
 	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;
+		}
 	}
 }
 

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

@@ -1,16 +1,17 @@
+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 FlightIcon from '@hashicorp/react-hds/src/components/flight-icon'
+import { TextPlus } from '@hashicorp/react-hds/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'],
+	['Terraform', 'terraform-fill'],
 	['Packer', 'packer-fill-color'],
 	['Vault', 'vault-fill-color'],
 	['Boundary', 'boundary-fill-color'],
@@ -18,37 +19,107 @@ 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 {
+const PRODUCT_LOGO_EXCEPTION_CLASSNAMES = {
+	Terraform: 'terraform',
+	'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 }: ProductsPanelProps) => {
+const ProductPanel = ({
+	productCategories,
+	promo,
+	sidePanel,
+}: 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
+			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}>
+										{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
+										aria-label={`${title} - ${description}`}
+										href={parseUrl(url).href}
+										className={classNames(s.sidePanelItem, s.focusIndicator)}
+									>
+										<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>
 	)
 }
@@ -63,6 +134,7 @@ function NavProduct({ url, product, description }: NavProductProps) {
 	return (
 		<NavigationMenu.Link asChild>
 			<Link
+				aria-label={`${product} - ${description}`}
 				href={parseUrl(url).href}
 				onClickCapture={() => {
 					trackNavClickEvent(product, url, 'products')
@@ -73,6 +145,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}>

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

@@ -1,11 +1,43 @@
+@custom-media --dev-dot-viewport (min-width: 924px);
+
+.productPanel {
+	height: 100%;
+
+	@media (--large) {
+		&.noSide {
+			display: grid;
+			grid-template-rows: 1fr;
+			grid-template-columns: max-content max-content;
+			padding: 0;
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		&.hasSide {
+			display: grid;
+			grid-template-rows: 1fr;
+			grid-template-columns: max-content max-content;
+			padding: 0;
+		}
+	}
+}
+
 .productCategories {
 	list-style: none;
 	padding: 0;
 	display: grid;
-	margin: var(--hdsplus-spacing-06) 0 0;
+	margin: var(--hdsplus-spacing-07) 0 0;
 
 	@media (--large) {
-		margin: 0;
+		@nest .noSide & {
+			margin: 0;
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		@nest .hasSide & {
+			margin: 0;
+		}
 	}
 }
 
@@ -27,7 +59,17 @@
 	font-weight: var(--font-weight-semi-bold);
 
 	@media (--large) {
-		padding: 0 0 var(--hdsplus-spacing-01) var(--hdsplus-spacing-04);
+		@nest .noSide & {
+			padding-bottom: 0;
+			padding-left: var(--hdsplus-spacing-06);
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		@nest .hasSide & {
+			padding-bottom: 0;
+			padding-left: var(--hdsplus-spacing-06);
+		}
 	}
 }
 
@@ -39,10 +81,31 @@
 	padding: 0;
 
 	@media (--large) {
-		grid-auto-flow: row;
-		grid-template-columns: repeat(2, 300px);
-		grid-template-rows: repeat(2, max-content);
-		gap: 0;
+		@nest .noSide & {
+			padding: var(--hdsplus-spacing-06) var(--hdsplus-spacing-05)
+				var(--hdsplus-spacing-04);
+			grid-auto-flow: row;
+			grid-template-columns: repeat(2, 300px);
+			grid-template-rows: repeat(2, max-content);
+			gap: 0;
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		@nest .hasSide & {
+			padding: var(--hdsplus-spacing-06) var(--hdsplus-spacing-05)
+				var(--hdsplus-spacing-04);
+			grid-auto-flow: row;
+			grid-template-columns: repeat(2, 300px);
+			grid-template-rows: repeat(2, max-content);
+			gap: 0;
+		}
+	}
+
+	& li:last-child {
+		& .productWrapper {
+			margin-bottom: 0;
+		}
 	}
 }
 
@@ -54,12 +117,26 @@
 	gap: var(--hdsplus-spacing-05);
 
 	@media (--large) {
-		padding: var(--hdsplus-spacing-05);
-		margin-bottom: 0;
+		@nest .noSide & {
+			padding: var(--hdsplus-spacing-03) var(--hdsplus-spacing-05);
+			margin-bottom: 0;
 
-		&:hover {
-			background-color: var(--token-color-surface-interactive-hover);
-			border-radius: var(--hdsplus-spacing-01);
+			&:hover {
+				background-color: var(--token-color-surface-interactive-hover);
+				border-radius: var(--hdsplus-spacing-01);
+			}
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		@nest .hasSide & {
+			padding: var(--hdsplus-spacing-03) var(--hdsplus-spacing-05);
+			margin-bottom: 0;
+
+			&:hover {
+				background-color: var(--token-color-surface-interactive-hover);
+				border-radius: var(--hdsplus-spacing-01);
+			}
 		}
 	}
 }
@@ -70,10 +147,23 @@
 	& svg {
 		height: 42px;
 		width: 42px;
+	}
+
+	@nest .noSide & {
+		& svg {
+			@media (--large) {
+				height: var(--hdsplus-spacing-08);
+				width: var(--hdsplus-spacing-08);
+			}
+		}
+	}
 
-		@media (--large) {
-			height: var(--hdsplus-spacing-08);
-			width: var(--hdsplus-spacing-08);
+	@nest .hasSide & {
+		& svg {
+			@media (--dev-dot-viewport) {
+				height: var(--hdsplus-spacing-08);
+				width: var(--hdsplus-spacing-08);
+			}
 		}
 	}
 }
@@ -98,3 +188,128 @@
 		outline-style: auto;
 	}
 }
+
+.mainPanel {
+	height: 100%;
+	display: flex;
+	justify-content: space-between;
+	flex-direction: column;
+
+	@media (--large) {
+		@nest .noSide & {
+			padding: var(--hdsplus-spacing-07) 0 var(--hdsplus-spacing-09)
+				var(--hdsplus-spacing-04);
+		}
+	}
+
+	@media (--dev-dot-viewport) {
+		@nest .hasSide & {
+			padding: var(--hdsplus-spacing-07) 0 var(--hdsplus-spacing-09)
+				var(--hdsplus-spacing-04);
+		}
+	}
+}
+
+.sidePanel {
+	height: 100%;
+	background: var(--token-color-surface-faint);
+	display: flex;
+	flex-direction: column;
+	gap: var(--hdsplus-spacing-05);
+	margin: 0;
+	padding: var(--hdsplus-spacing-07) var(--hdsplus-spacing-04)
+		var(--hdsplus-spacing-09) var(--hdsplus-spacing-07);
+}
+
+.sidePanelItems {
+	list-style: none;
+	margin: 0;
+	padding: 0;
+	display: grid;
+	grid-template-columns: 1fr;
+	gap: var(--hdsplus-spacing-07);
+
+	@media (--dev-dot-viewport) {
+		gap: var(--hdsplus-spacing-05);
+	}
+}
+
+/* Lifted from .productWrapper */
+.sidePanelItem {
+	display: flex;
+	gap: var(--hdsplus-spacing-05);
+
+	@media (--dev-dot-viewport) {
+		padding: var(--hdsplus-spacing-03) var(--hdsplus-spacing-05);
+
+		&:hover {
+			background-color: var(--token-color-surface-interactive-hover);
+			border-radius: var(--hdsplus-spacing-01);
+		}
+	}
+}
+
+/* Lifted from:
+packages/react-components/src/components/nav-panel/components/link-list/style.module.css  */
+.iconBackground {
+	background: var(--token-color-foreground-high-contrast);
+	height: var(--hdsplus-spacing-08);
+	width: var(--hdsplus-spacing-08);
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	border-radius: 3px;
+	flex: none;
+	margin-top: 3px;
+	border: 1px solid var(--token-color-border-primary);
+}
+
+/* Lifted from .productTextContent */
+.sidePanelItemContent {
+	display: flex;
+	flex-direction: column;
+	color: var(--token-color-foreground-strong);
+}
+
+.sidePanelItemDesc {
+	font-weight: 400;
+	font-size: 13px;
+	line-height: 18px;
+	color: var(--token-color-foreground-primary);
+}
+
+/* Branding exception classnames */
+
+/* Allows switching to a dark-mode-specific color for Terraform */
+.terraform {
+	& use {
+		fill: var(--token-color-terraform-brand);
+
+		@nest [data-theme='dark'] & {
+			fill: var(--token-color-terraform-foreground);
+		}
+	}
+
+	& path {
+		fill: inherit;
+	}
+}
+
+/* Styles for HCP Vault mimic the spec for `product-square` icons,
+	while allowing the symbol inside the icon border to change color
+	based on the site's theme
+*/
+.hcpVaultSecrets,
+.hcpVaultRadar {
+	padding: var(--hdsplus-spacing-01);
+	border: 2px solid var(--token-color-vault-brand);
+	border-radius: 3px;
+
+	& use {
+		fill: var(--token-color-foreground-strong);
+	}
+
+	& path {
+		fill: inherit;
+	}
+}

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

@@ -2,7 +2,7 @@
 	display: flex;
 	gap: var(--hdsplus-spacing-03);
 	flex-direction: column;
-	margin-top: var(--hdsplus-spacing-06);
+	margin-top: var(--hdsplus-spacing-07);
 
 	@media (--large) {
 		flex-direction: row;

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

@@ -2,6 +2,7 @@
  * Copyright (c) HashiCorp, Inc.
  * SPDX-License-Identifier: MPL-2.0
  */
+'use client'
 
 import { useState } from 'react'
 import Badge from '@hashicorp/react-badge'
@@ -10,7 +11,7 @@ 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 { HDSPlusStandaloneLink } from '@hashicorp/react-mds/src/hds-plus/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'
@@ -69,7 +70,7 @@ export default function NextSteps({
 					{cta ? (
 						<div className={s.cta}>
 							<p className={s.ctaCopy}>{cta.copy}</p>
-							<StandaloneLink
+							<HDSPlusStandaloneLink
 								href={cta.href}
 								text={cta.ctaText}
 								icon={

package/src/components/product-badge/index.tsx

@@ -4,7 +4,7 @@
  */
 
 import type { Products } from '@hashicorp/platform-product-meta'
-import Badge from '@hashicorp/react-design-system-components/src/components/badge'
+import Badge from '@hashicorp/react-hds/src/components/badge'
 import { IconDot16 } from '@hashicorp/flight-icons/svg-react/dot-16'
 import s from './style.module.css'
 

package/src/components/subnav/index.tsx

@@ -17,7 +17,6 @@ import CtaLinks, { type CtaLinkProps } from './partials/CtaLinks'
 import traverse, { isObject } from './helpers/traverse'
 import { areBasePathsMatching } from './helpers/areBasePathsMatching'
 import * as NavigationMenu from '@radix-ui/react-navigation-menu'
-import themeStyles from './theme.module.css'
 import s from './style.module.css'
 
 const productAllowList = {
@@ -165,6 +164,10 @@ function Subnav({ className, theme = 'light', ...restProps }: SubnavProps) {
 		setActivePanel(panel)
 	}
 
+	const ariaLabel = restProps?.titleLink?.text
+		? `${restProps.titleLink.text} pages`
+		: 'Subnav pages'
+
 	return (
 		<>
 			{/**
@@ -175,11 +178,12 @@ function Subnav({ className, theme = 'light', ...restProps }: SubnavProps) {
 			<style>{`:root{--subnav-height:${height}px}`}</style>
 			<NavigationMenu.Root
 				ref={wrapperRef}
-				className={classNames(s.root, themeStyles[theme], className, {
+				className={classNames(s.root, className, {
 					[s.isSticky]: isSticky,
 					[s.hasOverflow]: hasOverflow,
+					'hdsplus-dark-mode': theme === 'dark',
 				})}
-				aria-label={`${product} website navigation`}
+				aria-label={ariaLabel}
 				onValueChange={activatePanel}
 				value={activePanel}
 				delayDuration={0}

package/src/components/subnav/partials/CtaLinks/github-stars-link/style.module.css

@@ -3,15 +3,13 @@
  * SPDX-License-Identifier: MPL-2.0
  */
 
-/* Note: consumes from theme.module.css, as marked */
-
 .root {
-	--local-scrim-color: transparent;
-	--local-divider-color: var(--border-color); /* from theme.module.css */
+	--local-scrim-opacity: 0;
+	--local-divider-color: var(--token-color-border-primary);
 
 	position: relative;
-	color: var(--gh-stars-icon-color); /* from theme.module.css */
-	border: 1px solid var(--local-divider-color); /* from theme.module.css */
+	color: var(--token-color-foreground-primary);
+	border: 1px solid var(--local-divider-color);
 	border-radius: 5px;
 	background: none;
 	transition: background 0.2s, border-color 0.2s;
@@ -27,17 +25,15 @@
 		right: -1px;
 		bottom: -1px;
 		border-radius: 5px;
-		transition: background 0.25s ease;
+		transition: opacity 0.25s ease;
+		opacity: var(--local-scrim-opacity);
 		z-index: 0;
-		background-color: var(--local-scrim-color);
+		background-color: var(--token-color-foreground-primary);
 	}
 
 	&:hover,
 	&:active {
-		--local-divider-color: transparent;
-		--local-scrim-color: var(
-			--gh-stars-scrim-color
-		); /* from theme.module.css */
+		--local-scrim-opacity: 0.12;
 	}
 }