@numueg/theme-sdk 0.12.0 → 0.13.1

package/dist/chunk-WNMFED3F.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contexts/index.ts","../src/hooks/useLocalization.ts","../src/hooks/useShop.ts","../src/hooks/useCustomer.ts","../src/hooks/useThemeSettings.ts","../src/hooks/usePage.ts","../src/hooks/useProducts.ts","../src/hooks/useCollections.ts"],"names":["createContext","useContext","useMemo","useState","useEffect"],"mappings":";;;;;AAmFO,IAAM,WAAA,GAAcA,oBAA4B,IAAI;AACpD,IAAM,cAAA,GAAiBA,oBAA8B,IAAI;AACzD,IAAM,iBAAA,GAAoBA,oBAAiC,IAAI;AAC/D,IAAM,WAAA,GAAcA,oBAAuC,IAAI;AAC/D,IAAM,eAAA,GAAkBA,oBAA+B,IAAI;AAC3D,IAAM,oBAAA,GAAuBA,oBAAsC,IAAI;AACvE,IAAM,mBAAA,GAAsBA,oBAAwC,IAAI;AACxE,IAAM,WAAA,GAAcA,oBAA2B,IAAI;AASnD,IAAM,sBAAA,GAAyBA,oBAAsB,MAAM;AAqC3D,IAAM,iBAAA,GAAoBA,mBAAA;AAAA,EAC/B;AACF;AAiDO,IAAM,eAAA,GAAkBA,oBAAoC,IAAI;ACvLhE,SAAS,eAAA,GAAqC;AACnD,EAAA,MAAM,GAAA,GAAMC,iBAAW,mBAAmB,CAAA;AAC1C,EAAA,IAAI,CAAC,GAAA,EAAK,MAAM,IAAI,MAAM,kDAAkD,CAAA;AAC5E,EAAA,OAAO,GAAA;AACT;AAEO,SAAS,YAAA,GAA8B;AAC5C,EAAA,MAAM,EAAE,SAAA,EAAU,GAAI,eAAA,EAAgB;AACtC,EAAA,OAAO,SAAA;AACT;AAEO,SAAS,SAAA,GAAoB;AAClC,EAAA,MAAM,EAAE,MAAA,EAAO,GAAI,eAAA,EAAgB;AACnC,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,cAAA,GAAiB;AAC/B,EAAA,MAAM,EAAE,YAAA,EAAc,MAAA,EAAO,GAAI,eAAA,EAAgB;AACjD,EAAA,OAAO;AAAA,IACL,GAAG,CAAC,GAAA,EAAa,aAAsB,YAAA,CAAa,GAAG,KAAK,QAAA,IAAY,GAAA;AAAA,IACxE;AAAA,GACF;AACF;AAuBO,SAAS,mBAAA,CAEd,QAA8B,KAAA,EAAmC;AACjE,EAAA,MAAM,EAAE,MAAA,EAAO,GAAI,eAAA,EAAgB;AACnC,EAAA,IAAI,CAAC,QAAQ,OAAO,MAAA;AAIpB,EAAA,MAAM,UAAA,GACJ,MAAA,CAAO,UAAA,IAAc,OAAO,OAAO,UAAA,KAAe,QAAA,GAC7C,MAAA,CAAO,UAAA,CAAuC,CAAA,EAAG,KAAK,CAAA,CAAA,EAAI,MAAM,EAAE,CAAA,GACnE,MAAA;AACN,EAAA,IAAI,OAAO,UAAA,KAAe,QAAA,IAAY,UAAA,EAAY,OAAO,UAAA;AAEzD,EAAA,MAAM,IAAA,GAAQ,OAA8C,KAAK,CAAA;AACjE,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,EAAU,OAAO,IAAA;AACrC,EAAA,IAAI,IAAA,IAAQ,MAAM,OAAO,MAAA;AACzB,EAAA,OAAO,OAAO,IAAI,CAAA;AACpB;AAaO,SAAS,eAAA,GAAkB;AAChC,EAAA,MAAM,EAAE,YAAA,EAAa,GAAI,eAAA,EAAgB;AACzC,EAAA,OAAO,YAAA;AACT;AClDA,IAAM,gBAAA,GACJ,OAAO,MAAA,KAAW,WAAA,GACd,MAAA,CAAO,SAAS,QAAA,CAAS,OAAA,CAAQ,GAAA,EAAK,EAAE,CAAA,GACxC,OAAA;AAEN,SAAS,cAAc,KAAA,EAAsB;AAI3C,EAAA,IAAI,KAAA,CAAM,MAAA,EAAQ,OAAO,KAAA,CAAM,MAAA;AAC/B,EAAA,IAAI,MAAM,SAAA,EAAW;AAOnB,IAAA,MAAM,QAAA,GACH,OAAO,MAAA,KAAW,WAAA,IAChB,OACE,sBAAA,IACL,YAAA;AACF,IAAA,OAAO,CAAA,EAAG,KAAA,CAAM,SAAS,CAAA,CAAA,EAAI,QAAQ,CAAA,CAAA;AAAA,EACvC;AACA,EAAA,OAAO,KAAA,CAAM,IAAA;AACf;AAEO,SAAS,OAAA,GAA2B;AACzC,EAAA,MAAM,GAAA,GAAMA,iBAAW,WAAW,CAAA;AAClC,EAAA,IAAI,CAAC,GAAA,EAAK,MAAM,IAAI,MAAM,0CAA0C,CAAA;AACpE,EAAA,MAAM,SAAS,SAAA,EAAU;AAEzB,EAAA,OAAOC,cAAQ,MAAM;AACnB,IAAA,MAAM,MAAA,GAAS,cAAc,GAAG,CAAA;AAChC,IAAA,MAAM,WAAY,GAAA,CACf,QAAA;AACH,IAAA,MAAM,mBAAA,GAAsB,OAAA;AAAA,MAC1B,YAAa,QAAA,CAAqD;AAAA,KACpE;AACA,IAAA,MAAM,aAAA,GAAgB,IAAI,gBAAA,IAAoB,IAAA;AAK9C,IAAA,MAAM,eAAA,GACH,UACG,yBAAA,IAA6B,IAAA;AACnC,IAAA,MAAM,YAAA,GAAe,CAAC,CAAA,KAAuB;AAC3C,MAAA,IAAI,CAAC,qBAAqB,OAAO,KAAA;AACjC,MAAA,IAAI,eAAA,EAAiB,OAAO,eAAA,CAAgB,QAAA,CAAS,CAAC,CAAA;AACtD,MAAA,OAAO,CAAA,KAAM,aAAA;AAAA,IACf,CAAA;AAEA,IAAA,MAAM,SAAA,GAAY,CAAC,IAAA,KAAyB;AAC1C,MAAA,IAAI,CAAC,IAAA,EAAM,OAAO,CAAA,EAAG,gBAAgB,MAAM,MAAM,CAAA,CAAA,CAAA;AAEjD,MAAA,IAAI,eAAA,CAAgB,IAAA,CAAK,IAAI,CAAA,EAAG,OAAO,IAAA;AAEvC,MAAA,IAAI,IAAA,CAAK,WAAW,IAAI,CAAA,SAAU,CAAA,EAAG,gBAAgB,IAAI,IAAI,CAAA,CAAA;AAC7D,MAAA,IAAI,aAAa,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA,GAAI,IAAA,GAAO,IAAI,IAAI,CAAA,CAAA;AACvD,MAAA,IAAI,MAAA,IAAU,YAAA,CAAa,MAAM,CAAA,EAAG;AAGlC,QAAA,MAAM,MAAA,GAAS,IAAI,MAAM,CAAA,CAAA,CAAA;AACzB,QAAA,MAAM,IAAA,GAAO,IAAI,MAAM,CAAA,CAAA;AACvB,QAAA,IAAI,eAAe,IAAA,IAAQ,CAAC,UAAA,CAAW,UAAA,CAAW,MAAM,CAAA,EAAG;AACzD,UAAA,UAAA,GAAa,CAAA,EAAG,IAAI,CAAA,EAAG,UAAU,CAAA,CAAA;AAAA,QACnC;AAAA,MACF;AACA,MAAA,OAAO,CAAA,EAAG,gBAAgB,CAAA,GAAA,EAAM,MAAM,GAAG,UAAU,CAAA,CAAA;AAAA,IACrD,CAAA;AACA,IAAA,OAAO,EAAE,GAAG,GAAA,EAAK,MAAA,EAAQ,SAAA,EAAU;AAAA,EACrC,CAAA,EAAG,CAAC,GAAA,EAAK,MAAM,CAAC,CAAA;AAClB;ACtGO,SAAS,WAAA,GAA+B;AAC7C,EAAA,OAAOD,iBAAW,eAAe,CAAA;AACnC;ACFO,SAAS,gBAAA,GAAoC;AAClD,EAAA,MAAM,GAAA,GAAMA,iBAAW,oBAAoB,CAAA;AAC3C,EAAA,IAAI,CAAC,GAAA,EAAK,MAAM,IAAI,MAAM,mDAAmD,CAAA;AAC7E,EAAA,OAAO,GAAA;AACT;ACJO,SAAS,OAAA,GAAuB;AACrC,EAAA,OAAOA,iBAAW,WAAW,CAAA;AAC/B;AC4BO,SAAS,WAAA,CACd,IAAA,GAA2B,EAAC,EACT;AACnB,EAAA,MAAM,EAAE,KAAA,EAAO,cAAA,GAAiB,KAAA,EAAM,GAAI,IAAA;AAC1C,EAAA,MAAM,OAAO,OAAA,EAAQ;AACrB,EAAA,MAAM,OAAO,OAAA,EAAQ;AACrB,EAAA,MAAM,OAAA,GAAW,IAAA,EAAM,IAAA,EAAM,QAAA,IAAsC,IAAA;AAEnE,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,IAAIE,cAAA,CAAoB,OAAA,IAAW,EAAE,CAAA;AACjE,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,cAAA;AAAA,IAC5B,WAAW,IAAA,IAAQ;AAAA,GACrB;AACA,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAAuB,IAAI,CAAA;AAErD,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,WAAW,IAAA,EAAM;AACrB,IAAA,IAAI,CAAC,cAAA,EAAgB;AACrB,IAAA,IAAI,CAAC,MAAM,EAAA,EAAI;AACf,IAAA,IAAI,SAAA,GAAY,KAAA;AAChB,IAAA,CAAC,YAAY;AACX,MAAA,IAAI;AACF,QAAA,MAAM,SAAS,IAAI,eAAA,CAAgB,EAAE,QAAA,EAAU,IAAA,CAAK,IAAI,CAAA;AACxD,QAAA,IAAI,OAAO,MAAA,CAAO,GAAA,CAAI,OAAA,EAAS,MAAA,CAAO,KAAK,CAAC,CAAA;AAC5C,QAAA,MAAM,MAAM,MAAM,KAAA,CAAM,iBAAiB,MAAA,CAAO,QAAA,EAAU,CAAA,CAAE,CAAA;AAC5D,QAAA,IAAI,CAAC,IAAI,EAAA,EAAI,MAAM,IAAI,KAAA,CAAM,CAAA,qBAAA,EAAmB,GAAA,CAAI,MAAM,CAAA,CAAE,CAAA;AAC5D,QAAA,MAAM,IAAA,GAAQ,MAAM,GAAA,CAAI,IAAA,EAAK;AAC7B,QAAA,IAAI,SAAA,EAAW;AACf,QAAA,WAAA,CAAY,IAAA,CAAK,QAAA,IAAY,EAAE,CAAA;AAC/B,QAAA,UAAA,CAAW,KAAK,CAAA;AAAA,MAClB,SAAS,GAAA,EAAK;AACZ,QAAA,IAAI,SAAA,EAAW;AACf,QAAA,QAAA,CAAS,GAAA,YAAe,QAAQ,GAAA,GAAM,IAAI,MAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA;AAC5D,QAAA,UAAA,CAAW,KAAK,CAAA;AAAA,MAClB;AAAA,IACF,CAAA,GAAG;AACH,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AAAA,IACd,CAAA;AAAA,EACF,GAAG,CAAC,OAAA,EAAS,gBAAgB,KAAA,EAAO,IAAA,EAAM,EAAE,CAAC,CAAA;AAE7C,EAAA,MAAM,SAAS,KAAA,IAAS,IAAA,GAAO,SAAS,KAAA,CAAM,CAAA,EAAG,KAAK,CAAA,GAAI,QAAA;AAC1D,EAAA,OAAO,EAAE,QAAA,EAAU,MAAA,EAAQ,OAAA,EAAS,KAAA,EAAM;AAC5C;AC/CA,SAAS,kBAAkB,IAAA,EAA6B;AACtD,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,EAAG,OAAO,IAAA;AAChC,EAAA,MAAM,GAAA,GAAM,IAAA;AAOZ,EAAA,IAAI,MAAM,OAAA,CAAQ,GAAA,EAAK,WAAW,CAAA,SAAU,GAAA,CAAI,WAAA;AAChD,EAAA,IAAI,MAAM,OAAA,CAAQ,GAAA,EAAK,IAAI,CAAA,SAAU,GAAA,CAAI,IAAA;AACzC,EAAA,MAAM,KAAA,GAAS,KAAK,IAAA,EAA0C,KAAA;AAC9D,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG,OAAO,KAAA;AACjC,EAAA,OAAO,EAAC;AACV;AAOO,SAAS,cAAA,CACd,IAAA,GAA8B,EAAC,EACT;AACtB,EAAA,MAAM,EAAE,KAAA,EAAO,cAAA,GAAiB,KAAA,EAAM,GAAI,IAAA;AAC1C,EAAA,MAAM,OAAO,OAAA,EAAQ;AACrB,EAAA,MAAM,OAAO,OAAA,EAAQ;AACrB,EAAA,MAAM,OAAA,GAAW,IAAA,EAAM,IAAA,EAAM,WAAA,IAA4C,IAAA;AAEzE,EAAA,MAAM,CAAC,WAAA,EAAa,cAAc,IAAID,cAAAA,CAAuB,OAAA,IAAW,EAAE,CAAA;AAC1E,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,cAAAA;AAAA,IAC5B,WAAW,IAAA,IAAQ;AAAA,GACrB;AACA,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAAuB,IAAI,CAAA;AAErD,EAAAC,gBAAU,MAAM;AACd,IAAA,IAAI,WAAW,IAAA,EAAM;AACrB,IAAA,IAAI,CAAC,cAAA,EAAgB;AACrB,IAAA,IAAI,CAAC,MAAM,EAAA,EAAI;AACf,IAAA,IAAI,SAAA,GAAY,KAAA;AAChB,IAAA,CAAC,YAAY;AACX,MAAA,IAAI;AACF,QAAA,MAAM,SAAS,IAAI,eAAA,CAAgB,EAAE,QAAA,EAAU,IAAA,CAAK,IAAI,CAAA;AACxD,QAAA,MAAM,MAAM,MAAM,KAAA,CAAM,oBAAoB,MAAA,CAAO,QAAA,EAAU,CAAA,CAAE,CAAA;AAC/D,QAAA,IAAI,CAAC,IAAI,EAAA,EAAI,MAAM,IAAI,KAAA,CAAM,CAAA,wBAAA,EAAsB,GAAA,CAAI,MAAM,CAAA,CAAE,CAAA;AAC/D,QAAA,MAAM,IAAA,GAAQ,MAAM,GAAA,CAAI,IAAA,EAAK;AAC7B,QAAA,IAAI,SAAA,EAAW;AACf,QAAA,cAAA,CAAe,iBAAA,CAAkB,IAAI,CAAC,CAAA;AACtC,QAAA,UAAA,CAAW,KAAK,CAAA;AAAA,MAClB,SAAS,GAAA,EAAK;AACZ,QAAA,IAAI,SAAA,EAAW;AACf,QAAA,QAAA,CAAS,GAAA,YAAe,QAAQ,GAAA,GAAM,IAAI,MAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA;AAC5D,QAAA,UAAA,CAAW,KAAK,CAAA;AAAA,MAClB;AAAA,IACF,CAAA,GAAG;AACH,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AAAA,IACd,CAAA;AAAA,EACF,GAAG,CAAC,OAAA,EAAS,cAAA,EAAgB,IAAA,EAAM,EAAE,CAAC,CAAA;AAEtC,EAAA,MAAM,SAAS,KAAA,IAAS,IAAA,GAAO,YAAY,KAAA,CAAM,CAAA,EAAG,KAAK,CAAA,GAAI,WAAA;AAC7D,EAAA,OAAO,EAAE,WAAA,EAAa,MAAA,EAAQ,OAAA,EAAS,KAAA,EAAM;AAC/C","file":"chunk-WNMFED3F.cjs","sourcesContent":["\"use client\";\nimport { createContext } from \"react\";\nimport type { Store, Product, Collection, Cart, Customer, Page } from \"../types/entities\";\nimport type { ThemeSettingsV3 } from \"../types/theme\";\n\nexport interface LocalizationState {\n  locale: string;\n  direction: \"ltr\" | \"rtl\";\n  translations: Record<string, string>;\n  formatMoney: (amount: number, currency?: string) => string;\n  formatDate: (date: string | Date) => string;\n  /**\n   * Phase 3.7 — locale-aware number formatter. Routes to either\n   * Western (1234) or Arab-Indic (١٢٣٤) digits depending on\n   * `store.settings.numerals`. Themes calling formatMoney get the\n   * same digit choice automatically; this is for raw counts (\"12 items\").\n   */\n  formatNumber: (n: number, options?: Intl.NumberFormatOptions) => string;\n  /**\n   * Phase 3.6 — switch the active locale.\n   *\n   * Sets the `numu_locale` cookie and triggers a full page reload so\n   * the server-rendered layout picks up the new locale (the storefront\n   * resolves locale at SSR time from cookie/query). Returns once the\n   * cookie is written; the page navigation cancels any pending React\n   * work so callers don't need to await.\n   */\n  setLocale: (next: string) => void;\n  /**\n   * Phase 3.6 — list of locales the store advertises. Empty when the\n   * store hasn't configured a multi-locale catalog. Themes use this\n   * to decide whether to render the LocaleSwitcher at all.\n   */\n  availableLocales: string[];\n}\n\n/**\n * Result of a cart mutation (add / remove / update / discount / note).\n *\n * `ok` mirrors the HTTP result: `false` for any non-2xx response — an\n * out-of-stock or validation rejection, a 403 CSRF failure, etc. — so a\n * theme can surface the failure (toast, inline error) instead of assuming\n * the write landed. `status` is the HTTP status (0 for a network throw that\n * the caller catches); `message` carries the backend's error text when the\n * error body parses.\n *\n * Back-compat: the cart methods previously resolved `Promise<void>`; callers\n * that `await` them and ignore the return keep working unchanged — the\n * resolved value is purely additive.\n */\nexport interface CartMutationResult {\n  ok: boolean;\n  status: number;\n  message?: string;\n  /** The cart applied by a successful write (MAJOR currency units, same\n   *  normalization as `useCart().cart`). Lets callers read the written\n   *  state — e.g. addItem prices its AddToCart analytics event from the\n   *  added line — without racing React state. Absent on failure. */\n  cart?: Cart;\n}\n\nexport interface CartContextValue {\n  cart: Cart;\n  addItem: (\n    productId: string,\n    variantId?: string,\n    quantity?: number,\n    /** Picker axes ({Color: \"Black\", Size: \"L\"}) — variant_name fallback for\n     *  products whose variant rows carry no option_values. */\n    selectedOptions?: Record<string, string>,\n  ) => Promise<CartMutationResult>;\n  removeItem: (itemId: string) => Promise<CartMutationResult>;\n  updateQuantity: (\n    itemId: string,\n    quantity: number,\n  ) => Promise<CartMutationResult>;\n  applyDiscount: (code: string) => Promise<CartMutationResult>;\n  removeDiscount: () => Promise<CartMutationResult>;\n  updateNote: (note: string) => Promise<CartMutationResult>;\n  clearCart: () => Promise<void>;\n  loading: boolean;\n}\n\nexport const ShopContext = createContext<Store | null>(null);\nexport const ProductContext = createContext<Product | null>(null);\nexport const CollectionContext = createContext<Collection | null>(null);\nexport const CartContext = createContext<CartContextValue | null>(null);\nexport const CustomerContext = createContext<Customer | null>(null);\nexport const ThemeSettingsContext = createContext<ThemeSettingsV3 | null>(null);\nexport const LocalizationContext = createContext<LocalizationState | null>(null);\nexport const PageContext = createContext<Page | null>(null);\n/**\n * Wave 5 — currently-active template identifier. Mirrors the key inside\n * `themeSettings.templates.<currentTemplate>` so themes can dispatch\n * which section list to render. Hosts set this via `NuMuProvider`'s\n * `currentTemplate` prop (which is passed in by the storefront page\n * component — `app/(store)/[subdomain]/product/[id]/page.tsx` passes\n * \"product\", `cart/page.tsx` passes \"cart\", etc.). Falls back to \"home\".\n */\nexport const CurrentTemplateContext = createContext<string>(\"home\");\n\n/**\n * A merchant-managed navigation menu item, exactly as the storefront\n * menus resolver returns it (`GET /storefront/store/{id}/menus`):\n * bilingual `label`, a pre-resolved `url`, and nested `children`.\n *\n * This is the RAW shape the host injects via `NuMuProvider`'s\n * `navigation` prop. `useNavigation(handle)` localizes it to the\n * display-ready `NavigationItem` (a single `title` string for the\n * active locale).\n */\nexport interface MenuItemData {\n  id: string;\n  label: Record<string, string>;\n  url: string;\n  type?: string | null;\n  resource_id?: string | null;\n  /**\n   * §5 hide-page → hide-nav-link. `false` when the item targets a CMS page\n   * (`/pages/<handle>`) that is currently unpublished or deleted. The backend\n   * menus resolver annotates it; absent/`true` means visible (back-compat).\n   */\n  target_visible?: boolean;\n  children?: MenuItemData[];\n}\n\n/**\n * Phase 2.4 — navigation menus keyed by handle (`main-menu`, `footer`,\n * plus custom), injected by the host from the storefront resolver so a\n * theme's `useNavigation(handle)` resolves without a client round-trip.\n *\n * Defaults to `{}` — an empty map signals \"host provided no menus\", at\n * which point `useNavigation` falls back to its own fetch / a theme's\n * `DEFAULT_NAV`. A present-but-handle-absent map means the menu simply\n * doesn't exist (render nothing / fallback), no fetch attempted.\n */\nexport const NavigationContext = createContext<Record<string, MenuItemData[]>>(\n  {},\n);\n\n/**\n * Multi-currency presentment config, as returned by\n * `GET /api/storefront/currencies`. Display-only — the store's *capture*\n * currency never changes mid-session; this just lets visitors browse prices\n * in a currency they recognize.\n */\nexport interface CurrencyConfig {\n  base: string;\n  default_presentment: string;\n  presentment: string[];\n  rates: Record<string, string>; // Decimal-as-string\n  auto_convert: boolean;\n}\n\n/**\n * The value `useCurrency()` returns and `CurrencyContext` carries.\n *\n * `convert(cents, target?)` returns the converted **cents** in `target`\n * (defaults to `selected`), using the API rates; returns the input unchanged\n * when no rate exists (theme renders base — better than a wrong number).\n */\nexport interface CurrencyState {\n  base: string;\n  selected: string;\n  presentment: string[];\n  rates: Record<string, number>;\n  autoConvert: boolean;\n  loading: boolean;\n  setSelected: (currency: string) => void;\n  convert: (cents: number, target?: string) => number;\n}\n\n/**\n * Phase 2 (correctness) — multi-currency lifted into a provider context.\n *\n * Previously `useCurrency()` fetched `/api/storefront/currencies` and held\n * the selected currency in per-instance `useState`, so each `<Money>`,\n * `useMoney()` and `<CurrencySwitcher>` owned an INDEPENDENT copy: switching\n * currency in the switcher never reached the price tags, and every consumer\n * re-fetched. `NuMuProvider` now fetches ONCE and publishes a single\n * `CurrencyState` here, so a `<CurrencySwitcher>` change re-renders every\n * `<Money>` on the page without a reload.\n *\n * Null when no provider is present (SSR before hydrate, or a theme mounted\n * outside `NuMuProvider`); `useCurrency()` then falls back to a base-only,\n * no-convert state derived from the store currency so `<Money>` still renders.\n */\nexport const CurrencyContext = createContext<CurrencyState | null>(null);\n","import { useContext } from \"react\";\nimport { LocalizationContext } from \"../contexts\";\nimport type { LocalizationState } from \"../contexts\";\n\nexport function useLocalization(): LocalizationState {\n  const ctx = useContext(LocalizationContext);\n  if (!ctx) throw new Error(\"useLocalization must be used within NuMuProvider\");\n  return ctx;\n}\n\nexport function useDirection(): \"ltr\" | \"rtl\" {\n  const { direction } = useLocalization();\n  return direction;\n}\n\nexport function useLocale(): string {\n  const { locale } = useLocalization();\n  return locale;\n}\n\nexport function useTranslation() {\n  const { translations, locale } = useLocalization();\n  return {\n    t: (key: string, fallback?: string) => translations[key] || fallback || key,\n    locale,\n  };\n}\n\n/**\n * Phase 3.6 — pull a translated field off a domain object.\n *\n * Convention: per-product translations live on `entity.attributes`\n * keyed as `<field>_<locale>` — e.g. `name_ar`, `description_ar`.\n * Backend writes these via the merchant hub when a merchant turns on\n * \"Translations\" for a product. Themes call:\n *\n *     const productName = useFieldTranslation(product, \"name\");\n *\n * and get the Arabic name when the active locale is \"ar\", falling\n * back to the English `product.name` otherwise. Works for any object\n * that pairs a base field on the entity with an `attributes` JSONB\n * blob holding the translated variants.\n *\n * Why not put translations on the entity itself? Adding `name_ar`,\n * `description_ar`, `name_he`, etc. as first-class columns means a\n * schema migration every time a merchant enables a new locale. JSONB\n * lets the merchant flip locales on/off in settings without touching\n * the table.\n */\nexport function useFieldTranslation<\n  T extends { attributes?: Record<string, unknown> },\n>(entity: T | null | undefined, field: string): string | undefined {\n  const { locale } = useLocalization();\n  if (!entity) return undefined;\n  // English (or whichever default locale the merchant configured) is\n  // stored as the base field; non-default locales live on attributes\n  // with a `<field>_<locale>` key.\n  const translated =\n    entity.attributes && typeof entity.attributes === \"object\"\n      ? (entity.attributes as Record<string, unknown>)[`${field}_${locale}`]\n      : undefined;\n  if (typeof translated === \"string\" && translated) return translated;\n  // Base field — supports any value type that stringifies sensibly.\n  const base = (entity as unknown as Record<string, unknown>)[field];\n  if (typeof base === \"string\") return base;\n  if (base == null) return undefined;\n  return String(base);\n}\n\n/**\n * Phase 3.7 — formatted-number hook.\n *\n * Themes that need to render counts (\"12 items\", \"3 reviews\") should\n * route through this hook so Arab-Indic digits (٠١٢٣٤) vs Western\n * (01234) stay consistent with money + date elsewhere on the page.\n *\n *     const fmtNum = useNumberFormat();\n *     fmtNum(12)              → \"12\"   (or \"١٢\" for Arabic stores)\n *     fmtNum(12.5, { minimumFractionDigits: 2 }) → \"12.50\" / \"١٢٫٥٠\"\n */\nexport function useNumberFormat() {\n  const { formatNumber } = useLocalization();\n  return formatNumber;\n}\n","\"use client\";\nimport { useContext, useMemo } from \"react\";\nimport { ShopContext } from \"../contexts\";\nimport { useLocale } from \"./useLocalization\";\nimport type { Store } from \"../types/entities\";\n\n/**\n * Augmented Store shape returned from useShop().\n *\n * Adds a couple of conveniences theme devs reach for constantly:\n *   - `domain` — the active hostname (subdomain or custom). Resolved\n *     from `store.domain ?? store.subdomain ?? store.slug`.\n *   - `formatUrl(path)` — emits a fully-qualified URL using `domain`.\n *     Theme code that needs to render absolute URLs (canonical tags,\n *     Open Graph, JSON-LD) goes through this so dev/prod / subdomain\n *     vs. custom-domain stays correct without each theme reinventing\n *     the resolver.\n */\nexport interface ShopWithHelpers extends Store {\n  /** Fully-qualified hostname this store currently serves on. */\n  domain: string;\n  /**\n   * Format a path (relative or absolute) as a fully-qualified URL on\n   * this store's domain. No-ops when given an already-absolute URL.\n   *\n   * Phase 6 — when the active locale is non-default and the store\n   * has opted into locale URL prefixes, the path is prefixed with\n   * `/{locale}/` (e.g. `/ar/products/foo`). Already-prefixed paths\n   * are left alone so calling `formatUrl(formatUrl(...))` is safe.\n   */\n  formatUrl(path: string): string;\n}\n\nconst DEFAULT_PROTOCOL =\n  typeof window !== \"undefined\"\n    ? window.location.protocol.replace(\":\", \"\")\n    : \"https\";\n\nfunction resolveDomain(store: Store): string {\n  // Custom domain wins when set; otherwise fall back to the platform\n  // subdomain. The slug is a last resort for stores that haven't been\n  // assigned either yet (mostly demo stores in dev).\n  if (store.domain) return store.domain;\n  if (store.subdomain) {\n    // The platform-domain default lives on the storefront; theme code\n    // doesn't have access to env vars, so we read it off the runtime\n    // window object when present and fall back to the well-known\n    // production value. Themes can override by rendering with\n    // `<meta name=\"numu:platform-domain\" content=\"...\">` if they're\n    // hosted on a non-default platform.\n    const platform =\n      (typeof window !== \"undefined\" &&\n        (window as unknown as { __NUMU_PLATFORM_DOMAIN?: string })\n          .__NUMU_PLATFORM_DOMAIN) ||\n      \"numueg.app\";\n    return `${store.subdomain}.${platform}`;\n  }\n  return store.slug;\n}\n\nexport function useShop(): ShopWithHelpers {\n  const ctx = useContext(ShopContext);\n  if (!ctx) throw new Error(\"useShop must be used within NuMuProvider\");\n  const locale = useLocale();\n\n  return useMemo(() => {\n    const domain = resolveDomain(ctx);\n    const settings = (ctx as Store & { settings?: Record<string, unknown> })\n      .settings;\n    const localePrefixEnabled = Boolean(\n      settings && (settings as { locale_url_prefix_enabled?: boolean }).locale_url_prefix_enabled,\n    );\n    const defaultLocale = ctx.default_language || \"en\";\n    // List of locales that get a URL prefix. Defaults to \"everything\n    // except the default\" — but a store can opt into `[\"ar\", \"en\"]`\n    // (prefix even the default) if it wants a fully prefixed URL\n    // scheme like Shopify does for markets.\n    const prefixedLocales =\n      (settings as { locale_url_prefix_locales?: string[] } | undefined)\n        ?.locale_url_prefix_locales || null;\n    const shouldPrefix = (l: string): boolean => {\n      if (!localePrefixEnabled) return false;\n      if (prefixedLocales) return prefixedLocales.includes(l);\n      return l !== defaultLocale;\n    };\n\n    const formatUrl = (path: string): string => {\n      if (!path) return `${DEFAULT_PROTOCOL}://${domain}/`;\n      // Already absolute? Hand back as-is.\n      if (/^https?:\\/\\//i.test(path)) return path;\n      // Protocol-relative — assume same protocol as the host.\n      if (path.startsWith(\"//\")) return `${DEFAULT_PROTOCOL}:${path}`;\n      let normalized = path.startsWith(\"/\") ? path : `/${path}`;\n      if (locale && shouldPrefix(locale)) {\n        // Idempotent: don't double-prefix if the caller already\n        // gave us a /{locale}/... path.\n        const prefix = `/${locale}/`;\n        const root = `/${locale}`;\n        if (normalized !== root && !normalized.startsWith(prefix)) {\n          normalized = `${root}${normalized}`;\n        }\n      }\n      return `${DEFAULT_PROTOCOL}://${domain}${normalized}`;\n    };\n    return { ...ctx, domain, formatUrl };\n  }, [ctx, locale]);\n}\n","import { useContext } from \"react\";\nimport { CustomerContext } from \"../contexts\";\nimport type { Customer } from \"../types/entities\";\n\nexport function useCustomer(): Customer | null {\n  return useContext(CustomerContext);\n}\n","import { useContext } from \"react\";\nimport { ThemeSettingsContext } from \"../contexts\";\nimport type { ThemeSettingsV3 } from \"../types/theme\";\n\nexport function useThemeSettings(): ThemeSettingsV3 {\n  const ctx = useContext(ThemeSettingsContext);\n  if (!ctx) throw new Error(\"useThemeSettings must be used within NuMuProvider\");\n  return ctx;\n}\n","import { useContext } from \"react\";\nimport { PageContext } from \"../contexts\";\nimport type { Page } from \"../types/entities\";\n\nexport function usePage(): Page | null {\n  return useContext(PageContext);\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\nimport { usePage } from \"./usePage\";\nimport { useShop } from \"./useShop\";\nimport type { Product } from \"../types/entities\";\n\ninterface UseProductsOptions {\n  /** Limit the slice returned. Defaults to whatever the host gave us. */\n  limit?: number;\n  /**\n   * When true, fetch from `/api/products` if the host didn't provide a\n   * list via PageContext. Useful for sections rendered on routes that\n   * don't pre-fetch products (e.g. a custom CMS page that wants a\n   * \"featured\" rail). Default: false — themes typically prefer SSR data.\n   */\n  fetchIfMissing?: boolean;\n}\n\ninterface UseProductsResult {\n  products: Product[];\n  loading: boolean;\n  error: Error | null;\n}\n\n/**\n * useProducts — read the storefront-pre-fetched product list from the\n * page context, optionally falling back to a client-side fetch.\n *\n * The SSR path passes `page.data.products: Product[]` from\n * `numu-storefront/src/app/[domain]/page.tsx`; sections on the home\n * route get them for free. For other routes that don't pre-fetch, set\n * `fetchIfMissing: true` and we'll hit `/api/products`.\n */\nexport function useProducts(\n  opts: UseProductsOptions = {},\n): UseProductsResult {\n  const { limit, fetchIfMissing = false } = opts;\n  const page = usePage();\n  const shop = useShop();\n  const initial = (page?.data?.products as Product[] | undefined) ?? null;\n\n  const [products, setProducts] = useState<Product[]>(initial ?? []);\n  const [loading, setLoading] = useState<boolean>(\n    initial == null && fetchIfMissing,\n  );\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    if (initial != null) return;\n    if (!fetchIfMissing) return;\n    if (!shop?.id) return;\n    let cancelled = false;\n    (async () => {\n      try {\n        const params = new URLSearchParams({ store_id: shop.id });\n        if (limit) params.set(\"limit\", String(limit));\n        const res = await fetch(`/api/products?${params.toString()}`);\n        if (!res.ok) throw new Error(`/api/products → ${res.status}`);\n        const data = (await res.json()) as { products?: Product[] };\n        if (cancelled) return;\n        setProducts(data.products ?? []);\n        setLoading(false);\n      } catch (err) {\n        if (cancelled) return;\n        setError(err instanceof Error ? err : new Error(String(err)));\n        setLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [initial, fetchIfMissing, limit, shop?.id]);\n\n  const sliced = limit != null ? products.slice(0, limit) : products;\n  return { products: sliced, loading, error };\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\nimport { usePage } from \"./usePage\";\nimport { useShop } from \"./useShop\";\nimport type { Collection } from \"../types/entities\";\n\ninterface UseCollectionsOptions {\n  limit?: number;\n  fetchIfMissing?: boolean;\n}\n\ninterface UseCollectionsResult {\n  collections: Collection[];\n  loading: boolean;\n  error: Error | null;\n}\n\n/**\n * Read a collection list out of whatever envelope the host answered with.\n *\n * `fetchIfMissing` was effectively DEAD before this: it read `data.collections`\n * while `/api/collections` proxies FastAPI verbatim and answers the platform\n * envelope `{ success, data: [...] }`. That lookup is `undefined`, so a theme\n * that opted into the fetch got a request followed by an EMPTY list — the same\n * blank menu it was trying to fix, only slower. Verified against the live\n * endpoint. All three shapes are accepted so the hook can't be re-broken by an\n * envelope change on either side.\n */\nfunction unwrapCollections(json: unknown): Collection[] {\n  if (Array.isArray(json)) return json as Collection[];\n  const obj = json as\n    | {\n        collections?: unknown;\n        data?: unknown;\n      }\n    | null\n    | undefined;\n  if (Array.isArray(obj?.collections)) return obj.collections as Collection[];\n  if (Array.isArray(obj?.data)) return obj.data as Collection[];\n  const items = (obj?.data as { items?: unknown } | undefined)?.items;\n  if (Array.isArray(items)) return items as Collection[];\n  return [];\n}\n\n/**\n * useCollections — analog to useProducts. Reads page.data.collections\n * pre-fetched by the storefront SSR; falls back to /api/collections\n * when fetchIfMissing is true.\n */\nexport function useCollections(\n  opts: UseCollectionsOptions = {},\n): UseCollectionsResult {\n  const { limit, fetchIfMissing = false } = opts;\n  const page = usePage();\n  const shop = useShop();\n  const initial = (page?.data?.collections as Collection[] | undefined) ?? null;\n\n  const [collections, setCollections] = useState<Collection[]>(initial ?? []);\n  const [loading, setLoading] = useState<boolean>(\n    initial == null && fetchIfMissing,\n  );\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    if (initial != null) return;\n    if (!fetchIfMissing) return;\n    if (!shop?.id) return;\n    let cancelled = false;\n    (async () => {\n      try {\n        const params = new URLSearchParams({ store_id: shop.id });\n        const res = await fetch(`/api/collections?${params.toString()}`);\n        if (!res.ok) throw new Error(`/api/collections → ${res.status}`);\n        const json = (await res.json()) as unknown;\n        if (cancelled) return;\n        setCollections(unwrapCollections(json));\n        setLoading(false);\n      } catch (err) {\n        if (cancelled) return;\n        setError(err instanceof Error ? err : new Error(String(err)));\n        setLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [initial, fetchIfMissing, shop?.id]);\n\n  const sliced = limit != null ? collections.slice(0, limit) : collections;\n  return { collections: sliced, loading, error };\n}\n"]}

package/dist/{entities-1XRRUTlO.d.mts → entities-DRKn04q0.d.mts}

@@ -194,6 +194,32 @@ interface Cart {
     discount_code?: string;
     discount_amount?: number;
     note?: string;
+    /**
+     * Total of the automatic (no-code) promotions priced into this cart, in
+     * MAJOR units — same convention as `subtotal` / `total` /
+     * `discount_amount`. `normalizeCartFromServer` converts it from the
+     * backend's `automatic_discount_cents` and renames it here on purpose:
+     * a field called `_cents` that holds pounds is the single easiest way to
+     * get a 100x bug into a theme.
+     */
+    automatic_discount?: number;
+    /**
+     * Which automatic offers fired, and what each one saved — same shape as
+     * `Order.applied_promotions` so one component renders the cart, the
+     * checkout summary and the order.
+     *
+     * ⚠️ `amount` is in MAJOR units here (unlike the identically-named field
+     * on `Order`, which a theme reads straight from the API in cents). The
+     * cart passes through `normalizeCartFromServer`; the order does not.
+     * Never divide these by 100 again, and never recompute a saving in the
+     * theme — this number is the engine's, and the engine is what charges.
+     */
+    applied_promotions?: {
+        id: string;
+        title: string;
+        title_ar?: string;
+        amount: number;
+    }[];
 }
 interface CartItem {
     id: string;
@@ -204,6 +230,12 @@ interface CartItem {
     price: number;
     quantity: number;
     variant_name?: string;
+    /**
+     * The product's category. Present so a theme can count how many cart units
+     * belong to a category-scoped offer (see `offerProgress`'s `eligibleUnits`)
+     * without a second fetch. Not always populated — treat it as a hint.
+     */
+    category_id?: string | null;
 }
 /** Customer entity */
 interface Customer {

package/dist/{entities-1XRRUTlO.d.ts → entities-DRKn04q0.d.ts}

@@ -194,6 +194,32 @@ interface Cart {
     discount_code?: string;
     discount_amount?: number;
     note?: string;
+    /**
+     * Total of the automatic (no-code) promotions priced into this cart, in
+     * MAJOR units — same convention as `subtotal` / `total` /
+     * `discount_amount`. `normalizeCartFromServer` converts it from the
+     * backend's `automatic_discount_cents` and renames it here on purpose:
+     * a field called `_cents` that holds pounds is the single easiest way to
+     * get a 100x bug into a theme.
+     */
+    automatic_discount?: number;
+    /**
+     * Which automatic offers fired, and what each one saved — same shape as
+     * `Order.applied_promotions` so one component renders the cart, the
+     * checkout summary and the order.
+     *
+     * ⚠️ `amount` is in MAJOR units here (unlike the identically-named field
+     * on `Order`, which a theme reads straight from the API in cents). The
+     * cart passes through `normalizeCartFromServer`; the order does not.
+     * Never divide these by 100 again, and never recompute a saving in the
+     * theme — this number is the engine's, and the engine is what charges.
+     */
+    applied_promotions?: {
+        id: string;
+        title: string;
+        title_ar?: string;
+        amount: number;
+    }[];
 }
 interface CartItem {
     id: string;
@@ -204,6 +230,12 @@ interface CartItem {
     price: number;
     quantity: number;
     variant_name?: string;
+    /**
+     * The product's category. Present so a theme can count how many cart units
+     * belong to a category-scoped offer (see `offerProgress`'s `eligibleUnits`)
+     * without a second fetch. Not always populated — treat it as a hint.
+     */
+    category_id?: string | null;
 }
 /** Customer entity */
 interface Customer {