@gemboss/gem-framework 0.16.1 → 0.18.13

package/dist/settings-schema.js

@@ -11,12 +11,15 @@ var CONTROL_TYPES = Object.freeze([
   "range",
   "color",
   "color_scheme",
+  // the dialect's word for a scheme picker; validateColorScheme requires it stored as a select (normalize converts)
   "image_picker",
   "video",
   "url",
   "link_list",
   "collection",
   "product",
+  "datetime",
+  // a moment with its offset, stored as ISO 8601 (2026-12-31T23:59:00+07:00); the panel draws a date-time picker
   "edges",
   // 4-side spacing box, value = {t,r,b,l}
   "repeater",
@@ -24,6 +27,28 @@ var CONTROL_TYPES = Object.freeze([
   "header"
   // non-input group label
 ]);
+var RENDERED_COLOR_SCHEMES = Object.freeze([
+  "default",
+  "scheme-1",
+  "surface",
+  "accent",
+  "inverse",
+  "scheme-2",
+  "scheme-3",
+  "scheme-4",
+  "scheme-5"
+]);
+var RENDERED_COLOR_SCHEME_SET = new Set(RENDERED_COLOR_SCHEMES);
+var COLOR_SCHEME_OPTIONS = Object.freeze([
+  { value: "default", label: "Default" },
+  { value: "surface", label: "Surface" },
+  { value: "accent", label: "Accent" },
+  { value: "inverse", label: "Inverse" },
+  { value: "scheme-2", label: "Scheme 2" },
+  { value: "scheme-3", label: "Scheme 3" },
+  { value: "scheme-4", label: "Scheme 4" },
+  { value: "scheme-5", label: "Scheme 5" }
+].map((o) => Object.freeze(o)));
 var SETTING_GROUPS = Object.freeze(["content", "options", "design", "advanced"]);
 var CONTROL_TYPE_SET = new Set(CONTROL_TYPES);
 var GROUP_SET = new Set(SETTING_GROUPS);
@@ -32,6 +57,7 @@ var ADVANCED_ID_RE = /(^|_)(visibility|custom_css|custom_html|custom_class|class
 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",
+  "datetime",
   "textarea",
   "richtext",
   "inline_richtext",
@@ -119,16 +145,20 @@ function normalizeSetting(s = {}) {
   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));
+  let type = resolveType(s, Boolean(options));
+  const schemeChoice = (type === "color_scheme" || id === "color_scheme") && !(options && options.length && options.every((o) => o && RENDERED_COLOR_SCHEME_SET.has(o.value)));
+  if (schemeChoice) type = "select";
   const out = {
     id,
     type,
-    group: inferGroup({ ...s, type }),
+    group: inferGroup({ ...s, type: schemeChoice ? "color_scheme" : 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 (schemeChoice) out.default = RENDERED_COLOR_SCHEME_SET.has(s.default) && s.default !== "scheme-1" ? s.default : "default";
+  else if (s.default !== void 0) out.default = s.default;
+  if (schemeChoice) out.options = COLOR_SCHEME_OPTIONS.map((o) => ({ ...o }));
+  else 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;
@@ -195,14 +225,30 @@ function validateRow(s, seen, push) {
   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.type === "select" || s.type === "radio") && !(Array.isArray(s.options) && s.options.length))
+    push("error", "choice_without_options", `Setting "${s.id}" (${s.type}) has no \`options\`.`, s.id);
+  if (s.type === "range" && !(Number.isFinite(s.min) && Number.isFinite(s.max)))
+    push("error", "range_without_bounds", `Setting "${s.id}" (range) needs numeric \`min\` and \`max\`.`, s.id);
+  if (s.id === "color_scheme" || s.type === "color_scheme") validateColorScheme(s, push);
   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);
+    const scalar = (v) => ["string", "number", "boolean"].includes(typeof v);
+    const ok = r && typeof r === "object" && typeof r.key === "string" && r.key && ("equals" in r && scalar(r.equals) || r.set === true || Array.isArray(r.in) && r.in.length > 0 && r.in.every(scalar));
+    if (!ok) push("error", "invalid_requires", `Setting "${s.id}" has a malformed \`requires\` (want {key, equals}, {key, in: [...]} or {key, set: true}).`, s.id);
   }
 }
+function validateColorScheme(s, push) {
+  const options = Array.isArray(s.options) ? s.options : [];
+  if (s.type !== "select" || !options.length) {
+    push("error", "color_scheme_not_a_choice", `Setting "${s.id}" must be a select over the rendered schemes (${RENDERED_COLOR_SCHEMES.join(", ")}), not type "${s.type}".`, s.id);
+    return;
+  }
+  const unknown = options.map((o) => o && o.value).filter((v) => !RENDERED_COLOR_SCHEME_SET.has(v));
+  if (unknown.length)
+    push("error", "color_scheme_unrendered_option", `Setting "${s.id}" offers ${unknown.map((v) => `"${v}"`).join(", ")}, which no store draws.`, s.id);
+  if (s.default !== void 0 && !options.some((o) => o && o.value === s.default))
+    push("error", "color_scheme_default_not_offered", `Setting "${s.id}" defaults to "${s.default}", which is not one of its options.`, 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) {
@@ -215,6 +261,20 @@ function validateRequires(rows, push) {
     }
     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);
+    if (Array.isArray(r.in) && r.in.every((v) => ["string", "number", "boolean"].includes(typeof v)) && Array.isArray(gate.options)) {
+      for (const v of r.in) if (!gate.options.some((o) => o && String(o.value) === String(v)))
+        push("error", "requires_unknown_value", `Setting "${s.id}" requires ${r.key} in [${r.in.join(", ")}], and "${v}" is not one of its options.`, s.id);
+    }
+  }
+  for (const s of rows) {
+    const seenKeys = /* @__PURE__ */ new Set();
+    for (let at = s; at && at.requires && typeof at.requires.key === "string"; at = byId.get(at.requires.key)) {
+      if (seenKeys.has(at.id)) {
+        push("error", "requires_cycle", `Setting "${s.id}" is gated in a cycle (${[...seenKeys].join(" \u2192 ")} \u2192 ${at.id}): no value ever shows it.`, s.id);
+        break;
+      }
+      seenKeys.add(at.id);
+    }
   }
 }
 function validateSettingsSchema(raw) {
@@ -244,7 +304,9 @@ function isCanonical(raw) {
   return validateSettingsSchema(raw).issues.every((i) => i.level !== "error");
 }
 export {
+  COLOR_SCHEME_OPTIONS,
   CONTROL_TYPES,
+  RENDERED_COLOR_SCHEMES,
   SETTING_GROUPS,
   humanizeId,
   inferGroup,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gemboss/gem-framework",
-  "version": "0.16.1",
+  "version": "0.18.13",
   "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",