@hashicorp/react-components 0.0.0-nightly.e8ac55b → 0.0.0-nightly.f3bf415

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hashicorp/react-components",
-	"version": "0.0.0-nightly.e8ac55b",
+	"version": "0.0.0-nightly.f3bf415",
 	"main": "src/index.ts",
 	"scripts": {
 		"lint": "next-hashicorp lint",

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

@@ -0,0 +1,88 @@
+import Link from 'next/link'
+import { parseUrl } from '../../../../../../../apps/www/lib/parseUrl'
+import { v } from '@web/cms'
+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 LinkListProps {
+	links: {
+		title: string
+		url: string
+		icon?: string
+		description?: string
+		iconGradient?: string
+	}[]
+	linkClickHandler?: (title: string, url: string) => void
+}
+
+const GRADIENT_VALUE_MAP = new Map([
+	[
+		'ILM',
+		{
+			iconGradient: 'var(--icon-gradient-infrastructure-lifecycle-management)',
+		},
+	],
+	[
+		'SLM',
+		{
+			iconGradient: 'var(--icon-gradient-security-lifecycle-management)',
+		},
+	],
+	[
+		'Cloud',
+		{
+			iconGradient: 'var(--icon-gradient-infrastructure-cloud)',
+		},
+	],
+])
+
+export default function LinkList({ links, linkClickHandler }: LinkListProps) {
+	return (
+		<ul className={s.linkList}>
+			{links.map((link) => {
+				let style
+				link.iconGradient
+					? (style = {
+							'--iconGradient': GRADIENT_VALUE_MAP.get(v(link.iconGradient))
+								?.iconGradient,
+					  } as React.CSSProperties)
+					: (style = null)
+				return (
+					<li key={link.title}>
+						<NavigationMenu.Link asChild>
+							<Link
+								className={s.link}
+								href={parseUrl(link.url).href}
+								onClickCapture={() => {
+									linkClickHandler && linkClickHandler(link.title, link.url)
+								}}
+							>
+								{link.iconGradient && link.icon ? (
+									<div className={s.iconBackground} style={style}>
+										<FlightIcon name={v(link.icon)} />
+									</div>
+								) : (
+									link.icon && (
+										<FlightIcon
+											name={v(link.icon)}
+											color="var(--token-color-foreground-faint)"
+										/>
+									)
+								)}
+								<div>
+									<div className={link.iconGradient && s.boldTitle}>
+										{link.title}
+									</div>
+									{link.description && (
+										<div className={s.description}>{link.description}</div>
+									)}
+								</div>
+							</Link>
+						</NavigationMenu.Link>
+					</li>
+				)
+			})}
+		</ul>
+	)
+}

package/src/components/nav-panel/components/link-list/style.module.css

@@ -0,0 +1,57 @@
+.linkList {
+	display: flex;
+	list-style: none;
+	flex-direction: column;
+	gap: var(--hdsplus-spacing-03);
+	margin: 0;
+	padding: 0;
+}
+
+.link {
+	color: var(--token-color-foreground-primary);
+	display: flex;
+	gap: var(--hdsplus-spacing-04);
+	padding: var(--hdsplus-spacing-03) var(--hdsplus-spacing-04);
+	min-width: 190px;
+	align-items: center;
+
+	&:hover {
+		background-color: var(--token-color-surface-interactive-hover);
+		border-radius: var(--hdsplus-spacing-01);
+	}
+
+	&:has(.iconBackground) {
+		align-items: flex-start;
+	}
+
+	@media (--large) {
+		max-width: 416px;
+	}
+
+	&:focus {
+		outline: 2px solid var(--token-color-focus-action-internal);
+		outline-style: auto;
+	}
+}
+
+.description {
+	font-size: var(--hdsplus-typography-body-200-font-size);
+	font-weight: var(--token-typography-font-weight-regular);
+	margin-top: var(--hdsplus-spacing-02);
+}
+
+.iconBackground {
+	background: var(--iconGradient);
+	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;
+}
+
+.boldTitle {
+	font-weight: var(--font-weight-semi-bold);
+}

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

@@ -0,0 +1,9 @@
+import s from './style.module.css'
+
+export interface NavColumnProps {
+	children: React.ReactNode
+}
+
+export default function Column({ children }: NavColumnProps) {
+	return <div className={s.column}>{children}</div>
+}

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

@@ -0,0 +1,14 @@
+.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) {
+		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,9 @@
+import s from './style.module.css'
+
+interface RootProps {
+	children: React.ReactNode
+}
+
+export default function Root({ children }: RootProps) {
+	return <div className={s.root}>{children}</div>
+}

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

@@ -0,0 +1,15 @@
+.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) {
+		justify-content: flex-start;
+		height: 100%;
+		min-height: fit-content;
+		gap: var(--hdsplus-spacing-04);
+	}
+}

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

@@ -3,7 +3,7 @@
  * SPDX-License-Identifier: MPL-2.0
  */
 
-import * as React from 'react'
+import { useState } from 'react'
 import Badge from '@hashicorp/react-badge'
 import classNames from 'classnames'
 import ExpandableArrow from '@hashicorp/react-expandable-arrow'
@@ -23,16 +23,10 @@ export default function NextSteps({
 	steps,
 	cta,
 }: NextStepsProps) {
-	const { slug, themeClass } = useProductMeta(theme)
-
+	const { themeClass } = useProductMeta(theme)
 	return (
 		<section
-			className={classNames(
-				s.nextSteps,
-				s[appearance],
-				themeClass,
-				slug && s[slug]
-			)}
+			className={classNames(s.nextSteps, s[appearance], themeClass)}
 			data-testid="next-steps"
 		>
 			<div className={s.container}>
@@ -96,7 +90,7 @@ export default function NextSteps({
 }
 
 function Tile({ theme, variant, heading, badge, description, cta }) {
-	const [isHovered, setIsHovered] = React.useState(false)
+	const [isHovered, setIsHovered] = useState(false)
 	return (
 		<Link href={cta.url} legacyBehavior>
 			<a

package/src/components/subnav/index.tsx

@@ -1,17 +1,14 @@
+'use client'
+
 /**
  * Copyright (c) HashiCorp, Inc.
  * SPDX-License-Identifier: MPL-2.0
  */
-
-'use client'
-
 import { useState } from 'react'
 import classNames from 'classnames'
 import useProductMeta, { Products } from '@hashicorp/platform-product-meta'
 import { THEMES } from './subnav-consts'
 import useNavRef from './helpers/useNavRef'
-import s from './style.module.css'
-import themeStyles from './theme.module.css'
 
 import MenuItemsOverflow from './partials/MenuItemsOverflow'
 import TitleLink from './partials/TitleLink'
@@ -20,6 +17,8 @@ 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 = {
 	consul: 'consul',
@@ -76,7 +75,6 @@ function SubnavInner({
 	menuText = 'Menu',
 	activatePanel,
 }: SubnavInnerProps) {
-	const { themeClass } = useProductMeta(product) // overrides --brand css vars
 	// Add _isActiveUrl to menuItems so we can highlight them appropriately
 	const menuItemsWithActive = traverse(menuItems, (_key, value: any) => {
 		const hasUrl = isObject(value) && value.url
@@ -88,6 +86,8 @@ function SubnavInner({
 		return value
 	})
 
+	const { themeClass } = useProductMeta(product)
+
 	/**
 	 * Note on constrainWidth & g-grid-container
 	 *

package/src/components/subnav/partials/CtaLinks/index.tsx

@@ -12,8 +12,8 @@ import type { ToggleButtonProps } from '@hashicorp/react-design-system-component
 import * as Dropdown from '@hashicorp/react-design-system-components/src/components/dropdown'
 import GithubStarsLink from './github-stars-link'
 import classNames from 'classnames'
-import s from './style.module.css'
 import * as NavigationMenu from '@radix-ui/react-navigation-menu'
+import s from './style.module.css'
 
 type CtaLink = ButtonProps & { href: string; __typename?: string }
 

package/src/components/subnav/partials/DropdownTrigger/index.tsx

@@ -5,8 +5,8 @@
 
 import FlightIcon from '@hashicorp/react-design-system-components/src/components/flight-icon'
 import NavItemText from '../nav-item-text'
-import s from './style.module.css'
 import * as NavigationMenu from '@radix-ui/react-navigation-menu'
+import s from './style.module.css'
 
 interface DropdownTriggerProps {
 	text: string

package/src/components/subnav/partials/MenuItemsDefault/index.tsx

@@ -7,8 +7,8 @@ import React from 'react'
 import Link from 'next/link'
 import NavItemText from '../nav-item-text'
 import DropdownTrigger from '../DropdownTrigger'
-import s from './style.module.css'
 import * as NavigationMenu from '@radix-ui/react-navigation-menu'
+import s from './style.module.css'
 
 interface MenuItemsDefaultProps {
 	menuItems: (

package/src/components/subnav/partials/MenuItemsOverflow/index.tsx

@@ -9,9 +9,9 @@ import Link from 'next/link'
 import type { Products } from '@hashicorp/platform-product-meta'
 import CtaLinks, { type CtaLinkProps } from '../CtaLinks'
 import DropdownTrigger from '../DropdownTrigger'
-import s from './style.module.css'
 import * as NavigationMenu from '@radix-ui/react-navigation-menu'
 import classNames from 'classnames'
+import s from './style.module.css'
 
 interface MenuItemsOverflowProps {
 	menuItems: (