@numueg/theme-sdk 0.12.0 → 0.13.1

package/dist/{mount-DDFMacmj.d.mts → mount-BTaDtz8k.d.mts}

@@ -1,6 +1,6 @@
 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-1XRRUTlO.mjs';
+import { C as Cart, b as Collection, c as Customer, P as Page, e as Product, i as Store } from './entities-DRKn04q0.mjs';
 import { T as ThemeSettingsV3, M as MountResult } from './theme-CNTB4KnU.mjs';
 
 interface LocalizationState {

package/dist/{mount-qofjiBxw.d.ts → mount-CLQniVfc.d.ts}

@@ -1,6 +1,6 @@
 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-1XRRUTlO.js';
+import { C as Cart, b as Collection, c as Customer, P as Page, e as Product, i as Store } from './entities-DRKn04q0.js';
 import { T as ThemeSettingsV3, M as MountResult } from './theme-CNTB4KnU.js';
 
 interface LocalizationState {

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-1XRRUTlO.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-DRKn04q0.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-1XRRUTlO.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-DRKn04q0.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';

package/dist/v2-compat.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkV3JDQXD3_cjs = require('./chunk-V3JDQXD3.cjs');
+var chunkWNMFED3F_cjs = require('./chunk-WNMFED3F.cjs');
 var react = require('react');
 
 function useV2Products() {
-  const { products, loading } = chunkV3JDQXD3_cjs.useProducts();
+  const { products, loading } = chunkWNMFED3F_cjs.useProducts();
   return react.useMemo(
     () => ({
       products,
@@ -23,7 +23,7 @@ function collectionToV2Category(c) {
   };
 }
 function useV2Categories() {
-  const { collections, loading } = chunkV3JDQXD3_cjs.useCollections();
+  const { collections, loading } = chunkWNMFED3F_cjs.useCollections();
   return react.useMemo(
     () => ({
       categories: collections.map(collectionToV2Category),
@@ -33,7 +33,7 @@ function useV2Categories() {
   );
 }
 function useV2Auth() {
-  const customer = chunkV3JDQXD3_cjs.useCustomer();
+  const customer = chunkWNMFED3F_cjs.useCustomer();
   return react.useMemo(
     () => ({
       user: customer,
@@ -43,7 +43,7 @@ function useV2Auth() {
   );
 }
 function useV2Language() {
-  const { locale, direction, translations, setLocale } = chunkV3JDQXD3_cjs.useLocalization();
+  const { locale, direction, translations, setLocale } = chunkWNMFED3F_cjs.useLocalization();
   const normalisedLocale = locale === "ar" ? "ar" : "en";
   return react.useMemo(
     () => ({
@@ -56,7 +56,7 @@ function useV2Language() {
   );
 }
 function useV2Theme() {
-  const settings = chunkV3JDQXD3_cjs.useThemeSettings();
+  const settings = chunkWNMFED3F_cjs.useThemeSettings();
   return react.useMemo(() => {
     const g = settings.global_settings ?? {};
     const get = (key) => {

package/dist/v2-compat.d.mts

@@ -1,4 +1,4 @@
-import { c as Customer, e as Product } from './entities-1XRRUTlO.mjs';
+import { c as Customer, e as Product } from './entities-DRKn04q0.mjs';
 
 /**
  * V2 → V3 compatibility shim.

package/dist/v2-compat.d.ts

@@ -1,4 +1,4 @@
-import { c as Customer, e as Product } from './entities-1XRRUTlO.js';
+import { c as Customer, e as Product } from './entities-DRKn04q0.js';
 
 /**
  * V2 → V3 compatibility shim.

package/dist/v2-compat.mjs

@@ -1,4 +1,4 @@
-import { useProducts, useCollections, useCustomer, useLocalization, useThemeSettings } from './chunk-ZYZZG4JR.mjs';
+import { useProducts, useCollections, useCustomer, useLocalization, useThemeSettings } from './chunk-VZO2WMEM.mjs';
 import { useMemo } from 'react';
 
 function useV2Products() {

package/dist/validation.cjs

@@ -1,48 +1,48 @@
 'use strict';
 
-var chunk7RZISLP2_cjs = require('./chunk-7RZISLP2.cjs');
+var chunkJXJP6FND_cjs = require('./chunk-JXJP6FND.cjs');
 
 
 
 Object.defineProperty(exports, "KNOWN_SETTING_TYPES", {
   enumerable: true,
-  get: function () { return chunk7RZISLP2_cjs.KNOWN_SETTING_TYPES; }
+  get: function () { return chunkJXJP6FND_cjs.KNOWN_SETTING_TYPES; }
 });
 Object.defineProperty(exports, "KNOWN_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunk7RZISLP2_cjs.KNOWN_TEMPLATES; }
+  get: function () { return chunkJXJP6FND_cjs.KNOWN_TEMPLATES; }
 });
 Object.defineProperty(exports, "REQUIRED_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunk7RZISLP2_cjs.REQUIRED_TEMPLATES; }
+  get: function () { return chunkJXJP6FND_cjs.REQUIRED_TEMPLATES; }
 });
 Object.defineProperty(exports, "SDK_VERSION", {
   enumerable: true,
-  get: function () { return chunk7RZISLP2_cjs.SDK_VERSION; }
+  get: function () { return chunkJXJP6FND_cjs.SDK_VERSION; }
 });
 Object.defineProperty(exports, "THEME_CONTRACT_VERSION", {
   enumerable: true,
-  get: function () { return chunk7RZISLP2_cjs.THEME_CONTRACT_VERSION; }
+  get: function () { return chunkJXJP6FND_cjs.THEME_CONTRACT_VERSION; }
 });
 Object.defineProperty(exports, "mergeResults", {
   enumerable: true,
-  get: function () { return chunk7RZISLP2_cjs.mergeResults; }
+  get: function () { return chunkJXJP6FND_cjs.mergeResults; }
 });
 Object.defineProperty(exports, "validateBuiltManifest", {
   enumerable: true,
-  get: function () { return chunk7RZISLP2_cjs.validateBuiltManifest; }
+  get: function () { return chunkJXJP6FND_cjs.validateBuiltManifest; }
 });
 Object.defineProperty(exports, "validateManifest", {
   enumerable: true,
-  get: function () { return chunk7RZISLP2_cjs.validateManifest; }
+  get: function () { return chunkJXJP6FND_cjs.validateManifest; }
 });
 Object.defineProperty(exports, "validateSectionSchema", {
   enumerable: true,
-  get: function () { return chunk7RZISLP2_cjs.validateSectionSchema; }
+  get: function () { return chunkJXJP6FND_cjs.validateSectionSchema; }
 });
 Object.defineProperty(exports, "validateSettingsAgainstSchema", {
   enumerable: true,
-  get: function () { return chunk7RZISLP2_cjs.validateSettingsAgainstSchema; }
+  get: function () { return chunkJXJP6FND_cjs.validateSettingsAgainstSchema; }
 });
 //# sourceMappingURL=validation.cjs.map
 //# sourceMappingURL=validation.cjs.map

package/dist/validation.mjs

@@ -1,3 +1,3 @@
-export { KNOWN_SETTING_TYPES, KNOWN_TEMPLATES, REQUIRED_TEMPLATES, SDK_VERSION, THEME_CONTRACT_VERSION, mergeResults, validateBuiltManifest, validateManifest, validateSectionSchema, validateSettingsAgainstSchema } from './chunk-ZECKSIDL.mjs';
+export { KNOWN_SETTING_TYPES, KNOWN_TEMPLATES, REQUIRED_TEMPLATES, SDK_VERSION, THEME_CONTRACT_VERSION, mergeResults, validateBuiltManifest, validateManifest, validateSectionSchema, validateSettingsAgainstSchema } from './chunk-AFOLV2U5.mjs';
 //# sourceMappingURL=validation.mjs.map
 //# sourceMappingURL=validation.mjs.map

package/dist/verify.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk7RZISLP2_cjs = require('./chunk-7RZISLP2.cjs');
+var chunkJXJP6FND_cjs = require('./chunk-JXJP6FND.cjs');
 
 // src/verify/index.ts
 function makeFixtureStore(overrides = {}) {
@@ -127,7 +127,7 @@ function makeFixtureContext(template, overrides = {}) {
   };
 }
 async function verifyThemeRender(serverModule, options = {}) {
-  const templates = options.templates ?? chunk7RZISLP2_cjs.REQUIRED_TEMPLATES;
+  const templates = options.templates ?? chunkJXJP6FND_cjs.REQUIRED_TEMPLATES;
   if (!serverModule || typeof serverModule.createApp !== "function") {
     return {
       ok: false,
@@ -172,7 +172,7 @@ async function verifyThemeRender(serverModule, options = {}) {
 
 Object.defineProperty(exports, "REQUIRED_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunk7RZISLP2_cjs.REQUIRED_TEMPLATES; }
+  get: function () { return chunkJXJP6FND_cjs.REQUIRED_TEMPLATES; }
 });
 exports.makeFixtureCart = makeFixtureCart;
 exports.makeFixtureCollection = makeFixtureCollection;

package/dist/verify.d.mts

@@ -1,6 +1,6 @@
 import { ReactElement } from 'react';
-import { C as Cart, b as Collection, c as Customer, e as Product, i as Store } from './entities-1XRRUTlO.mjs';
-import { T as ThemeMountContext } from './mount-DDFMacmj.mjs';
+import { C as Cart, b as Collection, c as Customer, e as Product, i as Store } from './entities-DRKn04q0.mjs';
+import { T as ThemeMountContext } from './mount-BTaDtz8k.mjs';
 export { REQUIRED_TEMPLATES } from './validation.mjs';
 import './theme-CNTB4KnU.mjs';
 

package/dist/verify.d.ts

@@ -1,6 +1,6 @@
 import { ReactElement } from 'react';
-import { C as Cart, b as Collection, c as Customer, e as Product, i as Store } from './entities-1XRRUTlO.js';
-import { T as ThemeMountContext } from './mount-qofjiBxw.js';
+import { C as Cart, b as Collection, c as Customer, e as Product, i as Store } from './entities-DRKn04q0.js';
+import { T as ThemeMountContext } from './mount-CLQniVfc.js';
 export { REQUIRED_TEMPLATES } from './validation.js';
 import './theme-CNTB4KnU.js';
 

package/dist/verify.mjs

@@ -1,5 +1,5 @@
-import { REQUIRED_TEMPLATES } from './chunk-ZECKSIDL.mjs';
-export { REQUIRED_TEMPLATES } from './chunk-ZECKSIDL.mjs';
+import { REQUIRED_TEMPLATES } from './chunk-AFOLV2U5.mjs';
+export { REQUIRED_TEMPLATES } from './chunk-AFOLV2U5.mjs';
 
 // src/verify/index.ts
 function makeFixtureStore(overrides = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@numueg/theme-sdk",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "description": "NUMU Theme SDK — typed hooks, components, and utilities for building NUMU storefront themes",
   "keywords": [
     "numu",

package/dist/chunk-V3JDQXD3.cjs.map

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

package/dist/chunk-ZYZZG4JR.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/contexts/index.ts","../src/hooks/useLocalization.ts","../src/hooks/useShop.ts","../src/hooks/useCustomer.ts","../src/hooks/useThemeSettings.ts","../src/hooks/usePage.ts","../src/hooks/useProducts.ts","../src/hooks/useCollections.ts"],"names":["useContext","useState","useEffect"],"mappings":"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","file":"chunk-ZYZZG4JR.mjs","sourcesContent":["\"use client\";\nimport { createContext } from \"react\";\nimport type { Store, Product, Collection, Cart, Customer, Page } from \"../types/entities\";\nimport type { ThemeSettingsV3 } from \"../types/theme\";\n\nexport interface LocalizationState {\n  locale: string;\n  direction: \"ltr\" | \"rtl\";\n  translations: Record<string, string>;\n  formatMoney: (amount: number, currency?: string) => string;\n  formatDate: (date: string | Date) => string;\n  /**\n   * Phase 3.7 — locale-aware number formatter. Routes to either\n   * Western (1234) or Arab-Indic (١٢٣٤) digits depending on\n   * `store.settings.numerals`. Themes calling formatMoney get the\n   * same digit choice automatically; this is for raw counts (\"12 items\").\n   */\n  formatNumber: (n: number, options?: Intl.NumberFormatOptions) => string;\n  /**\n   * Phase 3.6 — switch the active locale.\n   *\n   * Sets the `numu_locale` cookie and triggers a full page reload so\n   * the server-rendered layout picks up the new locale (the storefront\n   * resolves locale at SSR time from cookie/query). Returns once the\n   * cookie is written; the page navigation cancels any pending React\n   * work so callers don't need to await.\n   */\n  setLocale: (next: string) => void;\n  /**\n   * Phase 3.6 — list of locales the store advertises. Empty when the\n   * store hasn't configured a multi-locale catalog. Themes use this\n   * to decide whether to render the LocaleSwitcher at all.\n   */\n  availableLocales: string[];\n}\n\n/**\n * Result of a cart mutation (add / remove / update / discount / note).\n *\n * `ok` mirrors the HTTP result: `false` for any non-2xx response — an\n * out-of-stock or validation rejection, a 403 CSRF failure, etc. — so a\n * theme can surface the failure (toast, inline error) instead of assuming\n * the write landed. `status` is the HTTP status (0 for a network throw that\n * the caller catches); `message` carries the backend's error text when the\n * error body parses.\n *\n * Back-compat: the cart methods previously resolved `Promise<void>`; callers\n * that `await` them and ignore the return keep working unchanged — the\n * resolved value is purely additive.\n */\nexport interface CartMutationResult {\n  ok: boolean;\n  status: number;\n  message?: string;\n  /** The cart applied by a successful write (MAJOR currency units, same\n   *  normalization as `useCart().cart`). Lets callers read the written\n   *  state — e.g. addItem prices its AddToCart analytics event from the\n   *  added line — without racing React state. Absent on failure. */\n  cart?: Cart;\n}\n\nexport interface CartContextValue {\n  cart: Cart;\n  addItem: (\n    productId: string,\n    variantId?: string,\n    quantity?: number,\n    /** Picker axes ({Color: \"Black\", Size: \"L\"}) — variant_name fallback for\n     *  products whose variant rows carry no option_values. */\n    selectedOptions?: Record<string, string>,\n  ) => Promise<CartMutationResult>;\n  removeItem: (itemId: string) => Promise<CartMutationResult>;\n  updateQuantity: (\n    itemId: string,\n    quantity: number,\n  ) => Promise<CartMutationResult>;\n  applyDiscount: (code: string) => Promise<CartMutationResult>;\n  removeDiscount: () => Promise<CartMutationResult>;\n  updateNote: (note: string) => Promise<CartMutationResult>;\n  clearCart: () => Promise<void>;\n  loading: boolean;\n}\n\nexport const ShopContext = createContext<Store | null>(null);\nexport const ProductContext = createContext<Product | null>(null);\nexport const CollectionContext = createContext<Collection | null>(null);\nexport const CartContext = createContext<CartContextValue | null>(null);\nexport const CustomerContext = createContext<Customer | null>(null);\nexport const ThemeSettingsContext = createContext<ThemeSettingsV3 | null>(null);\nexport const LocalizationContext = createContext<LocalizationState | null>(null);\nexport const PageContext = createContext<Page | null>(null);\n/**\n * Wave 5 — currently-active template identifier. Mirrors the key inside\n * `themeSettings.templates.<currentTemplate>` so themes can dispatch\n * which section list to render. Hosts set this via `NuMuProvider`'s\n * `currentTemplate` prop (which is passed in by the storefront page\n * component — `app/(store)/[subdomain]/product/[id]/page.tsx` passes\n * \"product\", `cart/page.tsx` passes \"cart\", etc.). Falls back to \"home\".\n */\nexport const CurrentTemplateContext = createContext<string>(\"home\");\n\n/**\n * A merchant-managed navigation menu item, exactly as the storefront\n * menus resolver returns it (`GET /storefront/store/{id}/menus`):\n * bilingual `label`, a pre-resolved `url`, and nested `children`.\n *\n * This is the RAW shape the host injects via `NuMuProvider`'s\n * `navigation` prop. `useNavigation(handle)` localizes it to the\n * display-ready `NavigationItem` (a single `title` string for the\n * active locale).\n */\nexport interface MenuItemData {\n  id: string;\n  label: Record<string, string>;\n  url: string;\n  type?: string | null;\n  resource_id?: string | null;\n  /**\n   * §5 hide-page → hide-nav-link. `false` when the item targets a CMS page\n   * (`/pages/<handle>`) that is currently unpublished or deleted. The backend\n   * menus resolver annotates it; absent/`true` means visible (back-compat).\n   */\n  target_visible?: boolean;\n  children?: MenuItemData[];\n}\n\n/**\n * Phase 2.4 — navigation menus keyed by handle (`main-menu`, `footer`,\n * plus custom), injected by the host from the storefront resolver so a\n * theme's `useNavigation(handle)` resolves without a client round-trip.\n *\n * Defaults to `{}` — an empty map signals \"host provided no menus\", at\n * which point `useNavigation` falls back to its own fetch / a theme's\n * `DEFAULT_NAV`. A present-but-handle-absent map means the menu simply\n * doesn't exist (render nothing / fallback), no fetch attempted.\n */\nexport const NavigationContext = createContext<Record<string, MenuItemData[]>>(\n  {},\n);\n\n/**\n * Multi-currency presentment config, as returned by\n * `GET /api/storefront/currencies`. Display-only — the store's *capture*\n * currency never changes mid-session; this just lets visitors browse prices\n * in a currency they recognize.\n */\nexport interface CurrencyConfig {\n  base: string;\n  default_presentment: string;\n  presentment: string[];\n  rates: Record<string, string>; // Decimal-as-string\n  auto_convert: boolean;\n}\n\n/**\n * The value `useCurrency()` returns and `CurrencyContext` carries.\n *\n * `convert(cents, target?)` returns the converted **cents** in `target`\n * (defaults to `selected`), using the API rates; returns the input unchanged\n * when no rate exists (theme renders base — better than a wrong number).\n */\nexport interface CurrencyState {\n  base: string;\n  selected: string;\n  presentment: string[];\n  rates: Record<string, number>;\n  autoConvert: boolean;\n  loading: boolean;\n  setSelected: (currency: string) => void;\n  convert: (cents: number, target?: string) => number;\n}\n\n/**\n * Phase 2 (correctness) — multi-currency lifted into a provider context.\n *\n * Previously `useCurrency()` fetched `/api/storefront/currencies` and held\n * the selected currency in per-instance `useState`, so each `<Money>`,\n * `useMoney()` and `<CurrencySwitcher>` owned an INDEPENDENT copy: switching\n * currency in the switcher never reached the price tags, and every consumer\n * re-fetched. `NuMuProvider` now fetches ONCE and publishes a single\n * `CurrencyState` here, so a `<CurrencySwitcher>` change re-renders every\n * `<Money>` on the page without a reload.\n *\n * Null when no provider is present (SSR before hydrate, or a theme mounted\n * outside `NuMuProvider`); `useCurrency()` then falls back to a base-only,\n * no-convert state derived from the store currency so `<Money>` still renders.\n */\nexport const CurrencyContext = createContext<CurrencyState | null>(null);\n","import { useContext } from \"react\";\nimport { LocalizationContext } from \"../contexts\";\nimport type { LocalizationState } from \"../contexts\";\n\nexport function useLocalization(): LocalizationState {\n  const ctx = useContext(LocalizationContext);\n  if (!ctx) throw new Error(\"useLocalization must be used within NuMuProvider\");\n  return ctx;\n}\n\nexport function useDirection(): \"ltr\" | \"rtl\" {\n  const { direction } = useLocalization();\n  return direction;\n}\n\nexport function useLocale(): string {\n  const { locale } = useLocalization();\n  return locale;\n}\n\nexport function useTranslation() {\n  const { translations, locale } = useLocalization();\n  return {\n    t: (key: string, fallback?: string) => translations[key] || fallback || key,\n    locale,\n  };\n}\n\n/**\n * Phase 3.6 — pull a translated field off a domain object.\n *\n * Convention: per-product translations live on `entity.attributes`\n * keyed as `<field>_<locale>` — e.g. `name_ar`, `description_ar`.\n * Backend writes these via the merchant hub when a merchant turns on\n * \"Translations\" for a product. Themes call:\n *\n *     const productName = useFieldTranslation(product, \"name\");\n *\n * and get the Arabic name when the active locale is \"ar\", falling\n * back to the English `product.name` otherwise. Works for any object\n * that pairs a base field on the entity with an `attributes` JSONB\n * blob holding the translated variants.\n *\n * Why not put translations on the entity itself? Adding `name_ar`,\n * `description_ar`, `name_he`, etc. as first-class columns means a\n * schema migration every time a merchant enables a new locale. JSONB\n * lets the merchant flip locales on/off in settings without touching\n * the table.\n */\nexport function useFieldTranslation<\n  T extends { attributes?: Record<string, unknown> },\n>(entity: T | null | undefined, field: string): string | undefined {\n  const { locale } = useLocalization();\n  if (!entity) return undefined;\n  // English (or whichever default locale the merchant configured) is\n  // stored as the base field; non-default locales live on attributes\n  // with a `<field>_<locale>` key.\n  const translated =\n    entity.attributes && typeof entity.attributes === \"object\"\n      ? (entity.attributes as Record<string, unknown>)[`${field}_${locale}`]\n      : undefined;\n  if (typeof translated === \"string\" && translated) return translated;\n  // Base field — supports any value type that stringifies sensibly.\n  const base = (entity as unknown as Record<string, unknown>)[field];\n  if (typeof base === \"string\") return base;\n  if (base == null) return undefined;\n  return String(base);\n}\n\n/**\n * Phase 3.7 — formatted-number hook.\n *\n * Themes that need to render counts (\"12 items\", \"3 reviews\") should\n * route through this hook so Arab-Indic digits (٠١٢٣٤) vs Western\n * (01234) stay consistent with money + date elsewhere on the page.\n *\n *     const fmtNum = useNumberFormat();\n *     fmtNum(12)              → \"12\"   (or \"١٢\" for Arabic stores)\n *     fmtNum(12.5, { minimumFractionDigits: 2 }) → \"12.50\" / \"١٢٫٥٠\"\n */\nexport function useNumberFormat() {\n  const { formatNumber } = useLocalization();\n  return formatNumber;\n}\n","\"use client\";\nimport { useContext, useMemo } from \"react\";\nimport { ShopContext } from \"../contexts\";\nimport { useLocale } from \"./useLocalization\";\nimport type { Store } from \"../types/entities\";\n\n/**\n * Augmented Store shape returned from useShop().\n *\n * Adds a couple of conveniences theme devs reach for constantly:\n *   - `domain` — the active hostname (subdomain or custom). Resolved\n *     from `store.domain ?? store.subdomain ?? store.slug`.\n *   - `formatUrl(path)` — emits a fully-qualified URL using `domain`.\n *     Theme code that needs to render absolute URLs (canonical tags,\n *     Open Graph, JSON-LD) goes through this so dev/prod / subdomain\n *     vs. custom-domain stays correct without each theme reinventing\n *     the resolver.\n */\nexport interface ShopWithHelpers extends Store {\n  /** Fully-qualified hostname this store currently serves on. */\n  domain: string;\n  /**\n   * Format a path (relative or absolute) as a fully-qualified URL on\n   * this store's domain. No-ops when given an already-absolute URL.\n   *\n   * Phase 6 — when the active locale is non-default and the store\n   * has opted into locale URL prefixes, the path is prefixed with\n   * `/{locale}/` (e.g. `/ar/products/foo`). Already-prefixed paths\n   * are left alone so calling `formatUrl(formatUrl(...))` is safe.\n   */\n  formatUrl(path: string): string;\n}\n\nconst DEFAULT_PROTOCOL =\n  typeof window !== \"undefined\"\n    ? window.location.protocol.replace(\":\", \"\")\n    : \"https\";\n\nfunction resolveDomain(store: Store): string {\n  // Custom domain wins when set; otherwise fall back to the platform\n  // subdomain. The slug is a last resort for stores that haven't been\n  // assigned either yet (mostly demo stores in dev).\n  if (store.domain) return store.domain;\n  if (store.subdomain) {\n    // The platform-domain default lives on the storefront; theme code\n    // doesn't have access to env vars, so we read it off the runtime\n    // window object when present and fall back to the well-known\n    // production value. Themes can override by rendering with\n    // `<meta name=\"numu:platform-domain\" content=\"...\">` if they're\n    // hosted on a non-default platform.\n    const platform =\n      (typeof window !== \"undefined\" &&\n        (window as unknown as { __NUMU_PLATFORM_DOMAIN?: string })\n          .__NUMU_PLATFORM_DOMAIN) ||\n      \"numueg.app\";\n    return `${store.subdomain}.${platform}`;\n  }\n  return store.slug;\n}\n\nexport function useShop(): ShopWithHelpers {\n  const ctx = useContext(ShopContext);\n  if (!ctx) throw new Error(\"useShop must be used within NuMuProvider\");\n  const locale = useLocale();\n\n  return useMemo(() => {\n    const domain = resolveDomain(ctx);\n    const settings = (ctx as Store & { settings?: Record<string, unknown> })\n      .settings;\n    const localePrefixEnabled = Boolean(\n      settings && (settings as { locale_url_prefix_enabled?: boolean }).locale_url_prefix_enabled,\n    );\n    const defaultLocale = ctx.default_language || \"en\";\n    // List of locales that get a URL prefix. Defaults to \"everything\n    // except the default\" — but a store can opt into `[\"ar\", \"en\"]`\n    // (prefix even the default) if it wants a fully prefixed URL\n    // scheme like Shopify does for markets.\n    const prefixedLocales =\n      (settings as { locale_url_prefix_locales?: string[] } | undefined)\n        ?.locale_url_prefix_locales || null;\n    const shouldPrefix = (l: string): boolean => {\n      if (!localePrefixEnabled) return false;\n      if (prefixedLocales) return prefixedLocales.includes(l);\n      return l !== defaultLocale;\n    };\n\n    const formatUrl = (path: string): string => {\n      if (!path) return `${DEFAULT_PROTOCOL}://${domain}/`;\n      // Already absolute? Hand back as-is.\n      if (/^https?:\\/\\//i.test(path)) return path;\n      // Protocol-relative — assume same protocol as the host.\n      if (path.startsWith(\"//\")) return `${DEFAULT_PROTOCOL}:${path}`;\n      let normalized = path.startsWith(\"/\") ? path : `/${path}`;\n      if (locale && shouldPrefix(locale)) {\n        // Idempotent: don't double-prefix if the caller already\n        // gave us a /{locale}/... path.\n        const prefix = `/${locale}/`;\n        const root = `/${locale}`;\n        if (normalized !== root && !normalized.startsWith(prefix)) {\n          normalized = `${root}${normalized}`;\n        }\n      }\n      return `${DEFAULT_PROTOCOL}://${domain}${normalized}`;\n    };\n    return { ...ctx, domain, formatUrl };\n  }, [ctx, locale]);\n}\n","import { useContext } from \"react\";\nimport { CustomerContext } from \"../contexts\";\nimport type { Customer } from \"../types/entities\";\n\nexport function useCustomer(): Customer | null {\n  return useContext(CustomerContext);\n}\n","import { useContext } from \"react\";\nimport { ThemeSettingsContext } from \"../contexts\";\nimport type { ThemeSettingsV3 } from \"../types/theme\";\n\nexport function useThemeSettings(): ThemeSettingsV3 {\n  const ctx = useContext(ThemeSettingsContext);\n  if (!ctx) throw new Error(\"useThemeSettings must be used within NuMuProvider\");\n  return ctx;\n}\n","import { useContext } from \"react\";\nimport { PageContext } from \"../contexts\";\nimport type { Page } from \"../types/entities\";\n\nexport function usePage(): Page | null {\n  return useContext(PageContext);\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\nimport { usePage } from \"./usePage\";\nimport { useShop } from \"./useShop\";\nimport type { Product } from \"../types/entities\";\n\ninterface UseProductsOptions {\n  /** Limit the slice returned. Defaults to whatever the host gave us. */\n  limit?: number;\n  /**\n   * When true, fetch from `/api/products` if the host didn't provide a\n   * list via PageContext. Useful for sections rendered on routes that\n   * don't pre-fetch products (e.g. a custom CMS page that wants a\n   * \"featured\" rail). Default: false — themes typically prefer SSR data.\n   */\n  fetchIfMissing?: boolean;\n}\n\ninterface UseProductsResult {\n  products: Product[];\n  loading: boolean;\n  error: Error | null;\n}\n\n/**\n * useProducts — read the storefront-pre-fetched product list from the\n * page context, optionally falling back to a client-side fetch.\n *\n * The SSR path passes `page.data.products: Product[]` from\n * `numu-storefront/src/app/[domain]/page.tsx`; sections on the home\n * route get them for free. For other routes that don't pre-fetch, set\n * `fetchIfMissing: true` and we'll hit `/api/products`.\n */\nexport function useProducts(\n  opts: UseProductsOptions = {},\n): UseProductsResult {\n  const { limit, fetchIfMissing = false } = opts;\n  const page = usePage();\n  const shop = useShop();\n  const initial = (page?.data?.products as Product[] | undefined) ?? null;\n\n  const [products, setProducts] = useState<Product[]>(initial ?? []);\n  const [loading, setLoading] = useState<boolean>(\n    initial == null && fetchIfMissing,\n  );\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    if (initial != null) return;\n    if (!fetchIfMissing) return;\n    if (!shop?.id) return;\n    let cancelled = false;\n    (async () => {\n      try {\n        const params = new URLSearchParams({ store_id: shop.id });\n        if (limit) params.set(\"limit\", String(limit));\n        const res = await fetch(`/api/products?${params.toString()}`);\n        if (!res.ok) throw new Error(`/api/products → ${res.status}`);\n        const data = (await res.json()) as { products?: Product[] };\n        if (cancelled) return;\n        setProducts(data.products ?? []);\n        setLoading(false);\n      } catch (err) {\n        if (cancelled) return;\n        setError(err instanceof Error ? err : new Error(String(err)));\n        setLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [initial, fetchIfMissing, limit, shop?.id]);\n\n  const sliced = limit != null ? products.slice(0, limit) : products;\n  return { products: sliced, loading, error };\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\nimport { usePage } from \"./usePage\";\nimport { useShop } from \"./useShop\";\nimport type { Collection } from \"../types/entities\";\n\ninterface UseCollectionsOptions {\n  limit?: number;\n  fetchIfMissing?: boolean;\n}\n\ninterface UseCollectionsResult {\n  collections: Collection[];\n  loading: boolean;\n  error: Error | null;\n}\n\n/**\n * useCollections — analog to useProducts. Reads page.data.collections\n * pre-fetched by the storefront SSR; falls back to /api/collections\n * when fetchIfMissing is true.\n */\nexport function useCollections(\n  opts: UseCollectionsOptions = {},\n): UseCollectionsResult {\n  const { limit, fetchIfMissing = false } = opts;\n  const page = usePage();\n  const shop = useShop();\n  const initial = (page?.data?.collections as Collection[] | undefined) ?? null;\n\n  const [collections, setCollections] = useState<Collection[]>(initial ?? []);\n  const [loading, setLoading] = useState<boolean>(\n    initial == null && fetchIfMissing,\n  );\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    if (initial != null) return;\n    if (!fetchIfMissing) return;\n    if (!shop?.id) return;\n    let cancelled = false;\n    (async () => {\n      try {\n        const params = new URLSearchParams({ store_id: shop.id });\n        const res = await fetch(`/api/collections?${params.toString()}`);\n        if (!res.ok) throw new Error(`/api/collections → ${res.status}`);\n        const data = (await res.json()) as { collections?: Collection[] };\n        if (cancelled) return;\n        setCollections(data.collections ?? []);\n        setLoading(false);\n      } catch (err) {\n        if (cancelled) return;\n        setError(err instanceof Error ? err : new Error(String(err)));\n        setLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [initial, fetchIfMissing, shop?.id]);\n\n  const sliced = limit != null ? collections.slice(0, limit) : collections;\n  return { collections: sliced, loading, error };\n}\n"]}