@gemboss/gem-framework 0.4.0

package/dist/sections.js

@@ -0,0 +1,112 @@
+// ../../packages/gem-sections/src/element-overrides.ts
+function edgesToCss(v) {
+  if (!v || typeof v !== "object") return void 0;
+  const sides = [v.t, v.r, v.b, v.l];
+  if (!sides.some((x) => typeof x === "number")) return void 0;
+  const px = (x) => typeof x === "number" ? `${x}px` : "0px";
+  return `${px(v.t)} ${px(v.r)} ${px(v.b)} ${px(v.l)}`;
+}
+function elementOverrideStyle(section, elId) {
+  const store = section?.element_settings ?? {};
+  const o = store[elId];
+  if (!o || typeof o !== "object") return void 0;
+  const s = {};
+  if (typeof o.font_size === "number") s.fontSize = `${o.font_size}px`;
+  if (typeof o.text_color === "string" && o.text_color) s.color = o.text_color;
+  if (typeof o.font_weight === "number" || typeof o.font_weight === "string" && o.font_weight) s.fontWeight = String(o.font_weight);
+  if (o.text_align === "left" || o.text_align === "center" || o.text_align === "right") s.textAlign = o.text_align;
+  if (typeof o.line_height === "number") s.lineHeight = String(o.line_height);
+  if (typeof o.letter_spacing === "number") s.letterSpacing = `${o.letter_spacing}px`;
+  if (o.text_transform === "uppercase" || o.text_transform === "lowercase" || o.text_transform === "capitalize" || o.text_transform === "none") s.textTransform = o.text_transform;
+  if (o.font_style === "italic") s.fontStyle = "italic";
+  const pad = edgesToCss(o.padding);
+  if (pad) s.padding = pad;
+  const mar = edgesToCss(o.margin);
+  if (mar) s.margin = mar;
+  if (typeof o.background_color === "string" && o.background_color) s.background = o.background_color;
+  if (typeof o.border_radius === "number") s.borderRadius = `${o.border_radius}px`;
+  if (typeof o.border_width === "number" && o.border_width > 0) {
+    const bc = typeof o.border_color === "string" && o.border_color ? o.border_color : "currentColor";
+    s.border = `${o.border_width}px solid ${bc}`;
+  }
+  if (typeof o.opacity === "number" && o.opacity >= 0 && o.opacity <= 100) s.opacity = String(o.opacity / 100);
+  if (typeof o.max_width === "number" && o.max_width > 0) s.maxWidth = `${o.max_width}px`;
+  return Object.keys(s).length ? s : void 0;
+}
+function elementOverrides(section) {
+  return (elId) => elementOverrideStyle(section, elId);
+}
+
+// ../../packages/gem-sections/src/responsive-image.ts
+var WIDTHS = [640, 828, 1080, 1920];
+var OPTIMIZER = /^\/_next\/image\?url=[^&\s]+&w=(\d+)&q=(\d+)$/;
+var SHOPIFY_WIDTHS = [256, 384, 512, 768, 1024, 1536];
+var SHOPIFY_IMAGE = /^https:\/\/(?:cdn\.shopify\.com\/|[a-z0-9-]+\.myshopify\.com\/cdn\/)[^\s]+$/i;
+function shopifySrcSet(src) {
+  let url;
+  try {
+    url = new URL(src);
+  } catch {
+    return void 0;
+  }
+  if (url.searchParams.has("width")) return void 0;
+  return SHOPIFY_WIDTHS.map((w) => {
+    const candidate = new URL(url.href);
+    candidate.searchParams.set("width", String(w));
+    return `${candidate.href} ${w}w`;
+  }).join(", ");
+}
+function imageSrcSet(src) {
+  if (typeof src !== "string") return void 0;
+  if (SHOPIFY_IMAGE.test(src)) return shopifySrcSet(src);
+  const match = OPTIMIZER.exec(src);
+  if (!match) return void 0;
+  const asked = Number(match[1]);
+  const widths = WIDTHS.filter((w) => w <= asked);
+  if (widths.length < 2) return void 0;
+  return widths.map((w) => `${src.replace(/&w=\d+/, `&w=${w}`)} ${w}w`).join(", ");
+}
+
+// ../../packages/gem-sections/src/selling-plans.ts
+function num(value) {
+  const n = typeof value === "string" || typeof value === "number" ? Number(value) : NaN;
+  return Number.isFinite(n) ? n : null;
+}
+function subscriptionPlans(allocations, basePrice) {
+  const rows = Array.isArray(allocations) ? allocations : [];
+  const base = num(basePrice) ?? 0;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const row of rows) {
+    const id = typeof row?.sellingPlan?.id === "string" ? row.sellingPlan.id.trim() : "";
+    if (!id || seen.has(id)) continue;
+    const adjustments = Array.isArray(row?.priceAdjustments) ? row.priceAdjustments.filter(Boolean) : [];
+    const first = adjustments[0];
+    const money = first?.perDeliveryPrice ?? first?.price ?? null;
+    const amount = adjustments.length ? num(money?.amount) : base > 0 ? base : null;
+    if (amount === null) continue;
+    seen.add(id);
+    const cheaper = base > 0 && amount < base;
+    const discountPct = cheaper ? (1 - amount / base) * 100 : 0;
+    out.push({
+      id,
+      name: typeof row?.sellingPlan?.name === "string" && row.sellingPlan.name.trim() || "Subscription",
+      amount,
+      currencyCode: typeof money?.currencyCode === "string" && money.currencyCode || void 0,
+      savingPct: Math.round(discountPct),
+      discountPct,
+      introOnly: adjustments.length > 1
+    });
+  }
+  return out;
+}
+function defaultPlan(plans) {
+  if (!plans.length) return null;
+  return plans.reduce((best, p) => p.amount < best.amount ? p : best, plans[0]);
+}
+export {
+  defaultPlan,
+  elementOverrides,
+  imageSrcSet,
+  subscriptionPlans
+};

package/dist/settings-schema.js

@@ -0,0 +1,254 @@
+// ../../scripts/lib/settings-schema-contract.mjs
+var CONTROL_TYPES = Object.freeze([
+  "text",
+  "textarea",
+  "richtext",
+  "inline_richtext",
+  "select",
+  "radio",
+  "checkbox",
+  "number",
+  "range",
+  "color",
+  "color_scheme",
+  "image_picker",
+  "video",
+  "url",
+  "link_list",
+  "collection",
+  "product",
+  "edges",
+  // 4-side spacing box, value = {t,r,b,l}
+  "repeater",
+  // object-array rows
+  "header"
+  // non-input group label
+]);
+var SETTING_GROUPS = Object.freeze(["content", "options", "design", "advanced"]);
+var CONTROL_TYPE_SET = new Set(CONTROL_TYPES);
+var GROUP_SET = new Set(SETTING_GROUPS);
+var GEM_PREFIX = "gem_";
+var ADVANCED_ID_RE = /(^|_)(visibility|custom_css|custom_html|custom_class|class_name|attribute|animation|reveal|position|opacity|z_index|anchor|css_id)(_|$)/i;
+var DESIGN_ID_RE = /(^|_)(colou?r|scheme|radius|shadow|border|spacing|padding|margin|weight|font|typography|align|alignment|card|divider|overlay|tone|price)(_|$)/i;
+var CONTENT_TYPES = /* @__PURE__ */ new Set([
+  "text",
+  "textarea",
+  "richtext",
+  "inline_richtext",
+  "image_picker",
+  "video",
+  "url",
+  "link_list",
+  "collection",
+  "product",
+  "repeater"
+]);
+var HEX_RE = /^#([0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
+function humanizeId(id = "") {
+  const base = String(id).replace(/^gem_/, "");
+  const words = base.replace(/[_-]+/g, " ").trim().split(/\s+/);
+  if (words.length === 0 || words[0] === "") return "";
+  return words.map((w, i) => i === 0 ? w.charAt(0).toUpperCase() + w.slice(1) : w).join(" ");
+}
+function inferStringControl(id = "", setting = {}) {
+  const key = String(id).toLowerCase();
+  if (typeof setting.default === "string" && HEX_RE.test(setting.default.trim())) return "color";
+  if (/(^|_)(colou?r)(_|$)/.test(key)) return "color";
+  if (/scheme/.test(key)) return "color_scheme";
+  if (/(url|link|href)$/.test(key)) return "url";
+  if (/(^|_)(image|photo|logo|avatar|icon|media)(_|$)/.test(key) && !/(url|link)$/.test(key)) return "image_picker";
+  return typeof setting.default === "string" && setting.default.length > 80 ? "textarea" : "text";
+}
+function coerceStubType(id = "", fallback = "text") {
+  const key = String(id).toLowerCase();
+  if (/^show_|^enable_|^hide_|^is_|_enabled$|^use_/.test(key)) return "checkbox";
+  if (key === "color_scheme" || /_scheme$|color_scheme/.test(key)) return "color_scheme";
+  if (/(^|_)(colou?r)(_|$)/.test(key)) return "color";
+  if (/^layout$|_layout$|position|alignment|_size$|variant|style$|columns?$/.test(key)) return "select";
+  if (/(^|_)(image|photo|media|logo|avatar)(_|$)/.test(key)) return "image_picker";
+  if (/(url|link|href)$/.test(key)) return "url";
+  if (/count$|limit$|number|_qty$|min$|max$/.test(key)) return "number";
+  return CONTROL_TYPE_SET.has(fallback) ? fallback : "text";
+}
+function resolveType(s, hasOptions) {
+  const rawType = String(s.type || "").toLowerCase();
+  if (CONTROL_TYPE_SET.has(rawType) && rawType !== "text" && rawType !== "textarea") return rawType;
+  if (hasOptions && rawType !== "radio") {
+    if (rawType === "" || rawType === "string" || rawType === "integer" || rawType === "number" || rawType === "setting" || !CONTROL_TYPE_SET.has(rawType)) {
+      return "select";
+    }
+  }
+  switch (rawType) {
+    case "text":
+    case "textarea":
+      return rawType;
+    case "boolean":
+      return "checkbox";
+    case "string":
+      return inferStringControl(s.id, s);
+    case "integer":
+      return "number";
+    case "array":
+    case "object":
+      return "repeater";
+    case "setting":
+      return coerceStubType(s.id);
+    default:
+      return coerceStubType(s.id, rawType);
+  }
+}
+function inferGroup(setting = {}) {
+  const id = String(setting.id || "");
+  const type = String(setting.type || "");
+  if (setting.group && GROUP_SET.has(setting.group)) return setting.group;
+  if (ADVANCED_ID_RE.test(id)) return "advanced";
+  if (id.startsWith(GEM_PREFIX)) return "design";
+  if (type === "color" || type === "color_scheme" || type === "edges") return "design";
+  if (type === "image_picker" || type === "video") return "content";
+  if (DESIGN_ID_RE.test(id)) return "design";
+  if (CONTENT_TYPES.has(type) && !/^show_|^enable_|^default_|^selected_/.test(id)) return "content";
+  return "options";
+}
+function normalizeSetting(s = {}) {
+  if (!s || typeof s !== "object") return null;
+  if (s.type === "header") {
+    return { type: "header", group: s.group && GROUP_SET.has(s.group) ? s.group : "content", content: s.content || s.label || "" };
+  }
+  const id = s.id;
+  if (!id) return null;
+  const options = Array.isArray(s.options) ? s.options : Array.isArray(s.enum) ? s.enum.map((v) => ({ value: String(v), label: humanizeId(String(v)) || String(v) })) : void 0;
+  const min = s.min !== void 0 ? s.min : s.minimum;
+  const max = s.max !== void 0 ? s.max : s.maximum;
+  const type = resolveType(s, Boolean(options));
+  const out = {
+    id,
+    type,
+    group: inferGroup({ ...s, type }),
+    label: s.label || humanizeId(id)
+  };
+  if (s.info) out.info = s.info;
+  if (s.default !== void 0) out.default = s.default;
+  if (options) out.options = options;
+  if (min !== void 0) out.min = min;
+  if (max !== void 0) out.max = max;
+  if (s.step !== void 0) out.step = s.step;
+  if (s.unit !== void 0) out.unit = s.unit;
+  if (s.variant) out.variant = s.variant;
+  if (s.requires && typeof s.requires === "object") out.requires = s.requires;
+  if (type === "repeater" && Array.isArray(s.item)) out.item = s.item;
+  return out;
+}
+function normalizeBlocks(blocks) {
+  if (!Array.isArray(blocks)) return void 0;
+  return blocks.map((b) => {
+    if (!b || typeof b !== "object") return b;
+    const out = { ...b };
+    if (Array.isArray(b.settings)) out.settings = b.settings.map(normalizeSetting).filter(Boolean);
+    return out;
+  });
+}
+function dedupe(rows) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const r of rows) {
+    if (!r) continue;
+    if (r.type === "header") {
+      out.push(r);
+      continue;
+    }
+    if (r.id && seen.has(r.id)) continue;
+    if (r.id) seen.add(r.id);
+    out.push(r);
+  }
+  return out;
+}
+function normalizeSettingsSchema(raw) {
+  let rows = [];
+  if (raw && Array.isArray(raw.settings)) {
+    rows = raw.settings.map(normalizeSetting);
+  } else if (raw && raw.type === "object" && raw.properties && typeof raw.properties === "object") {
+    const required = new Set(Array.isArray(raw.required) ? raw.required : []);
+    rows = Object.entries(raw.properties).map(([id, prop]) => normalizeSetting({ id, ...prop, required: required.has(id) }));
+  } else if (Array.isArray(raw)) {
+    rows = raw.map(normalizeSetting);
+  }
+  const out = { settings: dedupe(rows) };
+  const blocks = normalizeBlocks(raw && raw.blocks);
+  if (blocks) out.blocks = blocks;
+  return out;
+}
+function validateRow(s, seen, push) {
+  if (!s || typeof s !== "object") {
+    push("error", "invalid_setting_row", "Setting row is not an object.");
+    return;
+  }
+  if (s.type === "header") return;
+  if (s.type === "setting") {
+    push("error", "stub_setting_type", `Stub dialect (type:"setting") carries no control info.`, s.id);
+    return;
+  }
+  if (!s.id) push("error", "missing_id", "Setting has no `id`.");
+  else if (seen.has(s.id)) push("error", "duplicate_id", `Duplicate setting id "${s.id}".`, s.id);
+  else seen.add(s.id);
+  if (!s.type) push("error", "missing_type", `Setting "${s.id}" has no \`type\`.`, s.id);
+  else if (!CONTROL_TYPE_SET.has(s.type)) push("error", "unknown_type", `Setting "${s.id}" uses non-canonical type "${s.type}".`, s.id);
+  if (!s.label) push("warn", "missing_label", `Setting "${s.id}" has no \`label\`.`, s.id);
+  if (!s.group) push("warn", "missing_group", `Setting "${s.id}" has no \`group\`.`, s.id);
+  else if (!GROUP_SET.has(s.group)) push("error", "unknown_group", `Setting "${s.id}" uses unknown group "${s.group}".`, s.id);
+  if ((s.type === "select" || s.type === "radio") && !Array.isArray(s.options))
+    push("warn", "choice_without_options", `Setting "${s.id}" (${s.type}) has no \`options\`.`, s.id);
+  if (s.requires !== void 0) {
+    const r = s.requires;
+    const ok = r && typeof r === "object" && typeof r.key === "string" && r.key && ("equals" in r && ["string", "number", "boolean"].includes(typeof r.equals) || r.set === true);
+    if (!ok) push("error", "invalid_requires", `Setting "${s.id}" has a malformed \`requires\` (want {key, equals} or {key, set: true}).`, s.id);
+  }
+}
+function validateRequires(rows, push) {
+  const byId = new Map(rows.filter((r) => r && r.id).map((r) => [r.id, r]));
+  for (const s of rows) {
+    const r = s && s.requires;
+    if (!r || typeof r !== "object" || typeof r.key !== "string") continue;
+    const gate = byId.get(r.key);
+    if (!gate || gate === s) {
+      push("error", "requires_unknown_key", `Setting "${s.id}" requires "${r.key}", which this schema does not declare.`, s.id);
+      continue;
+    }
+    if ("equals" in r && Array.isArray(gate.options) && !gate.options.some((o) => o && String(o.value) === String(r.equals)))
+      push("error", "requires_unknown_value", `Setting "${s.id}" requires ${r.key} = "${r.equals}", which is not one of its options.`, s.id);
+  }
+}
+function validateSettingsSchema(raw) {
+  const issues = [];
+  const push = (level, code, message, id) => issues.push({ level, code, message, id });
+  const isArrayShape = raw && Array.isArray(raw.settings);
+  const isJsonSchemaShape = raw && raw.type === "object" && raw.properties;
+  if (!isArrayShape) {
+    if (isJsonSchemaShape) push("error", "legacy_json_schema_dialect", "Uses the JSON-Schema dialect ({type:object,properties}); migrate to {settings:[\u2026]}.");
+    else push("error", "not_a_settings_schema", "Missing top-level `settings` array.");
+    return { issues };
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const s of raw.settings) validateRow(s, seen, push);
+  validateRequires(raw.settings, push);
+  if (Array.isArray(raw.blocks)) {
+    for (const b of raw.blocks) {
+      if (b && Array.isArray(b.settings)) {
+        const blockSeen = /* @__PURE__ */ new Set();
+        for (const s of b.settings) validateRow(s, blockSeen, push);
+      }
+    }
+  }
+  return { issues };
+}
+function isCanonical(raw) {
+  return validateSettingsSchema(raw).issues.every((i) => i.level !== "error");
+}
+export {
+  CONTROL_TYPES,
+  SETTING_GROUPS,
+  humanizeId,
+  inferGroup,
+  isCanonical,
+  normalizeSettingsSchema,
+  validateSettingsSchema
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@gemboss/gem-framework",
+  "version": "0.4.0",
+  "description": "gem-framework của GemTheme (CSS, runtime, token, bộ kiểm) cộng đúng bộ kiểm section gemtheme dùng khi duyệt. Build từ gemtheme, không sửa ở đây.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./sections": "./dist/sections.js",
+    "./section-gate": "./dist/section-gate.js",
+    "./settings-schema": "./dist/settings-schema.js",
+    "./gem-framework.css": "./dist/gem-framework.css",
+    "./gem-runtime.js": "./dist/gem-runtime.js",
+    "./SOURCE.json": "./dist/SOURCE.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node build.mjs",
+    "prepack": "node build.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chriskoh26/gemtheme.git",
+    "directory": "dist-packages/gem-framework"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "UNLICENSED",
+  "private": false
+}