@bridge-ds/mcp 0.3.2 → 0.4.0

package/dist/{chunk-X455XY4E.js → chunk-7DBLDJIL.js}

@@ -391,6 +391,7 @@ var TeamDirectory = class {
 var OWNER_GROUPS = ["design", "tech"];
 var RIGHTS = ["approveDesign", "approveTech", "ship"];
 var DEFAULT_RIGHTS = { approveDesign: ["design"], approveTech: ["tech"], ship: ["tech"] };
+var norm2 = (x) => x.trim().toLowerCase().replace(/^@/, "");
 var uniq = (xs) => [...new Set(xs)];
 function normalizeRights(input) {
   const pick = (r) => {
@@ -426,6 +427,16 @@ function shipPolicy(owners, rights, teams) {
   const logins = expandEntries(entries, teams);
   return { logins, groups: [...rights.ship], entries, ...teams ? { teams } : {} };
 }
+function unreadableShipTeams(policy) {
+  if (!policy?.teams) return [];
+  const keys = new Set((policy.entries ?? []).map((e) => e.trim().toLowerCase().replace(/^@?/, "@")));
+  return unreadableTeams(policy.teams).filter((t) => keys.has(t.key));
+}
+function canShip(login, policy) {
+  if (!policy) return true;
+  if (!login || login.includes("/")) return false;
+  return policy.logins.map(norm2).includes(norm2(login));
+}
 function groupsPhrase(groups) {
   const g = OWNER_GROUPS.filter((x) => groups.includes(x));
   if (g.length === 1) return `the ${g[0]} owner`;
@@ -433,7 +444,7 @@ function groupsPhrase(groups) {
 }
 function whoCanShipSentence(policy) {
   const names = (policy.entries ?? policy.logins).map((l) => entryLabel(l, policy.teams)).join(", ");
-  return `Only ${groupsPhrase(policy.groups)} can ship this${names ? ` (${names})` : ""}.`;
+  return `Only ${groupsPhrase(policy.groups)} can merge this${names ? ` (${names})` : ""}.`;
 }
 function visualImpactProblems(raw) {
   if (raw === void 0) return [];
@@ -446,6 +457,101 @@ function visualImpactProblems(raw) {
   return out;
 }
 
+// ../core/src/products.ts
+var DEFAULT_PRODUCTS = [
+  { key: "admin", name: "Admin demo", path: "apps/admin", framework: "react" },
+  { key: "library", name: "Library", default: true }
+];
+var PRODUCT_LABEL_PREFIX = "product: ";
+var productLabel = (key) => `${PRODUCT_LABEL_PREFIX}${key}`;
+function productsOf(config) {
+  const list2 = config?.products;
+  return Array.isArray(list2) && list2.length ? list2 : DEFAULT_PRODUCTS;
+}
+function defaultProduct(products) {
+  const list2 = products.length ? products : DEFAULT_PRODUCTS;
+  return list2.find((p) => p.default) ?? list2[list2.length - 1];
+}
+function findProduct(products, keyOrName) {
+  const k = (keyOrName ?? "").trim().toLowerCase();
+  if (!k) return void 0;
+  return products.find((p) => p.key.toLowerCase() === k) ?? products.find((p) => p.name.toLowerCase() === k);
+}
+var cleanPath = (p) => p.trim().replace(/^\.?\/+|\/+$/g, "");
+function productOfBranch(products, branch) {
+  const fallback = defaultProduct(products);
+  for (const l of branch.labels ?? []) {
+    const name = typeof l === "string" ? l : l?.name;
+    if (typeof name !== "string" || !name.toLowerCase().startsWith(PRODUCT_LABEL_PREFIX)) continue;
+    const hit = findProduct(products, name.slice(PRODUCT_LABEL_PREFIX.length));
+    if (hit) return hit;
+  }
+  const files = branch.files ?? [];
+  for (const p of products) {
+    if (p === fallback || !p.path) continue;
+    const prefix = `${cleanPath(p.path)}/`;
+    if (prefix !== "/" && files.some((f) => f.startsWith(prefix))) return p;
+  }
+  return fallback;
+}
+function productForPlace(products, place) {
+  const repo = place.repo?.trim().toLowerCase();
+  if (repo && repo !== place.designSystemRepo?.trim().toLowerCase()) {
+    const hit = products.find((p) => p.repo?.toLowerCase() === repo);
+    if (hit) return { product: hit, how: "repo" };
+  }
+  const rel = cleanPath(place.relPath ?? "");
+  if (rel && rel !== ".") {
+    let best;
+    for (const p of products) {
+      if (!p.path) continue;
+      const dir = cleanPath(p.path);
+      if (dir && (rel === dir || rel.startsWith(`${dir}/`)) && (!best || dir.length > cleanPath(best.path).length)) best = p;
+    }
+    if (best) return { product: best, how: "path" };
+  }
+  return { product: defaultProduct(products), how: "default" };
+}
+var KEY = /^[a-z0-9][a-z0-9-]*$/;
+var REPO = /^[\w.-]+\/[\w.-]+$/;
+var FIELDS = ["key", "name", "repo", "path", "preview", "framework", "default"];
+function productProblems(raw) {
+  if (raw === void 0) return [];
+  if (!Array.isArray(raw)) return ['"products" must be a list of { "key", "name" } objects'];
+  if (!raw.length) return ['"products" must list at least one product, or be left out to use the defaults'];
+  const problems = [];
+  const seen = /* @__PURE__ */ new Set();
+  let defaults = 0;
+  raw.forEach((p, i) => {
+    const at = `"products[${i}]`;
+    if (!p || typeof p !== "object" || Array.isArray(p)) {
+      problems.push(`${at}" must be an object with a "key" and a "name"`);
+      return;
+    }
+    const o = p;
+    for (const k of Object.keys(o)) if (!FIELDS.includes(k)) problems.push(`${at}.${k}" is not a known field (${FIELDS.join(", ")})`);
+    if (typeof o.key !== "string" || !KEY.test(o.key)) problems.push(`${at}.key" must be lowercase letters, digits and dashes, such as "admin"`);
+    else if (seen.has(o.key)) problems.push(`${at}.key" ("${o.key}") is used twice: give each product its own key`);
+    else seen.add(o.key);
+    if (typeof o.name !== "string" || !o.name.trim()) problems.push(`${at}.name" must be the name people read, such as "Admin demo"`);
+    if (o.repo !== void 0 && (typeof o.repo !== "string" || !REPO.test(o.repo))) problems.push(`${at}.repo" must be "owner/name"`);
+    if (o.path !== void 0) {
+      const bad = typeof o.path !== "string" || !o.path.trim() || o.path.startsWith("/") || o.path.split("/").includes("..");
+      if (bad) problems.push(`${at}.path" must be a folder relative to the repository root, without a leading "/" or "..", such as "apps/admin"`);
+    }
+    if (o.preview !== void 0 && (typeof o.preview !== "string" || !/^https?:\/\//.test(o.preview))) problems.push(`${at}.preview" must be an http(s) URL template, such as "https://app-git-{branch}.vercel.app"`);
+    if (o.framework !== void 0 && (typeof o.framework !== "string" || !o.framework.trim())) problems.push(`${at}.framework" must be a name such as "react", "vue" or "other"`);
+    if (o.default !== void 0 && typeof o.default !== "boolean") problems.push(`${at}.default" must be true or false`);
+    if (o.default === true) defaults++;
+  });
+  if (defaults > 1) problems.push('"products" marks more than one product as default: keep "default": true on the library only');
+  return problems;
+}
+function sameProducts(a, b) {
+  const norm3 = (l) => JSON.stringify(l.map((p) => FIELDS.map((f) => p[f] ?? null)));
+  return norm3(a) === norm3(b);
+}
+
 // ../core/src/config.ts
 var CONFIG_FILE = "bridge.config.json";
 var DEFAULT_OVERRIDE = { allowed: [], requireReason: true, minReasonLength: 20 };
@@ -586,6 +692,7 @@ function defineConfig(input) {
       } : {},
       ...g.rights ? { rights: normalizeRights(g.rights) } : {}
     },
+    products: input.products?.length ? input.products.map((p) => ({ ...p })) : DEFAULT_PRODUCTS.map((p) => ({ ...p })),
     ...input.audit ? { audit: { ...input.audit } } : {},
     ...input.visualImpact ? { visualImpact: { mode: input.visualImpact.mode === "on-demand" ? "on-demand" : "auto" } } : {},
     ...input.integrations ? { integrations: { ...input.integrations } } : {},
@@ -708,6 +815,7 @@ function loadConfig(source) {
     }
   }
   problems.push(...visualImpactProblems(d.visualImpact));
+  problems.push(...productProblems(d.products));
   const audit = d.audit;
   if (audit !== void 0) {
     if (!isObj(audit)) problems.push('"audit" must be an object');
@@ -754,7 +862,8 @@ function toConfigJson(config, schema = "./packages/core/bridge.config.schema.jso
     governance: config.governance,
     ...config.audit ? { audit: config.audit } : {},
     ...config.previews ? { previews: config.previews } : {},
-    ...config.visualImpact ? { visualImpact: config.visualImpact } : {}
+    ...config.visualImpact ? { visualImpact: config.visualImpact } : {},
+    ...config.products && !sameProducts(config.products, DEFAULT_PRODUCTS) ? { products: config.products } : {}
   };
 }
 
@@ -1317,6 +1426,49 @@ function fieldChanges(a, b) {
   if (!sameScopes(sa, sb)) out.push({ field: "scopes", before: sa, after: sb });
   return out;
 }
+function sameToken(a, b) {
+  if (!a || !b) return a === b;
+  return fieldChanges(a, b).length === 0;
+}
+function sideChange(from, to) {
+  if (!from && !to) return void 0;
+  if (!from) return { kind: "added", fields: [] };
+  if (!to) return { kind: "removed", fields: [] };
+  const fields = fieldChanges(from, to);
+  if (!fields.length) return void 0;
+  return { kind: fields.some((f) => f.field === "path") ? "renamed" : "changed", fields };
+}
+function threeWayDiff(base, figma, head) {
+  const ids = /* @__PURE__ */ new Set([...base?.keys() ?? [], ...figma.keys(), ...head.keys()]);
+  const result = { local: [], remote: [], conflicts: [], unchanged: 0 };
+  for (const id of [...ids].sort()) {
+    const b = base?.get(id);
+    const f = figma.get(id);
+    const h = head.get(id);
+    const local = sideChange(b, f);
+    const remote = sideChange(b, h);
+    if (!local && !remote || f && h && sameToken(f, h) || !f && !h) {
+      result.unchanged++;
+      continue;
+    }
+    const entry = { id, path: (f ?? h ?? b).path, base: b, figma: f, head: h, local, remote, conflict: false };
+    if (local && !remote) {
+      entry.path = (f ?? b).path;
+      result.local.push(entry);
+    } else if (remote && !local) {
+      entry.path = (h ?? b).path;
+      result.remote.push(entry);
+    } else {
+      entry.conflict = true;
+      result.conflicts.push(entry);
+    }
+  }
+  const byPath = (a, b) => a.path.localeCompare(b.path);
+  result.local.sort(byPath);
+  result.remote.sort(byPath);
+  result.conflicts.sort(byPath);
+  return result;
+}
 
 // ../core/src/risk.ts
 var RISK_LABELS = {
@@ -1551,6 +1703,164 @@ function composeProposalBody(args) {
   ].join("\n");
 }
 
+// ../core/src/component-spec.ts
+var COMPONENT_SPECS_VERSION = 1;
+var DEFAULT_COMPONENT_SPECS_FILE = "packages/react/component-specs.json";
+function coverageSummary(file) {
+  const list2 = file.coverage ?? file.components.map((c) => ({ name: c.name, status: "generated" }));
+  const generated = list2.filter((c) => c.status === "generated").length;
+  const drafted = list2.filter((c) => c.status === "drafted").length;
+  const layout = list2.filter((c) => c.status === "layout").length;
+  return { generated, drafted, inFigma: generated + drafted, visual: list2.length - layout, layout, total: list2.length, missing: list2.filter((c) => c.status === "unsupported") };
+}
+var variantKeyOf = (props) => Object.keys(props).sort().map((k) => `${k}=${props[k]}`).join(", ") || "Default";
+function parseComponentSpecs(text) {
+  let data;
+  try {
+    data = JSON.parse(text);
+  } catch {
+    throw new Error("component-specs.json is not valid JSON.");
+  }
+  const f = data;
+  if (!f || typeof f !== "object" || !Array.isArray(f.components)) throw new Error('component-specs.json has no "components" list.');
+  if (f.version !== COMPONENT_SPECS_VERSION) throw new Error(`component-specs.json is version ${String(f.version)}; this tool reads version ${COMPONENT_SPECS_VERSION}.`);
+  return f;
+}
+function figmaCell(entry) {
+  if (!entry) return void 0;
+  if (entry.status === "generated") return { label: "Yes" };
+  if (entry.status === "drafted") return { label: "Drafted", title: "Drafted with Claude where the code cannot be read on its own: in Figma, check it against the code." };
+  if (entry.status === "layout") return { label: "Auto layout", title: "A layout helper: nothing to draw, use auto layout in Figma." };
+  return { label: "Not yet", ...entry.reason ? { title: `Not supported yet: ${entry.reason}` } : {} };
+}
+
+// ../core/src/fidelity-references.ts
+var FIGMA_REFERENCES_BRANCH = "bridge-visual";
+var FIGMA_REFERENCES_DIR = "figma-references";
+var FIGMA_REFERENCES_MANIFEST = `${FIGMA_REFERENCES_DIR}/manifest.json`;
+var FIGMA_REFERENCE_STORY = "internal-figma-reference--variant";
+var FIGMA_FILL_WIDTH_TOKEN = "size.80";
+var STATE_PSEUDO = {
+  default: "rest",
+  rest: "rest",
+  enabled: "rest",
+  hover: "hover",
+  hovered: "hover",
+  pressed: "active",
+  active: "active",
+  focus: "focus-visible",
+  focused: "focus-visible",
+  "focus visible": "focus-visible",
+  disabled: "disabled"
+};
+var iconName = (component) => component.replace(/^Icon\//, "");
+var exportName = (name) => name.replace(/[^A-Za-z0-9]+/g, "");
+function planReference(spec, variant, file) {
+  if (spec.view === "popup") return { ok: false, reason: "drawn open in Figma; the code image shows it closed" };
+  const props = { ...spec.fixed ?? {} };
+  let pseudo;
+  for (const axis of spec.axes) {
+    const value = variant.props[axis.name];
+    if (value === void 0) return { ok: false, reason: `the variant has no ${axis.name} value` };
+    if (axis.prop) {
+      props[axis.prop] = value === "true" ? true : value === "false" ? false : value;
+      continue;
+    }
+    if (axis.name === "Checked") {
+      props.checked = value === "true";
+      if (value === "mixed") props.indeterminate = true;
+      continue;
+    }
+    if (axis.name.toLowerCase() !== "state") return { ok: false, reason: `${axis.name} has no matching option in code` };
+    const s = STATE_PSEUDO[value.toLowerCase()];
+    if (!s) return { ok: false, reason: `the ${value} state has no code equivalent to render` };
+    if (s === "disabled") props.disabled = true;
+    else if (s !== "rest") pseudo = s;
+  }
+  const root = spec.parts.find((p) => !p.parent);
+  if (!root) return { ok: false, reason: "the spec has no root layer" };
+  const children = (id) => spec.parts.filter((p) => p.parent === id);
+  const textOf = (part) => {
+    const swapTo = variant.slots?.[part.id] ?? part.swap?.default;
+    if (part.swap && swapTo) {
+      const slot = file?.slots?.find((s) => s.name === swapTo);
+      if (!slot) return { reason: `${swapTo} is not in the specs` };
+      if (slot.kind !== "text" || !slot.text) return { reason: `Figma shows a placeholder (${swapTo}) that code has no example of` };
+      return slot.text.default;
+    }
+    const prop = spec.properties.find((p) => p.name === part.text && p.type === "TEXT");
+    return typeof prop?.default === "string" ? prop.default : part.name;
+  };
+  let text;
+  const icons = {};
+  for (const prop of spec.properties) {
+    if (prop.type === "TEXT") {
+      const hidden = spec.properties.some((b) => b.type === "BOOLEAN" && b.prop === prop.prop && b.default === false);
+      if (hidden && prop.prop) continue;
+      if (prop.prop === "children") text = String(prop.default);
+      else if (prop.prop) props[prop.prop] = String(prop.default);
+      continue;
+    }
+    const iconPart = spec.parts.find((p) => p.kind === "icon" && p.visible === prop.name);
+    if (prop.default === true && !iconPart && prop.prop && props[prop.prop] === void 0 && spec.example?.p?.[prop.prop] === void 0) props[prop.prop] = true;
+  }
+  for (const part of spec.parts) {
+    if (part.kind !== "icon" || !part.swap) continue;
+    const shown = part.visible ? spec.properties.find((p) => p.name === part.visible)?.default === true : true;
+    if (!shown) continue;
+    if (!part.swap.prop) return { ok: false, reason: `the ${part.name} icon has no matching option in code` };
+    icons[part.swap.prop] = iconName(variant.slots?.[part.id] ?? part.swap.default);
+  }
+  let parts;
+  const loose = spec.properties.filter((p) => p.type === "TEXT" && !p.prop);
+  const frames = children(root.id).filter((p) => p.kind === "frame");
+  const compound = text === void 0 && frames.length > 0 && frames.every((f) => spec.parts.some((p) => p.parent === f.id && p.kind === "text" && (p.swap || p.text === f.name)));
+  if (compound) {
+    parts = [];
+    for (const f of frames) {
+      const t = spec.parts.find((p) => p.parent === f.id && p.kind === "text");
+      const value = textOf(t);
+      if (typeof value !== "string") return { ok: false, reason: value.reason };
+      parts.push({ component: `${exportName(spec.name)}${exportName(f.name)}`, text: value });
+    }
+  }
+  for (const p of loose) {
+    if (p.name === "Value") continue;
+    const part = spec.parts.find((x) => x.text === p.name);
+    if (compound && part && part.parent !== root.id) continue;
+    if (part && /placeholder$/.test(part.id)) {
+      props.placeholder = String(p.default);
+      continue;
+    }
+    return { ok: false, reason: `the ${p.name} text has no matching option in code` };
+  }
+  const example = spec.example;
+  const exampleChildren = example?.children?.length ? example.children : void 0;
+  return {
+    ok: true,
+    render: {
+      component: exportName(spec.view || spec.fixed || example ? example?.c ?? spec.component ?? spec.name : spec.name),
+      props: { ...example?.p ?? {}, ...props },
+      ...exampleChildren ? { children: exampleChildren } : {},
+      ...text !== void 0 && !exampleChildren ? { text } : {},
+      ...parts && !exampleChildren ? { parts } : {},
+      ...Object.keys(icons).length ? { icons } : {},
+      ...pseudo ? { pseudo } : {},
+      ...root.fill ? { width: FIGMA_FILL_WIDTH_TOKEN } : {}
+    }
+  };
+}
+function referenceImagePath(component, key) {
+  const slug = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+  const file = key.split(",").map((kv) => slug(kv)).filter(Boolean).join("__");
+  return `${slug(component)}/${file || "default"}.png`;
+}
+function planReferences(file) {
+  return file.components.flatMap(
+    (spec) => spec.variants.map((v) => ({ component: spec.name, specHash: spec.hash, key: variantKeyOf(v.props), plan: planReference(spec, v, file) }))
+  );
+}
+
 // ../core/src/node/git-local.ts
 import { execFile } from "node:child_process";
 import { mkdtemp, rm } from "node:fs/promises";
@@ -1661,6 +1971,7 @@ async function identityEnv(root) {
 
 export {
   __export,
+  previewUrl,
   previewLinks,
   readPreviewComment,
   findPreviewComment,
@@ -1673,8 +1984,18 @@ export {
   DEFAULT_RIGHTS,
   approverEntries,
   shipPolicy,
+  unreadableShipTeams,
+  canShip,
   whoCanShipSentence,
+  productLabel,
+  productsOf,
+  defaultProduct,
+  findProduct,
+  productOfBranch,
+  productForPlace,
   CONFIG_FILE,
+  DEFAULT_OVERRIDE,
+  DEFAULT_TOKEN_PATHS,
   loadConfig,
   tokensPath,
   protectedBranchesOf,
@@ -1686,6 +2007,7 @@ export {
   renderedColor,
   contrastPair,
   parseContrastChecks,
+  threeWayDiff,
   RISK_LABELS,
   classifyRisk,
   aliasOf,
@@ -1707,6 +2029,15 @@ export {
   DEFAULT_PROTECTED_BRANCHES,
   ProtectedBranchError,
   assertSafeBranch,
+  DEFAULT_COMPONENT_SPECS_FILE,
+  coverageSummary,
+  parseComponentSpecs,
+  figmaCell,
+  FIGMA_REFERENCES_BRANCH,
+  FIGMA_REFERENCES_MANIFEST,
+  FIGMA_REFERENCE_STORY,
+  referenceImagePath,
+  planReferences,
   git,
   isGitRepo,
   currentBranch,