@wix/himalaya-cli 0.1528.0 → 0.1529.0

package/fixtures/wix-canned.json

@@ -2093,5 +2093,88 @@
   "POST /ecom/v1/checkouts/chk-0001/create-order": {
     "orderId": "order-0001",
     "paymentGatewayOrderId": "payment-0001"
+  },
+  "GET /ecom/v2/carts/current": {},
+  "GET /restaurants-operations/v1/operations": {
+    "operations": [
+      {
+        "id": "op-0001",
+        "name": "Ordering page",
+        "default": true,
+        "onlineOrderingStatus": "ENABLED",
+        "defaultFulfillmentType": "PICKUP",
+        "fulfillmentIds": [
+          "fm-pickup-0001",
+          "fm-delivery-0001"
+        ]
+      }
+    ]
+  },
+  "GET /fulfillment-methods/v1/fulfillment-methods": {
+    "fulfillmentMethods": [
+      {
+        "id": "fm-pickup-0001",
+        "type": "PICKUP",
+        "name": "Pickup",
+        "enabled": true,
+        "minOrderPrice": "0",
+        "pickupOptions": {
+          "address": {
+            "country": "US",
+            "subdivision": "US-CA",
+            "city": "San Francisco",
+            "formattedAddress": "500 Example St, San Francisco, CA"
+          }
+        }
+      },
+      {
+        "id": "fm-delivery-0001",
+        "type": "DELIVERY",
+        "name": "Delivery Area #1",
+        "enabled": true,
+        "fee": "0",
+        "minOrderPrice": "0",
+        "deliveryOptions": {
+          "deliveryTimeInMinutes": 30
+        }
+      }
+    ],
+    "pagingMetadata": {
+      "count": 2,
+      "hasNext": false
+    }
+  },
+  "GET /restaurants-operations/v1/operations/op-0001/first-available-time-slot-per-fulfillment-type": {
+    "timeslotsPerFulfillmentType": [
+      {
+        "fulfilmentType": "DELIVERY",
+        "timeSlot": {
+          "startTime": "2026-10-29T11:18:00Z",
+          "endTime": "2026-10-29T11:18:00Z",
+          "orderSchedulingType": "ASAP"
+        },
+        "fulfillmentInfo": [
+          {
+            "fee": "0",
+            "minOrderPrice": "0",
+            "maxTime": 60
+          }
+        ]
+      },
+      {
+        "fulfilmentType": "PICKUP",
+        "timeSlot": {
+          "startTime": "2026-10-29T10:48:00Z",
+          "endTime": "2026-10-29T10:48:00Z",
+          "orderSchedulingType": "ASAP"
+        },
+        "fulfillmentInfo": [
+          {
+            "minOrderPrice": "0",
+            "maxTime": 30
+          }
+        ]
+      }
+    ]
   }
 }

package/guides/hhp.md

@@ -195,6 +195,45 @@ and auth flows retain their existing transports and network-fixture seams.
 The studio preview adds compact, medium, and expanded presets. Existing worker state,
 action, and SDK inspection remain available through the dev drawer.
 
+## Design fidelity (`himi fidelity`)
+
+`himi fidelity` answers one question per screen: does what shipped look like what was designed? It is repo-only for now and advisory. No CI gate reads it. Its readers are the authoring agent, before it calls an app done, and the PR reviewer.
+
+Declare the mockup each screen was designed from in `hhp.json`:
+
+```json
+{ "version": "hhp/2", "screens": { "schedule": { "html": "screens/schedule.html", "mockup": "mockup/schedule.html" } } }
+```
+
+A screen may also carry `params` (the navigation input a device opens it with, used by native capture, #4935) and `fidelity: { "warn": 80, "fail": 60 }`. Thresholds can also be set app-wide at the top level.
+
+```bash
+himi fidelity --content <dir> [--screen a,b] [--variant light,dark,rtl,tablet] [--no-native] [--json] [--post-pr <n>]
+```
+
+For each screen and variant (`light`, `dark`, `rtl`, `tablet`), the command does four things:
+
+1. **Captures the mockup.** It draws the page in Chromium at the variant's width. Dark mode is drawn by emulating `prefers-color-scheme`. RTL is drawn by setting `dir=rtl` on the page.
+2. **Captures the web render** from the app's recorded data, as `himi render` does by default. Native frames come through a capture seam. Until #4935 lands, the seam reports iOS and Android as skipped.
+3. **Scores mockup↔web** with ImageMagick SSIM, globally and per tile. The worst tile says where the screens differ most.
+4. **Asks a fresh model** two questions, using the repo's fidelity judge prompt. The model never ran in the session that wrote the app.
+   - **Design:** does WEB look like the MOCKUP? This judges the port.
+   - **Parity:** do IOS and ANDROID look like WEB? This judges the native renderers.
+
+Each row gets a status:
+
+| Status | When |
+|---|---|
+| **fail** | The judge answers `mismatch` to either question, or the mockup↔web score is below a `fail` threshold you set. |
+| **warn** | `partial`, `cannot_tell`, a skipped surface, a mockup with no styling for the variant (`no_reference`), a missing mockup (`fidelity_mockup_missing`), or a score below `warn`. |
+| **pass** | Anything else. |
+
+The command exits 1 if any row fails. Output goes to `.himi/fidelity/<run>/`: `report.json` and one strip PNG per row. `--post-pr <n>` keeps one plain PR comment per app up to date. The comment opens with `<!-- himi-fidelity: app=<app> run=<id> -->`, and only your own comment is ever edited. It is never a review thread.
+
+The pixel score has no default threshold, on purpose. On the repo's four HTML-first fixture apps, a blank page scores 87–95 against a mockup, while faithful ports score 69–93. Native chrome also shifts every row, so a native bug and its fix score within a point of each other. The judge is the gate, and the score points at where to look. Set thresholds only for a screen whose port is meant to be pixel-close.
+
+Without the `claude` CLI, every verdict is `cannot_tell`, and no row passes. Outside the himalaya repo, the command refuses with `code: "fidelity_outside_repo"`.
+
 ## Qualification
 
 Automated tests cover v1

package/guides/himi-json-output.md

@@ -6,7 +6,7 @@ repurposed when human wording changes. New codes may be added; consumers must
 handle an unknown code as a failure, without parsing prose.
 
 **Rollout:** this contract is enforced for **`himi push`**, including `--only`,
-first, for **`himi store iap connect`**, for **`himi site member-app`**, and for the **`himi base44`** entity and function verbs. Other subcommands still have legacy failures without codes and are a
+first, for **`himi store iap connect`**, for **`himi site member-app`**, for **`himi fidelity`**, and for the **`himi base44`** entity and function verbs. Other subcommands still have legacy failures without codes and are a
 follow-up migration. This is an additive change: existing `error`, `errors`,
 `message`, `hint`, status, body, and gate-specific fields stay as they were.
 Some legacy envelopes have no singular `error` or `hint`; consumers must not
@@ -394,6 +394,27 @@ On success (`ok: true`, stdout, exit 0) `capabilities[]` lists the ids the gener
 `--force` to overwrite it). A skipped file is not a failure. `orphaned[]`, when present, lists
 generated files for entities no longer declared. They are never deleted.
 
+## `himi fidelity` codes
+
+`himi fidelity` failures print `ok: false` and `code`:
+
+- `fidelity_rows_failed`: the run completed and at least one screen × variant row failed (a judge
+  `mismatch`, or a score below a threshold `hhp.json` sets). The report follows in the same
+  envelope. Exit 1.
+- `fidelity_outside_repo`: the content directory is not inside a himalaya repo checkout, which
+  carries the fidelity judge; the command is repo-only for now. Exit 2.
+- `fidelity_not_hhp`: the content directory has no `hhp.json`. Exit 2.
+- `fidelity_unknown_screen`: `--screen` names a screen `hhp.json` does not declare. Exit 2.
+- `fidelity_bad_flag`: a flag value is invalid (a missing content directory, an unknown
+  `--variant`, or a `--post-pr` that is not a PR number). Exit 2.
+- `fidelity_post_failed`: `--post-pr` could not create or edit the PR comment. Exit 1.
+- `fidelity_error`: any other failure before a report existed, such as an unreadable `hhp.json`.
+  Exit 1.
+
+A row's own failure is not a command failure. A missing mockup gives that row
+`error.code: "fidelity_mockup_missing"`, and a capture, score or strip that throws gives it
+`error.code: "fidelity_row_failed"`. Both rows warn, and the other rows still run.
+
 ## Follow-ups
 
 - Migrate failure envelopes in subcommands other than `push`, keeping this contract.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1528.0",
+  "version": "0.1529.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -71,5 +71,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "977ce0e45046b28615366bb368c7ceb90d7a1f9404024a58bee20404"
+  "falconPackageHash": "28b98bdc9fc68f9be64914a2b88e5593f330b1f1f8e51dc6b49bba20"
 }

package/templates/beauty-salon/config.ts

@@ -424,7 +424,7 @@ export default defineApp({
   // Your on-device database. It must declare every entity a worker reads or writes,
   // or those calls fail closed — keep it in step with `local_database` above.
   dataSchema: {
-    "version": 1,
+    "version": 2,
     "entities": [
       {
         "name": "products",
@@ -549,6 +549,17 @@ export default defineApp({
           }
         ]
       },
+      {
+        "name": "food_orders",
+        "encrypted": true,
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          }
+        ]
+      },
       {
         "name": "member_bookings",
         "encrypted": true,

package/templates/beauty-salon/tier5-src/_shared/himi-restaurants.ts

@@ -133,15 +133,18 @@ export function itemLabels(value: unknown, limit = 3): string[] {
 }
 
 /** Price-variant rows ({ name, priceLine }) from the item's loose
- *  `priceVariants.variants` payload — [] when the item has a single price. */
-export function itemPriceVariants(item: WixItem): Array<{ id: string; name: string; priceLine: string }> {
+ *  `priceVariants.variants` payload — [] when the item has a single price.
+ *  `variantId` is Wix's own id for the variant (live rows carry `variantId`; older
+ *  fixtures `id`), "" when the payload has none — a synthetic `variant-<n>` row id is
+ *  only for the UI and must never be sent to Wix. `price` is the decimal price. */
+export function itemPriceVariants(item: WixItem): Array<{ id: string; variantId: string; name: string; priceLine: string; price: string }> {
   const raw = item as unknown as { priceVariants?: { variants?: unknown[] } };
   const variants = raw.priceVariants?.variants;
   if (!Array.isArray(variants)) return [];
-  const rows: Array<{ id: string; name: string; priceLine: string }> = [];
+  const rows: Array<{ id: string; variantId: string; name: string; priceLine: string; price: string }> = [];
   for (const [index, entry] of variants.entries()) {
     if (!entry || typeof entry !== "object") continue;
-    const node = entry as { id?: unknown; name?: unknown; priceInfo?: { price?: unknown; currency?: unknown } };
+    const node = entry as { id?: unknown; variantId?: unknown; name?: unknown; priceInfo?: { price?: unknown; currency?: unknown; formattedPrice?: unknown } };
     const name = typeof node.name === "string" ? cleanTitle(node.name) : "";
     const price = node.priceInfo?.price;
     if (price == null || price === "" || Number.isNaN(Number(price))) continue;
@@ -152,7 +155,11 @@ export function itemPriceVariants(item: WixItem): Array<{ id: string; name: stri
         priceLine = formatCurrency(Number(price), currency, "en");
       } catch { /* keep the bare amount */ }
     }
-    rows.push({ id: typeof node.id === "string" && node.id ? node.id : `variant-${index}`, name: name || "Option", priceLine });
+    const formatted = typeof node.priceInfo?.formattedPrice === "string" ? node.priceInfo.formattedPrice.trim() : "";
+    if (formatted) priceLine = normalizeFormattedPrice(formatted);
+    const variantId = typeof node.variantId === "string" && node.variantId ? node.variantId
+      : typeof node.id === "string" && node.id ? node.id : "";
+    rows.push({ id: variantId || `variant-${index}`, variantId, name: name || "Option", priceLine, price: `${price}` });
   }
   return rows;
 }

package/templates/beauty-salon/tier5-src/_shared/restaurant-ordering.ts

@@ -0,0 +1,201 @@
+// Restaurants online ordering — Wix's visitor "Place an order from a custom storefront" flow,
+// shared by the dish detail (himi-branded-lite-menu-item: add a dish to the Wix cart) and the
+// order screen (wix-spaces-food-orders: cart → pickup/delivery → hosted checkout → history).
+//
+// The cart is the site's eCom CURRENT cart (Cart V2). It is the same cart the Stores cart screen
+// reads (V1 and V2 answer the same cart id), so a restaurant line is told apart by its catalog
+// app — Restaurants Orders — never assumed. Every call here is visitor-scope; the member's placed
+// orders are read through the eCom orders search the member Orders screen already uses, never
+// through the owner-capable Restaurants Orders API.
+import {
+  getFirstAvailableTimeSlotPerFulfillmentType,
+  listFulfillmentMethods,
+  listOperations,
+  queryMenus,
+  querySections,
+  type WixFulfillmentMethod,
+  type WixFulfillmentTimeSlot,
+  type WixMenu,
+  type WixOperation,
+  type WixRestaurantsAddress,
+  type WixSection,
+} from "@himalaya/wix-restaurants";
+import type { WixCartV2, WixCartV2LineItem, WixCatalogReference } from "@himalaya/wix-ecom";
+import { formatCurrency } from "../_shared/engine-intl.js";
+
+/** Wix Restaurants Orders — the catalog app a restaurant cart line belongs to. */
+export const RESTAURANTS_ORDERS_APP_ID = "9a5d83fd-8570-482e-81ab-cfa88942ee60";
+
+export type FulfillmentType = "PICKUP" | "DELIVERY";
+
+/** The operation a visitor orders from: an `ENABLED` one, the site's default first. None means
+ *  online ordering is closed (`DISABLED`, `PAUSED_UNTIL`, or no operation at all). */
+export function orderingOperation(operations: WixOperation[] | undefined, selection: { businessLocationId?: string; operationId?: string } = {}): WixOperation | undefined {
+  const open = (operations ?? []).filter((operation) => !!operation?.id && operation.onlineOrderingStatus === "ENABLED");
+  if (selection.operationId) return open.find((operation) => operation.id === selection.operationId);
+  if (selection.businessLocationId) return open.find((operation) => operation.businessLocationId === selection.businessLocationId);
+  return open.find((operation) => operation.default === true) ?? open[0];
+}
+
+export async function loadOrderingOperation(selection: { businessLocationId?: string; operationId?: string } = {}): Promise<WixOperation | undefined> {
+  return orderingOperation((await listOperations()).operations, selection);
+}
+
+/** The enabled pickup/delivery methods [operation] offers: the ones its `fulfillmentIds` name. An
+ *  operation that names none falls back only to methods at its own business location — never to
+ *  every method on the site, which on a multi-location site would offer another location's pickup. */
+export function offeredMethods(operation: WixOperation, methods: WixFulfillmentMethod[] | undefined): WixFulfillmentMethod[] {
+  const ids = new Set(operation.fulfillmentIds ?? []);
+  const belongs = (method: WixFulfillmentMethod) => ids.size > 0
+    ? ids.has(method.id)
+    : !!operation.businessLocationId && method.businessLocationId === operation.businessLocationId;
+  return (methods ?? []).filter((method) =>
+    !!method?.id && method.enabled === true && (method.type === "PICKUP" || method.type === "DELIVERY") && belongs(method));
+}
+
+export async function loadOfferedMethods(operation: WixOperation): Promise<WixFulfillmentMethod[]> {
+  const all: WixFulfillmentMethod[] = [];
+  let cursor = "";
+  // A site has a handful of methods; five pages of 100 is a bound, not an expectation.
+  for (let page = 0; page < 5; page++) {
+    const response = await listFulfillmentMethods({ limit: 100, ...(cursor ? { cursor } : {}) });
+    all.push(...(response.fulfillmentMethods ?? []));
+    cursor = response.pagingMetadata?.hasNext ? response.pagingMetadata.cursors?.next ?? "" : "";
+    if (!cursor) break;
+  }
+  return offeredMethods(operation, all);
+}
+
+/** A decimal string from Wix ("6.99", "0") as a number; anything else is 0 (a missing fee is free). */
+export function decimal(value: unknown): number {
+  const n = typeof value === "number" ? value : Number(typeof value === "string" ? value.trim() : NaN);
+  return Number.isFinite(n) ? n : 0;
+}
+
+/** Cart V2 money carries no formatted string: format the decimal with the cart's currency. */
+export function money(amount: unknown, currency: string | undefined): string {
+  return formatCurrency(decimal(amount), (currency ?? "").trim() || "USD", "en");
+}
+
+export function cartCurrency(cart: WixCartV2 | undefined): string {
+  return cart?.businessInfo?.currencyCode || cart?.customerInfo?.currencyCode || "";
+}
+
+/** Where a dish is ordered from. Checkout validates the line against `menuSectionId`, so it must
+ *  be a visible section that lists the dish, inside a visible menu that lists the section. */
+export interface DishPlacement {
+  menuId: string;
+  sectionId: string;
+  businessLocationId?: string;
+}
+
+/** The section the dish was shown under wins when it qualifies; otherwise the first visible
+ *  menu → section that lists it. None → the dish is on no orderable menu. */
+export function pickPlacement(
+  dishId: string,
+  menus: WixMenu[],
+  sections: WixSection[],
+  hint: { menuId?: string; sectionId?: string } = {},
+): DishPlacement | undefined {
+  const listing = new Map(sections
+    .filter((section) => !!section?.id && section.visible !== false && (section.itemIds ?? []).includes(dishId))
+    .map((section) => [section.id, section]));
+  const candidates: DishPlacement[] = [];
+  for (const menu of menus) {
+    if (!menu?.id || menu.visible === false) continue;
+    for (const sectionId of menu.sectionIds ?? []) {
+      if (listing.has(sectionId)) candidates.push({ menuId: menu.id, sectionId, businessLocationId: menu.businessLocationId });
+    }
+  }
+  return candidates.find((c) => c.sectionId === hint.sectionId && (!hint.menuId || c.menuId === hint.menuId)) ?? candidates[0];
+}
+
+export async function loadDishPlacement(dishId: string, hint: { menuId?: string; sectionId?: string }): Promise<DishPlacement | undefined> {
+  const [sections, menus] = await Promise.all([
+    querySections({ paging: { limit: 100 } }),
+    queryMenus({ paging: { limit: 50 } }),
+  ]);
+  return pickPlacement(dishId, menus.menus ?? [], sections.sections ?? [], hint);
+}
+
+/** The catalog reference for one dish line. There is no `variantId` key in `options`. */
+export function dishReference(dishId: string, operationId: string, placement: DishPlacement): WixCatalogReference {
+  return {
+    appId: RESTAURANTS_ORDERS_APP_ID,
+    catalogItemId: dishId,
+    options: {
+      operationId,
+      menuId: placement.menuId,
+      menuSectionId: placement.sectionId,
+      sectionId: placement.sectionId,
+    },
+  };
+}
+
+export function isRestaurantLine(line: WixCartV2LineItem | undefined): boolean {
+  return line?.source?.catalogReference?.appId === RESTAURANTS_ORDERS_APP_ID;
+}
+
+function lineVariantId(line: WixCartV2LineItem): string {
+  const variant = (line.source?.catalogReference?.options as { priceVariant?: { id?: unknown } } | undefined)?.priceVariant;
+  return typeof variant?.id === "string" ? variant.id : "";
+}
+
+/** The cart line Wix kept for [reference] — same dish, operation, menu, section and variant — or
+ *  undefined when Wix dropped it. Wix can refuse an item and still answer 200, so the returned cart
+ *  is the proof. The operation and menu matter: the same dish added from two restaurant locations
+ *  is two lines, and only the one just added proves this add. */
+export function addedLine(cart: WixCartV2 | undefined, reference: WixCatalogReference): WixCartV2LineItem | undefined {
+  type PlacementOptions = { operationId?: unknown; menuId?: unknown; menuSectionId?: unknown };
+  const options = (reference.options ?? {}) as PlacementOptions & { priceVariant?: { id?: unknown } };
+  const variantId = typeof options.priceVariant?.id === "string" ? options.priceVariant.id : "";
+  return (cart?.lineItems ?? []).find((line) => {
+    const ref = line.source?.catalogReference;
+    if (!ref || ref.appId !== reference.appId || ref.catalogItemId !== reference.catalogItemId) return false;
+    const lineOptions = (ref.options ?? {}) as PlacementOptions;
+    if (lineOptions.operationId !== options.operationId || lineOptions.menuId !== options.menuId) return false;
+    if (lineOptions.menuSectionId !== options.menuSectionId) return false;
+    if (lineVariantId(line) !== variantId) return false;
+    if (line.status === "OUT_OF_STOCK" || line.status === "REMOVED_FROM_CATALOG") return false;
+    const confirmed = line.quantityInfo?.confirmedQuantity;
+    return confirmed === undefined || confirmed > 0;
+  });
+}
+
+export function lineQuantity(line: WixCartV2LineItem): number {
+  const q = line.quantityInfo?.confirmedQuantity ?? line.quantityInfo?.requestedQuantity ?? 1;
+  return Number.isFinite(q) && q >= 0 ? Math.floor(q) : 0;
+}
+
+/** How many dishes the cart holds (restaurant lines only). */
+export function restaurantItemCount(cart: WixCartV2 | undefined): number {
+  return (cart?.lineItems ?? []).filter(isRestaurantLine).reduce((total, line) => total + lineQuantity(line), 0);
+}
+
+export function slotFor(slots: WixFulfillmentTimeSlot[] | undefined, type: FulfillmentType): WixFulfillmentTimeSlot | undefined {
+  return (slots ?? []).find((slot) => slot?.fulfilmentType === type);
+}
+
+/** The `deliveryMethod.code` for [type]: `<TYPE>|ASAP`, or the slot's own window for a pre-order.
+ *  An ASAP slot must be sent as ASAP — its start/end window is refused as `DELIVERY_METHOD_NOT_FOUND`. */
+export function deliveryCode(type: FulfillmentType, slot?: WixFulfillmentTimeSlot): string {
+  const window = slot?.timeSlot;
+  if (window?.orderSchedulingType === "PREORDER") {
+    const start = Date.parse(window.startTime ?? ""), end = Date.parse(window.endTime ?? "");
+    if (Number.isFinite(start) && Number.isFinite(end)) return `${type}|${start}|${end}`;
+  }
+  return `${type}|ASAP`;
+}
+
+export async function firstSlots(operationId: string, deliveryAddress?: WixRestaurantsAddress): Promise<WixFulfillmentTimeSlot[]> {
+  return (await getFirstAvailableTimeSlotPerFulfillmentType(operationId, deliveryAddress)).timeslotsPerFulfillmentType ?? [];
+}
+
+/** The pickup address the cart needs before a pickup method can be set: the restaurant's own
+ *  country (and region when Wix gives one) — Wix requires an address even for pickup. */
+export function pickupCartAddress(method: WixFulfillmentMethod | undefined, fallbackCountry = ""): WixRestaurantsAddress | undefined {
+  const address = method?.pickupOptions?.address;
+  const country = (address?.country || fallbackCountry).trim();
+  if (!country) return undefined;
+  return { country, ...(address?.subdivision ? { subdivision: address.subdivision } : {}) };
+}

package/templates/beauty-salon/tier5-src/himi-branded-lite-cart/index.ts

@@ -1,6 +1,7 @@
 import { withOnlineWrites } from "../_shared/online-actions.js";
 import { defineService as registerState } from "@himalaya/state";
 import { getStoreProduct } from "../_shared/himi-store.js";
+import { RESTAURANTS_ORDERS_APP_ID } from "../_shared/restaurant-ordering.js";
 import { iapPriceCopy } from "../_shared/iap-worker.js";
 import { withIapPresentation } from "../_shared/iap-presentation.js";
 import { type IapCommerce, classifyCart } from "@himalaya/iap-checkout";
@@ -523,6 +524,11 @@ const svc = defineService<State, {
         const commerce = cartPricing;
         const items = lines.map(line => (line as WixCartLineItemDetail & { catalogReference?: Row["catalogReference"] }).catalogReference);
         if (items.some(item => !item?.catalogItemId || !item.appId)) return derive({ ...state, checkoutHint: iapPriceCopy("cart").purchaseUnavailable });
+        // Restaurant dishes share this Wix cart but check out on the food order screen; this checkout
+        // takes Stores products only, so say which lines are in the way rather than "unavailable".
+        if (items.some(item => item!.appId === RESTAURANTS_ORDERS_APP_ID)) {
+          return derive({ ...state, checkoutHint: copyParam("cart.restaurantItemsHint", "This cart also has restaurant dishes. Remove them here to check out your store items.") });
+        }
         await commerce.loadPrices(items.map((item, index) => ({ reference: { kind: "storesProduct", id: item!.catalogItemId }, commerceDisplayPrice: lines[index].price?.formattedAmount })));
         const classification = classifyCart(items.map((item, index) => ({ route: commerce.pricing.view({ kind: "storesProduct", id: item!.catalogItemId }).route, quantity: lines[index].quantity ?? 1 })));
         if (classification !== "regular") return derive({ ...state, checkoutHint: classification === "mixedRefused" ? copyParam("cart.iapSingleItemOnly", "Buy digital items individually, with quantity 1 and no options.") : iapPriceCopy("cart").purchaseUnavailable });

package/templates/branded-lite/config.ts

@@ -1033,7 +1033,7 @@ export default defineApp({
   // Your on-device database. It must declare every entity a worker reads or writes,
   // or those calls fail closed — keep it in step with `local_database` above.
   dataSchema: {
-    "version": 1,
+    "version": 2,
     "entities": [
       {
         "name": "products",
@@ -1158,6 +1158,17 @@ export default defineApp({
           }
         ]
       },
+      {
+        "name": "food_orders",
+        "encrypted": true,
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          }
+        ]
+      },
       {
         "name": "member_bookings",
         "encrypted": true,