@numueg/theme-sdk 0.1.0

package/dist/normalize.cjs

@@ -0,0 +1,96 @@
+'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
+  };
+}
+
+exports.resolveThemeSettings = resolveThemeSettings;
+//# sourceMappingURL=normalize.cjs.map
+//# sourceMappingURL=normalize.cjs.map

package/dist/normalize.cjs.map

@@ -0,0 +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"]}

package/dist/normalize.d.mts

@@ -0,0 +1,15 @@
+import { T as ThemeSettingsV3 } from './theme-NWJAU9jd.mjs';
+
+/**
+ * Dual-Read normalization: converts V1/V2 legacy payloads to V3 in memory.
+ * Portable — works in both Node.js (SSR) and browser.
+ *
+ * Output must match the backend's `normalize_legacy_to_v3()` byte-for-byte
+ * on the same input. The unit test in __tests__/normalize.test.ts asserts
+ * this. If you change the shape here, update the backend mapper too —
+ * otherwise stores rendered via SDK and stores rendered via SSR will
+ * disagree on what the page contains.
+ */
+declare function resolveThemeSettings(raw: Record<string, unknown> | null | undefined): ThemeSettingsV3;
+
+export { resolveThemeSettings };

package/dist/normalize.d.ts

@@ -0,0 +1,15 @@
+import { T as ThemeSettingsV3 } from './theme-NWJAU9jd.js';
+
+/**
+ * Dual-Read normalization: converts V1/V2 legacy payloads to V3 in memory.
+ * Portable — works in both Node.js (SSR) and browser.
+ *
+ * Output must match the backend's `normalize_legacy_to_v3()` byte-for-byte
+ * on the same input. The unit test in __tests__/normalize.test.ts asserts
+ * this. If you change the shape here, update the backend mapper too —
+ * otherwise stores rendered via SDK and stores rendered via SSR will
+ * disagree on what the page contains.
+ */
+declare function resolveThemeSettings(raw: Record<string, unknown> | null | undefined): ThemeSettingsV3;
+
+export { resolveThemeSettings };

package/dist/normalize.mjs

@@ -0,0 +1,94 @@
+// 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 };
+//# sourceMappingURL=normalize.mjs.map
+//# sourceMappingURL=normalize.mjs.map

package/dist/normalize.mjs.map

@@ -0,0 +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"]}

package/dist/theme-NWJAU9jd.d.mts

@@ -0,0 +1,128 @@
+/** 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;
+}
+interface ExternalThemeMetadata {
+    bundle_url: string;
+    css_url?: string | null;
+    mode?: string;
+    settings_schema?: Record<string, any> | null;
+    section_schemas?: Record<string, any> | null;
+}
+/** 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[];
+}
+/**
+ * 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" | "collection" | "header" | "paragraph" | "html" | "date" | "time" | "video_picker" | "color_scheme" | "page_picker" | "blog_picker" | "link_list_picker" | "variant_picker" | "file_upload";
+/**
+ * `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 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?: {
+        type: string;
+        settings?: Record<string, any>;
+    }[];
+}
+/** 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>;
+}
+
+export type { BlockSchema as B, ExternalThemeMetadata as E, PageTemplate as P, SectionInstance as S, ThemeSettingsV3 as T, BlockProps as a, SectionSchema as b, SectionProps as c, BlockInstance as d, SectionGroup as e, SectionPreset as f, SettingDefinition as g };

package/dist/theme-NWJAU9jd.d.ts

@@ -0,0 +1,128 @@
+/** 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;
+}
+interface ExternalThemeMetadata {
+    bundle_url: string;
+    css_url?: string | null;
+    mode?: string;
+    settings_schema?: Record<string, any> | null;
+    section_schemas?: Record<string, any> | null;
+}
+/** 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[];
+}
+/**
+ * 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" | "collection" | "header" | "paragraph" | "html" | "date" | "time" | "video_picker" | "color_scheme" | "page_picker" | "blog_picker" | "link_list_picker" | "variant_picker" | "file_upload";
+/**
+ * `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 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?: {
+        type: string;
+        settings?: Record<string, any>;
+    }[];
+}
+/** 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>;
+}
+
+export type { BlockSchema as B, ExternalThemeMetadata as E, PageTemplate as P, SectionInstance as S, ThemeSettingsV3 as T, BlockProps as a, SectionSchema as b, SectionProps as c, BlockInstance as d, SectionGroup as e, SectionPreset as f, SettingDefinition as g };

package/dist/types.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.cjs"}

package/dist/types.d.mts

@@ -0,0 +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';

package/dist/types.d.ts

@@ -0,0 +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';

package/dist/types.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=types.mjs.map
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.mjs"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@numueg/theme-sdk",
+  "version": "0.1.0",
+  "description": "NUMU Theme SDK — typed hooks, components, and utilities for building NUMU storefront themes",
+  "keywords": [
+    "numu",
+    "theme",
+    "sdk",
+    "react",
+    "hooks",
+    "storefront",
+    "ecommerce",
+    "byot"
+  ],
+  "license": "MIT",
+  "author": "NUMU <hello@numueg.app>",
+  "homepage": "https://numueg.app/docs/sdk/overview",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NUMU-IO/numu-theme-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/NUMU-IO/numu-theme-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.mjs",
+      "require": "./dist/types.cjs"
+    },
+    "./normalize": {
+      "types": "./dist/normalize.d.ts",
+      "import": "./dist/normalize.mjs",
+      "require": "./dist/normalize.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run build",
+    "pack:dry": "npm pack --dry-run"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.1.0",
+    "@types/react-dom": "^19.1.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0",
+    "vitest": "^4.1.4"
+  }
+}