@bearmenu/ui 0.8.8 → 0.8.10

package/dist/components/menu-filter-chips.d.ts

@@ -0,0 +1,86 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { MenuFilterChip } from './menu-types.js';
+import 'react';
+import './place-types.js';
+
+/**
+ * MenuFilterChips — the intent page's filter row.
+ *
+ * ## One unit, one list that moves
+ *
+ * Every chip counts KITCHENS, whatever facet is behind it. A dietary chip reads
+ * "has a vegetarian dish" and counts venues; a dish-group chip reads "has a
+ * pizza" and counts venues. The earlier version mixed venue counts and dish
+ * counts in one row and became unreadable — you could not tell what a number
+ * was counting without reading the label that produced it. The unit is stated
+ * once, at the head of the row (`unitLabel`, e.g. "KITCHENS · 247"), and never
+ * again.
+ *
+ * ## A zero-count chip is dimmed, not disabled
+ *
+ * `empty` chips stay tappable. Pressing one swaps it in and drops whichever
+ * active filter conflicts with it, and the caller says which in a line beneath.
+ * Disabling it would refuse the reader the thing they asked for and give no
+ * reason; this way the row answers the question by being pressed. Facets the
+ * API says are unavailable for this intent are not passed in at all — not
+ * drawn, rather than drawn dead.
+ *
+ * ## The row scrolls; the escape hatch does not
+ *
+ * One line in every state. Chips scroll horizontally under a `<ScrollFade>`,
+ * and "More filters" is pinned opposite the unit label rather than wrapping,
+ * so the way out of a full row is always in the same place.
+ *
+ * Interactive: the consumer marks its own module `"use client"`.
+ */
+type MenuFilterChipsProps = {
+    chips: MenuFilterChip[];
+    onToggle: (key: string) => void;
+    /** The unit and the current total, composed by the caller, e.g. "KITCHENS · 247". */
+    unitLabel?: string;
+    /** Opens the full filter sheet. Omit for a row where every facet is a chip. */
+    onMore?: () => void;
+    moreLabel?: string;
+    /**
+     * A glyph for the phone's icon-only "more filters" button.
+     *
+     * The label is the widest fixed element in the row — "More filters" is ~80px
+     * of a 358px viewport, and it is the one thing that never scrolls, so it eats
+     * the chips' runway on every phone. Given an icon, the button collapses to a
+     * square below `lg` and keeps `moreLabel` as its accessible name.
+     *
+     * A node rather than a name because the app owns its iconography, and this
+     * one is animated on press — the DS neither knows the glyph nor drives it.
+     */
+    moreIcon?: React.ReactNode;
+    /** Press handler for the icon button, e.g. to replay the glyph's animation. */
+    onMorePointerDown?: () => void;
+    /** Locale-aware integer formatter for the counts. Defaults to `String`. */
+    formatCount?: (value: number) => string;
+    /** Accessible name for the row. */
+    ariaLabel?: string;
+    className?: string;
+};
+declare function MenuFilterChips({ chips, onToggle, unitLabel, onMore, moreLabel, moreIcon, onMorePointerDown, formatCount, ariaLabel, className, }: MenuFilterChipsProps): react_jsx_runtime.JSX.Element;
+/**
+ * MenuFilterSummary — what the active filters did, and the way out.
+ *
+ * Sits under the row whenever anything is on. The sentence is composed by the
+ * caller because it is a real sentence in two languages ("Three filters · 34 of
+ * 247 kitchens are mid-range, have a vegetarian Italian dish, and are open
+ * now") and assembling it from fragments here would produce translated
+ * word-salad in one of them.
+ */
+type MenuFilterSummaryProps = {
+    /** The composed sentence. */
+    summary: React.ReactNode;
+    clearLabel: string;
+    onClear: () => void;
+    className?: string;
+};
+declare function MenuFilterSummary({ summary, clearLabel, onClear, className, }: MenuFilterSummaryProps): react_jsx_runtime.JSX.Element;
+declare function MenuFilterChipsSkeleton({ className }: {
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+
+export { MenuFilterChips, type MenuFilterChipsProps, MenuFilterChipsSkeleton, MenuFilterSummary, type MenuFilterSummaryProps };

package/dist/components/menu-filter-chips.js

@@ -0,0 +1,122 @@
+import { ScrollFade } from '../chunk-2XCZJWTV.js';
+import { Skeleton } from '../chunk-QXHMPJ35.js';
+import { cn } from '../chunk-FEK5XGZW.js';
+import '../chunk-3GWWZKX7.js';
+import { X } from 'lucide-react';
+import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
+
+function MenuFilterChips({
+  chips,
+  onToggle,
+  unitLabel,
+  onMore,
+  moreLabel,
+  moreIcon,
+  onMorePointerDown,
+  formatCount = String,
+  ariaLabel,
+  className
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: cn("relative flex items-center gap-2", className), children: [
+    unitLabel && /* @__PURE__ */ jsx("span", { className: "hidden shrink-0 pr-0.5 text-[11px] font-extrabold uppercase tracking-[0.1em] text-muted-foreground lg:inline", children: unitLabel }),
+    /* @__PURE__ */ jsx(
+      ScrollFade,
+      {
+        orientation: "horizontal",
+        size: "sm",
+        className: "min-w-0 flex-1",
+        scrollClassName: "scrollbar-hide",
+        children: /* @__PURE__ */ jsx("div", { className: "flex items-center gap-2", role: "group", "aria-label": ariaLabel, children: chips.map((chip) => /* @__PURE__ */ jsx(
+          Chip,
+          {
+            chip,
+            onToggle: () => onToggle(chip.key),
+            formatCount
+          },
+          chip.key
+        )) })
+      }
+    ),
+    onMore && /* @__PURE__ */ jsxs(Fragment, { children: [
+      moreIcon && /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: onMore,
+          onPointerDown: onMorePointerDown,
+          "aria-label": moreLabel,
+          "aria-haspopup": "dialog",
+          className: "inline-flex size-10 shrink-0 items-center justify-center rounded-full border border-border text-accent transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring motion-reduce:transition-none lg:hidden",
+          children: moreIcon
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: onMore,
+          className: cn(
+            "shrink-0 rounded-md pl-2 text-[12.5px] font-bold text-accent transition-colors hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring motion-reduce:transition-none",
+            moreIcon && "hidden lg:inline"
+          ),
+          children: moreLabel
+        }
+      )
+    ] })
+  ] });
+}
+function Chip({
+  chip,
+  onToggle,
+  formatCount
+}) {
+  return /* @__PURE__ */ jsxs(
+    "button",
+    {
+      type: "button",
+      onClick: onToggle,
+      "aria-pressed": chip.active,
+      className: cn(
+        "inline-flex h-9 shrink-0 items-center gap-1.5 whitespace-nowrap rounded-full border px-4 text-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring motion-reduce:transition-none",
+        chip.active ? "border-accent font-semibold text-accent shadow-[0_1px_2px_oklch(0.51_0.095_45_/_0.08)]" : "border-border bg-card text-foreground hover:border-accent/40",
+        // Dimmed, never disabled — pressing it is how the reader finds out
+        // which active filter is in the way.
+        chip.empty && "opacity-45"
+      ),
+      children: [
+        chip.icon,
+        chip.label,
+        chip.count !== void 0 && /* @__PURE__ */ jsx("span", { className: cn("tabular-nums", chip.active ? "text-accent" : "text-muted-foreground"), children: formatCount(chip.count) }),
+        chip.active && /* @__PURE__ */ jsx(X, { className: "h-3 w-3 shrink-0", "aria-hidden": true })
+      ]
+    }
+  );
+}
+function MenuFilterSummary({
+  summary,
+  clearLabel,
+  onClear,
+  className
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: cn("flex flex-wrap items-center gap-2.5 pt-3.5", className), children: [
+    /* @__PURE__ */ jsx("span", { className: "text-[13px] text-muted-foreground [&_b]:font-bold [&_b]:text-foreground", children: summary }),
+    /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        onClick: onClear,
+        className: "ml-auto shrink-0 rounded-md text-[12.5px] font-bold text-accent transition-colors hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring motion-reduce:transition-none",
+        children: clearLabel
+      }
+    )
+  ] });
+}
+var CHIP_WIDTHS = [128, 104, 96, 148, 112, 88];
+function MenuFilterChipsSkeleton({ className }) {
+  return /* @__PURE__ */ jsxs("div", { className: cn("flex items-center gap-2 overflow-hidden", className), "aria-hidden": true, children: [
+    /* @__PURE__ */ jsx(Skeleton, { className: "h-3 w-[92px] shrink-0" }),
+    CHIP_WIDTHS.map((width, index) => /* @__PURE__ */ jsx(Skeleton, { className: "h-9 shrink-0 rounded-full", style: { width } }, index))
+  ] });
+}
+
+export { MenuFilterChips, MenuFilterChipsSkeleton, MenuFilterSummary };

package/dist/components/menu-group-rows.d.ts

@@ -0,0 +1,53 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { MenuLinkComponent, MenuLinkProps } from './menu-types.js';
+import 'react';
+import './place-types.js';
+
+/**
+ * MenuGroupRows — what an intent consists of.
+ *
+ * On a cuisine page this is the `dish_groups` facet narrowed by the cuisine
+ * ("Pizza · 120 kitchens · 30–68"); on a going-out page it is the digest tags
+ * and graded strengths ("Cocktails · 63 places"). One component for both,
+ * because both are the same object: a facet value, its venue count, and a range.
+ *
+ * ## The counts are VENUES, and the label has to say so
+ *
+ * There is no endpoint that counts dishes per cuisine — `/dishes` accepts
+ * `cuisine_slugs` and ignores it — so "120" here is a hundred and twenty
+ * kitchens that make a pizza, not a hundred and twenty pizzas. The `meta` line
+ * is composed by the caller precisely so that it can say which, in a language
+ * where the two words differ.
+ *
+ * ## Not `<ConceptCard>`
+ *
+ * That one is a cover-led card for a thing with a date and a venue. This is a
+ * row in a sidebar: a hue bar, a name, a count and a range. Giving it a cover
+ * would mean finding a photograph of "pasta", which is the kind of picture that
+ * makes a page look generated.
+ */
+/** @deprecated Alias of `MenuLinkProps`; kept for symmetry with the other menu surfaces. */
+type MenuGroupRowsLinkProps = MenuLinkProps;
+type MenuGroupRow = {
+    slug: string;
+    name: string;
+    /** Venue count line, e.g. "120 kitchens". Pluralised by the caller. */
+    meta: string;
+    /** Price range, already formatted, e.g. "30—68". Omitted where none is known. */
+    rangeLabel?: string;
+    href?: string;
+    /** Finished CSS gradient for the bar. A missing one falls back to the border colour. */
+    gradient?: string;
+};
+type MenuGroupRowsProps = {
+    rows: MenuGroupRow[];
+    linkComponent?: MenuLinkComponent;
+    className?: string;
+};
+declare function MenuGroupRows({ rows, linkComponent: LinkComponent, className, }: MenuGroupRowsProps): react_jsx_runtime.JSX.Element;
+declare function MenuGroupRowsSkeleton({ rows, className, }: {
+    rows?: number;
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+
+export { type MenuGroupRow, MenuGroupRows, type MenuGroupRowsLinkProps, type MenuGroupRowsProps, MenuGroupRowsSkeleton };

package/dist/components/menu-group-rows.js

@@ -0,0 +1,67 @@
+import { Skeleton } from '../chunk-QXHMPJ35.js';
+import { cn } from '../chunk-FEK5XGZW.js';
+import { __objRest, __spreadValues } from '../chunk-3GWWZKX7.js';
+import { ChevronRight } from 'lucide-react';
+import { jsx, jsxs, 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 MenuGroupRows({
+  rows,
+  linkComponent: LinkComponent = DefaultLink,
+  className
+}) {
+  return /* @__PURE__ */ jsx("ul", { className: cn("flex flex-col", className), children: rows.map((row) => {
+    const body = /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(
+        "span",
+        {
+          "aria-hidden": true,
+          className: cn(
+            "h-[34px] w-2 shrink-0 rounded-full",
+            !row.gradient && "bg-border"
+          ),
+          style: row.gradient ? { backgroundImage: row.gradient } : void 0
+        }
+      ),
+      /* @__PURE__ */ jsxs("span", { className: "min-w-0 flex-1", children: [
+        /* @__PURE__ */ jsx("span", { className: "block truncate text-sm font-bold", children: row.name }),
+        /* @__PURE__ */ jsx("span", { className: "mt-px block truncate text-[11.5px] text-muted-foreground", children: row.meta })
+      ] }),
+      row.rangeLabel && /* @__PURE__ */ jsx("span", { className: "shrink-0 font-mono text-xs tabular-nums text-muted-foreground", children: row.rangeLabel }),
+      /* @__PURE__ */ jsx(ChevronRight, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground", "aria-hidden": true })
+    ] });
+    return /* @__PURE__ */ jsx("li", { className: "border-t border-border first:border-t-0", children: row.href ? /* @__PURE__ */ jsx(
+      LinkComponent,
+      {
+        href: row.href,
+        className: "flex items-center gap-3 py-3 transition-colors hover:bg-muted/30 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring motion-reduce:transition-none",
+        children: body
+      }
+    ) : /* @__PURE__ */ jsx("span", { className: "flex items-center gap-3 py-3", children: body }) }, row.slug);
+  }) });
+}
+function MenuGroupRowsSkeleton({
+  rows = 5,
+  className
+}) {
+  return /* @__PURE__ */ jsx("div", { className: cn("flex flex-col", className), "aria-hidden": true, children: Array.from({ length: rows }, (_, index) => /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: "flex items-center gap-3 border-t border-border py-3 first:border-t-0",
+      children: [
+        /* @__PURE__ */ jsx(Skeleton, { className: "h-[34px] w-2 rounded-full" }),
+        /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1.5", children: [
+          /* @__PURE__ */ jsx(Skeleton, { className: "h-3.5 w-[50%]" }),
+          /* @__PURE__ */ jsx(Skeleton, { className: "h-3 w-[35%]" })
+        ] }),
+        /* @__PURE__ */ jsx(Skeleton, { className: "h-3 w-[52px]" })
+      ]
+    },
+    index
+  )) });
+}
+
+export { MenuGroupRows, MenuGroupRowsSkeleton };

package/dist/components/menu-hub-hero.d.ts

@@ -0,0 +1,65 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * MenuHubHero — the claim that opens a menu hub, proven by live figures.
+ *
+ * A statement rather than a count ("Nobody should have to walk in blind"),
+ * over a dark ground, with the catalogue's real numbers under it and one proof
+ * line that demonstrates what the catalogue can do that a single menu cannot.
+ *
+ * ## Why the ground is a texture and not a photograph
+ *
+ * Menu-item photography is AI-generated and never shown, and one venue
+ * photograph behind a claim about every venue in the city argues the wrong
+ * thing. The tile grid reads as "many menus" without being any of them.
+ * Callers that DO have a real, licensed image for the slot can pass
+ * `backgroundUrl` — venue photography, never a plate.
+ *
+ * ## Figures
+ *
+ * `figures` is a list, not four fixed slots: the drinks tab has different ones
+ * and the count changes when a number turns out to have nothing behind it.
+ * Every value is a pre-formatted string because thousands separators are
+ * locale-dependent and the DS owns no locale.
+ *
+ * Server-safe.
+ */
+type MenuHubHeroFigure = {
+    /** Pre-formatted, e.g. "19,062". */
+    value: string;
+    label: string;
+};
+type MenuHubHeroProps = {
+    /** Small caps line above the headline, e.g. "397 MENUS IN CLUJ-NAPOCA, READ IN FULL". */
+    kicker?: string;
+    /** Icon for the kicker, resolved by the caller. */
+    kickerIcon?: React.ReactNode;
+    headline: string;
+    body?: string;
+    figures?: MenuHubHeroFigure[];
+    /**
+     * The proof line — one demonstrated fact, e.g. "A margherita: 87 kitchens
+     * make one, 10 to 120 lei". Composed by the caller; clause order is
+     * locale-dependent.
+     */
+    proof?: React.ReactNode;
+    proofIcon?: React.ReactNode;
+    /** The action beside the proof line. Pass a rendered link or button. */
+    action?: React.ReactNode;
+    /** Real, licensed photograph for the ground. Venue imagery only — see above. */
+    backgroundUrl?: string;
+    /**
+     * Tiles for the mosaic ground — generic, cinematic, licensed stills, served
+     * from the consumer's own origin.
+     *
+     * A mosaic rather than one photograph because the hero's claim is about EVERY
+     * kitchen in the city: a single image makes it about one of them. Given fewer
+     * tiles than cells the list repeats, so a caller can ship six and still fill
+     * a 1440px hero.
+     */
+    tileUrls?: string[];
+    className?: string;
+};
+declare function MenuHubHero({ kicker, kickerIcon, headline, body, figures, proof, proofIcon, action, backgroundUrl, tileUrls, className, }: MenuHubHeroProps): react_jsx_runtime.JSX.Element;
+
+export { MenuHubHero, type MenuHubHeroFigure, type MenuHubHeroProps };

package/dist/components/menu-hub-hero.js

@@ -0,0 +1,103 @@
+import { cn } from '../chunk-FEK5XGZW.js';
+import '../chunk-3GWWZKX7.js';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+var TEXTURE_CELLS = 28;
+function MenuHubHero({
+  kicker,
+  kickerIcon,
+  headline,
+  body,
+  figures,
+  proof,
+  proofIcon,
+  action,
+  backgroundUrl,
+  tileUrls,
+  className
+}) {
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "relative flex min-h-[260px] overflow-hidden rounded-[20px] bg-[oklch(0.21_0.012_55)] lg:min-h-[440px]",
+        className
+      ),
+      children: [
+        backgroundUrl ? (
+          // eslint-disable-next-line @next/next/no-img-element
+          /* @__PURE__ */ jsx(
+            "img",
+            {
+              src: backgroundUrl,
+              alt: "",
+              "aria-hidden": true,
+              className: "absolute inset-0 h-full w-full object-cover opacity-[0.42]"
+            }
+          )
+        ) : /* @__PURE__ */ jsx(
+          "div",
+          {
+            "aria-hidden": true,
+            className: "absolute inset-0 grid auto-rows-fr grid-cols-4 gap-0.5 lg:grid-cols-7",
+            children: Array.from({ length: TEXTURE_CELLS }, (_, cell) => {
+              const url = (tileUrls == null ? void 0 : tileUrls.length) ? tileUrls[cell % tileUrls.length] : void 0;
+              return url ? (
+                // eslint-disable-next-line @next/next/no-img-element
+                /* @__PURE__ */ jsx(
+                  "img",
+                  {
+                    src: url,
+                    alt: "",
+                    loading: "lazy",
+                    decoding: "async",
+                    className: "h-full w-full object-cover"
+                  },
+                  cell
+                )
+              ) : /* @__PURE__ */ jsx(
+                "div",
+                {
+                  className: "bg-[repeating-linear-gradient(135deg,oklch(0.6_0.02_55)_0_9px,oklch(0.68_0.016_58)_9px_18px)] opacity-[0.42]"
+                },
+                cell
+              );
+            })
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            "aria-hidden": true,
+            className: cn(
+              "absolute inset-0",
+              (tileUrls == null ? void 0 : tileUrls.length) || backgroundUrl ? "bg-[linear-gradient(100deg,oklch(0.16_0.012_55_/_0.96)_0%,oklch(0.16_0.012_55_/_0.88)_52%,oklch(0.16_0.012_55_/_0.72)_100%)]" : "bg-[linear-gradient(100deg,oklch(0.18_0.012_55_/_0.95)_0%,oklch(0.18_0.012_55_/_0.72)_52%,oklch(0.18_0.012_55_/_0.3)_100%)]"
+            )
+          }
+        ),
+        /* @__PURE__ */ jsxs("div", { className: "relative z-[1] flex w-full flex-col justify-center gap-3 p-5 text-white lg:gap-4 lg:px-12 lg:py-11", children: [
+          kicker && /* @__PURE__ */ jsxs("span", { className: "inline-flex w-max items-center gap-[7px] rounded-full bg-white/15 px-3 py-1.5 text-[11px] font-extrabold tracking-[0.11em]", children: [
+            kickerIcon,
+            kicker
+          ] }),
+          /* @__PURE__ */ jsx("h1", { className: "max-w-[640px] font-serif text-[32px] font-semibold leading-[1.04] tracking-[-0.025em] lg:text-[50px]", children: headline }),
+          body && /* @__PURE__ */ jsx("p", { className: "hidden max-w-[540px] text-sm leading-[1.6] opacity-[0.84] lg:block lg:text-[15.5px]", children: body }),
+          figures && figures.length > 0 && // Two by two on the phone: four figures in one row wrapped to three and an orphan.
+          /* @__PURE__ */ jsx("div", { className: "grid grid-cols-2 gap-x-6 gap-y-3 pt-3 lg:flex lg:flex-wrap lg:gap-x-8 lg:gap-y-4 lg:pt-1.5", children: figures.map((figure) => /* @__PURE__ */ jsxs("div", { children: [
+            /* @__PURE__ */ jsx("div", { className: "text-2xl font-black leading-none tracking-[-0.03em] tabular-nums lg:text-[32px]", children: figure.value }),
+            /* @__PURE__ */ jsx("div", { className: "mt-[5px] text-xs opacity-[0.72]", children: figure.label })
+          ] }, figure.label)) }),
+          (proof || action) && /* @__PURE__ */ jsxs("div", { className: "mt-auto flex flex-wrap items-center gap-3 pt-5", children: [
+            proof && /* @__PURE__ */ jsxs("span", { className: "inline-flex min-h-11 items-center gap-2.5 rounded-full bg-white/10 px-4 py-2 text-[13px] backdrop-blur-[6px]", children: [
+              proofIcon,
+              proof
+            ] }),
+            action
+          ] })
+        ] })
+      ]
+    }
+  );
+}
+
+export { MenuHubHero };

package/dist/components/menu-index-header.d.ts

@@ -0,0 +1,37 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { MenuIndexEntry, MenuLinkComponent } from './menu-types.js';
+import 'react';
+import './place-types.js';
+
+type MenuIndexHeaderProps = {
+    /** Small caps over the title, e.g. "MENU · CLUJ-NAPOCA". */
+    eyebrow?: string;
+    title: string;
+    /** Sits beside the title, e.g. "38 cuisines". Pluralised by the caller. */
+    count?: string;
+    subtitle?: string;
+    /** The Food / Drinks control. A `<SegmentedNav>`, composed by the caller. */
+    scopeSwitch?: React.ReactNode;
+    className?: string;
+};
+declare function MenuIndexHeader({ eyebrow, title, count, subtitle, scopeSwitch, className, }: MenuIndexHeaderProps): react_jsx_runtime.JSX.Element;
+/**
+ * MenuJumpStrip — the page's contents, as chips.
+ *
+ * It answers "move between families without going back to the hub", and it
+ * doubles as a table of contents: each chip carries the family's mark and its
+ * count, so the strip says how long the page is before the reader scrolls it.
+ *
+ * Only the families drawn in full belong here. A strip listing every value in
+ * the index below would be the index, twice.
+ */
+type MenuJumpStripProps = {
+    entries: MenuIndexEntry[];
+    formatCount?: (value: number) => string;
+    ariaLabel?: string;
+    linkComponent?: MenuLinkComponent;
+    className?: string;
+};
+declare function MenuJumpStrip({ entries, formatCount, ariaLabel, linkComponent: LinkComponent, className, }: MenuJumpStripProps): react_jsx_runtime.JSX.Element;
+
+export { MenuIndexHeader, type MenuIndexHeaderProps, MenuJumpStrip, type MenuJumpStripProps };

package/dist/components/menu-index-header.js

@@ -0,0 +1,68 @@
+import { ScrollFade } from '../chunk-2XCZJWTV.js';
+import { cn } from '../chunk-FEK5XGZW.js';
+import { __objRest, __spreadValues } from '../chunk-3GWWZKX7.js';
+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 MenuIndexHeader({
+  eyebrow,
+  title,
+  count,
+  subtitle,
+  scopeSwitch,
+  className
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: cn("flex flex-col gap-4 lg:flex-row lg:items-start lg:gap-8", className), children: [
+    /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
+      eyebrow && /* @__PURE__ */ jsx("p", { className: "text-[11px] font-bold uppercase tracking-[0.1em] text-muted-foreground", children: eyebrow }),
+      /* @__PURE__ */ jsxs("h1", { className: "mt-1.5 text-[30px] font-black leading-[1.05] tracking-[-0.035em] lg:text-[40px]", children: [
+        title,
+        count && /* @__PURE__ */ jsx("span", { className: "ml-2.5 align-middle text-base font-semibold text-muted-foreground lg:text-lg", children: count })
+      ] }),
+      subtitle && /* @__PURE__ */ jsx("p", { className: "mt-2 max-w-[60ch] text-sm text-muted-foreground", children: subtitle })
+    ] }),
+    scopeSwitch && /* @__PURE__ */ jsx("div", { className: "sticky top-0 z-10 -mx-[var(--page-gutter)] bg-background px-[var(--page-gutter)] py-2 lg:static lg:mx-0 lg:bg-transparent lg:px-0 lg:py-0", children: scopeSwitch })
+  ] });
+}
+function MenuJumpStrip({
+  entries,
+  formatCount = String,
+  ariaLabel,
+  linkComponent: LinkComponent = DefaultLink,
+  className
+}) {
+  return /* @__PURE__ */ jsx(
+    ScrollFade,
+    {
+      orientation: "horizontal",
+      size: "sm",
+      className,
+      scrollClassName: "scrollbar-hide",
+      children: /* @__PURE__ */ jsx("nav", { "aria-label": ariaLabel, className: "flex items-center gap-2", children: entries.map((entry) => /* @__PURE__ */ jsxs(
+        LinkComponent,
+        {
+          href: entry.href,
+          className: "inline-flex h-9 shrink-0 items-center gap-2 whitespace-nowrap rounded-full border border-border bg-card px-4 text-sm transition-colors hover:border-accent/40 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring motion-reduce:transition-none",
+          children: [
+            /* @__PURE__ */ jsx(
+              "span",
+              {
+                "aria-hidden": true,
+                className: cn("h-2.5 w-2.5 shrink-0 rounded-[3px]", !entry.gradient && "bg-border"),
+                style: entry.gradient ? { backgroundImage: entry.gradient } : void 0
+              }
+            ),
+            entry.name,
+            /* @__PURE__ */ jsx("span", { className: "tabular-nums text-muted-foreground", children: formatCount(entry.count) })
+          ]
+        },
+        entry.slug
+      )) })
+    }
+  );
+}
+
+export { MenuIndexHeader, MenuJumpStrip };

package/dist/components/menu-index-list.d.ts

@@ -0,0 +1,48 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { MenuIndexEntry, MenuLinkComponent, MenuLinkProps } from './menu-types.js';
+import 'react';
+import './place-types.js';
+
+/**
+ * MenuIndexList — the complete set, four across.
+ *
+ * ## This block is why the page can afford to be progressive
+ *
+ * It carries a crawlable link to EVERY destination the city has — all
+ * thirty-eight cuisines, not the ten the page draws in full below. That makes
+ * it the page's entire link-equity job, which in turn means the rich blocks
+ * underneath are free to load ten at a time behind a "show more": nothing a
+ * crawler needs is hidden behind that control, because it is all up here.
+ *
+ * Get this backwards — put the whole set behind the disclosure and only ten
+ * links in the markup — and the page silently stops linking to twenty-eight
+ * pages it is supposed to be the index for.
+ *
+ * ## Ordered by count, and the counts overlap
+ *
+ * Cuisines are non-exclusive tags: Cluj's thirty-eight sum to 3,182 against 767
+ * places, because a trattoria is Italian AND pizza AND international. So this
+ * is a ranked list of ways in, never a partition, and no copy near it may total
+ * the numbers or call them a breakdown.
+ */
+/** @deprecated Alias of `MenuLinkProps`; kept for symmetry with the other menu surfaces. */
+type MenuIndexListLinkProps = MenuLinkProps;
+type MenuIndexListProps = {
+    entries: MenuIndexEntry[];
+    /** e.g. "All 38 cuisines". Composed and pluralised by the caller. */
+    title: string;
+    /** One line under it, e.g. "Ordered by kitchens — every one has its own page". */
+    subtitle?: string;
+    /** Locale-aware integer formatter. Defaults to `String`. */
+    formatCount?: (value: number) => string;
+    linkComponent?: MenuLinkComponent;
+    className?: string;
+};
+declare function MenuIndexList({ entries, title, subtitle, formatCount, linkComponent: LinkComponent, className, }: MenuIndexListProps): react_jsx_runtime.JSX.Element;
+/** Two columns on a phone, four from `lg` — the grid the list itself renders. */
+declare function MenuIndexListSkeleton({ rows, className, }: {
+    rows?: number;
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+
+export { MenuIndexList, type MenuIndexListLinkProps, type MenuIndexListProps, MenuIndexListSkeleton };