Page data contract

interface MountContext {
  store: StoreData;
  themeSettings: ThemeSettingsV3;
  page: PageContext;
  locale: "en" | "ar";
  direction: "ltr" | "rtl";
  currency: string;             // e.g. "EGP", "USD"
}

interface StoreData {
  id: string;
  name: string;
  subdomain: string;
  default_language: "en" | "ar";
  currency: string;
  logo_url: string | null;
  favicon_url: string | null;
  contact_email: string | null;
  contact_phone: string | null;
  settings: Record<string, unknown>;   // free-form, includes payment + tax + analytics
}

interface ThemeSettingsV3 {
  theme_id: string;                    // e.g. "bazar" for built-in, or your published theme id
  external_theme?: {
    bundle_url: string;
    css_url?: string;
  };
  settings: Record<string, unknown>;   // resolved per settings_schema.json
  templates?: {
    home?: PageTemplate;
    product?: PageTemplate;
    collection?: PageTemplate;
    cart?: PageTemplate;
    [k: string]: PageTemplate | undefined;
  };
  // ... locales, presets, variants (theme color palettes), etc.
}

interface PageTemplate {
  sections: Record<string, SectionInstance>;
  order: string[];                     // section ids in render order
}

interface SectionInstance {
  type: string;                        // matches schemas/sections/<type>.json
  settings: Record<string, unknown>;
  blocks?: Record<string, BlockInstance>;
  block_order?: string[];
  disabled?: boolean;
}

{ type: "home", title?: string }

{
  type: "product",
  title: product.name,
  handle: slug,
  data: { product: Product }   // includes options[] + variants[] post-Phase 8.1
}

{
  type: "collection",
  title: collection.name,
  handle: slug,
  data: { collection: Category, products: Product[], pagination: {...} }
}

{ type: "cart", title: "Cart" }

{
  type: "search",
  data: { query: string, products: Product[], collections: Category[], pagination }
}

interface Product {
  id: string;
  name: string;
  slug: string;
  description: string;
  short_description: string | null;
  product_type: "physical" | "digital" | "gift_card";
  status: "active" | "draft" | "archived";
  price: number;                       // major units, e.g. 99.00
  compare_at_price?: number;
  currency: string;
  sku: string | null;
  quantity: number | null;             // sum across variants
  in_stock: boolean;
  is_low_stock: boolean;
  is_on_sale: boolean;
  images: Array<{ url: string; alt?: string }>;
  tags: string[];
  category_id: string | null;
  attributes: Record<string, unknown>;  // free-form
  options: ProductOption[];            // Phase 8.1 axes
  variants: ProductVariant[];          // Phase 8.1
}

interface ProductOption {
  name: string;                        // e.g. "Size"
  position: number;
  values?: string[];                   // e.g. ["S", "M", "L"]
}

interface ProductVariant {
  id: string;
  option_values: Record<string, string>;  // { Size: "M", Color: "Red" }
  price: string;                       // decimal string
  compare_at_price: string | null;
  sku: string | null;
  inventory_quantity: number;
  is_in_stock: boolean;
  image_url: string | null;
}

interface Cart {
  items: CartLineItem[];
  item_count: number;
  total_quantity: number;
  subtotal: number;                    // cents
  currency: string;
  applied_promotion?: { code?: string; label?: string; amount: number } | null;
}

interface CartLineItem {
  id: string;                          // line item key
  product_id: string;
  variant_id: string | null;
  product_name: string;
  variant_name: string | null;         // "Size: M / Color: Red"
  sku: string | null;
  quantity: number;
  unit_price: number;                  // cents, snapshotted at add-time
  total_price: number;                 // cents
  current_price: number;               // cents, LIVE
  price_changed: boolean;              // current vs unit
  image_url: string | null;
  in_stock: boolean;
  available_now: number | null;
  sold_out_now: boolean;
}

interface Order {
  id: string;
  order_number: string;
  status: "pending" | "pending_deposit" | "confirmed" | "processing" |
          "shipped" | "delivered" | "cancelled" | "returned";
  payment_status: "pending" | "paid" | "refunded" | "partially_refunded" | "failed";
  fulfillment_status: "unfulfilled" | "partial" | "fulfilled";
  currency: string;
  subtotal: number;                    // cents
  shipping_cost: number;
  tax_amount: number;
  discount_amount: number;
  total: number;
  line_items: OrderLineItem[];
  shipping_address: Address;
  billing_address: Address;
  payment_method: string;
  shipping_method: string | null;
  coupon_code: string | null;
  customer_notes: string | null;
  created_at: string;
  shipped_at?: string;
  delivered_at?: string;
  metadata?: {
    gift_cards_applied?: Array<{ gift_card_id: string; last_four: string; amount_cents: number }>;
    gift_card_tender_total_cents?: number;
    tax_breakdown?: { rate: number; inclusive: boolean; added_cents: number; included_cents: number };
  };
}

interface Customer {
  id: string;
  email: string;
  first_name: string | null;
  last_name: string | null;
  phone: string | null;
  total_orders: number;
  total_spent: number;
  created_at: string;
  default_address_id: string | null;
}