@numueg/theme-sdk 0.1.2 → 0.2.0

package/dist/normalize.d.mts

@@ -1,4 +1,4 @@
-import { T as ThemeSettingsV3 } from './theme-NWJAU9jd.mjs';
+import { T as ThemeSettingsV3 } from './theme-D0QybTQS.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-NWJAU9jd.js';
+import { T as ThemeSettingsV3 } from './theme-D0QybTQS.js';
 
 /**
  * Dual-Read normalization: converts V1/V2 legacy payloads to V3 in memory.

package/dist/theme-D0QybTQS.d.mts

@@ -0,0 +1,197 @@
+/** V3 Theme Settings — the canonical data shape */
+interface ThemeSettingsV3 {
+    schema_version: 3;
+    theme_id: string;
+    global_settings: Record<string, any>;
+    templates: Record<string, PageTemplate>;
+    section_groups: Record<string, SectionGroup>;
+    external_theme?: ExternalThemeMetadata | null;
+}
+interface PageTemplate {
+    name: string;
+    sections: Record<string, SectionInstance>;
+    order: string[];
+}
+interface SectionGroup {
+    name: string;
+    sections: Record<string, SectionInstance>;
+    order: string[];
+}
+interface SectionInstance {
+    type: string;
+    settings: Record<string, any>;
+    disabled?: boolean;
+    blocks?: Record<string, BlockInstance>;
+    block_order?: string[];
+}
+interface BlockInstance {
+    type: string;
+    settings: Record<string, any>;
+    disabled?: boolean;
+    /** Nested child blocks (blocks-in-blocks): a block can hold its own
+     *  block container — e.g. a footer "column" holding "link" blocks, or
+     *  a mega-menu. Same shape as a section's block container, so the
+     *  render/editor walk is uniform at any depth. Optional + absent on
+     *  leaf blocks, so pre-nesting payloads load unchanged. */
+    blocks?: Record<string, BlockInstance>;
+    block_order?: string[];
+}
+interface ExternalThemeMetadata {
+    bundle_url: string;
+    css_url?: string | null;
+    mode?: string;
+    settings_schema?: Record<string, any> | null;
+    section_schemas?: Record<string, any> | null;
+}
+/**
+ * Live mount handle returned by a V3 theme bundle's `mount(el, ctx)`.
+ *
+ * Two shapes accepted by the host:
+ *
+ *   1. **Legacy** — `mount(el, ctx): () => void`
+ *      The bundle returns only a cleanup function. Every host-side
+ *      themeSettings change forces a full unmount + remount, which is
+ *      expensive but always correct. Hosts must keep supporting this
+ *      for older bundles built against pre-0.2 SDK versions.
+ *
+ *   2. **Wave 3+** — `mount(el, ctx): MountResult`
+ *      The bundle returns an object with `cleanup` + an `applyDraft`
+ *      method that takes a fresh `ThemeSettingsV3` and re-renders the
+ *      bundle's React tree in-place (no createRoot churn). This is the
+ *      fast path used by the customizer's live preview — a keystroke
+ *      in the dashboard becomes a single React reconciliation in the
+ *      iframe, typically < 16 ms.
+ *
+ * Hosts feature-detect by checking `typeof handle === "function"`
+ * (legacy) vs `typeof handle === "object" && handle.cleanup`
+ * (Wave 3+). Theme authors should prefer the MountResult shape — the
+ * `numuTheme` plugin's typings will flag the missing applyDraft once
+ * the editor's live-preview path requires it.
+ */
+interface MountResult {
+    /** Unmount the bundle's React tree and release any resources. */
+    cleanup: () => void;
+    /**
+     * Apply a fresh draft (e.g. from the customizer iframe's
+     * `numu:theme:update` postMessage) without tearing down the tree.
+     * Implementations typically forward the value to a useState setter
+     * inside a wrapper that renders `<NuMuProvider themeSettings={...}>`.
+     *
+     * Safe to call repeatedly; the bundle is expected to dedup
+     * reference-equal calls on its own. Returns nothing — selection /
+     * navigation echo back via postMessage.
+     */
+    applyDraft: (next: ThemeSettingsV3) => void;
+}
+/** Section schema for customizer form generation */
+interface SectionSchema {
+    type: string;
+    name: string;
+    name_ar?: string;
+    tag?: string;
+    class?: string;
+    limit?: number;
+    settings: SettingDefinition[];
+    blocks?: BlockSchema[];
+    max_blocks?: number;
+    presets?: SectionPreset[];
+}
+interface BlockSchema {
+    type: string;
+    name: string;
+    name_ar?: string;
+    limit?: number;
+    settings: SettingDefinition[];
+    /** Child block types this block accepts (recursive). When present,
+     *  the customizer lets merchants add/remove/reorder these inside the
+     *  block, up to `max_blocks`. Enables footer columns, mega-menus,
+     *  multi-column layouts. The host caps practical nesting depth
+     *  (MAX_BLOCK_DEPTH). */
+    blocks?: BlockSchema[];
+    max_blocks?: number;
+}
+/** Max nesting depth the customizer allows for blocks-in-blocks. Depth
+ *  1 = a top-level block in a section; a block at this depth can't take
+ *  children. Generous (below Shopify's 8) and cheap to raise. Kept in
+ *  sync with the merchant hub's MAX_BLOCK_DEPTH. */
+declare const MAX_BLOCK_DEPTH = 5;
+/**
+ * Setting types the V3 customizer renders. Themes can declare any
+ * string here; unknown types fall through to a plain text input. The
+ * union below documents the canonical set so theme authors get
+ * autocomplete and TypeScript errors on typos.
+ */
+type SettingType = "text" | "textarea" | "richtext" | "number" | "range" | "color" | "checkbox" | "select" | "radio" | "font" | "image_picker" | "url" | "product" | "product_list" | "collection" | "collection_list" | "header" | "paragraph" | "html" | "date" | "time" | "video_picker" | "color_scheme" | "page_picker" | "blog_picker" | "link_list_picker" | "variant_picker" | "file_upload" | "icon_picker" | "icon";
+/**
+ * `visible_if` — conditional visibility expression evaluated against
+ * sibling settings in the same schema. Two flavors:
+ *
+ *   - String DSL: `"settings.show_button == true && settings.layout != 'minimal'"`
+ *   - Object form: `{ show_button: true, layout: ["full", "split"] }`
+ *
+ * Evaluator lives in the merchant hub: any setting whose expression is
+ * falsy is skipped from the rendered form.
+ */
+type VisibleIf = string | Record<string, unknown>;
+interface SettingDefinition {
+    type: SettingType | (string & {});
+    id: string;
+    label: string;
+    label_ar?: string;
+    default?: any;
+    info?: string;
+    info_ar?: string;
+    placeholder?: string;
+    options?: {
+        value: string;
+        label: string;
+        label_ar?: string;
+    }[];
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+    /** Hide this setting unless the expression evaluates truthy. */
+    visible_if?: VisibleIf;
+}
+interface PresetBlock {
+    type: string;
+    settings?: Record<string, any>;
+    /** Nested starter blocks materialized when the preset is applied
+     *  (recursive). Lets a preset ship, e.g., a footer column already
+     *  populated with link blocks. */
+    blocks?: PresetBlock[];
+}
+interface SectionPreset {
+    name: string;
+    /** Localized names so the Add Section dialog reads in the editor's
+     * current locale. Falls back to `name` when the locale is missing. */
+    locales?: {
+        en?: {
+            name?: string;
+        };
+        ar?: {
+            name?: string;
+        };
+    };
+    settings?: Record<string, any>;
+    blocks?: PresetBlock[];
+}
+/** Section component props */
+interface SectionProps {
+    settings: Record<string, any>;
+    blocks?: Record<string, BlockInstance>;
+    blockOrder?: string[];
+    storeData?: any;
+}
+/** Block component props */
+interface BlockProps {
+    settings: Record<string, any>;
+    /** Child block instances when this block nests others (footer column,
+     *  mega-menu, …). Mirror the section→block render: map `blockOrder`
+     *  and look each id up in `blocks`, wrapping each child in `<Block>`. */
+    blocks?: Record<string, BlockInstance>;
+    blockOrder?: string[];
+}
+
+export { type BlockInstance as B, type ExternalThemeMetadata as E, type MountResult as M, type PageTemplate as P, type SectionGroup as S, type ThemeSettingsV3 as T, type BlockProps as a, type BlockSchema as b, type SectionInstance as c, type SectionPreset as d, type SectionProps as e, type SectionSchema as f, type SettingDefinition as g, MAX_BLOCK_DEPTH as h, type PresetBlock as i };

package/dist/theme-D0QybTQS.d.ts

@@ -0,0 +1,197 @@
+/** V3 Theme Settings — the canonical data shape */
+interface ThemeSettingsV3 {
+    schema_version: 3;
+    theme_id: string;
+    global_settings: Record<string, any>;
+    templates: Record<string, PageTemplate>;
+    section_groups: Record<string, SectionGroup>;
+    external_theme?: ExternalThemeMetadata | null;
+}
+interface PageTemplate {
+    name: string;
+    sections: Record<string, SectionInstance>;
+    order: string[];
+}
+interface SectionGroup {
+    name: string;
+    sections: Record<string, SectionInstance>;
+    order: string[];
+}
+interface SectionInstance {
+    type: string;
+    settings: Record<string, any>;
+    disabled?: boolean;
+    blocks?: Record<string, BlockInstance>;
+    block_order?: string[];
+}
+interface BlockInstance {
+    type: string;
+    settings: Record<string, any>;
+    disabled?: boolean;
+    /** Nested child blocks (blocks-in-blocks): a block can hold its own
+     *  block container — e.g. a footer "column" holding "link" blocks, or
+     *  a mega-menu. Same shape as a section's block container, so the
+     *  render/editor walk is uniform at any depth. Optional + absent on
+     *  leaf blocks, so pre-nesting payloads load unchanged. */
+    blocks?: Record<string, BlockInstance>;
+    block_order?: string[];
+}
+interface ExternalThemeMetadata {
+    bundle_url: string;
+    css_url?: string | null;
+    mode?: string;
+    settings_schema?: Record<string, any> | null;
+    section_schemas?: Record<string, any> | null;
+}
+/**
+ * Live mount handle returned by a V3 theme bundle's `mount(el, ctx)`.
+ *
+ * Two shapes accepted by the host:
+ *
+ *   1. **Legacy** — `mount(el, ctx): () => void`
+ *      The bundle returns only a cleanup function. Every host-side
+ *      themeSettings change forces a full unmount + remount, which is
+ *      expensive but always correct. Hosts must keep supporting this
+ *      for older bundles built against pre-0.2 SDK versions.
+ *
+ *   2. **Wave 3+** — `mount(el, ctx): MountResult`
+ *      The bundle returns an object with `cleanup` + an `applyDraft`
+ *      method that takes a fresh `ThemeSettingsV3` and re-renders the
+ *      bundle's React tree in-place (no createRoot churn). This is the
+ *      fast path used by the customizer's live preview — a keystroke
+ *      in the dashboard becomes a single React reconciliation in the
+ *      iframe, typically < 16 ms.
+ *
+ * Hosts feature-detect by checking `typeof handle === "function"`
+ * (legacy) vs `typeof handle === "object" && handle.cleanup`
+ * (Wave 3+). Theme authors should prefer the MountResult shape — the
+ * `numuTheme` plugin's typings will flag the missing applyDraft once
+ * the editor's live-preview path requires it.
+ */
+interface MountResult {
+    /** Unmount the bundle's React tree and release any resources. */
+    cleanup: () => void;
+    /**
+     * Apply a fresh draft (e.g. from the customizer iframe's
+     * `numu:theme:update` postMessage) without tearing down the tree.
+     * Implementations typically forward the value to a useState setter
+     * inside a wrapper that renders `<NuMuProvider themeSettings={...}>`.
+     *
+     * Safe to call repeatedly; the bundle is expected to dedup
+     * reference-equal calls on its own. Returns nothing — selection /
+     * navigation echo back via postMessage.
+     */
+    applyDraft: (next: ThemeSettingsV3) => void;
+}
+/** Section schema for customizer form generation */
+interface SectionSchema {
+    type: string;
+    name: string;
+    name_ar?: string;
+    tag?: string;
+    class?: string;
+    limit?: number;
+    settings: SettingDefinition[];
+    blocks?: BlockSchema[];
+    max_blocks?: number;
+    presets?: SectionPreset[];
+}
+interface BlockSchema {
+    type: string;
+    name: string;
+    name_ar?: string;
+    limit?: number;
+    settings: SettingDefinition[];
+    /** Child block types this block accepts (recursive). When present,
+     *  the customizer lets merchants add/remove/reorder these inside the
+     *  block, up to `max_blocks`. Enables footer columns, mega-menus,
+     *  multi-column layouts. The host caps practical nesting depth
+     *  (MAX_BLOCK_DEPTH). */
+    blocks?: BlockSchema[];
+    max_blocks?: number;
+}
+/** Max nesting depth the customizer allows for blocks-in-blocks. Depth
+ *  1 = a top-level block in a section; a block at this depth can't take
+ *  children. Generous (below Shopify's 8) and cheap to raise. Kept in
+ *  sync with the merchant hub's MAX_BLOCK_DEPTH. */
+declare const MAX_BLOCK_DEPTH = 5;
+/**
+ * Setting types the V3 customizer renders. Themes can declare any
+ * string here; unknown types fall through to a plain text input. The
+ * union below documents the canonical set so theme authors get
+ * autocomplete and TypeScript errors on typos.
+ */
+type SettingType = "text" | "textarea" | "richtext" | "number" | "range" | "color" | "checkbox" | "select" | "radio" | "font" | "image_picker" | "url" | "product" | "product_list" | "collection" | "collection_list" | "header" | "paragraph" | "html" | "date" | "time" | "video_picker" | "color_scheme" | "page_picker" | "blog_picker" | "link_list_picker" | "variant_picker" | "file_upload" | "icon_picker" | "icon";
+/**
+ * `visible_if` — conditional visibility expression evaluated against
+ * sibling settings in the same schema. Two flavors:
+ *
+ *   - String DSL: `"settings.show_button == true && settings.layout != 'minimal'"`
+ *   - Object form: `{ show_button: true, layout: ["full", "split"] }`
+ *
+ * Evaluator lives in the merchant hub: any setting whose expression is
+ * falsy is skipped from the rendered form.
+ */
+type VisibleIf = string | Record<string, unknown>;
+interface SettingDefinition {
+    type: SettingType | (string & {});
+    id: string;
+    label: string;
+    label_ar?: string;
+    default?: any;
+    info?: string;
+    info_ar?: string;
+    placeholder?: string;
+    options?: {
+        value: string;
+        label: string;
+        label_ar?: string;
+    }[];
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+    /** Hide this setting unless the expression evaluates truthy. */
+    visible_if?: VisibleIf;
+}
+interface PresetBlock {
+    type: string;
+    settings?: Record<string, any>;
+    /** Nested starter blocks materialized when the preset is applied
+     *  (recursive). Lets a preset ship, e.g., a footer column already
+     *  populated with link blocks. */
+    blocks?: PresetBlock[];
+}
+interface SectionPreset {
+    name: string;
+    /** Localized names so the Add Section dialog reads in the editor's
+     * current locale. Falls back to `name` when the locale is missing. */
+    locales?: {
+        en?: {
+            name?: string;
+        };
+        ar?: {
+            name?: string;
+        };
+    };
+    settings?: Record<string, any>;
+    blocks?: PresetBlock[];
+}
+/** Section component props */
+interface SectionProps {
+    settings: Record<string, any>;
+    blocks?: Record<string, BlockInstance>;
+    blockOrder?: string[];
+    storeData?: any;
+}
+/** Block component props */
+interface BlockProps {
+    settings: Record<string, any>;
+    /** Child block instances when this block nests others (footer column,
+     *  mega-menu, …). Mirror the section→block render: map `blockOrder`
+     *  and look each id up in `blocks`, wrapping each child in `<Block>`. */
+    blocks?: Record<string, BlockInstance>;
+    blockOrder?: string[];
+}
+
+export { type BlockInstance as B, type ExternalThemeMetadata as E, type MountResult as M, type PageTemplate as P, type SectionGroup as S, type ThemeSettingsV3 as T, type BlockProps as a, type BlockSchema as b, type SectionInstance as c, type SectionPreset as d, type SectionProps as e, type SectionSchema as f, type SettingDefinition as g, MAX_BLOCK_DEPTH as h, type PresetBlock as i };

package/dist/types.d.mts

@@ -1,2 +1,2 @@
-export { A as Address, a as Cart, e as CartItem, C as Collection, b as Customer, O as Order, f as OrderItem, c as Page, P as Product, g as ProductImage, d as ProductVariant, S as Store } from './index-zSb0FIyh.mjs';
-export { d as BlockInstance, a as BlockProps, B as BlockSchema, E as ExternalThemeMetadata, P as PageTemplate, e as SectionGroup, S as SectionInstance, f as SectionPreset, c as SectionProps, b as SectionSchema, g as SettingDefinition, T as ThemeSettingsV3 } from './theme-NWJAU9jd.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 Store } from './entities-iiuRSPpk.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-D0QybTQS.mjs';

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-export { A as Address, a as Cart, e as CartItem, C as Collection, b as Customer, O as Order, f as OrderItem, c as Page, P as Product, g as ProductImage, d as ProductVariant, S as Store } from './index-CGx6FNqb.js';
-export { d as BlockInstance, a as BlockProps, B as BlockSchema, E as ExternalThemeMetadata, P as PageTemplate, e as SectionGroup, S as SectionInstance, f as SectionPreset, c as SectionProps, b as SectionSchema, g as SettingDefinition, T as ThemeSettingsV3 } from './theme-NWJAU9jd.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 Store } from './entities-iiuRSPpk.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-D0QybTQS.js';

package/dist/v2-compat.cjs

@@ -0,0 +1,248 @@
+'use strict';
+
+var react = require('react');
+
+var ShopContext = react.createContext(null);
+react.createContext(null);
+react.createContext(null);
+react.createContext(null);
+var CustomerContext = react.createContext(null);
+var ThemeSettingsContext = react.createContext(null);
+var LocalizationContext = react.createContext(null);
+var PageContext = react.createContext(null);
+react.createContext("home");
+react.createContext(
+  {}
+);
+
+// src/hooks/usePage.ts
+function usePage() {
+  return react.useContext(PageContext);
+}
+function useLocalization() {
+  const ctx = react.useContext(LocalizationContext);
+  if (!ctx) throw new Error("useLocalization must be used within NuMuProvider");
+  return ctx;
+}
+function useLocale() {
+  const { locale } = useLocalization();
+  return locale;
+}
+
+// src/hooks/useShop.ts
+var DEFAULT_PROTOCOL = typeof window !== "undefined" ? window.location.protocol.replace(":", "") : "https";
+function resolveDomain(store) {
+  if (store.domain) return store.domain;
+  if (store.subdomain) {
+    const platform = typeof window !== "undefined" && window.__NUMU_PLATFORM_DOMAIN || "numueg.app";
+    return `${store.subdomain}.${platform}`;
+  }
+  return store.slug;
+}
+function useShop() {
+  const ctx = react.useContext(ShopContext);
+  if (!ctx) throw new Error("useShop must be used within NuMuProvider");
+  const locale = useLocale();
+  return react.useMemo(() => {
+    const domain = resolveDomain(ctx);
+    const settings = ctx.settings;
+    const localePrefixEnabled = Boolean(
+      settings && settings.locale_url_prefix_enabled
+    );
+    const defaultLocale = ctx.default_language || "en";
+    const prefixedLocales = settings?.locale_url_prefix_locales || null;
+    const shouldPrefix = (l) => {
+      if (!localePrefixEnabled) return false;
+      if (prefixedLocales) return prefixedLocales.includes(l);
+      return l !== defaultLocale;
+    };
+    const formatUrl = (path) => {
+      if (!path) return `${DEFAULT_PROTOCOL}://${domain}/`;
+      if (/^https?:\/\//i.test(path)) return path;
+      if (path.startsWith("//")) return `${DEFAULT_PROTOCOL}:${path}`;
+      let normalized = path.startsWith("/") ? path : `/${path}`;
+      if (locale && shouldPrefix(locale)) {
+        const prefix = `/${locale}/`;
+        const root = `/${locale}`;
+        if (normalized !== root && !normalized.startsWith(prefix)) {
+          normalized = `${root}${normalized}`;
+        }
+      }
+      return `${DEFAULT_PROTOCOL}://${domain}${normalized}`;
+    };
+    return { ...ctx, domain, formatUrl };
+  }, [ctx, locale]);
+}
+
+// src/hooks/useProducts.ts
+function useProducts(opts = {}) {
+  const { limit, fetchIfMissing = false } = opts;
+  const page = usePage();
+  const shop = useShop();
+  const initial = page?.data?.products ?? null;
+  const [products, setProducts] = react.useState(initial ?? []);
+  const [loading, setLoading] = react.useState(
+    initial == null && fetchIfMissing
+  );
+  const [error, setError] = react.useState(null);
+  react.useEffect(() => {
+    if (initial != null) return;
+    if (!fetchIfMissing) return;
+    if (!shop?.id) return;
+    let cancelled = false;
+    (async () => {
+      try {
+        const params = new URLSearchParams({ store_id: shop.id });
+        if (limit) params.set("limit", String(limit));
+        const res = await fetch(`/api/products?${params.toString()}`);
+        if (!res.ok) throw new Error(`/api/products \u2192 ${res.status}`);
+        const data = await res.json();
+        if (cancelled) return;
+        setProducts(data.products ?? []);
+        setLoading(false);
+      } catch (err) {
+        if (cancelled) return;
+        setError(err instanceof Error ? err : new Error(String(err)));
+        setLoading(false);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [initial, fetchIfMissing, limit, shop?.id]);
+  const sliced = limit != null ? products.slice(0, limit) : products;
+  return { products: sliced, loading, error };
+}
+function useCollections(opts = {}) {
+  const { limit, fetchIfMissing = false } = opts;
+  const page = usePage();
+  const shop = useShop();
+  const initial = page?.data?.collections ?? null;
+  const [collections, setCollections] = react.useState(initial ?? []);
+  const [loading, setLoading] = react.useState(
+    initial == null && fetchIfMissing
+  );
+  const [error, setError] = react.useState(null);
+  react.useEffect(() => {
+    if (initial != null) return;
+    if (!fetchIfMissing) return;
+    if (!shop?.id) return;
+    let cancelled = false;
+    (async () => {
+      try {
+        const params = new URLSearchParams({ store_id: shop.id });
+        const res = await fetch(`/api/collections?${params.toString()}`);
+        if (!res.ok) throw new Error(`/api/collections \u2192 ${res.status}`);
+        const data = await res.json();
+        if (cancelled) return;
+        setCollections(data.collections ?? []);
+        setLoading(false);
+      } catch (err) {
+        if (cancelled) return;
+        setError(err instanceof Error ? err : new Error(String(err)));
+        setLoading(false);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [initial, fetchIfMissing, shop?.id]);
+  const sliced = limit != null ? collections.slice(0, limit) : collections;
+  return { collections: sliced, loading, error };
+}
+function useCustomer() {
+  return react.useContext(CustomerContext);
+}
+function useThemeSettings() {
+  const ctx = react.useContext(ThemeSettingsContext);
+  if (!ctx) throw new Error("useThemeSettings must be used within NuMuProvider");
+  return ctx;
+}
+
+// src/v2-compat.ts
+function useV2Products() {
+  const { products, loading } = useProducts();
+  return react.useMemo(
+    () => ({
+      products,
+      loading
+    }),
+    [products, loading]
+  );
+}
+function collectionToV2Category(c) {
+  return {
+    id: c.id,
+    name: c.name,
+    slug: c.slug,
+    image_url: c.image_url ?? null,
+    description: c.description ?? null
+  };
+}
+function useV2Categories() {
+  const { collections, loading } = useCollections();
+  return react.useMemo(
+    () => ({
+      categories: collections.map(collectionToV2Category),
+      loading
+    }),
+    [collections, loading]
+  );
+}
+function useV2Auth() {
+  const customer = useCustomer();
+  return react.useMemo(
+    () => ({
+      user: customer,
+      isAuthenticated: customer !== null
+    }),
+    [customer]
+  );
+}
+function useV2Language() {
+  const { locale, direction, translations, setLocale } = useLocalization();
+  const normalisedLocale = locale === "ar" ? "ar" : "en";
+  return react.useMemo(
+    () => ({
+      language: normalisedLocale,
+      direction,
+      setLanguage: (next) => setLocale(next),
+      t: (key, fallback) => translations[key] ?? fallback ?? key
+    }),
+    [normalisedLocale, direction, translations, setLocale]
+  );
+}
+function useV2Theme() {
+  const settings = useThemeSettings();
+  return react.useMemo(() => {
+    const g = settings.global_settings ?? {};
+    const get = (key) => {
+      const v = g[key];
+      return typeof v === "string" ? v : void 0;
+    };
+    return {
+      themeSettings: {
+        theme: {
+          primary_color: get("primary_color"),
+          accent_color: get("accent_color"),
+          background_color: get("background_color"),
+          text_color: get("text_color"),
+          heading_font: get("heading_font"),
+          ...g
+        },
+        identity: {
+          logo_url: get("logo_url"),
+          store_name: get("store_name")
+        }
+      }
+    };
+  }, [settings]);
+}
+
+exports.useV2Auth = useV2Auth;
+exports.useV2Categories = useV2Categories;
+exports.useV2Language = useV2Language;
+exports.useV2Products = useV2Products;
+exports.useV2Theme = useV2Theme;
+//# sourceMappingURL=v2-compat.cjs.map
+//# sourceMappingURL=v2-compat.cjs.map