@numueg/theme-sdk 0.6.0 → 0.9.0

package/dist/{mount-BGumg1JM.d.mts → mount-CM4kGg9w.d.ts}

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ReactElement } from 'react';
-import { C as Cart, b as Collection, c as Customer, P as Page, e as Product, i as Store } from './entities-6MGANln7.mjs';
-import { T as ThemeSettingsV3, M as MountResult } from './theme-D8MOopvi.mjs';
+import { C as Cart, b as Collection, c as Customer, P as Page, e as Product, i as Store } from './entities-B8378GKp.js';
+import { T as ThemeSettingsV3, M as MountResult } from './theme-CNTB4KnU.js';
 
 interface LocalizationState {
     locale: string;
@@ -33,20 +33,40 @@ interface LocalizationState {
      */
     availableLocales: string[];
 }
-declare const ShopContext: react.Context<Store | null>;
-declare const ProductContext: react.Context<Product | null>;
-declare const CollectionContext: react.Context<Collection | null>;
-declare const CartContext: react.Context<{
+/**
+ * Result of a cart mutation (add / remove / update / discount / note).
+ *
+ * `ok` mirrors the HTTP result: `false` for any non-2xx response — an
+ * out-of-stock or validation rejection, a 403 CSRF failure, etc. — so a
+ * theme can surface the failure (toast, inline error) instead of assuming
+ * the write landed. `status` is the HTTP status (0 for a network throw that
+ * the caller catches); `message` carries the backend's error text when the
+ * error body parses.
+ *
+ * Back-compat: the cart methods previously resolved `Promise<void>`; callers
+ * that `await` them and ignore the return keep working unchanged — the
+ * resolved value is purely additive.
+ */
+interface CartMutationResult {
+    ok: boolean;
+    status: number;
+    message?: string;
+}
+interface CartContextValue {
     cart: Cart;
-    addItem: (productId: string, variantId?: string, quantity?: number) => Promise<void>;
-    removeItem: (itemId: string) => Promise<void>;
-    updateQuantity: (itemId: string, quantity: number) => Promise<void>;
-    applyDiscount: (code: string) => Promise<void>;
-    removeDiscount: () => Promise<void>;
-    updateNote: (note: string) => Promise<void>;
+    addItem: (productId: string, variantId?: string, quantity?: number) => Promise<CartMutationResult>;
+    removeItem: (itemId: string) => Promise<CartMutationResult>;
+    updateQuantity: (itemId: string, quantity: number) => Promise<CartMutationResult>;
+    applyDiscount: (code: string) => Promise<CartMutationResult>;
+    removeDiscount: () => Promise<CartMutationResult>;
+    updateNote: (note: string) => Promise<CartMutationResult>;
     clearCart: () => Promise<void>;
     loading: boolean;
-} | null>;
+}
+declare const ShopContext: react.Context<Store | null>;
+declare const ProductContext: react.Context<Product | null>;
+declare const CollectionContext: react.Context<Collection | null>;
+declare const CartContext: react.Context<CartContextValue | null>;
 declare const CustomerContext: react.Context<Customer | null>;
 declare const ThemeSettingsContext: react.Context<ThemeSettingsV3 | null>;
 declare const LocalizationContext: react.Context<LocalizationState | null>;
@@ -86,6 +106,52 @@ interface MenuItemData {
  * doesn't exist (render nothing / fallback), no fetch attempted.
  */
 declare const NavigationContext: react.Context<Record<string, MenuItemData[]>>;
+/**
+ * Multi-currency presentment config, as returned by
+ * `GET /api/storefront/currencies`. Display-only — the store's *capture*
+ * currency never changes mid-session; this just lets visitors browse prices
+ * in a currency they recognize.
+ */
+interface CurrencyConfig {
+    base: string;
+    default_presentment: string;
+    presentment: string[];
+    rates: Record<string, string>;
+    auto_convert: boolean;
+}
+/**
+ * The value `useCurrency()` returns and `CurrencyContext` carries.
+ *
+ * `convert(cents, target?)` returns the converted **cents** in `target`
+ * (defaults to `selected`), using the API rates; returns the input unchanged
+ * when no rate exists (theme renders base — better than a wrong number).
+ */
+interface CurrencyState {
+    base: string;
+    selected: string;
+    presentment: string[];
+    rates: Record<string, number>;
+    autoConvert: boolean;
+    loading: boolean;
+    setSelected: (currency: string) => void;
+    convert: (cents: number, target?: string) => number;
+}
+/**
+ * Phase 2 (correctness) — multi-currency lifted into a provider context.
+ *
+ * Previously `useCurrency()` fetched `/api/storefront/currencies` and held
+ * the selected currency in per-instance `useState`, so each `<Money>`,
+ * `useMoney()` and `<CurrencySwitcher>` owned an INDEPENDENT copy: switching
+ * currency in the switcher never reached the price tags, and every consumer
+ * re-fetched. `NuMuProvider` now fetches ONCE and publishes a single
+ * `CurrencyState` here, so a `<CurrencySwitcher>` change re-renders every
+ * `<Money>` on the page without a reload.
+ *
+ * Null when no provider is present (SSR before hydrate, or a theme mounted
+ * outside `NuMuProvider`); `useCurrency()` then falls back to a base-only,
+ * no-convert state derived from the store currency so `<Money>` still renders.
+ */
+declare const CurrencyContext: react.Context<CurrencyState | null>;
 
 /**
  * `mountTheme(el, ctx, renderApp)` — the canonical V3 bundle entry helper.
@@ -148,6 +214,13 @@ interface ThemeMountPage {
     handle?: string;
     title?: string;
     data?: Record<string, unknown>;
+    /**
+     * Resolved alternate template key for this page (e.g. `"product.wholesale"`)
+     * when the storefront routed it to a template suffix. `mountTheme` forwards
+     * it to `NuMuProvider` so a theme reads it via `usePage()?.template`. Absent
+     * for pages on their default template. Additive/optional.
+     */
+    template?: string;
 }
 /**
  * The mount context a host (or dev harness) passes to a bundle's `mount`.
@@ -222,4 +295,4 @@ declare function buildThemeElement(ctx: ThemeMountContext, mountEl: HTMLElement
  */
 declare function mountTheme(el: HTMLElement, ctx: ThemeMountContext, renderApp: (args: ThemeRenderArgs) => ReactNode): MountResult;
 
-export { CartContext as C, type LocalizationState as L, type MenuItemData as M, NavigationContext as N, PageContext as P, ShopContext as S, type ThemeMountContext as T, type ThemeRenderArgs as a, CollectionContext as b, CustomerContext as c, LocalizationContext as d, ProductContext as e, type ThemeMountPage as f, ThemeSettingsContext as g, buildThemeElement as h, mountTheme as m };
+export { type CartContextValue as C, type LocalizationState as L, type MenuItemData as M, NavigationContext as N, PageContext as P, ShopContext as S, type ThemeMountContext as T, type CurrencyState as a, type ThemeRenderArgs as b, CartContext as c, type CartMutationResult as d, CollectionContext as e, type CurrencyConfig as f, CurrencyContext as g, CustomerContext as h, LocalizationContext as i, ProductContext as j, type ThemeMountPage as k, ThemeSettingsContext as l, buildThemeElement as m, mountTheme as n };

package/dist/{mount-Bt-4ken5.d.ts → mount-NLjFNyBv.d.mts}

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ReactElement } from 'react';
-import { C as Cart, b as Collection, c as Customer, P as Page, e as Product, i as Store } from './entities-6MGANln7.js';
-import { T as ThemeSettingsV3, M as MountResult } from './theme-D8MOopvi.js';
+import { C as Cart, b as Collection, c as Customer, P as Page, e as Product, i as Store } from './entities-B8378GKp.mjs';
+import { T as ThemeSettingsV3, M as MountResult } from './theme-CNTB4KnU.mjs';
 
 interface LocalizationState {
     locale: string;
@@ -33,20 +33,40 @@ interface LocalizationState {
      */
     availableLocales: string[];
 }
-declare const ShopContext: react.Context<Store | null>;
-declare const ProductContext: react.Context<Product | null>;
-declare const CollectionContext: react.Context<Collection | null>;
-declare const CartContext: react.Context<{
+/**
+ * Result of a cart mutation (add / remove / update / discount / note).
+ *
+ * `ok` mirrors the HTTP result: `false` for any non-2xx response — an
+ * out-of-stock or validation rejection, a 403 CSRF failure, etc. — so a
+ * theme can surface the failure (toast, inline error) instead of assuming
+ * the write landed. `status` is the HTTP status (0 for a network throw that
+ * the caller catches); `message` carries the backend's error text when the
+ * error body parses.
+ *
+ * Back-compat: the cart methods previously resolved `Promise<void>`; callers
+ * that `await` them and ignore the return keep working unchanged — the
+ * resolved value is purely additive.
+ */
+interface CartMutationResult {
+    ok: boolean;
+    status: number;
+    message?: string;
+}
+interface CartContextValue {
     cart: Cart;
-    addItem: (productId: string, variantId?: string, quantity?: number) => Promise<void>;
-    removeItem: (itemId: string) => Promise<void>;
-    updateQuantity: (itemId: string, quantity: number) => Promise<void>;
-    applyDiscount: (code: string) => Promise<void>;
-    removeDiscount: () => Promise<void>;
-    updateNote: (note: string) => Promise<void>;
+    addItem: (productId: string, variantId?: string, quantity?: number) => Promise<CartMutationResult>;
+    removeItem: (itemId: string) => Promise<CartMutationResult>;
+    updateQuantity: (itemId: string, quantity: number) => Promise<CartMutationResult>;
+    applyDiscount: (code: string) => Promise<CartMutationResult>;
+    removeDiscount: () => Promise<CartMutationResult>;
+    updateNote: (note: string) => Promise<CartMutationResult>;
     clearCart: () => Promise<void>;
     loading: boolean;
-} | null>;
+}
+declare const ShopContext: react.Context<Store | null>;
+declare const ProductContext: react.Context<Product | null>;
+declare const CollectionContext: react.Context<Collection | null>;
+declare const CartContext: react.Context<CartContextValue | null>;
 declare const CustomerContext: react.Context<Customer | null>;
 declare const ThemeSettingsContext: react.Context<ThemeSettingsV3 | null>;
 declare const LocalizationContext: react.Context<LocalizationState | null>;
@@ -86,6 +106,52 @@ interface MenuItemData {
  * doesn't exist (render nothing / fallback), no fetch attempted.
  */
 declare const NavigationContext: react.Context<Record<string, MenuItemData[]>>;
+/**
+ * Multi-currency presentment config, as returned by
+ * `GET /api/storefront/currencies`. Display-only — the store's *capture*
+ * currency never changes mid-session; this just lets visitors browse prices
+ * in a currency they recognize.
+ */
+interface CurrencyConfig {
+    base: string;
+    default_presentment: string;
+    presentment: string[];
+    rates: Record<string, string>;
+    auto_convert: boolean;
+}
+/**
+ * The value `useCurrency()` returns and `CurrencyContext` carries.
+ *
+ * `convert(cents, target?)` returns the converted **cents** in `target`
+ * (defaults to `selected`), using the API rates; returns the input unchanged
+ * when no rate exists (theme renders base — better than a wrong number).
+ */
+interface CurrencyState {
+    base: string;
+    selected: string;
+    presentment: string[];
+    rates: Record<string, number>;
+    autoConvert: boolean;
+    loading: boolean;
+    setSelected: (currency: string) => void;
+    convert: (cents: number, target?: string) => number;
+}
+/**
+ * Phase 2 (correctness) — multi-currency lifted into a provider context.
+ *
+ * Previously `useCurrency()` fetched `/api/storefront/currencies` and held
+ * the selected currency in per-instance `useState`, so each `<Money>`,
+ * `useMoney()` and `<CurrencySwitcher>` owned an INDEPENDENT copy: switching
+ * currency in the switcher never reached the price tags, and every consumer
+ * re-fetched. `NuMuProvider` now fetches ONCE and publishes a single
+ * `CurrencyState` here, so a `<CurrencySwitcher>` change re-renders every
+ * `<Money>` on the page without a reload.
+ *
+ * Null when no provider is present (SSR before hydrate, or a theme mounted
+ * outside `NuMuProvider`); `useCurrency()` then falls back to a base-only,
+ * no-convert state derived from the store currency so `<Money>` still renders.
+ */
+declare const CurrencyContext: react.Context<CurrencyState | null>;
 
 /**
  * `mountTheme(el, ctx, renderApp)` — the canonical V3 bundle entry helper.
@@ -148,6 +214,13 @@ interface ThemeMountPage {
     handle?: string;
     title?: string;
     data?: Record<string, unknown>;
+    /**
+     * Resolved alternate template key for this page (e.g. `"product.wholesale"`)
+     * when the storefront routed it to a template suffix. `mountTheme` forwards
+     * it to `NuMuProvider` so a theme reads it via `usePage()?.template`. Absent
+     * for pages on their default template. Additive/optional.
+     */
+    template?: string;
 }
 /**
  * The mount context a host (or dev harness) passes to a bundle's `mount`.
@@ -222,4 +295,4 @@ declare function buildThemeElement(ctx: ThemeMountContext, mountEl: HTMLElement
  */
 declare function mountTheme(el: HTMLElement, ctx: ThemeMountContext, renderApp: (args: ThemeRenderArgs) => ReactNode): MountResult;
 
-export { CartContext as C, type LocalizationState as L, type MenuItemData as M, NavigationContext as N, PageContext as P, ShopContext as S, type ThemeMountContext as T, type ThemeRenderArgs as a, CollectionContext as b, CustomerContext as c, LocalizationContext as d, ProductContext as e, type ThemeMountPage as f, ThemeSettingsContext as g, buildThemeElement as h, mountTheme as m };
+export { type CartContextValue as C, type LocalizationState as L, type MenuItemData as M, NavigationContext as N, PageContext as P, ShopContext as S, type ThemeMountContext as T, type CurrencyState as a, type ThemeRenderArgs as b, CartContext as c, type CartMutationResult as d, CollectionContext as e, type CurrencyConfig as f, CurrencyContext as g, CustomerContext as h, LocalizationContext as i, ProductContext as j, type ThemeMountPage as k, ThemeSettingsContext as l, buildThemeElement as m, mountTheme as n };

package/dist/normalize.cjs

@@ -1,96 +1,12 @@
 'use strict';
 
-// 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
-  };
-}
+var chunkTBSNHHFH_cjs = require('./chunk-TBSNHHFH.cjs');
 
-exports.resolveThemeSettings = resolveThemeSettings;
+
+
+Object.defineProperty(exports, "resolveThemeSettings", {
+  enumerable: true,
+  get: function () { return chunkTBSNHHFH_cjs.resolveThemeSettings; }
+});
 //# sourceMappingURL=normalize.cjs.map
 //# sourceMappingURL=normalize.cjs.map

package/dist/normalize.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/normalize.ts"],"names":[],"mappings":"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","file":"normalize.cjs","sourcesContent":["import type {\n  ThemeSettingsV3,\n  SectionGroup,\n  SectionInstance,\n  PageTemplate,\n} from \"../types/theme\";\n\n/**\n * Default theme id when neither the V3 payload nor the legacy `theme.base_theme`\n * is set. Sourced from the env at build time so it stays in sync with the\n * backend's `NUMU_DEFAULT_THEME_ID`.\n *\n * Read once: SDK code that runs in browsers can't read env at runtime, but\n * tsup inlines `process.env.*` at build time when configured to do so.\n */\nconst DEFAULT_THEME_ID =\n  (typeof process !== \"undefined\" &&\n    process.env?.NUMU_DEFAULT_THEME_ID) ||\n  \"modern\";\n\n/**\n * Dual-Read normalization: converts V1/V2 legacy payloads to V3 in memory.\n * Portable — works in both Node.js (SSR) and browser.\n *\n * Output must match the backend's `normalize_legacy_to_v3()` byte-for-byte\n * on the same input. The unit test in __tests__/normalize.test.ts asserts\n * this. If you change the shape here, update the backend mapper too —\n * otherwise stores rendered via SDK and stores rendered via SSR will\n * disagree on what the page contains.\n */\nexport function resolveThemeSettings(\n  raw: Record<string, unknown> | null | undefined,\n): ThemeSettingsV3 {\n  const safeRaw = (raw ?? {}) as Record<string, unknown>;\n\n  // Already V3 — pass through unchanged.\n  if (safeRaw.schema_version === 3) {\n    return safeRaw as unknown as ThemeSettingsV3;\n  }\n\n  const themeBlock = (safeRaw.theme as Record<string, unknown>) || {};\n  const themeId =\n    (typeof themeBlock.base_theme === \"string\" && themeBlock.base_theme) ||\n    DEFAULT_THEME_ID;\n\n  const globalSettings: Record<string, unknown> = {};\n  for (const key of [\n    \"primary_color\",\n    \"secondary_color\",\n    \"font_family\",\n    \"logo_url\",\n  ]) {\n    if (themeBlock[key] !== undefined) globalSettings[key] = themeBlock[key];\n  }\n  if (safeRaw.identity) globalSettings.identity = safeRaw.identity;\n\n  const sections: Record<string, SectionInstance> = {};\n  const order: string[] = [];\n\n  const hero = safeRaw.hero as Record<string, unknown> | undefined;\n  if (hero) {\n    sections[\"hero_1\"] = {\n      type: \"hero\",\n      settings: {\n        // Mirrors backend `normalize_legacy_to_v3` exactly — includes\n        // headline_ar so Arabic content survives the round-trip.\n        headline: hero.headline ?? \"\",\n        headline_ar: hero.headline_ar ?? \"\",\n        subtitle: hero.subtitle ?? \"\",\n        background_image: hero.hero_image_url ?? \"\",\n        cta_text: hero.cta_text ?? \"\",\n        cta_link: hero.cta_link ?? \"\",\n      },\n    };\n    order.push(\"hero_1\");\n  }\n\n  const products = safeRaw.products as Record<string, unknown> | undefined;\n  if (products) {\n    sections[\"featured_1\"] = {\n      type: \"featured-products\",\n      settings: products,\n    };\n    order.push(\"featured_1\");\n  }\n\n  const templates: Record<string, PageTemplate> = {};\n  if (Object.keys(sections).length > 0) {\n    templates[\"home\"] = { name: \"Home\", sections, order };\n  }\n\n  const sectionGroups: Record<string, SectionGroup> = {\n    header: {\n      name: \"Header Group\",\n      sections: {\n        header_1: {\n          type: \"header\",\n          settings: (safeRaw.header as Record<string, unknown>) || {},\n        },\n      },\n      order: [\"header_1\"],\n    },\n    footer: {\n      name: \"Footer Group\",\n      sections: {\n        footer_1: {\n          type: \"footer\",\n          settings: (safeRaw.footer as Record<string, unknown>) || {},\n        },\n      },\n      order: [\"footer_1\"],\n    },\n  };\n\n  let externalTheme: ThemeSettingsV3[\"external_theme\"] = null;\n  const ext = safeRaw.external_theme as\n    | { bundle_url?: unknown; css_url?: unknown; mode?: unknown }\n    | undefined;\n  if (\n    ext &&\n    typeof ext === \"object\" &&\n    typeof ext.bundle_url === \"string\" &&\n    ext.bundle_url\n  ) {\n    externalTheme = {\n      bundle_url: ext.bundle_url,\n      css_url: typeof ext.css_url === \"string\" ? ext.css_url : null,\n      mode: typeof ext.mode === \"string\" ? ext.mode : \"production\",\n    };\n  }\n\n  return {\n    schema_version: 3,\n    theme_id: themeId,\n    global_settings: globalSettings,\n    templates,\n    section_groups: sectionGroups,\n    external_theme: externalTheme,\n  };\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"normalize.cjs"}

package/dist/normalize.d.mts

@@ -1,4 +1,4 @@
-import { T as ThemeSettingsV3 } from './theme-D8MOopvi.mjs';
+import { T as ThemeSettingsV3 } from './theme-CNTB4KnU.mjs';
 
 /**
  * Dual-Read normalization: converts V1/V2 legacy payloads to V3 in memory.

package/dist/normalize.d.ts

@@ -1,4 +1,4 @@
-import { T as ThemeSettingsV3 } from './theme-D8MOopvi.js';
+import { T as ThemeSettingsV3 } from './theme-CNTB4KnU.js';
 
 /**
  * Dual-Read normalization: converts V1/V2 legacy payloads to V3 in memory.

package/dist/normalize.mjs

@@ -1,94 +1,3 @@
-// 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
-  };
-}
-
-export { resolveThemeSettings };
+export { resolveThemeSettings } from './chunk-XF2FGIVS.mjs';
 //# sourceMappingURL=normalize.mjs.map
 //# sourceMappingURL=normalize.mjs.map

package/dist/normalize.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/normalize.ts"],"names":[],"mappings":"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","file":"normalize.mjs","sourcesContent":["import type {\n  ThemeSettingsV3,\n  SectionGroup,\n  SectionInstance,\n  PageTemplate,\n} from \"../types/theme\";\n\n/**\n * Default theme id when neither the V3 payload nor the legacy `theme.base_theme`\n * is set. Sourced from the env at build time so it stays in sync with the\n * backend's `NUMU_DEFAULT_THEME_ID`.\n *\n * Read once: SDK code that runs in browsers can't read env at runtime, but\n * tsup inlines `process.env.*` at build time when configured to do so.\n */\nconst DEFAULT_THEME_ID =\n  (typeof process !== \"undefined\" &&\n    process.env?.NUMU_DEFAULT_THEME_ID) ||\n  \"modern\";\n\n/**\n * Dual-Read normalization: converts V1/V2 legacy payloads to V3 in memory.\n * Portable — works in both Node.js (SSR) and browser.\n *\n * Output must match the backend's `normalize_legacy_to_v3()` byte-for-byte\n * on the same input. The unit test in __tests__/normalize.test.ts asserts\n * this. If you change the shape here, update the backend mapper too —\n * otherwise stores rendered via SDK and stores rendered via SSR will\n * disagree on what the page contains.\n */\nexport function resolveThemeSettings(\n  raw: Record<string, unknown> | null | undefined,\n): ThemeSettingsV3 {\n  const safeRaw = (raw ?? {}) as Record<string, unknown>;\n\n  // Already V3 — pass through unchanged.\n  if (safeRaw.schema_version === 3) {\n    return safeRaw as unknown as ThemeSettingsV3;\n  }\n\n  const themeBlock = (safeRaw.theme as Record<string, unknown>) || {};\n  const themeId =\n    (typeof themeBlock.base_theme === \"string\" && themeBlock.base_theme) ||\n    DEFAULT_THEME_ID;\n\n  const globalSettings: Record<string, unknown> = {};\n  for (const key of [\n    \"primary_color\",\n    \"secondary_color\",\n    \"font_family\",\n    \"logo_url\",\n  ]) {\n    if (themeBlock[key] !== undefined) globalSettings[key] = themeBlock[key];\n  }\n  if (safeRaw.identity) globalSettings.identity = safeRaw.identity;\n\n  const sections: Record<string, SectionInstance> = {};\n  const order: string[] = [];\n\n  const hero = safeRaw.hero as Record<string, unknown> | undefined;\n  if (hero) {\n    sections[\"hero_1\"] = {\n      type: \"hero\",\n      settings: {\n        // Mirrors backend `normalize_legacy_to_v3` exactly — includes\n        // headline_ar so Arabic content survives the round-trip.\n        headline: hero.headline ?? \"\",\n        headline_ar: hero.headline_ar ?? \"\",\n        subtitle: hero.subtitle ?? \"\",\n        background_image: hero.hero_image_url ?? \"\",\n        cta_text: hero.cta_text ?? \"\",\n        cta_link: hero.cta_link ?? \"\",\n      },\n    };\n    order.push(\"hero_1\");\n  }\n\n  const products = safeRaw.products as Record<string, unknown> | undefined;\n  if (products) {\n    sections[\"featured_1\"] = {\n      type: \"featured-products\",\n      settings: products,\n    };\n    order.push(\"featured_1\");\n  }\n\n  const templates: Record<string, PageTemplate> = {};\n  if (Object.keys(sections).length > 0) {\n    templates[\"home\"] = { name: \"Home\", sections, order };\n  }\n\n  const sectionGroups: Record<string, SectionGroup> = {\n    header: {\n      name: \"Header Group\",\n      sections: {\n        header_1: {\n          type: \"header\",\n          settings: (safeRaw.header as Record<string, unknown>) || {},\n        },\n      },\n      order: [\"header_1\"],\n    },\n    footer: {\n      name: \"Footer Group\",\n      sections: {\n        footer_1: {\n          type: \"footer\",\n          settings: (safeRaw.footer as Record<string, unknown>) || {},\n        },\n      },\n      order: [\"footer_1\"],\n    },\n  };\n\n  let externalTheme: ThemeSettingsV3[\"external_theme\"] = null;\n  const ext = safeRaw.external_theme as\n    | { bundle_url?: unknown; css_url?: unknown; mode?: unknown }\n    | undefined;\n  if (\n    ext &&\n    typeof ext === \"object\" &&\n    typeof ext.bundle_url === \"string\" &&\n    ext.bundle_url\n  ) {\n    externalTheme = {\n      bundle_url: ext.bundle_url,\n      css_url: typeof ext.css_url === \"string\" ? ext.css_url : null,\n      mode: typeof ext.mode === \"string\" ? ext.mode : \"production\",\n    };\n  }\n\n  return {\n    schema_version: 3,\n    theme_id: themeId,\n    global_settings: globalSettings,\n    templates,\n    section_groups: sectionGroups,\n    external_theme: externalTheme,\n  };\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"normalize.mjs"}

package/dist/{theme-D8MOopvi.d.mts → theme-CNTB4KnU.d.mts}

@@ -179,9 +179,35 @@ interface SectionPreset {
     settings?: Record<string, any>;
     blocks?: PresetBlock[];
 }
-/** Section component props */
-interface SectionProps {
-    settings: Record<string, any>;
+/**
+ * Section component props.
+ *
+ * Generic over the settings shape so a theme can type its own settings
+ * without hand-rolling a parallel props interface (the `EmpSectionProps`
+ * pattern every theme was duplicating). `id`/`type` mirror the section
+ * instance's key + `SectionInstance.type` so a component can key React
+ * lists, dispatch on type, or emit editor anchors without threading them
+ * separately; `groupId` names the owning `SectionGroup` for header/footer
+ * group sections (absent for template sections).
+ *
+ *   // Loosely typed (default) — settings is Record<string, unknown>:
+ *   function Hero(props: SectionProps) { … }
+ *
+ *   // Strongly typed:
+ *   interface HeroSettings { headline: string; show_cta: boolean }
+ *   function Hero({ settings }: SectionProps<HeroSettings>) {
+ *     return <h1>{settings.headline}</h1>;
+ *   }
+ */
+interface SectionProps<S = Record<string, unknown>> {
+    /** The section instance's key within its template/group. */
+    id: string;
+    /** The section's `type` (its schema type / component name). */
+    type: string;
+    /** Owning section-group id for header/footer group sections; absent for
+     *  template-level sections. */
+    groupId?: string;
+    settings: S;
     blocks?: Record<string, BlockInstance>;
     blockOrder?: string[];
     storeData?: any;

package/dist/{theme-D8MOopvi.d.ts → theme-CNTB4KnU.d.ts}

@@ -179,9 +179,35 @@ interface SectionPreset {
     settings?: Record<string, any>;
     blocks?: PresetBlock[];
 }
-/** Section component props */
-interface SectionProps {
-    settings: Record<string, any>;
+/**
+ * Section component props.
+ *
+ * Generic over the settings shape so a theme can type its own settings
+ * without hand-rolling a parallel props interface (the `EmpSectionProps`
+ * pattern every theme was duplicating). `id`/`type` mirror the section
+ * instance's key + `SectionInstance.type` so a component can key React
+ * lists, dispatch on type, or emit editor anchors without threading them
+ * separately; `groupId` names the owning `SectionGroup` for header/footer
+ * group sections (absent for template sections).
+ *
+ *   // Loosely typed (default) — settings is Record<string, unknown>:
+ *   function Hero(props: SectionProps) { … }
+ *
+ *   // Strongly typed:
+ *   interface HeroSettings { headline: string; show_cta: boolean }
+ *   function Hero({ settings }: SectionProps<HeroSettings>) {
+ *     return <h1>{settings.headline}</h1>;
+ *   }
+ */
+interface SectionProps<S = Record<string, unknown>> {
+    /** The section instance's key within its template/group. */
+    id: string;
+    /** The section's `type` (its schema type / component name). */
+    type: string;
+    /** Owning section-group id for header/footer group sections; absent for
+     *  template-level sections. */
+    groupId?: string;
+    settings: S;
     blocks?: Record<string, BlockInstance>;
     blockOrder?: string[];
     storeData?: any;

package/dist/types.d.mts

@@ -1,2 +1,2 @@
-export { A as Address, C as Cart, a as CartItem, b as Collection, c as Customer, O as Order, d as OrderItem, P as Page, e as Product, f as ProductImage, g as ProductVariant, S as SizeChart, h as SizeChartMode, i as Store } from './entities-6MGANln7.mjs';
-export { B as BlockInstance, a as BlockProps, b as BlockSchema, E as ExternalThemeMetadata, P as PageTemplate, S as SectionGroup, c as SectionInstance, d as SectionPreset, e as SectionProps, f as SectionSchema, g as SettingDefinition, T as ThemeSettingsV3 } from './theme-D8MOopvi.mjs';
+export { A as Address, C as Cart, a as CartItem, b as Collection, c as Customer, O as Order, d as OrderItem, P as Page, e as Product, f as ProductImage, g as ProductVariant, S as SizeChart, h as SizeChartMode, i as Store } from './entities-B8378GKp.mjs';
+export { B as BlockInstance, a as BlockProps, b as BlockSchema, E as ExternalThemeMetadata, P as PageTemplate, S as SectionGroup, c as SectionInstance, d as SectionPreset, e as SectionProps, f as SectionSchema, g as SettingDefinition, T as ThemeSettingsV3 } from './theme-CNTB4KnU.mjs';

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-export { A as Address, C as Cart, a as CartItem, b as Collection, c as Customer, O as Order, d as OrderItem, P as Page, e as Product, f as ProductImage, g as ProductVariant, S as SizeChart, h as SizeChartMode, i as Store } from './entities-6MGANln7.js';
-export { B as BlockInstance, a as BlockProps, b as BlockSchema, E as ExternalThemeMetadata, P as PageTemplate, S as SectionGroup, c as SectionInstance, d as SectionPreset, e as SectionProps, f as SectionSchema, g as SettingDefinition, T as ThemeSettingsV3 } from './theme-D8MOopvi.js';
+export { A as Address, C as Cart, a as CartItem, b as Collection, c as Customer, O as Order, d as OrderItem, P as Page, e as Product, f as ProductImage, g as ProductVariant, S as SizeChart, h as SizeChartMode, i as Store } from './entities-B8378GKp.js';
+export { B as BlockInstance, a as BlockProps, b as BlockSchema, E as ExternalThemeMetadata, P as PageTemplate, S as SectionGroup, c as SectionInstance, d as SectionPreset, e as SectionProps, f as SectionSchema, g as SettingDefinition, T as ThemeSettingsV3 } from './theme-CNTB4KnU.js';