@bridge-ds/mcp 0.3.2 → 0.4.0

package/dist/explorations.d.ts

@@ -11,6 +11,8 @@ export interface StartExplorationInput {
     /** Where it is started from (the MCP tool says mcp, the CLI says cli), and the AI agent behind it when known. */
     source?: ExplorationSource | undefined;
     agent?: string | undefined;
+    /** The product it is tried in (key or name, bridge.config.json "products"). Default: the product of the current folder or repo. */
+    product?: string | undefined;
     dryRun?: boolean | undefined;
 }
 /**
@@ -20,6 +22,7 @@ export interface StartExplorationInput {
  */
 export declare function startExploration(ctx: BridgeContext, a: StartExplorationInput): Promise<{
     branch: string;
+    product: string;
     slug: string;
     base: string;
     title: string;
@@ -46,6 +49,7 @@ export declare function startExploration(ctx: BridgeContext, a: StartExploration
     }[];
     next: string;
     branch: string;
+    product: string;
     slug: string;
     base: string;
     title: string;
@@ -60,6 +64,7 @@ export declare function startExploration(ctx: BridgeContext, a: StartExploration
     commit: string;
     next: string;
     branch: string;
+    product: string;
     slug: string;
     base: string;
     title: string;

package/dist/index.js

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

package/dist/lib.d.ts

@@ -11,6 +11,8 @@ export * as brand from './brand.js';
 export * as requests from './requests.js';
 export * as explorations from './explorations.js';
 export * as drafts from './drafts.js';
+export * as branches from './branches.js';
+export * as studio from './studio.js';
 export { DOCS_DRAFT_MODEL, anthropicReplyText, anthropicRequest, formatDocsJson, mergeDocsDraft, missingProse, parseDocsReply } from '@bridge-ds/core';
 export interface ServeOptions extends ContextOptions {
 }

package/dist/lib.js

@@ -8,6 +8,7 @@ import {
   anthropicReplyText,
   anthropicRequest,
   auditSnippet,
+  branches_exports,
   brand_exports,
   core,
   createServer,
@@ -22,13 +23,14 @@ import {
   optionsFromArgv,
   parseDocsReply,
   requests_exports,
-  serveStdio
-} from "./chunk-MTQCDV65.js";
+  serveStdio,
+  studio_exports
+} from "./chunk-NYFH322K.js";
 import {
   CONFIG_FILE,
   loadConfig,
   toConfigJson
-} from "./chunk-X455XY4E.js";
+} from "./chunk-7DBLDJIL.js";
 export {
   BridgeContext,
   CONFIG_FILE,
@@ -40,6 +42,7 @@ export {
   anthropicReplyText,
   anthropicRequest,
   auditSnippet,
+  branches_exports as branches,
   brand_exports as brand,
   core,
   createServer,
@@ -56,5 +59,6 @@ export {
   parseDocsReply,
   requests_exports as requests,
   serveStdio,
+  studio_exports as studio,
   toConfigJson
 };

package/dist/ops.d.ts

@@ -1,7 +1,7 @@
 import { type ScaffoldInput } from './components.js';
-import type { BridgeContext } from './context.js';
 import { type BridgeConfig, type GitHubClient } from '@bridge-ds/core';
 import { type Combo, type PairInput, type TokenEdit, type TokenSet } from './core-adapter.js';
+import { BridgeContext } from './context.js';
 /** Accepts `color.text.muted`, `--color-text-muted` or `var(--color-text-muted)`. */
 export declare function normalizeTokenPath(set: TokenSet, input: string): string;
 export declare function getConfig(ctx: BridgeContext): Promise<{
@@ -274,7 +274,75 @@ export declare function proposeTokenChange(ctx: BridgeContext, a: {
     summary?: string;
     dryRun?: boolean;
     branch?: string | undefined;
+    pr?: number | string | undefined;
+    jira?: string | undefined;
+    product?: string | undefined;
 }): Promise<{
+    status: string;
+    pr: number;
+    message: string;
+} | {
+    hint: string;
+    pr: number;
+    branch: string;
+    tier: 1 | 2 | 3;
+    changes: {
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+    };
+    notes: string[];
+    status: string;
+    why: string;
+    newErrors: import("@bridge-ds/core").LayerIssue[];
+    message?: undefined;
+} | {
+    files: string[];
+    pr: number;
+    branch: string;
+    tier: 1 | 2 | 3;
+    changes: {
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+    };
+    notes: string[];
+    status: string;
+    message?: undefined;
+} | {
+    commit: string;
+    url: string;
+    said: string;
+    pr: number;
+    branch: string;
+    tier: 1 | 2 | 3;
+    changes: {
+        kind: "added" | "changed" | "renamed" | "removed";
+        path: string;
+        file: string;
+        before: string | undefined;
+        after: string | undefined;
+    }[];
+    contrast: {
+        moved: number;
+        newFailures: import("@bridge-ds/core").ContrastDelta[];
+    };
+    notes: string[];
+    status: string;
+    message?: undefined;
+} | {
     status: string;
     message: string;
 } | {
@@ -501,6 +569,7 @@ export declare function proposeTokenChange(ctx: BridgeContext, a: {
     url: string;
     labels: string[];
     draft: boolean;
+    product: string;
     files: string[];
     prBody: string;
     title: string;

package/dist/requests.d.ts

@@ -68,6 +68,8 @@ export interface CreateRequestInput {
     source?: RequestSource | undefined;
     /** Exploration branch to implement it on (`explore/<slug>`), instead of a pull request to main. */
     exploration?: string | undefined;
+    /** The product it is for (key or name, bridge.config.json "products"). Default: the product of the current folder or repo. */
+    product?: string | undefined;
     dryRun?: boolean | undefined;
 }
 export declare function createRequest(ctx: BridgeContext, a: CreateRequestInput): Promise<{

package/dist/{src-XSBCZV4W.js → src-2YRRAUUM.js}

@@ -1,13 +1,17 @@
 import {
+  FIGMA_REFERENCE_STORY,
   LayeredTokenSet,
   comboKey,
   diffLayered,
   git,
   listFilesAt,
   loadConfig,
+  parseComponentSpecs,
+  planReferences,
+  referenceImagePath,
   selectTokenFiles,
   showFile
-} from "./chunk-X455XY4E.js";
+} from "./chunk-7DBLDJIL.js";
 
 // ../visual/src/run.ts
 import { existsSync as existsSync3 } from "node:fs";
@@ -146,8 +150,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[:/])/,
@@ -1096,12 +1100,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/dist/studio.d.ts

@@ -0,0 +1,107 @@
+import type { BridgeContext } from './context.js';
+/**
+ * Save a component's guidance (docs.json) the way the Library edit mode does: merged into the docs on the branch,
+ * cleaned, validated (a summary, no empty items, no em dash), then either one new branch sent for review (Tier 1,
+ * patch changeset, the Jira key first in its name) or one commit on an open branch (`pr`).
+ */
+export declare function saveDocs(ctx: BridgeContext, a: {
+    component: string;
+    docs: Record<string, unknown>;
+    pr?: number | string | undefined;
+    title?: string | undefined;
+    notes?: string | undefined;
+    jira?: string | undefined;
+    product?: string | undefined;
+    dryRun?: boolean | undefined;
+}): Promise<{
+    status: "dry-run";
+    pr: number;
+    path: string;
+    content: string;
+    commit?: undefined;
+    said?: undefined;
+    url?: undefined;
+    title?: undefined;
+    product?: undefined;
+} | {
+    status: "committed" | "unchanged";
+    pr: number;
+    path: string;
+    commit: string | null;
+    said: string;
+    content?: undefined;
+    url?: undefined;
+    title?: undefined;
+    product?: undefined;
+} | {
+    status: "unchanged";
+    path: string;
+    said: string;
+    pr?: undefined;
+    content?: undefined;
+    commit?: undefined;
+    url?: undefined;
+    title?: undefined;
+    product?: undefined;
+} | {
+    said?: string | undefined;
+    status: "preview" | "dry-run";
+    path: string;
+    content: string;
+    product: string;
+    pr?: undefined;
+    commit?: undefined;
+    url?: undefined;
+    title?: undefined;
+} | {
+    status: "sent-for-review";
+    pr: number;
+    url: string;
+    title: string;
+    path: string;
+    product: string;
+    said: string;
+    content?: undefined;
+    commit?: undefined;
+}>;
+/** The settings a designer reads in Studio Settings, safe to show: roles, who ships, the owner override, protection, products, previews. */
+export declare function getSettings(ctx: BridgeContext): Promise<{
+    repo: string | null;
+    main: string;
+    roles: {
+        teamsNotRead?: string[] | undefined;
+        designApproval: string[];
+        techApproval: string[];
+        ship: string;
+    };
+    ownerOverride: {
+        on: boolean;
+        who: string[];
+        reason: string;
+    };
+    protection: string;
+    products: {
+        key: string;
+        name: string;
+        default: boolean;
+    }[];
+    previews: string[];
+    visualImpact: import("@bridge-ds/core").VisualImpactMode;
+    note: string;
+}>;
+/** Which components are in Figma (Studio's "In Figma" column), and whether code images exist for the fidelity check. */
+export declare function figmaCoverage(ctx: BridgeContext, a?: {
+    component?: string | undefined;
+}): Promise<{
+    components: never[];
+    summary: string;
+    fidelity?: undefined;
+} | {
+    summary: string;
+    components: {
+        why?: string | undefined;
+        name: string;
+        inFigma: string;
+    }[];
+    fidelity: string;
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge-ds/mcp",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "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.5.0",
-    "@bridge-ds/visual": "^0.2.3",
+    "@bridge-ds/core": "^0.7.0",
+    "@bridge-ds/visual": "^0.3.1",
     "@modelcontextprotocol/sdk": "1.31.0",
     "typescript": "5.9.3",
     "zod": "3.25.76"