@bearmenu/ui 0.8.8 → 0.8.10

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 };

package/dist/components/menu-family-block.js

@@ -0,0 +1,155 @@
+import { MenuKitchenList } from '../chunk-24RFI4RQ.js';
+import { HueChip } from '../chunk-CLLY6XB3.js';
+import { Separator } from '../chunk-WSRWFA6K.js';
+import { PhotoGround, PHOTO_GROUND } from '../chunk-5RWTOT5Y.js';
+import { Skeleton } from '../chunk-QXHMPJ35.js';
+import { cn } from '../chunk-FEK5XGZW.js';
+import { __objRest, __spreadValues } from '../chunk-3GWWZKX7.js';
+import { Wallet } 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 MOSAIC_TILES = 6;
+var PHONE_TILES = 4;
+var GROUND = PHOTO_GROUND;
+var FROST = "backdrop-blur-xl [mask-image:linear-gradient(to_bottom,transparent_0%,black_42%)] lg:[mask-image:linear-gradient(to_right,transparent_36%,black_54%)]";
+var INK = "bg-[linear-gradient(to_bottom,oklch(0.16_0.012_55_/_0.42)_0%,oklch(0.16_0.012_55_/_0.6)_30%,oklch(0.16_0.012_55_/_0.9)_48%,oklch(0.16_0.012_55_/_0.96)_100%)] lg:bg-[linear-gradient(to_right,oklch(0.16_0.012_55_/_0.38)_0%,oklch(0.16_0.012_55_/_0.6)_30%,oklch(0.16_0.012_55_/_0.92)_46%,oklch(0.16_0.012_55_/_0.96)_100%)]";
+var TEXT_SCRIM = (
+  /* `isolate` + `before:-z-10`: a positioned pseudo-element paints ABOVE the
+     column's in-flow text unless the column is its own stacking context and
+     the layer is ordered beneath. Without `isolate`, `-z-10` would instead
+     drop it behind the card's mosaic — inside the article's context. */
+  "isolate before:pointer-events-none before:absolute before:inset-x-0 before:bottom-0 before:top-[30%] before:-z-10 before:bg-[linear-gradient(to_bottom,oklch(0.16_0.012_55_/_0)_0%,oklch(0.16_0.012_55_/_0.55)_45%,oklch(0.16_0.012_55_/_0.8)_100%)] before:content-['']"
+);
+function MenuFamilyBlock({
+  family,
+  labels,
+  formatCount = String,
+  hue,
+  gradient,
+  linkComponent: LinkComponent = DefaultLink,
+  className
+}) {
+  var _a, _b, _c, _d, _e;
+  const photos = ((_a = family.photoUrls) != null ? _a : []).slice(0, MOSAIC_TILES);
+  const overflow = Math.max(family.venueCount - photos.length, 0);
+  const initial = ((_c = (_b = family.name.match(new RegExp("\\p{L}", "u"))) == null ? void 0 : _b[0]) != null ? _c : "").toLocaleUpperCase();
+  const venues = (_d = family.venues) != null ? _d : [];
+  return /* @__PURE__ */ jsxs(
+    "article",
+    {
+      className: cn(
+        /* `isolate` confines the blend and the backdrop-filter to this card.
+           `dark` scopes every token inside to its dark-theme value. */
+        "dark relative isolate overflow-hidden rounded-[14px] text-foreground",
+        GROUND,
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsx(
+          PhotoGround,
+          {
+            photos: photos.length > 0 ? photos : [void 0],
+            initials: initial,
+            mosaicClassName: photos.length > 0 ? "grid-cols-2 grid-rows-2 lg:grid-cols-3" : "grid-cols-1",
+            phoneTiles: PHONE_TILES,
+            gradient
+          }
+        ),
+        /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: cn("absolute inset-0", FROST) }),
+        /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: cn("absolute inset-0", INK) }),
+        /* @__PURE__ */ jsxs("div", { className: "relative grid grid-cols-1 lg:grid-cols-[38%_1fr]", children: [
+          /* @__PURE__ */ jsxs("div", { className: cn("relative flex flex-col p-3.5 lg:min-h-[320px] lg:justify-end lg:p-5", TEXT_SCRIM), children: [
+            overflow > 0 && /* @__PURE__ */ jsx("span", { className: "mb-16 self-end rounded-full bg-[oklch(0.16_0.012_55_/_0.72)] px-2.5 py-1 text-[11px] font-semibold text-white backdrop-blur-[2px] lg:mb-3 lg:self-start", children: labels.more(overflow) }),
+            /* @__PURE__ */ jsx("h3", { className: "text-balance font-serif text-[26px] font-semibold leading-tight tracking-[-0.02em] text-white lg:text-[30px]", children: family.name }),
+            /* @__PURE__ */ jsx("span", { className: "mt-0.5 block text-[13px] font-medium tabular-nums text-white/70", children: labels.venueUnit(family.venueCount) }),
+            /* @__PURE__ */ jsx(
+              LinkComponent,
+              {
+                href: family.href,
+                className: "mt-3.5 inline-flex h-10 w-max items-center rounded-full border border-white/20 bg-white/[0.12] px-4 text-[13.5px] font-bold text-white backdrop-blur-md transition-colors hover:bg-white/20 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white motion-reduce:transition-none",
+                children: labels.browse
+              }
+            )
+          ] }),
+          /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-col px-3.5 pb-3.5 lg:p-5", children: [
+            /* @__PURE__ */ jsxs("ul", { className: "flex flex-wrap items-center gap-1.5", children: [
+              family.priceBandLabel && /* No hue: a fact about money, not about the family. In the dark
+                 scope `HueChip`'s `--muted` fallback is the dark pill the design
+                 draws. */
+              /* @__PURE__ */ jsx(
+                HueChip,
+                {
+                  as: "li",
+                  className: "font-bold tabular-nums",
+                  "aria-label": `${labels.priceBand}: ${family.priceBandLabel}`,
+                  icon: /* @__PURE__ */ jsx(Wallet, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground", "aria-hidden": true }),
+                  children: family.priceBandLabel
+                }
+              ),
+              (_e = family.chips) == null ? void 0 : _e.map((chip) => (
+                /* Label only. The counts are VENUES beside a dish group's name,
+                   which every reader takes for dishes. */
+                /* @__PURE__ */ jsx(HueChip, { as: "li", hue, children: chip.label }, chip.slug)
+              ))
+            ] }),
+            venues.length > 0 && /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(Separator, { className: "my-3" }),
+              /* @__PURE__ */ jsx(
+                MenuKitchenList,
+                {
+                  kitchens: venues,
+                  labels: labels.kitchens,
+                  linkComponent: LinkComponent
+                }
+              )
+            ] })
+          ] })
+        ] })
+      ]
+    }
+  );
+}
+function MenuFamilyBlockSkeleton({
+  venues = 3,
+  className
+}) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: cn("dark relative overflow-hidden rounded-[14px]", GROUND, className),
+      "aria-hidden": true,
+      children: /* @__PURE__ */ jsxs("div", { className: "grid grid-cols-1 lg:grid-cols-[38%_1fr]", children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex flex-col p-3.5 lg:min-h-[320px] lg:justify-end lg:p-5", children: [
+          /* @__PURE__ */ jsx(Skeleton, { className: "mb-16 h-6 w-[72px] self-end rounded-full lg:mb-3 lg:self-start" }),
+          /* @__PURE__ */ jsx(Skeleton, { className: "h-7 w-[60%]" }),
+          /* @__PURE__ */ jsx(Skeleton, { className: "mt-2 h-3.5 w-[90px]" }),
+          /* @__PURE__ */ jsx(Skeleton, { className: "mt-3.5 h-10 w-[160px] rounded-full" })
+        ] }),
+        /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-col px-3.5 pb-3.5 lg:p-5", children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex gap-1.5", children: [
+            /* @__PURE__ */ jsx(Skeleton, { className: "h-7 w-[86px] rounded-full" }),
+            /* @__PURE__ */ jsx(Skeleton, { className: "h-7 w-[74px] rounded-full" }),
+            /* @__PURE__ */ jsx(Skeleton, { className: "h-7 w-[66px] rounded-full" })
+          ] }),
+          /* @__PURE__ */ jsx(Separator, { className: "my-3" }),
+          Array.from({ length: venues }, (_, index) => /* @__PURE__ */ jsxs("div", { children: [
+            index > 0 && /* @__PURE__ */ jsx(Separator, {}),
+            /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 py-2.5", children: [
+              /* @__PURE__ */ jsx(Skeleton, { className: "h-[46px] w-[46px] rounded-[11px]" }),
+              /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1.5", children: [
+                /* @__PURE__ */ jsx(Skeleton, { className: "h-3.5 w-[46%]" }),
+                /* @__PURE__ */ jsx(Skeleton, { className: "h-3 w-[58%]" })
+              ] })
+            ] })
+          ] }, index))
+        ] })
+      ] })
+    }
+  );
+}
+
+export { MenuFamilyBlock, MenuFamilyBlockSkeleton };

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

@@ -0,0 +1,65 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { MenuFamilyPreview, MenuLinkComponent, MenuLinkProps } from './menu-types.js';
+import 'react';
+import './place-types.js';
+
+/**
+ * MenuFamilyCard — a browsable grouping of venues: a cuisine on the dishes tab,
+ * a drink family on the drinks tab. The hub's doorway to a family.
+ *
+ * ## A doorway, not a summary
+ *
+ * The cuisines index's `MenuFamilyBlock` is the family's SUMMARY: photography,
+ * chips, a price band and three venues. This card is the same family drawn
+ * one step earlier, in a row of three on the hub, where the reader is choosing
+ * a family and not yet a venue — so it carries the same photography, the same
+ * chips and the same "Browse" action, and lists no venue. A venue on the hub
+ * card was tried and it was the first venue's signature relabelled as the
+ * family's most named, which was a lie at three-card width.
+ *
+ * ## The count does the scanning
+ *
+ * The card is one number, one name and the groups the family consists of,
+ * over a mosaic of its venues. The count is VENUES: cuisine exists on places
+ * and nowhere else — no listing endpoint will tell you how many dishes are
+ * Italian — so a card counting dishes cannot be built and this one does not
+ * try. The chips are plain labels: at three cards across, chips carrying
+ * numbers turned the panel into a table, and the numbers were kitchens, which
+ * nobody reads a chip as.
+ *
+ * ## One link
+ *
+ * The whole card is the link and the "Browse" pill is its visible affordance,
+ * not a second link — a pill inside a link is a nested anchor, and a pill that
+ * is the only link leaves the photography, the number and the name inert.
+ */
+/** @deprecated Alias of `MenuLinkProps`; kept so existing imports keep working. */
+type MenuFamilyCardLinkProps = MenuLinkProps;
+type MenuFamilyCardLabels = {
+    /** Unit under the count, e.g. "KITCHENS". */
+    venueUnit: string;
+    /**
+     * Price-band caption, e.g. "kitchen price band". Never drawn — it names the
+     * pill for a screen reader, which would otherwise be read two numbers and a
+     * currency.
+     */
+    priceBand: string;
+    /** The action pill, e.g. "Browse Italian". Sits on the photography — keep it short. */
+    browse: string;
+};
+type MenuFamilyCardProps = {
+    family: MenuFamilyPreview;
+    labels: MenuFamilyCardLabels;
+    href: string;
+    /** Finished CSS colour for the chips. */
+    hue?: string;
+    /** Finished CSS gradient — the family's colour over the mosaic. */
+    gradient?: string;
+    /** Composed price band, e.g. "32–84 lei". */
+    priceBandLabel?: string;
+    linkComponent?: MenuLinkComponent;
+    className?: string;
+};
+declare function MenuFamilyCard({ family, labels, href, hue, gradient, priceBandLabel, linkComponent: LinkComponent, className, }: MenuFamilyCardProps): react_jsx_runtime.JSX.Element;
+
+export { MenuFamilyCard, type MenuFamilyCardLabels, type MenuFamilyCardLinkProps, type MenuFamilyCardProps };

package/dist/components/menu-family-card.js

@@ -0,0 +1,79 @@
+import { HueChip } from '../chunk-CLLY6XB3.js';
+import { PhotoGround, PHOTO_GROUND } from '../chunk-5RWTOT5Y.js';
+import { cn } from '../chunk-FEK5XGZW.js';
+import { __objRest, __spreadValues } from '../chunk-3GWWZKX7.js';
+import { Wallet } 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));
+}
+var MOSAIC_CELLS = 4;
+var GROUND = PHOTO_GROUND;
+var FROST = "backdrop-blur-xl [mask-image:linear-gradient(to_bottom,transparent_28%,black_58%)]";
+var INK = "bg-[linear-gradient(to_bottom,oklch(0.16_0.012_55_/_0.78)_0%,oklch(0.16_0.012_55_/_0.5)_34%,oklch(0.16_0.012_55_/_0.86)_62%,oklch(0.16_0.012_55_/_0.96)_100%)]";
+function MenuFamilyCard({
+  family,
+  labels,
+  href,
+  hue,
+  gradient,
+  priceBandLabel,
+  linkComponent: LinkComponent = DefaultLink,
+  className
+}) {
+  var _a, _b, _c, _d;
+  const photos = (_a = family.venue_photo_urls) != null ? _a : [];
+  const tiles = photos.length ? Array.from({ length: MOSAIC_CELLS }, (_, cell) => photos[cell % photos.length]) : [void 0];
+  return /* @__PURE__ */ jsxs(
+    LinkComponent,
+    {
+      href,
+      className: cn(
+        "group dark relative isolate flex min-h-[280px] flex-col justify-between overflow-hidden rounded-[14px] border border-border p-3.5",
+        "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-white",
+        GROUND,
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsx(
+          PhotoGround,
+          {
+            className: "-z-30",
+            photos: tiles,
+            initials: family.name.charAt(0),
+            mosaicClassName: photos.length ? "grid-cols-2 grid-rows-2" : "grid-cols-1",
+            gradient
+          }
+        ),
+        /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: cn("absolute inset-0 -z-20", FROST) }),
+        /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: cn("absolute inset-0 -z-10", INK) }),
+        /* @__PURE__ */ jsxs("span", { className: "block text-white", children: [
+          /* @__PURE__ */ jsx("b", { className: "block text-[34px] font-extrabold leading-none tracking-[-0.03em] tabular-nums", children: family.venue_count }),
+          /* @__PURE__ */ jsx("span", { className: "mt-1 block text-[9.5px] font-bold uppercase tracking-[0.12em] opacity-80", children: labels.venueUnit })
+        ] }),
+        /* @__PURE__ */ jsxs("span", { className: "block", children: [
+          /* @__PURE__ */ jsx("span", { className: "block text-balance font-serif text-[24px] font-semibold leading-tight tracking-[-0.02em] text-white", children: family.name }),
+          (priceBandLabel || ((_c = (_b = family.chips) == null ? void 0 : _b.length) != null ? _c : 0) > 0) && /* @__PURE__ */ jsxs("span", { className: "mt-2.5 flex flex-wrap items-center gap-1.5", children: [
+            priceBandLabel && /* No hue: a fact about money, not about the family. In the dark
+               scope `HueChip`'s `--muted` fallback is the dark pill. */
+            /* @__PURE__ */ jsx(
+              HueChip,
+              {
+                className: "font-bold tabular-nums",
+                "aria-label": `${labels.priceBand}: ${priceBandLabel}`,
+                icon: /* @__PURE__ */ jsx(Wallet, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground", "aria-hidden": true }),
+                children: priceBandLabel
+              }
+            ),
+            (_d = family.chips) == null ? void 0 : _d.map((chip) => /* @__PURE__ */ jsx(HueChip, { hue, children: chip.label }, chip.slug))
+          ] }),
+          /* @__PURE__ */ jsx("span", { className: "mt-3.5 inline-flex h-10 items-center rounded-full border border-white/20 bg-white/[0.12] px-4 text-[13.5px] font-bold text-white backdrop-blur-md transition-colors group-hover:bg-white/20 motion-reduce:transition-none", children: labels.browse })
+        ] })
+      ]
+    }
+  );
+}
+
+export { MenuFamilyCard };

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

@@ -0,0 +1,57 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * MenuField — the photoless cover surface for a dish or drink.
+ *
+ * Menu-item photography is AI-generated and never shown, so the item's own name
+ * repeats across a shallow diagonal over a gradient. The type IS the cover.
+ *
+ * The rows fade SYMMETRICALLY out from a single strong row at the centre. That
+ * shape is what keeps the type reading as texture in the colour rather than as
+ * a watermark stamped on top of it: the eye lands on one legible line and the
+ * rest falls away in both directions. A uniform wash — or a random per-row
+ * alpha — reads as noise at every alpha high enough to see.
+ *
+ * The alpha curve is IDENTICAL for every hue. Scaling it per hue to even out
+ * how white type reads over different grounds also moves where rows fall below
+ * visibility, so a damped hue lost rows and one card showed five bands where
+ * its neighbour showed three. Correct contrast in the `gradient` you pass, not
+ * in the curve.
+ *
+ * ## Why `gradient` is a prop
+ *
+ * Resolving a category slug to a hue needs the app's category enums, which the
+ * DS does not take. Callers pass a finished CSS gradient — fe from its own
+ * category-colour table, post-generator from whatever it is filming. The DS
+ * owns the typography and the falloff; the consumer owns the palette.
+ *
+ * Server-safe: no state, no effects. The row geometry is a 13-iteration loop
+ * computed on every render, which is cheaper than the hook that would let it be
+ * skipped.
+ */
+type MenuFieldProps = {
+    /** Item name — rendered as the repeating ghost. */
+    name: string;
+    /** CSS `background-image` value. See the note above on why this is injected. */
+    gradient: string;
+    /**
+     * Deterministic stagger seed. Pass the PARENT CONCEPT SLUG so one dish breaks
+     * its lines identically at every venue and across re-sorts. Defaults to
+     * `name`, which is stable but shared by every venue's version of a dish.
+     */
+    seedKey?: string;
+    /**
+     * `repeat` (default) — the name as texture, thirteen fading rows. Right at
+     * swatch and thumbnail sizes, where any single line would be unreadable.
+     *
+     * `display` — the name ONCE, set large and bled off the edges. Right when the
+     * tile is the primary object on its row and the name is the thing being sold;
+     * the repeat treatment at that size reads as wallpaper rather than as a dish.
+     * Long names clip on purpose — the caption underneath carries the full text.
+     */
+    variant?: "repeat" | "display";
+    className?: string;
+};
+declare function MenuField({ name, gradient, seedKey, variant, className, }: MenuFieldProps): react_jsx_runtime.JSX.Element;
+
+export { MenuField, type MenuFieldProps };

package/dist/components/menu-field.js

@@ -0,0 +1,93 @@
+import { cn } from '../chunk-FEK5XGZW.js';
+import '../chunk-3GWWZKX7.js';
+import { jsx } from 'react/jsx-runtime';
+
+var GHOST_ROWS = 13;
+var GHOST_CENTRE = (GHOST_ROWS - 1) / 2;
+var ALPHA_PEAK = 0.44;
+var ALPHA_EDGE = 0;
+var FALLOFF_EXPONENT = 3.4;
+var GHOST_LINE_CHARS = 56;
+function hashString(input) {
+  let hash = 5381;
+  for (let i = 0; i < input.length; i++) hash = hash * 33 ^ input.charCodeAt(i);
+  return Math.abs(hash);
+}
+function MenuField({
+  name,
+  gradient,
+  seedKey,
+  variant = "repeat",
+  className
+}) {
+  if (variant === "display") {
+    const words = name.trim().split(/\s+/).filter(Boolean);
+    const longestWord = Math.max(1, ...words.map((word) => word.length));
+    const lineCount = Math.max(1, words.length);
+    const byWidth = (96 / (longestWord * 0.62)).toFixed(1);
+    const byHeight = (90 / (lineCount * 0.9)).toFixed(1);
+    const fontSize = `clamp(9cqw, min(19cqw, ${byWidth}cqw, ${byHeight}cqh), 19cqw)`;
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: cn("relative isolate overflow-hidden", className),
+        style: { backgroundImage: gradient, containerType: "size" },
+        children: /* @__PURE__ */ jsx(
+          "span",
+          {
+            "aria-hidden": true,
+            className: "pointer-events-none absolute inset-0 flex select-none items-center justify-center p-[4cqw] text-center font-black uppercase leading-[0.9] tracking-[-0.03em] text-white/[0.26]",
+            style: { fontSize },
+            children: name
+          }
+        )
+      }
+    );
+  }
+  const unit = `${name} \xB7 `;
+  const repeats = Math.max(2, Math.ceil(GHOST_LINE_CHARS / Math.max(unit.length, 1)));
+  const ghostLine = unit.repeat(repeats);
+  const seed = hashString(seedKey != null ? seedKey : name);
+  const rows = Array.from({ length: GHOST_ROWS }, (_, row) => {
+    const distance = Math.abs(row - GHOST_CENTRE) / GHOST_CENTRE;
+    const alpha = ALPHA_EDGE + (ALPHA_PEAK - ALPHA_EDGE) * Math.pow(1 - distance, FALLOFF_EXPONENT);
+    return { row, alpha, offset: (seed >> row % 12) % 90 - 45 };
+  });
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: cn("relative isolate overflow-hidden", className),
+      style: { backgroundImage: gradient },
+      children: /* @__PURE__ */ jsx(
+        "div",
+        {
+          "aria-hidden": true,
+          className: "pointer-events-none absolute left-1/2 top-1/2 flex h-[180%] w-[180%] -translate-x-1/2 -translate-y-1/2 -rotate-[11deg] select-none flex-col justify-center",
+          children: rows.map(({ row, alpha, offset }) => /* @__PURE__ */ jsx(
+            "span",
+            {
+              className: "block whitespace-nowrap text-center text-[15px] font-bold leading-[1.45] tracking-[-0.01em]",
+              style: {
+                color: `oklch(1 0 0 / ${alpha.toFixed(3)})`,
+                // Emboss, both edges scaled by this row's alpha: a dark edge below
+                // cuts the letterform into the field, a light edge above lifts its
+                // top. The dark edge is kept well under the fill — at parity it
+                // ringed every glyph and dragged the type back toward grey, which
+                // is the opposite of what the fill is doing.
+                textShadow: [
+                  `0 1px 1px oklch(0 0 0 / ${(alpha * 0.4).toFixed(3)})`,
+                  `0 -1px 0 oklch(1 0 0 / ${(alpha * 0.4).toFixed(3)})`
+                ].join(", "),
+                transform: `translateX(${offset}px)`
+              },
+              children: ghostLine
+            },
+            row
+          ))
+        }
+      )
+    }
+  );
+}
+
+export { MenuField };