@zappie/sdk 0.1.0 → 0.1.2

package/dist/site-config/sections.js

@@ -0,0 +1,105 @@
+// src/site-config/sections.ts
+import { record, unknownKeys } from "./helpers.js";
+import { DEFAULT_BUDGETS } from "./types.js";
+function nested(value, path, keys, issue, validate) {
+  if (value === void 0) {
+    return;
+  }
+  if (!record(value)) {
+    issue({
+      path,
+      code: "invalid_type",
+      message: `Expected an object. Set ${path} to an object or remove it.`,
+      severity: "error"
+    });
+    return;
+  }
+  unknownKeys(value, keys, path, issue);
+  validate(value);
+}
+function budgets(value, issue, error) {
+  nested(
+    value,
+    "budgets",
+    ["jsKbGz", "cssKbGz", "lcpMs", "override"],
+    issue,
+    (budget) => {
+      nested(
+        budget.override,
+        "budgets.override",
+        ["reason"],
+        issue,
+        (override) => {
+          if (typeof override.reason !== "string" || !override.reason.trim()) {
+            error(
+              "budgets.override.reason",
+              "invalid_format",
+              "Expected a non-blank reason. Explain why the default budget must be raised."
+            );
+          }
+        }
+      );
+      for (const key of ["jsKbGz", "cssKbGz", "lcpMs"]) {
+        const amount = budget[key];
+        if (amount === void 0) {
+          continue;
+        }
+        if (typeof amount !== "number" || !Number.isFinite(amount) || amount <= 0) {
+          error(
+            `budgets.${key}`,
+            "invalid_type",
+            `Expected a positive finite number. Set budgets.${key} to a number greater than zero.`
+          );
+        } else if (amount > DEFAULT_BUDGETS[key]) {
+          const message = `The ${key} budget exceeds the ${DEFAULT_BUDGETS[key]} default.`;
+          if (budget.override === void 0) {
+            error(
+              `budgets.${key}`,
+              "budget_override",
+              `${message} Add budgets.override.reason to explain the increase.`
+            );
+          } else {
+            issue({
+              path: `budgets.${key}`,
+              code: "budget_override",
+              message: `${message} Lower it to the default when the exception is no longer needed.`,
+              severity: "warning"
+            });
+          }
+        }
+      }
+    }
+  );
+}
+function analytics(value, issue, error) {
+  nested(value, "analytics", ["forward"], issue, (analyticsValue) => {
+    nested(
+      analyticsValue.forward,
+      "analytics.forward",
+      ["ga4", "metaPixel"],
+      issue,
+      (forward) => {
+        if (forward.ga4 !== void 0 && (typeof forward.ga4 !== "string" || !/^G-[A-Z0-9]+$/.test(forward.ga4))) {
+          error(
+            "analytics.forward.ga4",
+            "invalid_format",
+            "Expected a GA4 measurement id beginning with G-. Use a value such as G-XXXXXXXXXX."
+          );
+        }
+        if (forward.metaPixel !== void 0 && (typeof forward.metaPixel !== "string" || !/^\d+$/.test(forward.metaPixel))) {
+          error(
+            "analytics.forward.metaPixel",
+            "invalid_format",
+            "Expected a numeric Meta Pixel id. Use digits only."
+          );
+        }
+      }
+    );
+  });
+}
+export {
+  analytics,
+  budgets,
+  nested
+};
+//# sourceMappingURL=sections.js.map

package/dist/site-config/sections.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/site-config/sections.ts"],
+  "sourcesContent": ["import { record, unknownKeys } from \"./helpers\";\nimport { DEFAULT_BUDGETS, type ConfigIssue } from \"./types\";\n\ntype AddIssue = (value: ConfigIssue) => void;\ntype AddError = (\n  path: string,\n  code: ConfigIssue[\"code\"],\n  message: string,\n) => void;\n\nexport function nested(\n  value: unknown,\n  path: string,\n  keys: readonly string[],\n  issue: AddIssue,\n  validate: (value: Record<string, unknown>) => void,\n) {\n  if (value === undefined) {\n    return;\n  }\n  if (!record(value)) {\n    issue({\n      path,\n      code: \"invalid_type\",\n      message: `Expected an object. Set ${path} to an object or remove it.`,\n      severity: \"error\",\n    });\n    return;\n  }\n  unknownKeys(value, keys, path, issue);\n  validate(value);\n}\n\nexport function budgets(value: unknown, issue: AddIssue, error: AddError) {\n  nested(\n    value,\n    \"budgets\",\n    [\"jsKbGz\", \"cssKbGz\", \"lcpMs\", \"override\"],\n    issue,\n    (budget) => {\n      nested(\n        budget.override,\n        \"budgets.override\",\n        [\"reason\"],\n        issue,\n        (override) => {\n          if (typeof override.reason !== \"string\" || !override.reason.trim()) {\n            error(\n              \"budgets.override.reason\",\n              \"invalid_format\",\n              \"Expected a non-blank reason. Explain why the default budget must be raised.\",\n            );\n          }\n        },\n      );\n      for (const key of [\"jsKbGz\", \"cssKbGz\", \"lcpMs\"] as const) {\n        const amount = budget[key];\n        if (amount === undefined) {\n          continue;\n        }\n        if (\n          typeof amount !== \"number\" ||\n          !Number.isFinite(amount) ||\n          amount <= 0\n        ) {\n          error(\n            `budgets.${key}`,\n            \"invalid_type\",\n            `Expected a positive finite number. Set budgets.${key} to a number greater than zero.`,\n          );\n        } else if (amount > DEFAULT_BUDGETS[key]) {\n          const message = `The ${key} budget exceeds the ${DEFAULT_BUDGETS[key]} default.`;\n          if (budget.override === undefined) {\n            error(\n              `budgets.${key}`,\n              \"budget_override\",\n              `${message} Add budgets.override.reason to explain the increase.`,\n            );\n          } else {\n            issue({\n              path: `budgets.${key}`,\n              code: \"budget_override\",\n              message: `${message} Lower it to the default when the exception is no longer needed.`,\n              severity: \"warning\",\n            });\n          }\n        }\n      }\n    },\n  );\n}\n\nexport function analytics(value: unknown, issue: AddIssue, error: AddError) {\n  nested(value, \"analytics\", [\"forward\"], issue, (analyticsValue) => {\n    nested(\n      analyticsValue.forward,\n      \"analytics.forward\",\n      [\"ga4\", \"metaPixel\"],\n      issue,\n      (forward) => {\n        if (\n          forward.ga4 !== undefined &&\n          (typeof forward.ga4 !== \"string\" ||\n            !/^G-[A-Z0-9]+$/.test(forward.ga4))\n        ) {\n          error(\n            \"analytics.forward.ga4\",\n            \"invalid_format\",\n            \"Expected a GA4 measurement id beginning with G-. Use a value such as G-XXXXXXXXXX.\",\n          );\n        }\n        if (\n          forward.metaPixel !== undefined &&\n          (typeof forward.metaPixel !== \"string\" ||\n            !/^\\d+$/.test(forward.metaPixel))\n        ) {\n          error(\n            \"analytics.forward.metaPixel\",\n            \"invalid_format\",\n            \"Expected a numeric Meta Pixel id. Use digits only.\",\n          );\n        }\n      },\n    );\n  });\n}\n"],
+  "mappings": ";AAAA,SAAS,QAAQ,mBAAmB;AACpC,SAAS,uBAAyC;AAS3C,SAAS,OACd,OACA,MACA,MACA,OACA,UACA;AACA,MAAI,UAAU,QAAW;AACvB;AAAA,EACF;AACA,MAAI,CAAC,OAAO,KAAK,GAAG;AAClB,UAAM;AAAA,MACJ;AAAA,MACA,MAAM;AAAA,MACN,SAAS,2BAA2B,IAAI;AAAA,MACxC,UAAU;AAAA,IACZ,CAAC;AACD;AAAA,EACF;AACA,cAAY,OAAO,MAAM,MAAM,KAAK;AACpC,WAAS,KAAK;AAChB;AAEO,SAAS,QAAQ,OAAgB,OAAiB,OAAiB;AACxE;AAAA,IACE;AAAA,IACA;AAAA,IACA,CAAC,UAAU,WAAW,SAAS,UAAU;AAAA,IACzC;AAAA,IACA,CAAC,WAAW;AACV;AAAA,QACE,OAAO;AAAA,QACP;AAAA,QACA,CAAC,QAAQ;AAAA,QACT;AAAA,QACA,CAAC,aAAa;AACZ,cAAI,OAAO,SAAS,WAAW,YAAY,CAAC,SAAS,OAAO,KAAK,GAAG;AAClE;AAAA,cACE;AAAA,cACA;AAAA,cACA;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AACA,iBAAW,OAAO,CAAC,UAAU,WAAW,OAAO,GAAY;AACzD,cAAM,SAAS,OAAO,GAAG;AACzB,YAAI,WAAW,QAAW;AACxB;AAAA,QACF;AACA,YACE,OAAO,WAAW,YAClB,CAAC,OAAO,SAAS,MAAM,KACvB,UAAU,GACV;AACA;AAAA,YACE,WAAW,GAAG;AAAA,YACd;AAAA,YACA,kDAAkD,GAAG;AAAA,UACvD;AAAA,QACF,WAAW,SAAS,gBAAgB,GAAG,GAAG;AACxC,gBAAM,UAAU,OAAO,GAAG,uBAAuB,gBAAgB,GAAG,CAAC;AACrE,cAAI,OAAO,aAAa,QAAW;AACjC;AAAA,cACE,WAAW,GAAG;AAAA,cACd;AAAA,cACA,GAAG,OAAO;AAAA,YACZ;AAAA,UACF,OAAO;AACL,kBAAM;AAAA,cACJ,MAAM,WAAW,GAAG;AAAA,cACpB,MAAM;AAAA,cACN,SAAS,GAAG,OAAO;AAAA,cACnB,UAAU;AAAA,YACZ,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,UAAU,OAAgB,OAAiB,OAAiB;AAC1E,SAAO,OAAO,aAAa,CAAC,SAAS,GAAG,OAAO,CAAC,mBAAmB;AACjE;AAAA,MACE,eAAe;AAAA,MACf;AAAA,MACA,CAAC,OAAO,WAAW;AAAA,MACnB;AAAA,MACA,CAAC,YAAY;AACX,YACE,QAAQ,QAAQ,WACf,OAAO,QAAQ,QAAQ,YACtB,CAAC,gBAAgB,KAAK,QAAQ,GAAG,IACnC;AACA;AAAA,YACE;AAAA,YACA;AAAA,YACA;AAAA,UACF;AAAA,QACF;AACA,YACE,QAAQ,cAAc,WACrB,OAAO,QAAQ,cAAc,YAC5B,CAAC,QAAQ,KAAK,QAAQ,SAAS,IACjC;AACA;AAAA,YACE;AAAA,YACA;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/dist/site-config/types.js

@@ -0,0 +1,31 @@
+// src/site-config/types.ts
+var DEFAULT_BUDGETS = {
+  jsKbGz: 200,
+  cssKbGz: 50,
+  lcpMs: 2500
+};
+var GLOBAL_PACKAGE_ALLOWLIST = [
+  "react",
+  "react-dom",
+  "react-router",
+  "@react-router/*",
+  "@zappie/*",
+  "tailwindcss",
+  "@tailwindcss/*",
+  "clsx",
+  "tailwind-merge",
+  "class-variance-authority",
+  "lucide-react",
+  "date-fns",
+  "embla-carousel-react",
+  "framer-motion/motion",
+  "zod",
+  "@radix-ui/*",
+  "sonner",
+  "vaul"
+];
+export {
+  DEFAULT_BUDGETS,
+  GLOBAL_PACKAGE_ALLOWLIST
+};
+//# sourceMappingURL=types.js.map

package/dist/site-config/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/site-config/types.ts"],
+  "sourcesContent": ["/**\n * Default site budgets: 200 KB gzipped JavaScript, 50 KB gzipped CSS and 2500 ms LCP.\n */\nexport const DEFAULT_BUDGETS = {\n  jsKbGz: 200,\n  cssKbGz: 50,\n  lcpMs: 2500,\n} as const;\n\n/**\n * Package names and patterns allowed globally without a site-specific allowlist entry.\n */\nexport const GLOBAL_PACKAGE_ALLOWLIST = [\n  \"react\",\n  \"react-dom\",\n  \"react-router\",\n  \"@react-router/*\",\n  \"@zappie/*\",\n  \"tailwindcss\",\n  \"@tailwindcss/*\",\n  \"clsx\",\n  \"tailwind-merge\",\n  \"class-variance-authority\",\n  \"lucide-react\",\n  \"date-fns\",\n  \"embla-carousel-react\",\n  \"framer-motion/motion\",\n  \"zod\",\n  \"@radix-ui/*\",\n  \"sonner\",\n  \"vaul\",\n] as const;\n\n/**\n * The store, theme and optional build policies you export from zappie.config.ts.\n */\nexport type ZappieSiteConfig = {\n  store: string;\n  branches?: string[];\n  theme: string;\n  prerender?: string[];\n  menu?: { hiddenCategories?: string[] };\n  packages?: { allow?: string[] };\n  outbound?: { allow?: string[] };\n  /** Each budget left out uses DEFAULT_BUDGETS. */\n  budgets?: {\n    jsKbGz?: number;\n    cssKbGz?: number;\n    lcpMs?: number;\n    override?: { reason: string };\n  };\n  analytics?: { forward?: { ga4?: string; metaPixel?: string } };\n};\n\n/**\n * A configuration diagnostic with its field path, stable code, message and severity.\n */\nexport type ConfigIssue = {\n  path: string;\n  code:\n    | \"invalid_type\"\n    | \"missing_required\"\n    | \"unknown_key\"\n    | \"invalid_format\"\n    | \"duplicate\"\n    | \"redundant_allowlist\"\n    | \"budget_override\";\n  message: string;\n  severity: \"error\" | \"warning\";\n};\n\n/**\n * Configuration validation results. Warnings alone do not make valid false.\n */\nexport type ConfigValidation = { valid: boolean; issues: ConfigIssue[] };\n"],
+  "mappings": ";AAGO,IAAM,kBAAkB;AAAA,EAC7B,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,OAAO;AACT;AAKO,IAAM,2BAA2B;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;",
+  "names": []
+}

package/dist/site-config/validate.js

@@ -0,0 +1,165 @@
+// src/site-config/validate.ts
+import {
+  globallyAllowed,
+  hostname,
+  nonblank,
+  packageName,
+  record,
+  unknownKeys
+} from "./helpers.js";
+import { analytics, budgets, nested } from "./sections.js";
+var rootKeys = [
+  "store",
+  "branches",
+  "theme",
+  "prerender",
+  "menu",
+  "packages",
+  "outbound",
+  "budgets",
+  "analytics"
+];
+function validateConfig(input) {
+  const issues = [];
+  const issue = (value) => issues.push(value);
+  const error = (path, code, message) => issue({ path, code, message, severity: "error" });
+  if (!record(input)) {
+    return {
+      valid: false,
+      issues: [
+        {
+          path: "$",
+          code: "invalid_type",
+          message: "Expected a configuration object. Export an object from zappie.config.ts.",
+          severity: "error"
+        }
+      ]
+    };
+  }
+  unknownKeys(input, rootKeys, "", issue);
+  requiredSlug(input.store, "store", error);
+  theme(input.theme, error);
+  stringList(input.branches, "branches", error, {
+    nonempty: true,
+    unique: true,
+    slug: true
+  });
+  paths(input.prerender, error);
+  nested(input.menu, "menu", ["hiddenCategories"], issue, (value) => {
+    stringList(value.hiddenCategories, "menu.hiddenCategories", error);
+  });
+  nested(input.packages, "packages", ["allow"], issue, (value) => {
+    const allow = stringList(value.allow, "packages.allow", error);
+    allow?.forEach((name, index) => {
+      if (globallyAllowed(name)) {
+        issue({
+          path: `packages.allow[${index}]`,
+          code: "redundant_allowlist",
+          message: `${name} is already globally allowed. Remove it from packages.allow.`,
+          severity: "warning"
+        });
+      } else if (!packageName(name)) {
+        error(
+          `packages.allow[${index}]`,
+          "invalid_format",
+          "Expected a lowercase npm package name. Use a package name such as lucide-react or @scope/name."
+        );
+      }
+    });
+  });
+  nested(input.outbound, "outbound", ["allow"], issue, (value) => {
+    const allow = stringList(value.allow, "outbound.allow", error);
+    allow?.forEach((host, index) => {
+      if (!hostname(host)) {
+        error(
+          `outbound.allow[${index}]`,
+          "invalid_format",
+          "Expected a hostname or leading *. subdomain pattern without a scheme, path, port or IP. Use a value such as api.example.com."
+        );
+      }
+    });
+  });
+  budgets(input.budgets, issue, error);
+  analytics(input.analytics, issue, error);
+  return {
+    valid: !issues.some((entry) => entry.severity === "error"),
+    issues
+  };
+}
+function requiredSlug(value, path, error) {
+  if (!nonblank(value)) {
+    error(
+      path,
+      value === void 0 ? "missing_required" : "invalid_type",
+      `Expected a non-empty storefront slug. Set ${path} to the slug used by createZappie().`
+    );
+  }
+}
+function theme(value, error) {
+  if (typeof value !== "string") {
+    error(
+      "theme",
+      value === void 0 ? "missing_required" : "invalid_type",
+      "Expected a relative .json path. Set theme to a value such as ./theme.json."
+    );
+  } else if (!/\.json$/.test(value) || /^(?:[a-z][a-z\d+.-]*:|\/|\\)/i.test(value) || value.includes("\\")) {
+    error(
+      "theme",
+      "invalid_format",
+      "Expected a relative .json path. Use a value such as ./theme.json."
+    );
+  }
+}
+function stringList(value, path, error, options = {}) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string")) {
+    error(
+      path,
+      "invalid_type",
+      `Expected an array of strings. Set ${path} to string values.`
+    );
+    return void 0;
+  }
+  if (options.nonempty && value.length === 0) {
+    error(
+      path,
+      "invalid_format",
+      `Expected at least one value. Add a value to ${path} or remove the field.`
+    );
+  }
+  value.forEach((entry, index) => {
+    if (options.slug && !nonblank(entry)) {
+      error(
+        `${path}[${index}]`,
+        "invalid_format",
+        "Expected a non-empty branch slug. Remove the empty value or use a branch slug."
+      );
+    }
+  });
+  if (options.unique && new Set(value).size !== value.length) {
+    error(
+      path,
+      "duplicate",
+      `Expected unique values. Remove duplicates from ${path}.`
+    );
+  }
+  return value;
+}
+function paths(value, error) {
+  const values = stringList(value, "prerender", error, { unique: true });
+  values?.forEach((path, index) => {
+    if (!path.startsWith("/")) {
+      error(
+        `prerender[${index}]`,
+        "invalid_format",
+        "Expected a route starting with /. Prefix the route with /."
+      );
+    }
+  });
+}
+export {
+  validateConfig
+};
+//# sourceMappingURL=validate.js.map

package/dist/site-config/validate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/site-config/validate.ts"],
+  "sourcesContent": ["import {\n  globallyAllowed,\n  hostname,\n  nonblank,\n  packageName,\n  record,\n  unknownKeys,\n} from \"./helpers\";\nimport { analytics, budgets, nested } from \"./sections\";\nimport type { ConfigIssue, ConfigValidation } from \"./types\";\n\nconst rootKeys = [\n  \"store\",\n  \"branches\",\n  \"theme\",\n  \"prerender\",\n  \"menu\",\n  \"packages\",\n  \"outbound\",\n  \"budgets\",\n  \"analytics\",\n] as const;\n\n/**\n * Validate a site configuration and collect errors and warnings without changing it.\n * Checks required fields, unknown keys, allowlists, budgets and analytics settings.\n *\n * @param input - The configuration value to inspect.\n * @returns Diagnostics and a valid flag that is true when there are no errors.\n */\nexport function validateConfig(input: unknown): ConfigValidation {\n  const issues: ConfigIssue[] = [];\n  const issue = (value: ConfigIssue) => issues.push(value);\n  const error = (path: string, code: ConfigIssue[\"code\"], message: string) =>\n    issue({ path, code, message, severity: \"error\" });\n  if (!record(input)) {\n    return {\n      valid: false,\n      issues: [\n        {\n          path: \"$\",\n          code: \"invalid_type\",\n          message:\n            \"Expected a configuration object. Export an object from zappie.config.ts.\",\n          severity: \"error\",\n        },\n      ],\n    };\n  }\n  unknownKeys(input, rootKeys, \"\", issue);\n  requiredSlug(input.store, \"store\", error);\n  theme(input.theme, error);\n  stringList(input.branches, \"branches\", error, {\n    nonempty: true,\n    unique: true,\n    slug: true,\n  });\n  paths(input.prerender, error);\n  nested(input.menu, \"menu\", [\"hiddenCategories\"], issue, (value) => {\n    stringList(value.hiddenCategories, \"menu.hiddenCategories\", error);\n  });\n  nested(input.packages, \"packages\", [\"allow\"], issue, (value) => {\n    const allow = stringList(value.allow, \"packages.allow\", error);\n    allow?.forEach((name, index) => {\n      if (globallyAllowed(name)) {\n        issue({\n          path: `packages.allow[${index}]`,\n          code: \"redundant_allowlist\",\n          message: `${name} is already globally allowed. Remove it from packages.allow.`,\n          severity: \"warning\",\n        });\n      } else if (!packageName(name)) {\n        error(\n          `packages.allow[${index}]`,\n          \"invalid_format\",\n          \"Expected a lowercase npm package name. Use a package name such as lucide-react or @scope/name.\",\n        );\n      }\n    });\n  });\n  nested(input.outbound, \"outbound\", [\"allow\"], issue, (value) => {\n    const allow = stringList(value.allow, \"outbound.allow\", error);\n    allow?.forEach((host, index) => {\n      if (!hostname(host)) {\n        error(\n          `outbound.allow[${index}]`,\n          \"invalid_format\",\n          \"Expected a hostname or leading *. subdomain pattern without a scheme, path, port or IP. Use a value such as api.example.com.\",\n        );\n      }\n    });\n  });\n  budgets(input.budgets, issue, error);\n  analytics(input.analytics, issue, error);\n  return {\n    valid: !issues.some((entry) => entry.severity === \"error\"),\n    issues,\n  };\n}\n\ntype AddError = (\n  path: string,\n  code: ConfigIssue[\"code\"],\n  message: string,\n) => void;\n\nfunction requiredSlug(value: unknown, path: string, error: AddError) {\n  if (!nonblank(value)) {\n    error(\n      path,\n      value === undefined ? \"missing_required\" : \"invalid_type\",\n      `Expected a non-empty storefront slug. Set ${path} to the slug used by createZappie().`,\n    );\n  }\n}\n\nfunction theme(value: unknown, error: AddError) {\n  if (typeof value !== \"string\") {\n    error(\n      \"theme\",\n      value === undefined ? \"missing_required\" : \"invalid_type\",\n      \"Expected a relative .json path. Set theme to a value such as ./theme.json.\",\n    );\n  } else if (\n    !/\\.json$/.test(value) ||\n    /^(?:[a-z][a-z\\d+.-]*:|\\/|\\\\)/i.test(value) ||\n    value.includes(\"\\\\\")\n  ) {\n    error(\n      \"theme\",\n      \"invalid_format\",\n      \"Expected a relative .json path. Use a value such as ./theme.json.\",\n    );\n  }\n}\n\nfunction stringList(\n  value: unknown,\n  path: string,\n  error: AddError,\n  options: { nonempty?: boolean; unique?: boolean; slug?: boolean } = {},\n) {\n  if (value === undefined) {\n    return undefined;\n  }\n  if (\n    !Array.isArray(value) ||\n    value.some((entry) => typeof entry !== \"string\")\n  ) {\n    error(\n      path,\n      \"invalid_type\",\n      `Expected an array of strings. Set ${path} to string values.`,\n    );\n    return undefined;\n  }\n  if (options.nonempty && value.length === 0) {\n    error(\n      path,\n      \"invalid_format\",\n      `Expected at least one value. Add a value to ${path} or remove the field.`,\n    );\n  }\n  value.forEach((entry, index) => {\n    if (options.slug && !nonblank(entry)) {\n      error(\n        `${path}[${index}]`,\n        \"invalid_format\",\n        \"Expected a non-empty branch slug. Remove the empty value or use a branch slug.\",\n      );\n    }\n  });\n  if (options.unique && new Set(value).size !== value.length) {\n    error(\n      path,\n      \"duplicate\",\n      `Expected unique values. Remove duplicates from ${path}.`,\n    );\n  }\n  return value;\n}\n\nfunction paths(value: unknown, error: AddError) {\n  const values = stringList(value, \"prerender\", error, { unique: true });\n  values?.forEach((path, index) => {\n    if (!path.startsWith(\"/\")) {\n      error(\n        `prerender[${index}]`,\n        \"invalid_format\",\n        \"Expected a route starting with /. Prefix the route with /.\",\n      );\n    }\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/template/index.js

@@ -1,3 +1,46 @@
-function s(e,t,n,r){return r==="review"?{...e,...n??{}}:r==="draft"?{...e,...t,...n??{}}:{...e,...t}}function a(e){if(!e||typeof e!="object")return null;let t=e;if(t.zappie!=="settings"||!t.values||typeof t.values!="object"||Array.isArray(t.values))return null;let n={};for(let[r,o]of Object.entries(t.values))(typeof o=="string"||typeof o=="number"||typeof o=="boolean")&&(n[r]=o);return n}var i=[320,480,640,960,1280,1600];function u(e,t,n=80){return /^https?:\/\//.test(e)?`/cdn-cgi/image/width=${t},quality=${n},format=auto,fit=scale-down/${e}`:e}function l(e,t){return i.map(n=>`${u(e,n,t)} ${n}w`).join(", ")}
-export{i as IMAGE_WIDTHS,u as resized,a as settingsFromMessage,l as srcSet,s as templateSettings};//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+// src/template/index.ts
+function templateSettings(defaults, saved, preview, mode) {
+  if (mode === "review") {
+    return { ...defaults, ...preview ?? {} };
+  }
+  if (mode === "draft") {
+    return { ...defaults, ...saved, ...preview ?? {} };
+  }
+  return { ...defaults, ...saved };
+}
+function settingsFromMessage(data) {
+  if (!data || typeof data !== "object") {
+    return null;
+  }
+  const message = data;
+  if (message.zappie !== "settings" || !message.values || typeof message.values !== "object" || Array.isArray(message.values)) {
+    return null;
+  }
+  const values = {};
+  for (const [key, value] of Object.entries(message.values)) {
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+      values[key] = value;
+    }
+  }
+  return values;
+}
+var IMAGE_WIDTHS = [320, 480, 640, 960, 1280, 1600];
+function resized(src, width, quality = 80) {
+  if (!/^https?:\/\//.test(src)) {
+    return src;
+  }
+  return `/cdn-cgi/image/width=${width},quality=${quality},format=auto,fit=scale-down/${src}`;
+}
+function srcSet(src, quality) {
+  return IMAGE_WIDTHS.map(
+    (width) => `${resized(src, width, quality)} ${width}w`
+  ).join(", ");
+}
+export {
+  IMAGE_WIDTHS,
+  resized,
+  settingsFromMessage,
+  srcSet,
+  templateSettings
+};
+//# sourceMappingURL=index.js.map

package/dist/template/index.js.map

@@ -1 +1,7 @@
-{"version":3,"sources":["../../src/template/index.ts"],"names":["templateSettings","defaults","saved","preview","mode","settingsFromMessage","data","message","values","key","value","IMAGE_WIDTHS","resized","src","width","quality","srcSet"],"mappings":"AAOO,SAASA,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACAC,EACG,CACH,OAAIA,CAAAA,GAAS,QAAA,CACJ,CAAE,GAAGH,CAAAA,CAAU,GAAIE,CAAAA,EAAW,EAAI,CAAA,CAEvCC,CAAAA,GAAS,OAAA,CACJ,CAAE,GAAGH,CAAAA,CAAU,GAAGC,EAAO,GAAIC,CAAAA,EAAW,EAAI,EAE9C,CAAE,GAAGF,CAAAA,CAAU,GAAGC,CAAM,CACjC,CAGO,SAASG,CAAAA,CACdC,CAAAA,CAC6C,CAC7C,GAAI,CAACA,GAAQ,OAAOA,CAAAA,EAAS,QAAA,CAC3B,OAAO,KAET,IAAMC,CAAAA,CAAUD,CAAAA,CAChB,GACEC,EAAQ,MAAA,GAAW,UAAA,EACnB,CAACA,CAAAA,CAAQ,QACT,OAAOA,CAAAA,CAAQ,MAAA,EAAW,QAAA,EAC1B,MAAM,OAAA,CAAQA,CAAAA,CAAQ,MAAM,CAAA,CAE5B,OAAO,IAAA,CAET,IAAMC,CAAAA,CAA+C,GACrD,IAAA,GAAW,CAACC,CAAAA,CAAKC,CAAK,CAAA,GAAK,MAAA,CAAO,OAAA,CAAQH,CAAAA,CAAQ,MAAM,CAAA,CAAA,CAEpD,OAAOG,CAAAA,EAAU,QAAA,EACjB,OAAOA,CAAAA,EAAU,QAAA,EACjB,OAAOA,CAAAA,EAAU,aAEjBF,CAAAA,CAAOC,CAAG,CAAA,CAAIC,CAAAA,CAAAA,CAGlB,OAAOF,CACT,CAGO,IAAMG,CAAAA,CAAe,CAAC,GAAA,CAAK,GAAA,CAAK,GAAA,CAAK,GAAA,CAAK,KAAM,IAAI,EAGpD,SAASC,CAAAA,CAAQC,EAAaC,CAAAA,CAAeC,CAAAA,CAAU,EAAA,CAAY,CACxE,OAAK,cAAA,CAAe,IAAA,CAAKF,CAAG,EAGrB,CAAA,qBAAA,EAAwBC,CAAK,CAAA,SAAA,EAAYC,CAAO,+BAA+BF,CAAG,CAAA,CAAA,CAFhFA,CAGX,CAGO,SAASG,CAAAA,CAAOH,CAAAA,CAAaE,CAAAA,CAA0B,CAC5D,OAAOJ,CAAAA,CAAa,GAAA,CACjBG,CAAAA,EAAU,CAAA,EAAGF,EAAQC,CAAAA,CAAKC,CAAAA,CAAOC,CAAO,CAAC,IAAID,CAAK,CAAA,CAAA,CACrD,CAAA,CAAE,IAAA,CAAK,IAAI,CACb","file":"index.js","sourcesContent":["/** A value accepted by a template manifest and the live preview bridge. */\nexport type TemplateSettingValue = string | number | boolean;\n\n/** Where a template is running. Live sites never accept preview messages. */\nexport type TemplateMode = \"site\" | \"draft\" | \"review\";\n\n/** Merge defaults, saved settings, and preview values for the current mode. */\nexport function templateSettings<T extends Record<string, unknown>>(\n  defaults: T,\n  saved: Record<string, TemplateSettingValue> | undefined,\n  preview: Record<string, TemplateSettingValue> | null,\n  mode: TemplateMode,\n): T {\n  if (mode === \"review\") {\n    return { ...defaults, ...(preview ?? {}) };\n  }\n  if (mode === \"draft\") {\n    return { ...defaults, ...saved, ...(preview ?? {}) };\n  }\n  return { ...defaults, ...saved };\n}\n\n/** Read primitive setting values from an editor message. */\nexport function settingsFromMessage(\n  data: unknown,\n): Record<string, TemplateSettingValue> | null {\n  if (!data || typeof data !== \"object\") {\n    return null;\n  }\n  const message = data as { zappie?: unknown; values?: unknown };\n  if (\n    message.zappie !== \"settings\" ||\n    !message.values ||\n    typeof message.values !== \"object\" ||\n    Array.isArray(message.values)\n  ) {\n    return null;\n  }\n  const values: Record<string, TemplateSettingValue> = {};\n  for (const [key, value] of Object.entries(message.values)) {\n    if (\n      typeof value === \"string\" ||\n      typeof value === \"number\" ||\n      typeof value === \"boolean\"\n    ) {\n      values[key] = value;\n    }\n  }\n  return values;\n}\n\n/** Cloudflare image widths shared by template sites. */\nexport const IMAGE_WIDTHS = [320, 480, 640, 960, 1280, 1600] as const;\n\n/** Build a same-origin Cloudflare resize URL for an external image. */\nexport function resized(src: string, width: number, quality = 80): string {\n  if (!/^https?:\\/\\//.test(src)) {\n    return src;\n  }\n  return `/cdn-cgi/image/width=${width},quality=${quality},format=auto,fit=scale-down/${src}`;\n}\n\n/** Build the responsive Cloudflare image candidates used by a template. */\nexport function srcSet(src: string, quality?: number): string {\n  return IMAGE_WIDTHS.map(\n    (width) => `${resized(src, width, quality)} ${width}w`,\n  ).join(\", \");\n}\n"]}
+{
+  "version": 3,
+  "sources": ["../../src/template/index.ts"],
+  "sourcesContent": ["/** A value accepted by a template manifest and the live preview bridge. */\nexport type TemplateSettingValue = string | number | boolean;\n\n/** Where a template is running. Live sites never accept preview messages. */\nexport type TemplateMode = \"site\" | \"draft\" | \"review\";\n\n/** Merge defaults, saved settings, and preview values for the current mode. */\nexport function templateSettings<T extends Record<string, unknown>>(\n  defaults: T,\n  saved: Record<string, TemplateSettingValue> | undefined,\n  preview: Record<string, TemplateSettingValue> | null,\n  mode: TemplateMode,\n): T {\n  if (mode === \"review\") {\n    return { ...defaults, ...(preview ?? {}) };\n  }\n  if (mode === \"draft\") {\n    return { ...defaults, ...saved, ...(preview ?? {}) };\n  }\n  return { ...defaults, ...saved };\n}\n\n/** Read primitive setting values from an editor message. */\nexport function settingsFromMessage(\n  data: unknown,\n): Record<string, TemplateSettingValue> | null {\n  if (!data || typeof data !== \"object\") {\n    return null;\n  }\n  const message = data as { zappie?: unknown; values?: unknown };\n  if (\n    message.zappie !== \"settings\" ||\n    !message.values ||\n    typeof message.values !== \"object\" ||\n    Array.isArray(message.values)\n  ) {\n    return null;\n  }\n  const values: Record<string, TemplateSettingValue> = {};\n  for (const [key, value] of Object.entries(message.values)) {\n    if (\n      typeof value === \"string\" ||\n      typeof value === \"number\" ||\n      typeof value === \"boolean\"\n    ) {\n      values[key] = value;\n    }\n  }\n  return values;\n}\n\n/** Cloudflare image widths shared by template sites. */\nexport const IMAGE_WIDTHS = [320, 480, 640, 960, 1280, 1600] as const;\n\n/** Build a same-origin Cloudflare resize URL for an external image. */\nexport function resized(src: string, width: number, quality = 80): string {\n  if (!/^https?:\\/\\//.test(src)) {\n    return src;\n  }\n  return `/cdn-cgi/image/width=${width},quality=${quality},format=auto,fit=scale-down/${src}`;\n}\n\n/** Build the responsive Cloudflare image candidates used by a template. */\nexport function srcSet(src: string, quality?: number): string {\n  return IMAGE_WIDTHS.map(\n    (width) => `${resized(src, width, quality)} ${width}w`,\n  ).join(\", \");\n}\n"],
+  "mappings": ";AAOO,SAAS,iBACd,UACA,OACA,SACA,MACG;AACH,MAAI,SAAS,UAAU;AACrB,WAAO,EAAE,GAAG,UAAU,GAAI,WAAW,CAAC,EAAG;AAAA,EAC3C;AACA,MAAI,SAAS,SAAS;AACpB,WAAO,EAAE,GAAG,UAAU,GAAG,OAAO,GAAI,WAAW,CAAC,EAAG;AAAA,EACrD;AACA,SAAO,EAAE,GAAG,UAAU,GAAG,MAAM;AACjC;AAGO,SAAS,oBACd,MAC6C;AAC7C,MAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;AACrC,WAAO;AAAA,EACT;AACA,QAAM,UAAU;AAChB,MACE,QAAQ,WAAW,cACnB,CAAC,QAAQ,UACT,OAAO,QAAQ,WAAW,YAC1B,MAAM,QAAQ,QAAQ,MAAM,GAC5B;AACA,WAAO;AAAA,EACT;AACA,QAAM,SAA+C,CAAC;AACtD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,MAAM,GAAG;AACzD,QACE,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,WACjB;AACA,aAAO,GAAG,IAAI;AAAA,IAChB;AAAA,EACF;AACA,SAAO;AACT;AAGO,IAAM,eAAe,CAAC,KAAK,KAAK,KAAK,KAAK,MAAM,IAAI;AAGpD,SAAS,QAAQ,KAAa,OAAe,UAAU,IAAY;AACxE,MAAI,CAAC,eAAe,KAAK,GAAG,GAAG;AAC7B,WAAO;AAAA,EACT;AACA,SAAO,wBAAwB,KAAK,YAAY,OAAO,+BAA+B,GAAG;AAC3F;AAGO,SAAS,OAAO,KAAa,SAA0B;AAC5D,SAAO,aAAa;AAAA,IAClB,CAAC,UAAU,GAAG,QAAQ,KAAK,OAAO,OAAO,CAAC,IAAI,KAAK;AAAA,EACrD,EAAE,KAAK,IAAI;AACb;",
+  "names": []
+}

package/dist/template/react.js

@@ -1,3 +1,82 @@
 "use client";
-import {useStore}from'@zappie/sdk/react';import {templateSettings,settingsFromMessage}from'@zappie/sdk/template';import {createContext,useState,useEffect,useMemo,useContext}from'react';import {jsx}from'react/jsx-runtime';var d=createContext({mode:"site",preview:null});function R({mode:t,children:r}){let[n,s]=useState(null);useEffect(()=>{if(s(null),t==="site")return;let i=e=>window.parent.postMessage(e,"*"),o=()=>i({zappie:"route",path:location.pathname+location.search}),a=()=>i({zappie:"scroll",y:window.scrollY,height:document.documentElement.scrollHeight}),l=e=>{let u=settingsFromMessage(e.data);u&&s(u);},p=history.pushState,c=history.replaceState;return history.pushState=function(...e){p.apply(this,e),o();},history.replaceState=function(...e){c.apply(this,e),o();},window.addEventListener("message",l),window.addEventListener("popstate",o),window.addEventListener("scroll",a,{passive:true}),i({zappie:"ready"}),o(),a(),()=>{window.removeEventListener("message",l),window.removeEventListener("popstate",o),window.removeEventListener("scroll",a),history.pushState=p,history.replaceState=c;}},[t]);let m=useMemo(()=>({mode:t,preview:n}),[t,n]);return jsx(d.Provider,{value:m,children:r})}function C(t){let r=useStore(),{mode:n,preview:s}=useContext(d);return templateSettings(t,r.data?.templateSettings,s,n)}export{R as TemplateSettingsProvider,C as useTemplateSettings};//# sourceMappingURL=react.js.map
-//# sourceMappingURL=react.js.map
+
+// src/template/react.tsx
+import { useStore } from "@zappie/sdk/react";
+import {
+  settingsFromMessage,
+  templateSettings
+} from "@zappie/sdk/template";
+import {
+  createContext,
+  useContext,
+  useEffect,
+  useMemo,
+  useState
+} from "react";
+import { jsx } from "react/jsx-runtime";
+var Context = createContext({ mode: "site", preview: null });
+function TemplateSettingsProvider({
+  mode,
+  children
+}) {
+  const [preview, setPreview] = useState(null);
+  useEffect(() => {
+    setPreview(null);
+    if (mode === "site") {
+      return;
+    }
+    const send = (message2) => window.parent.postMessage(message2, "*");
+    const route = () => send({ zappie: "route", path: location.pathname + location.search });
+    const scroll = () => send({
+      zappie: "scroll",
+      y: window.scrollY,
+      height: document.documentElement.scrollHeight
+    });
+    const message = (event) => {
+      const values = settingsFromMessage(event.data);
+      if (values) {
+        setPreview(values);
+      }
+    };
+    const pushState = history.pushState;
+    const replaceState = history.replaceState;
+    history.pushState = function(...args) {
+      pushState.apply(this, args);
+      route();
+    };
+    history.replaceState = function(...args) {
+      replaceState.apply(this, args);
+      route();
+    };
+    window.addEventListener("message", message);
+    window.addEventListener("popstate", route);
+    window.addEventListener("scroll", scroll, { passive: true });
+    send({ zappie: "ready" });
+    route();
+    scroll();
+    return () => {
+      window.removeEventListener("message", message);
+      window.removeEventListener("popstate", route);
+      window.removeEventListener("scroll", scroll);
+      history.pushState = pushState;
+      history.replaceState = replaceState;
+    };
+  }, [mode]);
+  const value = useMemo(() => ({ mode, preview }), [mode, preview]);
+  return /* @__PURE__ */ jsx(Context.Provider, { value, children });
+}
+function useTemplateSettings(defaults) {
+  const store = useStore();
+  const { mode, preview } = useContext(Context);
+  return templateSettings(
+    defaults,
+    store.data?.templateSettings,
+    preview,
+    mode
+  );
+}
+export {
+  TemplateSettingsProvider,
+  useTemplateSettings
+};
+//# sourceMappingURL=react.js.map

package/dist/template/react.js.map

@@ -1 +1,7 @@
-{"version":3,"sources":["../../src/template/react.tsx"],"names":["Context","createContext","TemplateSettingsProvider","mode","children","preview","setPreview","useState","useEffect","send","message","route","scroll","event","values","settingsFromMessage","pushState","replaceState","args","value","useMemo","jsx","useTemplateSettings","defaults","store","useStore","useContext","templateSettings"],"mappings":"6NAiBA,IAAMA,CAAAA,CAAUC,aAAAA,CAGb,CAAE,IAAA,CAAM,MAAA,CAAQ,OAAA,CAAS,IAAK,CAAC,CAAA,CAG3B,SAASC,CAAAA,CAAyB,CACvC,IAAA,CAAAC,CAAAA,CACA,QAAA,CAAAC,CACF,CAAA,CAGG,CACD,GAAM,CAACC,CAAAA,CAASC,CAAU,CAAA,CAAIC,QAAAA,CAGpB,IAAI,CAAA,CACdC,SAAAA,CAAU,IAAM,CAEd,GADAF,CAAAA,CAAW,IAAI,CAAA,CACXH,CAAAA,GAAS,MAAA,CACX,OAEF,IAAMM,CAAAA,CAAQC,CAAAA,EAAoB,MAAA,CAAO,MAAA,CAAO,WAAA,CAAYA,CAAAA,CAAS,GAAG,CAAA,CAClEC,CAAAA,CAAQ,IACZF,CAAAA,CAAK,CAAE,MAAA,CAAQ,OAAA,CAAS,IAAA,CAAM,QAAA,CAAS,QAAA,CAAW,QAAA,CAAS,MAAO,CAAC,CAAA,CAC/DG,CAAAA,CAAS,IACbH,CAAAA,CAAK,CACH,MAAA,CAAQ,QAAA,CACR,CAAA,CAAG,MAAA,CAAO,OAAA,CACV,MAAA,CAAQ,QAAA,CAAS,eAAA,CAAgB,YACnC,CAAC,CAAA,CACGC,CAAAA,CAAWG,CAAAA,EAAwB,CACvC,IAAMC,CAAAA,CAASC,mBAAAA,CAAoBF,CAAAA,CAAM,IAAI,CAAA,CACzCC,CAAAA,EACFR,CAAAA,CAAWQ,CAAM,EAErB,CAAA,CACME,CAAAA,CAAY,OAAA,CAAQ,SAAA,CACpBC,CAAAA,CAAe,OAAA,CAAQ,YAAA,CAC7B,OAAA,OAAA,CAAQ,SAAA,CAAY,SAAA,GAAaC,CAAAA,CAAM,CACrCF,CAAAA,CAAU,KAAA,CAAM,IAAA,CAAME,CAAI,CAAA,CAC1BP,CAAAA,GACF,CAAA,CACA,OAAA,CAAQ,YAAA,CAAe,SAAA,GAAaO,CAAAA,CAAM,CACxCD,CAAAA,CAAa,KAAA,CAAM,IAAA,CAAMC,CAAI,CAAA,CAC7BP,CAAAA,GACF,CAAA,CACA,MAAA,CAAO,gBAAA,CAAiB,SAAA,CAAWD,CAAO,CAAA,CAC1C,MAAA,CAAO,gBAAA,CAAiB,UAAA,CAAYC,CAAK,CAAA,CACzC,MAAA,CAAO,gBAAA,CAAiB,QAAA,CAAUC,CAAAA,CAAQ,CAAE,OAAA,CAAS,IAAK,CAAC,CAAA,CAC3DH,CAAAA,CAAK,CAAE,MAAA,CAAQ,OAAQ,CAAC,CAAA,CACxBE,CAAAA,EAAM,CACNC,CAAAA,EAAO,CACA,IAAM,CACX,MAAA,CAAO,mBAAA,CAAoB,SAAA,CAAWF,CAAO,CAAA,CAC7C,MAAA,CAAO,mBAAA,CAAoB,UAAA,CAAYC,CAAK,CAAA,CAC5C,MAAA,CAAO,mBAAA,CAAoB,QAAA,CAAUC,CAAM,CAAA,CAC3C,OAAA,CAAQ,SAAA,CAAYI,CAAAA,CACpB,OAAA,CAAQ,YAAA,CAAeC,EACzB,CACF,CAAA,CAAG,CAACd,CAAI,CAAC,CAAA,CACT,IAAMgB,CAAAA,CAAQC,OAAAA,CAAQ,KAAO,CAAE,IAAA,CAAAjB,CAAAA,CAAM,OAAA,CAAAE,CAAQ,CAAA,CAAA,CAAI,CAACF,CAAAA,CAAME,CAAO,CAAC,CAAA,CAChE,OAAOgB,GAAAA,CAACrB,CAAAA,CAAQ,QAAA,CAAR,CAAiB,KAAA,CAAOmB,CAAAA,CAAQ,QAAA,CAAAf,CAAAA,CAAS,CACnD,CAGO,SAASkB,CAAAA,CACdC,CAAAA,CACG,CACH,IAAMC,CAAAA,CAAQC,QAAAA,EAAS,CACjB,CAAE,IAAA,CAAAtB,CAAAA,CAAM,OAAA,CAAAE,CAAQ,CAAA,CAAIqB,UAAAA,CAAW1B,CAAO,CAAA,CAC5C,OAAO2B,gBAAAA,CACLJ,CAAAA,CACAC,CAAAA,CAAM,IAAA,EAAM,gBAAA,CACZnB,CAAAA,CACAF,CACF,CACF","file":"react.js","sourcesContent":["\"use client\";\nimport { useStore } from \"@zappie/sdk/react\";\nimport {\n  settingsFromMessage,\n  templateSettings,\n  type TemplateMode,\n  type TemplateSettingValue,\n} from \"@zappie/sdk/template\";\nimport {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  type ReactNode,\n} from \"react\";\n\nconst Context = createContext<{\n  mode: TemplateMode;\n  preview: Record<string, TemplateSettingValue> | null;\n}>({ mode: \"site\", preview: null });\n\n/** Supply the host-controlled template mode and editor bridge to a storefront. */\nexport function TemplateSettingsProvider({\n  mode,\n  children,\n}: {\n  mode: TemplateMode;\n  children: ReactNode;\n}) {\n  const [preview, setPreview] = useState<Record<\n    string,\n    TemplateSettingValue\n  > | null>(null);\n  useEffect(() => {\n    setPreview(null);\n    if (mode === \"site\") {\n      return;\n    }\n    const send = (message: object) => window.parent.postMessage(message, \"*\");\n    const route = () =>\n      send({ zappie: \"route\", path: location.pathname + location.search });\n    const scroll = () =>\n      send({\n        zappie: \"scroll\",\n        y: window.scrollY,\n        height: document.documentElement.scrollHeight,\n      });\n    const message = (event: MessageEvent) => {\n      const values = settingsFromMessage(event.data);\n      if (values) {\n        setPreview(values);\n      }\n    };\n    const pushState = history.pushState;\n    const replaceState = history.replaceState;\n    history.pushState = function (...args) {\n      pushState.apply(this, args);\n      route();\n    };\n    history.replaceState = function (...args) {\n      replaceState.apply(this, args);\n      route();\n    };\n    window.addEventListener(\"message\", message);\n    window.addEventListener(\"popstate\", route);\n    window.addEventListener(\"scroll\", scroll, { passive: true });\n    send({ zappie: \"ready\" });\n    route();\n    scroll();\n    return () => {\n      window.removeEventListener(\"message\", message);\n      window.removeEventListener(\"popstate\", route);\n      window.removeEventListener(\"scroll\", scroll);\n      history.pushState = pushState;\n      history.replaceState = replaceState;\n    };\n  }, [mode]);\n  const value = useMemo(() => ({ mode, preview }), [mode, preview]);\n  return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\n/** Read effective merchant settings over the defaults declared by a template. */\nexport function useTemplateSettings<T extends Record<string, unknown>>(\n  defaults: T,\n): T {\n  const store = useStore();\n  const { mode, preview } = useContext(Context);\n  return templateSettings(\n    defaults,\n    store.data?.templateSettings,\n    preview,\n    mode,\n  );\n}\n"]}
+{
+  "version": 3,
+  "sources": ["../../src/template/react.tsx"],
+  "sourcesContent": ["\"use client\";\nimport { useStore } from \"@zappie/sdk/react\";\nimport {\n  settingsFromMessage,\n  templateSettings,\n  type TemplateMode,\n  type TemplateSettingValue,\n} from \"@zappie/sdk/template\";\nimport {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  type ReactNode,\n} from \"react\";\n\nconst Context = createContext<{\n  mode: TemplateMode;\n  preview: Record<string, TemplateSettingValue> | null;\n}>({ mode: \"site\", preview: null });\n\n/** Supply the host-controlled template mode and editor bridge to a storefront. */\nexport function TemplateSettingsProvider({\n  mode,\n  children,\n}: {\n  mode: TemplateMode;\n  children: ReactNode;\n}) {\n  const [preview, setPreview] = useState<Record<\n    string,\n    TemplateSettingValue\n  > | null>(null);\n  useEffect(() => {\n    setPreview(null);\n    if (mode === \"site\") {\n      return;\n    }\n    const send = (message: object) => window.parent.postMessage(message, \"*\");\n    const route = () =>\n      send({ zappie: \"route\", path: location.pathname + location.search });\n    const scroll = () =>\n      send({\n        zappie: \"scroll\",\n        y: window.scrollY,\n        height: document.documentElement.scrollHeight,\n      });\n    const message = (event: MessageEvent) => {\n      const values = settingsFromMessage(event.data);\n      if (values) {\n        setPreview(values);\n      }\n    };\n    const pushState = history.pushState;\n    const replaceState = history.replaceState;\n    history.pushState = function (...args) {\n      pushState.apply(this, args);\n      route();\n    };\n    history.replaceState = function (...args) {\n      replaceState.apply(this, args);\n      route();\n    };\n    window.addEventListener(\"message\", message);\n    window.addEventListener(\"popstate\", route);\n    window.addEventListener(\"scroll\", scroll, { passive: true });\n    send({ zappie: \"ready\" });\n    route();\n    scroll();\n    return () => {\n      window.removeEventListener(\"message\", message);\n      window.removeEventListener(\"popstate\", route);\n      window.removeEventListener(\"scroll\", scroll);\n      history.pushState = pushState;\n      history.replaceState = replaceState;\n    };\n  }, [mode]);\n  const value = useMemo(() => ({ mode, preview }), [mode, preview]);\n  return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\n/** Read effective merchant settings over the defaults declared by a template. */\nexport function useTemplateSettings<T extends Record<string, unknown>>(\n  defaults: T,\n): T {\n  const store = useStore();\n  const { mode, preview } = useContext(Context);\n  return templateSettings(\n    defaults,\n    store.data?.templateSettings,\n    preview,\n    mode,\n  );\n}\n"],
+  "mappings": ";;;AACA,SAAS,gBAAgB;AACzB;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAgEE;AA9DT,IAAM,UAAU,cAGb,EAAE,MAAM,QAAQ,SAAS,KAAK,CAAC;AAG3B,SAAS,yBAAyB;AAAA,EACvC;AAAA,EACA;AACF,GAGG;AACD,QAAM,CAAC,SAAS,UAAU,IAAI,SAGpB,IAAI;AACd,YAAU,MAAM;AACd,eAAW,IAAI;AACf,QAAI,SAAS,QAAQ;AACnB;AAAA,IACF;AACA,UAAM,OAAO,CAACA,aAAoB,OAAO,OAAO,YAAYA,UAAS,GAAG;AACxE,UAAM,QAAQ,MACZ,KAAK,EAAE,QAAQ,SAAS,MAAM,SAAS,WAAW,SAAS,OAAO,CAAC;AACrE,UAAM,SAAS,MACb,KAAK;AAAA,MACH,QAAQ;AAAA,MACR,GAAG,OAAO;AAAA,MACV,QAAQ,SAAS,gBAAgB;AAAA,IACnC,CAAC;AACH,UAAM,UAAU,CAAC,UAAwB;AACvC,YAAM,SAAS,oBAAoB,MAAM,IAAI;AAC7C,UAAI,QAAQ;AACV,mBAAW,MAAM;AAAA,MACnB;AAAA,IACF;AACA,UAAM,YAAY,QAAQ;AAC1B,UAAM,eAAe,QAAQ;AAC7B,YAAQ,YAAY,YAAa,MAAM;AACrC,gBAAU,MAAM,MAAM,IAAI;AAC1B,YAAM;AAAA,IACR;AACA,YAAQ,eAAe,YAAa,MAAM;AACxC,mBAAa,MAAM,MAAM,IAAI;AAC7B,YAAM;AAAA,IACR;AACA,WAAO,iBAAiB,WAAW,OAAO;AAC1C,WAAO,iBAAiB,YAAY,KAAK;AACzC,WAAO,iBAAiB,UAAU,QAAQ,EAAE,SAAS,KAAK,CAAC;AAC3D,SAAK,EAAE,QAAQ,QAAQ,CAAC;AACxB,UAAM;AACN,WAAO;AACP,WAAO,MAAM;AACX,aAAO,oBAAoB,WAAW,OAAO;AAC7C,aAAO,oBAAoB,YAAY,KAAK;AAC5C,aAAO,oBAAoB,UAAU,MAAM;AAC3C,cAAQ,YAAY;AACpB,cAAQ,eAAe;AAAA,IACzB;AAAA,EACF,GAAG,CAAC,IAAI,CAAC;AACT,QAAM,QAAQ,QAAQ,OAAO,EAAE,MAAM,QAAQ,IAAI,CAAC,MAAM,OAAO,CAAC;AAChE,SAAO,oBAAC,QAAQ,UAAR,EAAiB,OAAe,UAAS;AACnD;AAGO,SAAS,oBACd,UACG;AACH,QAAM,QAAQ,SAAS;AACvB,QAAM,EAAE,MAAM,QAAQ,IAAI,WAAW,OAAO;AAC5C,SAAO;AAAA,IACL;AAAA,IACA,MAAM,MAAM;AAAA,IACZ;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": ["message"]
+}