@bridge-ds/core 0.5.0 → 0.6.0

package/dist/index.js

@@ -1,7 +1,7 @@
-import { n as modeDisplayName, o as modesOf$1, q as isMultiMode, T as TIER_NAMES, s as TIER_AXIS, u as findReferenceProblems, w as evaluatePairs, x as contrastScope, y as contextLabel, S as SINGLE_MODE, z as pathId, A as flattenTokens, B as serializeTokenFile, D as removeToken, E as upsertToken, F as threeWayDiff, G as emptyTokenFile, H as parseTokenFile, I as EXT_ID, J as EXT_SCOPES, K as resolve, L as moveToken, M as effectiveScopes, N as sameScopes, O as defaultScopes, P as readTokenAt, Q as modeFile, R as defaultFile, U as DEFAULT_PROTECTED_BRANCHES, a as assertSafeBranch, V as ProtectedBranchError, f as CONFIG_FILE, l as loadConfig, W as ConfigError, X as DEFAULT_TOKEN_PATHS, c as collectHistory, p as packageDirCandidates, b as parseChangelog, r as releasesFromTags, m as mergeReleases, d as buildReport, Y as applyTokenEdits, Z as buildHistoryEntry, _ as resolveBranchPreviews, $ as tokensPath, a0 as coerceValue, a1 as toConfigJson, a2 as parseContrastChecks, a3 as checkLayeredPair, a4 as classifyRisk, a5 as formatChangeset, a6 as RISK_LABELS, a7 as parseJson, a8 as serializeJson, a9 as plainEqual, aa as toPlain, ab as getEntry, ac as fromPlain, ad as previewLinks, ae as slugify, af as readPreviewComment, ag as findPreviewComment, ah as previewsSettled } from "./component-spec-cvrSvIZj.js";
-import { ai, aj, ak, k, C, al, am, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, aO, i, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf, bg, bh, bi, bj, bk, bl, bm, bn, bo, h, bp, j, bq, br, bs, bt, bu, bv, bw, bx, by, bz, g, bA, bB, bC, bD, bE, bF, bG, bH, bI, bJ, bK, bL, bM, bN, e, bO, bP, bQ, bR, bS, bT, bU, bV, bW, bX, bY, bZ, b_, b$, c0, c1, c2, c3, c4, c5, c6, c7, c8, t, c9, ca, cb, cc, cd, v, ce, cf, cg, ch } from "./component-spec-cvrSvIZj.js";
+import { o as modeDisplayName, q as modesOf$1, u as isMultiMode, T as TIER_NAMES, w as TIER_AXIS, x as findReferenceProblems, y as evaluatePairs, z as contrastScope, A as contextLabel, S as SINGLE_MODE, B as pathId, D as flattenTokens, E as serializeTokenFile, F as removeToken, G as upsertToken, H as threeWayDiff, I as emptyTokenFile, J as parseTokenFile, K as EXT_ID, L as EXT_SCOPES, M as resolve, N as moveToken, O as effectiveScopes, P as sameScopes, Q as defaultScopes, R as readTokenAt, U as modeFile, V as defaultFile, W as DEFAULT_PROTECTED_BRANCHES, a as assertSafeBranch, X as ProtectedBranchError, C as CONFIG_FILE, l as loadConfig, Y as ConfigError, Z as DEFAULT_TOKEN_PATHS, c as collectHistory, p as packageDirCandidates, b as parseChangelog, r as releasesFromTags, m as mergeReleases, d as buildReport, _ as applyTokenEdits, $ as buildHistoryEntry, a0 as resolveBranchPreviews, a1 as tokensPath, a2 as coerceValue, a3 as toConfigJson, a4 as parseContrastChecks, a5 as checkLayeredPair, a6 as classifyRisk, a7 as formatChangeset, a8 as RISK_LABELS, a9 as parseJson, aa as serializeJson, ab as plainEqual, ac as toPlain, ad as getEntry, ae as fromPlain, af as previewLinks, ag as slugify, ah as readPreviewComment, ai as findPreviewComment, aj as previewsSettled, f as variantKeyOf } from "./component-spec-GFVEE6Fc.js";
+import { ak, al, am, n, k, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, aO, aP, aQ, j, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf, bg, bh, bi, bj, bk, bl, bm, bn, bo, bp, bq, br, h, bs, i, bt, bu, bv, bw, bx, by, bz, bA, bB, bC, g, bD, bE, bF, bG, bH, bI, bJ, bK, bL, bM, bN, bO, bP, bQ, e, bR, bS, bT, bU, bV, bW, bX, bY, bZ, b_, b$, s, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, ca, t, cb, cc, cd, ce, v, cf, cg, ch, ci, cj } from "./component-spec-GFVEE6Fc.js";
 import { a as collectRefs, i as isAlias, b as aliasTarget, v as valuesEqual, p as parseColor, e as rgbaToHex, f as formatValue, s as selectTokenFiles, L as LayeredTokenSet, j as validateLayered } from "./layered-BnbmToGs.js";
-import { D, d, k as k2, l, c, m, n, g as g2, h as h2, o, q, r, t as t2, u } from "./layered-BnbmToGs.js";
+import { D, d, k as k2, l, c, m, n as n2, g as g2, h as h2, o, q, r, t as t2, u } from "./layered-BnbmToGs.js";
 const issueKey = (i2) => `${i2.code}|${i2.path ?? ""}|${i2.mode ?? ""}|${i2.code === "file-problem" ? i2.message : ""}`;
 const modeName = (mode) => mode === SINGLE_MODE ? "all modes" : modeDisplayName(mode);
 const isPalette = (t3) => t3.tier === "brand" && t3.path.startsWith("palette.");
@@ -236,14 +236,14 @@ function reconcileIds(figma, git) {
     if (best) suggestions.push(best);
   }
   const byGit = /* @__PURE__ */ new Map();
-  for (const s of suggestions) {
-    const prev = byGit.get(s.gitId);
-    if (!prev || s.similarity > prev.similarity) byGit.set(s.gitId, s);
+  for (const s2 of suggestions) {
+    const prev = byGit.get(s2.gitId);
+    if (!prev || s2.similarity > prev.similarity) byGit.set(s2.gitId, s2);
   }
   return { tokens, adoptedByName, suggestions: [...byGit.values()] };
 }
 function applyConfirmedRenames(tokens, confirmed) {
-  const map = new Map(confirmed.map((s) => [s.figmaId, s.gitId]));
+  const map = new Map(confirmed.map((s2) => [s2.figmaId, s2.gitId]));
   return tokens.map((t3) => map.has(t3.id) ? { ...t3, id: map.get(t3.id) } : t3);
 }
 function idExtensionFor(t3) {
@@ -404,8 +404,8 @@ function combineConflicts(changes) {
   return out;
 }
 function pickedOption(c10, picks) {
-  const n2 = picks[c10.key];
-  return n2 === void 0 ? null : c10.options.find((o2) => o2.changes.includes(n2)) ?? null;
+  const n3 = picks[c10.key];
+  return n3 === void 0 ? null : c10.options.find((o2) => o2.changes.includes(n3)) ?? null;
 }
 const unpicked = (conflicts, picks) => conflicts.filter((c10) => !pickedOption(c10, picks));
 function combineChanges(latest, changes, picks = {}, opts = {}) {
@@ -458,16 +458,16 @@ function combineChanges(latest, changes, picks = {}, opts = {}) {
   return { files, included: on.map((c10) => c10.number), edits: groups.size, tokens, conflicts, missing, from, problems };
 }
 function encodePicks(picks) {
-  return Object.entries(picks).filter(([, n2]) => Number.isSafeInteger(n2) && n2 > 0).sort(([a], [b]) => a.localeCompare(b)).map(([key, n2]) => `${n2}:${key}`).join("~");
+  return Object.entries(picks).filter(([, n3]) => Number.isSafeInteger(n3) && n3 > 0).sort(([a], [b]) => a.localeCompare(b)).map(([key, n3]) => `${n3}:${key}`).join("~");
 }
 function decodePicks(raw) {
   const out = {};
   for (const part of (raw ?? "").split("~")) {
     const i2 = part.indexOf(":");
     if (i2 < 1) continue;
-    const n2 = Number(part.slice(0, i2));
+    const n3 = Number(part.slice(0, i2));
     const key = part.slice(i2 + 1);
-    if (/^\d{1,7}$/.test(part.slice(0, i2)) && n2 > 0 && key.includes("#")) out[key] = n2;
+    if (/^\d{1,7}$/.test(part.slice(0, i2)) && n3 > 0 && key.includes("#")) out[key] = n3;
   }
   return out;
 }
@@ -595,7 +595,7 @@ function requiredCheckNames(defaultBranchRuns, pullRequestRuns) {
   const names2 = [...new Set(defaultBranchRuns.filter((r2) => !isVercel(r2) && ran(r2)).map((r2) => r2.name))];
   if (!pullRequestRuns?.length) return names2;
   const onPulls = new Set(pullRequestRuns.filter((r2) => !isVercel(r2)).map((r2) => r2.name));
-  return names2.filter((n2) => onPulls.has(n2));
+  return names2.filter((n3) => onPulls.has(n3));
 }
 function refPattern(pattern) {
   const src = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "\0").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]").replace(/\u0000/g, ".*");
@@ -664,8 +664,8 @@ function protectionSentence(state) {
     case "unprotected":
       return "Your library can be changed without review.";
     case "partial": {
-      const s = joinAnd(state.missing.map((p) => PROTECTION_PART_PHRASE[p]));
-      return `Partly protected: ${s}.`;
+      const s2 = joinAnd(state.missing.map((p) => PROTECTION_PART_PHRASE[p]));
+      return `Partly protected: ${s2}.`;
     }
     default:
       return "Protection status unknown: GitHub did not let this token read it.";
@@ -989,37 +989,37 @@ class GitHubClient {
    * Marks a draft pull request ready for review. REST cannot unset `draft`, so this is the GraphQL mutation
    * markPullRequestReadyForReview, with the same token (pull requests: write).
    */
-  async markReadyForReview(n2) {
+  async markReadyForReview(n3) {
     this.assertToken("Marking a pull request ready for review");
-    const pr = await this.request("GET", `${this.repoPath}/pulls/${n2}`);
+    const pr = await this.request("GET", `${this.repoPath}/pulls/${n3}`);
     if (pr.draft === false) return;
-    if (!pr.node_id) throw new GitHubError(422, `Pull request #${n2} has no node id: mark it ready for review on GitHub.`);
+    if (!pr.node_id) throw new GitHubError(422, `Pull request #${n3} has no node id: mark it ready for review on GitHub.`);
     const r2 = await this.request("POST", "/graphql", {
       query: "mutation($id: ID!) { markPullRequestReadyForReview(input: { pullRequestId: $id }) { pullRequest { number isDraft } } }",
       variables: { id: pr.node_id }
     });
     if (r2?.errors?.length) {
       const detail = r2.errors.map((e2) => e2.message).filter(Boolean).join(" ");
-      throw new GitHubError(422, `GitHub refused to mark #${n2} ready for review${detail ? `: ${detail}` : "."} Use "Ready for review" on GitHub instead.`, detail);
+      throw new GitHubError(422, `GitHub refused to mark #${n3} ready for review${detail ? `: ${detail}` : "."} Use "Ready for review" on GitHub instead.`, detail);
     }
   }
   /**
    * Turns an open pull request back into a draft: the GraphQL mutation convertPullRequestToDraft (REST cannot set
    * `draft` either), same token. No-op when it is already a draft.
    */
-  async convertToDraft(n2) {
+  async convertToDraft(n3) {
     this.assertToken("Turning a pull request back into a draft");
-    const pr = await this.request("GET", `${this.repoPath}/pulls/${n2}`);
+    const pr = await this.request("GET", `${this.repoPath}/pulls/${n3}`);
     if (pr.draft === true) return;
-    if (pr.state && pr.state !== "open") throw new GitHubError(422, `Pull request #${n2} is ${pr.state}: only an open one can go back to draft.`);
-    if (!pr.node_id) throw new GitHubError(422, `Pull request #${n2} has no node id: convert it to draft on GitHub.`);
+    if (pr.state && pr.state !== "open") throw new GitHubError(422, `Pull request #${n3} is ${pr.state}: only an open one can go back to draft.`);
+    if (!pr.node_id) throw new GitHubError(422, `Pull request #${n3} has no node id: convert it to draft on GitHub.`);
     const r2 = await this.request("POST", "/graphql", {
       query: "mutation($id: ID!) { convertPullRequestToDraft(input: { pullRequestId: $id }) { pullRequest { number isDraft } } }",
       variables: { id: pr.node_id }
     });
     if (r2?.errors?.length) {
       const detail = r2.errors.map((e2) => e2.message).filter(Boolean).join(" ");
-      throw new GitHubError(422, `GitHub refused to turn #${n2} back into a draft${detail ? `: ${detail}` : "."} Use "Convert to draft" on GitHub instead.`, detail);
+      throw new GitHubError(422, `GitHub refused to turn #${n3} back into a draft${detail ? `: ${detail}` : "."} Use "Convert to draft" on GitHub instead.`, detail);
     }
   }
   async createPullRequest(input) {
@@ -1073,18 +1073,18 @@ class GitHubClient {
     const r2 = await this.request("GET", `${this.repoPath}/issues?${q2}`);
     return r2.filter((i2) => !i2.pull_request).map(toIssue);
   }
-  async getIssue(n2) {
-    return toIssue(await this.request("GET", `${this.repoPath}/issues/${n2}`));
+  async getIssue(n3) {
+    return toIssue(await this.request("GET", `${this.repoPath}/issues/${n3}`));
   }
   /** Edits an issue: its body, or closes it with a reason ("not_planned" for a declined request). */
-  async updateIssue(n2, patch) {
+  async updateIssue(n3, patch) {
     this.assertToken("Editing an issue");
-    return toIssue(await this.request("PATCH", `${this.repoPath}/issues/${n2}`, patch));
+    return toIssue(await this.request("PATCH", `${this.repoPath}/issues/${n3}`, patch));
   }
   /** Adds people to an issue's assignees (GitHub ignores logins that cannot be assigned: the result says who is). */
-  async addAssignees(n2, logins) {
+  async addAssignees(n3, logins) {
     this.assertToken("Assigning an issue");
-    const r2 = await this.request("POST", `${this.repoPath}/issues/${n2}/assignees`, { assignees: logins });
+    const r2 = await this.request("POST", `${this.repoPath}/issues/${n3}/assignees`, { assignees: logins });
     return (r2.assignees ?? []).map((a) => a.login);
   }
   /** People with at least `permission` on the repository (reading the list needs push access). First 100. */
@@ -1266,7 +1266,7 @@ class GitHubClient {
     ]);
     const checks = [
       ...runs.map((c10) => ({ name: c10.name, status: c10.status, conclusion: c10.conclusion })),
-      ...combined.statuses.map((s) => ({ name: s.context, status: s.state === "pending" ? "in_progress" : "completed", conclusion: s.state === "pending" ? null : s.state }))
+      ...combined.statuses.map((s2) => ({ name: s2.context, status: s2.state === "pending" ? "in_progress" : "completed", conclusion: s2.state === "pending" ? null : s2.state }))
     ];
     const failing = checks.some((c10) => c10.conclusion && !["success", "neutral", "skipped"].includes(c10.conclusion));
     const pending = checks.some((c10) => c10.status !== "completed");
@@ -1275,7 +1275,7 @@ class GitHubClient {
   /** Commit statuses of a commit, newest first (Vercel reports each project as "Vercel – <project>"). */
   async listCommitStatuses(sha) {
     const r2 = await this.request("GET", `${this.repoPath}/commits/${encodeRef(sha)}/statuses?per_page=100`);
-    return r2.map((s) => ({ context: s.context, state: s.state, target_url: s.target_url ?? null, description: s.description ?? null }));
+    return r2.map((s2) => ({ context: s2.context, state: s2.state, target_url: s2.target_url ?? null, description: s2.description ?? null }));
   }
   /**
    * GitHub deployments of a commit with their latest status (environment "Preview – <project>", environment_url the
@@ -1288,30 +1288,30 @@ class GitHubClient {
     return Promise.all(
       [...latest.values()].map(async (d2) => {
         const st = await this.request("GET", `${this.repoPath}/deployments/${d2.id}/statuses?per_page=1`).catch(() => []);
-        const s = st[0];
-        return { id: d2.id, environment: d2.environment, state: s?.state ?? null, environmentUrl: s?.environment_url || null };
+        const s2 = st[0];
+        return { id: d2.id, environment: d2.environment, state: s2?.state ?? null, environmentUrl: s2?.environment_url || null };
       })
     );
   }
-  async getPullRequest(n2) {
-    const r2 = await this.request("GET", `${this.repoPath}/pulls/${n2}`);
+  async getPullRequest(n3) {
+    const r2 = await this.request("GET", `${this.repoPath}/pulls/${n3}`);
     return { ...toSummary(r2), body: r2.body ?? "", mergeable: r2.mergeable ?? null };
   }
-  async listPullRequestFiles(n2) {
-    const r2 = await this.request("GET", `${this.repoPath}/pulls/${n2}/files?per_page=100`);
+  async listPullRequestFiles(n3) {
+    const r2 = await this.request("GET", `${this.repoPath}/pulls/${n3}/files?per_page=100`);
     return r2.map((f) => ({ filename: f.filename, status: f.status, additions: f.additions, deletions: f.deletions }));
   }
-  async updatePullRequest(n2, patch) {
-    await this.request("PATCH", `${this.repoPath}/pulls/${n2}`, patch);
+  async updatePullRequest(n3, patch) {
+    await this.request("PATCH", `${this.repoPath}/pulls/${n3}`, patch);
   }
-  async listReviews(n2) {
-    const r2 = await this.request("GET", `${this.repoPath}/pulls/${n2}/reviews`);
+  async listReviews(n3) {
+    const r2 = await this.request("GET", `${this.repoPath}/pulls/${n3}/reviews`);
     return r2.map((x) => ({ id: x.id, user: x.user?.login, state: x.state, body: x.body ?? "", ...x.submitted_at ? { submittedAt: x.submitted_at } : {} }));
   }
   /** Submit a review. `COMMENT` works for any collaborator; approving your own PR is refused by GitHub. */
-  async createReview(n2, input) {
+  async createReview(n3, input) {
     this.assertToken("Reviewing a pull request");
-    const r2 = await this.request("POST", `${this.repoPath}/pulls/${n2}/reviews`, input);
+    const r2 = await this.request("POST", `${this.repoPath}/pulls/${n3}/reviews`, input);
     return { id: r2.id, user: r2.user?.login, state: r2.state, body: r2.body ?? "" };
   }
   async listCheckRuns(ref) {
@@ -1816,19 +1816,19 @@ const LIGHTNESS = { 50: 0.975, 100: 0.952, 200: 0.912, 300: 0.85, 400: 0.735, 50
 const BELL = { 50: 0.12, 100: 0.22, 200: 0.4, 300: 0.62, 400: 0.85, 500: 1, 600: 1, 700: 0.92, 800: 0.8, 900: 0.62, 950: 0.5 };
 const NEUTRAL_ANCHORS = { 200: "#E3E8EE", 600: "#5B6672", 900: "#15202B" };
 const PIN_TOLERANCE = 0.04;
-const bellChroma = (peak) => (s) => peak * BELL[s];
-const neutralChroma = (scale = 1, low = 4e-3, base = 0.01, slope = 0.022) => (s) => (s <= 100 ? low : base + slope * (s / 950)) * scale;
-function oklchToLinear(L, C2, h3) {
+const bellChroma = (peak) => (s2) => peak * BELL[s2];
+const neutralChroma = (scale = 1, low = 4e-3, base = 0.01, slope = 0.022) => (s2) => (s2 <= 100 ? low : base + slope * (s2 / 950)) * scale;
+function oklchToLinear(L, C, h3) {
   const hr = h3 * Math.PI / 180;
-  const a = C2 * Math.cos(hr);
-  const b = C2 * Math.sin(hr);
+  const a = C * Math.cos(hr);
+  const b = C * Math.sin(hr);
   const l2 = (L + 0.3963377774 * a + 0.2158037573 * b) ** 3;
   const m2 = (L - 0.1055613458 * a - 0.0638541728 * b) ** 3;
-  const s = (L - 0.0894841775 * a - 1.291485548 * b) ** 3;
+  const s2 = (L - 0.0894841775 * a - 1.291485548 * b) ** 3;
   return [
-    4.0767416621 * l2 - 3.3077115913 * m2 + 0.2309699292 * s,
-    -1.2684380046 * l2 + 2.6097574011 * m2 - 0.3413193965 * s,
-    -0.0041960863 * l2 - 0.7034186147 * m2 + 1.707614701 * s
+    4.0767416621 * l2 - 3.3077115913 * m2 + 0.2309699292 * s2,
+    -1.2684380046 * l2 + 2.6097574011 * m2 - 0.3413193965 * s2,
+    -0.0041960863 * l2 - 0.7034186147 * m2 + 1.707614701 * s2
   ];
 }
 const encode = (x) => {
@@ -1836,8 +1836,8 @@ const encode = (x) => {
   return c10 <= 31308e-7 ? 12.92 * c10 : 1.055 * c10 ** (1 / 2.4) - 0.055;
 };
 const decode = (x) => x <= 0.04045 ? x / 12.92 : ((x + 0.055) / 1.055) ** 2.4;
-function oklch(L, C2, h3) {
-  let c10 = C2;
+function oklch(L, C, h3) {
+  let c10 = C;
   let lin = oklchToLinear(L, c10, h3);
   for (let i2 = 0; i2 < 60 && !lin.every((x) => x >= -5e-4 && x <= 1.0005); i2++) {
     c10 *= 0.95;
@@ -1849,15 +1849,15 @@ function toOklch(rgb) {
   const [r2, g3, b] = rgb.map(decode);
   const l2 = Math.cbrt(0.4122214708 * r2 + 0.5363325363 * g3 + 0.0514459929 * b);
   const m2 = Math.cbrt(0.2119034982 * r2 + 0.6806995451 * g3 + 0.1073969566 * b);
-  const s = Math.cbrt(0.0883024619 * r2 + 0.2817188376 * g3 + 0.6299787005 * b);
-  const L = 0.2104542553 * l2 + 0.793617785 * m2 - 0.0040720468 * s;
-  const A = 1.9779984951 * l2 - 2.428592205 * m2 + 0.4505937099 * s;
-  const B = 0.0259040371 * l2 + 0.7827717662 * m2 - 0.808675766 * s;
-  const C2 = Math.sqrt(A * A + B * B);
-  const h3 = C2 < 1e-6 ? 0 : (Math.atan2(B, A) * 180 / Math.PI + 360) % 360;
-  return { L, C: C2, h: h3 };
-}
-const isHex = (s) => typeof s === "string" && /^#[0-9a-f]{6}$/i.test(s.trim());
+  const s2 = Math.cbrt(0.0883024619 * r2 + 0.2817188376 * g3 + 0.6299787005 * b);
+  const L = 0.2104542553 * l2 + 0.793617785 * m2 - 0.0040720468 * s2;
+  const A = 1.9779984951 * l2 - 2.428592205 * m2 + 0.4505937099 * s2;
+  const B = 0.0259040371 * l2 + 0.7827717662 * m2 - 0.808675766 * s2;
+  const C = Math.sqrt(A * A + B * B);
+  const h3 = C < 1e-6 ? 0 : (Math.atan2(B, A) * 180 / Math.PI + 360) % 360;
+  return { L, C, h: h3 };
+}
+const isHex = (s2) => typeof s2 === "string" && /^#[0-9a-f]{6}$/i.test(s2.trim());
 const fromHex = (hex) => [1, 3, 5].map((i2) => parseInt(hex.slice(i2, i2 + 2), 16) / 255);
 const round3 = (x) => Math.round(x * 1e3) / 1e3;
 const toHex = (rgb) => "#" + rgb.map((x) => Math.round(x * 255).toString(16).padStart(2, "0")).join("");
@@ -1868,35 +1868,35 @@ function dtcgColor(rgb, alpha) {
 }
 function generateRamp({ hue, chroma, offset = () => 0, pins = {} }) {
   const out = {};
-  for (const s of STEPS) {
-    const pin = pins[s];
-    out[s] = pin ? fromHex(pin) : oklch(LIGHTNESS[s] + offset(s), chroma(s), hue);
+  for (const s2 of STEPS) {
+    const pin = pins[s2];
+    out[s2] = pin ? fromHex(pin) : oklch(LIGHTNESS[s2] + offset(s2), chroma(s2), hue);
   }
   return out;
 }
 function nearestStep(rgb) {
   const { L } = toOklch(rgb);
   let best = STEPS[0];
-  for (const s of STEPS) if (Math.abs(LIGHTNESS[s] - L) < Math.abs(LIGHTNESS[best] - L)) best = s;
+  for (const s2 of STEPS) if (Math.abs(LIGHTNESS[s2] - L) < Math.abs(LIGHTNESS[best] - L)) best = s2;
   return best;
 }
 function anchoredRamp(hex, pinStep) {
   const rgb = fromHex(hex);
-  const { L, C: C2, h: h3 } = toOklch(rgb);
+  const { L, C, h: h3 } = toOklch(rgb);
   const step = pinStep ?? nearestStep(rgb);
-  const peak = Math.min(0.24, Math.max(0.02, C2 / BELL[step]));
+  const peak = Math.min(0.24, Math.max(0.02, C / BELL[step]));
   return { hue: h3, peak, step, distance: Math.abs(L - LIGHTNESS[step]), ramp: generateRamp({ hue: h3, chroma: bellChroma(peak), pins: { [step]: hex.toUpperCase() } }) };
 }
 function neutralOffset() {
   const off = {};
-  for (const [s, hex] of Object.entries(NEUTRAL_ANCHORS)) off[s] = toOklch(fromHex(hex)).L - LIGHTNESS[s];
-  return (s) => off[s] ?? 0;
+  for (const [s2, hex] of Object.entries(NEUTRAL_ANCHORS)) off[s2] = toOklch(fromHex(hex)).L - LIGHTNESS[s2];
+  return (s2) => off[s2] ?? 0;
 }
 function tintedNeutral(hex) {
   const rgb = fromHex(hex);
-  const { C: C2, h: h3 } = toOklch(rgb);
+  const { C, h: h3 } = toOklch(rgb);
   const ref = neutralChroma()(nearestStep(rgb));
-  const scale = C2 < 4e-3 ? 0 : Math.min(2.5, C2 / ref);
+  const scale = C < 4e-3 ? 0 : Math.min(2.5, C / ref);
   return { hue: h3, scale, ramp: generateRamp({ hue: h3, chroma: neutralChroma(scale), offset: neutralOffset() }) };
 }
 const BRAND_FONTS = [
@@ -1968,8 +1968,8 @@ function rampFor(input, pinStep, kind) {
   const hex = String(input).trim();
   if (!isHex(hex)) throw new Error(`"${hex}" is not a color. Use #rrggbb or a hue in degrees (0 to 360).`);
   if (kind === "neutral") {
-    const n2 = tintedNeutral(hex);
-    return { ramp: n2.ramp, anchor: `${hex.toUpperCase()} (hue ${Math.round(n2.hue)})` };
+    const n3 = tintedNeutral(hex);
+    return { ramp: n3.ramp, anchor: `${hex.toUpperCase()} (hue ${Math.round(n3.hue)})` };
   }
   const a = anchoredRamp(hex, pinStep);
   const issue = a.distance > PIN_TOLERANCE ? {
@@ -1982,9 +1982,9 @@ function rampFor(input, pinStep, kind) {
 function aliasRamp(doc, role, ramp, description) {
   const group = getAt(doc, `palette.${role}`);
   if (!group) return;
-  for (const s of STEPS) {
-    if (!(String(s) in group)) continue;
-    setAt(doc, `palette.${role}.${s}`, { $value: `{color.${ramp}.${s}}` });
+  for (const s2 of STEPS) {
+    if (!(String(s2) in group)) continue;
+    setAt(doc, `palette.${role}.${s2}`, { $value: `{color.${ramp}.${s2}}` });
   }
   group.$description = description;
 }
@@ -2031,15 +2031,15 @@ function listBrands(source) {
 }
 function checkBrandSlug(config, files, slug) {
   const out = [];
-  const s = slug.trim();
-  if (!s) return [{ level: "error", code: "slug-empty", message: "Give the brand a name." }];
-  if (s.length < 2 || s.length > 24 || !BRAND_SLUG_RE.test(s)) out.push({ level: "error", code: "slug-format", message: 'Use 2 to 24 lowercase letters, digits and single dashes, starting with a letter: "acme" or "north-star".' });
+  const s2 = slug.trim();
+  if (!s2) return [{ level: "error", code: "slug-empty", message: "Give the brand a name." }];
+  if (s2.length < 2 || s2.length > 24 || !BRAND_SLUG_RE.test(s2)) out.push({ level: "error", code: "slug-format", message: 'Use 2 to 24 lowercase letters, digits and single dashes, starting with a letter: "acme" or "north-star".' });
   const taken = Object.values(config.axes).flatMap((a) => a.values);
-  if (config.axes.brand?.values.includes(s)) out.push({ level: "error", code: "slug-taken", message: `A brand called "${s}" already exists. Pick another name or edit that brand.` });
-  else if (taken.includes(s) || RESERVED.has(s)) out.push({ level: "error", code: "slug-reserved", message: `"${s}" is a reserved mode name. Pick another name.` });
+  if (config.axes.brand?.values.includes(s2)) out.push({ level: "error", code: "slug-taken", message: `A brand called "${s2}" already exists. Pick another name or edit that brand.` });
+  else if (taken.includes(s2) || RESERVED.has(s2)) out.push({ level: "error", code: "slug-reserved", message: `"${s2}" is a reserved mode name. Pick another name.` });
   const layer = brandLayers(config).brand;
   const map = fileMap(files);
-  if (layer && !config.axes.brand?.values.includes(s) && map.has(fill(layer, { brand: s }))) out.push({ level: "error", code: "slug-file-exists", message: `${tokensPath(config, fill(layer, { brand: s }))} already exists. Pick another name or add it to bridge.config.json.` });
+  if (layer && !config.axes.brand?.values.includes(s2) && map.has(fill(layer, { brand: s2 }))) out.push({ level: "error", code: "slug-file-exists", message: `${tokensPath(config, fill(layer, { brand: s2 }))} already exists. Pick another name or add it to bridge.config.json.` });
   return out;
 }
 function planNewBrand(source, input) {
@@ -2219,7 +2219,7 @@ function planNewBrand(source, input) {
   const ramps = {};
   if (inGate) {
     const combo = after.normalizeCombo({ brand: slug });
-    const read = (role) => STEPS.map((s) => ({ step: s, hex: after.resolve(`palette.${role}.${s}`, combo).css })).filter((x) => /^#[0-9a-f]{6}$/i.test(x.hex));
+    const read = (role) => STEPS.map((s2) => ({ step: s2, hex: after.resolve(`palette.${role}.${s2}`, combo).css })).filter((x) => /^#[0-9a-f]{6}$/i.test(x.hex));
     ramps.primary = read("primary");
     ramps.neutral = read("neutral");
     for (const role of ["accent", "link"]) {
@@ -2281,13 +2281,13 @@ function brandPreviewVariables(source, plan, theme) {
   }
   return out;
 }
-const code = (s) => `\`${s}\``;
+const code = (s2) => `\`${s2}\``;
 function newBrandSection(plan) {
   const roles = Object.keys(plan.ramps);
   const rampTable = roles.length ? [
     `| Step | ${roles.map((r2) => r2[0].toUpperCase() + r2.slice(1)).join(" | ")} |`,
     `| --- | ${roles.map(() => "---").join(" | ")} |`,
-    ...STEPS.map((s) => `| ${s}${s === plan.actionStep ? " (actions)" : ""} | ${roles.map((r2) => code(plan.ramps[r2].find((x) => x.step === s)?.hex ?? "")).join(" | ")} |`)
+    ...STEPS.map((s2) => `| ${s2}${s2 === plan.actionStep ? " (actions)" : ""} | ${roles.map((r2) => code(plan.ramps[r2].find((x) => x.step === s2)?.hex ?? "")).join(" | ")} |`)
   ].join("\n") : "_No ramps resolved._";
   const c10 = plan.contrast;
   const contrastLine = c10.failing.length ? `**${c10.failing.length} of ${c10.checks} pairs fail** for ${plan.name} (${c10.themes.join(" and ")}).` : `All ${c10.checks} contrast checks pass for ${plan.name} in ${c10.themes.join(" and ")}.`;
@@ -2311,7 +2311,7 @@ function newBrandSection(plan) {
 }
 function composeNewBrandBody(plan, opts) {
   const t3 = plan.risk.tier;
-  const box = (n2) => `- ${n2 === t3 ? "[x]" : "[ ]"} ${RISK_LABELS[n2]}`;
+  const box = (n3) => `- ${n3 === t3 ? "[x]" : "[ ]"} ${RISK_LABELS[n3]}`;
   const errors = plan.issues.filter((i2) => i2.level === "error");
   const warnings = plan.issues.filter((i2) => i2.level === "warning");
   return [
@@ -2376,7 +2376,7 @@ function cssModuleClasses(css) {
   }
   return out;
 }
-const cell$1 = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
+const cell$1 = (s2) => s2.replace(/\|/g, "\\|").replace(/\n/g, " ");
 function propsTable(name, props, inherits) {
   if (!props.length) return inherits ? `${name} has no props of its own. It accepts every native <${inherits}> attribute.` : "";
   const rows = props.map((p) => `| \`${p.name}\`${p.required ? " (required)" : ""} | \`${cell$1(p.type)}\` | ${p.defaultValue ? `\`${cell$1(p.defaultValue)}\`` : ""} | ${cell$1(p.description ?? "")} |`);
@@ -2519,9 +2519,9 @@ function formatDocsJson(d2) {
 function patchNode(old, next) {
   if (plainEqual(toPlain(old), next)) return old;
   if (old.kind === "object" && next && typeof next === "object" && !Array.isArray(next)) {
-    const n2 = next;
-    const kept = old.entries.filter((e2) => n2[e2.key] !== void 0).map((e2) => ({ key: e2.key, value: patchNode(e2.value, n2[e2.key]) }));
-    const added = Object.keys(n2).filter((k3) => n2[k3] !== void 0 && !getEntry(old, k3)).map((k3) => ({ key: k3, value: fromPlain(n2[k3], void 0, old.inline) }));
+    const n3 = next;
+    const kept = old.entries.filter((e2) => n3[e2.key] !== void 0).map((e2) => ({ key: e2.key, value: patchNode(e2.value, n3[e2.key]) }));
+    const added = Object.keys(n3).filter((k3) => n3[k3] !== void 0 && !getEntry(old, k3)).map((k3) => ({ key: k3, value: fromPlain(n3[k3], void 0, old.inline) }));
     return { kind: "object", inline: old.inline, entries: [...kept, ...added] };
   }
   if (old.kind === "array" && Array.isArray(next)) {
@@ -2547,16 +2547,16 @@ const DOCS_CHANGE_BUMP = "patch";
 function cleanDraftText(text) {
   return text.replace(/\s*\u2014\s*/g, ", ").replace(/,\s*,/g, ",").replace(/^,\s*/, "").replace(/[ \t]+/g, " ").trim();
 }
-const values = (s) => (s ?? "").split(", ").map((x) => x.trim()).filter(Boolean);
+const values = (s2) => (s2 ?? "").split(", ").map((x) => x.trim()).filter(Boolean);
 const article = (word) => /^[aeiou]/i.test(word) ? "an" : "a";
 const andList = (xs) => xs.length <= 1 ? xs[0] ?? "" : `${xs.slice(0, -1).join(", ")} and ${xs[xs.length - 1]}`;
-const plural = (n2, word, many = `${word}s`) => `${n2} ${n2 === 1 ? word : many}`;
-const capital = (s) => s.charAt(0).toUpperCase() + s.slice(1);
-const lower = (s) => s.charAt(0).toLowerCase() + s.slice(1);
-function propShape(s) {
-  if (!s) return void 0;
-  const m2 = /^(.*?), default (.*)$/.exec(s);
-  return m2 ? { type: m2[1], def: m2[2] } : { type: s, def: "" };
+const plural = (n3, word, many = `${word}s`) => `${n3} ${n3 === 1 ? word : many}`;
+const capital = (s2) => s2.charAt(0).toUpperCase() + s2.slice(1);
+const lower = (s2) => s2.charAt(0).toLowerCase() + s2.slice(1);
+function propShape(s2) {
+  if (!s2) return void 0;
+  const m2 = /^(.*?), default (.*)$/.exec(s2);
+  return m2 ? { type: m2[1], def: m2[2] } : { type: s2, def: "" };
 }
 const VARIANT_FIRST = ["variant", "tone", "intent", "appearance", "kind", "type", "style"];
 function shortVariant(key) {
@@ -2842,19 +2842,19 @@ function parseDocsReply(text) {
   if (!json || typeof json !== "object" || Array.isArray(json)) throw new Error("The reply is not a docs.json object.");
   return json;
 }
-const cleanDocsText = (s) => cleanDraftText(s.replace(/[\r\n]+/g, " "));
+const cleanDocsText = (s2) => cleanDraftText(s2.replace(/[\r\n]+/g, " "));
 const isExample = (x) => {
   if (typeof x === "string") return true;
   if (!x || typeof x !== "object" || Array.isArray(x)) return false;
-  const n2 = x;
-  if (typeof n2.c !== "string" || !n2.c) return false;
-  if (n2.p !== void 0 && (!n2.p || typeof n2.p !== "object" || Array.isArray(n2.p))) return false;
-  return n2.children === void 0 || Array.isArray(n2.children) && n2.children.every(isExample);
+  const n3 = x;
+  if (typeof n3.c !== "string" || !n3.c) return false;
+  if (n3.p !== void 0 && (!n3.p || typeof n3.p !== "object" || Array.isArray(n3.p))) return false;
+  return n3.children === void 0 || Array.isArray(n3.children) && n3.children.every(isExample);
 };
 const textList = (x) => {
   if (typeof x === "string") x = [x];
   if (!Array.isArray(x)) return void 0;
-  const out = x.filter((s) => typeof s === "string").map(cleanDocsText).filter(Boolean);
+  const out = x.filter((s2) => typeof s2 === "string").map(cleanDocsText).filter(Boolean);
   return out.length ? out : void 0;
 };
 const guidanceList = (x, examples) => {
@@ -2877,8 +2877,8 @@ function sanitizeDocsSections(raw, keys = PROSE_KEYS, opts = {}) {
   for (const k3 of keys) {
     const v2 = r2[k3];
     if (k3 === "summary") {
-      const s = typeof v2 === "string" ? cleanDocsText(v2) : "";
-      if (s) out.summary = s;
+      const s2 = typeof v2 === "string" ? cleanDocsText(v2) : "";
+      if (s2) out.summary = s2;
     } else if (k3 === "dos" || k3 === "donts") {
       const g3 = guidanceList(v2, opts.examples ?? false);
       if (g3) out[k3] = g3;
@@ -2970,9 +2970,9 @@ const EXPLORATION_STATUS_LABEL = { active: "Running", promoted: "Promoted to rev
 const MARK$1 = "bridge-exploration";
 const SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 function explorationSlug(name) {
-  const s = name.trim().replace(/^explore\//i, "");
-  if (!/[a-z0-9]/i.test(s)) return "";
-  return slugify(s, 40);
+  const s2 = name.trim().replace(/^explore\//i, "");
+  if (!/[a-z0-9]/i.test(s2)) return "";
+  return slugify(s2, 40);
 }
 function explorationBranch(nameOrBranch) {
   return `${EXPLORATION_PREFIX}${explorationSlug(nameOrBranch)}`;
@@ -3013,8 +3013,8 @@ function explorationNote(e2) {
   ].join("\n");
 }
 function explorationPrTitle(e2) {
-  const n2 = e2.name.trim().replace(/\.$/, "");
-  return `Exploration: ${n2.charAt(0).toLowerCase()}${n2.slice(1)}`;
+  const n3 = e2.name.trim().replace(/\.$/, "");
+  return `Exploration: ${n3.charAt(0).toLowerCase()}${n3.slice(1)}`;
 }
 function explorationPrBody(e2, ctx) {
   const slug = e2.slug || explorationSlug(e2.name);
@@ -3079,6 +3079,8 @@ function explorationStatus(p) {
 const isActiveExploration = (labels) => labelNames(labels).includes(EXPLORATION_LABEL);
 function promotionPlan(input) {
   const exploration = parseExplorationBody(input.body);
+  const jira = /^([A-Z][A-Z0-9_]*-\d+)\s+/.exec(input.title)?.[1] ?? null;
+  const title = jira ? input.title.slice(jira.length).trim() : input.title;
   const removeFiles = input.files.filter((f) => f.path.startsWith(`${EXPLORATION_NOTES_DIR}/`) && f.status !== "removed").map((f) => f.path);
   const files = input.files.filter((f) => !f.path.startsWith(`${EXPLORATION_NOTES_DIR}/`));
   const risk = classifyRisk({ files, ...input.config ? { config: input.config } : {} });
@@ -3086,18 +3088,18 @@ function promotionPlan(input) {
   const addLabels = [`tier: ${risk.tier}`, ...risk.tier === 3 && tokens ? ["tokens"] : []];
   const date = (input.date ?? /* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const existing = new Set(input.body ? [...input.body.matchAll(/\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\s+#(\d+)/gi)].map((m2) => Number(m2[1])) : []);
-  const closes = [...new Set(input.requests ?? [])].filter((n2) => !existing.has(n2));
+  const closes = [...new Set(input.requests ?? [])].filter((n3) => !existing.has(n3));
   const kept = (input.body ?? "").replace(/^> Not mergeable as is\..*$\n?\n?/m, "").replace(/### When it is done[\s\S]*?(?=<!-- |$)/, "").replace(/^## Exploration: /m, "## ").trim();
   const body = [
     `**Promoted from an exploration on ${date}.** Review it like any change: the tier below comes from the files it touches.`,
     "",
-    kept || `## ${input.title.replace(/^Exploration:\s*/i, "")}`,
+    kept || `## ${title.replace(/^Exploration:\s*/i, "")}`,
     "",
     `**Risk tier:** ${risk.tier}.`,
     ...risk.reasons.slice(0, 8).map((r2) => `- ${r2}`),
-    ...closes.length ? ["", ...closes.map((n2) => `Closes #${n2}`)] : []
+    ...closes.length ? ["", ...closes.map((n3) => `Closes #${n3}`)] : []
   ].join("\n");
-  const t3 = input.title.replace(/^Exploration:\s*/i, "").trim() || exploration?.name || input.title;
+  const t3 = title.replace(/^Exploration:\s*/i, "").trim() || exploration?.name || title;
   return {
     tier: risk.tier,
     reasons: risk.reasons,
@@ -3105,7 +3107,7 @@ function promotionPlan(input) {
     addLabels,
     removeFiles,
     body,
-    title: t3.charAt(0).toUpperCase() + t3.slice(1),
+    title: `${jira ? `${jira} ` : ""}${t3.charAt(0).toUpperCase()}${t3.slice(1)}`,
     markReady: true
   };
 }
@@ -3249,8 +3251,8 @@ function requestBrief(r2, ctx) {
     "- If the request is unclear or conflicts with the guidance, comment on the issue instead of guessing."
   ].join("\n");
 }
-const cell = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
-const sourceLabel = (s) => s === "figma" ? "Figma" : s === "studio" ? "Bridge Studio" : s === "cli" ? "the CLI" : "Claude (MCP)";
+const cell = (s2) => s2.replace(/\|/g, "\\|").replace(/\n/g, " ");
+const sourceLabel = (s2) => s2 === "figma" ? "Figma" : s2 === "studio" ? "Bridge Studio" : s2 === "cli" ? "the CLI" : "Claude (MCP)";
 function validateIntegrations(i2) {
   const out = [];
   if (!i2?.jira) return out;
@@ -3308,7 +3310,7 @@ function newDraftSessionId(random = Math.random) {
   return out;
 }
 const SESSION_RE = /^[a-z0-9-]{6,64}$/;
-const isDraftSessionId = (s) => typeof s === "string" && SESSION_RE.test(s);
+const isDraftSessionId = (s2) => typeof s2 === "string" && SESSION_RE.test(s2);
 function draftSessionPath(sessionId) {
   if (!isDraftSessionId(sessionId)) throw new Error(`"${sessionId}" is not a draft session id.`);
   return `${DRAFTS_DIR}/${sessionId}.json`;
@@ -3345,8 +3347,8 @@ function validatePendingDrafts(x) {
   if (p.source !== "figma" && p.source !== "studio") out.push('source must be "figma" or "studio".');
   if (!Array.isArray(p.items) || !p.items.length) out.push("A draft session needs at least one item.");
   const ids = /* @__PURE__ */ new Set();
-  for (const [n2, i2] of (Array.isArray(p.items) ? p.items : []).entries()) {
-    const at2 = `Item ${n2 + 1}`;
+  for (const [n3, i2] of (Array.isArray(p.items) ? p.items : []).entries()) {
+    const at2 = `Item ${n3 + 1}`;
     if (!i2 || typeof i2 !== "object") {
       out.push(`${at2} is not an object.`);
       continue;
@@ -3405,7 +3407,7 @@ function clip(text, max) {
 function sentences(text) {
   const t3 = text.replace(/\s+/g, " ").trim();
   const parts = t3.match(/[^.!?]+(?:[.!?]+(?=\s|$)|$)/g) ?? [t3];
-  let out = parts.slice(0, DRAFT_SUMMARY_SENTENCES).map((s) => s.trim()).join(" ");
+  let out = parts.slice(0, DRAFT_SUMMARY_SENTENCES).map((s2) => s2.trim()).join(" ");
   if (out.length > SUMMARY_MAX) out = `${clip(out, SUMMARY_MAX)}.`;
   return out;
 }
@@ -3478,7 +3480,7 @@ function draftItemBrief(i2) {
     return [`Item ${i2.id}: component docs${i2.component ? ` of ${i2.component}` : ""} from Bridge Studio (${i2.docs.path ?? i2.docs.slug}): ${what}.`, "", i2.docs.prompt].join("\n");
   }
   const kind = i2.kind ? REQUEST_KINDS.find((k3) => k3.value === i2.kind)?.label : void 0;
-  const cell2 = (s) => (s ?? "").replace(/\|/g, "\\|").replace(/\n/g, " ");
+  const cell2 = (s2) => (s2 ?? "").replace(/\|/g, "\\|").replace(/\n/g, " ");
   const lines = [`Item ${i2.id}: ${i2.scope === "request" ? "a component change request (a GitHub issue developers implement)" : "the description of a pull request with design token (variable) edits from Figma"}.`];
   if (i2.component) lines.push(`Component: ${i2.component}`);
   if (kind) lines.push(`Kind: ${kind}`);
@@ -3645,7 +3647,7 @@ class DraftPoller {
     }
   }
 }
-function explorationSummary(p, _owner, _repo, s) {
+function explorationSummary(p, _owner, _repo, s2) {
   const e2 = parseExplorationBody(p.body);
   const slug = p.headRef?.startsWith(EXPLORATION_PREFIX) ? p.headRef.slice(EXPLORATION_PREFIX.length) : e2?.slug ?? explorationSlug(p.title);
   return {
@@ -3653,7 +3655,7 @@ function explorationSummary(p, _owner, _repo, s) {
     url: p.url,
     branch: p.headRef,
     slug,
-    name: e2?.name ?? p.title.replace(/^Exploration:\s*/i, ""),
+    name: e2?.name ?? p.title.replace(/^[A-Z][A-Z0-9_]*-\d+\s+/, "").replace(/^Exploration:\s*/i, ""),
     purpose: e2?.purpose ?? "",
     ...e2?.useCase ? { useCase: e2.useCase } : {},
     status: explorationStatus({ state: p.state, labels: p.labels, headRef: p.headRef, body: p.body }),
@@ -3663,14 +3665,14 @@ function explorationSummary(p, _owner, _repo, s) {
     ...e2?.agent ? { agent: e2.agent } : {},
     updatedAt: p.updatedAt,
     headSha: p.headSha,
-    previews: previewLinks(s.apps, { branch: p.headRef, pr: p.number, sha: p.headSha })
+    previews: previewLinks(s2.apps, { branch: p.headRef, pr: p.number, sha: p.headSha })
   };
 }
-async function listExplorationsOnGitHub(gh, s, opts = {}) {
+async function listExplorationsOnGitHub(gh, s2, opts = {}) {
   const pulls = await gh.listPullRequests(opts.state ?? "open");
-  return pulls.filter((p) => isExplorationPull({ state: p.state, labels: p.labels, headRef: p.headRef, body: p.body })).map((p) => explorationSummary(p, gh.owner, gh.name, s));
+  return pulls.filter((p) => isExplorationPull({ state: p.state, labels: p.labels, headRef: p.headRef, body: p.body })).map((p) => explorationSummary(p, gh.owner, gh.name, s2));
 }
-async function startExplorationOnGitHub(gh, e2, s) {
+async function startExplorationOnGitHub(gh, e2, s2) {
   const problems = explorationProblems(e2);
   if (problems.length) throw new GitHubError(422, problems.join(" "));
   if (!gh.canWrite) throw new GitHubError(401, "Starting an exploration needs a GitHub token (contents and pull requests, read and write, on this repository only).");
@@ -3680,7 +3682,7 @@ async function startExplorationOnGitHub(gh, e2, s) {
   if (await x.getBranchSha(branch)) throw new GitHubError(422, `An exploration named "${slug}" already exists (${branch}). Pick another name, or continue that one.`);
   const full = { ...e2, slug, startedAt: e2.startedAt ?? (/* @__PURE__ */ new Date()).toISOString() };
   const commit = await x.commitToNewBranch({
-    base: s.base,
+    base: s2.base,
     branch,
     message: `chore(explore): start ${full.name.trim()}
 
@@ -3689,8 +3691,9 @@ ${full.purpose.trim()}
 Exploration: never merged as is. Promote it to review or close it.`,
     files: [{ path: explorationNotePath(slug), content: explorationNote(full) }]
   });
-  const ctx = { owner: gh.owner, repo: gh.name, packages: s.packages, apps: s.apps, ...s.requests?.length ? { requests: s.requests } : {} };
-  const pr = await x.createPullRequest({ title: explorationPrTitle(full), head: branch, base: s.base, body: explorationPrBody(full, ctx), draft: true });
+  const ctx = { owner: gh.owner, repo: gh.name, packages: s2.packages, apps: s2.apps, ...s2.requests?.length ? { requests: s2.requests } : {} };
+  const title = full.jira ? `${full.jira.trim().toUpperCase()} ${explorationPrTitle(full)}` : explorationPrTitle(full);
+  const pr = await x.createPullRequest({ title, head: branch, base: s2.base, body: explorationPrBody(full, ctx), draft: true });
   await x.addLabels(pr.number, [EXPLORATION_LABEL]);
   await x.updatePullRequest(pr.number, { body: explorationPrBody(full, { ...ctx, pr: pr.number }) }).catch(() => void 0);
   return {
@@ -3700,7 +3703,7 @@ Exploration: never merged as is. Promote it to review or close it.`,
     url: pr.url,
     commit: commit.sha,
     tryIt: { state: "building" },
-    previews: previewLinks(s.apps, { branch, pr: pr.number, sha: commit.sha })
+    previews: previewLinks(s2.apps, { branch, pr: pr.number, sha: commit.sha })
   };
 }
 async function explorationTryItOnGitHub(gh, e2) {
@@ -3756,59 +3759,313 @@ async function closeExplorationOnGitHub(gh, ref) {
   await gh.updatePullRequest(p.number, { state: "closed" });
   return { number: p.number, url: p.url, branch: p.headRef };
 }
-async function linkRequestToExplorationOnGitHub(gh, n2, branch, opts = {}) {
+async function linkRequestToExplorationOnGitHub(gh, n3, branch, opts = {}) {
   if (!isExplorationBranch(branch)) throw new GitHubError(422, `"${branch}" is not an exploration branch. Exploration branches are named explore/<name>.`);
-  const issue = await gh.getIssue(n2);
+  const issue = await gh.getIssue(n3);
   const body = withRequestExploration(issue.body, branch);
-  if (!body) throw new GitHubError(422, `#${n2} has no Bridge request block, so it cannot be linked. Add "exploration: ${branch}" to it on GitHub.`);
-  await gh.updateIssue(n2, { body });
+  if (!body) throw new GitHubError(422, `#${n3} has no Bridge request block, so it cannot be linked. Add "exploration: ${branch}" to it on GitHub.`);
+  await gh.updateIssue(n3, { body });
   const warnings = [];
-  if (!await gh.addLabels(n2, [EXPLORATION_LABEL])) warnings.push(`The ${EXPLORATION_LABEL} label could not be added to #${n2}.`);
+  if (!await gh.addLabels(n3, [EXPLORATION_LABEL])) warnings.push(`The ${EXPLORATION_LABEL} label could not be added to #${n3}.`);
   let assignees = [];
   if (opts.assignee) {
     try {
-      assignees = await gh.addAssignees(n2, [opts.assignee.replace(/^@/, "")]);
+      assignees = await gh.addAssignees(n3, [opts.assignee.replace(/^@/, "")]);
     } catch {
-      warnings.push(`@${opts.assignee.replace(/^@/, "")} could not be assigned to #${n2}.`);
+      warnings.push(`@${opts.assignee.replace(/^@/, "")} could not be assigned to #${n3}.`);
     }
   }
-  return { number: n2, branch, assignees, warnings };
+  return { number: n3, branch, assignees, warnings };
 }
-async function assignRequestOnGitHub(gh, n2, login) {
+async function assignRequestOnGitHub(gh, n3, login) {
   const who = login.trim().replace(/^@/, "");
   if (!who) throw new GitHubError(422, "Pick who should work on it.");
-  const assignees = await gh.addAssignees(n2, [who]);
+  const assignees = await gh.addAssignees(n3, [who]);
   if (!assignees.some((a) => a.toLowerCase() === who.toLowerCase())) throw new GitHubError(422, `GitHub did not assign @${who}: they need access to this repository.`);
   return assignees;
 }
-async function declineRequestOnGitHub(gh, n2, reason, by2) {
+async function declineRequestOnGitHub(gh, n3, reason, by2) {
   const problems = declineReasonProblems(reason);
   if (problems.length) throw new GitHubError(422, problems.join(" "));
-  await gh.addComment(n2, declineComment(reason, by2));
-  await gh.updateIssue(n2, { state: "closed", state_reason: "not_planned" });
+  await gh.addComment(n3, declineComment(reason, by2));
+  await gh.updateIssue(n3, { state: "closed", state_reason: "not_planned" });
+}
+const FIDELITY_DEFAULTS = { scale: 2, threshold: 0.1, maxPercent: 3, sizeTolerance: 1 };
+const MAX_DELTA = 35215;
+const STRICT_THRESHOLD = 0.02;
+function rgbAt(img, x, y) {
+  if (x < 0 || y < 0 || x >= img.width || y >= img.height) return [255, 255, 255];
+  const i2 = (y * img.width + x) * 4;
+  const a = img.data[i2 + 3] / 255;
+  return [255 + (img.data[i2] - 255) * a, 255 + (img.data[i2 + 1] - 255) * a, 255 + (img.data[i2 + 2] - 255) * a];
+}
+function colorDelta(a, b) {
+  const dr = a[0] - b[0];
+  const dg = a[1] - b[1];
+  const db = a[2] - b[2];
+  const y = dr * 0.29889531 + dg * 0.58662247 + db * 0.11448223;
+  const i2 = dr * 0.59597799 - dg * 0.2741761 - db * 0.32180189;
+  const q2 = dr * 0.21147017 - dg * 0.52261711 + db * 0.31114694;
+  return 0.5053 * y * y + 0.299 * i2 * i2 + 0.1957 * q2 * q2;
+}
+function foundNear(img, x, y, c10, radius, max) {
+  for (let dy = -radius; dy <= radius; dy++) for (let dx = -radius; dx <= radius; dx++) if (colorDelta(c10, rgbAt(img, x + dx, y + dy)) <= max) return true;
+  return false;
+}
+function compareImages(figma, code2, options = {}) {
+  const scale = options.scale ?? FIDELITY_DEFAULTS.scale;
+  const radius = Math.max(0, Math.round(options.radius ?? scale));
+  const max = MAX_DELTA * (options.threshold ?? FIDELITY_DEFAULTS.threshold) ** 2;
+  const strict = MAX_DELTA * STRICT_THRESHOLD ** 2;
+  const width = Math.max(figma.width, code2.width);
+  const height = Math.max(figma.height, code2.height);
+  const total = width * height;
+  const wantDiff = options.diffImage !== false;
+  const out = wantDiff ? new Uint8ClampedArray(total * 4) : void 0;
+  let different = 0;
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const a = rgbAt(figma, x, y);
+      const b = rgbAt(code2, x, y);
+      const m2 = x < Math.min(figma.width, code2.width) && y < Math.min(figma.height, code2.height) ? max : strict;
+      const same = colorDelta(a, b) <= m2 || foundNear(code2, x, y, a, radius, m2) && foundNear(figma, x, y, b, radius, m2);
+      if (!same) different++;
+      if (out) {
+        const o2 = (y * width + x) * 4;
+        if (same) {
+          const gray = 255 + (b[0] * 0.299 + b[1] * 0.587 + b[2] * 0.114 - 255) * 0.1;
+          out[o2] = out[o2 + 1] = out[o2 + 2] = gray;
+        } else {
+          out[o2] = 220;
+          out[o2 + 1] = 38;
+          out[o2 + 2] = 38;
+        }
+        out[o2 + 3] = 255;
+      }
+    }
+  }
+  const css = (img) => ({ width: Math.round(img.width / scale), height: Math.round(img.height / scale) });
+  const size = { figma: css(figma), code: css(code2) };
+  const tol = options.sizeTolerance ?? FIDELITY_DEFAULTS.sizeTolerance;
+  const sizeMatches = Math.abs(size.figma.width - size.code.width) <= tol && Math.abs(size.figma.height - size.code.height) <= tol;
+  const percent = total ? Math.round(different / total * 1e4) / 100 : 0;
+  return {
+    matches: sizeMatches && percent <= (options.maxPercent ?? FIDELITY_DEFAULTS.maxPercent),
+    percent,
+    differentPixels: different,
+    totalPixels: total,
+    size,
+    sizeMatches,
+    ...out ? { diff: { width, height, data: out } } : {}
+  };
+}
+function summarizeComponent(component, variants, reason) {
+  const compared = variants.filter((v2) => v2.status !== "skipped");
+  const differing = compared.filter((v2) => v2.status === "differs");
+  const rank = (v2) => (v2.status === "differs" ? 1e3 : 0) + (v2.percent ?? 0) + (v2.size && !sameSize(v2.size) ? 500 : 0);
+  const worst = [...compared].sort((a, b) => rank(b) - rank(a))[0];
+  return {
+    component,
+    status: compared.length === 0 ? "not-checked" : differing.length ? "differs" : "matches",
+    checked: compared.length,
+    differing: differing.length,
+    skipped: variants.length - compared.length,
+    ...worst && worst.size ? { worst: { key: worst.key, percent: worst.percent ?? 0, size: worst.size } } : {},
+    ...compared.length === 0 ? { reason: reason ?? variants.find((v2) => v2.reason)?.reason } : {},
+    variants
+  };
+}
+const sameSize = (s2) => s2.figma.width === s2.code.width && s2.figma.height === s2.code.height;
+function buildFidelityReport(input) {
+  const o2 = input.options ?? {};
+  const scale = o2.scale ?? FIDELITY_DEFAULTS.scale;
+  const c10 = input.components;
+  return {
+    version: 1,
+    checkedAt: (input.now ?? /* @__PURE__ */ new Date()).toISOString(),
+    ...input.file ? { file: input.file } : {},
+    reference: input.reference,
+    options: {
+      scale,
+      threshold: o2.threshold ?? FIDELITY_DEFAULTS.threshold,
+      radius: Math.round(o2.radius ?? scale),
+      maxPercent: o2.maxPercent ?? FIDELITY_DEFAULTS.maxPercent,
+      sizeTolerance: o2.sizeTolerance ?? FIDELITY_DEFAULTS.sizeTolerance
+    },
+    components: c10,
+    summary: {
+      components: c10.length,
+      matches: c10.filter((x) => x.status === "matches").length,
+      differs: c10.filter((x) => x.status === "differs").length,
+      notChecked: c10.filter((x) => x.status === "not-checked").length,
+      variantsChecked: c10.reduce((n3, x) => n3 + x.checked, 0),
+      variantsSkipped: c10.reduce((n3, x) => n3 + x.skipped, 0)
+    }
+  };
+}
+const fmtPercent = (p) => p >= 10 ? `${Math.round(p)}%` : p >= 1 ? `${Math.round(p * 10) / 10}%` : p > 0 ? "under 1%" : "0%";
+const fmtSize = (s2) => `${s2.width}x${s2.height}`;
+function fidelityVerdict(v2) {
+  if (v2.status === "skipped") return `Not compared: ${v2.reason ?? "no image of the code"}`;
+  if (v2.status === "matches") return "Matches the code";
+  const parts = [`${fmtPercent(v2.percent ?? 0)} of pixels`];
+  if (v2.size && !sameSize(v2.size)) parts.push(`size ${fmtSize(v2.size.figma)} vs ${fmtSize(v2.size.code)}`);
+  return `Differs from the code: ${parts.join(", ")}`;
+}
+function fidelityComponentLine(c10) {
+  if (c10.status === "not-checked") return `Not compared: ${c10.reason ?? "no image of the code"}`;
+  if (c10.status === "matches") return c10.checked === 1 ? "Matches the code" : `Matches the code (${c10.checked} variants)`;
+  const w = c10.worst;
+  const head = fidelityVerdict({ status: "differs", percent: w.percent, size: w.size });
+  return c10.checked > 1 ? `${head} (${c10.differing} of ${c10.checked} variants)` : head;
+}
+const FIGMA_REFERENCES_BRANCH = "bridge-visual";
+const FIGMA_REFERENCES_DIR = "figma-references";
+const FIGMA_REFERENCES_MANIFEST = `${FIGMA_REFERENCES_DIR}/manifest.json`;
+const FIGMA_REFERENCE_STORY = "internal-figma-reference--variant";
+const FIGMA_FILL_WIDTH_TOKEN = "size.80";
+const 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"
+};
+const iconName = (component) => component.replace(/^Icon\//, "");
+const 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 s2 = STATE_PSEUDO[value.toLowerCase()];
+    if (!s2) return { ok: false, reason: `the ${value} state has no code equivalent to render` };
+    if (s2 === "disabled") props.disabled = true;
+    else if (s2 !== "rest") pseudo = s2;
+  }
+  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((s2) => s2.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 t3 = spec.parts.find((p) => p.parent === f.id && p.kind === "text");
+      const value = textOf(t3);
+      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 = (s2) => s2.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((v2) => ({ component: spec.name, specHash: spec.hash, key: variantKeyOf(v2.props), plan: planReference(spec, v2, file) }))
+  );
 }
 export {
-  ai as AAA_MIN,
-  aj as AA_MIN,
+  ak as AAA_MIN,
+  al as AA_MIN,
   ADMIN_ROLE_ID,
   ANTHROPIC_MESSAGES_URL,
   BELL,
   BRAND_FONTS,
   BRAND_SLUG_RE,
-  ak as BULK_LIMIT,
-  k as COLOR_FIELDS,
-  C as COMPONENT_SPECS_VERSION,
+  am as BULK_LIMIT,
+  n as COLOR_FIELDS,
+  k as COMPONENT_SPECS_VERSION,
   CONFIG_FILE,
-  al as CONTRAST_CELL_MAX,
-  am as CONTRAST_CHECKS_FILE,
+  an as CONTRAST_CELL_MAX,
+  ao as CONTRAST_CHECKS_FILE,
   ConfigError,
-  an as DEFAULT_COMPONENT_SPECS_FILE,
-  ao as DEFAULT_GOVERNANCE,
-  ap as DEFAULT_OVERRIDE,
+  ap as DEFAULT_COMPONENT_SPECS_FILE,
+  aq as DEFAULT_GOVERNANCE,
+  ar as DEFAULT_OVERRIDE,
   DEFAULT_PROTECTED_BRANCHES,
-  aq as DEFAULT_RIGHTS,
+  as as DEFAULT_RIGHTS,
   DEFAULT_TOKEN_PATHS,
-  ar as DEFAULT_VISUAL_IMPACT,
+  at as DEFAULT_VISUAL_IMPACT,
   DEMO_RELEASES,
   DOCS_CHANGE_BUMP,
   DOCS_DRAFT_MODEL,
@@ -3835,18 +4092,24 @@ export {
   EXPLORATION_USE_CASES,
   EXT_ID,
   EXT_SCOPES,
+  FIDELITY_DEFAULTS,
+  FIGMA_FILL_WIDTH_TOKEN,
+  FIGMA_REFERENCES_BRANCH,
+  FIGMA_REFERENCES_DIR,
+  FIGMA_REFERENCES_MANIFEST,
+  FIGMA_REFERENCE_STORY,
   GitHubClient,
   GitHubError,
-  as as JsonParseError,
+  au as JsonParseError,
   LIGHTNESS,
   LayeredTokenSet,
   NEUTRAL_ANCHORS,
-  at as OWNER_GROUPS,
+  av as OWNER_GROUPS,
   PIN_TOLERANCE,
-  au as PREVIEW_APP_LABELS,
-  av as PREVIEW_COMMENT_MARKER,
-  aw as PREVIEW_PLACEHOLDERS,
-  ax as PRIMITIVE_MODE,
+  aw as PREVIEW_APP_LABELS,
+  ax as PREVIEW_COMMENT_MARKER,
+  ay as PREVIEW_PLACEHOLDERS,
+  az as PRIMITIVE_MODE,
   PROSE_KEYS,
   PROTECTION_PARTS,
   PROTECTION_PART_PHRASE,
@@ -3856,100 +4119,104 @@ export {
   REQUEST_KINDS,
   REQUEST_LABEL,
   REQUEST_STATUS_LABEL,
-  ay as RIGHTS,
-  az as RIGHT_LABEL,
+  aA as RIGHTS,
+  aB as RIGHT_LABEL,
   RISK_LABELS,
-  aA as RISK_TIER,
+  aC as RISK_TIER,
   SIMILARITY_THRESHOLD,
   SINGLE_MODE,
-  aB as SPEC_FIELDS,
+  aD as SPEC_FIELDS,
   STEPS,
   TIER_AXIS,
   TIER_NAMES,
-  aC as TIER_ORDER,
+  aE as TIER_ORDER,
   TOKEN_REJECTED_MESSAGE,
   TOKEN_SETTINGS_URL,
-  aD as TeamDirectory,
-  aE as UNRELEASED,
-  aF as VISUAL_CHECK_LABEL,
+  aF as TeamDirectory,
+  aG as UNRELEASED,
+  aH as VISUAL_CHECK_LABEL,
   acceptDocsDraft,
   acceptDocsText,
   addBrandToConfigText,
-  aG as affectedContrast,
+  aI as affectedContrast,
   d as aliasOf,
   aliasTarget,
   anatomyLabel,
   anchoredRamp,
   anthropicReplyText,
   anthropicRequest,
-  aH as appForProject,
-  aI as appUrl,
+  aJ as appForProject,
+  aK as appUrl,
   applyConfirmedRenames,
   applyDocsSections,
   applyTokenEdits,
   applyTokenMerge,
-  aJ as approverEntries,
-  aK as approverLists,
+  aL as approverEntries,
+  aM as approverLists,
   assertSafeBranch,
   assignRequestOnGitHub,
-  aL as assignVersions,
+  aN as assignVersions,
   base64ToUtf8,
-  aM as baseBranchOf,
+  aO as baseBranchOf,
   bellChroma,
-  aN as branchName,
+  aP as branchName,
   branchPreviewUrls,
-  aO as branchSlug,
+  aQ as branchSlug,
   brandDisplayName,
   brandPreviewVariables,
+  buildFidelityReport,
   buildHistoryEntry,
   buildReport,
-  i as buildTokenSet,
+  j as buildTokenSet,
   buildUsageIndex,
-  aP as canShip,
+  aR as canShip,
   changeEdits,
-  aQ as changeKind,
-  aR as changeTable,
-  aS as changedModes,
-  aT as changesetBump,
+  aS as changeKind,
+  aT as changeTable,
+  aU as changedModes,
+  aV as changesetBump,
   checkBrandSlug,
   checkLayeredPair,
   choiceFor,
   classifyAuth,
-  aU as classifyLayered,
+  aW as classifyLayered,
   classifyRisk,
   cleanDocsText,
   cleanDraftText,
-  aV as clearRawDeep,
+  aX as clearRawDeep,
   closeExplorationOnGitHub,
   closingIssueNumbers,
   coerceValue,
   collectHistory,
   collectRefs,
+  colorDelta,
   k2 as colorToCss,
   l as colorsEqual,
   combineChanges,
   combineConflicts,
   c as comboKey,
-  aW as commitMessage,
+  aY as commitMessage,
   m as compactJson,
+  compareImages,
   componentForPath,
-  aX as composeChangeset,
+  aZ as composeChangeset,
   composeFiles,
   composeNewBrandBody,
   composePendingDrafts,
-  aY as composePrBody,
-  aZ as composeProposalBody,
+  a_ as composePrBody,
+  a$ as composeProposalBody,
   composeRequestIssue,
-  a_ as composite,
-  a$ as contextFor,
+  b0 as composite,
+  b1 as contextFor,
   contextLabel,
-  b0 as contrastDelta,
-  b1 as contrastDeltaTable,
-  b2 as contrastLevel,
-  b3 as contrastPair,
-  b4 as contrastRatio,
+  b2 as contrastDelta,
+  b3 as contrastDeltaTable,
+  b4 as contrastLevel,
+  b5 as contrastPair,
+  b6 as contrastRatio,
   contrastScope,
-  b5 as countChanges,
+  b7 as countChanges,
+  b8 as coverageSummary,
   createDocsDraftSession,
   createPendingDrafts,
   cssModuleClasses,
@@ -3961,15 +4228,15 @@ export {
   declineRequestOnGitHub,
   decodePicks,
   defaultChoiceFor,
-  b6 as defaultContext,
+  b9 as defaultContext,
   defaultFile,
   defaultScopes,
-  b7 as defaultTitle,
-  b8 as defineConfig,
+  ba as defaultTitle,
+  bb as defineConfig,
   deletePendingDrafts,
   demoHistory,
-  b9 as detectLayout,
-  ba as diffLayered,
+  bc as detectLayout,
+  bd as diffLayered,
   docsPrompt,
   docsSectionShapes,
   docsSectionsAnswer,
@@ -3988,11 +4255,11 @@ export {
   emptyTokenFile,
   encodePicks,
   ensureRequestsBranch,
-  bb as entriesFor,
-  bc as entryLabel,
+  be as entriesFor,
+  bf as entryLabel,
   evaluatePairs,
-  bd as expandEntries,
-  be as expandOwners,
+  bg as expandEntries,
+  bh as expandOwners,
   explorationBranch,
   explorationNote,
   explorationNotePath,
@@ -4008,61 +4275,63 @@ export {
   explorationTestBuildOnGitHub,
   explorationTryIt,
   explorationTryItOnGitHub,
-  bf as fieldChanges,
-  bg as fileModes,
-  bh as filterHistory,
+  fidelityComponentLine,
+  fidelityVerdict,
+  bi as fieldChanges,
+  bj as fileModes,
+  bk as filterHistory,
   findExplorationOnGitHub,
   findPreviewComment,
   findReferenceProblems,
-  bi as findToken,
-  bj as findVercelComment,
-  bk as firstParagraph,
-  n as flattenLayerFile,
+  bl as findToken,
+  bm as findVercelComment,
+  bn as firstParagraph,
+  n2 as flattenLayerFile,
   flattenTokens,
   formatChangeset,
   formatDocsJson,
-  bl as formatNumber,
-  bm as formatOwnerEntry,
+  bo as formatNumber,
+  bp as formatOwnerEntry,
   formatValue,
   friendlyMessage,
   fromHex,
   fromPlain,
   generateRamp,
-  bn as getChild,
+  bq as getChild,
   getEntry,
   gitHubHistoryBackend,
   g2 as globToRegExp,
-  bo as groupsPhrase,
+  br as groupsPhrase,
   h as hashSpec,
   h2 as hexToRgba,
-  bp as holdersOf,
-  j as iconComponentName,
+  bs as holdersOf,
+  i as iconComponentName,
   idExtensionFor,
   impactedModules,
   importsIn,
-  bq as indexByPath,
-  br as inheritedTypeAt,
-  bs as installCommand,
-  bt as installCommandFromPreviewComment,
+  bt as indexByPath,
+  bu as inheritedTypeAt,
+  bv as installCommand,
+  bw as installCommandFromPreviewComment,
   isActiveExploration,
   isAlias,
   isDocsSelectionMode,
   isDraftSessionId,
   isExplorationBranch,
   isExplorationPull,
-  bu as isGuardrail,
+  bx as isGuardrail,
   isHex,
   isMissingPermission,
   isMultiMode,
   isPlanRefusal,
   isProseKey,
-  bv as isTeamEntry,
-  bw as isTokenFile,
+  by as isTeamEntry,
+  bz as isTokenFile,
   isTokenRejected,
-  bx as isVercelComment,
+  bA as isVercelComment,
   jiraIssueFields,
-  by as kindForMin,
-  bz as layeredImpact,
+  bB as kindForMin,
+  bC as layeredImpact,
   o as layeredParityIssues,
   g as layoutOptions,
   levenshtein,
@@ -4075,7 +4344,7 @@ export {
   loadProtection,
   loadRepoFiles,
   loadRequiredChecks,
-  bA as luminance,
+  bD as luminance,
   markClaudeDraft,
   mergeDocsDraft,
   mergeDraftResults,
@@ -4085,7 +4354,7 @@ export {
   missingProse,
   modeDisplayName,
   modeFile,
-  bB as modeLabel,
+  bE as modeLabel,
   modesOf$1 as modesOf,
   moveToken,
   nearestStep,
@@ -4094,31 +4363,31 @@ export {
   neutralOffset,
   newBrandSection,
   newDraftSessionId,
-  bC as nodesEqual,
-  bD as normalizeRights,
+  bF as nodesEqual,
+  bG as normalizeRights,
   oklch,
   oklchToLinear,
-  bE as overrideKey,
-  bF as ownerEntryProblems,
+  bH as overrideKey,
+  bI as ownerEntryProblems,
   packageDirCandidates,
-  bG as pairKey,
+  bJ as pairKey,
   parseChangelog,
-  bH as parseChangesetText,
+  bK as parseChangesetText,
   parseColor,
-  bI as parseComponentSpecs,
+  bL as parseComponentSpecs,
   parseContrastChecks,
   q as parseDimension,
   parseDocsReply,
   parseDocsTaskAnswer,
   parseExplorationBody,
   parseJson,
-  bJ as parseOwnerEntry,
+  bM as parseOwnerEntry,
   parsePendingDrafts,
   parseRepo,
   parseRequestIssue,
   parseStructureChange,
   parseTokenFile,
-  bK as parseVercelComment,
+  bN as parseVercelComment,
   patchDocsJson,
   pathId,
   pathSimilarity,
@@ -4126,25 +4395,27 @@ export {
   pickedOption,
   plainEqual,
   planNewBrand,
-  bL as planRestore,
-  bM as planRevert,
-  bN as planToJson,
+  planReference,
+  planReferences,
+  bO as planRestore,
+  bP as planRevert,
+  bQ as planToJson,
   planTokenMerge,
   e as prNumberFromSubject,
   prefillDocs,
-  bO as previewComment,
+  bR as previewComment,
   previewLinks,
-  bP as previewLinksOf,
+  bS as previewLinksOf,
   previewOverrides,
-  bQ as previewUrl,
+  bT as previewUrl,
   previewsSettled,
-  bR as projectOfLabel,
+  bU as projectOfLabel,
   promoteExplorationOnGitHub,
   promotionPlan,
   propsTable,
   protectLibrary,
   protectRefusal,
-  bS as protectedBranchesOf,
+  bV as protectedBranchesOf,
   protectionRuleset,
   protectionRulesetName,
   protectionSentence,
@@ -4155,10 +4426,11 @@ export {
   readPreviewComment,
   readTokenAt,
   reconcileIds,
+  referenceImagePath,
   releasesFromTags,
   removeToken,
   removedSide,
-  bT as renderedColor,
+  bW as renderedColor,
   requestBrief,
   requestImagePath,
   requestIssueTitle,
@@ -4169,13 +4441,13 @@ export {
   resolveBranchPreviews,
   r as rgbaToDtcg,
   rgbaToHex,
-  bU as rightsProblems,
+  bX as rightsProblems,
   round3,
   rulesSettingsUrl,
   rulesetTargetsDefault,
-  bV as runLayeredContrast,
+  bY as runLayeredContrast,
   sameScopes,
-  bW as sameToken,
+  bZ as sameToken,
   sanitizeDocsReplacement,
   sanitizeDocsResult,
   sanitizeDocsSections,
@@ -4189,57 +4461,59 @@ export {
   serializePendingDrafts,
   serializeTokenFile,
   shadowedEdits,
-  bX as shipPolicy,
+  b_ as shipPolicy,
   shortVariant,
   shortVariants,
   slugify,
-  bY as snapshotUrl,
-  bZ as specHash,
+  b$ as snapshotUrl,
+  s as specHash,
   startExplorationOnGitHub,
-  b_ as summarizeTokenChange,
+  summarizeComponent,
+  c0 as summarizeTokenChange,
   takeMine,
-  b$ as tarballAssetName,
-  c0 as tarballUrl,
-  c1 as teamKey,
-  c2 as teamKeyOf,
-  c3 as teamUnreadableMessage,
-  c4 as teamsIn,
+  c1 as tarballAssetName,
+  c2 as tarballUrl,
+  c3 as teamKey,
+  c4 as teamKeyOf,
+  c5 as teamUnreadableMessage,
+  c6 as teamsIn,
   threeWayDiff,
   tintedNeutral,
-  c5 as titleOf,
+  c7 as titleOf,
   t2 as toAlias,
-  c6 as toChangeSummary,
+  c8 as toChangeSummary,
   toConfigJson,
   toHex,
-  c7 as toMap,
+  c9 as toMap,
   toOklch,
   toPlain,
-  c8 as tokenBump,
+  ca as tokenBump,
   t as tokenCssVar,
-  c9 as tokenHistory,
-  ca as tokenNode,
+  cb as tokenHistory,
+  cc as tokenNode,
   tokenUsage,
   tokensPath,
   unpicked,
-  cb as unreadableShipTeams,
-  cc as unreadableTeams,
+  cd as unreadableShipTeams,
+  ce as unreadableTeams,
   updatePendingDrafts,
   upsertToken,
   utf8ToBase64,
+  v as validateComponentSpec,
   validateDocsTask,
   validateIntegrations,
   validateLayered,
   validatePendingDrafts,
   validateProposal,
   validateSet,
-  cd as valueIn,
+  cf as valueIn,
   u as valueToCss,
   valuesEqual,
-  v as variantKeyOf,
-  ce as variantName,
-  cf as versionTimeline,
-  cg as visualImpactProblems,
-  ch as whoCanShipSentence,
+  variantKeyOf,
+  cg as variantName,
+  ch as versionTimeline,
+  ci as visualImpactProblems,
+  cj as whoCanShipSentence,
   withRequestExploration,
   writeDraftResults
 };