@bridge-ds/core 0.10.0 → 0.12.0

package/dist/index.js

@@ -1,7 +1,7 @@
 import { m as modeDisplayName, b as modesOf$1, i as isMultiMode, T as TIER_NAMES, c as TIER_AXIS, d as collectRefs, f as findReferenceProblems, e as evaluatePairs, g as contrastScope, h as contextLabel, S as SINGLE_MODE, j as isAlias, k as aliasTarget, l as pathId, v as valuesEqual, n as flattenTokens, s as serializeTokenFile, r as removeToken, u as upsertToken, o as threeWayDiff, q as emptyTokenFile, w as parseTokenFile, E as EXT_ID, x as EXT_SCOPES, y as parseColor, z as rgbaToHex, A as formatValue, B as resolve, C as moveToken, D as effectiveScopes, F as sameScopes, G as defaultScopes, H as readTokenAt, I as modeFile, J as defaultFile, K as selectTokenFiles, L as LayeredTokenSet, M as resolveBranchPreviews, N as loadConfig, O as tokensPath, P as toConfigJson, Q as validateLayered, R as parseContrastChecks, U as classifyRisk, V as CONFIG_FILE, W as RISK_LABELS, X as previewLinks, Y as findPreviewComment, Z as previewsSettled, _ as DEFAULT_TOKEN_PATHS, $ as layoutOptions, a0 as buildTokenSet, a1 as readPreviewComment, a2 as linkStatus, a3 as libraryPreviewState, a4 as parsePiecesRecord, a5 as libraryBranchPlan, a6 as NEEDED_BY_LABEL, a7 as withNeededBy, a8 as withLink, a9 as withPiecesRecord, aa as productBranchSentence, ab as mergePiecesRecord, ac as productOfBranch, ad as defaultProduct, ae as slugify } from "./prod-branch-BdMPKffE.js";
 import { af, ag, ah, ai, aj, ak, 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, 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, bp, bq, br, bs, bt, bu, bv, bw, bx, by, bz, bA, bB, bC, bD, bE, bF, bG, bH, bI, bJ, bK, bL, p, bM, bN, bO, bP, bQ, bR, bS, bT, bU, bV, bW, a, bX, bY, bZ, b_, b$, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, ca, cb, cc, cd, ce, cf, cg, t, ch, ci, cj, ck, cl, cm, cn, co } from "./prod-branch-BdMPKffE.js";
-import { G as GitHubError, c as collectHistory, p as packageDirCandidates, a as parseChangelog, r as releasesFromTags, m as mergeReleases, b as buildReport, d as applyTokenEdits, e as buildHistoryEntry, f as coerceValue, g as checkLayeredPair, h as formatChangeset, P as PROSE_KEYS, i as markClaudeDraft, j as cleanDraftText, k as docsPrompt, D as DRAFT_LINE_MAX, R as REQUESTS_BRANCH, l as REQUEST_KINDS, s as sanitizeDraftLine, n as parseExplorationBody, E as EXPLORATION_PREFIX, o as explorationSlug, q as explorationStatus, t as explorationTryIt, u as isExplorationPull, v as promotionPlan, w as EXPLORATION_LABEL, x as explorationProblems, y as explorationNote, z as explorationNotePath, A as explorationPrTitle, B as explorationPrBody, C as variantKeyOf, F as overrideComment, O as OVERRIDE_HEADING, H as overrideRefusedComment, I as suggestionStateFromLabels, J as suggestionStatus, K as composeRequestIssue, L as EXPLORATION_NOTES_DIR, M as isExplorationBranch, N as diffLayered, Q as contrastDelta, S as runLayeredContrast, T as layeredImpact, U as classifyLayered, V as composeProposalBody, W as createSuggestionOnGitHub, X as gitBlobSha, Y as SUGGESTION_SCHEMA, Z as branchWithJiraKey, _ as titleWithJiraKey, $ as figmaSpecPath, a0 as formatFigmaSpec, a1 as figmaDraftBrief, a2 as parseFigmaOrigin, a3 as figmaPushStatus, a4 as parseFigmaSpec, a5 as FIGMA_SPEC_DIR, a6 as FROM_FIGMA_LABEL, a7 as withFigmaOrigin, a8 as WAITING_FOR_CLAUDE_LABEL, a9 as DRAFTED_BY_CLAUDE_LABEL, aa as planComponentPush, ab as figmaOriginSection, ac as figmaBranchTitle, ad as figmaSpecSlug, ae as figmaDraftBody, af as REQUEST_LABEL } from "./suggestion-apply-ByBEYtct.js";
-import { ag as ag2, ah as ah2, ai as ai2, aj as aj2, ak as ak2, al as al2, am as am2, an as an2, ao as ao2, ap as ap2, aq as aq2, ar as ar2, as as as2, at as at2, au as au2, av as av2, aw as aw2, ax as ax2, ay as ay2, az as az2, aA as aA2, aB as aB2, aC as aC2, aD as aD2, aE as aE2, aF as aF2, aG as aG2, aH as aH2, aI as aI2, aJ as aJ2, aK as aK2, aL as aL2, aM as aM2, aN as aN2, aO as aO2, aP as aP2, aQ as aQ2, aR as aR2, aS as aS2, aT as aT2, aU as aU2, aV as aV2, aW as aW2, aX as aX2, aY as aY2, aZ as aZ2, a_ as a_2, a$ as a$2, b0 as b02, b1 as b12, b2 as b22, b3 as b32, b4 as b42, b5 as b52, b6 as b62, b7 as b72, b8 as b82, b9 as b92, ba as ba2, bb as bb2, bc as bc2, bd as bd2, be as be2, bf as bf2, bg as bg2, bh as bh2, bi as bi2, bj as bj2, bk as bk2, bl as bl2, bm as bm2, bn as bn2, bo as bo2, bp as bp2, bq as bq2, br as br2, bs as bs2, bt as bt2, bu as bu2, bv as bv2, bw as bw2, bx as bx2, by as by2, bz as bz2, bA as bA2, bB as bB2, bC as bC2, bD as bD2, bE as bE2, bF as bF2, bG as bG2, bH as bH2, bI as bI2, bJ as bJ2, bK as bK2, bL as bL2, bM as bM2, bN as bN2, bO as bO2, bP as bP2, bQ as bQ2, bR as bR2, bS as bS2, bT as bT2, bU as bU2, bV as bV2, bW as bW2, bX as bX2, bY as bY2, bZ as bZ2, b_ as b_2, b$ as b$2, c0 as c02, c1 as c12, c2 as c22, c3 as c32, c4 as c42, c5 as c52, c6 as c62, c7 as c72, c8 as c82, c9 as c92, ca as ca2, cb as cb2, cc as cc2, cd as cd2, ce as ce2, cf as cf2, cg as cg2, ch as ch2, ci as ci2, cj as cj2, ck as ck2, cl as cl2, cm as cm2, cn as cn2, co as co2, cp, cq, cr, cs, ct, cu, cv, cw, cx, cy, cz, cA, cB, cC, cD, cE, cF, cG, cH, cI, cJ, cK, cL, cM, cN, cO, cP, cQ, cR, cS, cT, cU, cV, cW, cX, cY, cZ, c_, c$, d0, d1, d2, d3, d4, d5, d6, d7, d8, d9, da, db, dc, dd, de, df, dg } from "./suggestion-apply-ByBEYtct.js";
+import { G as GitHubError, c as collectHistory, p as packageDirCandidates, a as parseChangelog, r as releasesFromTags, m as mergeReleases, b as buildReport, d as applyTokenEdits, e as buildHistoryEntry, f as coerceValue, g as checkLayeredPair, h as formatChangeset, P as PROSE_KEYS, i as markClaudeDraft, j as cleanDraftText, k as docsPrompt, D as DRAFT_LINE_MAX, R as REQUESTS_BRANCH, l as REQUEST_KINDS, s as sanitizeDraftLine, n as parseExplorationBody, E as EXPLORATION_PREFIX, o as explorationSlug, q as explorationStatus, t as explorationTryIt, u as isExplorationPull, v as promotionPlan, w as EXPLORATION_LABEL, x as explorationProblems, y as explorationNote, z as explorationNotePath, A as explorationPrTitle, B as explorationPrBody, C as variantKeyOf, F as overrideComment, O as OVERRIDE_HEADING, H as overrideRefusedComment, I as suggestionStateFromLabels, J as suggestionStatus, K as composeRequestIssue, L as EXPLORATION_NOTES_DIR, M as isExplorationBranch, N as diffLayered, Q as contrastDelta, S as runLayeredContrast, T as layeredImpact, U as classifyLayered, V as composeProposalBody, W as createSuggestionOnGitHub, X as gitBlobSha, Y as SUGGESTION_SCHEMA, Z as branchWithJiraKey, _ as titleWithJiraKey, $ as figmaSpecPath, a0 as formatFigmaSpec, a1 as figmaDraftBrief, a2 as parseFigmaOrigin, a3 as figmaPushStatus, a4 as parseFigmaSpec, a5 as FIGMA_SPEC_DIR, a6 as FROM_FIGMA_LABEL, a7 as withFigmaOrigin, a8 as WAITING_FOR_CLAUDE_LABEL, a9 as DRAFTED_BY_CLAUDE_LABEL, aa as planComponentPush, ab as figmaOriginSection, ac as figmaBranchTitle, ad as figmaSpecSlug, ae as figmaDraftBody, af as REQUEST_LABEL, ag as figmaNodeUrl } from "./suggestion-apply-DxXRGQrO.js";
+import { ah as ah2, ai as ai2, aj as aj2, ak as ak2, al as al2, am as am2, an as an2, ao as ao2, ap as ap2, aq as aq2, ar as ar2, as as as2, at as at2, au as au2, av as av2, aw as aw2, ax as ax2, ay as ay2, az as az2, aA as aA2, aB as aB2, aC as aC2, aD as aD2, aE as aE2, aF as aF2, aG as aG2, aH as aH2, aI as aI2, aJ as aJ2, aK as aK2, aL as aL2, aM as aM2, aN as aN2, aO as aO2, aP as aP2, aQ as aQ2, aR as aR2, aS as aS2, aT as aT2, aU as aU2, aV as aV2, aW as aW2, aX as aX2, aY as aY2, aZ as aZ2, a_ as a_2, a$ as a$2, b0 as b02, b1 as b12, b2 as b22, b3 as b32, b4 as b42, b5 as b52, b6 as b62, b7 as b72, b8 as b82, b9 as b92, ba as ba2, bb as bb2, bc as bc2, bd as bd2, be as be2, bf as bf2, bg as bg2, bh as bh2, bi as bi2, bj as bj2, bk as bk2, bl as bl2, bm as bm2, bn as bn2, bo as bo2, bp as bp2, bq as bq2, br as br2, bs as bs2, bt as bt2, bu as bu2, bv as bv2, bw as bw2, bx as bx2, by as by2, bz as bz2, bA as bA2, bB as bB2, bC as bC2, bD as bD2, bE as bE2, bF as bF2, bG as bG2, bH as bH2, bI as bI2, bJ as bJ2, bK as bK2, bL as bL2, bM as bM2, bN as bN2, bO as bO2, bP as bP2, bQ as bQ2, bR as bR2, bS as bS2, bT as bT2, bU as bU2, bV as bV2, bW as bW2, bX as bX2, bY as bY2, bZ as bZ2, b_ as b_2, b$ as b$2, c0 as c02, c1 as c12, c2 as c22, c3 as c32, c4 as c42, c5 as c52, c6 as c62, c7 as c72, c8 as c82, c9 as c92, ca as ca2, cb as cb2, cc as cc2, cd as cd2, ce as ce2, cf as cf2, cg as cg2, ch as ch2, ci as ci2, cj as cj2, ck as ck2, cl as cl2, cm as cm2, cn as cn2, co as co2, cp, cq, cr, cs, ct, cu, cv, cw, cx, cy, cz, cA, cB, cC, cD, cE, cF, cG, cH, cI, cJ, cK, cL, cM, cN, cO, cP, cQ, cR, cS, cT, cU, cV, cW, cX, cY, cZ, c_, c$, d0, d1, d2, d3, d4, d5, d6, d7, d8, d9, da, db, dc, dd, de, df, dg, dh } from "./suggestion-apply-DxXRGQrO.js";
 const issueKey$1 = (i) => `${i.code}|${i.path ?? ""}|${i.mode ?? ""}|${i.code === "file-problem" ? i.message : ""}`;
 const modeName = (mode) => mode === SINGLE_MODE ? "all modes" : modeDisplayName(mode);
 const isPalette = (t2) => t2.tier === "brand" && t2.path.startsWith("palette.");
@@ -52,7 +52,7 @@ function checkValue(set, owner, value, mode, where, issues) {
     });
   }
 }
-function validateSet(set, pairs) {
+function validateSet(set, pairs2) {
   const issues = [];
   for (const p2 of set.problems) issues.push({ code: "file-problem", severity: "error", message: p2 });
   for (const t2 of set.tokens.values()) {
@@ -119,7 +119,7 @@ function validateSet(set, pairs) {
       }
     );
   }
-  const contrast = evaluatePairs(set.byPath, pairs, contrastScope(set));
+  const contrast = evaluatePairs(set.byPath, pairs2, contrastScope(set));
   for (const r of contrast) {
     const path = `${r.pair.foreground} on ${r.pair.background}`;
     const mode = `${r.brand ?? ""}.${r.theme}`;
@@ -154,9 +154,9 @@ function shadowedEdits(set, edits) {
   }
   return out;
 }
-function validateProposal(proposed, head, pairs, typeChanges = []) {
-  const after = validateSet(proposed, pairs);
-  const before = validateSet(head, pairs);
+function validateProposal(proposed, head, pairs2, typeChanges = []) {
+  const after = validateSet(proposed, pairs2);
+  const before = validateSet(head, pairs2);
   const existing = new Set(before.issues.map(issueKey$1));
   const blocking = [];
   const warnings = [];
@@ -1112,7 +1112,7 @@ const RADIUS_ROLES = ["inset", "control", "container", "overlay"];
 const RESERVED = /* @__PURE__ */ new Set(["default", "base", "all", "none", "new", "blank", "primitives", "semantic", "components", "density"]);
 const BRAND_SLUG_RE = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
 const DEFAULT_PRIMARY_CHROMA = 0.14;
-const isObj = (x) => !!x && typeof x === "object" && !Array.isArray(x);
+const isObj$1 = (x) => !!x && typeof x === "object" && !Array.isArray(x);
 const fileMap = (f) => f instanceof Map ? new Map(f) : new Map(Object.entries(f));
 const brandDisplayName = (slug) => slug.split("-").filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join(" ");
 function brandLayers(config) {
@@ -1133,27 +1133,27 @@ function setAt(doc, path, node) {
   const keys = path.split(".");
   let cur = doc;
   for (const k of keys.slice(0, -1)) {
-    if (!isObj(cur[k])) cur[k] = {};
+    if (!isObj$1(cur[k])) cur[k] = {};
     cur = cur[k];
   }
   const last = keys[keys.length - 1];
-  const prev = isObj(cur[last]) ? cur[last] : {};
+  const prev = isObj$1(cur[last]) ? cur[last] : {};
   cur[last] = { ...prev, ...node };
 }
 function getAt(doc, path) {
   let cur = doc;
-  for (const k of path.split(".")) cur = isObj(cur) ? cur[k] : void 0;
-  return isObj(cur) ? cur : void 0;
+  for (const k of path.split(".")) cur = isObj$1(cur) ? cur[k] : void 0;
+  return isObj$1(cur) ? cur : void 0;
 }
 function typeAt(doc, path) {
   let cur = doc;
   let type;
   for (const k of path.split(".")) {
-    if (!isObj(cur)) return type;
+    if (!isObj$1(cur)) return type;
     if (typeof cur.$type === "string") type = cur.$type;
     cur = cur[k];
   }
-  return isObj(cur) && typeof cur.$type === "string" ? cur.$type : type;
+  return isObj$1(cur) && typeof cur.$type === "string" ? cur.$type : type;
 }
 function rampFor(input, pinStep, kind) {
   if (typeof input === "number" || typeof input === "string" && /^\d+(\.\d+)?$/.test(input.trim())) {
@@ -1210,7 +1210,7 @@ function listBrands(source) {
       doc = JSON.parse(files.get(file) ?? "{}");
     } catch {
     }
-    const meta = isObj(doc.$extensions) && isObj(doc.$extensions["dev.bridge.brand"]) ? doc.$extensions["dev.bridge.brand"] : {};
+    const meta = isObj$1(doc.$extensions) && isObj$1(doc.$extensions["dev.bridge.brand"]) ? doc.$extensions["dev.bridge.brand"] : {};
     const combo = set.normalizeCombo({ brand: slug });
     const primary = set.resolve("color.action.primary.bg", combo);
     const overrides = layers.override ? (config.axes[layers.overrideAxis]?.values ?? []).map((v) => fill(layers.override, { brand: slug, [layers.overrideAxis]: v })).filter((f) => files.has(f)) : [];
@@ -1300,7 +1300,7 @@ function planNewBrand(source, input) {
   for (const [path, defs] of before.view(before.defaultCombo)) {
     const m = /^radius\.([\w-]+)$/.exec(path);
     const v = defs[defs.length - 1].value;
-    if (m && isObj(v) && typeof v.value === "number" && v.unit === "px" && !getAt(doc, path)) scale.set(v.value, m[1]);
+    if (m && isObj$1(v) && typeof v.value === "number" && v.unit === "px" && !getAt(doc, path)) scale.set(v.value, m[1]);
   }
   const radius = input.radius ?? (blank ? RADIUS_PRESETS[0].radius : void 0);
   if (radius) {
@@ -1339,9 +1339,9 @@ function planNewBrand(source, input) {
   }
   const palette = getAt(doc, "palette");
   for (const [role, group] of Object.entries(palette ?? {})) {
-    if (role.startsWith("$") || !isObj(group)) continue;
+    if (role.startsWith("$") || !isObj$1(group)) continue;
     for (const [step, node] of Object.entries(group)) {
-      if (step.startsWith("$") || !isObj(node) || !("$value" in node) || typeof node.$value === "string") continue;
+      if (step.startsWith("$") || !isObj$1(node) || !("$value" in node) || typeof node.$value === "string") continue;
       const ramp = `${slug}-${role}`;
       const entry = prims.get(ramp) ?? { description: `${name} ${role}. Exact values set when the brand was created.`, steps: /* @__PURE__ */ new Map() };
       entry.steps.set(Number(step), node.$value);
@@ -1354,7 +1354,7 @@ function planNewBrand(source, input) {
   if (prims.size && files.has(primFile)) issues.push({ level: "error", code: "slug-file-exists", message: `${tokensPath(config, primFile)} already exists. Pick another name.` });
   for (const r of prims.keys()) if (before.allPaths().some((p2) => p2.startsWith(`color.${r}.`))) issues.push({ level: "error", code: "ramp-exists", message: `A primitive ramp color.${r} already exists. Pick another name.` });
   doc.$description = `${name}: created with Bridge, started from ${blank ? "a blank brand" : brandDisplayName(from)}.`;
-  doc.$extensions = { ...isObj(doc.$extensions) ? doc.$extensions : {}, "dev.bridge.brand": { name, from, ...Object.keys(anchors).length ? { anchors } : {} } };
+  doc.$extensions = { ...isObj$1(doc.$extensions) ? doc.$extensions : {}, "dev.bridge.brand": { name, from, ...Object.keys(anchors).length ? { anchors } : {} } };
   const { $description, $extensions, ...rest } = doc;
   const brandFile = fill(layers.brand, { brand: slug });
   const nextFiles = new Map(files);
@@ -1406,10 +1406,10 @@ function planNewBrand(source, input) {
     if (i.modes && !i.modes.some((m) => m.split(",").includes(brandKey)) && !created.includes(i.file ?? "")) continue;
     issues.push({ level: i.level, code: i.code, message: i.message, ...i.path ? { path: i.path } : {}, ...i.file ? { file: tokensPath(config, i.file) } : {} });
   }
-  const pairs = parseContrastChecks(source.contrastText);
+  const pairs2 = parseContrastChecks(source.contrastText);
   const inGate = nextConfig.axes.brand?.values.includes(slug);
   const combos = inGate ? after.combos(nextConfig.contrast?.modes).filter((c) => c.brand === slug) : [];
-  const results = combos.flatMap((c) => pairs.map((p2) => checkLayeredPair(after, p2, c)));
+  const results = combos.flatMap((c) => pairs2.map((p2) => checkLayeredPair(after, p2, c)));
   const failing = results.filter((r) => !r.pass);
   const themes = [...new Set(combos.map((c) => c.theme).filter((t2) => !!t2))];
   const ramps = {};
@@ -1780,7 +1780,7 @@ function composePendingDrafts(input) {
   return p2;
 }
 const KINDS = new Set(REQUEST_KINDS.map((k) => k.value));
-const str = (x) => typeof x === "string";
+const str$1 = (x) => typeof x === "string";
 const optStr = (x) => x === void 0 || typeof x === "string";
 function validatePendingDrafts(x) {
   const out = [];
@@ -1788,7 +1788,7 @@ function validatePendingDrafts(x) {
   const p2 = x;
   if (p2.version !== DRAFT_EXCHANGE_VERSION) out.push(`Unsupported draft session version ${String(p2.version)}: update Bridge.`);
   if (!isDraftSessionId(p2.sessionId)) out.push("The session id is missing or invalid.");
-  if (!str(p2.createdAt) || Number.isNaN(Date.parse(p2.createdAt))) out.push("createdAt must be an ISO date.");
+  if (!str$1(p2.createdAt) || Number.isNaN(Date.parse(p2.createdAt))) out.push("createdAt must be an ISO date.");
   if (p2.status !== "pending" && p2.status !== "drafted") out.push('status must be "pending" or "drafted".');
   if (p2.source !== "figma" && p2.source !== "studio") out.push('source must be "figma" or "studio".');
   if (!Array.isArray(p2.items) || !p2.items.length) out.push("A draft session needs at least one item.");
@@ -1799,32 +1799,32 @@ function validatePendingDrafts(x) {
       out.push(`${at3} is not an object.`);
       continue;
     }
-    if (!str(i.id) || !i.id) out.push(`${at3} has no id.`);
+    if (!str$1(i.id) || !i.id) out.push(`${at3} has no id.`);
     else if (ids.has(i.id)) out.push(`${at3} repeats the id "${i.id}".`);
     else ids.add(i.id);
     if (i.scope !== "request" && i.scope !== "push" && i.scope !== "docs") out.push(`${at3}: scope must be "request", "push" or "docs".`);
     if (i.scope === "docs") {
       const d = i.docs;
-      if (!d || typeof d !== "object" || !str(d.slug) || !d.slug || !str(d.prompt) || !d.prompt || !optStr(d.path)) out.push(`${at3}: a docs item needs docs {slug, task, prompt}.`);
+      if (!d || typeof d !== "object" || !str$1(d.slug) || !d.slug || !str$1(d.prompt) || !d.prompt || !optStr(d.path)) out.push(`${at3}: a docs item needs docs {slug, task, prompt}.`);
       else out.push(...validateDocsTask(d.task).map((m) => `${at3}: ${m}`));
     } else if (i.docs !== void 0) out.push(`${at3}: only a docs item has docs.`);
     if (!optStr(i.component)) out.push(`${at3}: component must be text.`);
     if (i.kind !== void 0 && !KINDS.has(i.kind)) out.push(`${at3}: unknown kind "${String(i.kind)}".`);
-    if (!Array.isArray(i.changes) || i.changes.some((c) => !c || !str(c.field) || !optStr(c.before) || !optStr(c.after))) out.push(`${at3}: changes must be a list of {field, before, after}.`);
-    if (i.variables !== void 0 && (!Array.isArray(i.variables) || i.variables.some((v) => !v || !str(v.path)))) out.push(`${at3}: variables must be a list of {path, before, after}.`);
+    if (!Array.isArray(i.changes) || i.changes.some((c) => !c || !str$1(c.field) || !optStr(c.before) || !optStr(c.after))) out.push(`${at3}: changes must be a list of {field, before, after}.`);
+    if (i.variables !== void 0 && (!Array.isArray(i.variables) || i.variables.some((v) => !v || !str$1(v.path)))) out.push(`${at3}: variables must be a list of {path, before, after}.`);
     if (i.variables !== void 0 && i.scope !== "push") out.push(`${at3}: only a push item has variables.`);
-    if (i.images !== void 0 && (!Array.isArray(i.images) || i.images.some((m) => !m || m.label !== "before" && m.label !== "after" || !str(m.url)))) out.push(`${at3}: images must be a list of {label: before or after, url}.`);
-    if (!i.draft || !str(i.draft.title) || !str(i.draft.summary)) out.push(`${at3}: draft must hold a title and a summary.`);
-    if (i.lines !== void 0 && (!Array.isArray(i.lines) || i.lines.some((l) => !l || !str(l.id) || !l.id || !str(l.line) || !optStr(l.title) || !Array.isArray(l.changes)))) out.push(`${at3}: lines must be a list of {id, changes, line, title}.`);
+    if (i.images !== void 0 && (!Array.isArray(i.images) || i.images.some((m) => !m || m.label !== "before" && m.label !== "after" || !str$1(m.url)))) out.push(`${at3}: images must be a list of {label: before or after, url}.`);
+    if (!i.draft || !str$1(i.draft.title) || !str$1(i.draft.summary)) out.push(`${at3}: draft must hold a title and a summary.`);
+    if (i.lines !== void 0 && (!Array.isArray(i.lines) || i.lines.some((l) => !l || !str$1(l.id) || !l.id || !str$1(l.line) || !optStr(l.title) || !Array.isArray(l.changes)))) out.push(`${at3}: lines must be a list of {id, changes, line, title}.`);
   }
   if (p2.results !== void 0) {
     if (!Array.isArray(p2.results)) out.push("results must be a list.");
     else
       for (const r of p2.results) {
-        if (!r || !str(r.id) || !str(r.title) || !str(r.summary)) out.push("Each result needs an id, a title and a summary.");
+        if (!r || !str$1(r.id) || !str$1(r.title) || !str$1(r.summary)) out.push("Each result needs an id, a title and a summary.");
         else if (r.docs !== void 0 && (!r.docs || typeof r.docs !== "object" || Array.isArray(r.docs))) out.push("Result docs must be an object of sections.");
         else if (!optStr(r.replacement)) out.push("A result replacement must be text.");
-        else if (r.lines !== void 0 && (!Array.isArray(r.lines) || r.lines.some((l) => !l || !str(l.id) || !str(l.line) || !optStr(l.title)))) out.push("Result lines must be a list of {id, line, title}.");
+        else if (r.lines !== void 0 && (!Array.isArray(r.lines) || r.lines.some((l) => !l || !str$1(l.id) || !str$1(l.line) || !optStr(l.title)))) out.push("Result lines must be a list of {id, line, title}.");
       }
   }
   return out;
@@ -3084,7 +3084,8 @@ function componentSpecSuggestionPayload(d, plan, ctx) {
   const spec = JSON.parse(formatFigmaSpec(d, plan));
   const brief = figmaDraftBrief({ ...d, tokenEdits: plan.edits, reasons: plan.reasons }, { suggestion: true, specPath, componentsDir: ctx.componentsDir });
   const by3 = (ctx.suggestedBy ?? d.requestedBy)?.replace(/^@/, "");
-  const figma = d.figma?.fileKey || d.figma?.nodeId || d.figma?.url ? { ...d.figma.fileKey ? { fileKey: d.figma.fileKey } : {}, ...d.figma.nodeId ? { nodeId: d.figma.nodeId } : {}, ...d.figma.url ? { url: d.figma.url } : {} } : void 0;
+  const figma = d.figma?.fileKey || d.figma?.nodeId || d.figma?.url ? { ...d.figma.fileKey ? { fileKey: d.figma.fileKey } : {}, ...d.figma.nodeId ? { nodeId: d.figma.nodeId } : {}, ...d.figma.url ? { url: d.figma.url } : {}, ...figmaNodes(d) } : void 0;
+  const previews = (d.images ?? []).map((url, i) => ({ label: `${d.component} in Figma${(d.images?.length ?? 0) > 1 ? ` ${i + 1}` : ""}`, url }));
   return {
     schema: SUGGESTION_SCHEMA,
     kind: "component-spec",
@@ -3097,9 +3098,19 @@ function componentSpecSuggestionPayload(d, plan, ctx) {
     tier: specTier(d),
     componentSpec: { component: d.component, specPath, spec, brief },
     checks: { newErrors: 0, contrast: [], blocked: null, impact: 0 },
-    ...figma ? { links: { figma } } : {}
+    ...figma ? { links: { figma } } : {},
+    ...previews.length ? { previews } : {}
   };
 }
+function figmaNodes(d) {
+  const f = d.figma;
+  if (!f) return {};
+  const url = (id, given) => given ?? (f.fileKey ? figmaNodeUrl(f.fileKey, id) : void 0);
+  const nodes = [];
+  if (f.before?.nodeId) nodes.push({ nodeId: f.before.nodeId, state: "before", ...url(f.before.nodeId, f.before.url) ? { url: url(f.before.nodeId, f.before.url) } : {}, ...f.before.nodeName ? { name: f.before.nodeName } : {} });
+  if (f.nodeId) nodes.push({ nodeId: f.nodeId, state: "after", ...url(f.nodeId, f.url) ? { url: url(f.nodeId, f.url) } : {}, ...f.nodeName ? { name: f.nodeName } : {} });
+  return nodes.length ? { nodes } : {};
+}
 async function openComponentPushOnGitHub(gh, input) {
   const d = input.diff;
   if (!input.plan && !input.tokens) throw new Error("Route the change first: pass the token facts or the plan.");
@@ -3120,7 +3131,7 @@ async function openComponentPushOnGitHub(gh, input) {
   };
   if (plan.route === "token-change") {
     if (!input.writeTokens) throw new GitHubError(422, "This change is a token change: send it where the token files are read (the DS Bridge plugin, bridge_push_figma_component or `bridge figma push`).");
-    const figma = { ...origin.fileKey ? { fileKey: origin.fileKey } : {}, ...origin.nodeId ? { nodeId: origin.nodeId } : {}, ...origin.url ? { url: origin.url } : {} };
+    const figma = { ...origin.fileKey ? { fileKey: origin.fileKey } : {}, ...origin.nodeId ? { nodeId: origin.nodeId } : {}, ...origin.url ? { url: origin.url } : {}, ...figmaNodes(d) };
     const r = await input.writeTokens({ edits: plan.edits, title: figmaBranchTitle(d), summary: d.summary.trim() || d.title, bodyExtra: [figmaOriginSection(origin)], mode, figma });
     await gh.addLabels(r.number, [FROM_FIGMA_LABEL]);
     if (r.status === "suggested") return { status: "suggested", plan, link: null, suggestion: { route: "token-change", number: r.number, url: r.url } };
@@ -3199,6 +3210,149 @@ async function figmaPushStatusesOnGitHub(gh, numbers) {
   );
   return out;
 }
+class StorybookIndexError extends Error {
+  constructor(code2, message, status) {
+    super(message);
+    this.code = code2;
+    this.status = status;
+    this.name = "StorybookIndexError";
+  }
+  code;
+  status;
+}
+const isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const str = (v) => typeof v === "string" && v.trim() ? v : void 0;
+function entryFrom(key, raw, v3) {
+  if (!isObj(raw)) return null;
+  const id = str(raw.id) ?? key;
+  const title = str(raw.title) ?? str(raw.kind);
+  const name = str(raw.name) ?? str(raw.story);
+  if (!id || !title || !name) return null;
+  const params = isObj(raw.parameters) ? raw.parameters : {};
+  const type = raw.type === "docs" || raw.type === "story" ? raw.type : v3 && params.docsOnly === true ? "docs" : "story";
+  const e = {
+    id,
+    title,
+    name,
+    type,
+    importPath: str(raw.importPath) ?? str(params.fileName) ?? "",
+    tags: Array.isArray(raw.tags) ? raw.tags.filter((t2) => typeof t2 === "string") : []
+  };
+  const subtype = str(raw.subtype);
+  if (subtype) e.subtype = subtype;
+  const exportName2 = str(raw.exportName);
+  if (exportName2) e.exportName = exportName2;
+  const componentPath = str(raw.componentPath);
+  if (componentPath) e.componentPath = componentPath;
+  return e;
+}
+function groupStorybookComponents(entries) {
+  const byTitle = /* @__PURE__ */ new Map();
+  for (const e of entries) {
+    let c = byTitle.get(e.title);
+    if (!c) {
+      const parts = e.title.split("/").map((p2) => p2.trim()).filter(Boolean);
+      c = { title: e.title, name: parts[parts.length - 1] ?? e.title, group: parts.slice(0, -1), stories: [], docs: [], tags: [] };
+      byTitle.set(e.title, c);
+    }
+    if (e.type === "docs") c.docs.push(e);
+    else if (e.subtype !== "test") c.stories.push(e);
+    for (const t2 of e.tags) if (!c.tags.includes(t2)) c.tags.push(t2);
+  }
+  const out = [...byTitle.values()].filter((c) => c.stories.length || c.docs.length);
+  for (const c of out) c.tags.sort();
+  return out.sort((a2, b) => a2.title.localeCompare(b.title));
+}
+function parseStorybookIndex(json, source) {
+  if (!isObj(json)) throw new StorybookIndexError("not-json", "The Storybook index is not a JSON object.");
+  if (typeof json.loginUrl === "string" && !("entries" in json) && !("stories" in json)) {
+    throw new StorybookIndexError("private", "This Storybook is private: it asks for a sign-in before showing its index.");
+  }
+  const map = isObj(json.entries) ? json.entries : isObj(json.stories) ? json.stories : null;
+  if (!map) throw new StorybookIndexError("empty", "This file has no Storybook entries.");
+  const v3 = !isObj(json.entries);
+  const entries = Object.entries(map).map(([k, raw]) => entryFrom(k, raw, v3)).filter((e) => e !== null);
+  if (!entries.length) throw new StorybookIndexError("empty", "This Storybook index lists no stories or docs.");
+  const version = typeof json.v === "number" ? json.v : v3 ? 3 : 4;
+  return { version, source: source ?? (v3 ? "stories.json" : "index.json"), entries, components: groupStorybookComponents(entries) };
+}
+function normalizeStorybookUrl(input) {
+  let u;
+  try {
+    u = new URL(input.trim());
+  } catch {
+    throw new StorybookIndexError("invalid-url", "Enter the full Storybook address, for example https://storybook.example.com");
+  }
+  const local = u.hostname === "localhost" || u.hostname === "127.0.0.1" || u.hostname === "[::1]";
+  if (u.protocol !== "https:" && !(u.protocol === "http:" && local)) {
+    throw new StorybookIndexError("invalid-url", "The Storybook address must start with https://");
+  }
+  if (u.username || u.password) throw new StorybookIndexError("invalid-url", "Remove the user name and password from the address.");
+  const path = u.pathname.replace(/\/(index\.html|iframe\.html|index\.json|stories\.json)$/i, "/").replace(/\/+$/, "");
+  return `${u.protocol}//${u.host}${path}`;
+}
+const storybookIndexUrls = (base) => {
+  const b = base.replace(/\/+$/, "");
+  return [
+    { url: `${b}/index.json`, source: "index.json" },
+    { url: `${b}/stories.json`, source: "stories.json" }
+  ];
+};
+const pairs = (o) => Object.entries(o).map(([k, v]) => `${encodeURIComponent(k)}:${encodeURIComponent(v)}`).join(";");
+function storybookIframeUrl(base, id, o = {}) {
+  let url = `${base.replace(/\/+$/, "")}/iframe.html?id=${encodeURIComponent(id)}&viewMode=${o.viewMode ?? "story"}`;
+  if (o.globals && Object.keys(o.globals).length) url += `&globals=${pairs(o.globals)}`;
+  if (o.args && Object.keys(o.args).length) url += `&args=${pairs(o.args)}`;
+  return url;
+}
+function storybookManagerUrl(base, id, viewMode = "story") {
+  return `${base.replace(/\/+$/, "")}/?path=/${viewMode}/${encodeURIComponent(id)}`;
+}
+async function fetchStorybookIndex(base, o = {}) {
+  const doFetch = o.fetch ?? ((url, init) => fetch(url, init));
+  const rank = { private: 6, http: 5, network: 4, empty: 3, "not-json": 2, "not-found": 1, "invalid-url": 0 };
+  let worst = null;
+  const keep = (e) => {
+    if (!worst || rank[e.code] > rank[worst.code]) worst = e;
+  };
+  for (const { url, source } of storybookIndexUrls(base)) {
+    let res;
+    try {
+      res = await doFetch(url, { headers: { accept: "application/json" }, ...o.signal ? { signal: o.signal } : {} });
+    } catch (err) {
+      if (o.signal?.aborted) throw err;
+      keep(new StorybookIndexError("network", `Could not reach ${url}. The host may be down or may not allow reading from another site.`));
+      continue;
+    }
+    if (res.status === 404 || res.status === 410) {
+      keep(new StorybookIndexError("not-found", `No Storybook index at ${base}: neither index.json nor stories.json was found.`, res.status));
+      continue;
+    }
+    if (res.status === 401 || res.status === 403) {
+      keep(new StorybookIndexError("private", "This Storybook is private: it asks for a sign-in before showing its index.", res.status));
+      continue;
+    }
+    if (!res.ok) {
+      keep(new StorybookIndexError("http", `The Storybook host answered ${res.status} for ${url}.`, res.status));
+      continue;
+    }
+    const text = await res.text();
+    let json;
+    try {
+      json = JSON.parse(text);
+    } catch {
+      keep(new StorybookIndexError("not-json", `${url} is not a Storybook index (the host answered with a web page).`));
+      continue;
+    }
+    try {
+      return parseStorybookIndex(json, source);
+    } catch (err) {
+      if (err instanceof StorybookIndexError) keep(err);
+      else throw err;
+    }
+  }
+  throw worst ?? new StorybookIndexError("not-found", `No Storybook index at ${base}.`);
+}
 export {
   af as AAA_MIN,
   ag as AA_MIN,
@@ -3207,32 +3361,32 @@ export {
   BELL,
   BRAND_FONTS,
   BRAND_SLUG_RE,
-  ag2 as BULK_LIMIT,
+  ah2 as BULK_LIMIT,
   ah as CHANGES_MODES,
-  ah2 as COLOR_FIELDS,
+  ai2 as COLOR_FIELDS,
   COMBINE_COMPARE_LIMIT,
   COMPARE_FILE_LIMIT,
-  ai2 as COMPONENT_SPECS_VERSION,
+  aj2 as COMPONENT_SPECS_VERSION,
   CONFIG_FILE,
-  aj2 as CONFLICT_REASON,
+  ak2 as CONFLICT_REASON,
   ai as CONTRAST_CELL_MAX,
   aj as CONTRAST_CHECKS_FILE,
   ak as ConfigError,
   al as DEFAULT_CHANGES_MODE,
-  ak2 as DEFAULT_COMPONENT_SPECS_FILE,
+  al2 as DEFAULT_COMPONENT_SPECS_FILE,
   am as DEFAULT_GOVERNANCE,
   an as DEFAULT_OVERRIDE,
   ao as DEFAULT_PRODUCTS,
-  al2 as DEFAULT_PROTECTED_BRANCHES,
+  am2 as DEFAULT_PROTECTED_BRANCHES,
   ap as DEFAULT_RIGHTS,
   DEFAULT_TOKEN_PATHS,
   aq as DEFAULT_VISUAL_IMPACT,
   DEMO_RELEASES,
-  am2 as DOCS_CHANGE_BUMP,
+  an2 as DOCS_CHANGE_BUMP,
   DOCS_DRAFT_MODEL,
-  an2 as DOCS_EDITOR_ORIGIN,
-  ao2 as DOCS_KEYS,
-  ap2 as DOCS_MCP_ORIGIN,
+  ao2 as DOCS_EDITOR_ORIGIN,
+  ap2 as DOCS_KEYS,
+  aq2 as DOCS_MCP_ORIGIN,
   DOCS_SELECTION_MODES,
   DRAFTED_BY_CLAUDE_LABEL,
   DRAFTS_DIR,
@@ -3247,13 +3401,13 @@ export {
   DRAFT_VOICE_RULES,
   ar as DTCG_TYPES,
   DraftPoller,
-  aq2 as EXPLORATION_CHECK,
+  ar2 as EXPLORATION_CHECK,
   EXPLORATION_LABEL,
   EXPLORATION_NOTES_DIR,
   EXPLORATION_PREFIX,
-  ar2 as EXPLORATION_STATUS_LABEL,
-  as2 as EXPLORATION_TIER_LABEL,
-  at2 as EXPLORATION_USE_CASES,
+  as2 as EXPLORATION_STATUS_LABEL,
+  at2 as EXPLORATION_TIER_LABEL,
+  au2 as EXPLORATION_USE_CASES,
   EXT_ID,
   EXT_SCOPES,
   FIDELITY_DEFAULTS,
@@ -3264,7 +3418,7 @@ export {
   FIGMA_REFERENCE_STORY,
   FIGMA_SPEC_DIR,
   FROM_FIGMA_LABEL,
-  au2 as GitHubClient,
+  av2 as GitHubClient,
   GitHubError,
   as as JsonParseError,
   LIGHTNESS,
@@ -3287,15 +3441,15 @@ export {
   PROSE_KEYS,
   PROTECTION_PARTS,
   PROTECTION_PART_PHRASE,
-  av2 as PULL_STATE_PILL,
-  aw2 as ProtectedBranchError,
+  aw2 as PULL_STATE_PILL,
+  ax2 as ProtectedBranchError,
   RADIUS_PRESETS,
-  ax2 as REDUCED_MOTION_NOTE,
+  ay2 as REDUCED_MOTION_NOTE,
   REQUESTS_BRANCH,
   REQUEST_KINDS,
   REQUEST_LABEL,
-  ay2 as REQUEST_STATUS_LABEL,
-  az2 as REVIEW_STATUS_ORDER,
+  az2 as REQUEST_STATUS_LABEL,
+  aA2 as REVIEW_STATUS_ORDER,
   aA as RIGHTS,
   aB as RIGHT_LABEL,
   RISK_LABELS,
@@ -3303,38 +3457,39 @@ export {
   SHARE_EXPLAIN,
   SIMILARITY_THRESHOLD,
   SINGLE_MODE,
-  aA2 as SPEC_FIELDS,
+  aB2 as SPEC_FIELDS,
   STEPS,
-  aB2 as SUGGESTION_APPLIED_MARK,
-  aC2 as SUGGESTION_APPLY_EXIT,
-  aD2 as SUGGESTION_KINDS,
-  aE2 as SUGGESTION_LABEL,
-  aF2 as SUGGESTION_LIMITS,
-  aG2 as SUGGESTION_REVIEW_MARK,
+  aC2 as SUGGESTION_APPLIED_MARK,
+  aD2 as SUGGESTION_APPLY_EXIT,
+  aE2 as SUGGESTION_KINDS,
+  aF2 as SUGGESTION_LABEL,
+  aG2 as SUGGESTION_LIMITS,
+  aH2 as SUGGESTION_REVIEW_MARK,
   SUGGESTION_SCHEMA,
-  aH2 as SUGGESTION_STATE_LABELS,
-  aI2 as SUGGESTION_STATUS_LABEL,
-  aJ2 as SUGGESTION_TOO_LARGE,
-  aK2 as SuggestionError,
+  aI2 as SUGGESTION_STATE_LABELS,
+  aJ2 as SUGGESTION_STATUS_LABEL,
+  aK2 as SUGGESTION_TOO_LARGE,
+  StorybookIndexError,
+  aL2 as SuggestionError,
   TIER_AXIS,
   TIER_NAMES,
   aD as TIER_ORDER,
-  aL2 as TOKEN_REJECTED_MESSAGE,
-  aM2 as TOKEN_SETTINGS_URL,
-  aN2 as TRIGGER_LABELS,
+  aM2 as TOKEN_REJECTED_MESSAGE,
+  aN2 as TOKEN_SETTINGS_URL,
+  aO2 as TRIGGER_LABELS,
   aE as TeamDirectory,
-  aO2 as UNRELEASED,
+  aP2 as UNRELEASED,
   aF as VISUAL_CHECK_LABEL,
   WAITING_FOR_CLAUDE_LABEL,
-  aP2 as acceptDocsDraft,
-  aQ2 as acceptDocsText,
+  aQ2 as acceptDocsDraft,
+  aR2 as acceptDocsText,
   addBrandToConfigText,
   addedComment,
   aG as affectedContrast,
   aH as aliasOf,
   aliasTarget,
-  aR2 as allowedMergeMethods,
-  aS2 as anatomyLabel,
+  aS2 as allowedMergeMethods,
+  aT2 as anatomyLabel,
   anchoredRamp,
   anthropicReplyText,
   anthropicRequest,
@@ -3347,10 +3502,10 @@ export {
   aK as approverEntries,
   aL as approverLists,
   askOthersToReviewOnGitHub,
-  aT2 as assertSafeBranch,
-  aU2 as assignRequestOnGitHub,
-  aV2 as assignVersions,
-  aW2 as base64ToUtf8,
+  aU2 as assertSafeBranch,
+  aV2 as assignRequestOnGitHub,
+  aW2 as assignVersions,
+  aX2 as base64ToUtf8,
   aM as baseBranchOf,
   bellChroma,
   aN as branchName,
@@ -3359,37 +3514,37 @@ export {
   branchWithJiraKey,
   brandDisplayName,
   brandPreviewVariables,
-  aX2 as bridgeMcpInstallCommand,
+  aY2 as bridgeMcpInstallCommand,
   buildFidelityReport,
   buildHistoryEntry,
   buildReport,
   buildTokenSet,
   buildUsageIndex,
   canAddTo,
-  aY2 as canOverride,
+  aZ2 as canOverride,
   canShare,
   aP as canShip,
-  aZ2 as canonicalJson,
+  a_2 as canonicalJson,
   changeEdits,
   aQ as changeKind,
   changeList,
-  a_2 as changeTable,
+  a$2 as changeTable,
   aR as changedModes,
   aS as changesMode,
-  a$2 as changesetBump,
+  b02 as changesetBump,
   checkBrandSlug,
   checkLayeredPair,
   choiceFor,
-  b02 as classifyAuth,
+  b12 as classifyAuth,
   classifyLayered,
   classifyRisk,
-  b12 as cleanDocs,
+  b22 as cleanDocs,
   cleanDocsText,
   cleanDraftText,
   aT as clearRawDeep,
   closeExplorationOnGitHub,
   closeOnGitHub,
-  b22 as closingIssueNumbers,
+  b32 as closingIssueNumbers,
   coerceValue,
   collectHistory,
   collectRefs,
@@ -3400,54 +3555,54 @@ export {
   combineConflicts,
   aW as comboKey,
   commentOnGitHub,
-  b32 as commitFileOnGitHub,
+  b42 as commitFileOnGitHub,
   commitLibraryResolution,
   aX as commitMessage,
   aY as compactJson,
   compareImages,
-  b42 as componentContrastPairs,
+  b52 as componentContrastPairs,
   componentForPath,
-  b52 as componentMotion,
+  b62 as componentMotion,
   componentSpecSuggestionPayload,
-  b62 as componentsUsingMotionToken,
-  b72 as composeChangeset,
+  b72 as componentsUsingMotionToken,
+  b82 as composeChangeset,
   composeFiles,
   composeNewBrandBody,
   composePendingDrafts,
   aZ as composePrBody,
   composeProposalBody,
   composeRequestIssue,
-  b82 as composeSuggestionAppliedComment,
-  b92 as composeSuggestionIssue,
-  ba2 as composeSuggestionReviewComment,
+  b92 as composeSuggestionAppliedComment,
+  ba2 as composeSuggestionIssue,
+  bb2 as composeSuggestionReviewComment,
   a_ as composite,
   conflictRoute,
   a$ as contextFor,
   contextLabel,
-  bb2 as continueDocsProposalOnGitHub,
+  bc2 as continueDocsProposalOnGitHub,
   contrastDelta,
-  bc2 as contrastDeltaTable,
+  bd2 as contrastDeltaTable,
   b0 as contrastLevel,
   b1 as contrastPair,
   b2 as contrastRatio,
   contrastScope,
-  bd2 as countChanges,
-  be2 as coverageSummary,
+  be2 as countChanges,
+  bf2 as coverageSummary,
   createDocsDraftSession,
   createPendingDrafts,
   createSuggestionOnGitHub,
-  bf2 as cssModuleClasses,
+  bg2 as cssModuleClasses,
   cssOf,
   cssVarOf,
   cssVarsIn,
-  bg2 as declineComment,
-  bh2 as declineReasonProblems,
-  bi2 as declineRequestOnGitHub,
-  bj2 as declineSuggestionOnGitHub,
+  bh2 as declineComment,
+  bi2 as declineReasonProblems,
+  bj2 as declineRequestOnGitHub,
+  bk2 as declineSuggestionOnGitHub,
   decodePicks,
   defaultChoiceFor,
   b3 as defaultContext,
-  bk2 as defaultDocsFooter,
+  bl2 as defaultDocsFooter,
   defaultFile,
   defaultProduct,
   defaultScopes,
@@ -3458,29 +3613,29 @@ export {
   b6 as detectLayout,
   diffLayered,
   dismissStaleFrom,
-  bl2 as docsAuthorLine,
-  bm2 as docsFileText,
+  bm2 as docsAuthorLine,
+  bn2 as docsFileText,
   docsPrompt,
-  bn2 as docsProposal,
-  bo2 as docsSectionShapes,
+  bo2 as docsProposal,
+  bp2 as docsSectionShapes,
   docsSectionsAnswer,
   docsSectionsResult,
   docsSelectionPrompt,
-  bp2 as docsSlug,
-  bq2 as docsSuggestionPayload,
+  bq2 as docsSlug,
+  br2 as docsSuggestionPayload,
   docsTaskKeys,
   docsTaskPrompt,
-  br2 as docsText,
-  bs2 as draftChangeLine,
+  bs2 as docsText,
+  bt2 as draftChangeLine,
   draftImagePath,
   draftItemBrief,
-  bt2 as draftPushDescription,
-  bu2 as draftRequestText,
+  bu2 as draftPushDescription,
+  bv2 as draftRequestText,
   draftSessionPath,
   dtcgColor,
   effectiveScopes,
-  bv2 as effectiveTier,
-  bw2 as eligibleReviewers,
+  bw2 as effectiveTier,
+  bx2 as eligibleReviewers,
   emptyTokenFile,
   encodePicks,
   ensureRequestsBranch,
@@ -3489,71 +3644,75 @@ export {
   evaluatePairs,
   b9 as expandEntries,
   ba as expandOwners,
-  bx2 as explorationBranch,
+  by2 as explorationBranch,
   explorationNote,
   explorationNotePath,
   explorationPrBody,
   explorationPrTitle,
   explorationProblems,
-  by2 as explorationRules,
-  bz2 as explorationShareMessage,
+  bz2 as explorationRules,
+  bA2 as explorationShareMessage,
   explorationSlug,
-  bA2 as explorationSlugFromBranch,
+  bB2 as explorationSlugFromBranch,
   explorationStatus,
   explorationSummary,
   explorationTestBuildOnGitHub,
   explorationTryIt,
   explorationTryItOnGitHub,
+  fetchStorybookIndex,
   fidelityComponentLine,
   fidelityVerdict,
   bb as fieldChanges,
   figmaBranchTitle,
-  bB2 as figmaCell,
+  bC2 as figmaCell,
   figmaChangeOnGitHub,
   figmaDraftBody,
   figmaDraftBrief,
+  figmaNodeUrl,
+  figmaNodes,
   figmaOriginSection,
   figmaPushStatus,
   figmaPushStatusesOnGitHub,
   figmaSpecPath,
   figmaSpecSlug,
-  bC2 as fileModes,
-  bD2 as filterHistory,
+  bD2 as fileModes,
+  bE2 as filterHistory,
   findExplorationOnGitHub,
-  bE2 as findOpenDocsProposal,
-  bF2 as findOpenDocsProposalOnGitHub,
+  bF2 as findOpenDocsProposal,
+  bG2 as findOpenDocsProposalOnGitHub,
   findPreviewComment,
   bc as findProduct,
   findReferenceProblems,
   bd as findToken,
   be as findVercelComment,
-  bG2 as firstParagraph,
+  bH2 as firstParagraph,
   bf as flattenLayerFile,
   flattenTokens,
   formatChangeset,
-  bH2 as formatDocsJson,
+  bI2 as formatDocsJson,
   formatFigmaSpec,
   bg as formatNumber,
   bh as formatOwnerEntry,
   formatValue,
   freshness,
-  bI2 as friendlyMessage,
+  bJ2 as friendlyMessage,
   fromHex,
   bi as fromPlain,
   generateRamp,
   bj as getChild,
   bk as getEntry,
-  bJ2 as getSuggestionOnGitHub,
+  bK2 as getSuggestionOnGitHub,
   gitBlobSha,
   gitHubHistoryBackend,
   bl as globToRegExp,
+  groupStorybookComponents,
   bm as groupsPhrase,
-  bK2 as hasSuggestionBlock,
-  bL2 as hasWriteAccess,
-  bM2 as hashSpec,
+  bL2 as hasSuggestionBlock,
+  bM2 as hasWriteAccess,
+  bN2 as hashSpec,
   bn as hexToRgba,
   bo as holdersOf,
-  bN2 as iconComponentName,
+  bO2 as iconComponentName,
   idExtensionFor,
   impactedModules,
   importsIn,
@@ -3561,29 +3720,29 @@ export {
   bq as inheritedTypeAt,
   br as installCommand,
   bs as installCommandFromPreviewComment,
-  bO2 as isActiveExploration,
+  bP2 as isActiveExploration,
   isAlias,
-  bP2 as isAutomationPull,
-  bQ2 as isDocsProposalBranch,
+  bQ2 as isAutomationPull,
+  bR2 as isDocsProposalBranch,
   isDocsSelectionMode,
   isDraftSessionId,
   isExplorationBranch,
   isExplorationPull,
   bt as isGuardrail,
-  bR2 as isGuardrailPath,
+  bS2 as isGuardrailPath,
   isHex,
-  bS2 as isJiraKey,
-  bT2 as isMissingPermission,
+  bT2 as isJiraKey,
+  bU2 as isMissingPermission,
   isMultiMode,
   isPlanRefusal,
   isProseKey,
-  bU2 as isReleasePull,
+  bV2 as isReleasePull,
   bu as isTeamEntry,
   bv as isTokenFile,
-  bV2 as isTokenRejected,
+  bW2 as isTokenRejected,
   bw as isVercelComment,
-  bW2 as jiraIssueFields,
-  bX2 as jiraKeyOf,
+  bX2 as jiraIssueFields,
+  bY2 as jiraKeyOf,
   bx as kindForMin,
   layeredImpact,
   by as layeredParityIssues,
@@ -3591,20 +3750,20 @@ export {
   levenshtein,
   libraryBranchPlan,
   libraryPreviewState,
-  bY2 as linkRequestToExplorationOnGitHub,
+  bZ2 as linkRequestToExplorationOnGitHub,
   linkStatus,
-  bZ2 as linkSuggestionPrOnGitHub,
+  b_2 as linkSuggestionPrOnGitHub,
   linkedLibraryBranchOnGitHub,
-  b_2 as linkedPullsOf,
+  b$2 as linkedPullsOf,
   listBrands,
   listExplorationsOnGitHub,
   listFigmaChangesOnGitHub,
   listPendingDrafts,
-  b$2 as listSuggestionsOnGitHub,
+  c02 as listSuggestionsOnGitHub,
   loadConfig,
   loadGitHubHistory,
   loadProtection,
-  c02 as loadRepoFiles,
+  c12 as loadRepoFiles,
   loadRequiredChecks,
   bz as luminance,
   mailtoHref,
@@ -3612,48 +3771,49 @@ export {
   markFigmaChangeDraftedOnGitHub,
   mergeDocsDraft,
   mergeDraftResults,
-  c12 as mergeGate,
+  c22 as mergeGate,
   mergeOnGitHub,
   mergePiecesRecord,
   mergeReleases,
   missingChoices,
-  c22 as missingPermissionMessage,
-  c32 as missingProse,
+  c32 as missingPermissionMessage,
+  c42 as missingProse,
   modeDisplayName,
   modeFile,
-  c42 as modeLabel,
+  c52 as modeLabel,
   modesOf$1 as modesOf,
   moveToken,
   bA as nearestQuestion,
   nearestStep,
   bB as neededBySection,
-  c52 as needsDocsReview,
+  c62 as needsDocsReview,
   neutralChroma,
   neutralOffset,
   newBrandSection,
   newDraftSessionId,
   bC as nodesEqual,
   bD as normalizeRights,
+  normalizeStorybookUrl,
   oklch,
   oklchToLinear,
   onlyTokens,
   openComponentPushOnGitHub,
   openLibraryBranchOnGitHub,
-  c62 as openPulls,
+  c72 as openPulls,
   overlap,
   overrideComment,
   bE as overrideKey,
   overrideMergeOnGitHub,
-  c72 as overrideReasonProblem,
+  c82 as overrideReasonProblem,
   overrideRefusedComment,
   bF as ownerEntryProblems,
   packageDir,
   packageDirCandidates,
   bG as pairKey,
   parseChangelog,
-  c82 as parseChangesetText,
+  c92 as parseChangesetText,
   parseColor,
-  c92 as parseComponentSpecs,
+  ca2 as parseComponentSpecs,
   parseContrastChecks,
   bH as parseDimension,
   parseDocsReply,
@@ -3661,27 +3821,28 @@ export {
   parseExplorationBody,
   parseFigmaOrigin,
   parseFigmaSpec,
-  ca2 as parseJiraKey,
+  cb2 as parseJiraKey,
   bI as parseJson,
   bJ as parseNeededBy,
-  cb2 as parseOverrideComment,
+  cc2 as parseOverrideComment,
   bK as parseOwnerEntry,
   parsePendingDrafts,
   parsePiecesRecord,
-  cc2 as parseRepo,
-  cd2 as parseRequestIssue,
-  ce2 as parseStructureChange,
-  cf2 as parseSuggestionAppliedComment,
-  cg2 as parseSuggestionIssue,
-  ch2 as parseSuggestionReviewComment,
-  ci2 as parseTier,
+  cd2 as parseRepo,
+  ce2 as parseRequestIssue,
+  parseStorybookIndex,
+  cf2 as parseStructureChange,
+  cg2 as parseSuggestionAppliedComment,
+  ch2 as parseSuggestionIssue,
+  ci2 as parseSuggestionReviewComment,
+  cj2 as parseTier,
   parseTokenFile,
   bL as parseVercelComment,
-  cj2 as patchDocsJson,
+  ck2 as patchDocsJson,
   pathId,
   pathSimilarity,
-  ck2 as pendingApprovals,
-  cl2 as permissionLabel,
+  cl2 as pendingApprovals,
+  cm2 as permissionLabel,
   pickedOption,
   p as pieceId,
   bM as piecesSection,
@@ -3690,14 +3851,14 @@ export {
   planNewBrand,
   planReference,
   planReferences,
-  cm2 as planRestore,
-  cn2 as planRevert,
-  co2 as planSuggestionApply,
-  cp as planToJson,
+  cn2 as planRestore,
+  co2 as planRevert,
+  cp as planSuggestionApply,
+  cq as planToJson,
   planTokenMerge,
   planTokenProposal,
-  cq as prNumberFromSubject,
-  cr as prefillDocs,
+  cr as prNumberFromSubject,
+  cs as prefillDocs,
   bO as previewComment,
   previewLinks,
   bP as previewLinksOf,
@@ -3717,9 +3878,9 @@ export {
   bW as projectOfLabel,
   promoteExplorationOnGitHub,
   promotionPlan,
-  cs as proposeDocsOnGitHub,
+  ct as proposeDocsOnGitHub,
   a as proposedTokenPath,
-  ct as propsTable,
+  cu as propsTable,
   protectLibrary,
   protectRefusal,
   bX as protectedBranchesOf,
@@ -3727,9 +3888,9 @@ export {
   protectionRulesetName,
   protectionSentence,
   protectionState,
-  cu as pullState,
-  cv as pushChangeRows,
-  cw as rateLimitMessage,
+  cv as pullState,
+  cw as pushChangeRows,
+  cx as rateLimitMessage,
   readCombineBranch,
   readLibraryConflicts,
   readPendingDrafts,
@@ -3739,29 +3900,29 @@ export {
   reconcileIds,
   recordPiecesOnGitHub,
   referenceImagePath,
-  cx as releasePull,
+  cy as releasePull,
   releasesFromTags,
   removeToken,
   removedSide,
   bY as renderedColor,
-  cy as reopenEligibility,
+  cz as reopenEligibility,
   reopenOnGitHub,
-  cz as requestBrief,
-  cA as requestImagePath,
-  cB as requestIssueTitle,
-  cC as requestStatus,
-  cD as requiredApprovals,
+  cA as requestBrief,
+  cB as requestImagePath,
+  cC as requestIssueTitle,
+  cD as requestStatus,
+  cE as requiredApprovals,
   requiredCheckNames,
-  cE as requiredPermission,
+  cF as requiredPermission,
   resolutionMessage,
   resolve,
   resolveBranchPreviews,
   resolvedTokenFiles,
   reviewOnGitHub,
-  cF as reviewQueue,
-  cG as reviewStatusKind,
-  cH as reviewSuggestionOnGitHub,
-  cI as reviewersToAsk,
+  cG as reviewQueue,
+  cH as reviewStatusKind,
+  cI as reviewSuggestionOnGitHub,
+  cJ as reviewersToAsk,
   bZ as rgbaToDtcg,
   rgbaToHex,
   b_ as rightsProblems,
@@ -3779,51 +3940,54 @@ export {
   sanitizeDraftText,
   sanitizeDraftTitle,
   sanitizeResultLines,
-  cJ as sectionsNeedingReview,
+  cK as sectionsNeedingReview,
   selectTokenFiles,
   c1 as serializeJson,
   serializePendingDrafts,
   serializeTokenFile,
-  cK as sha256Hex,
+  cL as sha256Hex,
   shadowedEdits,
   shareDescription,
   shareMessage,
   shareState,
   c2 as shipPolicy,
-  cL as shortVariant,
-  cM as shortVariants,
+  cM as shortVariant,
+  cN as shortVariants,
   showShare,
   slugify,
   c3 as snapshotUrl,
-  cN as specHash,
-  cO as specsUsage,
+  cO as specHash,
+  cP as specsUsage,
   stableCommand,
   startExplorationOnGitHub,
   stateSentence,
+  storybookIframeUrl,
+  storybookIndexUrls,
+  storybookManagerUrl,
   c4 as storybookUrl,
   c5 as suggestNearestComment,
   suggestTokenProposalOnGitHub,
-  cP as suggestionAllowedRoots,
-  cQ as suggestionAppliedComment,
-  cR as suggestionApplyTable,
-  cS as suggestionIssueTitle,
-  cT as suggestionKindFromLabels,
-  cU as suggestionLabels,
-  cV as suggestionPathProblems,
-  cW as suggestionPayloadSha,
-  cX as suggestionReviewState,
-  cY as suggestionShapeProblems,
+  cQ as suggestionAllowedRoots,
+  cR as suggestionAppliedComment,
+  cS as suggestionApplyTable,
+  cT as suggestionIssueTitle,
+  cU as suggestionKindFromLabels,
+  cV as suggestionLabels,
+  cW as suggestionPathProblems,
+  cX as suggestionPayloadSha,
+  cY as suggestionReviewState,
+  cZ as suggestionShapeProblems,
   suggestionStateFromLabels,
-  cZ as suggestionStateLabel,
+  c_ as suggestionStateLabel,
   suggestionStatus,
-  c_ as suggestionSubject,
-  c$ as summarizeApprovals,
-  d0 as summarizeCi,
+  c$ as suggestionSubject,
+  d0 as summarizeApprovals,
+  d1 as summarizeCi,
   summarizeComponent,
-  d1 as summarizeSuggestionApprovals,
+  d2 as summarizeSuggestionApprovals,
   c6 as summarizeTokenChange,
   switchToPublishedOnGitHub,
-  d2 as syncSuggestionStateLabel,
+  d3 as syncSuggestionStateLabel,
   takeMine,
   c7 as tarballAssetName,
   c8 as tarballUrl,
@@ -3833,19 +3997,19 @@ export {
   cc as teamsIn,
   threeWayDiff,
   tintedNeutral,
-  d3 as titleOf,
+  d4 as titleOf,
   titleWithJiraKey,
   cd as toAlias,
-  d4 as toChangeSummary,
+  d5 as toChangeSummary,
   toConfigJson,
   toHex,
   ce as toMap,
   toOklch,
   cf as toPlain,
   cg as tokenBump,
-  d5 as tokenCssVar,
+  d6 as tokenCssVar,
   tokenFilesOf,
-  d6 as tokenHistory,
+  d7 as tokenHistory,
   t as tokenLabel,
   ch as tokenNode,
   tokenSuggestionPayload,
@@ -3857,15 +4021,15 @@ export {
   unpicked,
   ci as unreadableShipTeams,
   cj as unreadableTeams,
-  d7 as unsafePathProblem,
+  d8 as unsafePathProblem,
   updatePendingDrafts,
   upsertToken,
   useLibraryPreviewOnGitHub,
-  d8 as utf8ToBase64,
-  d9 as validateComponentSpec,
-  da as validateDocs,
+  d9 as utf8ToBase64,
+  da as validateComponentSpec,
+  db as validateDocs,
   validateDocsTask,
-  db as validateIntegrations,
+  dc as validateIntegrations,
   validateLayered,
   validatePendingDrafts,
   validateProposal,
@@ -3874,18 +4038,18 @@ export {
   cl as valueToCss,
   valuesEqual,
   variantKeyOf,
-  dc as variantName,
-  dd as versionTimeline,
+  dd as variantName,
+  de as versionTimeline,
   cm as visualImpactProblems,
   cn as whoCanShipSentence,
   co as whyItExists,
-  de as withAuthorLine,
+  df as withAuthorLine,
   withFigmaOrigin,
   withLink,
   withNeededBy,
   withPiecesRecord,
-  df as withRequestExploration,
-  dg as withoutJiraKey,
+  dg as withRequestExploration,
+  dh as withoutJiraKey,
   writeDraftResults,
   writeTokenProposalOnGitHub
 };