@bearmenu/ui 0.8.8 → 0.8.9

package/dist/components/menu-types.d.ts

@@ -0,0 +1,245 @@
+import { ComponentType, CSSProperties, ReactNode } from 'react';
+import { MenuSizeAndPrice, PlacePreview } from './place-types.js';
+
+/**
+ * Structural mirror of the openapi `Dish` / `Drink` schemas, decoupled from any
+ * one app's generated types. FE, admin and post-generator map their domain
+ * shapes into these before passing data to the menu-hub surfaces.
+ *
+ * Same contract as `place-types.ts` and `event-types.ts`: no app schemas, no
+ * app hooks, no i18n. Every user-facing string arrives through a `*Labels`
+ * object, every destination through an `href`, and every locale-sensitive
+ * format through an injected formatter — the DS never owns a translation key
+ * or an `Intl` locale.
+ *
+ * ## One set of components, two tabs
+ *
+ * Dishes and drinks are the same shape. `MenuItemPreview.kind` is the only
+ * discriminator, and nothing in this file branches on it — a drinks hub is a
+ * different view model and a different `*Labels` object, never a second set of
+ * components. Anything that would need a `if (kind === 'drink')` inside a
+ * component belongs in the caller's mapper instead.
+ */
+
+/**
+ * The shape every menu surface's `linkComponent` must accept.
+ *
+ * One type rather than a clone per component: these surfaces nest each other —
+ * a family card renders a `<MenuItem>`, a spotlight renders a signature block —
+ * and a caller passes ONE `next/link` down through all of them. Subtly
+ * different clones made those hand-offs fail to typecheck for no design reason.
+ */
+type MenuLinkProps = {
+    href: string;
+    className?: string;
+    'aria-label'?: string;
+    'aria-current'?: 'page';
+    /** Intent tiles paint their hue on the link element itself. */
+    style?: CSSProperties;
+    children?: ReactNode;
+};
+type MenuLinkComponent = ComponentType<MenuLinkProps>;
+/**
+ * A dish or a drink as every hub surface consumes it.
+ *
+ * `mentions` is the census count of review mentions and is populated on every
+ * item in the catalogue — it is the ranking signal the hub is built on. Do not
+ * confuse it with `review_count`, which counts full review objects and is zero
+ * for most items; a surface that ranks on `review_count` renders an empty page.
+ */
+type MenuItemPreview = {
+    id: string;
+    slug: string;
+    name: string;
+    kind: 'dish' | 'drink';
+    description?: string;
+    /** API category code (pizza, pasta, cocktail, non-alcoholic, …). Localised by the caller. */
+    category_slug?: string;
+    sizes_and_prices?: MenuSizeAndPrice[];
+    /** Censused review mentions. The hub's ranking signal. */
+    mentions?: number;
+    /** Full review objects citing this item. Sparse — not a ranking signal. */
+    review_count?: number;
+    /** 0–100 recommendation score. */
+    score?: number;
+    /** The venue serving it. Menu items are always venue-scoped. */
+    place?: MenuItemPlaceRef;
+    /**
+     * Pre-resolved photo URL. Menu-item photography is AI-generated and hidden in
+     * production, so hub surfaces draw a typographic `<MenuFieldTile>` instead
+     * and leave this unset. It exists for the surfaces that legitimately show one
+     * (concept detail) and for consumers outside the consumer app.
+     */
+    photo_url?: string;
+};
+/** The venue attribution carried on a menu item. */
+type MenuItemPlaceRef = {
+    slug: string;
+    name: string;
+    /** Pre-resolved venue thumbnail. Venue photography is real; item photography is not. */
+    thumbnail_url?: string;
+};
+/**
+ * A dish or drink concept — one item across every kitchen that makes it, under
+ * whatever name each of them uses. The page's keystone, and the one thing the
+ * catalogue can say that a single menu cannot.
+ */
+type MenuConceptPreview = {
+    slug: string;
+    /** Canonical concept name, e.g. "Margherita". */
+    title: string;
+    kind: 'dish' | 'drink';
+    /** Venues serving it. */
+    venue_count?: number;
+    price_low?: number;
+    price_high?: number;
+    /** Distinct names it appears under across those menus. */
+    alias_count?: number;
+    /** Summed censused mentions across every venue's version. */
+    mentions?: number;
+    rows?: MenuConceptRow[];
+};
+/** One venue's version of a concept, as drawn by `<ConceptCompare>`. */
+type MenuConceptRow = {
+    place_slug: string;
+    place_name: string;
+    /** What this kitchen calls it on its own menu. */
+    alias: string;
+    price: number;
+    mentions?: number;
+    rating?: number;
+    /** Venue type line, e.g. "pub". Localised by the caller. */
+    place_type?: string;
+    /** Neighbourhood, e.g. "Centru". */
+    place_area?: string;
+    /**
+     * Pre-resolved VENUE photograph.
+     *
+     * The row is place-led: five restaurants that disagree about a name, not five
+     * bars of similar length. A price bar was drawn here first and it measured
+     * the one thing already written beside it in words, while the venue — the
+     * thing you are actually choosing between — had no image at all.
+     */
+    place_thumbnail_url?: string;
+    open_now?: boolean;
+    /** Marks the row the surface should lead with (cheapest, or most named). */
+    featured?: boolean;
+    /** Portion, already formatted with its unit, e.g. "260g". */
+    portion_label?: string;
+};
+/**
+ * A browsable grouping of venues — a cuisine on the dishes tab, a drink family
+ * on the drinks tab. Both are sets of VENUES, never sets of items: cuisine
+ * exists only on places, so a card counting dishes cannot be built.
+ */
+type MenuFamilyPreview = {
+    slug: string;
+    /** Display name, already localised by the caller. */
+    name: string;
+    /** Venues in this family. */
+    venue_count: number;
+    /**
+     * Facet chips. Counts are VENUES, not items — they come from the places
+     * facet narrowed by this family. The drinks tab has no equivalent facet, so
+     * its chips ship without counts; `count` is optional for that reason.
+     */
+    chips?: MenuFamilyChip[];
+    /** Price band across the family's venues. */
+    price_low?: number;
+    price_high?: number;
+    price_median?: number;
+    /** Pre-resolved venue photos for the fanned deck. Venue photography only. */
+    venue_photo_urls?: string[];
+    /** The item this family is most named for. */
+    signature?: MenuFamilySignature;
+};
+type MenuFamilyChip = {
+    slug: string;
+    label: string;
+    /** Venue count. Absent where no facet backs the chip. */
+    count?: number;
+};
+/** A family card's featured item. Same shape as a venue's, for the same reason. */
+type MenuFamilySignature = MenuVenueSignature;
+/**
+ * A venue as the hub's venue-scoped surfaces consume it: the place itself plus
+ * the pre-resolved bits a hub row needs and `PlacePreview` does not carry —
+ * which signature to lead with, and where the row points.
+ */
+type MenuVenuePreview = {
+    place: PlacePreview;
+    href: string;
+    /**
+     * The signature to draw. Callers pick it from `reviews_digest.must_try`
+     * rather than the surface re-deriving the rule on every row.
+     */
+    signature?: MenuVenueSignature;
+    /** Closing time as an already-formatted wall clock, e.g. "23:00". */
+    closes_at_label?: string;
+};
+/**
+ * The resolved signature on a venue row.
+ *
+ * It carries a whole `MenuItemPreview` rather than a flattened name and price,
+ * because every surface that draws one renders `<MenuItem>` — the same row a
+ * venue's own menu uses — and that component takes an item. Flattening it here
+ * was what let the hub's version drift into a different-looking row.
+ */
+type MenuVenueSignature = {
+    item: MenuItemPreview;
+    /** The reviewers' reason, from the digest. Rendered in place of the description. */
+    why?: string;
+    href?: string;
+    /** The digest called this the venue's signature rather than merely frequent. */
+    isSignature?: boolean;
+};
+/**
+ * An intent tile — a family plus a constraint, resolving to a category page.
+ *
+ * Only about thirty-two of the thirty-eight cuisines have a page, so `href` is
+ * required: a tile that cannot resolve to a real destination is not rendered
+ * rather than linking nowhere.
+ */
+type MenuIntentTile = {
+    slug: string;
+    label: string;
+    /** Supporting line, e.g. "247 kitchens". Already formatted by the caller. */
+    caption?: string;
+    href: string;
+    /**
+     * Finished CSS gradient for the tile's ground, e.g.
+     * `linear-gradient(150deg, …)`.
+     *
+     * A gradient rather than a token name, for the same reason `<MenuField>`
+     * takes one: the hue tables are app-owned, and a component referencing
+     * `var(--h-pizza)` renders an invisible tile in any consumer that does not
+     * happen to define that variable. A missing gradient falls back to `bg-muted`
+     * — visible and obviously unstyled, rather than white text on white.
+     */
+    gradient?: string;
+    /** Icon node, resolved by the caller — the DS does not pick icons for it. */
+    icon?: ReactNode;
+};
+/** Formatters injected into every menu surface. The DS owns no `Intl` locale. */
+type MenuFormatters = {
+    /** 24 → "24 lei". */
+    price: (value: number) => string;
+    /** 1717 → "1,717". */
+    number: (value: number) => string;
+};
+/** Strings shared by every menu-hub surface. */
+type MenuHubLabels = {
+    /** Mention-count badge. Pass a translator that handles ICU pluralization. */
+    mentions: (count: number) => string;
+    /** Venue-count line. Pass a translator that handles ICU pluralization. */
+    venues: (count: number) => string;
+    /** "See all" affordance on a section header. */
+    seeAll: string;
+    /** Badge on a must-try row the digest called `signature`. */
+    signature: string;
+    openNow: string;
+    /** Prefixes a closing time, e.g. "until". */
+    until: string;
+};
+
+export { type MenuConceptPreview, type MenuConceptRow, type MenuFamilyChip, type MenuFamilyPreview, type MenuFamilySignature, type MenuFormatters, type MenuHubLabels, type MenuIntentTile, type MenuItemPlaceRef, type MenuItemPreview, type MenuLinkComponent, type MenuLinkProps, MenuSizeAndPrice, type MenuVenuePreview, type MenuVenueSignature };

package/dist/components/menu-types.js

@@ -0,0 +1 @@
+

package/dist/components/motion-icon-set.js

@@ -40,12 +40,14 @@ function MotionHouse(props) {
 }
 var UTENSILS_TIMES = [0, 0.18, 0.72, 1];
 var SEPARATION = 5;
+var FORK_LIFT = -1.5;
 var fork = {
-  rest: { rotate: 0, x: 0, transition: returnTransition },
-  active: { rotate: -44, x: -SEPARATION, transition: returnTransition },
+  rest: { rotate: 0, x: 0, y: 0, transition: returnTransition },
+  active: { rotate: -44, x: -SEPARATION, y: FORK_LIFT, transition: returnTransition },
   play: {
     rotate: [0, 6, -50, -44],
     x: [0, 0.8, -6, -SEPARATION],
+    y: [0, 0, FORK_LIFT - 0.3, FORK_LIFT],
     transition: beats(UTENSILS_TIMES, 0.6)
   }
 };
@@ -59,6 +61,16 @@ var knife = {
   }
 };
 var CROSSING = { originX: "12px", originY: "12px" };
+var HANDLE_CROSSED = "M2.1 21.8 8.5 15.4";
+var HANDLE_CLEAR = "M2.1 21.8 12 12";
+var forkHandle = {
+  rest: { d: HANDLE_CROSSED, transition: returnTransition },
+  active: { d: HANDLE_CLEAR, transition: returnTransition },
+  play: {
+    d: [HANDLE_CROSSED, HANDLE_CROSSED, HANDLE_CLEAR, HANDLE_CLEAR],
+    transition: beats(UTENSILS_TIMES, 0.6)
+  }
+};
 function MotionUtensils(props) {
   return /* @__PURE__ */ jsxs(MotionIcon, __spreadProps(__spreadValues({}, props), { children: [
     /* @__PURE__ */ jsx(
@@ -71,7 +83,7 @@ function MotionUtensils(props) {
     ),
     /* @__PURE__ */ jsxs(motion.g, { variants: fork, style: CROSSING, children: [
       /* @__PURE__ */ jsx("path", { d: "m16 2-2.3 2.3a3 3 0 0 0 0 4.2l1.8 1.8a3 3 0 0 0 4.2 0L22 8" }),
-      /* @__PURE__ */ jsx("path", { d: "m2.1 21.8 6.4-6.3" }),
+      /* @__PURE__ */ jsx(motion.path, { variants: forkHandle, d: HANDLE_CROSSED }),
       /* @__PURE__ */ jsx("path", { d: "m19 5-7 7" })
     ] })
   ] }));

package/dist/components/open-now-list.d.ts

@@ -0,0 +1,40 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { MenuVenuePreview, MenuLinkComponent, MenuLinkProps } from './menu-types.js';
+import 'react';
+import './place-types.js';
+
+/**
+ * OpenNowList — who is still serving, and until when.
+ *
+ * At half past ten this beats every other sort, which is why it is its own
+ * surface rather than a filter chip: the question is not "what is good" but
+ * "what is possible", and every other module on a hub answers the first one.
+ *
+ * The closing time arrives pre-formatted on the view model (`closes_at_label`)
+ * because the venue's own trading day can cross midnight — a bar closing at
+ * 04:00 closes on the following date — and resolving that needs the venue's
+ * timezone and the reader's clock, neither of which the DS has.
+ *
+ * The live dot is never the only signal that a venue is open: the closing pill
+ * carries the same fact in words, so the row reads without colour.
+ *
+ * Server-safe.
+ */
+/** @deprecated Alias of `MenuLinkProps`; kept so existing imports keep working. */
+type OpenNowListLinkProps = MenuLinkProps;
+type OpenNowListProps = {
+    venues: MenuVenuePreview[];
+    /** Prefix on the closing pill, e.g. "until". */
+    untilLabel: string;
+    /** Composed meta line per venue, keyed by place slug, e.g. "pub · Centru". */
+    metaLabels?: Record<string, string>;
+    /** What the kitchen is still sending out, keyed by place slug. */
+    summaryLabels?: Record<string, string>;
+    /** Composed price band per venue, keyed by place slug, e.g. "19—62 lei". */
+    priceBandLabels?: Record<string, string>;
+    linkComponent?: MenuLinkComponent;
+    className?: string;
+};
+declare function OpenNowList({ venues, untilLabel, metaLabels, summaryLabels, priceBandLabels, linkComponent: LinkComponent, className, }: OpenNowListProps): react_jsx_runtime.JSX.Element;
+
+export { OpenNowList, type OpenNowListLinkProps, type OpenNowListProps };

package/dist/components/open-now-list.js

@@ -0,0 +1,69 @@
+import { Separator } from '../chunk-WSRWFA6K.js';
+import { cn } from '../chunk-FEK5XGZW.js';
+import { __objRest, __spreadValues } from '../chunk-3GWWZKX7.js';
+import { Clock, ChevronRight } from 'lucide-react';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+function DefaultLink(_a) {
+  var _b = _a, { href } = _b, props = __objRest(_b, ["href"]);
+  return /* @__PURE__ */ jsx("a", __spreadValues({ href }, props));
+}
+function OpenNowList({
+  venues,
+  untilLabel,
+  metaLabels,
+  summaryLabels,
+  priceBandLabels,
+  linkComponent: LinkComponent = DefaultLink,
+  className
+}) {
+  return /* @__PURE__ */ jsx("ul", { className: cn("flex flex-col", className), children: venues.map((venue, index) => {
+    const { place } = venue;
+    return /* @__PURE__ */ jsxs("li", { children: [
+      index > 0 && /* @__PURE__ */ jsx(Separator, {}),
+      /* @__PURE__ */ jsxs(
+        LinkComponent,
+        {
+          href: venue.href,
+          className: "flex flex-wrap items-center gap-x-3 gap-y-1.5 py-3 transition-colors hover:bg-muted/40 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring",
+          children: [
+            /* @__PURE__ */ jsxs("span", { className: "relative h-14 w-14 shrink-0 overflow-hidden rounded-xl bg-[repeating-linear-gradient(135deg,oklch(0.78_0.018_55)_0_8px,oklch(0.84_0.012_58)_8px_16px)]", children: [
+              place.thumbnail_url && // eslint-disable-next-line @next/next/no-img-element
+              /* @__PURE__ */ jsx(
+                "img",
+                {
+                  src: place.thumbnail_url,
+                  alt: "",
+                  className: "h-full w-full object-cover",
+                  loading: "lazy"
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                "i",
+                {
+                  "aria-hidden": true,
+                  className: "absolute right-1 top-1 h-[7px] w-[7px] rounded-full bg-[var(--free,currentColor)] ring-2 ring-white/80"
+                }
+              )
+            ] }),
+            /* @__PURE__ */ jsxs("span", { className: "min-w-0 flex-1", children: [
+              /* @__PURE__ */ jsx("span", { className: "block text-sm font-bold leading-snug tracking-[-0.01em]", children: place.name }),
+              (metaLabels == null ? void 0 : metaLabels[place.slug]) && /* @__PURE__ */ jsx("span", { className: "mt-px block truncate text-[11.5px] text-muted-foreground", children: metaLabels[place.slug] })
+            ] }),
+            (summaryLabels == null ? void 0 : summaryLabels[place.slug]) && /* @__PURE__ */ jsx("span", { className: "order-last w-full truncate text-[12.5px] text-muted-foreground lg:order-none lg:w-auto lg:flex-1", children: summaryLabels[place.slug] }),
+            (venue.closes_at_label || (priceBandLabels == null ? void 0 : priceBandLabels[place.slug])) && /* @__PURE__ */ jsxs("span", { className: "flex shrink-0 flex-col items-end gap-1 lg:flex-row lg:items-center lg:gap-3", children: [
+              (priceBandLabels == null ? void 0 : priceBandLabels[place.slug]) && /* @__PURE__ */ jsx("span", { className: "text-[12.5px] tabular-nums text-muted-foreground", children: priceBandLabels[place.slug] }),
+              venue.closes_at_label && /* @__PURE__ */ jsxs("span", { className: "inline-flex h-6 items-center gap-1 rounded-full bg-[var(--free-subtle,var(--accent-subtle))] px-2.5 text-[11.5px] font-semibold tabular-nums", children: [
+                /* @__PURE__ */ jsx(Clock, { className: "h-[11px] w-[11px]", "aria-hidden": true }),
+                `${untilLabel} ${venue.closes_at_label}`
+              ] })
+            ] }),
+            /* @__PURE__ */ jsx(ChevronRight, { className: "h-4 w-4 shrink-0 text-muted-foreground", "aria-hidden": true })
+          ]
+        }
+      )
+    ] }, place.slug);
+  }) });
+}
+
+export { OpenNowList };

package/dist/components/place-types.d.ts

@@ -47,6 +47,13 @@ type PlacePreview = {
         hour: number;
         score: number;
     }>;
+    /**
+     * The review distillation. Drives every menu-hub surface that speaks for a
+     * venue — `<VenueSpotlight>`, `<RankedVenueList>`, `<SignatureLineList>` —
+     * because the signature dish, the pull-quotes and the graded dimensions all
+     * live here rather than on the menu itself.
+     */
+    reviews_digest?: PlaceReviewsDigest;
     type?: string;
     business_status?: 'operational' | 'closed_temporarily' | 'closed_permanently';
     phone?: string;
@@ -71,6 +78,110 @@ type PlaceSchedule = Record<WeekdayKey, PlaceHourBlock[]>;
 type PlacePriceRange = {
     price_range_low?: number;
     price_range_high?: number;
+    /** Median price across the place's menu, in the local currency. */
+    median_price?: number;
+};
+/**
+ * Menu items are priced per size; a single-size item still ships one entry.
+ *
+ * Defined here rather than in `menu-types.ts` because `PlaceMustTry` carries
+ * it, and `menu-types.ts` already imports from this file — keeping the
+ * definition here leaves that import one-directional. `menu-types.ts`
+ * re-exports it, so menu code never reaches into place types for it.
+ */
+type MenuSizeAndPrice = {
+    /** Grams or millilitres. */
+    size: number;
+    price: number;
+    discounted_price?: number;
+    discount_percentage?: number;
+};
+/** A digest string with the reviews that back it. `review_ids.length` is the mention count. */
+type CitedText = {
+    text: string;
+    review_ids?: string[];
+};
+/** A digest enum value with the reviews that back it. The value is a language-neutral code. */
+type CitedValue = {
+    value: string;
+    review_ids?: string[];
+};
+/**
+ * One dish or drink the reviews single out.
+ *
+ * `mentions` and `score` come from the item census and are only served by the
+ * place DETAIL endpoint — a listing carries the item without them. Surfaces
+ * that need a count from a list fall back to `review_ids.length`, which is
+ * present in both. `strength`, `why` and `review_ids` are absent for census
+ * items the prose digest never mentioned, so none of them can be assumed.
+ */
+type PlaceMustTry = {
+    name: string;
+    why?: string;
+    strength?: 'signature' | 'frequent' | 'occasional';
+    /** Deep-link slug. Present only when the item matched a live menu row. */
+    slug?: string;
+    sizes_and_prices?: MenuSizeAndPrice[];
+    review_ids?: string[];
+    /** 0–100 census sentiment. Detail endpoint only; 3+ mentions required. */
+    score?: number;
+    /** Censused review mentions of this item. Detail endpoint only. */
+    mentions?: number;
+};
+/**
+ * Per-dimension 0–100 review scores.
+ *
+ * A dimension the reviews never mention is ABSENT, not zero — so a surface
+ * drawing these must render what it is given rather than a fixed row of seven.
+ * Exactly one of `food` / `coffee_quality` / `drinks_quality` is scored per
+ * place: a coffee bar has no food score and a restaurant has no coffee one.
+ */
+type PlaceGradeDimensions = {
+    food?: number;
+    coffee_quality?: number;
+    drinks_quality?: number;
+    value?: number;
+    service?: number;
+    cleanliness?: number;
+    ambiance?: number;
+    portion?: number;
+    consistency?: number;
+};
+type PlaceGrade = {
+    /** 1.0–10.0. */
+    overall?: number;
+    /**
+     * Backend recommendation to show the number at all. When false the caller
+     * should draw a "building confidence" state instead — the DS renders what it
+     * is told, it does not apply the rule.
+     */
+    show_number?: boolean;
+    /** Locale-resolved band label, e.g. "Foarte bun". Already translated upstream. */
+    descriptor?: string;
+    confidence?: 'low' | 'medium' | 'high';
+    capped?: boolean;
+    dimensions?: PlaceGradeDimensions;
+};
+type PlaceReviewsDigest = {
+    grade?: PlaceGrade;
+    grade_note?: string;
+    tagline?: CitedText;
+    verdict?: CitedText;
+    caveat?: CitedText;
+    /** 1–3 standout positives. The pull-quotes on `<VenueSpotlight>`. */
+    highlights?: CitedText[];
+    must_try?: PlaceMustTry[];
+    /** Vibe codes (cozy, quiet, family_friendly, …). Localised by the caller. */
+    tags?: CitedValue[];
+    dietary?: CitedValue[];
+    /** small | moderate | generous */
+    portion_size?: CitedValue;
+    /** cheap | fair | mid_range | splurge */
+    value?: CitedValue;
+    /** quiet | moderate | loud */
+    noise_level?: CitedValue;
+    /** Text reviews behind the digest. */
+    review_count?: number;
 };
 /** Labels passed to `<PlaceCard>`. All translation happens in the caller. */
 type PlaceCardLabels = {
@@ -151,4 +262,4 @@ type PlaceDetailsMobileLabels = PlaceAboutTabLabels & {
     noImageAvailable: string;
 };
 
-export type { PlaceAboutTabLabels, PlaceCardLabels, PlaceDetailsMobileLabels, PlaceHourBlock, PlaceLinkKind, PlacePreview, PlacePriceRange, PlaceSchedule, PlaceScheduleWeekLabels, WeekdayKey };
+export type { CitedText, CitedValue, MenuSizeAndPrice, PlaceAboutTabLabels, PlaceCardLabels, PlaceDetailsMobileLabels, PlaceGrade, PlaceGradeDimensions, PlaceHourBlock, PlaceLinkKind, PlaceMustTry, PlacePreview, PlacePriceRange, PlaceReviewsDigest, PlaceSchedule, PlaceScheduleWeekLabels, WeekdayKey };

package/dist/components/ranked-venue-list.d.ts

@@ -0,0 +1,49 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { MenuVenuePreview, MenuLinkComponent, MenuLinkProps } from './menu-types.js';
+import 'react';
+import './place-types.js';
+
+/**
+ * RankedVenueList — venues ordered by how often reviews name their dishes.
+ *
+ * The answer to "best Italian in Cluj", and the reason it is defensible is the
+ * mention count sitting on every row: the order is evidence, not opinion. A
+ * caller that cannot supply mentions should use a different surface rather than
+ * this one with the column blank — an unexplained ranking is worse than none.
+ *
+ * The tab strip re-ranks in place and never navigates, so `activeTab` and
+ * `onTabChange` are controlled by the caller. Omit `tabs` entirely and the
+ * header is just a heading.
+ *
+ * No directive: without `tabs` the list renders on the server, which is the
+ * common case on a hub.
+ */
+/** @deprecated Alias of `MenuLinkProps`; kept so existing imports keep working. */
+type RankedVenueListLinkProps = MenuLinkProps;
+type RankedVenueListTab = {
+    slug: string;
+    label: string;
+};
+type RankedVenueListProps = {
+    venues: MenuVenuePreview[];
+    /** Section heading, e.g. "The kitchens Cluj rates for Italian". */
+    heading?: string;
+    /** The basis of the order, e.g. "by how often reviews name their dishes". */
+    caption?: string;
+    tabs?: RankedVenueListTab[];
+    activeTab?: string;
+    onTabChange?: (slug: string) => void;
+    /** Composed price band per venue, keyed by place slug, e.g. "38—84". */
+    priceBandLabels?: Record<string, string>;
+    /**
+     * The app's own grade per venue slug, already formatted ("8.7"). Shown in
+     * place of the star rating when present — the star is the third-party
+     * fallback for a venue the reviews have not graded yet.
+     */
+    gradeLabels?: Record<string, string>;
+    linkComponent?: MenuLinkComponent;
+    className?: string;
+};
+declare function RankedVenueList({ venues, heading, caption, tabs, activeTab, onTabChange, priceBandLabels, gradeLabels, linkComponent: LinkComponent, className, }: RankedVenueListProps): react_jsx_runtime.JSX.Element;
+
+export { RankedVenueList, type RankedVenueListLinkProps, type RankedVenueListProps, type RankedVenueListTab };

package/dist/components/ranked-venue-list.js

@@ -0,0 +1,87 @@
+import { Separator } from '../chunk-WSRWFA6K.js';
+import { cn } from '../chunk-FEK5XGZW.js';
+import { __objRest, __spreadValues } from '../chunk-3GWWZKX7.js';
+import { MessageSquare, Star, ChevronRight } from 'lucide-react';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+function DefaultLink(_a) {
+  var _b = _a, { href } = _b, props = __objRest(_b, ["href"]);
+  return /* @__PURE__ */ jsx("a", __spreadValues({ href }, props));
+}
+function RankedVenueList({
+  venues,
+  heading,
+  caption,
+  tabs,
+  activeTab,
+  onTabChange,
+  priceBandLabels,
+  gradeLabels,
+  linkComponent: LinkComponent = DefaultLink,
+  className
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: cn("overflow-hidden rounded-[14px] border border-border bg-card", className), children: [
+    (heading || tabs) && /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-x-4 gap-y-2 border-b border-border p-3.5", children: [
+      heading && /* @__PURE__ */ jsx("h3", { className: "text-[15px] font-bold leading-tight tracking-[-0.01em]", children: heading }),
+      caption && /* @__PURE__ */ jsx("span", { className: "text-[12.5px] text-muted-foreground", children: caption }),
+      tabs && tabs.length > 0 && /* @__PURE__ */ jsx("div", { className: "ml-auto flex flex-wrap gap-1.5", children: tabs.map((tab) => /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          "aria-pressed": tab.slug === activeTab,
+          onClick: () => onTabChange == null ? void 0 : onTabChange(tab.slug),
+          className: cn(
+            "inline-flex h-7 items-center rounded-full border px-2.5 text-xs font-semibold transition-colors",
+            tab.slug === activeTab ? "border-accent bg-accent-subtle text-accent" : "border-border text-muted-foreground hover:bg-muted/50"
+          ),
+          children: tab.label
+        },
+        tab.slug
+      )) })
+    ] }),
+    /* @__PURE__ */ jsx("ol", { children: venues.map((venue, index) => {
+      var _a;
+      const { place, signature } = venue;
+      const mentions = (_a = signature == null ? void 0 : signature.item.mentions) != null ? _a : 0;
+      return /* @__PURE__ */ jsxs("li", { children: [
+        index > 0 && /* @__PURE__ */ jsx(Separator, {}),
+        /* @__PURE__ */ jsxs(
+          LinkComponent,
+          {
+            href: venue.href,
+            className: "flex items-center gap-3 p-3 transition-colors hover:bg-muted/40 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring",
+            children: [
+              /* @__PURE__ */ jsx("span", { className: "w-4 shrink-0 text-center text-[13px] font-extrabold tabular-nums text-accent", children: index + 1 }),
+              /* @__PURE__ */ jsx("span", { className: "h-12 w-12 shrink-0 overflow-hidden rounded-xl bg-[repeating-linear-gradient(135deg,oklch(0.78_0.018_55)_0_8px,oklch(0.84_0.012_58)_8px_16px)]", children: place.thumbnail_url && // eslint-disable-next-line @next/next/no-img-element
+              /* @__PURE__ */ jsx(
+                "img",
+                {
+                  src: place.thumbnail_url,
+                  alt: "",
+                  className: "h-full w-full object-cover",
+                  loading: "lazy"
+                }
+              ) }),
+              /* @__PURE__ */ jsxs("span", { className: "min-w-0 flex-1", children: [
+                /* @__PURE__ */ jsx("span", { className: "block text-sm font-bold leading-snug tracking-[-0.01em]", children: place.name }),
+                (signature == null ? void 0 : signature.item.name) && /* @__PURE__ */ jsx("span", { className: "mt-px block truncate font-serif text-xs italic text-muted-foreground", children: `\u201C${signature.item.name}\u201D` })
+              ] }),
+              mentions > 0 && /* @__PURE__ */ jsxs("span", { className: "hidden shrink-0 items-center gap-1 text-[11.5px] tabular-nums text-muted-foreground sm:inline-flex", children: [
+                /* @__PURE__ */ jsx(MessageSquare, { className: "h-[11px] w-[11px]", "aria-hidden": true }),
+                mentions
+              ] }),
+              (gradeLabels == null ? void 0 : gradeLabels[place.slug]) ? /* @__PURE__ */ jsx("span", { className: "inline-flex h-6 shrink-0 items-center rounded-md bg-foreground px-1.5 text-[12px] font-extrabold tabular-nums text-background", children: gradeLabels[place.slug] }) : place.rating && /* @__PURE__ */ jsxs("span", { className: "inline-flex shrink-0 items-center gap-1 text-[12.5px] font-semibold tabular-nums", children: [
+                /* @__PURE__ */ jsx(Star, { className: "h-3 w-3", "aria-hidden": true }),
+                place.rating.rating
+              ] }),
+              (priceBandLabels == null ? void 0 : priceBandLabels[place.slug]) && /* @__PURE__ */ jsx("span", { className: "hidden shrink-0 text-[12.5px] tabular-nums text-muted-foreground sm:block", children: priceBandLabels[place.slug] }),
+              /* @__PURE__ */ jsx(ChevronRight, { className: "h-4 w-4 shrink-0 text-muted-foreground", "aria-hidden": true })
+            ]
+          }
+        )
+      ] }, place.slug);
+    }) })
+  ] });
+}
+
+export { RankedVenueList };