@bettercms-ai/types 1.24.0 → 1.26.0

package/dist/index.js

@@ -2156,6 +2156,482 @@ var PAGE_CONTENT_ANCHOR_ID = "page-content";
 var NAVIGATION_SECTION_ID = "navigation";
 var FOOTER_SECTION_ID = "footer";
 
+// src/dock-icon-names.ts
+var DOCK_ICON_NAMES = [
+  "access-denied",
+  "activity",
+  "add",
+  "add-circle",
+  "add-comment",
+  "add-document",
+  "add-user",
+  "api",
+  "archive",
+  "arrow-down",
+  "arrow-left",
+  "arrow-right",
+  "arrow-top-right",
+  "arrow-up",
+  "asterisk",
+  "bar-chart",
+  "basket",
+  "bell",
+  "bill",
+  "binary-document",
+  "block-content",
+  "block-element",
+  "blockquote",
+  "bold",
+  "bolt",
+  "book",
+  "bookmark",
+  "bookmark-filled",
+  "bottle",
+  "bug",
+  "bulb-filled",
+  "bulb-outline",
+  "calendar",
+  "case",
+  "chart-upward",
+  "checkmark",
+  "checkmark-circle",
+  "chevron-down",
+  "chevron-left",
+  "chevron-right",
+  "chevron-up",
+  "circle",
+  "clipboard",
+  "clipboard-image",
+  "clock",
+  "close",
+  "close-circle",
+  "code",
+  "code-block",
+  "cog",
+  "collapse",
+  "color-wheel",
+  "comment",
+  "component",
+  "compose",
+  "compose-sparkles",
+  "confetti",
+  "controls",
+  "copy",
+  "credit-card",
+  "crop",
+  "cube",
+  "dashboard",
+  "database",
+  "desktop",
+  "diamond",
+  "document",
+  "document-pdf",
+  "document-remove",
+  "document-sheet",
+  "document-text",
+  "document-video",
+  "document-word",
+  "document-zip",
+  "documents",
+  "dot",
+  "double-chevron-down",
+  "double-chevron-left",
+  "double-chevron-right",
+  "double-chevron-up",
+  "double-quote",
+  "download",
+  "drag-handle",
+  "drop",
+  "earth-americas",
+  "earth-globe",
+  "edit",
+  "ellipsis-horizontal",
+  "ellipsis-vertical",
+  "empty",
+  "enter",
+  "enter-right",
+  "envelope",
+  "equal",
+  "error-filled",
+  "error-outline",
+  "error-screen",
+  "expand",
+  "eye-closed",
+  "eye-open",
+  "face-happy",
+  "face-indifferent",
+  "face-sad",
+  "feedback",
+  "filter",
+  "folder",
+  "generate",
+  "github",
+  "groq",
+  "hash",
+  "heart",
+  "heart-filled",
+  "help-circle",
+  "highlight",
+  "home",
+  "ice-cream",
+  "image",
+  "image-remove",
+  "images",
+  "inbox",
+  "info-filled",
+  "info-outline",
+  "inline",
+  "inline-element",
+  "insert-above",
+  "insert-below",
+  "italic",
+  "joystick",
+  "json",
+  "launch",
+  "leave",
+  "lemon",
+  "link",
+  "link-removed",
+  "linkedin",
+  "list",
+  "lock",
+  "logo-js",
+  "logo-ts",
+  "marker",
+  "marker-removed",
+  "master-detail",
+  "menu",
+  "microphone",
+  "microphone-slash",
+  "mobile-device",
+  "moon",
+  "number",
+  "ok-hand",
+  "olist",
+  "overage",
+  "package",
+  "panel-left",
+  "panel-right",
+  "pause",
+  "pin",
+  "pin-filled",
+  "pin-removed",
+  "play",
+  "plug",
+  "presentation",
+  "progress-50",
+  "progress-75",
+  "projects",
+  "publish",
+  "read-only",
+  "redo",
+  "refresh",
+  "remove",
+  "remove-circle",
+  "reset",
+  "restore",
+  "retrieve",
+  "retry",
+  "revert",
+  "robot",
+  "rocket",
+  "schema",
+  "search",
+  "select",
+  "share",
+  "sort",
+  "sparkle",
+  "sparkles",
+  "spinner",
+  "split-horizontal",
+  "split-vertical",
+  "square",
+  "stack",
+  "stack-compact",
+  "star",
+  "star-filled",
+  "stop",
+  "strikethrough",
+  "string",
+  "sun",
+  "sync",
+  "tablet-device",
+  "tag",
+  "tags",
+  "target",
+  "task",
+  "terminal",
+  "text",
+  "th-large",
+  "th-list",
+  "thumbs-down",
+  "thumbs-up",
+  "tiers",
+  "timeline",
+  "toggle-arrow-right",
+  "token",
+  "transfer",
+  "translate",
+  "trash",
+  "trend-upward",
+  "triangle-outline",
+  "trolley",
+  "truncate",
+  "twitter",
+  "ulist",
+  "unarchive",
+  "underline",
+  "undo",
+  "unknown",
+  "unlink",
+  "unlock",
+  "unpublish",
+  "upload",
+  "user",
+  "users",
+  "versions",
+  "video",
+  "warning-filled",
+  "warning-outline",
+  "wrench"
+];
+var DOCK_ICON_NAME_SET = new Set(DOCK_ICON_NAMES);
+
+// src/dock-budget.ts
+var DOCK_BUDGET = { ungrouped: 8, group: 12, depth: 3, activations: 2 };
+function listItems(f) {
+  const c = f.config ?? {};
+  if (f.type === "repeater") return f.fields ?? [];
+  if (f.type === "table") return c.fields ?? f.fields ?? [];
+  if (f.type === "array" && c.zones?.repeatable) return c.zones.repeatable.fields ?? [];
+  if (f.type === "modular") return null;
+  return void 0;
+}
+function zoneFields(f) {
+  const c = f.config ?? {};
+  if (f.type === "group") return c.fields ?? f.fields ?? [];
+  if (f.type === "array" && c.zones?.nonRepeatable) return c.zones.nonRepeatable;
+  return void 0;
+}
+function layout(fields, fieldsets, root) {
+  const byId = new Map(fieldsets.map((s) => [s.id, s]));
+  const tabIds = root ? fieldsets.filter((s) => s.kind === "tab").map((s) => s.id) : [];
+  const tabOf = (s) => s?.kind === "tab" ? s.id : s?.tab !== void 0 && byId.get(s.tab)?.kind === "tab" ? s.tab : void 0;
+  const nonEmpty = new Set(
+    fields.map((f) => tabOf(byId.get(f.fieldsetId ?? ""))).filter((t) => t && tabIds.includes(t))
+  );
+  const strip = nonEmpty.size >= 2;
+  const branches = /* @__PURE__ */ new Map();
+  const nodeFor = (f, path) => {
+    const key = `${path}${f.key}`;
+    const zone = zoneFields(f);
+    if (zone) {
+      return { kind: "group", id: key, collapsed: f.ui?.collapsed === true, nodes: zone.map((z) => nodeFor(z, `${key}.`)) };
+    }
+    const items = listItems(f);
+    if (items !== void 0) {
+      branches.set(key, { key, field: f, items });
+      return { kind: "branch", key };
+    }
+    return { kind: "leaf", key };
+  };
+  const pinned = [];
+  const panels = new Map(strip ? tabIds.filter((t) => nonEmpty.has(t)).map((t) => [t, []]) : []);
+  const containers = /* @__PURE__ */ new Map();
+  for (const f of fields) {
+    const node = nodeFor(f, "");
+    const set = byId.get(f.fieldsetId ?? "");
+    const target = strip && panels.get(tabOf(set) ?? "") || pinned;
+    if (set?.kind !== "group" && set?.kind !== "row") {
+      target.push(node);
+      continue;
+    }
+    let box = containers.get(set.id);
+    if (!box) {
+      box = set.kind === "row" ? { kind: "row", id: set.id, keys: [] } : { kind: "group", id: set.id, collapsed: set.collapsed === true, nodes: [] };
+      containers.set(set.id, box);
+      target.push(box);
+    }
+    if (box.kind === "row") box.keys.push(f.key);
+    else if (box.kind === "group") box.nodes.push(node);
+  }
+  return { pinned, tabs: [...panels.values()], branches };
+}
+function walkCosts(screen) {
+  const values = [];
+  const branchCost = /* @__PURE__ */ new Map();
+  const walk = (nodes, cost) => {
+    for (const n of nodes) {
+      if (n.kind === "group") walk(n.nodes, cost + (n.collapsed ? 1 : 0));
+      else if (n.kind === "branch") branchCost.set(n.key, cost);
+      else values.push(cost);
+    }
+  };
+  walk(screen.pinned, 0);
+  screen.tabs.forEach((panel, i) => walk(panel, i === 0 ? 0 : 1));
+  return { values, branchCost };
+}
+function dockScreens(source, lane, props) {
+  let fields = source.fields ?? [];
+  let fieldsets = source.fieldsets ?? [];
+  if (props) {
+    fieldsets = [];
+    fields = props.map((p) => {
+      const g = p.ui?.group;
+      if (!g) return p;
+      if (!fieldsets.some((s) => s.id === g.id)) {
+        fieldsets.push({ id: g.id, name: g.label, kind: g.kind ?? "group", collapsed: g.collapsed });
+      }
+      return { ...p, fieldsetId: g.id };
+    });
+  }
+  const screens = [];
+  const open = (id, kind, title, depth, entry, level) => {
+    const laid = level ? layout(level, fieldsets, kind === "root") : null;
+    const screen = {
+      id,
+      lane,
+      kind,
+      title,
+      depth,
+      entry,
+      pinned: laid?.pinned ?? [],
+      tabs: laid?.tabs ?? []
+    };
+    screens.push(screen);
+    if (!laid) return;
+    const { branchCost } = walkCosts(screen);
+    for (const b of laid.branches.values()) {
+      const listId = `${id}/${b.key}`;
+      const listEntry = entry + (branchCost.get(b.key) ?? 0) + 1;
+      const label = b.field.label ?? b.field.key;
+      open(listId, "list", label, depth + 1, listEntry, null);
+      if (b.items) open(`${listId}/item`, "item", `${label} item`, depth + 2, listEntry + 1, b.items);
+    }
+  };
+  open(lane, "root", lane === "component" ? "Component" : lane === "page-fields" ? "Page fields" : "Section", 0, 0, fields);
+  return screens;
+}
+function dockBudget(screen) {
+  const rows = (nodes) => nodes.filter((n) => n.kind !== "group").length;
+  let maxGroupLeaves = 0;
+  const groups = (nodes) => {
+    for (const n of nodes) {
+      if (n.kind !== "group") continue;
+      maxGroupLeaves = Math.max(maxGroupLeaves, rows(n.nodes));
+      groups(n.nodes);
+    }
+  };
+  groups(screen.pinned);
+  screen.tabs.forEach(groups);
+  const pinned = rows(screen.pinned);
+  const { values } = walkCosts(screen);
+  return {
+    ungroupedLeaves: screen.tabs.length ? Math.max(...screen.tabs.map((p) => pinned + rows(p))) : pinned,
+    maxGroupLeaves,
+    depth: screen.depth,
+    maxActivations: screen.entry + (values.length ? Math.max(...values) : 0)
+  };
+}
+
+// src/button-link-pairing.ts
+var TEXT_ROLES = /* @__PURE__ */ new Set(["label", "text", "title", "cta", "button", "btn", "name"]);
+var LINK_ROLES = /* @__PURE__ */ new Set(["href", "link", "url", "to"]);
+var BUTTON_NOUNS = /* @__PURE__ */ new Set(["cta", "button", "btn"]);
+var TEXT_TYPES = /* @__PURE__ */ new Set(["text", "string"]);
+var LINK_TYPES = /* @__PURE__ */ new Set(["link", "url"]);
+var MEDIA = /image|img|photo|video|avatar|logo|icon|thumb|poster|embed|src|og|favicon/i;
+function keyWords(key) {
+  const leaf = key.split(".").pop() ?? "";
+  return leaf.replace(/([a-z\d])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").split(/[\s_-]+/).filter(Boolean).map((word) => word.toLowerCase());
+}
+function roleFromWords(candidate, words) {
+  const type = (candidate.type ?? "").toLowerCase();
+  const value = candidate.value;
+  if (!(value === void 0 || value === null || typeof value === "string")) return null;
+  if (!words.length) return null;
+  const last = words[words.length - 1];
+  const stem = words.slice(0, -1).join("_");
+  const full = words.join("_");
+  if (LINK_TYPES.has(type)) return { role: "link", stems: LINK_ROLES.has(last) ? [stem] : [stem, full] };
+  if (!TEXT_TYPES.has(type)) return null;
+  if (LINK_ROLES.has(last)) {
+    if (MEDIA.test(candidate.key) || MEDIA.test(candidate.label ?? "")) return null;
+    return { role: "link", stems: [stem] };
+  }
+  if (TEXT_ROLES.has(last)) return { role: "text", stems: BUTTON_NOUNS.has(last) ? [stem, full] : [stem] };
+  return null;
+}
+function candidateRole(candidate) {
+  const fromKey = roleFromWords(candidate, keyWords(candidate.key));
+  if (fromKey) return fromKey;
+  const label = candidate.label?.trim();
+  if (!label) return null;
+  const fromLabel = roleFromWords(candidate, keyWords(label.replace(/\s+/g, "_")));
+  return fromLabel ? { role: fromLabel.role, stems: fromLabel.stems.map((stem) => `label:${stem}`) } : null;
+}
+function buttonLinkPairs(candidates) {
+  const roles = candidates.map(candidateRole);
+  const byStem = /* @__PURE__ */ new Map();
+  roles.forEach((role, index) => {
+    if (!role) return;
+    for (const stem of new Set(role.stems)) {
+      const bucket = byStem.get(stem) ?? { text: /* @__PURE__ */ new Set(), link: /* @__PURE__ */ new Set() };
+      bucket[role.role].add(index);
+      byStem.set(stem, bucket);
+    }
+  });
+  const ambiguous = /* @__PURE__ */ new Set();
+  const proposals = /* @__PURE__ */ new Map();
+  for (const bucket of byStem.values()) {
+    if (bucket.text.size + bucket.link.size >= 3) {
+      for (const index of [...bucket.text, ...bucket.link]) ambiguous.add(index);
+      continue;
+    }
+    if (bucket.text.size === 1 && bucket.link.size === 1) {
+      const pair = [[...bucket.text][0], [...bucket.link][0]];
+      proposals.set(pair.join(":"), pair);
+    }
+  }
+  const uses = /* @__PURE__ */ new Map();
+  for (const [text, link] of proposals.values()) {
+    uses.set(text, (uses.get(text) ?? 0) + 1);
+    uses.set(link, (uses.get(link) ?? 0) + 1);
+  }
+  return [...proposals.values()].filter(([t, l]) => !ambiguous.has(t) && !ambiguous.has(l) && uses.get(t) === 1 && uses.get(l) === 1).sort((a, b) => Math.min(...a) - Math.min(...b));
+}
+
+// src/button-look.ts
+var BUTTON_VARIANTS = ["primary", "secondary", "tertiary", "brand", "dark", "light", "outline", "link"];
+var BUTTON_ICONS = {
+  "arrow-right": '<path d="M5 12h14"/><path d="m12 5 7 7-7 7"/>',
+  "arrow-up-right": '<path d="M7 7h10v10"/><path d="M7 17 17 7"/>',
+  "chevron-right": '<path d="m9 18 6-6-6-6"/>',
+  plus: '<path d="M5 12h14"/><path d="M12 5v14"/>',
+  check: '<path d="M20 6 9 17l-5-5"/>',
+  download: '<path d="M12 15V3"/><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="m7 10 5 5 5-5"/>',
+  "external-link": '<path d="M15 3h6v6"/><path d="M10 14 21 3"/><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/>',
+  mail: '<path d="m22 7-8.991 5.727a2 2 0 0 1-2.009 0L2 7"/><rect x="2" y="4" width="20" height="16" rx="2"/>',
+  phone: '<path d="M13.832 16.568a1 1 0 0 0 1.213-.303l.355-.465A2 2 0 0 1 17 15h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2A18 18 0 0 1 2 4a2 2 0 0 1 2-2h3a2 2 0 0 1 2 2v3a2 2 0 0 1-.8 1.6l-.468.351a1 1 0 0 0-.292 1.233 14 14 0 0 0 6.392 6.384"/>',
+  calendar: '<path d="M8 2v4"/><path d="M16 2v4"/><rect width="18" height="18" x="3" y="4" rx="2"/><path d="M3 10h18"/>',
+  play: '<path d="M5 5a2 2 0 0 1 3.008-1.728l11.997 6.998a2 2 0 0 1 .003 3.458l-12 7A2 2 0 0 1 5 19z"/>',
+  search: '<path d="m21 21-4.34-4.34"/><circle cx="11" cy="11" r="8"/>',
+  "shopping-cart": '<circle cx="8" cy="21" r="1"/><circle cx="19" cy="21" r="1"/><path d="M2.05 2.05h2l2.66 12.42a2 2 0 0 0 2 1.58h9.78a2 2 0 0 0 1.95-1.57l1.65-7.43H5.12"/>',
+  star: '<path d="M11.525 2.295a.53.53 0 0 1 .95 0l2.31 4.679a2.123 2.123 0 0 0 1.595 1.16l5.166.756a.53.53 0 0 1 .294.904l-3.736 3.638a2.123 2.123 0 0 0-.611 1.878l.882 5.14a.53.53 0 0 1-.771.56l-4.618-2.428a2.122 2.122 0 0 0-1.973 0L6.396 21.01a.53.53 0 0 1-.77-.56l.881-5.139a2.122 2.122 0 0 0-.611-1.879L2.16 9.795a.53.53 0 0 1 .294-.906l5.165-.755a2.122 2.122 0 0 0 1.597-1.16z"/>',
+  sparkles: '<path d="M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z"/><path d="M20 2v4"/><path d="M22 4h-4"/><circle cx="4" cy="20" r="2"/>',
+  zap: '<path d="M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z"/>'
+};
+var BUTTON_ICON_NAMES = Object.keys(BUTTON_ICONS);
+function buttonVariantOf(value) {
+  return BUTTON_VARIANTS.includes(value) ? value : "primary";
+}
+function buttonIconOf(value) {
+  return BUTTON_ICON_NAMES.includes(value) ? value : null;
+}
+function buttonIconSvg(name, cls) {
+  return `<svg class="${cls}" viewBox="0 0 24 24" width="1em" height="1em" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">${BUTTON_ICONS[name]}</svg>`;
+}
+
 // src/locator.ts
 var LANDMARK_SELECTOR = "header,nav,footer";
 var LANDMARK_TAGS = /* @__PURE__ */ new Set(["HEADER", "NAV", "FOOTER"]);
@@ -2218,8 +2694,14 @@ function regionOf(regions, el) {
 }
 export {
   BLOCK_BINDINGS,
+  BUTTON_ICONS,
+  BUTTON_ICON_NAMES,
+  BUTTON_VARIANTS,
   COMPONENT_PROP_TYPES,
   DIALOG_SELECTOR,
+  DOCK_BUDGET,
+  DOCK_ICON_NAMES,
+  DOCK_ICON_NAME_SET,
   FOOTER_SECTION_ID,
   LANDMARK_SELECTOR,
   LAYOUT_SECTION_ICONS,
@@ -2232,13 +2714,21 @@ export {
   SPACE_BOTTOM_TOKENS,
   SPACE_STEP_TOKENS,
   blockStyleToCss,
+  buttonIconOf,
+  buttonIconSvg,
+  buttonLinkPairs,
+  buttonVariantOf,
+  candidateRole,
   componentInstanceAddresses,
   componentPropTargetKey,
+  dockBudget,
+  dockScreens,
   expandBlockBindings,
   formatPropsAttribute,
   getBlockType,
   isBlock,
   isChromeLandmark,
+  keyWords,
   landmarkRegions,
   locatorFor,
   parsePropsAttribute,