@bridge-ds/mcp 0.8.5 → 0.10.0

package/dist/{chunk-PMZGEZGX.js → chunk-BZEPCY42.js}

@@ -171,7 +171,7 @@ function resolveBranchPreviews(apps, ctx, sources = {}) {
   }
   return out;
 }
-var previewsSettled = (previews) => previews.every((p) => !!p.url && (p.state === "ready" || p.state === "failed"));
+var previewsSettled = (previews) => previews.every((p) => p.state === "failed" || !!p.url && p.state === "ready");
 
 // ../core/src/teams.ts
 var LOGIN = /^[A-Za-z0-9](?:[A-Za-z0-9]|-(?=[A-Za-z0-9])){0,38}$/;
@@ -578,6 +578,12 @@ var CONFIG_FILE = "bridge.config.json";
 var CHANGES_MODES = ["suggest", "direct"];
 var DEFAULT_CHANGES_MODE = "suggest";
 var DEFAULT_OVERRIDE = { allowed: [], requireReason: true, minReasonLength: 20 };
+var TEAM_NAME_MAX = 60;
+function teamName(value) {
+  if (typeof value !== "string") return void 0;
+  const v = value.trim().replace(/\s+/g, " ");
+  return v && v.length <= TEAM_NAME_MAX ? v : void 0;
+}
 var DEFAULT_TOKEN_PATHS = {
   root: "tokens",
   primitives: "primitives",
@@ -683,6 +689,7 @@ function defineConfig(input) {
   const g = input.governance ?? {};
   const contrastFile = contrastPath ?? [root === "." ? "" : root, paths.contrastChecks].filter(Boolean).join("/");
   return {
+    ...teamName(input.name) ? { name: teamName(input.name) } : {},
     repo: parseRepoInput(input.repo, input.branch),
     tokens: { ...paths, include: input.tokens?.include ?? ["**/*.tokens.json"], exclude: input.tokens?.exclude ?? [], tiers, layers, ...t.usage ? { usage: trimSlashes(t.usage) } : {} },
     axes,
@@ -715,12 +722,14 @@ function defineConfig(input) {
         }
       } : {},
       ...g.rights ? { rights: normalizeRights(g.rights) } : {},
-      ...g.soloOwnerCanApproveBoth === true ? { soloOwnerCanApproveBoth: true } : {}
+      ...g.soloOwnerCanApproveBoth === true ? { soloOwnerCanApproveBoth: true } : {},
+      ...g.leadsPublishTier1 === false ? { leadsPublishTier1: false } : {}
     },
     products: input.products?.length ? input.products.map((p) => ({ ...p })) : DEFAULT_PRODUCTS.map((p) => ({ ...p })),
     changes: input.changes === "direct" ? "direct" : DEFAULT_CHANGES_MODE,
     ...input.storybook?.url ? { storybook: { url: input.storybook.url.trim().replace(/\/+$/, "") } } : {},
     ...input.library?.public === true ? { library: { public: true } } : {},
+    ...input.demo?.viewer?.trim() ? { demo: { viewer: input.demo.viewer.trim(), ...input.demo.role?.trim() ? { role: input.demo.role.trim() } : {} } } : {},
     ...input.audit ? { audit: { ...input.audit } } : {},
     ...input.visualImpact ? { visualImpact: { mode: input.visualImpact.mode === "on-demand" ? "on-demand" : "auto" } } : {},
     ...input.integrations ? { integrations: { ...input.integrations } } : {},
@@ -842,9 +851,11 @@ function loadConfig(source) {
       }
       problems.push(...rightsProblems(gov.rights));
       if (gov.soloOwnerCanApproveBoth !== void 0 && typeof gov.soloOwnerCanApproveBoth !== "boolean") problems.push('"governance.soloOwnerCanApproveBoth" must be true or false');
+      if (gov.leadsPublishTier1 !== void 0 && typeof gov.leadsPublishTier1 !== "boolean") problems.push('"governance.leadsPublishTier1" must be true or false');
     }
   }
   problems.push(...visualImpactProblems(d.visualImpact));
+  if (d.name !== void 0 && teamName(d.name) === void 0) problems.push(`"name" must be the team's name, 1 to ${TEAM_NAME_MAX} characters`);
   if (d.changes !== void 0 && !CHANGES_MODES.includes(d.changes)) problems.push(`"changes" must be "suggest" or "direct" (got ${JSON.stringify(d.changes)})`);
   const sb = d.storybook;
   if (sb !== void 0) {
@@ -860,6 +871,14 @@ function loadConfig(source) {
       for (const k of Object.keys(lib)) if (k !== "public") problems.push(`"library.${k}" is not a known key`);
     }
   }
+  const demo = d.demo;
+  if (demo !== void 0) {
+    if (!isObj(demo) || !isStr(demo.viewer) || !demo.viewer.trim()) problems.push('"demo" must be { "viewer" }, for example { "viewer": "Dana", "role": "DS lead" }');
+    else {
+      if (demo.role !== void 0 && !isStr(demo.role)) problems.push('"demo.role" must be a string, for example "DS lead"');
+      for (const k of Object.keys(demo)) if (k !== "viewer" && k !== "role") problems.push(`"demo.${k}" is not a known key`);
+    }
+  }
   problems.push(...productProblems(d.products));
   const audit = d.audit;
   if (audit !== void 0) {
@@ -897,6 +916,7 @@ function toConfigJson(config, schema = "./packages/core/bridge.config.schema.jso
   return {
     $schema: schema,
     version: 1,
+    ...config.name ? { name: config.name } : {},
     ...config.repo ? { repo: config.repo } : {},
     tokens: { root: config.tokens.root, include: config.tokens.include, ...config.tokens.exclude.length ? { exclude: config.tokens.exclude } : {}, tiers: config.tokens.tiers, layers: config.tokens.layers.map((l) => l.optional ? l : { files: l.files }), ...config.tokens.usage ? { usage: config.tokens.usage } : {} },
     modes: Object.fromEntries(Object.entries(config.axes).map(([k, a]) => [k, a.parity ? a : { values: a.values, default: a.default }])),
@@ -912,6 +932,7 @@ function toConfigJson(config, schema = "./packages/core/bridge.config.schema.jso
     changes: changesMode(config),
     ...config.storybook ? { storybook: config.storybook } : {},
     ...config.library ? { library: config.library } : {},
+    ...config.demo ? { demo: config.demo } : {},
     ...config.products && !sameProducts(config.products, DEFAULT_PRODUCTS) ? { products: config.products } : {}
   };
 }
@@ -1525,6 +1546,11 @@ var RISK_LABELS = {
   2: "Tier 2: medium risk, design review then design + tech approval",
   3: "Tier 3: token change, needs design + tech approval"
 };
+function figmaPushTierLabel(tier, changes) {
+  const waits = changes.some((c) => c.kind === "renamed" || c.kind === "removed");
+  return `Tier ${tier}: token change. From Figma: design-approved, ${waits ? "waits for a developer OK (a token renamed or removed can break product code)" : "ships once the checks pass"}`;
+}
+var figmaPushNextLine = (changes) => changes.some((c) => c.kind === "renamed" || c.kind === "removed") ? "Pushed from Figma, so design-approved. A developer OKs the rename or removal before it merges." : "Pushed from Figma, so design-approved. Bridge merges it once the automatic checks pass; Undo is in History in Bridge Studio.";
 var BUMP_RANK = { patch: 0, minor: 1, major: 2 };
 var LOW = [/\.md$/, /^docs\//, /\.stories\.tsx?$/, /\.docs\.json$/, /\.test\.tsx?$/, /^\.changeset\//];
 var isSummary = (c) => "kind" in c;
@@ -1703,14 +1729,15 @@ _${deltas.length - limit} more pair(s) not shown._` : "";
 }
 function composeProposalBody(args) {
   const t = args.tier.tier;
-  const box = (n) => `- ${n === t ? "[x]" : "[ ]"} ${RISK_LABELS[n]}`;
+  const figma = Boolean(args.fromFigma);
+  const box = (n) => `- ${n === t ? "[x]" : "[ ]"} ${figma && n === t ? figmaPushTierLabel(n, args.changes) : RISK_LABELS[n]}`;
   const impactList = args.impact.entries.slice(0, 15).map((e) => `- \`${e.path}\`: ${swatch(e.before)} -> ${swatch(e.after)} (${e.modes.length} mode${e.modes.length > 1 ? "s" : ""})`);
   return [
     "## What changed and why",
     "",
     args.summary.trim(),
     "",
-    `Proposed through ${args.tool ?? "Bridge MCP"}${args.author ? ` by ${args.author}` : ""}. Agent-authored: a human design owner and tech owner review and merge.`,
+    figma ? `Pushed from Figma through ${args.tool ?? "the Bridge Figma plugin"}${args.author ? ` by ${args.author}` : ""}. ${figmaPushNextLine(args.changes)}` : `Proposed through ${args.tool ?? "Bridge MCP"}${args.author ? ` by ${args.author}` : ""}. Agent-authored: a human design owner and tech owner review and merge.`,
     "",
     "## Risk tier",
     "",
@@ -1740,8 +1767,8 @@ function composeProposalBody(args) {
     "",
     "## Authored by",
     "",
-    "- [ ] Human",
-    "- [x] AI agent (Claude), reviewed by a human before merge",
+    `- [${figma ? "x" : " "}] Human`,
+    `- [${figma ? " " : "x"}] AI agent (Claude), reviewed by a human before merge`,
     "",
     "## Design review checklist",
     "",
@@ -1755,6 +1782,36 @@ function composeProposalBody(args) {
 // ../core/src/component-spec.ts
 var COMPONENT_SPECS_VERSION = 1;
 var DEFAULT_COMPONENT_SPECS_FILE = "packages/react/component-specs.json";
+var SPEC_FIELDS = [
+  "fill",
+  "stroke",
+  "strokeWeight",
+  "strokeTopWeight",
+  "strokeRightWeight",
+  "strokeBottomWeight",
+  "strokeLeftWeight",
+  "cornerRadius",
+  "paddingTop",
+  "paddingRight",
+  "paddingBottom",
+  "paddingLeft",
+  "itemSpacing",
+  "counterAxisSpacing",
+  "width",
+  "height",
+  "minWidth",
+  "minHeight",
+  "opacity",
+  "shadow",
+  "textFill",
+  "fontFamily",
+  "fontSize",
+  "fontWeight",
+  "lineHeight",
+  "letterSpacing",
+  "textDecoration"
+];
+var COLOR_FIELDS = /* @__PURE__ */ new Set(["fill", "stroke", "textFill"]);
 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;
@@ -1762,6 +1819,18 @@ function coverageSummary(file) {
   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") };
 }
+function specHash(text) {
+  let h = 2166136261;
+  for (let i = 0; i < text.length; i++) {
+    h ^= text.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return (h >>> 0).toString(16).padStart(8, "0");
+}
+function hashSpec(spec) {
+  const { hash: _ignored, example: _example, ...rest } = spec;
+  return specHash(JSON.stringify(rest));
+}
 var variantKeyOf = (props) => Object.keys(props).sort().map((k) => `${k}=${props[k]}`).join(", ") || "Default";
 function parseComponentSpecs(text) {
   let data;
@@ -1805,7 +1874,7 @@ var STATE_PSEUDO = {
 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" };
+  if (spec.view === "popup") return planPopup(spec, variant);
   const props = { ...spec.fixed ?? {} };
   let pseudo;
   for (const axis of spec.axes) {
@@ -1834,6 +1903,7 @@ function planReference(spec, variant, file) {
     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 === "media") return { reason: `Figma shows a media placeholder (${swapTo}); code shows the image it is given, nothing to compare` };
       if (slot.kind !== "text" || !slot.text) return { reason: `Figma shows a placeholder (${swapTo}) that code has no example of` };
       return slot.text.default;
     }
@@ -1885,10 +1955,13 @@ function planReference(spec, variant, file) {
   }
   const example = spec.example;
   const exampleChildren = example?.children?.length ? example.children : void 0;
+  const component = exportName(example?.c ?? (spec.name.includes("/") ? spec.component ?? spec.name : spec.name));
+  const parent = spec.component ? exportName(spec.component) : void 0;
   return {
     ok: true,
     render: {
-      component: exportName(spec.view || spec.fixed || example ? example?.c ?? spec.component ?? spec.name : spec.name),
+      component,
+      ...parent && parent !== component ? { within: parent } : {},
       props: { ...example?.p ?? {}, ...props },
       ...exampleChildren ? { children: exampleChildren } : {},
       ...text !== void 0 && !exampleChildren ? { text } : {},
@@ -1899,6 +1972,28 @@ function planReference(spec, variant, file) {
     }
   };
 }
+function planPopup(spec, variant) {
+  const root = spec.parts.find((p) => !p.parent);
+  const own = {};
+  for (const axis of spec.axes) {
+    const value = variant.props[axis.name];
+    if (!axis.prop || value === void 0) return { ok: false, reason: `${axis.name} has no matching option in code` };
+    own[axis.prop] = value === "true" ? true : value === "false" ? false : value;
+  }
+  const className = /\.module\.css \.([\w-]+)/.exec(root?.source ?? "")?.[1];
+  const component = spec.component ? exportName(spec.component) : void 0;
+  const example = spec.example;
+  if (!component || !example) return { ok: false, reason: "drawn open from no code example: nothing to open in code" };
+  if (!className) return { ok: false, reason: "the popup has no class to find it by in code" };
+  const popup = { className };
+  if (exportName(example.c) === component) {
+    return { ok: true, render: { component, props: { ...example.p ?? {}, ...own, defaultOpen: true }, ...example.children?.length ? { children: example.children } : {}, popup } };
+  }
+  return {
+    ok: true,
+    render: { component, props: { defaultOpen: true }, children: [{ c: `${component}Trigger`, children: ["Open"] }, { ...example, p: { ...example.p ?? {}, ...own } }], popup }
+  };
+}
 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("__");
@@ -2053,6 +2148,7 @@ export {
   CONFIG_FILE,
   DEFAULT_OVERRIDE,
   DEFAULT_TOKEN_PATHS,
+  DEFAULT_GOVERNANCE,
   loadConfig,
   tokensPath,
   protectedBranchesOf,
@@ -2067,6 +2163,7 @@ export {
   parseContrastChecks,
   threeWayDiff,
   RISK_LABELS,
+  isGuardrail,
   classifyRisk,
   aliasOf,
   globToRegExp,
@@ -2088,7 +2185,10 @@ export {
   ProtectedBranchError,
   assertSafeBranch,
   DEFAULT_COMPONENT_SPECS_FILE,
+  SPEC_FIELDS,
+  COLOR_FIELDS,
   coverageSummary,
+  hashSpec,
   variantKeyOf,
   parseComponentSpecs,
   figmaCell,