@bettercms-ai/types 1.40.0 → 1.41.0

package/dist/index.js

@@ -427,7 +427,27 @@ var COMPONENT_PROP_TYPES = [
   "color",
   "file",
   "icon",
-  "multiselect"
+  "multiselect",
+  // V2 schema language (F1.x). `object` is ONE nested value of named `config.fields`, stored as
+  // `{ [childKey]: value }` like the model field `object`; the six after it store what the
+  // same-named content-model FIELD stores (`location` is the V2 geopoint) and are judged by
+  // that field's validator.
+  "object",
+  "datetime",
+  "slug",
+  "email",
+  "phone",
+  "json",
+  "location",
+  // V2 leaves, each storing what the same-named content-model FIELD stores: a taxonomy string[],
+  // a rating number, a code value (`{ language?, code }` or a string).
+  "tags",
+  "rating",
+  "code",
+  // CMS items, as the same-named content-model FIELDS store them: an entry id (or a polymorphic
+  // `{ entryId, modelSlug }`), and a list of them. Delivery hydrates them like an entry's.
+  "reference",
+  "multi-reference"
 ];
 var SLOT_MAX_ITEMS = 12;
 var SLOT_ITEMS_CAP = 50;
@@ -2688,7 +2708,7 @@ function listItems(f) {
 }
 function zoneFields(f) {
   const c = f.config ?? {};
-  if (f.type === "group") return c.fields ?? f.fields ?? [];
+  if (f.type === "group" || f.type === "object") return c.fields ?? f.fields ?? [];
   if (f.type === "array" && c.zones?.nonRepeatable) return c.zones.nonRepeatable;
   return void 0;
 }
@@ -2927,12 +2947,101 @@ function buttonLinkPairs(candidates) {
 
 // src/button-look.ts
 import { ICON_MARKUP, iconSvg } from "@bettercms-ai/icons/markup";
+
+// src/link-value.ts
+var LINK_RELS = ["nofollow", "sponsored", "ugc"];
+var LINK_VALUE_TYPES = ["url", "page", "entry", "email", "phone", "anchor", "section", "file"];
+var isPlainObject = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+function isLinkObject(value) {
+  return isPlainObject(value) && typeof value.href === "string";
+}
+function linkHref(value) {
+  if (typeof value === "string") return value;
+  return isLinkObject(value) ? value.href : null;
+}
+function linkRefOf(value) {
+  if (!isLinkObject(value) || value.type !== "page" && value.type !== "entry") return null;
+  const id = value.ref ?? (value.type === "page" ? value.pageId : value.entryId);
+  return typeof id === "string" && id.length > 0 ? { kind: value.type, id } : null;
+}
+var isScriptHref = (href) => /^(javascript|data|vbscript):/i.test(href.replace(/[\u0000- \u007F]/g, ""));
+var newTabOf = (v) => v.newTab === true || v.newTab === void 0 && v.target === "_blank";
+function linkValueProblem(value) {
+  if (!isPlainObject(value)) return "link_value_invalid: must be an href string or a link object { type, href, \u2026 }";
+  const v = value;
+  if (typeof v.href !== "string") return "link_value_invalid: needs an href string";
+  if (isScriptHref(v.href)) return "link_value_invalid: script links (javascript:, data:, vbscript:) aren't allowed";
+  if (v.type !== void 0 && !LINK_VALUE_TYPES.includes(v.type)) {
+    return `link_value_invalid: unknown type "${String(v.type)}" (${LINK_VALUE_TYPES.join(", ")})`;
+  }
+  for (const key of ["title", "section", "ref"]) {
+    if (v[key] !== void 0 && typeof v[key] !== "string") return `link_value_invalid: ${key} must be a string`;
+  }
+  if (v.ref !== void 0 && v.type !== "page" && v.type !== "entry") return "link_value_invalid: ref is the target of a page or entry link";
+  if (v.newTab !== void 0 && typeof v.newTab !== "boolean") return "link_value_invalid: newTab must be true or false";
+  if (v.target !== void 0 && v.target !== "_self" && v.target !== "_blank") return 'link_value_invalid: target must be "_self" or "_blank"';
+  if (typeof v.newTab === "boolean" && v.target !== void 0 && v.newTab !== (v.target === "_blank")) {
+    return "link_value_invalid: newTab and target disagree";
+  }
+  if (v.rel !== void 0 && !LINK_RELS.includes(v.rel)) {
+    return `link_value_invalid: unknown rel "${String(v.rel)}" (nofollow, sponsored or ugc)`;
+  }
+  return null;
+}
+function normalizeLinkValue(value) {
+  if (!isLinkObject(value)) return value;
+  const out = { ...value };
+  delete out.resolved;
+  if (out.rel === "follow") delete out.rel;
+  if (out.newTab === void 0 && out.target !== void 0) out.newTab = out.target === "_blank";
+  const ref = linkRefOf(out);
+  if (ref && out.ref === void 0) out.ref = ref.id;
+  return out;
+}
+function linkAnchorOf(value) {
+  if (typeof value === "string") return { href: value, newTab: false };
+  if (!isLinkObject(value)) return null;
+  return {
+    href: value.href,
+    newTab: newTabOf(value),
+    ...LINK_RELS.includes(value.rel) ? { rel: value.rel } : {}
+  };
+}
+
+// src/button-look.ts
 var BUTTON_VARIANTS = ["primary", "secondary", "tertiary", "brand", "dark", "light", "outline", "link"];
 var BUTTON_ICONS = ICON_MARKUP;
 var BUTTON_ICON_NAMES = DOCK_ICON_NAMES;
 function buttonVariantOf(value) {
   return BUTTON_VARIANTS.includes(value) ? value : "primary";
 }
+var SITE_CLASS = /^[^\s"'<>`=]{1,64}$/;
+var LOOK_VALUE = /^[a-z0-9][a-z0-9-]{0,63}$/;
+function buttonSiteLookOf(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const v = value;
+  const tokens = (list) => Array.isArray(list) ? list.filter((c) => typeof c === "string" && SITE_CLASS.test(c)) : [];
+  const variant = v.attrs?.["data-variant"];
+  const classes = tokens(v.classes);
+  const also = tokens(v.also);
+  const size = tokens(v.size);
+  const sizeAlso = tokens(v.sizeAlso);
+  const attrs = typeof variant === "string" && LOOK_VALUE.test(variant) ? { "data-variant": variant } : void 0;
+  if (classes.length === 0 && !attrs) return null;
+  return {
+    classes,
+    ...attrs ? { attrs } : {},
+    ...also.length ? { also } : {},
+    ...size.length ? { size } : {},
+    ...sizeAlso.length ? { sizeAlso } : {}
+  };
+}
+function buttonLookValue(slug, siteLook) {
+  return siteLook?.attrs?.["data-variant"] ?? slug;
+}
+function isButtonLookValue(value) {
+  return typeof value === "string" && LOOK_VALUE.test(value);
+}
 function buttonIconOf(value) {
   return typeof value === "string" && DOCK_ICON_NAME_SET.has(value) ? value : null;
 }
@@ -2940,14 +3049,15 @@ function buttonIconSvg(name, cls) {
   return iconSvg(name, cls);
 }
 var BUTTON_SIZES = ["sm", "md", "lg"];
-var LINK_RELS = ["nofollow", "sponsored", "ugc"];
 function anchorTargetRel(newTab, rel) {
   const tokens = [...newTab ? ["noopener", "noreferrer"] : [], ...LINK_RELS.includes(rel) ? [rel] : []];
   return `${newTab ? ' target="_blank"' : ""}${tokens.length ? ` rel="${tokens.join(" ")}"` : ""}`;
 }
-var hrefOf = (href) => typeof href === "string" ? href : href && typeof href === "object" && typeof href.href === "string" ? href.href : null;
+var hrefOf = linkHref;
 function readButtonValue(value) {
   const v = value && typeof value === "object" ? value : {};
+  const link = isLinkObject(v.href) ? linkAnchorOf(v.href) : null;
+  const rel = v.rel ?? link?.rel;
   return {
     label: typeof v.label === "string" ? v.label : "",
     href: hrefOf(v.href) ?? "",
@@ -2955,16 +3065,22 @@ function readButtonValue(value) {
     size: BUTTON_SIZES.includes(v.size) ? v.size : "md",
     arrow: v.arrow === true,
     icon: buttonIconOf(v.icon),
-    newTab: v.newTab === true,
-    ...LINK_RELS.includes(v.rel) ? { rel: v.rel } : {}
+    newTab: v.newTab === void 0 ? link?.newTab === true : v.newTab === true,
+    ...LINK_RELS.includes(rel) ? { rel } : {}
   };
 }
-function buttonValueProblem(value) {
+function buttonValueProblem(value, looks) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return "must be a { label, href } button";
   const v = value;
   if (typeof v.label !== "string") return "needs a label";
   if (hrefOf(v.href) === null) return "needs an href";
-  if (v.variant !== void 0 && !BUTTON_VARIANTS.includes(v.variant)) return `has an unknown variant "${String(v.variant)}"`;
+  if (isLinkObject(v.href)) {
+    const problem = linkValueProblem(v.href);
+    if (problem) return `href ${problem}`;
+  }
+  if (v.variant !== void 0 && !BUTTON_VARIANTS.includes(v.variant) && !(typeof v.variant === "string" && looks?.has(v.variant))) {
+    return `has an unknown variant "${String(v.variant)}"${looks?.size ? ` (this project's looks: ${[...looks].join(", ")})` : ""}`;
+  }
   if (v.size !== void 0 && !BUTTON_SIZES.includes(v.size)) return `has an unknown size "${String(v.size)}"`;
   if (v.arrow !== void 0 && typeof v.arrow !== "boolean") return "arrow must be true or false";
   if (v.newTab !== void 0 && typeof v.newTab !== "boolean") return "newTab must be true or false";
@@ -2979,7 +3095,14 @@ function buttonBlockProps(value) {
   const out = {};
   if (typeof v.label === "string") out.text = v.label;
   const href = hrefOf(v.href);
-  if (href !== null) out.href = href;
+  const script = href !== null && isScriptHref(href);
+  if (href !== null) out.href = script ? "#" : href;
+  if (isLinkObject(v.href) && !script) {
+    const link = linkAnchorOf(v.href);
+    out.newTab = link.newTab;
+    out.rel = link.rel;
+  }
+  if (v.rel !== void 0) out.rel = v.rel;
   for (const key of BUTTON_LOOK_KEYS) if (key in v) out[key] = v[key];
   return out;
 }
@@ -3032,6 +3155,9 @@ function buttonValueOfInstance(def, overrides) {
   return readButtonValue({ ...props, label: props.text });
 }
 
+// src/content-model.ts
+var OPTION_DESCRIPTION_MAX = 140;
+
 // src/locator.ts
 var LANDMARK_SELECTOR = "header,nav,footer";
 var LANDMARK_TAGS = /* @__PURE__ */ new Set(["HEADER", "NAV", "FOOTER"]);
@@ -3113,8 +3239,10 @@ export {
   LAYOUT_SECTION_ICONS,
   LAYOUT_SECTION_ICON_SET,
   LINK_RELS,
+  LINK_VALUE_TYPES,
   MAIN_SELECTOR,
   NAVIGATION_SECTION_ID,
+  OPTION_DESCRIPTION_MAX,
   PAGE_CONTENT_ANCHOR_ID,
   RESPONSIVE_CSS,
   SECTION_DOCTRINE,
@@ -3131,6 +3259,8 @@ export {
   buttonIconOf,
   buttonIconSvg,
   buttonLinkPairs,
+  buttonLookValue,
+  buttonSiteLookOf,
   buttonValueOfInstance,
   buttonValueProblem,
   buttonVariantOf,
@@ -3149,10 +3279,18 @@ export {
   hideOnAttr,
   inWindow,
   isBlock,
+  isButtonLookValue,
   isChromeLandmark,
+  isLinkObject,
+  isScriptHref,
   keyWords,
   landmarkRegions,
+  linkAnchorOf,
+  linkHref,
+  linkRefOf,
+  linkValueProblem,
   locatorFor,
+  normalizeLinkValue,
   normalizeWindow,
   parsePropsAttribute,
   pickFieldStyle,