@bridge-ds/mcp 0.3.1 → 0.3.3

package/dist/{chunk-X455XY4E.js → chunk-K3HY24MZ.js}

@@ -433,7 +433,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 [];

package/dist/index.js

@@ -3,8 +3,8 @@ import {
   VERSION,
   optionsFromArgv,
   serveStdio
-} from "./chunk-I3TL76GK.js";
-import "./chunk-X455XY4E.js";
+} from "./chunk-7HYTZVRW.js";
+import "./chunk-K3HY24MZ.js";
 
 // src/index.ts
 var argv = process.argv.slice(2);

package/dist/lib.js

@@ -23,12 +23,12 @@ import {
   parseDocsReply,
   requests_exports,
   serveStdio
-} from "./chunk-I3TL76GK.js";
+} from "./chunk-7HYTZVRW.js";
 import {
   CONFIG_FILE,
   loadConfig,
   toConfigJson
-} from "./chunk-X455XY4E.js";
+} from "./chunk-K3HY24MZ.js";
 export {
   BridgeContext,
   CONFIG_FILE,

package/dist/ops.d.ts

@@ -651,6 +651,7 @@ export declare function auditOp(ctx: BridgeContext, a: {
     label?: string;
     limit?: number;
     findings?: boolean;
+    allowlist?: string;
 }): Promise<{
     next: string;
     findings?: {
@@ -671,23 +672,6 @@ export declare function auditOp(ctx: BridgeContext, a: {
             library: string;
         }[];
     }[] | undefined;
-    byCategory: Partial<Record<import("@bridge-ds/core/audit").FindingCategory, import("@bridge-ds/core/audit").CategoryCount>>;
-    components: {
-        ds: Record<string, number>;
-        foreign: {
-            [k: string]: {
-                instances: number;
-                top: string[];
-            };
-        };
-        native: Record<string, number>;
-        recreated: {
-            name: string;
-            file: string;
-            line: number;
-            instances: number;
-        }[];
-    };
     topFiles: {
         path: string;
         hardcoded: number;
@@ -710,6 +694,37 @@ export declare function auditOp(ctx: BridgeContext, a: {
         category: import("@bridge-ds/core/audit").FindingCategory;
         count: number;
     })[];
+    ignoreErrors?: {
+        line: number;
+        message: string;
+        file: string;
+    }[] | undefined;
+    ignored?: {
+        total: number;
+        comment: number;
+        allowlist: number;
+        items: (import("@bridge-ds/core/audit").IgnoredItem & {
+            file: string;
+        })[];
+        staleAllowlist: import("@bridge-ds/core/audit").AllowlistEntry[];
+    } | undefined;
+    byCategory: Partial<Record<import("@bridge-ds/core/audit").FindingCategory, import("@bridge-ds/core/audit").CategoryCount>>;
+    components: {
+        ds: Record<string, number>;
+        foreign: {
+            [k: string]: {
+                instances: number;
+                top: string[];
+            };
+        };
+        native: Record<string, number>;
+        recreated: {
+            name: string;
+            file: string;
+            line: number;
+            instances: number;
+        }[];
+    };
     sinceBaseline?: {
         tokenAdoption: {
             before: number | null;

package/dist/{src-XSBCZV4W.js → src-V653Z7JC.js}

@@ -7,7 +7,7 @@ import {
   loadConfig,
   selectTokenFiles,
   showFile
-} from "./chunk-X455XY4E.js";
+} from "./chunk-K3HY24MZ.js";
 
 // ../visual/src/run.ts
 import { existsSync as existsSync3 } from "node:fs";
@@ -123,6 +123,148 @@ function impactedModules(index, input) {
   return { modules, globalHits };
 }
 
+// ../core/src/component-spec.ts
+var COMPONENT_SPECS_VERSION = 1;
+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;
+}
+
+// ../core/src/fidelity-references.ts
+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) }))
+  );
+}
+
 // ../visual/src/capture.ts
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname } from "node:path";
@@ -146,8 +288,8 @@ async function launch(o = {}) {
     args: ["--lang=en-US", "--disable-gpu", "--font-render-hinting=none", "--disable-lcd-text", "--force-color-profile=srgb", "--hide-scrollbars", "--disable-skia-runtime-opts", "--disable-renderer-backgrounding"]
   });
 }
-async function newContext(browser, viewport) {
-  const ctx = await browser.newContext({ viewport, deviceScaleFactor: 1, reducedMotion: "reduce", colorScheme: "light", locale: "en-US", timezoneId: "UTC", serviceWorkers: "block" });
+async function newContext(browser, viewport, deviceScaleFactor = 1) {
+  const ctx = await browser.newContext({ viewport, deviceScaleFactor, reducedMotion: "reduce", colorScheme: "light", locale: "en-US", timezoneId: "UTC", serviceWorkers: "block" });
   await ctx.addInitScript(INIT_SCRIPT);
   await ctx.route(
     /^https?:\/\/(?!127\.0\.0\.1[:/]|localhost[:/])/,
@@ -580,9 +722,9 @@ function selectImpact(input) {
     app
   };
 }
-function storyId(title, exportName) {
+function storyId(title, exportName2) {
   const sanitize = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/-+/g, "-").replace(/^-+/, "").replace(/-+$/, "");
-  const startCase = exportName.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z])([A-Z][a-z])/g, "$1 $2").replace(/[_-]+/g, " ").trim();
+  const startCase = exportName2.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z])([A-Z][a-z])/g, "$1 $2").replace(/[_-]+/g, " ").trim();
   return `${sanitize(title)}--${sanitize(startCase)}`;
 }
 function storiesFromSource(files) {
@@ -1096,12 +1238,106 @@ async function runImpact(o) {
   log(`${result.summary} Manifest: ${relative2(process.cwd(), result.manifestPath) || result.manifestPath}`);
   return result;
 }
+
+// ../visual/src/references.ts
+import { existsSync as existsSync4 } from "node:fs";
+import { mkdir as mkdir4, readFile as readFile4, writeFile as writeFile4 } from "node:fs/promises";
+import { dirname as dirname3, join as join4 } from "node:path";
+async function captureFigmaReferences(o) {
+  const log = o.log ?? (() => void 0);
+  const scale = o.scale ?? 2;
+  const brand = o.brand ?? "bridge";
+  const theme = o.theme ?? "light";
+  if (!existsSync4(join4(o.storybook, "index.json"))) throw new Error(`No built Storybook in ${o.storybook}: run npm run build-storybook first.`);
+  const index = JSON.parse(await readFile4(join4(o.storybook, "index.json"), "utf8"));
+  if (!index.entries[FIGMA_REFERENCE_STORY]) throw new Error(`The Storybook build has no ${FIGMA_REFERENCE_STORY} story (packages/react/src/stories/FigmaReference.stories.tsx).`);
+  const specs = parseComponentSpecs(await readFile4(o.specs, "utf8"));
+  const jobs = planReferences(specs).filter((j) => !o.only?.length || o.only.includes(j.component));
+  const manifest = {
+    version: 1,
+    tool: "@bridge-ds/visual",
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    sha: o.sha,
+    scale,
+    mode: { brand, theme, density: "comfortable" },
+    storyId: FIGMA_REFERENCE_STORY,
+    components: {}
+  };
+  for (const j of jobs) manifest.components[j.component] ??= { specHash: j.specHash, variants: {} };
+  let captured = 0;
+  let skipped = 0;
+  const served = await serveDir(o.storybook);
+  const browser = await launch();
+  try {
+    const ctx = await newContext(browser, { width: 1200, height: 800 }, scale);
+    const page = await newPage(ctx);
+    await page.goto(storyUrl(served.url, FIGMA_REFERENCE_STORY, brand, theme), { waitUntil: "load", timeout: 3e4 });
+    await page.waitForSelector("[data-fidelity-root], [data-fidelity-error]", { state: "attached", timeout: 2e4 });
+    await settle(page, { busy: false });
+    log(`Capturing ${jobs.length} variants at ${scale}x (${brand} ${theme})`);
+    for (const j of jobs) {
+      const variants = manifest.components[j.component].variants;
+      if (!j.plan.ok) {
+        variants[j.key] = { skipped: j.plan.reason };
+        skipped++;
+        continue;
+      }
+      const plan = JSON.stringify(j.plan.render);
+      await page.evaluate(
+        ({ id, plan: plan2 }) => new Promise((resolve2) => {
+          const ch = window.__STORYBOOK_ADDONS_CHANNEL__;
+          const done = () => {
+            clearTimeout(timer);
+            ch.off("storyRendered", done);
+            resolve2();
+          };
+          const timer = setTimeout(done, 1e4);
+          ch.on("storyRendered", done);
+          ch.emit("updateStoryArgs", { storyId: id, updatedArgs: { plan: plan2 } });
+        }),
+        { id: FIGMA_REFERENCE_STORY, plan }
+      );
+      await settle(page, { network: false, quiet: 2, interval: 40, busy: false });
+      const error = await page.locator("[data-fidelity-error]").first().textContent({ timeout: 200 }).catch(() => null);
+      let target = page.locator("[data-fidelity-root] > *").first();
+      if (!error && !await target.count()) {
+        const marked = page.locator("[data-fidelity-target]").first();
+        await marked.waitFor({ state: "visible", timeout: 3e3 }).catch(() => void 0);
+        await settle(page, { network: false, quiet: 2, interval: 40, busy: false });
+        target = marked;
+      }
+      if (error || !await target.count()) {
+        variants[j.key] = { skipped: error ?? "the code example did not render" };
+        skipped++;
+        continue;
+      }
+      const file = referenceImagePath(j.component, j.key);
+      const path = join4(o.out, file);
+      await mkdir4(dirname3(path), { recursive: true });
+      await target.screenshot({ path, omitBackground: true, animations: "disabled", caret: "hide", scale: "device" });
+      const box = await target.boundingBox();
+      variants[j.key] = { file, width: Math.round(box?.width ?? 0), height: Math.round(box?.height ?? 0) };
+      captured++;
+    }
+    await ctx.close();
+  } finally {
+    await browser.close().catch(() => void 0);
+    await served.close();
+  }
+  await mkdir4(o.out, { recursive: true });
+  const manifestPath = join4(o.out, "manifest.json");
+  await writeFile4(manifestPath, `${JSON.stringify(manifest, null, 2)}
+`);
+  log(`${captured} images, ${skipped} variants skipped. ${manifestPath}`);
+  return { manifest, manifestPath, captured, skipped };
+}
 export {
   COMMENT_MARKER,
   DEFAULT_ROUTES,
   DEFAULT_TENANTS,
   boxesFromCells,
   boxesFromDiff,
+  captureFigmaReferences,
   changedTokens,
   decodePng,
   diffPngs,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge-ds/mcp",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "type": "module",
   "description": "Bridge MCP server: lets Claude (Claude Code, Claude Desktop or any MCP client) read, check and propose changes to a DTCG design system repo through pull requests.",
   "license": "MIT",
@@ -54,8 +54,8 @@
     "build:package": "node ../../scripts/build-packages.mjs mcp"
   },
   "dependencies": {
-    "@bridge-ds/core": "^0.4.0",
-    "@bridge-ds/visual": "^0.2.2",
+    "@bridge-ds/core": "^0.6.0",
+    "@bridge-ds/visual": "^0.3.0",
     "@modelcontextprotocol/sdk": "1.31.0",
     "typescript": "5.9.3",
     "zod": "3.25.76"