@numueg/theme-sdk 0.6.1 → 0.10.0

package/dist/index.mjs

@@ -1,494 +1,13 @@
-import { createContext, forwardRef, useState, useImperativeHandle, useEffect, useCallback, useMemo, useRef, useContext, StrictMode, createElement, Component } from 'react';
+export { resolveThemeSettings } from './chunk-XF2FGIVS.mjs';
+export { KNOWN_SETTING_TYPES, KNOWN_TEMPLATES, REQUIRED_TEMPLATES, SDK_VERSION, THEME_CONTRACT_VERSION, mergeResults, validateBuiltManifest, validateManifest, validateSectionSchema, validateSettingsAgainstSchema } from './chunk-EB2ESBLD.mjs';
+import { ShopContext, ThemeSettingsContext, CurrentTemplateContext, PageContext, LocalizationContext, CurrencyContext, CartContext, CustomerContext, NavigationContext, CollectionContext, ProductContext, useShop, useLocalization, useCustomer, useThemeSettings } from './chunk-4TMO5Y5W.mjs';
+export { CartContext, CollectionContext, CurrencyContext, CustomerContext, LocalizationContext, NavigationContext, PageContext, ProductContext, ShopContext, ThemeSettingsContext, useCollections, useCustomer, useDirection, useFieldTranslation, useLocale, useLocalization, useNumberFormat, usePage, useProducts, useShop, useThemeSettings, useTranslation } from './chunk-4TMO5Y5W.mjs';
+import { createContext, forwardRef, useState, useImperativeHandle, useEffect, useCallback, useMemo, useRef, useContext, useSyncExternalStore, StrictMode, createElement, Component } from 'react';
 import { hydrateRoot, createRoot } from 'react-dom/client';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
 
 // src/types/theme.ts
 var MAX_BLOCK_DEPTH = 5;
-
-// src/validation/index.ts
-var THEME_CONTRACT_VERSION = 1;
-var SDK_VERSION = "0.6.1" ;
-var REQUIRED_TEMPLATES = [
-  "home",
-  "product",
-  "collection",
-  "cart",
-  "page",
-  "search",
-  "404"
-];
-var KNOWN_TEMPLATES = /* @__PURE__ */ new Set([
-  ...REQUIRED_TEMPLATES,
-  "blog",
-  "article",
-  "policies",
-  "password",
-  "account",
-  "checkout"
-]);
-var KNOWN_SETTING_TYPES = /* @__PURE__ */ new Set([
-  "text",
-  "textarea",
-  "richtext",
-  "number",
-  "range",
-  "color",
-  "checkbox",
-  "select",
-  "radio",
-  "font",
-  "image_picker",
-  "url",
-  "product",
-  "product_list",
-  "collection",
-  "collection_list",
-  "header",
-  "paragraph",
-  "html",
-  "date",
-  "time",
-  "video_picker",
-  "color_scheme",
-  "page_picker",
-  "blog_picker",
-  "link_list_picker",
-  "variant_picker",
-  "file_upload",
-  "icon_picker",
-  "icon"
-]);
-var PRESENTATIONAL_SETTING_TYPES = /* @__PURE__ */ new Set([
-  "header",
-  "paragraph",
-  "html"
-]);
-var SECTION_TYPE_RE = /^[a-z][a-z0-9_-]*$/;
-var THEME_ID_RE = /^[a-z0-9][a-z0-9_-]*[a-z0-9]$/;
-var SEMVER_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-.]+)?(?:\+[0-9A-Za-z-.]+)?$/;
-function isObject(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-function isNonEmptyString(v) {
-  return typeof v === "string" && v.trim().length > 0;
-}
-var IssueBag = class {
-  constructor() {
-    this.issues = [];
-  }
-  err(code, message, path) {
-    this.issues.push({ level: "error", code, message, path });
-  }
-  warn(code, message, path) {
-    this.issues.push({ level: "warning", code, message, path });
-  }
-  result() {
-    return {
-      valid: !this.issues.some((i) => i.level === "error"),
-      issues: this.issues
-    };
-  }
-};
-function collectPresetSectionTypes(manifest) {
-  const types = /* @__PURE__ */ new Set();
-  const presets = manifest.presets;
-  if (!isObject(presets)) return types;
-  const buckets = [presets.templates, presets.section_groups];
-  for (const bucket of buckets) {
-    if (!isObject(bucket)) continue;
-    for (const entry of Object.values(bucket)) {
-      if (!isObject(entry)) continue;
-      const sections = entry.sections;
-      const instances = Array.isArray(sections) ? sections : isObject(sections) ? Object.values(sections) : [];
-      for (const inst of instances) {
-        if (isObject(inst) && isNonEmptyString(inst.type)) types.add(inst.type);
-      }
-    }
-  }
-  return types;
-}
-function validateSettingInto(bag, setting, pathPrefix, seenIds) {
-  if (!isObject(setting)) {
-    bag.err("schema.setting.invalid", "Setting must be an object.", pathPrefix);
-    return;
-  }
-  const type = setting.type;
-  if (!isNonEmptyString(type)) {
-    bag.err("schema.setting.type.missing", "Setting is missing a `type`.", pathPrefix);
-  } else if (!KNOWN_SETTING_TYPES.has(type)) {
-    bag.warn(
-      "schema.setting.type.unknown",
-      `Unknown setting type "${type}" \u2014 the customizer will fall back to a text input.`,
-      pathPrefix
-    );
-  }
-  const presentational = isNonEmptyString(type) && PRESENTATIONAL_SETTING_TYPES.has(type);
-  if (!presentational) {
-    if (!isNonEmptyString(setting.id)) {
-      bag.err("schema.setting.id.missing", "Setting is missing an `id`.", pathPrefix);
-    } else {
-      if (seenIds.has(setting.id)) {
-        bag.err(
-          "schema.setting.id.duplicate",
-          `Duplicate setting id "${setting.id}".`,
-          pathPrefix
-        );
-      }
-      seenIds.add(setting.id);
-    }
-    if (!isNonEmptyString(setting.label)) {
-      bag.warn("schema.setting.label.missing", "Setting has no `label`.", pathPrefix);
-    }
-  }
-  if (type === "select" || type === "radio") {
-    const options = setting.options;
-    if (!Array.isArray(options) || options.length === 0) {
-      bag.err(
-        "schema.setting.options.missing",
-        `"${type}" setting "${String(setting.id)}" must declare a non-empty \`options\` array.`,
-        pathPrefix
-      );
-    }
-  }
-  if (type === "range") {
-    if (typeof setting.min !== "number" || typeof setting.max !== "number") {
-      bag.err(
-        "schema.setting.range.bounds",
-        `"range" setting "${String(setting.id)}" must declare numeric \`min\` and \`max\`.`,
-        pathPrefix
-      );
-    } else if (setting.min >= setting.max) {
-      bag.err(
-        "schema.setting.range.order",
-        `"range" setting "${String(setting.id)}" has min >= max.`,
-        pathPrefix
-      );
-    }
-  }
-}
-function validateSectionSchema(schema, opts = {}) {
-  const bag = new IssueBag();
-  const where = opts.filenameType ? `${opts.filenameType}.json` : "section schema";
-  if (!isObject(schema)) {
-    bag.err("schema.invalid", "Section schema must be a JSON object.", where);
-    return bag.result();
-  }
-  const type = schema.type;
-  if (!isNonEmptyString(type)) {
-    bag.err("schema.type.missing", "Section schema is missing a `type`.", where);
-  } else {
-    if (!SECTION_TYPE_RE.test(type)) {
-      bag.err(
-        "schema.type.format",
-        `Section type "${type}" must match ${SECTION_TYPE_RE} (lowercase, start with a letter).`,
-        where
-      );
-    }
-    if (opts.filenameType && type !== opts.filenameType) {
-      bag.err(
-        "schema.type.filename_mismatch",
-        `Schema type "${type}" must equal its filename "${opts.filenameType}" (component-filename = schema-type convention).`,
-        where
-      );
-    }
-  }
-  if (!isNonEmptyString(schema.name)) {
-    bag.err("schema.name.missing", "Section schema is missing a `name`.", where);
-  }
-  if (schema.settings === void 0) {
-    bag.warn("schema.settings.missing", "Section schema has no `settings`.", where);
-  } else if (!Array.isArray(schema.settings)) {
-    bag.err("schema.settings.invalid", "`settings` must be an array.", where);
-  } else {
-    const seen = /* @__PURE__ */ new Set();
-    schema.settings.forEach(
-      (s, i) => validateSettingInto(bag, s, `${where}.settings[${i}]`, seen)
-    );
-  }
-  if (schema.blocks !== void 0) {
-    if (!Array.isArray(schema.blocks)) {
-      bag.err("schema.blocks.invalid", "`blocks` must be an array.", where);
-    } else {
-      schema.blocks.forEach((b, i) => {
-        if (!isObject(b) || !isNonEmptyString(b.type)) {
-          bag.err("schema.block.type.missing", `Block[${i}] is missing a \`type\`.`, where);
-          return;
-        }
-        if (!SECTION_TYPE_RE.test(b.type)) {
-          bag.err(
-            "schema.block.type.format",
-            `Block type "${b.type}" must match ${SECTION_TYPE_RE}.`,
-            where
-          );
-        }
-        if (Array.isArray(b.settings)) {
-          const seen = /* @__PURE__ */ new Set();
-          b.settings.forEach(
-            (s, j) => validateSettingInto(bag, s, `${where}.blocks[${i}].settings[${j}]`, seen)
-          );
-        }
-      });
-    }
-  }
-  return bag.result();
-}
-function validateSettingsAgainstSchema(settings, schema, pathPrefix = "settings") {
-  const bag = new IssueBag();
-  if (!isObject(settings)) {
-    bag.err("instance.settings.invalid", "Section settings must be an object.", pathPrefix);
-    return bag.result();
-  }
-  const defs = Array.isArray(schema.settings) ? schema.settings : [];
-  const byId = /* @__PURE__ */ new Map();
-  for (const d of defs) if (isNonEmptyString(d?.id)) byId.set(d.id, d);
-  for (const [key, value] of Object.entries(settings)) {
-    const def = byId.get(key);
-    if (!def) {
-      bag.warn(
-        "instance.setting.unknown",
-        `Setting "${key}" is not declared in the "${String(schema.type)}" schema.`,
-        `${pathPrefix}.${key}`
-      );
-      continue;
-    }
-    if (value === null || value === void 0) continue;
-    const p = `${pathPrefix}.${key}`;
-    if ((def.type === "select" || def.type === "radio") && Array.isArray(def.options)) {
-      const allowed = def.options.map((o) => o.value);
-      if (typeof value === "string" && !allowed.includes(value)) {
-        bag.err(
-          "instance.setting.option.invalid",
-          `"${key}" = "${value}" is not one of: ${allowed.join(", ")}.`,
-          p
-        );
-      }
-    }
-    if (def.type === "range" && typeof value === "number") {
-      if (typeof def.min === "number" && value < def.min) {
-        bag.err("instance.setting.range.under", `"${key}" = ${value} is below min ${def.min}.`, p);
-      }
-      if (typeof def.max === "number" && value > def.max) {
-        bag.err("instance.setting.range.over", `"${key}" = ${value} is above max ${def.max}.`, p);
-      }
-    }
-    if (def.type === "checkbox" && typeof value !== "boolean") {
-      bag.warn("instance.setting.type.mismatch", `"${key}" should be a boolean.`, p);
-    }
-    if ((def.type === "number" || def.type === "range") && typeof value !== "number") {
-      bag.warn("instance.setting.type.mismatch", `"${key}" should be a number.`, p);
-    }
-  }
-  return bag.result();
-}
-function validateManifestCore(bag, m) {
-  if (!isNonEmptyString(m.id)) {
-    bag.err("manifest.id.missing", "theme.json is missing `id`.", "id");
-  } else if (!THEME_ID_RE.test(m.id)) {
-    bag.err(
-      "manifest.id.format",
-      `Theme id "${m.id}" must be lowercase alphanumeric with dashes/underscores (no leading/trailing separator).`,
-      "id"
-    );
-  }
-  const name = m.name;
-  const nameOk = isNonEmptyString(name) || isObject(name) && Object.values(name).some((v) => isNonEmptyString(v));
-  if (!nameOk) {
-    bag.err("manifest.name.missing", "theme.json is missing a non-empty `name`.", "name");
-  }
-  if (!isNonEmptyString(m.version)) {
-    bag.err("manifest.version.missing", "theme.json is missing `version`.", "version");
-  } else if (!SEMVER_RE.test(m.version)) {
-    bag.err("manifest.version.invalid", `Version "${m.version}" is not valid semver.`, "version");
-  }
-  if (!isNonEmptyString(m.author)) {
-    bag.err("manifest.author.missing", "theme.json is missing `author`.", "author");
-  }
-  if (m.min_sdk_version !== void 0 && !SEMVER_RE.test(String(m.min_sdk_version))) {
-    bag.warn("manifest.min_sdk_version.invalid", "`min_sdk_version` is not valid semver.", "min_sdk_version");
-  }
-}
-function validateManifest(manifest, ctx = {}) {
-  const bag = new IssueBag();
-  if (!isObject(manifest)) {
-    bag.err("manifest.invalid", "theme.json must be a JSON object.", "theme.json");
-    return bag.result();
-  }
-  validateManifestCore(bag, manifest);
-  const presets = manifest.presets;
-  if (!isObject(presets) || Object.keys(presets).length === 0) {
-    bag.warn("manifest.presets.empty", "theme.json has no presets \u2014 merchants start with an empty page.", "presets");
-  } else {
-    if (ctx.sectionTypes) {
-      for (const type of collectPresetSectionTypes(manifest)) {
-        if (!ctx.sectionTypes.has(type)) {
-          bag.err(
-            "manifest.preset.unknown_section",
-            `Preset references section type "${type}" with no schemas/sections/${type}.json.`,
-            "presets"
-          );
-        }
-      }
-    }
-    const templates = isObject(presets.templates) ? presets.templates : {};
-    for (const t of REQUIRED_TEMPLATES) {
-      if (!(t in templates)) {
-        bag.warn(
-          "manifest.template.missing",
-          `No preset for required template "${t}" \u2014 the storefront will fall back to its built-in.`,
-          `presets.templates.${t}`
-        );
-      }
-    }
-  }
-  return bag.result();
-}
-function validateBuiltManifest(builtManifest, importMap, opts = {}) {
-  const bag = new IssueBag();
-  if (!isObject(builtManifest)) {
-    bag.err("built.invalid", "manifest.json must be a JSON object.", "manifest.json");
-    return bag.result();
-  }
-  validateManifestCore(bag, builtManifest);
-  const schemas = builtManifest.section_schemas;
-  const shipped = new Set(isObject(schemas) ? Object.keys(schemas) : []);
-  if (!isObject(schemas)) {
-    bag.warn("built.section_schemas.missing", "manifest.json has no `section_schemas`.", "section_schemas");
-  }
-  for (const type of collectPresetSectionTypes(builtManifest)) {
-    if (!shipped.has(type)) {
-      bag.err(
-        "built.preset.unknown_section",
-        `Preset references section type "${type}" not present in section_schemas.`,
-        "presets"
-      );
-    }
-  }
-  if (isObject(schemas)) {
-    for (const [type, schema] of Object.entries(schemas)) {
-      const r = validateSectionSchema(schema, { filenameType: type });
-      for (const issue of r.issues) bag.issues.push(issue);
-    }
-  }
-  if (!isNonEmptyString(builtManifest.plugin_version)) {
-    bag.warn("built.plugin_version.missing", "manifest.json has no `plugin_version`.", "plugin_version");
-  }
-  if (importMap !== void 0) {
-    if (!isObject(importMap)) {
-      bag.err("importmap.invalid", "import-map.json must be a JSON object.", "import-map.json");
-    } else {
-      const cv = importMap.contract_version;
-      if (typeof cv !== "number") {
-        bag.warn(
-          "importmap.contract_version.missing",
-          "import-map.json has no numeric `contract_version` \u2014 built by an older plugin.",
-          "contract_version"
-        );
-      } else if (typeof opts.hostContractVersion === "number" && cv > opts.hostContractVersion) {
-        bag.err(
-          "importmap.contract_version.incompatible",
-          `Theme built for contract v${cv}; this platform supports up to v${opts.hostContractVersion}.`,
-          "contract_version"
-        );
-      }
-    }
-  }
-  return bag.result();
-}
-function mergeResults(...results) {
-  const issues = results.flatMap((r) => r.issues);
-  return { valid: !issues.some((i) => i.level === "error"), issues };
-}
-var ShopContext = createContext(null);
-var ProductContext = createContext(null);
-var CollectionContext = createContext(null);
-var CartContext = createContext(null);
-var CustomerContext = createContext(null);
-var ThemeSettingsContext = createContext(null);
-var LocalizationContext = createContext(null);
-var PageContext = createContext(null);
-var CurrentTemplateContext = createContext("home");
-var NavigationContext = createContext(
-  {}
-);
-function useLocalization() {
-  const ctx = useContext(LocalizationContext);
-  if (!ctx) throw new Error("useLocalization must be used within NuMuProvider");
-  return ctx;
-}
-function useDirection() {
-  const { direction } = useLocalization();
-  return direction;
-}
-function useLocale() {
-  const { locale } = useLocalization();
-  return locale;
-}
-function useTranslation() {
-  const { translations, locale } = useLocalization();
-  return {
-    t: (key, fallback) => translations[key] || fallback || key,
-    locale
-  };
-}
-function useFieldTranslation(entity, field) {
-  const { locale } = useLocalization();
-  if (!entity) return void 0;
-  const translated = entity.attributes && typeof entity.attributes === "object" ? entity.attributes[`${field}_${locale}`] : void 0;
-  if (typeof translated === "string" && translated) return translated;
-  const base = entity[field];
-  if (typeof base === "string") return base;
-  if (base == null) return void 0;
-  return String(base);
-}
-function useNumberFormat() {
-  const { formatNumber } = useLocalization();
-  return formatNumber;
-}
-
-// src/hooks/useShop.ts
-var DEFAULT_PROTOCOL = typeof window !== "undefined" ? window.location.protocol.replace(":", "") : "https";
-function resolveDomain(store) {
-  if (store.domain) return store.domain;
-  if (store.subdomain) {
-    const platform = typeof window !== "undefined" && window.__NUMU_PLATFORM_DOMAIN || "numueg.app";
-    return `${store.subdomain}.${platform}`;
-  }
-  return store.slug;
-}
-function useShop() {
-  const ctx = useContext(ShopContext);
-  if (!ctx) throw new Error("useShop must be used within NuMuProvider");
-  const locale = useLocale();
-  return useMemo(() => {
-    const domain = resolveDomain(ctx);
-    const settings = ctx.settings;
-    const localePrefixEnabled = Boolean(
-      settings && settings.locale_url_prefix_enabled
-    );
-    const defaultLocale = ctx.default_language || "en";
-    const prefixedLocales = settings?.locale_url_prefix_locales || null;
-    const shouldPrefix = (l) => {
-      if (!localePrefixEnabled) return false;
-      if (prefixedLocales) return prefixedLocales.includes(l);
-      return l !== defaultLocale;
-    };
-    const formatUrl = (path) => {
-      if (!path) return `${DEFAULT_PROTOCOL}://${domain}/`;
-      if (/^https?:\/\//i.test(path)) return path;
-      if (path.startsWith("//")) return `${DEFAULT_PROTOCOL}:${path}`;
-      let normalized = path.startsWith("/") ? path : `/${path}`;
-      if (locale && shouldPrefix(locale)) {
-        const prefix = `/${locale}/`;
-        const root = `/${locale}`;
-        if (normalized !== root && !normalized.startsWith(prefix)) {
-          normalized = `${root}${normalized}`;
-        }
-      }
-      return `${DEFAULT_PROTOCOL}://${domain}${normalized}`;
-    };
-    return { ...ctx, domain, formatUrl };
-  }, [ctx, locale]);
-}
 function useProduct() {
   const ctx = useContext(ProductContext);
   if (!ctx) throw new Error("useProduct must be used within ProductProvider");
@@ -510,20 +29,9 @@ function useCart() {
   if (!ctx) throw new Error("useCart must be used within NuMuProvider");
   return ctx;
 }
-function useCustomer() {
-  return useContext(CustomerContext);
-}
-function useThemeSettings() {
-  const ctx = useContext(ThemeSettingsContext);
-  if (!ctx) throw new Error("useThemeSettings must be used within NuMuProvider");
-  return ctx;
-}
 function useCurrentTemplate() {
   return useContext(CurrentTemplateContext);
 }
-function usePage() {
-  return useContext(PageContext);
-}
 var SectionContext = createContext(null);
 function useSection() {
   const ctx = useContext(SectionContext);
@@ -533,13 +41,57 @@ function useSection() {
 function useSectionOptional() {
   return useContext(SectionContext);
 }
+var EMPTY = Object.freeze([]);
+function useSectionGroup(group) {
+  const settings = useContext(ThemeSettingsContext);
+  return useMemo(() => {
+    const grp = settings?.section_groups?.[group];
+    if (!grp || !Array.isArray(grp.order) || grp.order.length === 0) {
+      return EMPTY;
+    }
+    const sections = grp.sections ?? {};
+    const out = [];
+    for (const id of grp.order) {
+      const instance = sections[id];
+      if (!instance) continue;
+      out.push({ id, ...instance });
+    }
+    return out;
+  }, [settings, group]);
+}
+function useCurrency() {
+  const ctx = useContext(CurrencyContext);
+  const shop = useShop();
+  const fallback = useMemo(() => {
+    const ccy = shop?.currency || "EGP";
+    return {
+      base: ccy,
+      selected: ccy,
+      presentment: [ccy],
+      rates: {},
+      autoConvert: false,
+      loading: false,
+      setSelected: () => {
+      },
+      convert: (cents) => cents
+    };
+  }, [shop?.currency]);
+  return ctx ?? fallback;
+}
 
 // src/hooks/useMoney.ts
 function useMoney(currencyOverride) {
   const { formatMoney } = useLocalization();
   const shop = useShop();
-  const ccy = currencyOverride || shop?.currency;
-  return (amount) => formatMoney(amount, ccy);
+  const { selected, base, autoConvert, convert } = useCurrency();
+  return (amount) => {
+    const shouldConvert = autoConvert && !currencyOverride && !!selected && selected !== base;
+    if (shouldConvert) {
+      const converted = convert(Math.round(amount * 100), selected) / 100;
+      return formatMoney(converted, selected);
+    }
+    return formatMoney(amount, currencyOverride || shop?.currency);
+  };
 }
 var DEFAULT_WIDTHS = [320, 480, 640, 768, 1024, 1280, 1600, 1920];
 var DEFAULT_SIZES = "(min-width: 1024px) 25vw, (min-width: 640px) 50vw, 100vw";
@@ -553,81 +105,6 @@ function useImage(src, opts = {}) {
     return { src, srcSet, sizes, alt };
   }, [src, sizes, widths, alt]);
 }
-function useProducts(opts = {}) {
-  const { limit, fetchIfMissing = false } = opts;
-  const page = usePage();
-  const shop = useShop();
-  const initial = page?.data?.products ?? null;
-  const [products, setProducts] = useState(initial ?? []);
-  const [loading, setLoading] = useState(
-    initial == null && fetchIfMissing
-  );
-  const [error, setError] = useState(null);
-  useEffect(() => {
-    if (initial != null) return;
-    if (!fetchIfMissing) return;
-    if (!shop?.id) return;
-    let cancelled = false;
-    (async () => {
-      try {
-        const params = new URLSearchParams({ store_id: shop.id });
-        if (limit) params.set("limit", String(limit));
-        const res = await fetch(`/api/products?${params.toString()}`);
-        if (!res.ok) throw new Error(`/api/products \u2192 ${res.status}`);
-        const data = await res.json();
-        if (cancelled) return;
-        setProducts(data.products ?? []);
-        setLoading(false);
-      } catch (err) {
-        if (cancelled) return;
-        setError(err instanceof Error ? err : new Error(String(err)));
-        setLoading(false);
-      }
-    })();
-    return () => {
-      cancelled = true;
-    };
-  }, [initial, fetchIfMissing, limit, shop?.id]);
-  const sliced = limit != null ? products.slice(0, limit) : products;
-  return { products: sliced, loading, error };
-}
-function useCollections(opts = {}) {
-  const { limit, fetchIfMissing = false } = opts;
-  const page = usePage();
-  const shop = useShop();
-  const initial = page?.data?.collections ?? null;
-  const [collections, setCollections] = useState(initial ?? []);
-  const [loading, setLoading] = useState(
-    initial == null && fetchIfMissing
-  );
-  const [error, setError] = useState(null);
-  useEffect(() => {
-    if (initial != null) return;
-    if (!fetchIfMissing) return;
-    if (!shop?.id) return;
-    let cancelled = false;
-    (async () => {
-      try {
-        const params = new URLSearchParams({ store_id: shop.id });
-        const res = await fetch(`/api/collections?${params.toString()}`);
-        if (!res.ok) throw new Error(`/api/collections \u2192 ${res.status}`);
-        const data = await res.json();
-        if (cancelled) return;
-        setCollections(data.collections ?? []);
-        setLoading(false);
-      } catch (err) {
-        if (cancelled) return;
-        setError(err instanceof Error ? err : new Error(String(err)));
-        setLoading(false);
-      }
-    })();
-    return () => {
-      cancelled = true;
-    };
-  }, [initial, fetchIfMissing, shop?.id]);
-  const sliced = limit != null ? collections.slice(0, limit) : collections;
-  return { collections: sliced, loading, error };
-}
 var NOOP_ACTIONS = {
   login: async () => ({}),
   register: async () => ({}),
@@ -997,7 +474,7 @@ function useNavigation(handle, options) {
   }, [handle, hostItems === null]);
   return { items, loading, error };
 }
-var EMPTY = {
+var EMPTY2 = {
   products: [],
   collections: [],
   pages: [],
@@ -1012,7 +489,7 @@ function useSearch(query, options = {}) {
     debounceMs = 200,
     immediate = false
   } = options;
-  const [results, setResults] = useState(EMPTY);
+  const [results, setResults] = useState(EMPTY2);
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState(null);
   const lastRequestId = useRef(0);
@@ -1020,7 +497,7 @@ function useSearch(query, options = {}) {
     if (typeof window === "undefined") return;
     const trimmed = query.trim();
     if (!trimmed) {
-      setResults(EMPTY);
+      setResults(EMPTY2);
       setLoading(false);
       setError(null);
       return;
@@ -1038,7 +515,7 @@ function useSearch(query, options = {}) {
         });
         if (requestId !== lastRequestId.current) return;
         if (!res.ok) {
-          setResults(EMPTY);
+          setResults(EMPTY2);
           return;
         }
         const json = await res.json();
@@ -1054,7 +531,7 @@ function useSearch(query, options = {}) {
       } catch (err) {
         if (requestId !== lastRequestId.current) return;
         setError(err instanceof Error ? err : new Error(String(err)));
-        setResults(EMPTY);
+        setResults(EMPTY2);
       } finally {
         if (requestId === lastRequestId.current) setLoading(false);
       }
@@ -1159,63 +636,218 @@ function useAnalytics() {
   );
   return useMemo(() => ({ track }), [track]);
 }
+var cache2 = /* @__PURE__ */ new Map();
+function buildSnapshot(entry) {
+  return {
+    data: entry.data,
+    error: entry.error,
+    isLoading: !entry.settled,
+    isValidating: entry.inFlight
+  };
+}
+function commit(entry) {
+  entry.snapshot = buildSnapshot(entry);
+  entry.subscribers.forEach((cb) => cb());
+}
+function getEntry(key, initialData) {
+  let entry = cache2.get(key);
+  if (!entry) {
+    entry = {
+      data: initialData,
+      error: void 0,
+      settled: false,
+      inFlight: false,
+      seq: 0,
+      lastFetchAt: 0,
+      promise: void 0,
+      controller: void 0,
+      fetcher: void 0,
+      subscribers: /* @__PURE__ */ new Set(),
+      snapshot: {
+        data: initialData,
+        error: void 0,
+        isLoading: true,
+        isValidating: false
+      }
+    };
+    cache2.set(key, entry);
+  }
+  return entry;
+}
+function revalidateResource(key, fetcher, opts) {
+  const entry = getEntry(key);
+  entry.fetcher = fetcher;
+  if (!opts?.force && entry.promise) return entry.promise;
+  const mySeq = ++entry.seq;
+  if (entry.controller) entry.controller.abort();
+  const controller = new AbortController();
+  entry.controller = controller;
+  entry.inFlight = true;
+  commit(entry);
+  const run = (async () => {
+    try {
+      const data = await fetcher(controller.signal);
+      if (mySeq !== entry.seq) return;
+      entry.data = data;
+      entry.error = void 0;
+      entry.settled = true;
+      entry.lastFetchAt = Date.now();
+    } catch (err) {
+      if (controller.signal.aborted) return;
+      if (mySeq !== entry.seq) return;
+      const error = err instanceof Error ? err : new Error(String(err));
+      entry.error = error;
+      entry.settled = true;
+      entry.lastFetchAt = Date.now();
+      opts?.onError?.(error, key);
+    } finally {
+      if (mySeq === entry.seq) {
+        entry.inFlight = false;
+        entry.controller = void 0;
+        commit(entry);
+      }
+    }
+  })();
+  entry.promise = run;
+  void run.finally(() => {
+    if (entry.promise === run) entry.promise = void 0;
+  });
+  return run;
+}
+function mutateResource(key, next, opts) {
+  const entry = getEntry(key);
+  const value = typeof next === "function" ? next(entry.data) : next;
+  entry.data = value;
+  entry.error = void 0;
+  entry.settled = true;
+  commit(entry);
+  if (opts?.revalidate && entry.fetcher) {
+    void revalidateResource(key, entry.fetcher, { force: true });
+  }
+}
+function readResource(key) {
+  return cache2.get(key)?.data;
+}
+var NOOP = () => {
+};
+function useCachedResource(key, fetcher, options) {
+  const enabled = options?.enabled !== false && key != null && key !== "";
+  const revalidateOnMount = options?.revalidateOnMount !== false;
+  const dedupeIntervalMs = options?.dedupeIntervalMs ?? 2e3;
+  const cacheKey = enabled ? key : "";
+  const fetcherRef = useRef(fetcher);
+  fetcherRef.current = fetcher;
+  const onErrorRef = useRef(options?.onError);
+  onErrorRef.current = options?.onError;
+  const initialDataRef = useRef(options?.initialData);
+  const fallbackRef = useRef(null);
+  if (fallbackRef.current === null) {
+    fallbackRef.current = {
+      data: initialDataRef.current,
+      error: void 0,
+      isLoading: enabled && revalidateOnMount,
+      isValidating: false
+    };
+  }
+  const subscribe = useCallback(
+    (cb) => {
+      if (!enabled) return NOOP;
+      const entry = getEntry(cacheKey, initialDataRef.current);
+      entry.subscribers.add(cb);
+      return () => {
+        entry.subscribers.delete(cb);
+      };
+    },
+    [cacheKey, enabled]
+  );
+  const getSnapshot = useCallback(() => {
+    if (!enabled) return fallbackRef.current;
+    return getEntry(cacheKey, initialDataRef.current).snapshot;
+  }, [cacheKey, enabled]);
+  const getServerSnapshot = useCallback(
+    () => fallbackRef.current,
+    []
+  );
+  const state = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+  useEffect(() => {
+    if (!enabled) return;
+    const entry = getEntry(cacheKey, initialDataRef.current);
+    const fresh = entry.settled && Date.now() - entry.lastFetchAt < dedupeIntervalMs;
+    if (revalidateOnMount && !fresh) {
+      void revalidateResource(
+        cacheKey,
+        (signal) => fetcherRef.current(signal),
+        { onError: (e, k) => onErrorRef.current?.(e, k) }
+      );
+    }
+  }, [cacheKey, enabled, revalidateOnMount, dedupeIntervalMs]);
+  const mutate = useCallback(
+    (next, opts) => {
+      if (!enabled) return;
+      mutateResource(cacheKey, next, opts);
+    },
+    [cacheKey, enabled]
+  );
+  const revalidate = useCallback(() => {
+    if (!enabled) return Promise.resolve();
+    return revalidateResource(
+      cacheKey,
+      (signal) => fetcherRef.current(signal),
+      { force: true, onError: (e, k) => onErrorRef.current?.(e, k) }
+    );
+  }, [cacheKey, enabled]);
+  return {
+    data: state.data,
+    error: state.error,
+    isLoading: state.isLoading,
+    isValidating: state.isValidating,
+    mutate,
+    revalidate
+  };
+}
+
+// src/hooks/useApp.ts
 function useApp(slug) {
   const shop = useShop();
-  const [state, setState] = useState({ data: null, loading: true, available: false, error: null });
-  const fetchApp = useCallback(async () => {
-    if (!slug) {
-      setState({ data: null, loading: false, available: false, error: null });
-      return;
-    }
-    setState((s) => ({ ...s, loading: true, error: null }));
-    try {
+  const key = slug ? `numu:app:${shop.id}:${slug}` : "";
+  const fetcher = useCallback(
+    async (signal) => {
       const url = `/api/storefront/apps/${encodeURIComponent(slug)}`;
       const res = await fetch(url, {
         credentials: "include",
-        headers: { Accept: "application/json" }
+        headers: { Accept: "application/json" },
+        signal
       });
       if (res.status === 404) {
-        setState({
-          data: null,
-          loading: false,
-          available: false,
-          error: null
-        });
-        return;
+        return { payload: null, available: false };
       }
       if (!res.ok) {
         throw new Error(`useApp(${slug}) failed: HTTP ${res.status}`);
       }
       const body = await res.json();
-      const payload = body.data;
-      if (!payload) {
-        setState({
-          data: null,
-          loading: false,
-          available: false,
-          error: null
-        });
-        return;
-      }
-      setState({
-        data: payload,
-        loading: false,
-        available: payload.available !== false,
-        error: null
-      });
-    } catch (e) {
-      setState({
-        data: null,
-        loading: false,
-        available: false,
-        error: e instanceof Error ? e : new Error(String(e))
-      });
-    }
-  }, [slug, shop.id]);
-  useEffect(() => {
-    void fetchApp();
-  }, [fetchApp]);
-  return { ...state, refresh: fetchApp };
+      const payload = body.data ?? null;
+      if (!payload) return { payload: null, available: false };
+      return {
+        payload,
+        available: payload.available !== false
+      };
+    },
+    [slug]
+  );
+  const { data, isLoading, error, revalidate } = useCachedResource(key, fetcher, {
+    enabled: Boolean(slug),
+    initialData: { payload: null, available: false }
+  });
+  const refresh = useCallback(async () => {
+    await revalidate();
+  }, [revalidate]);
+  return {
+    data: error ? null : data?.payload ?? null,
+    loading: isLoading,
+    available: error ? false : data?.available ?? false,
+    error: error ?? null,
+    refresh
+  };
 }
 function storageKey(storeId) {
   return `numu_wishlist_${storeId}`;
@@ -1231,109 +863,95 @@ function readLocal(storeId) {
     return [];
   }
 }
-function writeLocal(storeId, items) {
+function persistWishlist(storeId, items) {
   if (typeof window === "undefined") return;
-  try {
-    window.localStorage.setItem(storageKey(storeId), JSON.stringify(items));
-  } catch {
-  }
+  window.localStorage.setItem(storageKey(storeId), JSON.stringify(items));
 }
 function sameItem(a, productId, variantId) {
   return a.product_id === productId && (a.variant_id ?? null) === (variantId ?? null);
 }
+var EMPTY3 = [];
 function useWishlist(storeId) {
-  const customer = useCustomer();
-  const [items, setItems] = useState([]);
-  const [loading, setLoading] = useState(true);
-  useEffect(() => {
-    if (typeof window === "undefined") return;
-    setItems(readLocal(storeId));
-    setLoading(false);
-  }, [storeId, customer?.id]);
+  const key = storageKey(storeId);
+  const fetcher = useCallback(
+    () => Promise.resolve(readLocal(storeId)),
+    [storeId]
+  );
+  const { data, isLoading, mutate } = useCachedResource(
+    key,
+    fetcher,
+    { initialData: EMPTY3 }
+  );
+  const items = data ?? EMPTY3;
   const has = useCallback(
     (productId, variantId) => items.some((it) => sameItem(it, productId, variantId)),
     [items]
   );
+  const applyOptimistic = useCallback(
+    (compute) => {
+      const prev = readResource(key) ?? EMPTY3;
+      const next = compute(prev);
+      if (next === null) return;
+      mutate(next, { revalidate: false });
+      try {
+        persistWishlist(storeId, next);
+      } catch {
+        mutate(prev, { revalidate: false });
+      }
+    },
+    [key, storeId, mutate]
+  );
   const addToWishlist = useCallback(
-    (productId, variantId) => {
-      setItems((prev) => {
-        if (prev.some((it) => sameItem(it, productId, variantId))) {
-          return prev;
+    (productId, variantId) => applyOptimistic(
+      (prev) => prev.some((it) => sameItem(it, productId, variantId)) ? null : [
+        ...prev,
+        {
+          product_id: productId,
+          variant_id: variantId ?? null,
+          added_at: Date.now()
         }
-        const next = [
-          ...prev,
-          {
-            product_id: productId,
-            variant_id: variantId ?? null,
-            added_at: Date.now()
-          }
-        ];
-        writeLocal(storeId, next);
-        return next;
-      });
-    },
-    [storeId]
+      ]
+    ),
+    [applyOptimistic]
   );
   const removeFromWishlist = useCallback(
-    (productId, variantId) => {
-      setItems((prev) => {
-        const next = prev.filter((it) => !sameItem(it, productId, variantId));
-        writeLocal(storeId, next);
-        return next;
-      });
-    },
-    [storeId]
+    (productId, variantId) => applyOptimistic((prev) => {
+      const next = prev.filter((it) => !sameItem(it, productId, variantId));
+      return next.length === prev.length ? null : next;
+    }),
+    [applyOptimistic]
   );
-  const clear = useCallback(() => {
-    setItems([]);
-    writeLocal(storeId, []);
-  }, [storeId]);
-  return { items, loading, has, addToWishlist, removeFromWishlist, clear };
+  const clear = useCallback(
+    () => applyOptimistic((prev) => prev.length === 0 ? null : []),
+    [applyOptimistic]
+  );
+  return { items, loading: isLoading, has, addToWishlist, removeFromWishlist, clear };
 }
+var EMPTY4 = [];
 function useRelatedProducts(productId, options = {}) {
   const limit = options.limit ?? 4;
-  const [items, setItems] = useState([]);
-  const [loading, setLoading] = useState(false);
-  const [error, setError] = useState(null);
-  useEffect(() => {
-    if (typeof window === "undefined") return;
-    if (!productId) {
-      setItems([]);
-      setLoading(false);
-      setError(null);
-      return;
-    }
-    let cancelled = false;
-    setLoading(true);
-    setError(null);
-    void (async () => {
-      try {
-        const res = await fetch(
-          `/api/storefront/products/${encodeURIComponent(productId)}/related?limit=${limit}`,
-          { cache: "no-store" }
-        );
-        if (!res.ok) {
-          if (cancelled) return;
-          setItems([]);
-          return;
-        }
-        const json = await res.json();
-        const list = Array.isArray(json) ? json : Array.isArray(json.data) ? json.data : Array.isArray(json.items) ? json.items : [];
-        if (cancelled) return;
-        setItems(list);
-      } catch (err) {
-        if (cancelled) return;
-        setError(err instanceof Error ? err : new Error(String(err)));
-        setItems([]);
-      } finally {
-        if (!cancelled) setLoading(false);
+  const key = productId ? `numu:related:${productId}:${limit}` : "";
+  const fetcher = useCallback(
+    async (signal) => {
+      const res = await fetch(
+        `/api/storefront/products/${encodeURIComponent(
+          productId
+        )}/related?limit=${limit}`,
+        { cache: "no-store", signal }
+      );
+      if (!res.ok) {
+        return EMPTY4;
       }
-    })();
-    return () => {
-      cancelled = true;
-    };
-  }, [productId, limit]);
-  return { items, loading, error };
+      const json = await res.json();
+      return Array.isArray(json) ? json : Array.isArray(json.data) ? json.data : Array.isArray(json.items) ? json.items : EMPTY4;
+    },
+    [productId, limit]
+  );
+  const { data, isLoading, error } = useCachedResource(key, fetcher, {
+    enabled: Boolean(productId),
+    initialData: EMPTY4
+  });
+  return { items: data ?? EMPTY4, loading: isLoading, error: error ?? null };
 }
 function useProductSizeChart(productOverride) {
   const ctxProduct = useProductOptional();
@@ -1358,86 +976,6 @@ function resolveSizeChart(productAttributes, storeSettings) {
   if (hasRows(storeDefault)) return storeDefault;
   return null;
 }
-var COOKIE_NAME = "numu_currency";
-var COOKIE_MAX_AGE = 60 * 60 * 24 * 30;
-function readCookie(name) {
-  if (typeof document === "undefined") return null;
-  const match = document.cookie.match(
-    new RegExp(`(?:^|;\\s*)${name}=([^;]+)`)
-  );
-  return match ? decodeURIComponent(match[1]) : null;
-}
-function writeCookie(name, value) {
-  if (typeof document === "undefined") return;
-  document.cookie = `${name}=${encodeURIComponent(value)}; path=/; max-age=${COOKIE_MAX_AGE}; SameSite=Lax`;
-}
-function useCurrency() {
-  const shop = useShop();
-  const [config, setConfig] = useState(null);
-  const [loading, setLoading] = useState(true);
-  const [selected, setSelectedState] = useState("");
-  useEffect(() => {
-    let cancelled = false;
-    (async () => {
-      try {
-        const res = await fetch(`/api/storefront/currencies`, {
-          credentials: "include",
-          headers: { Accept: "application/json" }
-        });
-        if (!res.ok) throw new Error(`currencies: HTTP ${res.status}`);
-        const body = await res.json();
-        if (cancelled) return;
-        setConfig(body.data);
-        const cookie = readCookie(COOKIE_NAME);
-        const valid = cookie && body.data.presentment.includes(cookie) ? cookie : null;
-        setSelectedState(valid || body.data.default_presentment || body.data.base);
-      } catch {
-        if (cancelled) return;
-        setConfig(null);
-        setSelectedState(shop.currency || "EGP");
-      } finally {
-        if (!cancelled) setLoading(false);
-      }
-    })();
-    return () => {
-      cancelled = true;
-    };
-  }, [shop.id, shop.currency]);
-  const rates = useMemo(() => {
-    const out = {};
-    if (!config) return out;
-    for (const [k, v] of Object.entries(config.rates)) {
-      const n = Number.parseFloat(v);
-      if (Number.isFinite(n)) out[k] = n;
-    }
-    return out;
-  }, [config]);
-  const convert = useCallback(
-    (cents, target) => {
-      if (!config) return cents;
-      const to = target || selected;
-      if (!to || to === config.base) return cents;
-      const rate = rates[to];
-      if (!rate || !Number.isFinite(rate)) return cents;
-      return Math.round(cents * rate);
-    },
-    [config, rates, selected]
-  );
-  const setSelected = useCallback((currency) => {
-    setSelectedState(currency);
-    writeCookie(COOKIE_NAME, currency);
-  }, []);
-  return {
-    base: config?.base || shop.currency || "EGP",
-    selected: selected || config?.base || shop.currency || "EGP",
-    presentment: config?.presentment || [shop.currency || "EGP"],
-    rates,
-    autoConvert: Boolean(config?.auto_convert),
-    loading,
-    setSelected,
-    convert
-  };
-}
 
 // src/utils/variants.ts
 function findVariantByOptions(product, selection) {
@@ -1482,6 +1020,25 @@ function availableValues(product, selection) {
   }
   return out;
 }
+
+// src/utils/selectionRegistry.ts
+var selections = /* @__PURE__ */ new Map();
+function publishVariantSelection(productId, selection) {
+  if (!productId) return;
+  selections.set(productId, selection);
+}
+function readVariantSelection(productId) {
+  if (!productId) return null;
+  const sel = selections.get(productId);
+  if (!sel) return null;
+  const filtered = {};
+  for (const [k, v] of Object.entries(sel)) {
+    if (v) filtered[k] = v;
+  }
+  return Object.keys(filtered).length > 0 ? filtered : null;
+}
+
+// src/hooks/useVariantSelection.ts
 function useVariantSelection(product, opts = {}) {
   const autoSelect = opts.autoSelect ?? true;
   const initial = useMemo(() => {
@@ -1500,6 +1057,9 @@ function useVariantSelection(product, opts = {}) {
     () => findVariantByOptions(product, selection),
     [product, selection]
   );
+  useEffect(() => {
+    publishVariantSelection(product.id, selection);
+  }, [product.id, selection]);
   const availability = useMemo(
     () => availableValues(product, selection),
     [product, selection]
@@ -1893,6 +1453,19 @@ function readCsrfCookie() {
   const match = document.cookie.match(/(?:^|;\s*)numu_csrf=([^;]+)/);
   return match ? decodeURIComponent(match[1]) : null;
 }
+var CURRENCY_COOKIE_NAME = "numu_currency";
+var CURRENCY_COOKIE_MAX_AGE = 60 * 60 * 24 * 30;
+function readCurrencyCookie() {
+  if (typeof document === "undefined") return null;
+  const match = document.cookie.match(
+    new RegExp(`(?:^|;\\s*)${CURRENCY_COOKIE_NAME}=([^;]+)`)
+  );
+  return match ? decodeURIComponent(match[1]) : null;
+}
+function writeCurrencyCookie(value) {
+  if (typeof document === "undefined") return;
+  document.cookie = `${CURRENCY_COOKIE_NAME}=${encodeURIComponent(value)}; path=/; max-age=${CURRENCY_COOKIE_MAX_AGE}; SameSite=Lax`;
+}
 async function postCartMutation(endpoint, body, applyCart, reserveToken) {
   const headers = {
     "Content-Type": "application/json"
@@ -1906,9 +1479,21 @@ async function postCartMutation(endpoint, body, applyCart, reserveToken) {
     headers,
     body: body === void 0 ? void 0 : JSON.stringify(body)
   });
-  if (!res.ok) return;
+  if (!res.ok) {
+    let message;
+    try {
+      const err = await res.json();
+      if (err && typeof err === "object") {
+        const m = err.message ?? err.error ?? err.detail;
+        if (typeof m === "string") message = m;
+      }
+    } catch {
+    }
+    return { ok: false, status: res.status, message };
+  }
   const json = await res.json();
   applyCart(unwrapCart(json));
+  return { ok: true, status: res.status };
 }
 function NuMuProvider({
   store,
@@ -1918,6 +1503,7 @@ function NuMuProvider({
   locale: initialLocale,
   translations: initialTranslations,
   currentTemplate = "home",
+  pageTemplate,
   initialProducts,
   initialCollections,
   navigation,
@@ -1927,12 +1513,16 @@ function NuMuProvider({
     () => ({
       type: currentTemplate,
       title: store?.name ?? "",
+      // I3 — resolved alternate template key (e.g. "product.wholesale"),
+      // surfaced via usePage()?.template. Omitted when undefined so a
+      // page on its default template exposes no `template` field.
+      ...pageTemplate ? { template: pageTemplate } : {},
       data: {
         products: initialProducts ?? [],
         collections: initialCollections ?? []
       }
     }),
-    [currentTemplate, store?.name, initialProducts, initialCollections]
+    [currentTemplate, pageTemplate, store?.name, initialProducts, initialCollections]
   );
   const [cart, setCart] = useState(
     initialCart || { ...EMPTY_CART, currency: store.currency }
@@ -2123,7 +1713,7 @@ function NuMuProvider({
       const token = reserveToken();
       setLoading(true);
       try {
-        await postCartMutation(
+        return await postCartMutation(
           endpoint,
           body,
           buildApplyCart(token),
@@ -2137,15 +1727,18 @@ function NuMuProvider({
     [reserveToken, buildApplyCart]
   );
   const addItem = useCallback(
-    async (productId, variantId, quantity) => {
+    async (productId, variantId, quantity, selectedOptions) => {
       const eventId = typeof crypto !== "undefined" && crypto.randomUUID ? crypto.randomUUID() : `${Date.now()}`;
       const qty = quantity || 1;
-      await mutate("/api/cart/add", {
+      const axes = selectedOptions && Object.keys(selectedOptions).length > 0 ? selectedOptions : readVariantSelection(productId) ?? void 0;
+      const result = await mutate("/api/cart/add", {
         product_id: productId,
         variant_id: variantId,
         quantity: qty,
+        selected_options: axes,
         _event_id: eventId
       });
+      if (!result.ok) return result;
       try {
         if (typeof window !== "undefined") {
           window.dispatchEvent(
@@ -2164,34 +1757,29 @@ function NuMuProvider({
         }
       } catch {
       }
+      return result;
     },
     [mutate]
   );
   const removeItem = useCallback(
-    async (itemId) => {
-      await mutate("/api/cart/remove", { item_id: itemId });
-    },
+    (itemId) => mutate("/api/cart/remove", { item_id: itemId }),
     [mutate]
   );
   const updateQuantity = useCallback(
-    async (itemId, quantity) => {
-      await mutate("/api/cart/update", { item_id: itemId, quantity });
-    },
+    (itemId, quantity) => mutate("/api/cart/update", { item_id: itemId, quantity }),
     [mutate]
   );
   const applyDiscount = useCallback(
-    async (code) => {
-      await mutate("/api/cart/discount", { code });
-    },
+    (code) => mutate("/api/cart/discount", { code }),
+    [mutate]
+  );
+  const removeDiscount = useCallback(
+    // DELETE — postCartMutation interprets undefined body as DELETE.
+    () => mutate("/api/cart/discount", void 0),
     [mutate]
   );
-  const removeDiscount = useCallback(async () => {
-    await mutate("/api/cart/discount", void 0);
-  }, [mutate]);
   const updateNote = useCallback(
-    async (note) => {
-      await mutate("/api/cart/update", { note });
-    },
+    (note) => mutate("/api/cart/update", { note }),
     [mutate]
   );
   const clearCart = useCallback(async () => {
@@ -2327,7 +1915,87 @@ function NuMuProvider({
       defaultNumberFmt
     ]
   );
-  return /* @__PURE__ */ jsx(ShopContext.Provider, { value: store, children: /* @__PURE__ */ jsx(ThemeSettingsContext.Provider, { value: themeSettings, children: /* @__PURE__ */ jsx(CurrentTemplateContext.Provider, { value: currentTemplate, children: /* @__PURE__ */ jsx(PageContext.Provider, { value: pageValue, children: /* @__PURE__ */ jsx(LocalizationContext.Provider, { value: localization, children: /* @__PURE__ */ jsx(CartContext.Provider, { value: cartValue, children: /* @__PURE__ */ jsx(CustomerContext.Provider, { value: customerState, children: /* @__PURE__ */ jsx(CustomerActionsContext.Provider, { value: customerActions, children: /* @__PURE__ */ jsx(NavigationContext.Provider, { value: navigation ?? {}, children }) }) }) }) }) }) }) }) });
+  const [currencyConfig, setCurrencyConfig] = useState(
+    null
+  );
+  const [currencyLoading, setCurrencyLoading] = useState(true);
+  const [currencySelected, setCurrencySelected] = useState("");
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    let cancelled = false;
+    void (async () => {
+      try {
+        const res = await fetch("/api/storefront/currencies", {
+          credentials: "include",
+          headers: { Accept: "application/json" }
+        });
+        if (!res.ok) throw new Error(`currencies: HTTP ${res.status}`);
+        const body = await res.json();
+        if (cancelled) return;
+        setCurrencyConfig(body.data);
+        const cookie = readCurrencyCookie();
+        const valid = cookie && body.data.presentment?.includes(cookie) ? cookie : null;
+        setCurrencySelected(
+          valid || body.data.default_presentment || body.data.base
+        );
+      } catch {
+        if (cancelled) return;
+        setCurrencyConfig(null);
+        setCurrencySelected(store.currency || "EGP");
+      } finally {
+        if (!cancelled) setCurrencyLoading(false);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [store.id, store.currency]);
+  const currencyRates = useMemo(() => {
+    const out = {};
+    if (!currencyConfig) return out;
+    for (const [k, v] of Object.entries(currencyConfig.rates)) {
+      const n = Number.parseFloat(v);
+      if (Number.isFinite(n)) out[k] = n;
+    }
+    return out;
+  }, [currencyConfig]);
+  const convertCurrency = useCallback(
+    (cents, target) => {
+      if (!currencyConfig) return cents;
+      const to = target || currencySelected;
+      if (!to || to === currencyConfig.base) return cents;
+      const rate = currencyRates[to];
+      if (!rate || !Number.isFinite(rate)) return cents;
+      return Math.round(cents * rate);
+    },
+    [currencyConfig, currencyRates, currencySelected]
+  );
+  const setCurrency = useCallback((currency) => {
+    setCurrencySelected(currency);
+    writeCurrencyCookie(currency);
+  }, []);
+  const currencyValue = useMemo(
+    () => ({
+      base: currencyConfig?.base || store.currency || "EGP",
+      selected: currencySelected || currencyConfig?.base || store.currency || "EGP",
+      presentment: currencyConfig?.presentment || [store.currency || "EGP"],
+      rates: currencyRates,
+      autoConvert: Boolean(currencyConfig?.auto_convert),
+      loading: currencyLoading,
+      setSelected: setCurrency,
+      convert: convertCurrency
+    }),
+    [
+      currencyConfig,
+      currencySelected,
+      currencyRates,
+      currencyLoading,
+      store.currency,
+      setCurrency,
+      convertCurrency
+    ]
+  );
+  return /* @__PURE__ */ jsx(ShopContext.Provider, { value: store, children: /* @__PURE__ */ jsx(ThemeSettingsContext.Provider, { value: themeSettings, children: /* @__PURE__ */ jsx(CurrentTemplateContext.Provider, { value: currentTemplate, children: /* @__PURE__ */ jsx(PageContext.Provider, { value: pageValue, children: /* @__PURE__ */ jsx(LocalizationContext.Provider, { value: localization, children: /* @__PURE__ */ jsx(CurrencyContext.Provider, { value: currencyValue, children: /* @__PURE__ */ jsx(CartContext.Provider, { value: cartValue, children: /* @__PURE__ */ jsx(CustomerContext.Provider, { value: customerState, children: /* @__PURE__ */ jsx(CustomerActionsContext.Provider, { value: customerActions, children: /* @__PURE__ */ jsx(NavigationContext.Provider, { value: navigation ?? {}, children }) }) }) }) }) }) }) }) }) });
 }
 function ProductProvider({ product, children }) {
   return /* @__PURE__ */ jsx(ProductContext.Provider, { value: product, children });
@@ -2628,6 +2296,7 @@ var ThemeMountBridge = forwardRef(function ThemeMountBridge2({ ctx, mountEl, ren
       initialProducts: pageData.products,
       initialCollections: pageData.collections,
       currentTemplate: template,
+      pageTemplate: ctx.page?.template,
       children: wrapEntityProviders(app, pageData)
     }
   );
@@ -2673,15 +2342,18 @@ function Money({
 }) {
   const { formatMoney } = useLocalization();
   const shop = useShop();
-  const ccy = currency || shop?.currency;
+  const { selected, base, autoConvert, convert } = useCurrency();
+  const shouldConvert = autoConvert && !currency && !!selected && selected !== base;
+  const ccy = shouldConvert ? selected : currency || shop?.currency;
+  const toDisplay = (major) => shouldConvert ? convert(Math.round(major * 100), selected) / 100 : major;
   const showCompare = compareAt != null && compareAt > amount;
   const children = [
-    /* @__PURE__ */ jsx("span", { children: formatMoney(amount, ccy) }, "amt")
+    /* @__PURE__ */ jsx("span", { children: formatMoney(toDisplay(amount), ccy) }, "amt")
   ];
   if (showCompare) {
     children.push(" ");
     children.push(
-      /* @__PURE__ */ jsx("s", { style: { opacity: 0.6 }, children: formatMoney(compareAt, ccy) }, "cmp")
+      /* @__PURE__ */ jsx("s", { style: { opacity: 0.6 }, children: formatMoney(toDisplay(compareAt), ccy) }, "cmp")
     );
   }
   return createElement(
@@ -2960,19 +2632,40 @@ function Logo({
   );
 }
 var ABSOLUTE_URL = /^[a-z]+:|^\/\//i;
-function Link({ to, children, ...rest }) {
+var NAVIGATE_EVENT = "numu:navigate";
+function requestNavigate(href) {
+  if (typeof window === "undefined") return false;
+  const event = new CustomEvent(NAVIGATE_EVENT, {
+    detail: { href },
+    cancelable: true
+  });
+  return !window.dispatchEvent(event);
+}
+function Link({ to, children, onClick, ...rest }) {
   const shop = useShop();
   const isAbsolute = ABSOLUTE_URL.test(to);
   let href = to;
   if (!isAbsolute && shop && !to.startsWith("/")) {
     href = `/${to}`;
   }
-  return /* @__PURE__ */ jsx("a", { href, ...rest, children });
+  const handleClick = (e) => {
+    onClick?.(e);
+    if (e.defaultPrevented) return;
+    if (e.button !== 0) return;
+    if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+    if (rest.target && rest.target !== "_self") return;
+    if (rest.download !== void 0) return;
+    if (isAbsolute) return;
+    if (to.startsWith("#") || href.startsWith("#")) return;
+    if (requestNavigate(href)) e.preventDefault();
+  };
+  return /* @__PURE__ */ jsx("a", { href, onClick: handleClick, ...rest, children });
 }
 function AddToCartButton({
   product,
   variant,
   quantity = 1,
+  selectedOptions,
   label = "Add to cart",
   loadingLabel = "Adding\u2026",
   soldOutLabel = "Sold out",
@@ -2999,7 +2692,7 @@ function AddToCartButton({
     if (state === "adding") return;
     setState("adding");
     try {
-      await addItem(product.id, variant?.id, quantity);
+      await addItem(product.id, variant?.id, quantity, selectedOptions);
       setState("idle");
       onAdded?.(product, variant);
     } catch {
@@ -3417,11 +3110,29 @@ function walk(node) {
   }
 }
 function sanitizeHtmlServer(input) {
-  let s = input.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<iframe[\s\S]*?<\/iframe>/gi, "").replace(/<object[\s\S]*?<\/object>/gi, "").replace(/<embed[\s\S]*?<\/embed>/gi, "").replace(/<link[\s\S]*?>/gi, "").replace(/<meta[\s\S]*?>/gi, "");
-  s = s.replace(/\s+on\w+\s*=\s*("[^"]*"|'[^']*'|[^\s>]+)/gi, "");
+  if (!input) return "";
+  let s = input;
+  let prev;
+  const DANGEROUS = [
+    /<script\b[\s\S]*?<\/script\s*>/gi,
+    /<style\b[\s\S]*?<\/style\s*>/gi,
+    /<iframe\b[\s\S]*?<\/iframe\s*>/gi,
+    /<object\b[\s\S]*?<\/object\s*>/gi,
+    /<embed\b[\s\S]*?<\/embed\s*>/gi,
+    /<\/?(?:script|style|iframe|object|embed|link|meta|form|input)\b[^>]*>/gi
+  ];
+  do {
+    prev = s;
+    for (const re of DANGEROUS) s = s.replace(re, "");
+  } while (s !== prev);
+  const HANDLER = /[\s/"'<]on\w+\s*=\s*("[^"]*"|'[^']*'|[^\s>]+)/gi;
+  do {
+    prev = s;
+    s = s.replace(HANDLER, "");
+  } while (s !== prev);
   s = s.replace(
-    /\s+(href|src)\s*=\s*("[^"]*"|'[^']*'|[^\s>]+)/gi,
-    (full, attr, val) => {
+    /[\s/"'<](href|src)\s*=\s*("[^"]*"|'[^']*'|[^\s>]+)/gi,
+    (full, _attr, val) => {
       const cleaned = String(val).replace(/^['"]|['"]$/g, "");
       return isSafeUrl(cleaned) ? full : "";
     }
@@ -3766,97 +3477,6 @@ function Icon({
   );
 }
 
-// src/utils/normalize.ts
-var DEFAULT_THEME_ID = typeof process !== "undefined" && process.env?.NUMU_DEFAULT_THEME_ID || "modern";
-function resolveThemeSettings(raw) {
-  const safeRaw = raw ?? {};
-  if (safeRaw.schema_version === 3) {
-    return safeRaw;
-  }
-  const themeBlock = safeRaw.theme || {};
-  const themeId = typeof themeBlock.base_theme === "string" && themeBlock.base_theme || DEFAULT_THEME_ID;
-  const globalSettings = {};
-  for (const key of [
-    "primary_color",
-    "secondary_color",
-    "font_family",
-    "logo_url"
-  ]) {
-    if (themeBlock[key] !== void 0) globalSettings[key] = themeBlock[key];
-  }
-  if (safeRaw.identity) globalSettings.identity = safeRaw.identity;
-  const sections = {};
-  const order = [];
-  const hero = safeRaw.hero;
-  if (hero) {
-    sections["hero_1"] = {
-      type: "hero",
-      settings: {
-        // Mirrors backend `normalize_legacy_to_v3` exactly — includes
-        // headline_ar so Arabic content survives the round-trip.
-        headline: hero.headline ?? "",
-        headline_ar: hero.headline_ar ?? "",
-        subtitle: hero.subtitle ?? "",
-        background_image: hero.hero_image_url ?? "",
-        cta_text: hero.cta_text ?? "",
-        cta_link: hero.cta_link ?? ""
-      }
-    };
-    order.push("hero_1");
-  }
-  const products = safeRaw.products;
-  if (products) {
-    sections["featured_1"] = {
-      type: "featured-products",
-      settings: products
-    };
-    order.push("featured_1");
-  }
-  const templates = {};
-  if (Object.keys(sections).length > 0) {
-    templates["home"] = { name: "Home", sections, order };
-  }
-  const sectionGroups = {
-    header: {
-      name: "Header Group",
-      sections: {
-        header_1: {
-          type: "header",
-          settings: safeRaw.header || {}
-        }
-      },
-      order: ["header_1"]
-    },
-    footer: {
-      name: "Footer Group",
-      sections: {
-        footer_1: {
-          type: "footer",
-          settings: safeRaw.footer || {}
-        }
-      },
-      order: ["footer_1"]
-    }
-  };
-  let externalTheme = null;
-  const ext = safeRaw.external_theme;
-  if (ext && typeof ext === "object" && typeof ext.bundle_url === "string" && ext.bundle_url) {
-    externalTheme = {
-      bundle_url: ext.bundle_url,
-      css_url: typeof ext.css_url === "string" ? ext.css_url : null,
-      mode: typeof ext.mode === "string" ? ext.mode : "production"
-    };
-  }
-  return {
-    schema_version: 3,
-    theme_id: themeId,
-    global_settings: globalSettings,
-    templates,
-    section_groups: sectionGroups,
-    external_theme: externalTheme
-  };
-}
-
 // src/utils/federation.ts
 function sdkSlot() {
   return /* @__PURE__ */ Symbol.for("@numueg/theme-sdk:singleton");
@@ -4169,6 +3789,6 @@ function buildLocaleBundle(modules) {
   return bundle;
 }
 
-export { AddToCartButton, Block, CartContext, CollectionCard, CollectionContext, CollectionProvider, CurrencySwitcher, CustomerContext, EditableImage, EditableText, Form, HeroMedia, ICON_NAMES, Icon, IconMap, Image, KNOWN_SETTING_TYPES, KNOWN_TEMPLATES, LOGO_SHAPE_OPTIONS, LOGO_SIZE_OPTIONS, Link, LocaleSwitcher, LocalizationContext, Logo, MAX_BLOCK_DEPTH, Money, NavigationContext, NuMuProvider, PageContext, ProductCard, ProductContext, ProductProvider, REQUIRED_TEMPLATES, RichText, SDK_VERSION, Section, SectionContext, ShopContext, THEME_CONTRACT_VERSION, ThemeSettingsContext, applyGlobalStyleTokens, applyImageTransform, asImageTransform, assetUrl, availableValues, buildLocaleBundle, buildThemeElement, clearSdkSingleton, collectBlocks, collectSections, computeGlobalStyleTokens, defaultVariant, defineBlock, defineSection, defineThemeEntry, dynamicSource, findVariantByOptions, flattenMessages, focalSrc, getReactSingleton, getSdkSingleton, isDefinedBlock, isDefinedSection, isDynamicSource, isSdkAvailable, logoImgStyle, logoStyleTokens, mergeResults, mountTheme, pickTranslations, registerReactSingleton, registerSdkSingleton, resolveDynamicValue, resolveFontStack, resolveSettingsMap, resolveSizeChart, resolveSourcePath, resolveThemeSettings, sanitizeHtml, useAnalytics, useApp, useCart, useCheckout, useCollection, useCollectionOptional, useCollections, useCurrency, useCurrentTemplate, useCustomer, useCustomerActions, useCustomerAddresses, useDirection, useFieldTranslation, useGiftCardBalance, useImage, useLocale, useLocalization, useMoney, useNavigation, useNumberFormat, useOrder, useOrders, usePage, useProduct, useProductOptional, useProductSizeChart, useProducts, useRelatedProducts, useReorder, useResolvedSettings, useSearch, useSection, useSectionOptional, useShippingRates, useShop, useThemeSettings, useTranslation, useVariantSelection, useWishlist, validateBuiltManifest, validateManifest, validateSectionSchema, validateSettingsAgainstSchema };
+export { AddToCartButton, Block, CollectionCard, CollectionProvider, CurrencySwitcher, EditableImage, EditableText, Form, HeroMedia, ICON_NAMES, Icon, IconMap, Image, LOGO_SHAPE_OPTIONS, LOGO_SIZE_OPTIONS, Link, LocaleSwitcher, Logo, MAX_BLOCK_DEPTH, Money, NAVIGATE_EVENT, NuMuProvider, ProductCard, ProductProvider, RichText, Section, SectionContext, applyGlobalStyleTokens, applyImageTransform, asImageTransform, assetUrl, availableValues, buildLocaleBundle, buildThemeElement, clearSdkSingleton, collectBlocks, collectSections, computeGlobalStyleTokens, defaultVariant, defineBlock, defineSection, defineThemeEntry, dynamicSource, findVariantByOptions, flattenMessages, focalSrc, getReactSingleton, getSdkSingleton, isDefinedBlock, isDefinedSection, isDynamicSource, isSdkAvailable, logoImgStyle, logoStyleTokens, mountTheme, pickTranslations, publishVariantSelection, readVariantSelection, registerReactSingleton, registerSdkSingleton, requestNavigate, resolveDynamicValue, resolveFontStack, resolveSettingsMap, resolveSizeChart, resolveSourcePath, sanitizeHtml, useAnalytics, useApp, useCachedResource, useCart, useCheckout, useCollection, useCollectionOptional, useCurrency, useCurrentTemplate, useCustomerActions, useCustomerAddresses, useGiftCardBalance, useImage, useMoney, useNavigation, useOrder, useOrders, useProduct, useProductOptional, useProductSizeChart, useRelatedProducts, useReorder, useResolvedSettings, useSearch, useSection, useSectionGroup, useSectionOptional, useShippingRates, useVariantSelection, useWishlist };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map