# Spotlight Beam

A large, tilted beam of light that sweeps in once when the section scrolls into view, and can lean toward the pointer.

- Category: Backgrounds
- Status: stable
- Registry: https://markas.jenderalcorp.com/r/spotlight-beam.json
- CLI: `npx markasui@latest add spotlight-beam`

## When to use

A cinematic backdrop for a hero, sign-in screen, or launch section that needs one strong light source.

- Set the background color, padding, and radius with class on the component
- Use intensity=soft on light backgrounds and strong on dark ones
- Use follow only on large sections where the pointer moves a lot

## Code

### Blade

Save at `resources/views/components/markas/spotlight-beam.blade.php`. Dependencies: alpinejs.

```blade
@props([
    'variant' => 'top-left',
    'color' => 'primary',
    'intensity' => 'medium',
    'speed' => 'normal',
    'follow' => false,
])

@php
    $base = 'relative isolate overflow-hidden [--markas-beam-play:paused] data-[visible]:[--markas-beam-play:running]';
    $layer = 'pointer-events-none absolute inset-0 overflow-hidden';
    $source = 'absolute inset-0 [translate:calc(var(--markas-beam-x,0)*4%)_calc(var(--markas-beam-y,0)*4%)] animate-[markas-beam_var(--markas-beam-speed)_cubic-bezier(0.22,1,0.36,1)_both_var(--markas-beam-play)] transition-[translate] duration-700 ease-out motion-reduce:animate-none motion-reduce:transition-none';
    $beams = [
        'absolute top-0 left-[var(--markas-beam-left)] h-[90%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)+6deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*0.35),transparent),transparent)]',
        'absolute top-0 left-[var(--markas-beam-left)] h-[50%] w-[170%] origin-left -translate-y-1/2 rotate-[var(--markas-beam-angle)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_var(--markas-beam-strength),transparent),transparent)]',
        'absolute top-0 left-[var(--markas-beam-left)] h-[22%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)-2deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*1.1),transparent),transparent)]',
    ];
    $content = 'relative';
    $variants = [
        'top-left' => '[--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]',
        'top-right' => '-scale-x-100 [--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]',
        'center' => '[--markas-beam-angle:90deg] [--markas-beam-left:50%] [--markas-beam-dx:0%]',
    ];
    $colors = [
        'primary' => 'text-primary',
        'success' => 'text-success',
        'warning' => 'text-warning',
        'danger' => 'text-danger',
        'muted' => 'text-muted',
    ];
    $intensities = [
        'soft' => '[--markas-beam-strength:22%]',
        'medium' => '[--markas-beam-strength:34%]',
        'strong' => '[--markas-beam-strength:50%]',
    ];
    $speeds = [
        'slow' => '[--markas-beam-speed:2.4s]',
        'normal' => '[--markas-beam-speed:1.6s]',
        'fast' => '[--markas-beam-speed:0.9s]',
    ];
    $keyframes = '@keyframes markas-beam{from{opacity:0;transform:translate(var(--markas-beam-dx),-10%) scale(.9)}}';
@endphp

{{-- Mark the root visible the first time it scrolls into view, which starts the entrance. With follow, the light source leans a little toward the pointer. --}}
<div
    wire:ignore.self
    x-data="{
        observer: null,
        init() {
            const show = () => this.$el.setAttribute('data-visible', '');
            if (typeof IntersectionObserver === 'undefined') return show();
            this.observer = new IntersectionObserver((entries) => {
                if (! entries.some((entry) => entry.isIntersecting)) return;
                this.observer.disconnect();
                show();
            });
            this.observer.observe(this.$el);
        },
        lean(event) {
            if (! @js((bool) $follow) || window.matchMedia?.('(prefers-reduced-motion: reduce)').matches) return;
            const rect = this.$el.getBoundingClientRect();
            const x = ((event.clientX - rect.left) / rect.width) * 2 - 1;
            const y = ((event.clientY - rect.top) / rect.height) * 2 - 1;
            this.$el.style.setProperty('--markas-beam-x', x.toFixed(3));
            this.$el.style.setProperty('--markas-beam-y', y.toFixed(3));
        },
        destroy() {
            this.observer?.disconnect();
        },
    }"
    @pointermove="lean($event)"
    {{ $attributes->class([$base]) }}
>
    <style>{!! $keyframes !!}</style>
    <div aria-hidden="true" @class([$layer, $colors[$color] ?? $colors['primary'], $intensities[$intensity] ?? $intensities['medium'], $speeds[$speed] ?? $speeds['normal']])>
        <div @class([$source, $variants[$variant] ?? $variants['top-left']])>
            @foreach ($beams as $beam)
                <div class="{{ $beam }}"></div>
            @endforeach
        </div>
    </div>
    <div class="{{ $content }}">{{ $slot }}</div>
</div>
```

```blade
<x-markas.spotlight-beam follow class="dark rounded-xl bg-canvas px-6 py-16 text-ink">
    <h2 class="text-3xl font-semibold text-ink">Your roadmap, in the spotlight</h2>
    <x-markas.button>Create a roadmap</x-markas.button>
</x-markas.spotlight-beam>
```

Needs Alpine.js for the entrance and for `follow`.

### React

Save at `src/components/markas/SpotlightBeam.tsx`. No extra dependencies.

```tsx
"use client";

import {
  useEffect,
  useRef,
  type ComponentProps,
  type PointerEvent,
} from "react";

const base =
  "relative isolate overflow-hidden [--markas-beam-play:paused] data-[visible]:[--markas-beam-play:running]";
const layer = "pointer-events-none absolute inset-0 overflow-hidden";
const source =
  "absolute inset-0 [translate:calc(var(--markas-beam-x,0)*4%)_calc(var(--markas-beam-y,0)*4%)] animate-[markas-beam_var(--markas-beam-speed)_cubic-bezier(0.22,1,0.36,1)_both_var(--markas-beam-play)] transition-[translate] duration-700 ease-out motion-reduce:animate-none motion-reduce:transition-none";
const beams = [
  "absolute top-0 left-[var(--markas-beam-left)] h-[90%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)+6deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*0.35),transparent),transparent)]",
  "absolute top-0 left-[var(--markas-beam-left)] h-[50%] w-[170%] origin-left -translate-y-1/2 rotate-[var(--markas-beam-angle)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_var(--markas-beam-strength),transparent),transparent)]",
  "absolute top-0 left-[var(--markas-beam-left)] h-[22%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)-2deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*1.1),transparent),transparent)]",
];
const content = "relative";
const variants = {
  "top-left":
    "[--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]",
  "top-right":
    "-scale-x-100 [--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]",
  center:
    "[--markas-beam-angle:90deg] [--markas-beam-left:50%] [--markas-beam-dx:0%]",
};
const colors = {
  primary: "text-primary",
  success: "text-success",
  warning: "text-warning",
  danger: "text-danger",
  muted: "text-muted",
};
const intensities = {
  soft: "[--markas-beam-strength:22%]",
  medium: "[--markas-beam-strength:34%]",
  strong: "[--markas-beam-strength:50%]",
};
const speeds = {
  slow: "[--markas-beam-speed:2.4s]",
  normal: "[--markas-beam-speed:1.6s]",
  fast: "[--markas-beam-speed:0.9s]",
};
const keyframes =
  "@keyframes markas-beam{from{opacity:0;transform:translate(var(--markas-beam-dx),-10%) scale(.9)}}";
const cx = (...c: (string | false | null | undefined)[]) =>
  c.filter(Boolean).join(" ");

const reducedMotion = () =>
  typeof matchMedia === "function" &&
  matchMedia("(prefers-reduced-motion: reduce)").matches;

/** Mark the root visible the first time it scrolls into view, which starts the entrance. */
function revealOnView(element: HTMLElement): (() => void) | undefined {
  const show = () => element.setAttribute("data-visible", "");
  if (typeof IntersectionObserver === "undefined") {
    show();
    return undefined;
  }
  const observer = new IntersectionObserver((entries) => {
    if (!entries.some((entry) => entry.isIntersecting)) return;
    observer.disconnect();
    show();
  });
  observer.observe(element);
  return () => observer.disconnect();
}

/** Store the pointer position from -1 to 1 so the light source leans toward it. */
function lean(event: PointerEvent<HTMLDivElement>) {
  if (reducedMotion()) return;
  const root = event.currentTarget;
  const rect = root.getBoundingClientRect();
  const x = ((event.clientX - rect.left) / rect.width) * 2 - 1;
  const y = ((event.clientY - rect.top) / rect.height) * 2 - 1;
  root.style.setProperty("--markas-beam-x", x.toFixed(3));
  root.style.setProperty("--markas-beam-y", y.toFixed(3));
}

export type SpotlightBeamProps = ComponentProps<"div"> & {
  /** Where the light comes from. */
  variant?: keyof typeof variants;
  color?: keyof typeof colors;
  intensity?: keyof typeof intensities;
  speed?: keyof typeof speeds;
  /** The light source leans a little toward the pointer. */
  follow?: boolean;
};

export function SpotlightBeam({
  variant = "top-left",
  color = "primary",
  intensity = "medium",
  speed = "normal",
  follow = false,
  className,
  children,
  onPointerMove,
  ...props
}: SpotlightBeamProps) {
  const ref = useRef<HTMLDivElement>(null);
  useEffect(() => (ref.current ? revealOnView(ref.current) : undefined), []);
  return (
    <div
      ref={ref}
      {...props}
      className={cx(base, className)}
      onPointerMove={(event) => {
        if (follow) lean(event);
        onPointerMove?.(event);
      }}
    >
      <style>{keyframes}</style>
      <div
        aria-hidden="true"
        className={cx(
          layer,
          colors[color],
          intensities[intensity],
          speeds[speed],
        )}
      >
        <div className={cx(source, variants[variant] ?? variants["top-left"])}>
          {beams.map((beam, index) => (
            <div key={index} className={beam} />
          ))}
        </div>
      </div>
      <div className={content}>{children}</div>
    </div>
  );
}
```

```tsx
import { Button } from "@/components/markas/Button";
import { SpotlightBeam } from "@/components/markas/SpotlightBeam";

<SpotlightBeam follow className="dark rounded-xl bg-canvas px-6 py-16 text-ink">
  <h2 className="text-3xl font-semibold text-ink">
    Your roadmap, in the spotlight
  </h2>
  <Button>Create a roadmap</Button>
</SpotlightBeam>;
```

### Vue

Save at `src/components/markas/SpotlightBeam.vue`. No extra dependencies.

```vue
<script setup lang="ts">
import { onBeforeUnmount, onMounted, useTemplateRef } from "vue";

const base =
  "relative isolate overflow-hidden [--markas-beam-play:paused] data-[visible]:[--markas-beam-play:running]";
const layer = "pointer-events-none absolute inset-0 overflow-hidden";
const source =
  "absolute inset-0 [translate:calc(var(--markas-beam-x,0)*4%)_calc(var(--markas-beam-y,0)*4%)] animate-[markas-beam_var(--markas-beam-speed)_cubic-bezier(0.22,1,0.36,1)_both_var(--markas-beam-play)] transition-[translate] duration-700 ease-out motion-reduce:animate-none motion-reduce:transition-none";
const beams = [
  "absolute top-0 left-[var(--markas-beam-left)] h-[90%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)+6deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*0.35),transparent),transparent)]",
  "absolute top-0 left-[var(--markas-beam-left)] h-[50%] w-[170%] origin-left -translate-y-1/2 rotate-[var(--markas-beam-angle)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_var(--markas-beam-strength),transparent),transparent)]",
  "absolute top-0 left-[var(--markas-beam-left)] h-[22%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)-2deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*1.1),transparent),transparent)]",
];
const content = "relative";
const variants = {
  "top-left":
    "[--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]",
  "top-right":
    "-scale-x-100 [--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]",
  center:
    "[--markas-beam-angle:90deg] [--markas-beam-left:50%] [--markas-beam-dx:0%]",
};
const colors = {
  primary: "text-primary",
  success: "text-success",
  warning: "text-warning",
  danger: "text-danger",
  muted: "text-muted",
};
const intensities = {
  soft: "[--markas-beam-strength:22%]",
  medium: "[--markas-beam-strength:34%]",
  strong: "[--markas-beam-strength:50%]",
};
const speeds = {
  slow: "[--markas-beam-speed:2.4s]",
  normal: "[--markas-beam-speed:1.6s]",
  fast: "[--markas-beam-speed:0.9s]",
};
const keyframes =
  "@keyframes markas-beam{from{opacity:0;transform:translate(var(--markas-beam-dx),-10%) scale(.9)}}";

const props = withDefaults(
  defineProps<{
    /** Where the light comes from. */
    variant?: keyof typeof variants;
    color?: keyof typeof colors;
    intensity?: keyof typeof intensities;
    speed?: keyof typeof speeds;
    /** The light source leans a little toward the pointer. */
    follow?: boolean;
  }>(),
  {
    variant: "top-left",
    color: "primary",
    intensity: "medium",
    speed: "normal",
    follow: false,
  },
);

const reducedMotion = () =>
  typeof matchMedia === "function" &&
  matchMedia("(prefers-reduced-motion: reduce)").matches;

/** Mark the root visible the first time it scrolls into view, which starts the entrance. */
function revealOnView(element: HTMLElement): (() => void) | undefined {
  const show = () => element.setAttribute("data-visible", "");
  if (typeof IntersectionObserver === "undefined") {
    show();
    return undefined;
  }
  const observer = new IntersectionObserver((entries) => {
    if (!entries.some((entry) => entry.isIntersecting)) return;
    observer.disconnect();
    show();
  });
  observer.observe(element);
  return () => observer.disconnect();
}

/** Store the pointer position from -1 to 1 so the light source leans toward it. */
function lean(event: PointerEvent) {
  if (!props.follow || reducedMotion()) return;
  const root = event.currentTarget as HTMLElement;
  const rect = root.getBoundingClientRect();
  const x = ((event.clientX - rect.left) / rect.width) * 2 - 1;
  const y = ((event.clientY - rect.top) / rect.height) * 2 - 1;
  root.style.setProperty("--markas-beam-x", x.toFixed(3));
  root.style.setProperty("--markas-beam-y", y.toFixed(3));
}

const rootEl = useTemplateRef<HTMLDivElement>("rootRef");
let stop: (() => void) | undefined;
onMounted(() => {
  if (rootEl.value) stop = revealOnView(rootEl.value);
});
onBeforeUnmount(() => stop?.());
</script>

<template>
  <div ref="rootRef" :class="base" @pointermove="lean">
    <component :is="'style'">{{ keyframes }}</component>
    <div
      aria-hidden="true"
      :class="[
        layer,
        colors[props.color],
        intensities[props.intensity],
        speeds[props.speed],
      ]"
    >
      <div :class="[source, variants[props.variant] ?? variants['top-left']]">
        <div v-for="(beam, index) in beams" :key="index" :class="beam" />
      </div>
    </div>
    <div :class="content"><slot /></div>
  </div>
</template>
```

```vue
<template>
  <SpotlightBeam follow class="dark rounded-xl bg-canvas px-6 py-16 text-ink">
    <h2 class="text-3xl font-semibold text-ink">
      Your roadmap, in the spotlight
    </h2>
    <Button>Create a roadmap</Button>
  </SpotlightBeam>
</template>
```

### Svelte

Save at `src/lib/components/markas/SpotlightBeam.svelte`. No extra dependencies.

```svelte
<script lang="ts">
  import type { Snippet } from "svelte";
  import type { HTMLAttributes } from "svelte/elements";

  const base =
    "relative isolate overflow-hidden [--markas-beam-play:paused] data-[visible]:[--markas-beam-play:running]";
  const layer = "pointer-events-none absolute inset-0 overflow-hidden";
  const source =
    "absolute inset-0 [translate:calc(var(--markas-beam-x,0)*4%)_calc(var(--markas-beam-y,0)*4%)] animate-[markas-beam_var(--markas-beam-speed)_cubic-bezier(0.22,1,0.36,1)_both_var(--markas-beam-play)] transition-[translate] duration-700 ease-out motion-reduce:animate-none motion-reduce:transition-none";
  const beams = [
    "absolute top-0 left-[var(--markas-beam-left)] h-[90%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)+6deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*0.35),transparent),transparent)]",
    "absolute top-0 left-[var(--markas-beam-left)] h-[50%] w-[170%] origin-left -translate-y-1/2 rotate-[var(--markas-beam-angle)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_var(--markas-beam-strength),transparent),transparent)]",
    "absolute top-0 left-[var(--markas-beam-left)] h-[22%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)-2deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*1.1),transparent),transparent)]",
  ];
  const content = "relative";
  const variants = {
    "top-left":
      "[--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]",
    "top-right":
      "-scale-x-100 [--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]",
    center:
      "[--markas-beam-angle:90deg] [--markas-beam-left:50%] [--markas-beam-dx:0%]",
  };
  const colors = {
    primary: "text-primary",
    success: "text-success",
    warning: "text-warning",
    danger: "text-danger",
    muted: "text-muted",
  };
  const intensities = {
    soft: "[--markas-beam-strength:22%]",
    medium: "[--markas-beam-strength:34%]",
    strong: "[--markas-beam-strength:50%]",
  };
  const speeds = {
    slow: "[--markas-beam-speed:2.4s]",
    normal: "[--markas-beam-speed:1.6s]",
    fast: "[--markas-beam-speed:0.9s]",
  };
  const keyframes =
    "@keyframes markas-beam{from{opacity:0;transform:translate(var(--markas-beam-dx),-10%) scale(.9)}}";

  const reducedMotion = () =>
    typeof matchMedia === "function" &&
    matchMedia("(prefers-reduced-motion: reduce)").matches;

  type Props = HTMLAttributes<HTMLDivElement> & {
    /** Where the light comes from. */
    variant?: keyof typeof variants;
    color?: keyof typeof colors;
    intensity?: keyof typeof intensities;
    speed?: keyof typeof speeds;
    /** The light source leans a little toward the pointer. */
    follow?: boolean;
    children?: Snippet;
  };

  let {
    variant = "top-left",
    color = "primary",
    intensity = "medium",
    speed = "normal",
    follow = false,
    class: className,
    children,
    onpointermove,
    ...rest
  }: Props = $props();

  let root = $state<HTMLDivElement>();

  // Mark the root visible the first time it scrolls into view, which starts the entrance.
  $effect(() => {
    const element = root;
    if (!element) return;
    const show = () => element.setAttribute("data-visible", "");
    if (typeof IntersectionObserver === "undefined") return show();
    const observer = new IntersectionObserver((entries) => {
      if (!entries.some((entry) => entry.isIntersecting)) return;
      observer.disconnect();
      show();
    });
    observer.observe(element);
    return () => observer.disconnect();
  });

  /** Store the pointer position from -1 to 1 so the light source leans toward it. */
  function lean(
    event: PointerEvent & { currentTarget: EventTarget & HTMLDivElement },
  ) {
    if (follow && !reducedMotion()) {
      const element = event.currentTarget;
      const rect = element.getBoundingClientRect();
      const x = ((event.clientX - rect.left) / rect.width) * 2 - 1;
      const y = ((event.clientY - rect.top) / rect.height) * 2 - 1;
      element.style.setProperty("--markas-beam-x", x.toFixed(3));
      element.style.setProperty("--markas-beam-y", y.toFixed(3));
    }
    onpointermove?.(event);
  }
</script>

<div bind:this={root} {...rest} class={[base, className]} onpointermove={lean}>
  {@html `<style>${keyframes}</style>`}
  <div
    aria-hidden="true"
    class={[layer, colors[color], intensities[intensity], speeds[speed]]}
  >
    <div class={[source, variants[variant] ?? variants["top-left"]]}>
      {#each beams as beam, index (index)}
        <div class={beam}></div>
      {/each}
    </div>
  </div>
  <div class={content}>{@render children?.()}</div>
</div>
```

```svelte
<script lang="ts">
  import Button from "$lib/components/markas/Button.svelte";
  import SpotlightBeam from "$lib/components/markas/SpotlightBeam.svelte";
</script>

<SpotlightBeam follow class="dark rounded-xl bg-canvas px-6 py-16 text-ink">
  <h2 class="text-3xl font-semibold text-ink">
    Your roadmap, in the spotlight
  </h2>
  <Button>Create a roadmap</Button>
</SpotlightBeam>
```

### Astro

Save at `src/components/markas/SpotlightBeam.astro`. No extra dependencies.

```astro
---
import type { HTMLAttributes } from "astro/types";

const base =
  "relative isolate overflow-hidden [--markas-beam-play:paused] data-[visible]:[--markas-beam-play:running]";
const layer = "pointer-events-none absolute inset-0 overflow-hidden";
const source =
  "absolute inset-0 [translate:calc(var(--markas-beam-x,0)*4%)_calc(var(--markas-beam-y,0)*4%)] animate-[markas-beam_var(--markas-beam-speed)_cubic-bezier(0.22,1,0.36,1)_both_var(--markas-beam-play)] transition-[translate] duration-700 ease-out motion-reduce:animate-none motion-reduce:transition-none";
const beams = [
  "absolute top-0 left-[var(--markas-beam-left)] h-[90%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)+6deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*0.35),transparent),transparent)]",
  "absolute top-0 left-[var(--markas-beam-left)] h-[50%] w-[170%] origin-left -translate-y-1/2 rotate-[var(--markas-beam-angle)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_var(--markas-beam-strength),transparent),transparent)]",
  "absolute top-0 left-[var(--markas-beam-left)] h-[22%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)-2deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*1.1),transparent),transparent)]",
];
const content = "relative";
const variants = {
  "top-left":
    "[--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]",
  "top-right":
    "-scale-x-100 [--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]",
  center:
    "[--markas-beam-angle:90deg] [--markas-beam-left:50%] [--markas-beam-dx:0%]",
};
const colors = {
  primary: "text-primary",
  success: "text-success",
  warning: "text-warning",
  danger: "text-danger",
  muted: "text-muted",
};
const intensities = {
  soft: "[--markas-beam-strength:22%]",
  medium: "[--markas-beam-strength:34%]",
  strong: "[--markas-beam-strength:50%]",
};
const speeds = {
  slow: "[--markas-beam-speed:2.4s]",
  normal: "[--markas-beam-speed:1.6s]",
  fast: "[--markas-beam-speed:0.9s]",
};
const keyframes =
  "@keyframes markas-beam{from{opacity:0;transform:translate(var(--markas-beam-dx),-10%) scale(.9)}}";

type Props = HTMLAttributes<"div"> & {
  /** Where the light comes from. */
  variant?: keyof typeof variants;
  color?: keyof typeof colors;
  intensity?: keyof typeof intensities;
  speed?: keyof typeof speeds;
  /** The light source leans a little toward the pointer. */
  follow?: boolean;
};

const {
  variant = "top-left",
  color = "primary",
  intensity = "medium",
  speed = "normal",
  follow = false,
  class: className,
  ...rest
} = Astro.props;
---

<markas-spotlight-beam class="contents">
  <div
    {...rest}
    class:list={[base, className]}
    data-markas-spotlight-beam-follow={follow ? "" : undefined}
  >
    <style is:inline set:html={keyframes} />
    <div
      aria-hidden="true"
      class:list={[layer, colors[color], intensities[intensity], speeds[speed]]}
    >
      <div class:list={[source, variants[variant] ?? variants["top-left"]]}>
        {beams.map((beam) => <div class={beam} />)}
      </div>
    </div>
    <div class={content}><slot /></div>
  </div>
</markas-spotlight-beam>

<script>
  // Marks the root visible the first time it scrolls into view, which starts the entrance.
  // With follow, the light source leans a little toward the pointer.
  class MarkasSpotlightBeam extends HTMLElement {
    observer?: IntersectionObserver;

    connectedCallback() {
      const root = this.firstElementChild;
      if (!(root instanceof HTMLElement)) return;
      const show = () => root.setAttribute("data-visible", "");
      if (typeof IntersectionObserver === "undefined") return show();
      this.observer = new IntersectionObserver((entries) => {
        if (!entries.some((entry) => entry.isIntersecting)) return;
        this.observer?.disconnect();
        show();
      });
      this.observer.observe(root);
    }

    disconnectedCallback() {
      this.observer?.disconnect();
    }
  }

  if (!customElements.get("markas-spotlight-beam"))
    customElements.define("markas-spotlight-beam", MarkasSpotlightBeam);

  document.addEventListener("pointermove", (event) => {
    const root = (event.target as Element).closest?.<HTMLElement>(
      "[data-markas-spotlight-beam-follow]",
    );
    if (!root) return;
    if (window.matchMedia?.("(prefers-reduced-motion: reduce)").matches) return;
    const rect = root.getBoundingClientRect();
    const x = ((event.clientX - rect.left) / rect.width) * 2 - 1;
    const y = ((event.clientY - rect.top) / rect.height) * 2 - 1;
    root.style.setProperty("--markas-beam-x", x.toFixed(3));
    root.style.setProperty("--markas-beam-y", y.toFixed(3));
  });
</script>
```

```astro
---
import Button from "@/components/markas/Button.astro";
import SpotlightBeam from "@/components/markas/SpotlightBeam.astro";
---

<SpotlightBeam follow class="dark rounded-xl bg-canvas px-6 py-16 text-ink">
  <h2 class="text-3xl font-semibold text-ink">
    Your roadmap, in the spotlight
  </h2>
  <Button>Create a roadmap</Button>
</SpotlightBeam>
```

### Angular

Save at `src/app/markas/spotlight-beam.component.ts`. No extra dependencies.

```ts
import {
  afterNextRender,
  booleanAttribute,
  ChangeDetectionStrategy,
  Component,
  computed,
  DestroyRef,
  ElementRef,
  inject,
  input,
  ViewEncapsulation,
} from "@angular/core";

const base =
  "relative isolate overflow-hidden [--markas-beam-play:paused] data-[visible]:[--markas-beam-play:running]";
const layer = "pointer-events-none absolute inset-0 overflow-hidden";
const source =
  "absolute inset-0 [translate:calc(var(--markas-beam-x,0)*4%)_calc(var(--markas-beam-y,0)*4%)] animate-[markas-beam_var(--markas-beam-speed)_cubic-bezier(0.22,1,0.36,1)_both_var(--markas-beam-play)] transition-[translate] duration-700 ease-out motion-reduce:animate-none motion-reduce:transition-none";
const beams = [
  "absolute top-0 left-[var(--markas-beam-left)] h-[90%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)+6deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*0.35),transparent),transparent)]",
  "absolute top-0 left-[var(--markas-beam-left)] h-[50%] w-[170%] origin-left -translate-y-1/2 rotate-[var(--markas-beam-angle)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_var(--markas-beam-strength),transparent),transparent)]",
  "absolute top-0 left-[var(--markas-beam-left)] h-[22%] w-[140%] origin-left -translate-y-1/2 rotate-[calc(var(--markas-beam-angle)-2deg)] bg-[radial-gradient(ellipse_100%_50%_at_0%_50%,color-mix(in_oklab,currentColor_calc(var(--markas-beam-strength)*1.1),transparent),transparent)]",
];
const content = "relative";
const variants = {
  "top-left":
    "[--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]",
  "top-right":
    "-scale-x-100 [--markas-beam-angle:32deg] [--markas-beam-left:0%] [--markas-beam-dx:-8%]",
  center:
    "[--markas-beam-angle:90deg] [--markas-beam-left:50%] [--markas-beam-dx:0%]",
};
const colors = {
  primary: "text-primary",
  success: "text-success",
  warning: "text-warning",
  danger: "text-danger",
  muted: "text-muted",
};
const intensities = {
  soft: "[--markas-beam-strength:22%]",
  medium: "[--markas-beam-strength:34%]",
  strong: "[--markas-beam-strength:50%]",
};
const speeds = {
  slow: "[--markas-beam-speed:2.4s]",
  normal: "[--markas-beam-speed:1.6s]",
  fast: "[--markas-beam-speed:0.9s]",
};
const keyframes =
  "@keyframes markas-beam{from{opacity:0;transform:translate(var(--markas-beam-dx),-10%) scale(.9)}}";

const reducedMotion = () =>
  typeof matchMedia === "function" &&
  matchMedia("(prefers-reduced-motion: reduce)").matches;

/** Where the light comes from. */
export type SpotlightBeamVariant = keyof typeof variants;
export type SpotlightBeamColor = keyof typeof colors;
export type SpotlightBeamIntensity = keyof typeof intensities;
export type SpotlightBeamSpeed = keyof typeof speeds;

/** Mark the root visible the first time it scrolls into view, which starts the entrance. */
function revealOnView(element: HTMLElement): () => void {
  const show = () => element.setAttribute("data-visible", "");
  if (typeof IntersectionObserver === "undefined") {
    show();
    return () => {};
  }
  const observer = new IntersectionObserver((entries) => {
    if (!entries.some((entry) => entry.isIntersecting)) return;
    observer.disconnect();
    show();
  });
  observer.observe(element);
  return () => observer.disconnect();
}

/**
 * Attribute selector on the native root div: the user's class, attributes, and pointermove
 * listener stay on it. The keyframes are a global style, so encapsulation is off.
 */
@Component({
  selector: "div[markas-spotlight-beam]",
  changeDetection: ChangeDetectionStrategy.OnPush,
  encapsulation: ViewEncapsulation.None,
  styles: [keyframes],
  host: { "[class]": "base", "(pointermove)": "lean($event)" },
  template: `
    <div aria-hidden="true" [class]="layerClasses()">
      <div [class]="sourceClasses()">
        @for (beam of beams; track $index) {
          <div [class]="beam"></div>
        }
      </div>
    </div>
    <div [class]="content"><ng-content /></div>
  `,
})
export class SpotlightBeam {
  readonly variant = input<SpotlightBeamVariant>("top-left");
  readonly color = input<SpotlightBeamColor>("primary");
  readonly intensity = input<SpotlightBeamIntensity>("medium");
  readonly speed = input<SpotlightBeamSpeed>("normal");
  /** The light source leans a little toward the pointer. */
  readonly follow = input(false, { transform: booleanAttribute });

  protected readonly base = base;
  protected readonly beams = beams;
  protected readonly content = content;
  protected readonly layerClasses = computed(
    () =>
      `${layer} ${colors[this.color()]} ${intensities[this.intensity()]} ${speeds[this.speed()]}`,
  );
  protected readonly sourceClasses = computed(
    () => `${source} ${variants[this.variant()] ?? variants["top-left"]}`,
  );
  private readonly host = inject<ElementRef<HTMLDivElement>>(ElementRef);

  constructor() {
    let stop = () => {};
    afterNextRender(() => {
      stop = revealOnView(this.host.nativeElement);
    });
    inject(DestroyRef).onDestroy(() => stop());
  }

  /** Store the pointer position from -1 to 1 so the light source leans toward it. */
  protected lean(event: PointerEvent) {
    if (!this.follow() || reducedMotion()) return;
    const root = this.host.nativeElement;
    const rect = root.getBoundingClientRect();
    const x = ((event.clientX - rect.left) / rect.width) * 2 - 1;
    const y = ((event.clientY - rect.top) / rect.height) * 2 - 1;
    root.style.setProperty("--markas-beam-x", x.toFixed(3));
    root.style.setProperty("--markas-beam-y", y.toFixed(3));
  }
}
```

```ts
import { Component } from "@angular/core";
import { Button } from "./markas/button.component";
import { SpotlightBeam } from "./markas/spotlight-beam.component";

@Component({
  selector: "app-roadmap",
  imports: [Button, SpotlightBeam],
  template: `
    <div
      markas-spotlight-beam
      follow
      class="dark rounded-xl bg-canvas px-6 py-16 text-ink"
    >
      <h2 class="text-3xl font-semibold text-ink">
        Your roadmap, in the spotlight
      </h2>
      <button markas-button>Create a roadmap</button>
    </div>
  `,
})
export class Roadmap {}
```

Angular uses an attribute selector on the native div, so `class`, `aria-*`, and other attributes stay on the root element.

## Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `variant` | `top-left \| top-right \| center` | top-left | Where the light comes from: a top corner shining diagonally, or straight down from the top center. |
| `color` | `primary \| success \| warning \| danger \| muted` | primary | Token used for the beam. |
| `intensity` | `soft \| medium \| strong` | medium | How bright the beam is. |
| `speed` | `slow \| normal \| fast` | normal | Length of the entrance: 2.4s, 1.6s, or 0.9s. |
| `follow` | `boolean` | false | The light source leans a little toward the pointer while it moves over the section. |
| `children / slot` | `slot / ReactNode` | - | Content shown on top of the beam. |

## Accessibility

- The beam layer is aria-hidden and ignores pointer events.
- The entrance plays once, the first time the section scrolls into view.
- With reduced motion, the beam shows in place right away and does not follow the pointer.

## Notes

- The beam is three stretched radial gradients, rotated from the light source. No SVG filters or blur, so it stays cheap to paint.
- `variant="top-right"` mirrors the beam, `variant="center"` shines straight down.
- `follow` stores the pointer position in CSS variables on the root; the light shifts by at most 4% and eases back into place.
- The entrance plays once when the section first scrolls into view. With reduced motion the beam is shown right away and `follow` is off.
- The component has no built-in text, so there are no label props to translate.
