@wix/agent-skills 1.17.0 → 1.18.1

package/skills/wix-headless-fast/references/restaurants/app/wix/restaurants/types.ts

@@ -0,0 +1,168 @@
+// Restaurants DTOs — the serializable shapes every hook, component, and page consumes.
+// Plain JSON: safe as Astro island props or across server/client boundaries. Images are
+// resolved https URLs. MENU prices come from the Menus API as decimal strings in the site
+// currency with NO symbol ("12.50") — the DTO carries the platform's formatted string when
+// the response includes one, else the plain decimal (prefix your brand's currency in the UI).
+// Order-cart prices (eCom) ARE fully formatted strings.
+
+/** A dietary/style label on a menu item (e.g. "Vegan", "Spicy"). */
+export interface MenuItemLabel {
+  id: string;
+  name: string;
+  /** Resolved https URL ("" when the label has no icon). */
+  iconUrl: string;
+}
+
+/** One price variant of an item ("Glass" / "Bottle"). An item has price OR variants. */
+export interface MenuItemVariant {
+  variantId: string;
+  name: string;
+  /** Display price — formatted when the API provides it, else the decimal amount. */
+  price: string;
+}
+
+/** One choice inside a modifier group ("Extra cheese"). */
+export interface MenuModifier {
+  id: string;
+  name: string;
+  preSelected: boolean;
+  /** Decimal up-charge amount ("0" = free), site currency, no symbol. */
+  additionalCharge: string;
+  inStock: boolean;
+}
+
+/** A modifier group on an item ("Toppings", choose 0–3). DISPLAY-ONLY: modifier
+ * selections are not sent on the cart line (the API doesn't document that shape). */
+export interface MenuModifierGroup {
+  id: string;
+  name: string;
+  required: boolean;
+  minSelections: number;
+  maxSelections: number | null;
+  modifiers: MenuModifier[];
+}
+
+/** A dish/drink as the menu page needs it. */
+export interface MenuItem {
+  id: string;
+  name: string;
+  description: string;
+  /** Display price; null when the item is variant-priced or market-priced. */
+  price: string | null;
+  /** True → show "Market price"; the item can't be ordered online. */
+  marketPrice: boolean;
+  /** Non-empty exactly when price is null and not marketPrice. */
+  variants: MenuItemVariant[];
+  /** Resolved https URL ("" when the item has no image). */
+  imageUrl: string;
+  labels: MenuItemLabel[];
+  modifierGroups: MenuModifierGroup[];
+  /** False → render "Sold out" and disable add-to-order. */
+  inStock: boolean;
+  featured: boolean;
+}
+
+/** A section of a menu ("Appetizers"), items already in display order. */
+export interface MenuSection {
+  id: string;
+  name: string;
+  description: string;
+  /** Resolved https URL ("" when none). */
+  imageUrl: string;
+  items: MenuItem[];
+}
+
+/** A whole menu ("Dinner"), sections already in display order. */
+export interface MenuData {
+  id: string;
+  name: string;
+  description: string;
+  /** URL fragment (urlQueryParam), e.g. "dinner". */
+  slug: string;
+  sections: MenuSection[];
+}
+
+/** A pickup/delivery method to display (the buyer picks one on the hosted checkout). */
+export interface FulfillmentMethodInfo {
+  id: string;
+  type: "PICKUP" | "DELIVERY";
+  name: string;
+  /** Decimal amounts, site currency, no symbol ("0", "5"). */
+  fee: string;
+  minOrderPrice: string;
+}
+
+export interface OrderLine {
+  /** The cart line id — what update/remove take (NOT the menu item id). */
+  lineItemId: string;
+  itemName: string;
+  quantity: number;
+  /** Per-unit price, formatted. */
+  unitPrice: string;
+  /** Line total, formatted. */
+  linePrice: string;
+  /** Resolved https URL ("" when none). */
+  imageUrl: string;
+  /** Human-readable selection labels the platform attached (may be empty). */
+  descriptionLines: string[];
+  /** Not IN_STOCK → the line can't be checked out as-is. */
+  status: string;
+}
+
+export interface OrderCart {
+  lines: OrderLine[];
+  /** Sum of line quantities. */
+  itemCount: number;
+  /** Formatted subtotal (after discounts) — from the cart estimate, not hand-summed. */
+  subtotal: string;
+  currency: string;
+}
+
+/** A reservation location as the booking form needs it. */
+export interface ReservationLocationInfo {
+  id: string;
+  default: boolean;
+  /** Bound the party-size input to [partySizeMin, partySizeMax]. */
+  partySizeMin: number;
+  partySizeMax: number;
+  /** "AUTOMATIC" confirms instantly; "MANUAL"/"MANUAL_FOR_LARGE_PARTIES" may end REQUESTED. */
+  approvalMode: "AUTOMATIC" | "MANUAL" | "MANUAL_FOR_LARGE_PARTIES";
+  /** False (premium-gated toggle off) → slots/booking won't work; show an honest notice. */
+  onlineReservationsEnabled: boolean;
+}
+
+/** One AVAILABLE reservation time slot. */
+export interface ReservationSlot {
+  /** ISO datetime — pass to holdSlot as-is. */
+  startIso: string;
+  /** Display label, e.g. "7:00 PM". */
+  label: string;
+  /** "YYYY-MM-DD" in the visitor's timezone — for grouping/labeling. */
+  dayKey: string;
+  durationMinutes: number;
+  /** This slot needs staff approval → the reservation will end REQUESTED, not RESERVED. */
+  manualApproval: boolean;
+}
+
+/** A 10-minute hold on a slot; completeReservation needs BOTH ids. */
+export interface ReservationHold {
+  reservationId: string;
+  revision: string;
+  startIso: string;
+  partySize: number;
+}
+
+/** The visitor's details. firstName + phone (E.164, e.g. "+15551234567") are REQUIRED. */
+export interface ReservationReservee {
+  firstName: string;
+  phone: string;
+  lastName?: string;
+  email?: string;
+}
+
+/** The outcome of completing a reservation. */
+export interface ReservationConfirmation {
+  reservationId: string;
+  /** RESERVED = confirmed; REQUESTED = pending the restaurant's approval — tell the visitor. */
+  status: "RESERVED" | "REQUESTED";
+}

package/skills/wix-headless-fast/references/restaurants/app-astro/layouts/SiteLayout.astro

@@ -0,0 +1,47 @@
+---
+// The site chrome for every restaurant page — THIS file (header/footer/nav) plus the @theme
+// token block in src/styles/global.css are what you brand. Keep the <slot name="seo-tags" />
+// in <head>, the global.css import, and one OrderCartButton in the header + one
+// OrderCartDrawer per page (both client:only — they read browser cart state and must not
+// server-render). (If another vertical is also deployed, its SiteLayout may have won; merge
+// the Menu/Reservations nav links and the order-cart mounts there instead.)
+import OrderCartButton from "../components/restaurants/OrderCartButton";
+import OrderCartDrawer from "../components/restaurants/OrderCartDrawer";
+import "../styles/global.css";
+
+interface Props {
+  title: string;
+  description?: string;
+}
+const { title, description } = Astro.props;
+---
+
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{title}</title>
+    {description && <meta name="description" content={description} />}
+    <slot name="seo-tags" />
+  </head>
+  <body>
+    <header class="sticky top-0 z-40 border-b border-border bg-background/80 backdrop-blur">
+      <div class="mx-auto flex h-16 max-w-6xl items-center justify-between px-6">
+        <a href="/" class="text-base font-bold tracking-tight text-foreground no-underline">Brand Name</a>
+        <nav class="flex items-center gap-6 text-sm">
+          <a href="/menu" class="text-foreground no-underline transition-colors hover:text-muted-foreground">Menu</a>
+          <a href="/reservations" class="text-foreground no-underline transition-colors hover:text-muted-foreground">Reservations</a>
+          <OrderCartButton client:only="react" />
+        </nav>
+      </div>
+    </header>
+    <main class="mx-auto max-w-6xl px-6 pb-24 pt-10">
+      <slot />
+    </main>
+    <footer class="border-t border-border px-6 py-10 text-center text-sm text-muted-foreground">
+      © Brand Name
+    </footer>
+    <OrderCartDrawer client:only="react" />
+  </body>
+</html>

package/skills/wix-headless-fast/references/restaurants/app-astro/pages/menu.astro

@@ -0,0 +1,22 @@
+---
+// Menu page — the full menu tree fetched SERVER-SIDE (SEO: dish names in view-source) and
+// handed to the island as DTO props. Keep this frontmatter; swap the island import to YOUR
+// menu component. The island is client:load — add-to-order needs the browser.
+import SiteLayout from "../layouts/SiteLayout.astro";
+import MenuView from "../components/restaurants/MenuView";
+import { fetchMenus } from "../wix/restaurants/menu";
+import type { MenuData } from "../wix/restaurants/types";
+
+let menus: MenuData[] = [];
+try {
+  menus = await fetchMenus();
+} catch {
+  // An unguarded SSR throw truncates the response mid-stream; the island renders the
+  // empty state instead.
+}
+---
+
+<SiteLayout title="Menu">
+  <h1 class="mb-8 text-2xl font-semibold tracking-tight">Menu</h1>
+  <MenuView client:load initialMenus={menus} />
+</SiteLayout>

package/skills/wix-headless-fast/references/restaurants/app-astro/pages/reservations.astro

@@ -0,0 +1,12 @@
+---
+// Reservations page. The surface is client:only — availability is timezone- and
+// party-specific, so nothing useful can server-render. Swap the island import to YOUR
+// reservation component.
+import SiteLayout from "../layouts/SiteLayout.astro";
+import ReservationView from "../components/restaurants/ReservationView";
+---
+
+<SiteLayout title="Reservations" description="Reserve a table">
+  <h1 class="mb-8 text-2xl font-semibold tracking-tight">Reserve a table</h1>
+  <ReservationView client:only="react" />
+</SiteLayout>