@bearmenu/ui 0.8.16 → 0.8.18

package/src/components/coach-marks.tsx

@@ -0,0 +1,252 @@
+"use client";
+
+import { useCallback, useEffect, useLayoutEffect, useState } from "react";
+import { createPortal } from "react-dom";
+import { ArrowRight, Lightbulb } from "lucide-react";
+import { cn } from "../lib/utils";
+import { Button } from "./button";
+
+/**
+ * CoachMarks — a guided tour drawn OVER the real page.
+ *
+ * Four things, one at a time: the page dims, the current stop's target is cut
+ * out of the dimming in a spotlight, its step number sits on the spotlight's
+ * corner, and one callout beside the spotlight says what the target is. Only
+ * the current stop is marked — a map of every stop's number over the page
+ * competes with the page's own numerals and with the callout's "Step N of
+ * M"; the way through is Next, Back and the arrow keys. The reader learns
+ * the surface by looking at the surface, not at a picture of it; nothing on
+ * the page moves or re-renders to be taught.
+ *
+ * Targets are found by `data-coach-mark="<stop id>"` on the page's own
+ * elements, so the page keeps its markup and the tour attaches from outside.
+ * The tour is built from the stops whose target is ON THE PAGE when it opens
+ * (or when the itinerary changes): a stop with nothing to point at is not
+ * counted, so "Step 3 of 5" is always a step the reader will reach. Where
+ * the same id is on two elements — a desktop and a phone rendering of one
+ * control — the visible one is taken.
+ *
+ * The consumer owns the words (`labels`, `stops`) and the open state; the
+ * tour owns its position, the geometry (8px breathing room, the callout's
+ * side, re-measure on scroll and resize) and the keys (Escape closes, the
+ * arrows step). `onProgress` reports the current stop for a toolbar label.
+ *
+ * Rendered into `document.body`: a page wrapper with an opacity or transform
+ * transition is a stacking context, and the tour must sit above everything
+ * the page and its chrome draw, whatever wraps the consumer.
+ */
+
+export type CoachMarkStop = {
+  /** Matches the target's `data-coach-mark` attribute. */
+  id: string;
+  title: string;
+  body: string;
+};
+
+export type CoachMarksLabels = {
+  /** "Step 2 of 4". */
+  progress: (step: number, total: number) => string;
+  back: string;
+  next: string;
+  /** The last stop's forward action, e.g. "Done". */
+  done: string;
+  skip: string;
+};
+
+export type CoachMarksProps = {
+  open: boolean;
+  stops: CoachMarkStop[];
+  /** Skip, Done, Escape and a tap on the dimmed page all end here. */
+  onClose: () => void;
+  /**
+   * 1-based position, the count of stops the page actually has, and the
+   * stop being shown — its id is what a consumer remembers, since the
+   * position shifts when a stop's target is missing.
+   */
+  onProgress?: (step: number, total: number, stop: CoachMarkStop) => void;
+  labels: CoachMarksLabels;
+  className?: string;
+};
+
+type Rect = { top: number; left: number; width: number; height: number };
+
+const PAD = 8;
+const CALLOUT_WIDTH = 320;
+const CALLOUT_GAP = 14;
+/** The room a side needs before the callout goes there. */
+const CALLOUT_ROOM = 280;
+const EDGE = 12;
+
+/** The step number, an inverted disc on the spotlight's corner: dark on the gold ring. */
+const PIN =
+  "pointer-events-none absolute z-[1] flex h-8 w-8 -translate-x-1/2 -translate-y-1/2 items-center justify-center rounded-full bg-[oklch(0.26_0.03_60)] text-[13px] font-extrabold text-[oklch(0.82_0.15_85)] ring-2 ring-[oklch(0.82_0.15_85)] shadow-[0_2px_8px_oklch(0.16_0.012_55_/_0.45)] transition-[top,left] duration-300 motion-reduce:transition-none";
+
+/** The visible element carrying the id — a `display: none` twin has no boxes. */
+function findTarget(id: string): HTMLElement | null {
+  if (typeof document === "undefined") return null;
+  const candidates = document.querySelectorAll<HTMLElement>(`[data-coach-mark="${id}"]`);
+  for (const candidate of candidates) {
+    if (candidate.getClientRects().length > 0) return candidate;
+  }
+  return null;
+}
+
+function measure(element: HTMLElement): Rect {
+  const box = element.getBoundingClientRect();
+  return { top: box.top, left: box.left, width: box.width, height: box.height };
+}
+
+export function CoachMarks({ open, stops, onClose, onProgress, labels, className }: CoachMarksProps) {
+  // The stops the page can show, fixed when the tour opens or the itinerary
+  // changes — by its ids, so a consumer rebuilding the array each render does
+  // not send the tour back to the first stop.
+  const [available, setAvailable] = useState<CoachMarkStop[]>([]);
+  const [index, setIndex] = useState(0);
+  const [rect, setRect] = useState<Rect | null>(null);
+  const [viewport, setViewport] = useState({ width: 0, height: 0 });
+  const itinerary = stops.map((stop) => stop.id).join("|");
+
+  useLayoutEffect(() => {
+    if (!open) return;
+    const present = stops.filter((stop) => findTarget(stop.id));
+    setAvailable(present);
+    setIndex(0);
+    if (present.length === 0) onClose();
+    // `stops` is read whenever its ids change; the words alone do not restart the tour.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [open, itinerary]);
+
+  const current = available[index];
+  const currentId = current?.id;
+
+  const remeasure = useCallback(() => {
+    const element = currentId ? findTarget(currentId) : null;
+    setRect(element ? measure(element) : null);
+    setViewport({ width: window.innerWidth, height: window.innerHeight });
+  }, [currentId]);
+
+  // Bring the current target into view, then measure it — again once the
+  // smooth scroll has settled.
+  useLayoutEffect(() => {
+    if (!open || !current) return;
+    const element = findTarget(current.id);
+    if (!element) {
+      // The page changed under the tour: move on, or end when nothing is left.
+      const forward = available.findIndex((stop, at) => at > index && findTarget(stop.id));
+      if (forward !== -1) setIndex(forward);
+      else onClose();
+      return;
+    }
+    element.scrollIntoView({ block: "center", behavior: "smooth", inline: "nearest" });
+    remeasure();
+    const settle = setTimeout(remeasure, 400);
+    return () => clearTimeout(settle);
+  }, [open, current, index, available, remeasure, onClose]);
+
+  useEffect(() => {
+    if (!open || !current) return;
+    onProgress?.(index + 1, available.length, current);
+  }, [open, current, index, available.length, onProgress]);
+
+  useEffect(() => {
+    if (!open) return;
+    window.addEventListener("resize", remeasure);
+    window.addEventListener("scroll", remeasure, true);
+    const onKey = (event: KeyboardEvent) => {
+      if (event.key === "Escape") onClose();
+      if (event.key === "ArrowRight") setIndex((at) => Math.min(at + 1, available.length - 1));
+      if (event.key === "ArrowLeft") setIndex((at) => Math.max(at - 1, 0));
+    };
+    window.addEventListener("keydown", onKey);
+    return () => {
+      window.removeEventListener("resize", remeasure);
+      window.removeEventListener("scroll", remeasure, true);
+      window.removeEventListener("keydown", onKey);
+    };
+  }, [open, remeasure, onClose, available.length]);
+
+  if (!open || !current || !rect) return null;
+
+  const last = index === available.length - 1;
+  const spot = {
+    top: rect.top - PAD,
+    left: rect.left - PAD,
+    width: rect.width + PAD * 2,
+    height: rect.height + PAD * 2,
+  };
+  // Below the target when there is room for the callout, else above it; a
+  // target taller than the viewport leaves room on neither side, and the
+  // callout then sits at the bottom edge, over the target's lower part.
+  const roomBelow = viewport.height - (spot.top + spot.height);
+  const calloutLeft = Math.min(
+    Math.max(spot.left, EDGE),
+    Math.max(EDGE, viewport.width - CALLOUT_WIDTH - EDGE)
+  );
+  const calloutPlace =
+    roomBelow > CALLOUT_ROOM
+      ? { top: spot.top + spot.height + CALLOUT_GAP, left: calloutLeft }
+      : spot.top > CALLOUT_ROOM
+        ? { bottom: viewport.height - spot.top + CALLOUT_GAP, left: calloutLeft }
+        : { bottom: EDGE, left: calloutLeft };
+
+  return createPortal(
+    <div
+      className={cn("fixed inset-0 z-[80]", className)}
+      role="dialog"
+      aria-modal
+      aria-label={current.title}
+    >
+      {/* The dimming is the spotlight's shadow: one element, cut out where
+          the target is, so the target stays fully visible and the rest of the
+          page falls back. A tap on the dim closes the tour. */}
+      <button
+        type="button"
+        aria-label={labels.skip}
+        onClick={onClose}
+        className="absolute inset-0 cursor-default"
+      />
+      <div
+        aria-hidden
+        className="pointer-events-none absolute rounded-[18px] shadow-[0_0_0_9999px_oklch(0.16_0.012_55_/_0.55)] ring-2 ring-[oklch(0.82_0.15_85)] transition-[top,left,width,height] duration-300 motion-reduce:transition-none"
+        style={spot}
+      />
+
+      {/* The step number on the spotlight's corner; the callout says the rest. */}
+      <span aria-hidden className={PIN} style={{ top: rect.top - 2, left: rect.left - 2 }}>
+        {index + 1}
+      </span>
+
+      {/* The callout. */}
+      <div
+        className="absolute z-[2] w-[min(320px,calc(100vw-24px))] rounded-2xl border border-border bg-card p-4 text-card-foreground shadow-xl"
+        style={calloutPlace}
+      >
+        <span className="inline-flex items-center gap-1.5 rounded-full bg-[oklch(0.82_0.15_85)] px-2.5 py-1 text-[10.5px] font-extrabold uppercase tracking-[0.08em] text-[oklch(0.26_0.03_60)]">
+          <Lightbulb className="h-3 w-3" aria-hidden />
+          {labels.progress(index + 1, available.length)}
+        </span>
+        <p className="mt-3 text-[15px] font-bold leading-snug">{current.title}</p>
+        <p className="mt-1.5 text-sm leading-relaxed text-muted-foreground">{current.body}</p>
+        <div className="mt-4 flex items-center gap-2">
+          {index > 0 && (
+            <Button type="button" variant="ghost" size="sm" onClick={() => setIndex(index - 1)}>
+              {labels.back}
+            </Button>
+          )}
+          <Button
+            type="button"
+            size="sm"
+            onClick={() => (last ? onClose() : setIndex(index + 1))}
+          >
+            {last ? labels.done : labels.next}
+            {!last && <ArrowRight aria-hidden />}
+          </Button>
+          <Button type="button" variant="link" size="sm" className="ml-auto" onClick={onClose}>
+            {labels.skip}
+          </Button>
+        </div>
+      </div>
+    </div>,
+    document.body
+  );
+}

package/src/components/doorway-tiles.stories.tsx

@@ -1,4 +1,5 @@
 import type { Meta, StoryObj } from "@storybook/react";
+import { TextSearch } from "lucide-react";
 import { DoorwayTiles } from "./doorway-tiles";
 import {
   mockFamilyTiles,
@@ -58,6 +59,25 @@ export const PolaroidPartial: Story = {
   args: { treatment: "polaroid", tiles: mockFamilyTiles.slice(0, 5) },
 };
 
+/**
+ * The closing tile as a door to an ACTION — the menu's search page. No
+ * photograph, no initial: the print holds a glyph on the photo ground, and
+ * the tile keeps its siblings' silhouette.
+ */
+export const PolaroidWithSearchDoor: Story = {
+  args: {
+    treatment: "polaroid",
+    tiles: mockFamilyTiles,
+    all: {
+      ...mockFamilyTilesAll,
+      label: "Search the menu",
+      countLabel: "535 dishes · 210 drinks",
+      photoUrl: undefined,
+      icon: <TextSearch strokeWidth={1.75} aria-hidden />,
+    },
+  },
+};
+
 /** The occasions: the mood's hue multiplied over a room. */
 export const Ground: Story = {
   args: { treatment: "ground", tiles: mockOccasionTiles, all: mockOccasionTilesAll },
@@ -81,3 +101,17 @@ export const GroundWithoutPhotos: Story = {
     tiles: mockOccasionTiles.map(({ photoUrl: _photoUrl, ...tile }) => tile),
   },
 };
+
+/** The closing tile as a door to an action on the ground treatment: the glyph where the initial was. */
+export const GroundWithActionDoor: Story = {
+  args: {
+    treatment: "ground",
+    tiles: mockOccasionTiles,
+    all: {
+      ...mockOccasionTilesAll,
+      label: "Search the menu",
+      photoUrl: undefined,
+      icon: <TextSearch strokeWidth={1.75} aria-hidden />,
+    },
+  },
+};

package/src/components/doorway-tiles.test.tsx

@@ -30,6 +30,33 @@ describe("DoorwayTiles", () => {
     expect(screen.getByText(withoutPhoto.label.charAt(0))).toBeInTheDocument();
   });
 
+  // A door about an action carries a glyph in the print: no photograph, and
+  // not the initial either — that would read as a family starting with "S".
+  it("draws the glyph, not the initial or the photo, where a tile has an icon", () => {
+    const search = {
+      ...mockFamilyTilesAll,
+      label: "Search the menu",
+      icon: <svg data-testid="glyph" />,
+    };
+    render(<DoorwayTiles treatment="polaroid" tiles={mockFamilyTiles.slice(0, 1)} all={search} />);
+    expect(screen.getByTestId("glyph")).toBeInTheDocument();
+    expect(screen.queryByText("S")).not.toBeInTheDocument();
+    expect(document.querySelectorAll("img")).toHaveLength(1);
+  });
+
+  it("ground: the glyph takes the initial's place and no photograph is drawn for it", () => {
+    const door = {
+      ...mockOccasionTilesAll,
+      label: "Search the menu",
+      icon: <svg data-testid="glyph" />,
+    };
+    render(<DoorwayTiles treatment="ground" tiles={mockOccasionTiles.slice(0, 1)} all={door} />);
+    expect(screen.getByTestId("glyph")).toBeInTheDocument();
+    expect(screen.queryByText("S")).not.toBeInTheDocument();
+    const withPhoto = mockOccasionTiles.slice(0, 1).filter((t) => t.photoUrl).length;
+    expect(document.querySelectorAll("img")).toHaveLength(withPhoto);
+  });
+
   it("omits the index tile when no index is given", () => {
     render(<DoorwayTiles treatment="polaroid" tiles={mockFamilyTiles.slice(0, 3)} />);
     expect(screen.getAllByRole("link")).toHaveLength(3);

package/src/components/doorway-tiles.tsx

@@ -1,6 +1,6 @@
 import { cn } from "../lib/utils";
 import type { MenuLinkComponent, MenuLinkProps } from "./menu-types";
-import { PhotoGround } from "./photo-ground";
+import { PHOTO_GLYPH_SHADOW, PHOTO_GROUND, PhotoGround } from "./photo-ground";
 
 /**
  * DoorwayTiles — a grid of doors: every class the reader browses by, as
@@ -89,6 +89,17 @@ export type DoorwayTile = {
   gradient?: string;
   /** Pre-resolved photograph of the CLASS, from the consumer's own origin. */
   photoUrl?: string;
+  /**
+   * A glyph in the photograph's place — for a tile about an ACTION, not a
+   * thing. A search door has no class to photograph, and any subject put on
+   * it (a table, a lens, a book) reads as one more family; the initial the
+   * fallback draws is a family's initial too. So the print holds the glyph
+   * instead, on the photo ground with the photo fallback's drop shadow, and
+   * the tile keeps its siblings' silhouette. Wins over `photoUrl`.
+   *
+   * A node rather than a name: the app owns its iconography.
+   */
+  icon?: React.ReactNode;
 };
 
 export type DoorwayTilesTreatment = "polaroid" | "ground";
@@ -144,6 +155,17 @@ const GROUND_LIFT = "absolute inset-0 z-0 opacity-[0.22]";
 const GROUND_GLYPH =
   "absolute inset-0 z-0 flex items-center justify-center font-serif text-[64px] font-semibold leading-none text-white/15";
 
+/**
+ * The action glyph. In the polaroid it fills the print at 44% on the photo
+ * ground, white with the fallback family's drop shadow; on the ground
+ * treatment it takes the initial's place at the initial's weight.
+ */
+const PRINT_ICON =
+  `absolute inset-0 flex items-center justify-center ${PHOTO_GROUND} text-white/90 ` +
+  `[&_svg]:h-[44%] [&_svg]:w-[44%] [&_svg]:${PHOTO_GLYPH_SHADOW}`;
+const GROUND_ICON =
+  "absolute inset-0 z-0 flex items-center justify-center text-white/15 [&_svg]:h-[40%] [&_svg]:w-[40%]";
+
 export function DoorwayTiles({
   tiles,
   all,
@@ -167,7 +189,9 @@ export function DoorwayTiles({
           >
             {isPolaroid ? (
               <span aria-hidden className={POLAROID}>
-                {tile.photoUrl ? (
+                {tile.icon ? (
+                  <span className={PRINT_ICON}>{tile.icon}</span>
+                ) : tile.photoUrl ? (
                   /* Not lazy: the grid sits directly under the hero, and these
                      photographs are the first thing the reader looks at. */
                   // eslint-disable-next-line @next/next/no-img-element
@@ -186,6 +210,10 @@ export function DoorwayTiles({
                   />
                 )}
               </span>
+            ) : tile.icon ? (
+              <span aria-hidden className={GROUND_ICON}>
+                {tile.icon}
+              </span>
             ) : tile.photoUrl ? (
               <>
                 {/* eslint-disable-next-line @next/next/no-img-element */}

package/src/components/event-card.tsx

@@ -55,8 +55,22 @@ export type EventCardProps = {
    * `Coverflow`) — it crops less than `3/4` and is not the same as it.
    */
   posterAspect?: "4/3" | "3/4" | "4/5";
-  /** Larger title — the featured/highlight slot. Never a clamp: the title wraps in full either way. */
-  emphasis?: boolean;
+  /**
+   * Larger title — the featured/highlight slot. Never a clamp: the title
+   * wraps in full either way. `"lg"` applies it from the `lg` breakpoint
+   * only: the timeline's day hero is an ordinary card in the phone column and
+   * the lane's feature poster on desktop, one node.
+   */
+  emphasis?: boolean | "lg";
+  /**
+   * `card` (default) at every width. `row-lg`: the card below `lg`, and from
+   * `lg` the compact row `EventCompactRow` draws — a 64px portrait poster
+   * beside the text, overlay pills off, the fee as a chip on the tags row.
+   * The timeline demotes an hour's later events to rows on desktop only, and
+   * a server render cannot swap components per viewport; this is the one
+   * node that paints both.
+   */
+  density?: "card" | "row-lg";
   /** Top-left overlay pill (the design's "Busy" hype marker). Include its icon. */
   badge?: React.ReactNode;
   /** Bottom-left overlay pill naming the category. Include its icon. */
@@ -77,8 +91,12 @@ export type EventCardProps = {
    * locale, and "is this live" depends on the app's clock, not the DS's.
    */
   liveStatus?: string;
-  /** Hide the day/time line — the timeline supplies its own hour heading. */
-  hideWhen?: boolean;
+  /**
+   * Hide the day/time line — the timeline supplies its own hour heading.
+   * `"below-lg"` hides it on the phone only: the desktop lane's hero sits
+   * beside whatever hour is passing and has to carry its own start time.
+   */
+  hideWhen?: boolean | "below-lg";
   /**
    * Already over — dims the poster, mutes the title and shows the `endedLabel`
    * chip. Never row-level opacity, which composites the text below AA. Same
@@ -111,6 +129,7 @@ export const EventCard = memo(function EventCard({
   formatters,
   posterAspect = "4/3",
   emphasis,
+  density = "card",
   badge,
   tagLabel,
   tags,
@@ -129,7 +148,10 @@ export const EventCard = memo(function EventCard({
 }: EventCardProps) {
   const [imgError, setImgError] = useState(false);
   const showEnded = isEnded && !!endedLabel;
-  const time = hideWhen ? "" : formatters.time(event.starts_at);
+  // `"below-lg"` still renders the line (hidden by CSS on the phone), so the
+  // time is formatted whenever the line can show anywhere.
+  const time = hideWhen === true ? "" : formatters.time(event.starts_at);
+  const isRowLg = density === "row-lg";
 
   const fee = resolveEventEntryFee(event);
   const showPoster = !!event.poster_url && !imgError;
@@ -146,6 +168,8 @@ export const EventCard = memo(function EventCard({
             : posterAspect === "4/5"
               ? "aspect-[4/5]"
               : "aspect-[4/3]",
+          // The compact row's poster from `lg`: 64px, portrait, tighter radius.
+          isRowLg && "lg:aspect-[4/5] lg:w-16 lg:shrink-0 lg:rounded-[10px]",
         )}
       >
         {showPoster ? (
@@ -164,8 +188,14 @@ export const EventCard = memo(function EventCard({
         )}
 
         {/* Top overlay row — hype badge left, entry fee right. The empty span
-            keeps the fee pill right-aligned when there is no badge. */}
-        <div className="absolute inset-x-2 top-2 flex items-start justify-between gap-2">
+            keeps the fee pill right-aligned when there is no badge. Off on a
+            64px row poster, where the fee moves to the tags row. */}
+        <div
+          className={cn(
+            "absolute inset-x-2 top-2 flex items-start justify-between gap-2",
+            isRowLg && "lg:hidden",
+          )}
+        >
           {badge ? (
             <span className={cn(PILL_BASE, "bg-black/55 text-white")}>
               {badge}
@@ -187,7 +217,12 @@ export const EventCard = memo(function EventCard({
         </div>
 
         {tagLabel && (
-          <div className="absolute inset-x-2 bottom-2 flex gap-1">
+          <div
+            className={cn(
+              "absolute inset-x-2 bottom-2 flex gap-1",
+              isRowLg && "lg:hidden",
+            )}
+          >
             <span className={cn(PILL_BASE, "bg-black/55 text-white")}>
               {tagLabel}
             </span>
@@ -195,6 +230,8 @@ export const EventCard = memo(function EventCard({
         )}
       </div>
 
+      {/* The text column — a wrapper so `row-lg` can lay it beside the poster. */}
+      <div className={cn("flex min-w-0 flex-col", isRowLg && "lg:flex-1")}>
       {/* NEVER CLAMPED, in any variant. The title is the one thing a card
           exists to say, and "Movie Night: Futni m…" says none of it — the
           truncated form was the reported defect. It wraps to as many lines as
@@ -205,9 +242,11 @@ export const EventCard = memo(function EventCard({
       <h3
         className={cn(
           "mt-2.5 leading-[1.35]",
-          emphasis
+          emphasis === true
             ? "text-lg font-bold tracking-[-0.02em]"
             : "text-sm font-semibold",
+          emphasis === "lg" && "lg:text-lg lg:font-bold lg:tracking-[-0.02em]",
+          isRowLg && "lg:mt-0 lg:text-[13.5px]",
           isEnded && "text-muted-foreground",
         )}
       >
@@ -219,8 +258,13 @@ export const EventCard = memo(function EventCard({
         <span className="truncate">{venue}</span>
       </div>
 
-      {!hideWhen && (
-        <div className="mt-[3px] flex items-center gap-1.5 text-xs text-muted-foreground">
+      {hideWhen !== true && (
+        <div
+          className={cn(
+            "mt-[3px] flex items-center gap-1.5 text-xs text-muted-foreground",
+            hideWhen === "below-lg" && "hidden lg:flex",
+          )}
+        >
           <span>{dayLabel ?? formatters.day(event.starts_at)}</span>
           {/* An empty time is "hour unknown" (see `EventFormatters.time`): the
               day stands alone, no dangling separator. Consumers used to have
@@ -244,13 +288,21 @@ export const EventCard = memo(function EventCard({
         </div>
       )}
 
-      {tags && tags.length > 0 && (
+      {/* The row look carries the fee as a chip here, where the compact row
+          puts it — the poster is too small for an overlay pill. */}
+      {((tags && tags.length > 0) || (isRowLg && fee.kind === "free")) && (
         <TagGroup className="mt-1.5">
-          {tags.map((tag) => (
+          {tags?.map((tag) => (
             <Tag key={tag} size="sm">
               {tag}
             </Tag>
           ))}
+          {isRowLg && fee.kind === "free" && (
+            <Tag size="sm" variant="success" className="hidden font-bold lg:inline-flex">
+              <Gift className="h-3 w-3" aria-hidden />
+              {labels.free}
+            </Tag>
+          )}
         </TagGroup>
       )}
 
@@ -268,13 +320,18 @@ export const EventCard = memo(function EventCard({
           </Tag>
         </div>
       )}
+      </div>
     </>
   );
 
   const rootClasses = cn(
     "flex min-w-0 flex-col text-left",
+    // The compact row from `lg`: poster beside text, the row's own padding
+    // and negative gutter so the hover wash bleeds like `EventCompactRow`'s.
+    isRowLg && "lg:-mx-2.5 lg:flex-row lg:items-start lg:gap-[11px] lg:rounded-lg lg:px-2.5 lg:py-2",
     (href || onClick) &&
       "cursor-pointer focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 rounded-xl",
+    (href || onClick) && isRowLg && "lg:hover:bg-foreground/5",
     className,
   );
 

package/src/components/event-day-header.tsx

@@ -47,10 +47,12 @@ export type EventDayHeaderProps = {
    */
   action?: React.ReactNode;
   /**
-   * Larger desktop scale: 58px day number, 18px weekday, 12.5px meta,
-   * against the mobile 40/15/11.5.
+   * `sm`: the phone scale (30px day number, 15px weekday, 11.5px meta).
+   * `default`: the desktop scale (58 / 18 / 12.5). `responsive`: `sm` below
+   * `lg` and `default` from it, in one node — for a server render that
+   * cannot know the viewport.
    */
-  size?: "sm" | "default";
+  size?: "sm" | "default" | "responsive";
   href?: string;
   linkComponent?: React.ComponentType<EventDayHeaderLinkProps>;
   onClick?: () => void;
@@ -70,6 +72,9 @@ export function EventDayHeader({
 }: EventDayHeaderProps) {
   const isInteractive = !!href || !!onClick;
   const large = size === "default";
+  // `responsive` is the phone scale with every `default` class as an `lg:`
+  // twin — one node for a server-rendered timeline.
+  const responsive = size === "responsive";
 
   const body = (
     <>
@@ -78,21 +83,27 @@ export function EventDayHeader({
           "font-black leading-[0.82] tracking-[-0.05em] tabular-nums",
           // `sm` is the phone scale: 30px, the design's app day head. 40px
           // was a page-scale number that took a third of a 390px row.
-          large ? "text-[58px]" : "text-[30px] leading-[0.86]"
+          large ? "text-[58px]" : "text-[30px] leading-[0.86]",
+          responsive && "lg:text-[58px] lg:leading-[0.82]"
         )}
       >
         {dayNumber}
       </div>
-      <div className={large ? "pb-1" : "pb-0.5"}>
+      <div className={cn(large ? "pb-1" : "pb-0.5", responsive && "lg:pb-1")}>
         <div
-          className={cn("font-extrabold tracking-[-0.015em]", large ? "text-lg" : "text-[15px]")}
+          className={cn(
+            "font-extrabold tracking-[-0.015em]",
+            large ? "text-lg" : "text-[15px]",
+            responsive && "lg:text-lg"
+          )}
         >
           {weekday}
         </div>
         <div
           className={cn(
             "mt-0.5 text-muted-foreground",
-            large ? "whitespace-nowrap text-[12.5px]" : "text-[11.5px]"
+            large ? "whitespace-nowrap text-[12.5px]" : "text-[11.5px]",
+            responsive && "lg:whitespace-nowrap lg:text-[12.5px]"
           )}
         >
           {meta}
@@ -132,6 +143,7 @@ export function EventDayHeader({
       className={cn(
         "relative flex w-full items-end gap-3 pb-3 pt-[18px]",
         large && "gap-[18px] pb-4",
+        responsive && "lg:gap-[18px] lg:pb-4",
         className
       )}
     >