---
// starlight's Hero (0.36), with the actions rendered as the web app's
// buttons. markup and styles otherwise match upstream
import { Image } from "astro:assets";
import Button from "$lib/components/ui/Button.svelte";
import ArrowRight from "~icons/lucide/arrow-right";
const { data } = Astro.locals.starlightRoute.entry;
const { title = data.title, tagline, image, actions = [] } = data.hero || {};
const imageAttrs = {
loading: "eager" as const,
decoding: "async" as const,
width: 400,
height: 400,
alt: image?.alt || "",
};
let darkImage: ImageMetadata | undefined;
let lightImage: ImageMetadata | undefined;
let rawHtml: string | undefined;
if (image) {
if ("file" in image) {
darkImage = image.file;
} else if ("dark" in image) {
darkImage = image.dark;
lightImage = image.light;
} else {
rawHtml = image.html;
}
}
// the primary action is the web app's call to action, arrow on the right.
// the others need a text color: the web app sets it on every <a>, starlight doesn't
const variants = { primary: "primary", secondary: "default", minimal: "ghost" } as const;
---
<div class:list={["hero", { "hero-no-image": !darkImage && !lightImage && !rawHtml }]}>
{
darkImage && (
<Image
src={darkImage}
{...imageAttrs}
class:list={{ "light:sl-hidden": Boolean(lightImage) }}
/>
)
}
{lightImage && <Image src={lightImage} {...imageAttrs} class="dark:sl-hidden" />}
{rawHtml && <div class="hero-html sl-flex" set:html={rawHtml} />}
<div class="sl-flex stack">
<div class="sl-flex copy">
<h2 id="_top" data-page-title set:html={title} />
{tagline && <div class="tagline" set:html={tagline} />}
</div>
{
actions.length > 0 && (
<div class="sl-flex actions">
{actions.map(({ link: href, text, variant = "primary" }) => (
<Button
{href}
variant={variants[variant]}
size="large"
icon={variant === "primary" ? ArrowRight : undefined}
iconSide="right"
class={variant === "primary" ? undefined : "text-foreground-default"}
>
{text}
</Button>
))}
</div>
)
}
</div>
</div>
<style>
@layer starlight.core {
.hero {
display: grid;
align-items: center;
gap: 1rem;
padding-bottom: 1rem;
}
.hero > img,
.hero > .hero-html {
object-fit: contain;
width: min(70%, 20rem);
height: auto;
margin-inline: auto;
}
.stack {
flex-direction: column;
gap: clamp(1.5rem, calc(1.5rem + 1vw), 2rem);
text-align: center;
}
.copy {
flex-direction: column;
gap: 1rem;
align-items: center;
}
.copy > * {
max-width: 50ch;
}
h2 {
font-size: clamp(var(--sl-text-3xl), calc(0.25rem + 5vw), var(--sl-text-6xl));
line-height: var(--sl-line-height-headings);
font-weight: 600;
color: var(--sl-color-white);
}
.tagline {
font-size: clamp(var(--sl-text-base), calc(0.0625rem + 2vw), var(--sl-text-xl));
color: var(--sl-color-gray-2);
}
.actions {
gap: 1rem;
flex-wrap: wrap;
justify-content: center;
}
@media (min-width: 50rem) {
.hero {
grid-template-columns: 7fr 4fr;
gap: 3%;
padding-block: clamp(2.5rem, calc(1rem + 10vmin), 10rem);
}
/* without an image the copy takes the whole width */
.hero-no-image {
grid-template-columns: 1fr;
}
.hero > img,
.hero > .hero-html {
order: 2;
width: min(100%, 25rem);
}
.stack {
text-align: start;
}
.copy {
align-items: flex-start;
}
.actions {
justify-content: flex-start;
}
}
}
</style>