@bearmenu/ui 0.8.7 → 0.8.9

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

@@ -0,0 +1,127 @@
+import * as React from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { MenuItemPreview, MenuLinkComponent, MenuLinkProps } from './menu-types.js';
+import './place-types.js';
+
+/**
+ * MenuItem — THE menu row.
+ *
+ * A venue's page (its menu list, its signature picks, the "pairs well with"
+ * list inside the entity drawer) and the cross-venue surfaces (the city menu,
+ * the hub's "known for" list, the daily editorial buckets) all render this one
+ * component, so an item is visibly the same object wherever it is met.
+ *
+ * Hoisted out of the app, where it had grown a second and a third lookalike
+ * beside it. It carries the app version's design decisions verbatim; only the
+ * couplings changed — the locale, the translation keys and the category-colour
+ * table are injected, because the DS owns none of those.
+ *
+ * ## The left mark
+ *
+ * An 8px rounded tab in the section's CATEGORY colour, flat against the row's
+ * left edge and bulging right. It replaced an earlier monogram chip, and the
+ * trade was deliberate:
+ *
+ *   + The text column widens. At 390px the monogram costs 50px (38 + gap) and
+ *     the tab costs 16px, so the text column goes 308px → 342px: ~11% more room
+ *     for names and descriptions, which means fewer wrapped names and more
+ *     items per screen.
+ *   + The hue answers "which section am I in" rather than "what is this made
+ *     of". Every row in a category draws the same mark, so it survives the
+ *     category header scrolling out of view — which a per-item ingredient hue
+ *     cannot do, since it changes for reasons the reader cannot see.
+ *   − COLOUR-BLINDNESS. The monogram gave a reader who cannot separate the hues
+ *     a LETTER; a rule collapses to the same grey bar for everyone. Both marks
+ *     are `aria-hidden` and neither carries meaning the text lacks, so this is
+ *     not a WCAG 1.4.1 failure — but it is a real loss of scannability for ~8%
+ *     of men, and it has not been bought back yet.
+ *
+ * `markGradient` is passed IN, never derived: inside a menu the colour depends
+ * on the neighbouring sections, which a single row cannot see.
+ *
+ * ## No chevron
+ *
+ * The row is already `role="button"`, so an arrow would only restate that, and
+ * the right edge belongs to the mention count, which the arrow would collide
+ * with.
+ */
+/** @deprecated Alias of `MenuLinkProps`; kept so existing imports keep working. */
+type MenuItemLinkProps = MenuLinkProps;
+type MenuItemLabels = {
+    /** Currency unit beside the price, e.g. "RON". */
+    currency: string;
+    /** Fully-worded mention count — the accessible name for the glyph-and-numeral pair. */
+    mentions: (count: number) => string;
+    /** Chip text for a `signature`-strength item. */
+    signature: string;
+    /** Chip text for a `weak` (merely mentioned) item. */
+    mentioned: string;
+};
+type MenuItemProps = {
+    item: MenuItemPreview;
+    labels: MenuItemLabels;
+    /** Locale-aware money formatter. The DS owns no `Intl` locale. */
+    formatPrice: (amount: number) => string;
+    /** Locale-aware integer formatter for the mention count. Defaults to `String`. */
+    formatCount?: (value: number) => string;
+    /**
+     * Opens the item's own sheet. Ignored when `href` is set.
+     *
+     * Neither this nor `href` → an INERT row: same geometry, mark, type and meta
+     * line, but no `role="button"`, no tab stop and no hover or press states.
+     * That is the must-try mention with no menu row behind it — it has nothing to
+     * open, so it renders as content rather than as a control that goes nowhere.
+     */
+    onOpen?: () => void;
+    showSignatureBadge?: boolean;
+    signatureTier?: "strong" | "weak";
+    onSignatureEvidence?: () => void;
+    /** Opens the reviews behind the mention count. */
+    onMentions?: () => void;
+    /** The mark's colour, as a CSS `background-image` value. */
+    markGradient?: string;
+    /**
+     * The venue this item belongs to — an attribution line under the name.
+     *
+     * Set it ONLY on cross-venue surfaces, where ten near-identical burgers come
+     * from ten kitchens and the venue IS the tap decision. A venue's own menu
+     * page must never pass it: the page already said whose menu this is. Passed
+     * in rather than read off `item.place` so the redundant case cannot be the
+     * default.
+     */
+    venueName?: string;
+    /**
+     * Explicit subtitle, in italic, in place of the description. Used where the
+     * reviewer's reason IS the row's content rather than the payoff for tapping.
+     */
+    subtitle?: string;
+    /**
+     * Render the row as a LINK instead of a `role="button"` div — for surfaces
+     * where it navigates rather than opening a sheet, so it stays
+     * middle-clickable and shareable. Implemented as a stretched overlay rather
+     * than by wrapping the row: the mention count is a control in its own right
+     * and a button inside an anchor is invalid.
+     */
+    href?: string;
+    /** Accessible name for the link overlay. Defaults to the item's name. */
+    linkLabel?: string;
+    linkComponent?: MenuLinkComponent;
+    disabled?: boolean;
+    className?: string;
+};
+/**
+ * The mention count: a filled quote glyph and the numeral, pinned right.
+ *
+ * Deliberately NOT a badge — a chip would add a filled shape to a row that has
+ * none, and would read as a status label the venue was given rather than a
+ * count drawn from the same reviews.
+ */
+declare function MentionSignal({ label, count, onMentions, formatCount, }: {
+    label: string;
+    count: number;
+    onMentions?: () => void;
+    formatCount?: (value: number) => string;
+}): react_jsx_runtime.JSX.Element;
+declare const MenuItem: React.NamedExoticComponent<MenuItemProps>;
+
+export { MentionSignal, MenuItem, type MenuItemLabels, type MenuItemLinkProps, type MenuItemProps };

package/dist/components/menu-item.js

@@ -0,0 +1,5 @@
+export { MentionSignal, MenuItem } from '../chunk-TH6W2PWG.js';
+import '../chunk-Q6QH52LJ.js';
+import '../chunk-UKBNQO6Q.js';
+import '../chunk-FEK5XGZW.js';
+import '../chunk-3GWWZKX7.js';

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

@@ -0,0 +1,55 @@
+import { MenuConceptPreview, MenuFamilyPreview, MenuIntentTile, MenuItemPreview, MenuVenuePreview } from './menu-types.js';
+import { PlacePreview } from './place-types.js';
+import 'react';
+
+/**
+ * Fixtures for the menu-hub surfaces — used by their stories, and shipped so
+ * that consumers rendering these components outside an app (post-generator's
+ * Remotion frames, admin previews) do not each rebuild a plausible view model.
+ *
+ * ## Every venue here is invented
+ *
+ * The names, ratings and quotes are fabricated. Real venues must never appear
+ * in marketing or promotional renders — a real kitchen's rating in a promo
+ * frame is a claim about that business, made without its involvement, and it
+ * goes stale the moment the data moves. Anything filmed from these fixtures is
+ * safe to publish; anything filmed from live data is not.
+ *
+ * The SHAPES are real, though: the gaps are the gaps the API actually has, so
+ * a layout that survives these fixtures survives production. `mentions` is
+ * populated everywhere because it is populated everywhere upstream; one venue
+ * has no `must_try`, one has no photograph, and one grade is missing the
+ * dimensions a coffee bar never gets.
+ */
+
+declare const mockGradients: {
+    readonly pasta: "linear-gradient(150deg, oklch(0.555 0.105 80), oklch(0.455 0.10 70))";
+    readonly meat: "linear-gradient(150deg, oklch(0.49 0.13 28), oklch(0.41 0.12 22))";
+    readonly greens: "linear-gradient(150deg, oklch(0.505 0.115 148), oklch(0.415 0.11 142))";
+    readonly sweet: "linear-gradient(150deg, oklch(0.505 0.14 50), oklch(0.405 0.13 42))";
+    readonly cocktail: "linear-gradient(150deg, oklch(0.485 0.095 205), oklch(0.405 0.09 212))";
+};
+declare const mockPlaces: PlacePreview[];
+declare const mockVenues: MenuVenuePreview[];
+declare const mockItems: MenuItemPreview[];
+declare const mockConcept: MenuConceptPreview;
+declare const mockFamily: MenuFamilyPreview;
+/** The drinks counterpart, and the reason `chip.count` is optional. */
+declare const mockDrinkFamily: MenuFamilyPreview;
+declare const mockIntentTiles: MenuIntentTile[];
+/** Formatters the stories pass. Real callers inject locale-aware ones. */
+declare const mockFormatters: {
+    price: (value: number) => string;
+    number: (value: number) => string;
+    score: (value: number) => string;
+};
+declare const mockHubLabels: {
+    mentions: (count: number) => string;
+    venues: (count: number) => string;
+    seeAll: string;
+    signature: string;
+    openNow: string;
+    until: string;
+};
+
+export { mockConcept, mockDrinkFamily, mockFamily, mockFormatters, mockGradients, mockHubLabels, mockIntentTiles, mockItems, mockPlaces, mockVenues };

package/dist/components/menu-mocks.js

@@ -0,0 +1,379 @@
+import '../chunk-3GWWZKX7.js';
+
+// src/components/menu-mocks.ts
+var mockGradients = {
+  // The forest dictionary (docs/colour-dictionary.md, Foundations/Colour dictionary):
+  // wheat, ember, pine, maple, lake water. Post-generator films these, so they
+  // must be the same values the app paints.
+  pasta: "linear-gradient(150deg, oklch(0.555 0.105 80), oklch(0.455 0.10 70))",
+  meat: "linear-gradient(150deg, oklch(0.49 0.13 28), oklch(0.41 0.12 22))",
+  greens: "linear-gradient(150deg, oklch(0.505 0.115 148), oklch(0.415 0.11 142))",
+  sweet: "linear-gradient(150deg, oklch(0.505 0.14 50), oklch(0.405 0.13 42))",
+  cocktail: "linear-gradient(150deg, oklch(0.485 0.095 205), oklch(0.405 0.09 212))"
+};
+var mockPlaces = [
+  {
+    id: "p1",
+    slug: "the-copper-yard",
+    name: "The Copper Yard",
+    open_now: true,
+    rating: { rating: 4.6, count: 318 },
+    hours: [{ opens_at: 12, closes_at: 23 }],
+    price_dishes: { price_range_low: 19, price_range_high: 62, median_price: 28 },
+    cuisines: ["italian", "pizza"],
+    type: "pub",
+    busyness: [
+      { hour: 12, score: 22 },
+      { hour: 13, score: 26 },
+      { hour: 14, score: 30 },
+      { hour: 15, score: 38 },
+      { hour: 16, score: 52 },
+      { hour: 17, score: 74 },
+      { hour: 18, score: 92 },
+      { hour: 19, score: 100 },
+      { hour: 20, score: 86 },
+      { hour: 21, score: 64 }
+    ],
+    reviews_digest: {
+      review_count: 318,
+      grade: {
+        overall: 8.4,
+        show_number: true,
+        descriptor: "Foarte bun",
+        confidence: "high",
+        dimensions: {
+          food: 89,
+          service: 82,
+          value: 86,
+          ambiance: 78,
+          portion: 91,
+          consistency: 84
+        }
+      },
+      value: { value: "fair" },
+      tags: [{ value: "casual" }, { value: "cozy" }, { value: "family_friendly" }],
+      highlights: [
+        {
+          text: "The wings are the reason to sit at the bar \u2014 hot honey, and they keep going until the kitchen shuts.",
+          review_ids: ["r1", "r2", "r3"]
+        },
+        {
+          text: "Last kitchen open on this street. We came at half eleven and still ate properly.",
+          review_ids: ["r4", "r5"]
+        }
+      ],
+      must_try: [
+        {
+          name: "Chicken wings, 6 pc",
+          why: "Buttermilk brine and hot honey, fried to order until the kitchen shuts.",
+          strength: "signature",
+          slug: "chicken-wings",
+          mentions: 23,
+          sizes_and_prices: [{ size: 320, price: 32 }],
+          review_ids: ["r1", "r2", "r3"]
+        }
+      ]
+    }
+  },
+  {
+    id: "p2",
+    slug: "salt-and-stone",
+    name: "Salt & Stone",
+    open_now: true,
+    rating: { rating: 4.8, count: 204 },
+    hours: [{ opens_at: 11, closes_at: 22 }],
+    price_dishes: { price_range_low: 38, price_range_high: 84, median_price: 49 },
+    cuisines: ["italian"],
+    type: "restaurant",
+    reviews_digest: {
+      review_count: 204,
+      grade: {
+        overall: 8.9,
+        show_number: true,
+        dimensions: { food: 93, service: 88, value: 74, ambiance: 85 }
+      },
+      must_try: [
+        {
+          name: "Truffle Tagliatelle",
+          why: "Made in-house each morning with black truffle and parmesan.",
+          strength: "signature",
+          slug: "truffle-tagliatelle",
+          mentions: 17,
+          sizes_and_prices: [{ size: 320, price: 62 }],
+          review_ids: ["r6", "r7"]
+        }
+      ]
+    }
+  },
+  {
+    id: "p3",
+    slug: "the-quiet-hours",
+    name: "The Quiet Hours",
+    open_now: true,
+    rating: { rating: 4.5, count: 96 },
+    hours: [{ opens_at: 8, closes_at: 20 }],
+    price_dishes: { price_range_low: 8, price_range_high: 26, median_price: 14 },
+    type: "coffee_shop",
+    reviews_digest: {
+      review_count: 96,
+      // A coffee bar is graded on coffee_quality and never on food — the
+      // dimension row must survive the absence rather than draw a zero.
+      grade: {
+        overall: 8.6,
+        show_number: true,
+        dimensions: { coffee_quality: 91, service: 86, value: 80, ambiance: 88 }
+      },
+      must_try: [
+        {
+          name: "Flat white",
+          strength: "frequent",
+          slug: "flat-white",
+          mentions: 28,
+          sizes_and_prices: [{ size: 220, price: 14 }]
+        }
+      ]
+    }
+  },
+  {
+    id: "p4",
+    slug: "green-room-canteen",
+    name: "Green Room Canteen",
+    open_now: false,
+    rating: { rating: 4.7, count: 141 },
+    price_dishes: { price_range_low: 22, price_range_high: 51, median_price: 31 },
+    type: "restaurant"
+    // No digest at all: a place the census has not reached. Every venue surface
+    // has to render this without collapsing.
+  }
+];
+var placeBySlug = (slug) => mockPlaces.find((place) => place.slug === slug);
+var mockVenues = [
+  {
+    place: placeBySlug("the-copper-yard"),
+    href: "/places/the-copper-yard",
+    closes_at_label: "23:00",
+    signature: {
+      item: {
+        id: "s1",
+        slug: "chicken-wings",
+        name: "Chicken wings, 6 pc",
+        kind: "dish",
+        mentions: 23,
+        sizes_and_prices: [{ size: 320, price: 32 }]
+      },
+      why: "Buttermilk brine and hot honey, fried to order until the kitchen shuts.",
+      isSignature: true,
+      href: "/menu/dishes/chicken-wings"
+    }
+  },
+  {
+    place: placeBySlug("salt-and-stone"),
+    href: "/places/salt-and-stone",
+    closes_at_label: "22:00",
+    signature: {
+      item: {
+        id: "s2",
+        slug: "truffle-tagliatelle",
+        name: "Truffle Tagliatelle",
+        kind: "dish",
+        mentions: 17,
+        sizes_and_prices: [{ size: 320, price: 62 }]
+      },
+      why: "Made in-house each morning with black truffle and parmesan.",
+      isSignature: true,
+      href: "/menu/dishes/truffle-tagliatelle"
+    }
+  },
+  {
+    place: placeBySlug("the-quiet-hours"),
+    href: "/places/the-quiet-hours",
+    closes_at_label: "20:00",
+    signature: {
+      item: {
+        id: "s3",
+        slug: "flat-white",
+        name: "Flat white",
+        kind: "drink",
+        mentions: 28,
+        sizes_and_prices: [{ size: 220, price: 14 }]
+      },
+      href: "/menu/drinks/flat-white"
+    }
+  },
+  {
+    place: placeBySlug("green-room-canteen"),
+    href: "/places/green-room-canteen"
+    // No signature: the row must still read as a venue.
+  }
+];
+var mockItems = [
+  {
+    id: "i1",
+    slug: "truffle-tagliatelle",
+    name: "Truffle Tagliatelle",
+    kind: "dish",
+    category_slug: "pasta",
+    mentions: 17,
+    sizes_and_prices: [{ size: 320, price: 62 }],
+    place: { slug: "salt-and-stone", name: "Salt & Stone" }
+  },
+  {
+    id: "i2",
+    slug: "chicken-wings",
+    name: "Chicken wings, 6 pc",
+    kind: "dish",
+    category_slug: "chicken-dish",
+    mentions: 23,
+    sizes_and_prices: [{ size: 320, price: 32 }],
+    place: { slug: "the-copper-yard", name: "The Copper Yard" }
+  },
+  {
+    id: "i3",
+    slug: "burrata-heirloom-tomato",
+    name: "Burrata & heirloom tomato",
+    kind: "dish",
+    category_slug: "salad",
+    mentions: 14,
+    sizes_and_prices: [{ size: 300, price: 49 }],
+    place: { slug: "green-room-canteen", name: "Green Room Canteen" }
+  },
+  {
+    id: "i4",
+    slug: "flat-white",
+    name: "Flat white",
+    kind: "drink",
+    category_slug: "non-alcoholic",
+    mentions: 28,
+    sizes_and_prices: [{ size: 220, price: 14 }],
+    place: { slug: "the-quiet-hours", name: "The Quiet Hours" }
+  },
+  {
+    id: "i5",
+    slug: "house-negroni",
+    name: "House negroni",
+    kind: "drink",
+    category_slug: "cocktail",
+    // Deliberately unmentioned: the badge must not render "0".
+    mentions: 0,
+    sizes_and_prices: [{ size: 150, price: 32 }],
+    place: { slug: "the-copper-yard", name: "The Copper Yard" }
+  }
+];
+var mockConcept = {
+  slug: "margherita",
+  title: "Margherita",
+  kind: "dish",
+  venue_count: 87,
+  price_low: 10,
+  price_high: 120,
+  alias_count: 12,
+  mentions: 214,
+  rows: [
+    {
+      place_slug: "the-copper-yard",
+      place_name: "The Copper Yard",
+      alias: "Pizza Margherita",
+      price: 34,
+      mentions: 23,
+      rating: 4.6,
+      place_type: "pub",
+      featured: true
+    },
+    {
+      place_slug: "salt-and-stone",
+      place_name: "Salt & Stone",
+      alias: "Margherita D.O.P.",
+      price: 46,
+      mentions: 17,
+      rating: 4.8,
+      place_type: "restaurant"
+    },
+    {
+      place_slug: "green-room-canteen",
+      place_name: "Green Room Canteen",
+      alias: "Marinara Bianca",
+      price: 52,
+      mentions: 9,
+      rating: 4.7,
+      place_type: "canteen"
+    }
+  ]
+};
+var mockFamily = {
+  slug: "italian",
+  name: "Italian",
+  venue_count: 247,
+  chips: [
+    { slug: "pizza", label: "Pizza", count: 120 },
+    { slug: "pasta", label: "Pasta", count: 96 },
+    { slug: "salad", label: "Salad", count: 88 },
+    { slug: "chicken-dish", label: "Chicken", count: 77 }
+  ],
+  price_low: 32,
+  price_high: 84,
+  price_median: 49,
+  venue_photo_urls: [],
+  signature: {
+    item: {
+      id: "f1",
+      slug: "truffle-tagliatelle",
+      name: "Truffle Tagliatelle",
+      kind: "dish",
+      mentions: 17,
+      sizes_and_prices: [{ size: 320, price: 62 }]
+    },
+    why: "Salt & Stone",
+    href: "/menu/dishes/truffle-tagliatelle"
+  }
+};
+var mockDrinkFamily = {
+  slug: "cocktail",
+  name: "Cocktails",
+  venue_count: 21,
+  // No counts: there is no drink-group facet on places, so these ship as bare
+  // labels rather than with an invented number.
+  chips: [
+    { slug: "spritz", label: "Spritz" },
+    { slug: "negroni", label: "Negroni" },
+    { slug: "sour", label: "Sour" }
+  ],
+  price_low: 18,
+  price_high: 54,
+  price_median: 28,
+  venue_photo_urls: [],
+  signature: {
+    item: {
+      id: "f2",
+      slug: "house-negroni",
+      name: "House negroni",
+      kind: "drink",
+      mentions: 16,
+      sizes_and_prices: [{ size: 150, price: 32 }]
+    },
+    why: "The Copper Yard"
+  }
+};
+var intentGradient = (hue) => `linear-gradient(150deg, oklch(0.52 0.14 ${hue}), oklch(0.43 0.13 ${hue - 4}))`;
+var mockIntentTiles = [
+  { slug: "italian", label: "Italian tonight", caption: "247 kitchens", href: "/top/italian?open=now", gradient: intentGradient(40) },
+  { slug: "burgeri", label: "Burgers", caption: "229 kitchens", href: "/top/burgeri", gradient: intentGradient(25) },
+  { slug: "restaurante", label: "Open right now", caption: "by the hour", href: "/top/restaurante?open=now", gradient: intentGradient(60) },
+  { slug: "brunch", label: "Brunch", caption: "314 kitchens", href: "/top/brunch", gradient: intentGradient(75) },
+  { slug: "vegan", label: "Vegan", caption: "108 kitchens", href: "/top/vegan", gradient: intentGradient(148) },
+  { slug: "centru", label: "In Centru", caption: "by neighbourhood", href: "/top/centru", gradient: intentGradient(300) }
+];
+var mockFormatters = {
+  price: (value) => `${value} lei`,
+  number: (value) => value.toLocaleString("en-US"),
+  score: (value) => (value / 10).toFixed(1)
+};
+var mockHubLabels = {
+  mentions: (count) => `${count} mentions`,
+  venues: (count) => `${count} kitchens`,
+  seeAll: "See all",
+  signature: "SIGNATURE",
+  openNow: "Open now",
+  until: "until"
+};
+
+export { mockConcept, mockDrinkFamily, mockFamily, mockFormatters, mockGradients, mockHubLabels, mockIntentTiles, mockItems, mockPlaces, mockVenues };