@bettercms-ai/types 1.24.0 → 1.25.0

package/dist/index.js

@@ -2156,6 +2156,451 @@ 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/locator.ts
 var LANDMARK_SELECTOR = "header,nav,footer";
 var LANDMARK_TAGS = /* @__PURE__ */ new Set(["HEADER", "NAV", "FOOTER"]);
@@ -2220,6 +2665,9 @@ export {
   BLOCK_BINDINGS,
   COMPONENT_PROP_TYPES,
   DIALOG_SELECTOR,
+  DOCK_BUDGET,
+  DOCK_ICON_NAMES,
+  DOCK_ICON_NAME_SET,
   FOOTER_SECTION_ID,
   LANDMARK_SELECTOR,
   LAYOUT_SECTION_ICONS,
@@ -2232,13 +2680,18 @@ export {
   SPACE_BOTTOM_TOKENS,
   SPACE_STEP_TOKENS,
   blockStyleToCss,
+  buttonLinkPairs,
+  candidateRole,
   componentInstanceAddresses,
   componentPropTargetKey,
+  dockBudget,
+  dockScreens,
   expandBlockBindings,
   formatPropsAttribute,
   getBlockType,
   isBlock,
   isChromeLandmark,
+  keyWords,
   landmarkRegions,
   locatorFor,
   parsePropsAttribute,