@bearmenu/ui 0.8.9 → 0.8.10

package/dist/components/glass-ground.d.ts

@@ -0,0 +1,66 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * GlassGround — a frosted, inked caption rising out of one edge of a
+ * photograph.
+ *
+ * Layers over a `PhotoGround`: two masked `backdrop-blur`s (the frost) and
+ * an ink gradient (the contrast), running in one direction — absent where the
+ * photograph is the subject, solid where the type is. `MenuFamilyBlock` drew
+ * this first; this is the same idea with the stops as data, so a card can say
+ * "clear for 128px, then glass" without a sixth copy of the gradient strings.
+ *
+ * ## Why two blurs, and why the ramps are eased
+ *
+ * One blur under a linear mask has an edge: the eye reads the line where
+ * sharp becomes soft, however gently the mask fades it in. Two blurs — a
+ * light one that starts early and a heavier one that starts late — make the
+ * softening itself a gradient (the "progressive blur" of a phone's lock
+ * screen), and every ramp here is an ease-in through five stops rather than
+ * a straight line, because a straight ramp has a visible crease at each end
+ * where its slope changes.
+ *
+ * ## Why the stops are custom properties
+ *
+ * Tailwind emits only the classes it can read verbatim, so the gradients
+ * cannot be assembled from props into a class. The classes below are literal
+ * and read `--glass-*` variables; the component writes those inline, having
+ * interpolated the quarter stops in JS (`clear` and `full` must share a
+ * unit). Same mechanism as `HueChip`'s hue. The ink's colour is the
+ * package's one scrim literal, `oklch(0.16 0.012 55)`, never `var(--scrim)`.
+ *
+ * ## The ramp ends where the type begins
+ *
+ * `clear` is where the frost starts, `full` where it and the ink are solid.
+ * Set `full` to the exact seam the content starts at — a ramp that runs past
+ * the seam puts the first row of type on half-frost.
+ */
+type GlassStops = {
+    /** Which way the ink runs — toward the type. */
+    direction: "to bottom" | "to right";
+    /** Where the frost begins, e.g. `"0px"` or `"24%"`. */
+    clear: string;
+    /** Where frost and ink are solid — the seam the content starts at. Same unit as `clear`. */
+    full: string;
+};
+type GlassGroundProps = {
+    stops: GlassStops;
+    /** Stops from `lg`. Omit to keep the same ramp at every width. */
+    lgStops?: GlassStops;
+    /**
+     * How dark the ink gets at the far edge, 0–1. `0.96` is a caption the
+     * photograph is only a texture under; `0.4` is a photograph the caption is
+     * drawn on — the type is lifted, the room stays a room.
+     */
+    peak?: number;
+    /**
+     * How much the frost softens the photograph where it is solid. `xl` turns
+     * a room into colour; `sm` keeps it a room and only takes the edge off the
+     * detail behind the type.
+     */
+    blur?: "sm" | "md" | "lg" | "xl";
+    className?: string;
+};
+declare function GlassGround({ stops, lgStops, peak, blur, className, }: GlassGroundProps): react_jsx_runtime.JSX.Element;
+
+export { GlassGround, type GlassGroundProps, type GlassStops };

package/dist/components/glass-ground.js

@@ -0,0 +1,3 @@
+export { GlassGround } from '../chunk-SY6RV476.js';
+import '../chunk-FEK5XGZW.js';
+import '../chunk-3GWWZKX7.js';

package/dist/components/hub-surface.js

@@ -9,7 +9,17 @@ function HubSurface({ flush, className, children }) {
       className: cn(
         "rounded-[18px] border border-border bg-card shadow-none",
         flush ? "overflow-hidden" : "px-3.5 py-4",
-        "lg:overflow-visible lg:rounded-none lg:bg-transparent lg:p-0 lg:shadow-none",
+        /*
+         * `lg:border-0` is load-bearing and was missing.
+         *
+         * Above `lg` this surface stops being a card — the background, the
+         * radius, the padding and the shadow are all dropped so the section
+         * sits on the page. The border was not, so every section on every
+         * desktop page kept a 1px rectangle around content that no longer had
+         * a card behind it. A caller that genuinely wants an edge at desktop
+         * adds `lg:border` in `className`, which lands after this in `cn`.
+         */
+        "lg:overflow-visible lg:rounded-none lg:border-0 lg:bg-transparent lg:p-0 lg:shadow-none",
         className
       ),
       children

package/dist/components/hue-chip.d.ts

@@ -0,0 +1,70 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * HueChip — a pill that wears a category's colour as a pale wash.
+ *
+ * Menu surfaces label things with a family's hue: a cuisine's dish groups, a
+ * going-out family's tags, a price band. Every one of them was an inline
+ * `style` with a hand-written `color-mix` next to a hand-written pill class
+ * list, which is how the two below drifted apart and how the mix space bug
+ * survived as long as it did — it had to be found and fixed in each copy.
+ *
+ * ## The mix space is the whole reason this is a component
+ *
+ * **`in oklab`, and never `in oklch`.** They describe the same colours, but
+ * oklch is POLAR, so `color-mix(in oklch, …)` interpolates the hue ANGLE — and
+ * the paper being mixed into is achromatic (`--card` is `oklch(1 0 0)`, hue 0).
+ * Mixing 20% of a family colour into that lands at a fifth of the family's hue:
+ * honey 82° came out at 16°, which is pink, so a Breakfast & Brunch card wore
+ * pink chips under an amber mosaic. Cool families were worse — a bar's 205°
+ * blue mixes to 41°, orange; a club's 300° violet to 60°, mustard.
+ *
+ * oklab is rectangular: mixing toward an achromatic base scales chroma along
+ * the SAME hue instead of rotating it, which is what "a pale version of this
+ * colour" has to mean.
+ *
+ * ## Why an inline style and not a Tailwind class
+ *
+ * The hue is DATA — one of ~40 cuisine values resolved by the app at request
+ * time — not one of a fixed set of variants. Tailwind can only emit classes it
+ * can see at build time, so a class-based version would mean either a
+ * safelisted colour per cuisine (a palette that must be edited to add a
+ * cuisine) or an arbitrary-value class built from a runtime string, which
+ * Tailwind cannot compile. A CSS custom property set inline is the honest
+ * mechanism; this component is the one place that writes it.
+ */
+/** Mix strengths, so callers say what a chip IS rather than picking a number. */
+declare const STRENGTH: {
+    /** A labelled facet: readable at 11.5px, still clearly the family's colour. */
+    readonly chip: 20;
+    /** A quieter wash, for a chip that sits beside a stronger one. */
+    readonly subtle: 12;
+};
+type HueChipTone = keyof typeof STRENGTH;
+/**
+ * The tint itself, exported for the surfaces that need the colour rather than
+ * the pill — a section ground, a hover state. Same rule: `in oklab`.
+ */
+declare function hueTint(hue: string, tone?: HueChipTone, base?: string): string;
+type HueChipProps = {
+    /**
+     * A finished CSS colour — the DS owns no category table, so the app resolves
+     * it. Without one the chip falls back to `--muted`, which is the right
+     * neutral for a facet that has no family behind it.
+     */
+    hue?: string;
+    tone?: HueChipTone;
+    /** The paper the wash is mixed into. Must be the surface the chip sits on. */
+    base?: string;
+    /** Drawn before the label, e.g. a wallet on a price band. */
+    icon?: React.ReactNode;
+    /** `li` inside a list, which is where most of these live. */
+    as?: "span" | "li" | "div";
+    children: React.ReactNode;
+    className?: string;
+    /** For a chip whose visible text is a bare figure, e.g. "22–86 lei". */
+    "aria-label"?: string;
+};
+declare function HueChip({ hue, tone, base, icon, as: Tag, children, className, "aria-label": ariaLabel, }: HueChipProps): react_jsx_runtime.JSX.Element;
+
+export { HueChip, type HueChipProps, type HueChipTone, hueTint };

package/dist/components/hue-chip.js

@@ -0,0 +1,3 @@
+export { HueChip, hueTint } from '../chunk-CLLY6XB3.js';
+import '../chunk-FEK5XGZW.js';
+import '../chunk-3GWWZKX7.js';

package/dist/components/kitchen-dossier.d.ts

@@ -0,0 +1,88 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { MenuVenueSignature, MenuLinkComponent, MenuLinkProps } from './menu-types.js';
+import { PlacePreview, CitedText, PlaceGradeDimensions } from './place-types.js';
+import { VenueGradeDimensionKey } from './venue-grade-dimensions.js';
+
+/**
+ * KitchenDossier — one kitchen, told as a story on its own photograph.
+ *
+ * The hub used to say this three times: a spotlight with everything the
+ * digest knows, a ranked row with a grade, a card with the signature dish —
+ * and the same kitchen led all three. This is the one card: the venue's
+ * photograph clear at the top, a frosted caption rising from the foot with
+ * the identity (rating, name, type · area · reviews), and under it a PANEL
+ * that says the three or four things the reviews established one at a time —
+ * the dish it is known for, what people say, the grade — with segments at the
+ * top edge showing which is up. The story runs on its own while the card is
+ * in view; a tap advances.
+ *
+ * ## A photograph with a caption, not a dark card
+ *
+ * `ConceptCompare` is a dark card with a photograph showing through two glass
+ * bands. This is the reverse — the room is the subject and the facts are its
+ * caption — which is `GlassGround` at its lightest and smallest: anchored to
+ * the CAPTION, not the card, so it covers the identity, the panel and the
+ * action plus a short lead above them and nothing else; a `sm` blur that
+ * only takes the edge off the detail; ink that never passes 0.45; a text
+ * shadow under the identity doing the rest. Everything above the caption is
+ * the photograph, untouched. The panel is its own glass, so its rule reads
+ * as a panel and not a hole. The same layout at every width; the desktop
+ * card is wider, not turned on its side.
+ *
+ * ## Two targets, and everything else is "next"
+ *
+ * The name and the action open the venue; the dish name in the first part
+ * opens the item. A tap anywhere else on the card advances the story.
+ */
+/** @deprecated Alias of `MenuLinkProps`; kept for symmetry with the other menu surfaces. */
+type KitchenDossierLinkProps = MenuLinkProps;
+type KitchenDossierLabels = {
+    /** Kickers over the three parts. */
+    knownFor: string;
+    whatPeopleSay: string;
+    theGrade: string;
+    /** Currency beside the price, e.g. "lei". */
+    currency: string;
+    /** Beside the mention count, e.g. "4 name it". */
+    mentions: (count: number) => string;
+    /** "427 reviews", composed by the caller. */
+    reviewCount?: string;
+    /** "Open until 22:00", composed by the caller. Omit when closed or unknown. */
+    openUntil?: string;
+    /** Accessible name per segment, e.g. "Part 2 of 3". */
+    part: (index: number, count: number) => string;
+    /** Accessible name of the tap-to-advance. */
+    next: string;
+    /** Dimension key → translated label. */
+    dimensions: Partial<Record<VenueGradeDimensionKey, string>>;
+};
+type KitchenDossierProps = {
+    place: PlacePreview;
+    /** The venue's destination. */
+    href: string;
+    /** "Restaurant · Centru", composed by the caller. */
+    meta?: string;
+    /** Part one. */
+    signature?: MenuVenueSignature;
+    /** Part two — the digest's highlights; two are shown. */
+    quotes?: CitedText[];
+    /** Part three — the grade, with the overall already formatted. */
+    grade?: {
+        overall?: string;
+        dimensions?: PlaceGradeDimensions;
+    };
+    labels: KitchenDossierLabels;
+    formatPrice: (amount: number) => string;
+    /** 0–100 → display numeral. */
+    formatScore: (value: number) => string;
+    /** How long each part shows. */
+    partDurationMs?: number;
+    /** The foot's action — pass a rendered link or button. */
+    action?: ReactNode;
+    linkComponent?: MenuLinkComponent;
+    className?: string;
+};
+declare function KitchenDossier({ place, href, meta, signature, quotes, grade, labels, formatPrice, formatScore, partDurationMs, action, linkComponent: LinkComponent, className, }: KitchenDossierProps): react_jsx_runtime.JSX.Element;
+
+export { KitchenDossier, type KitchenDossierLabels, type KitchenDossierLinkProps, type KitchenDossierProps };

package/dist/components/kitchen-dossier.js

@@ -0,0 +1,187 @@
+import { DIMENSION_ORDER, VenueGradeDimensions } from '../chunk-AKQ57NXY.js';
+import { VenueQuotes } from '../chunk-62ES6N32.js';
+import { StoryProvider, StorySegments, StoryPanel } from '../chunk-F6FMZJDG.js';
+import { GlassGround } from '../chunk-SY6RV476.js';
+import { Separator } from '../chunk-WSRWFA6K.js';
+import { PhotoGround, PHOTO_GROUND } from '../chunk-5RWTOT5Y.js';
+import { cn } from '../chunk-FEK5XGZW.js';
+import { __objRest, __spreadValues } from '../chunk-3GWWZKX7.js';
+import { MessageSquareQuote, Star } from 'lucide-react';
+import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
+
+function DefaultLink(_a) {
+  var _b = _a, { href } = _b, props = __objRest(_b, ["href"]);
+  return /* @__PURE__ */ jsx("a", __spreadValues({ href }, props));
+}
+var GLASS_LEAD = "128px";
+var DIMENSION_LIMIT = 3;
+var QUOTE_LIMIT = 2;
+var initialOf = (name) => {
+  var _a, _b;
+  return ((_b = (_a = name.match(new RegExp("\\p{L}", "u"))) == null ? void 0 : _a[0]) != null ? _b : "").toLocaleUpperCase();
+};
+function KitchenDossier({
+  place,
+  href,
+  meta,
+  signature,
+  quotes,
+  grade,
+  labels,
+  formatPrice,
+  formatScore,
+  partDurationMs,
+  action,
+  linkComponent: LinkComponent = DefaultLink,
+  className
+}) {
+  var _a, _b, _c, _d;
+  const rating = (_a = place.rating) == null ? void 0 : _a.rating;
+  const parts = [];
+  if (signature) {
+    const item = signature.item;
+    const firstEntry = (_b = item.sizes_and_prices) == null ? void 0 : _b[0];
+    const mentions = (_d = (_c = item.mentions) != null ? _c : item.review_count) != null ? _d : 0;
+    parts.push(
+      /* @__PURE__ */ jsxs(Part, { kicker: labels.knownFor, children: [
+        signature.href ? /* @__PURE__ */ jsx(
+          LinkComponent,
+          {
+            href: signature.href,
+            className: "w-max max-w-full text-[16px] font-bold leading-tight tracking-[-0.01em] text-white hover:underline focus-visible:outline-none focus-visible:underline",
+            children: item.name
+          }
+        ) : /* @__PURE__ */ jsx("span", { className: "text-[16px] font-bold leading-tight tracking-[-0.01em] text-white", children: item.name }),
+        signature.why && /* @__PURE__ */ jsx("p", { className: "mt-1 line-clamp-2 font-serif text-[13px] italic leading-snug text-white/75", children: signature.why }),
+        (firstEntry || mentions > 0) && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(Separator, { className: "my-2.5 via-white/20" }),
+          /* @__PURE__ */ jsxs("div", { className: "flex items-end justify-between gap-3", children: [
+            /* @__PURE__ */ jsx("span", { className: "flex items-baseline gap-1.5", children: firstEntry && /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsxs("span", { className: "text-[18px] font-extrabold leading-none tabular-nums text-white", children: [
+                formatPrice(firstEntry.price),
+                /* @__PURE__ */ jsx("span", { className: "ml-1 text-[12px] font-bold", children: labels.currency })
+              ] }),
+              firstEntry.size > 0 && /* @__PURE__ */ jsxs("span", { className: "text-[11.5px] tabular-nums text-white/60", children: [
+                firstEntry.size,
+                item.kind === "dish" ? "g" : "ml"
+              ] })
+            ] }) }),
+            mentions > 0 && /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-1 text-[12px] font-semibold tabular-nums text-white/85", children: [
+              /* @__PURE__ */ jsx(MessageSquareQuote, { className: "h-3.5 w-3.5", "aria-hidden": true }),
+              labels.mentions(mentions)
+            ] })
+          ] })
+        ] })
+      ] }, "signature")
+    );
+  }
+  if (quotes && quotes.length > 0) {
+    parts.push(
+      /* @__PURE__ */ jsx(Part, { kicker: labels.whatPeopleSay, children: /* @__PURE__ */ jsx(VenueQuotes, { quotes, limit: QUOTE_LIMIT, className: "lg:grid-cols-1" }) }, "quotes")
+    );
+  }
+  const dimensions = grade == null ? void 0 : grade.dimensions;
+  const strongest = dimensions ? DIMENSION_ORDER.filter((key) => typeof dimensions[key] === "number").sort((a, b) => {
+    var _a2, _b2;
+    return ((_a2 = dimensions[b]) != null ? _a2 : 0) - ((_b2 = dimensions[a]) != null ? _b2 : 0);
+  }).slice(0, DIMENSION_LIMIT) : [];
+  if (grade && (grade.overall || strongest.length > 0)) {
+    parts.push(
+      /* @__PURE__ */ jsx(Part, { kicker: labels.theGrade, children: /* @__PURE__ */ jsxs("div", { className: "flex items-end gap-4", children: [
+        grade.overall && /* @__PURE__ */ jsx("span", { className: "text-[34px] font-extrabold leading-none tracking-[-0.03em] tabular-nums text-[oklch(0.82_0.15_85)]", children: grade.overall }),
+        dimensions && strongest.length > 0 && /* @__PURE__ */ jsx(
+          VenueGradeDimensions,
+          {
+            className: "min-w-0 flex-1",
+            dimensions,
+            labels: labels.dimensions,
+            order: strongest,
+            formatScore
+          }
+        )
+      ] }) }, "grade")
+    );
+  }
+  return /* @__PURE__ */ jsxs(
+    "article",
+    {
+      className: cn(
+        /* `flex flex-col` so the story fills the card's height: in a rail
+           the cards are stretched to the tallest, and a story that stopped
+           at its own min-height left a band of bare photograph under the
+           action on every shorter card. */
+        "dark relative isolate flex flex-col overflow-hidden rounded-[18px] border border-border text-foreground shadow-[var(--shadow-card)]",
+        PHOTO_GROUND,
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsx(PhotoGround, { className: "-z-20", photos: [place.thumbnail_url], initials: initialOf(place.name), loading: "eager" }),
+        /* @__PURE__ */ jsxs(
+          StoryProvider,
+          {
+            count: parts.length,
+            durationMs: partDurationMs,
+            nextLabel: labels.next,
+            className: "relative flex min-h-[560px] flex-1 flex-col p-4 lg:min-h-[440px] lg:p-5",
+            children: [
+              /* @__PURE__ */ jsx(
+                StorySegments,
+                {
+                  labels: parts.map((_, index) => labels.part(index, parts.length)),
+                  className: "-mt-1"
+                }
+              ),
+              /* @__PURE__ */ jsx("div", { className: "relative min-h-[184px] flex-1", children: labels.openUntil && /* @__PURE__ */ jsxs("span", { className: "absolute left-0 top-3 inline-flex h-[30px] items-center gap-[7px] rounded-full bg-[oklch(0.16_0.012_55_/_0.72)] px-3 text-[11.5px] font-bold text-white backdrop-blur-[2px]", children: [
+                /* @__PURE__ */ jsx("i", { className: "h-[7px] w-[7px] rounded-full bg-success", "aria-hidden": true }),
+                labels.openUntil
+              ] }) }),
+              /* @__PURE__ */ jsxs("div", { className: "relative flex flex-col gap-3.5", children: [
+                /* @__PURE__ */ jsx(
+                  "div",
+                  {
+                    "aria-hidden": true,
+                    className: "pointer-events-none absolute -inset-x-4 -bottom-4 -top-32 -z-10 lg:-inset-x-5 lg:-bottom-5",
+                    children: /* @__PURE__ */ jsx(
+                      GlassGround,
+                      {
+                        stops: { direction: "to bottom", clear: "0px", full: GLASS_LEAD },
+                        peak: 0.4,
+                        blur: "sm"
+                      }
+                    )
+                  }
+                ),
+                /* @__PURE__ */ jsxs("div", { className: "[text-shadow:0_1px_12px_oklch(0_0_0/0.55)]", children: [
+                  /* @__PURE__ */ jsxs("div", { className: "flex items-baseline justify-between gap-4", children: [
+                    /* @__PURE__ */ jsx("h3", { className: "min-w-0 font-serif text-[26px] font-semibold leading-tight tracking-[-0.02em] text-white lg:text-[32px]", children: /* @__PURE__ */ jsx(LinkComponent, { href, className: "focus-visible:outline-none focus-visible:underline", children: place.name }) }),
+                    rating !== void 0 && /* @__PURE__ */ jsxs("span", { className: "inline-flex shrink-0 items-center gap-1 text-[18px] font-extrabold leading-none tabular-nums text-white lg:text-[22px]", children: [
+                      rating.toFixed(1),
+                      /* @__PURE__ */ jsx(Star, { className: "h-3.5 w-3.5 lg:h-4 lg:w-4", "aria-hidden": true })
+                    ] })
+                  ] }),
+                  (meta || labels.reviewCount) && /* @__PURE__ */ jsx("p", { className: "mt-1 truncate text-[12.5px] text-white/70", children: [meta, labels.reviewCount].filter(Boolean).join(" \xB7 ") })
+                ] }),
+                parts.length > 0 && /* @__PURE__ */ jsx(
+                  StoryPanel,
+                  {
+                    parts,
+                    className: "rounded-[14px] border border-white/10 bg-[oklch(0.16_0.012_55_/_0.35)] p-4 backdrop-blur-md"
+                  }
+                ),
+                action && /* @__PURE__ */ jsx("div", { className: "flex [&>*]:w-full lg:[&>*]:w-auto", children: action })
+              ] })
+            ]
+          }
+        )
+      ]
+    }
+  );
+}
+function Part({ kicker, children }) {
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-col", children: [
+    /* @__PURE__ */ jsx("span", { className: "mb-1.5 block text-[9.5px] font-bold uppercase tracking-[0.12em] text-white/60", children: kicker }),
+    children
+  ] });
+}
+
+export { KitchenDossier };

package/dist/components/menu-dead-end.d.ts

@@ -0,0 +1,56 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { MenuLinkComponent, MenuLoosenOption } from './menu-types.js';
+import 'react';
+import './place-types.js';
+
+/**
+ * MenuDeadEnd — what dropped out, and the one press that brings it back.
+ *
+ * A filter combination that returns nothing is the intent page's worst state,
+ * and an empty-state illustration is the worst answer to it: the reader knows
+ * the list is empty, what they do not know is WHICH of their four filters did
+ * it. So this says what dropped out, why, and what widening one specific filter
+ * would restore — with the count, because "+5 kitchens, including the
+ * highest-rated Italian room in the city" is an answer and "try removing a
+ * filter" is a shrug.
+ *
+ * It is also drawn on a NON-empty list, whenever a filter has cost the reader
+ * something notable. The board's case is 34 kitchens still standing and Casa
+ * Boema — the one they came for — missing.
+ *
+ * Interactive: the consumer marks its own module `"use client"`.
+ */
+type MenuDeadEndProps = {
+    /**
+     * The explanation, composed by the caller.
+     *
+     * A node rather than a string because it emphasises real names ("**Casa
+     * Boema** and six others dropped out"), and assembling that from fragments
+     * here would produce translated word-salad in one of the two locales.
+     */
+    children: React.ReactNode;
+    /** The widening this offers, e.g. "Raise to 60 lei · 16 kitchens". */
+    actionLabel?: string;
+    /** Where the widening leads. Preferred over `onAction` — see `MenuLoosenOption.href`. */
+    actionHref?: string;
+    onAction?: () => void;
+    linkComponent?: MenuLinkComponent;
+    className?: string;
+};
+declare function MenuDeadEnd({ children, actionLabel, actionHref, onAction, linkComponent: LinkComponent, className, }: MenuDeadEndProps): react_jsx_runtime.JSX.Element;
+/**
+ * MenuLoosenList — one row per active filter, each priced in kitchens.
+ *
+ * The companion to the panel above: the panel names the single best widening,
+ * this lists every one of them so the reader can choose which constraint they
+ * care least about. Every row states what it would return, because a filter the
+ * reader cannot price is a filter they will not drop.
+ */
+type MenuLoosenListProps = {
+    options: MenuLoosenOption[];
+    linkComponent?: MenuLinkComponent;
+    className?: string;
+};
+declare function MenuLoosenList({ options, linkComponent: LinkComponent, className, }: MenuLoosenListProps): react_jsx_runtime.JSX.Element;
+
+export { MenuDeadEnd, type MenuDeadEndProps, MenuLoosenList, type MenuLoosenListProps };

package/dist/components/menu-dead-end.js

@@ -0,0 +1,49 @@
+import { cn } from '../chunk-FEK5XGZW.js';
+import { __objRest, __spreadValues } from '../chunk-3GWWZKX7.js';
+import { Info } from 'lucide-react';
+import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
+
+function DefaultLink(_a) {
+  var _b = _a, { href } = _b, props = __objRest(_b, ["href"]);
+  return /* @__PURE__ */ jsx("a", __spreadValues({ href }, props));
+}
+function MenuDeadEnd({
+  children,
+  actionLabel,
+  actionHref,
+  onAction,
+  linkComponent: LinkComponent = DefaultLink,
+  className
+}) {
+  const actionClass = "inline-flex h-7 shrink-0 items-center rounded-full bg-foreground px-3 text-[12.5px] font-bold text-background transition-opacity hover:opacity-90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 motion-reduce:transition-none lg:ml-auto";
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "mt-4 flex flex-wrap items-center gap-3 rounded-[14px] bg-muted p-3.5 lg:flex-nowrap lg:gap-4 lg:px-[18px] lg:py-4",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsx(Info, { className: "h-[18px] w-[18px] shrink-0 text-muted-foreground", "aria-hidden": true }),
+        /* @__PURE__ */ jsx("p", { className: "max-w-[560px] text-[13px] leading-[1.55] text-muted-foreground [&_b]:font-bold [&_b]:text-foreground", children }),
+        actionLabel && (actionHref ? /* @__PURE__ */ jsx(LinkComponent, { href: actionHref, className: actionClass, children: actionLabel }) : onAction && /* @__PURE__ */ jsx("button", { type: "button", onClick: onAction, className: actionClass, children: actionLabel }))
+      ]
+    }
+  );
+}
+function MenuLoosenList({
+  options,
+  linkComponent: LinkComponent = DefaultLink,
+  className
+}) {
+  const rowClass = "inline-flex h-9 items-center justify-between gap-3 rounded-full border border-border bg-card px-4 text-sm font-semibold transition-colors hover:border-accent/40 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring motion-reduce:transition-none";
+  return /* @__PURE__ */ jsx("div", { className: cn("flex flex-col gap-2.5", className), children: options.map((option) => {
+    const body = /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("span", { className: "min-w-0 truncate", children: option.label }),
+      /* @__PURE__ */ jsx("span", { className: "shrink-0 font-bold tabular-nums text-accent", children: option.gainLabel })
+    ] });
+    return option.href ? /* @__PURE__ */ jsx(LinkComponent, { href: option.href, className: rowClass, children: body }, option.key) : /* @__PURE__ */ jsx("button", { type: "button", onClick: option.onSelect, className: rowClass, children: body }, option.key);
+  }) });
+}
+
+export { MenuDeadEnd, MenuLoosenList };

package/dist/components/menu-family-block.d.ts

@@ -0,0 +1,99 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { MenuKitchenListLabels } from './menu-kitchen-list.js';
+import { MenuFamilyBlockPreview, MenuLinkComponent, MenuLinkProps } from './menu-types.js';
+import 'react';
+import './place-types.js';
+
+/**
+ * MenuFamilyBlock — the cuisines index's family card. The mosaic is the ground.
+ *
+ * ## Three layers, and everything floats on them
+ *
+ * The grid of venue photographs is the background for the ENTIRE card, edge to
+ * edge, and the facts sit on it. Three layers do the work:
+ *
+ *  1. **The mosaic**, full-bleed, wearing the family's hue through a
+ *     `mix-blend-color` layer.
+ *  2. **A masked backdrop-filter** — absent where the photography is the
+ *     subject, full where the rows begin — so the pictures stay sharp where
+ *     they are looked at and go soft exactly where they are read over.
+ *  3. **An ink gradient** over that. This is what actually buys the contrast:
+ *     frost alone blurs without darkening, and blurred mid-tones will not carry
+ *     16px type.
+ *
+ * On the phone the frost and ink run top to bottom: the name and the action
+ * sit on clear photography, the chips and the rows on the frosted foot. On
+ * desktop the same three layers turn ninety degrees — the photo column on the
+ * left stays clear, the row column on the right is the frosted one. The mosaic
+ * runs 3×2 there rather than 2×2, because at 1110px a four-tile grid makes each
+ * photograph too big to read as texture.
+ *
+ * ## The dark scope
+ *
+ * The card's content region carries the `dark` class, so every token inside —
+ * `text-foreground`, `bg-muted`, `border-border` — resolves to its dark-theme
+ * value. That is how `MenuKitchenList` and `HueChip` render correctly on the
+ * ink without a fork or a "tone" prop: the mechanism the app already uses to
+ * mark a region as dark. It also means the card looks the same in both themes,
+ * which is right — it is built on photography, and photography is not themed.
+ *
+ * ## The two costs, stated
+ *
+ * A `backdrop-filter` over a mask is expensive to composite, and this card is
+ * repeated ten times down a scroll. And the thumbnails now sit on a
+ * photograph; they survive only because the ink is heavy under them, and on a
+ * busy interior shot they will fight. Both were accepted with the design.
+ *
+ * ## No "most named" item, no venue count badge
+ *
+ * The family-level "most named" was the first venue's signature relabelled —
+ * Italian, Pizza and Mediterranean all claimed "Turkish Poached Eggs" — and
+ * the count used to print three times with two values. One count, under the
+ * name; the overflow tile says only how many photographs it stands for.
+ */
+/** @deprecated Alias of `MenuLinkProps`; kept for symmetry with the other menu surfaces. */
+type MenuFamilyBlockLinkProps = MenuLinkProps;
+type MenuFamilyBlockLabels = {
+    /** Unit under the family name, e.g. "247 kitchens". Pluralised by the caller. */
+    venueUnit: (count: number) => string;
+    /** The overflow pill over the mosaic, e.g. "+311 more". */
+    more: (count: number) => string;
+    /**
+     * Price-band caption, e.g. "kitchen price band".
+     *
+     * Never drawn: the band reads as a wallet and a range, and a caption on a
+     * pill that short is longer than the fact. It names the pill for a screen
+     * reader, which would otherwise be read two numbers and a currency.
+     */
+    priceBand: string;
+    /** Main action, e.g. "Browse Italian". Sits on the photography — keep it short. */
+    browse: string;
+    /** Passed through to the venue rows. */
+    kitchens: MenuKitchenListLabels;
+};
+type MenuFamilyBlockProps = {
+    family: MenuFamilyBlockPreview;
+    labels: MenuFamilyBlockLabels;
+    formatCount?: (value: number) => string;
+    /** Finished CSS colour for the chips. */
+    hue?: string;
+    /** Finished CSS gradient — the family's colour over the mosaic. */
+    gradient?: string;
+    linkComponent?: MenuLinkComponent;
+    className?: string;
+};
+declare function MenuFamilyBlock({ family, labels, formatCount, hue, gradient, linkComponent: LinkComponent, className, }: MenuFamilyBlockProps): react_jsx_runtime.JSX.Element;
+/**
+ * The block's own loading state, at the block's footprint.
+ *
+ * The ground is the card's own, so the placeholder is already the dark
+ * surface the photographs will land on — nothing flashes from paper to ink.
+ * `venues` matches the rows the caller will render, so a block showing three
+ * does not settle from a placeholder showing one.
+ */
+declare function MenuFamilyBlockSkeleton({ venues, className, }: {
+    venues?: number;
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+
+export { MenuFamilyBlock, type MenuFamilyBlockLabels, type MenuFamilyBlockLinkProps, type MenuFamilyBlockProps, MenuFamilyBlockSkeleton };