@bearmenu/ui 0.8.4 → 0.8.7

package/src/components/card.tsx

@@ -12,6 +12,29 @@ const cardVariants = cva(
         glass: "glass",
         outline: "bg-transparent border border-border",
         muted: "bg-muted border border-transparent",
+        // `surface` PLUS elevation. The border is NOT replaced, and that is the
+        // whole design of these two.
+        //
+        // In light mode `--card` is pure white on a 0.986 ground — 1.04:1, a
+        // five-in-255 step — so a plain surface is defined by its 1.32:1
+        // hairline alone. That is proportionate under a pill and invisible under
+        // a panel, which is what "this looks flat" means here: there is no z.
+        //
+        // But dropping the border to go shadow-only breaks both themes. Every
+        // elevation token in this system is downward-offset, so a white
+        // shadow-only box has no defined TOP edge on a near-white page and
+        // reads as half-drawn. And on the 0.155 dark canvas the shadow is
+        // nearly invisible, so `--border` is the only thing left describing the
+        // box. The border IS the dark-mode fallback, which is why neither
+        // variant needs a `dark:` branch.
+        elevated: "bg-card border border-border shadow-[var(--shadow-card)]",
+        // The same recipe at panel scale — see `--shadow-panel` for why a
+        // bigger box does not simply take the card shadow. Resting elevation
+        // only: deliberately absent from `compoundVariants` below, because a
+        // several-hundred-pixel slab that translates under the cursor is a
+        // wobble rather than a lift. A panel that size delegates interaction to
+        // its children.
+        elevatedPanel: "bg-card border border-border shadow-[var(--shadow-panel)]",
       },
       size: {
         sm: "[&_[data-slot=card-header]]:p-4 [&_[data-slot=card-content]]:p-4 [&_[data-slot=card-content]]:pt-0 [&_[data-slot=card-footer]]:p-4 [&_[data-slot=card-footer]]:pt-0",
@@ -21,11 +44,31 @@ const cardVariants = cva(
       },
       // Interactive variant follows v1.0 `press-response` archetype:
       // hover lift via shadow + translate (200ms), press scale-down (instant).
+      //
+      // The hover SHADOW is not here — it lives in `compoundVariants` below, so
+      // it can be expressed relative to the resting elevation. `box-shadow` is
+      // a single property, so a flat `hover:shadow-md` REPLACES a resting
+      // shadow rather than stepping up from it: an `elevated` card would
+      // translate upward while its shadow got tighter, which is physically
+      // backwards and reads as a flicker.
       interactive: {
-        true: "cursor-pointer transition-[transform,border-color,box-shadow] duration-[var(--duration-quick)] ease-[var(--ease-standard)] hover:border-primary/40 hover:-translate-y-0.5 hover:shadow-md active:scale-[0.97] active:duration-[var(--duration-instant)] motion-reduce:hover:translate-y-0 motion-reduce:active:scale-100",
+        true: "cursor-pointer transition-[transform,border-color,box-shadow] duration-[var(--duration-quick)] ease-[var(--ease-standard)] hover:border-primary/40 hover:-translate-y-0.5 active:scale-[0.97] active:duration-[var(--duration-instant)] motion-reduce:hover:translate-y-0 motion-reduce:active:scale-100",
         false: "",
       },
     },
+    // The first four reproduce the previous `hover:shadow-md` exactly; only
+    // `elevated` is new. `elevatedPanel` is absent on purpose — see its note.
+    compoundVariants: [
+      { variant: "surface", interactive: true, class: "hover:shadow-md" },
+      { variant: "glass", interactive: true, class: "hover:shadow-md" },
+      { variant: "outline", interactive: true, class: "hover:shadow-md" },
+      { variant: "muted", interactive: true, class: "hover:shadow-md" },
+      {
+        variant: "elevated",
+        interactive: true,
+        class: "hover:shadow-[var(--shadow-card-hover)]",
+      },
+    ],
   defaultVariants: {
     variant: "surface",
     size: "default",

package/src/components/category-deck.stories.tsx

@@ -0,0 +1,96 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { CategoryDeck, CategoryDeckSkeleton } from "./category-deck";
+
+function poster(color: string, label: string) {
+  return {
+    src:
+      "data:image/svg+xml;utf8," +
+      encodeURIComponent(
+        `<svg xmlns="http://www.w3.org/2000/svg" width="240" height="320"><rect width="240" height="320" fill="${color}"/><text x="50%" y="50%" font-family="monospace" font-size="14" fill="#fff" text-anchor="middle">${label}</text></svg>`
+      ),
+  };
+}
+
+// Explicitly annotated rather than `satisfies`: the meta-level decorator makes
+// the inferred type reference storybook's internal CSF module, which tsc cannot
+// name portably (TS2742).
+const meta: Meta<typeof CategoryDeck> = {
+  title: "Events/CategoryDeck",
+  component: CategoryDeck,
+  tags: ["autodocs"],
+  args: {
+    name: "Petreceri",
+    meta: "32 events · /petreceri",
+    href: "/petreceri",
+    posters: [
+      poster("#7c5a3a", "1"),
+      poster("#5a4a3a", "2"),
+      poster("#8a6a4a", "3"),
+      poster("#3a2a1a", "4"),
+    ],
+  },
+  decorators: [
+    (Story) => (
+      <div className="w-[220px] p-8">
+        <Story />
+      </div>
+    ),
+  ],
+  parameters: {
+    docs: {
+      description: {
+        component:
+          "The hub's category doorway — one link, four decorative posters fanned back to front. The fan opens on hover AND keyboard focus (`group-focus-visible`), never on hover alone.",
+      },
+    },
+  },
+};
+
+export default meta;
+type Story = StoryObj<typeof CategoryDeck>;
+
+export const Default: Story = {};
+
+/** Fewer than four posters supplied — the remaining slots render as placeholders. */
+export const PartialPosters: Story = {
+  args: {
+    posters: [poster("#7c5a3a", "1"), poster("#5a4a3a", "2")],
+  },
+};
+
+/** No posters at all — every slot is a placeholder block. */
+export const NoPosters: Story = {
+  args: { posters: [] },
+};
+
+/**
+ * `content` replaces the `<img>` entirely — for callers whose cards are not
+ * photographs. The menu hub fans dish categories this way, drawing a tinted
+ * colour field per card instead of a photo it is not allowed to show.
+ */
+export const CustomContent: Story = {
+  args: {
+    name: "Pizza",
+    meta: "214 dishes · from 18 lei",
+    posters: ["#8d5524", "#a3663a", "#6f4520", "#b07d4e"].map((background, index) => ({
+      content: (
+        <div
+          className="flex h-full w-full items-end p-2 text-[10px] font-bold text-white/80"
+          style={{ background }}
+        >
+          Pizza {index + 1}
+        </div>
+      ),
+    })),
+  },
+};
+
+/** Rendered as a `<button>` when only `onClick` is given. */
+export const AsButton: Story = {
+  args: { href: undefined, onClick: () => alert("Category selected") },
+};
+
+/** The fan at rest — never spread, since the loading state has nothing to hover. */
+export const Skeleton: Story = {
+  render: () => <CategoryDeckSkeleton />,
+};

package/src/components/category-deck.tsx

@@ -0,0 +1,227 @@
+"use client";
+
+import * as React from "react";
+import { ChevronRight } from "lucide-react";
+import { cn } from "../lib/utils";
+import { Skeleton } from "./skeleton";
+
+/**
+ * CategoryDeck — the hub's category doorway: a fanned stack of four posters
+ * that spreads open on hover or focus.
+ *
+ * The whole deck is ONE link (or button, or static div — same href/onClick
+ * contract as `EventCard`). The four posters are decorative dressing for that
+ * single destination, not four separate targets, so they're `aria-hidden` and
+ * the link's accessible name comes from the visible `name`/`meta` text next
+ * to it.
+ *
+ * The fan must open for keyboard users too, not just mouse hover — the spread
+ * transform is driven by `group-hover` AND `group-focus-visible` on the same
+ * link. Every poster's `transform` is set as a single arbitrary CSS property
+ * rather than composed Tailwind `translate-x`/`rotate` utilities, because
+ * those utilities share one `--tw-translate-x` variable and would silently
+ * overwrite each other.
+ *
+ * Poster offsets are the same at every breakpoint — the design only specifies
+ * a smaller card size and deck height for mobile, not a rescaled fan.
+ */
+
+const DECK_POSTER_COUNT = 4;
+
+const DECK_TRANSITION =
+  "transition-transform duration-[400ms] ease-[cubic-bezier(0.2,0.8,0.2,1)] motion-reduce:transition-none";
+
+const DECK_CARD_TRANSFORMS: ReadonlyArray<{ rest: string; spread: string; z: string }> = [
+  {
+    rest: "[transform:translateX(-50%)_rotate(-9deg)_translateX(-26px)]",
+    spread:
+      "group-hover:[transform:translateX(-50%)_rotate(-14deg)_translateX(-64px)_translateY(-6px)] group-focus-visible:[transform:translateX(-50%)_rotate(-14deg)_translateX(-64px)_translateY(-6px)]",
+    z: "z-0",
+  },
+  {
+    rest: "[transform:translateX(-50%)_rotate(-3deg)_translateX(-9px)]",
+    spread:
+      "group-hover:[transform:translateX(-50%)_rotate(-5deg)_translateX(-22px)_translateY(-10px)] group-focus-visible:[transform:translateX(-50%)_rotate(-5deg)_translateX(-22px)_translateY(-10px)]",
+    z: "z-[1]",
+  },
+  {
+    rest: "[transform:translateX(-50%)_rotate(3deg)_translateX(9px)]",
+    spread:
+      "group-hover:[transform:translateX(-50%)_rotate(5deg)_translateX(22px)_translateY(-10px)] group-focus-visible:[transform:translateX(-50%)_rotate(5deg)_translateX(22px)_translateY(-10px)]",
+    z: "z-[1]",
+  },
+  {
+    rest: "[transform:translateX(-50%)_rotate(9deg)_translateX(26px)]",
+    spread:
+      "group-hover:[transform:translateX(-50%)_rotate(14deg)_translateX(64px)_translateY(-6px)] group-focus-visible:[transform:translateX(-50%)_rotate(14deg)_translateX(64px)_translateY(-6px)]",
+    z: "z-[2]",
+  },
+];
+
+export type CategoryDeckPoster = {
+  src?: string;
+  alt?: string;
+  /**
+   * Rendered in the card instead of an `<img>`. Wins over `src`.
+   *
+   * The deck was built for event posters, where every card is a photograph.
+   * The menu hub fans the same deck over dish categories, and that app renders
+   * no menu-item photography on card surfaces — it draws a tinted colour field
+   * carrying the item's name. Without a slot, those decks fanned four empty
+   * `bg-muted` blocks.
+   *
+   * Same escape hatch, and the same name-and-precedence rule, as
+   * `FeaturedRailItemProps.fallback` and `PosterTapeItem.fallback` — except
+   * those two are fallbacks shown when a poster is ABSENT, while this one is a
+   * deliberate replacement. Hence `content`, not `fallback`: a caller passing
+   * it is choosing what the card is, not what it degrades to.
+   */
+  content?: React.ReactNode;
+};
+
+export type CategoryDeckLinkProps = {
+  href: string;
+  className?: string;
+  children: React.ReactNode;
+  onClick?: (mouseEvent: React.MouseEvent) => void;
+};
+
+function DefaultLink({ href, ...props }: CategoryDeckLinkProps) {
+  return <a href={href} {...props} />;
+}
+
+export type CategoryDeckProps = {
+  name: string;
+  /** Caller-composed, e.g. "32 events · /petreceri". */
+  meta: string;
+  /** Up to four posters, fanned back to front. A poster with neither `content`
+   *  nor `src` renders a placeholder block. */
+  posters: CategoryDeckPoster[];
+  href?: string;
+  /** Defaults to a plain `<a>`. Pass `next/link` in a Next app. */
+  linkComponent?: React.ComponentType<CategoryDeckLinkProps>;
+  onClick?: (mouseEvent: React.MouseEvent) => void;
+  className?: string;
+};
+
+export function CategoryDeck({
+  name,
+  meta,
+  posters,
+  href,
+  linkComponent: LinkComponent = DefaultLink,
+  onClick,
+  className,
+}: CategoryDeckProps) {
+  const slots = Array.from(
+    { length: DECK_POSTER_COUNT },
+    (_, index): CategoryDeckPoster => posters[index] ?? {}
+  );
+
+  const body = (
+    <>
+      <div className="relative h-[150px] sm:h-[186px]" aria-hidden>
+
+        {slots.map((poster, index) => {
+          const transform = DECK_CARD_TRANSFORMS[index];
+          return (
+            <div
+              key={index}
+              className={cn(
+                "absolute left-1/2 top-0 aspect-[4/5] w-24 overflow-hidden rounded-[10px] bg-muted",
+                "shadow-[0_10px_26px_color-mix(in_oklch,var(--foreground)_18%,transparent)]",
+                "sm:w-[120px]",
+                transform.rest,
+                transform.spread,
+                transform.z,
+                DECK_TRANSITION
+              )}
+            >
+              {poster.content ? (
+                poster.content
+              ) : poster.src ? (
+                // eslint-disable-next-line @next/next/no-img-element
+                <img
+                  src={poster.src}
+                  alt={poster.alt ?? ""}
+                  loading="lazy"
+                  decoding="async"
+                  className="h-full w-full object-cover"
+                />
+              ) : (
+                <div className="h-full w-full bg-muted" />
+              )}
+            </div>
+          );
+        })}
+      </div>
+
+      <div className="flex items-center gap-[9px] pt-3.5">
+        <div className="min-w-0">
+          <div className="truncate text-[14.5px] font-extrabold tracking-[-0.015em] sm:text-base">
+            {name}
+          </div>
+          <div className="truncate font-mono text-[11.5px] text-muted-foreground">{meta}</div>
+        </div>
+        <ChevronRight className="ml-auto h-4 w-4 shrink-0 text-muted-foreground" aria-hidden />
+      </div>
+    </>
+  );
+
+  const rootClasses = cn(
+    "group flex min-w-0 flex-col text-left",
+    (href || onClick) &&
+      "cursor-pointer focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 rounded-xl",
+    className
+  );
+
+  if (href) {
+    return (
+      <LinkComponent href={href} className={rootClasses} onClick={onClick}>
+        {body}
+      </LinkComponent>
+    );
+  }
+
+  if (onClick) {
+    return (
+      <button type="button" className={rootClasses} onClick={onClick}>
+        {body}
+      </button>
+    );
+  }
+
+  return <div className={rootClasses}>{body}</div>;
+}
+
+export type CategoryDeckSkeletonProps = {
+  className?: string;
+};
+
+/** The deck's resting layout — the fan sits at its rest transform, never spread. */
+export function CategoryDeckSkeleton({ className }: CategoryDeckSkeletonProps) {
+  return (
+    <div aria-hidden="true" className={cn("flex min-w-0 flex-col", className)}>
+      <div className="relative h-[150px] sm:h-[186px]">
+        {DECK_CARD_TRANSFORMS.map((transform, index) => (
+          <Skeleton
+            key={index}
+            className={cn(
+              "absolute left-1/2 top-0 aspect-[4/5] w-24 rounded-[10px] sm:w-[120px]",
+              transform.rest,
+              transform.z
+            )}
+          />
+        ))}
+      </div>
+
+      <div className="flex items-center gap-[9px] pt-3.5">
+        <div className="min-w-0 flex-1">
+          <Skeleton className="h-[14.5px] w-24 sm:h-4 sm:w-28" />
+          <Skeleton className="mt-1.5 h-[11.5px] w-32" />
+        </div>
+        <Skeleton className="ml-auto h-4 w-4 shrink-0 rounded-full" />
+      </div>
+    </div>
+  );
+}

package/src/components/concept-card.stories.tsx

@@ -0,0 +1,80 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { PartyPopper, Music } from "lucide-react";
+import { ConceptCard, ConceptCardSkeleton } from "./concept-card";
+
+const kind = (
+  <>
+    <PartyPopper className="h-3 w-3" aria-hidden />
+    Party
+  </>
+);
+
+// Explicitly annotated rather than `satisfies`: the meta-level decorator makes
+// the inferred type reference storybook's internal CSF module, which tsc cannot
+// name portably (TS2742).
+const meta: Meta<typeof ConceptCard> = {
+  title: "Events/ConceptCard",
+  component: ConceptCard,
+  tags: ["autodocs"],
+  args: {
+    title: "Flying Circus",
+    meta: "Every Saturday · Flying Circus · 4 dates",
+    kind,
+  },
+  decorators: [
+    (Story) => (
+      <div className="w-[320px]">
+        <Story />
+      </div>
+    ),
+  ],
+  parameters: {
+    docs: {
+      description: {
+        component:
+          "`meta` is composed by the caller — the design's variants (\"Every Saturday · Flying Circus · 4 dates\") don't decompose into parts without hardcoding clause order.",
+      },
+    },
+  },
+};
+
+export default meta;
+type Story = StoryObj<typeof ConceptCard>;
+
+export const Default: Story = {};
+
+/** Absent `coverUrl` falls back to a flat muted block, same as `EventCard`. */
+export const NoCover: Story = {
+  args: { coverUrl: undefined },
+};
+
+export const WithCover: Story = {
+  args: {
+    coverUrl:
+      "data:image/svg+xml;utf8," +
+      encodeURIComponent(
+        `<svg xmlns="http://www.w3.org/2000/svg" width="640" height="320"><rect width="640" height="320" fill="#3a2c46"/><text x="50%" y="50%" font-family="monospace" font-size="18" fill="#fff" text-anchor="middle">cover</text></svg>`
+      ),
+  },
+};
+
+export const LiveMusicKind: Story = {
+  args: {
+    title: "Jazz at the Basement",
+    meta: "Every Thursday · The Basement · 12 dates",
+    kind: (
+      <>
+        <Music className="h-3 w-3" aria-hidden />
+        Live music
+      </>
+    ),
+  },
+};
+
+export const Clickable: Story = {
+  args: { href: "/events/flying-circus" },
+};
+
+export const Skeleton: Story = {
+  render: () => <ConceptCardSkeleton />,
+};

package/src/components/concept-card.tsx

@@ -0,0 +1,143 @@
+"use client";
+
+import { memo, useState } from "react";
+import { Calendar } from "lucide-react";
+import { cn } from "../lib/utils";
+import { Skeleton } from "./skeleton";
+
+/**
+ * ConceptCard — the recurring-series cover card (e.g. a weekly party
+ * concept), a wide 2:1 image with a bottom scrim carrying a kind pill,
+ * a composed date/venue/count line and the title.
+ *
+ * Same contract as `EventCard`: DS-owned props, plain `<img>`, anchor
+ * whenever `href` is given. Absent `coverUrl` falls back to a flat
+ * `bg-muted` block, same treatment `EventCard` gives a missing poster.
+ */
+
+export type ConceptCardLinkProps = {
+  href: string;
+  className?: string;
+  children: React.ReactNode;
+  onClick?: (mouseEvent: React.MouseEvent) => void;
+};
+
+function DefaultLink({ href, ...props }: ConceptCardLinkProps) {
+  return <a href={href} {...props} />;
+}
+
+export type ConceptCardProps = {
+  title: string;
+  /**
+   * The whole date/venue/count line, composed by the caller, e.g. "Every
+   * Saturday · Flying Circus · 4 dates" — clause order is locale-dependent.
+   */
+  meta: string;
+  /** Label plus its icon, e.g. `<><PartyPopper .../> Party</>`. */
+  kind: React.ReactNode;
+  coverUrl?: string;
+  href?: string;
+  /** Defaults to a plain `<a>`. Pass `next/link` in a Next app. */
+  linkComponent?: React.ComponentType<ConceptCardLinkProps>;
+  onClick?: (mouseEvent: React.MouseEvent) => void;
+  className?: string;
+  /** Forwarded to the cover's `loading` attribute (`"eager"` when true). */
+  priority?: boolean;
+};
+
+export const ConceptCard = memo(function ConceptCard({
+  title,
+  meta,
+  kind,
+  coverUrl,
+  href,
+  linkComponent: LinkComponent = DefaultLink,
+  onClick,
+  className,
+  priority,
+}: ConceptCardProps) {
+  const [imgError, setImgError] = useState(false);
+  const showCover = !!coverUrl && !imgError;
+
+  const body = (
+    <>
+      <div className="absolute inset-0 bg-muted">
+        {showCover && (
+          // eslint-disable-next-line @next/next/no-img-element
+          <img
+            src={coverUrl}
+            alt={title}
+            title={title}
+            loading={priority ? "eager" : "lazy"}
+            decoding="async"
+            className="h-full w-full object-cover"
+            onError={() => setImgError(true)}
+          />
+        )}
+      </div>
+
+      <div className="absolute inset-x-0 bottom-0 z-[1] h-[60%] bg-gradient-to-t from-black/90 via-black/60 to-transparent" />
+
+      <span className="absolute left-2 top-2 z-[2] inline-flex items-center gap-1 rounded-md bg-black/50 px-2 py-1 text-[11px] font-semibold text-white">
+        {kind}
+      </span>
+
+      <div className="relative z-[2] mt-auto flex w-full flex-col gap-0.5 p-2.5 text-white">
+        <div className="flex items-center gap-1 text-[11px] font-medium text-white/85">
+          <Calendar className="h-3 w-3 shrink-0" aria-hidden />
+          <span className="truncate">{meta}</span>
+        </div>
+        <div className="line-clamp-1 text-[14px] font-semibold leading-[1.25]">{title}</div>
+      </div>
+    </>
+  );
+
+  const rootClasses = cn(
+    "relative flex aspect-[2/1] flex-col overflow-hidden rounded-xl text-left",
+    (href || onClick) &&
+      "cursor-pointer focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
+    className
+  );
+
+  if (href) {
+    return (
+      <LinkComponent href={href} className={rootClasses} onClick={onClick}>
+        {body}
+      </LinkComponent>
+    );
+  }
+
+  if (onClick) {
+    return (
+      <button type="button" className={rootClasses} onClick={onClick}>
+        {body}
+      </button>
+    );
+  }
+
+  return <div className={rootClasses}>{body}</div>;
+});
+
+export type ConceptCardSkeletonProps = {
+  className?: string;
+};
+
+export function ConceptCardSkeleton({ className }: ConceptCardSkeletonProps) {
+  return (
+    <div
+      aria-hidden="true"
+      className={cn("relative flex aspect-[2/1] flex-col overflow-hidden rounded-xl", className)}
+    >
+      <Skeleton className="absolute inset-0 rounded-none" />
+
+      <div className="absolute inset-x-0 bottom-0 z-[1] h-[60%] bg-gradient-to-t from-black/90 via-black/60 to-transparent" />
+
+      <Skeleton className="absolute left-2 top-2 z-[2] h-[26px] w-16 rounded-md bg-white/20" />
+
+      <div className="relative z-[2] mt-auto flex w-full flex-col gap-1 p-2.5">
+        <Skeleton className="h-[11px] w-24 bg-white/15" />
+        <Skeleton className="h-[14px] w-2/3 bg-white/20" />
+      </div>
+    </div>
+  );
+}