@bridge-ds/core 0.11.0 → 0.13.0

package/README.md

@@ -275,7 +275,7 @@ parseSuggestionIssue(body, { comments?, author? }): { ok: true; payload; sha; ma
 suggestionPayloadSha(payload); canonicalJson(value); sha256Hex(text); gitBlobSha(text);
 suggestionLabels(payload, { state?, labels? }); suggestionIssueTitle(payload); suggestionStatus({ state, stateReason?, linkedPrs?, review?, applied?, outdated? });
 suggestionPathProblems(payload, config): string[];    unsafePathProblem(path): string | null;
-summarizeSuggestionApprovals(comments, { owners, rights?, teams? }, { payloadSha, author? }); suggestionReviewState(tier, approvals);
+summarizeSuggestionApprovals(comments, { owners, rights?, teams?, soloOwnerCanApproveBoth? }, { payloadSha, author? }); suggestionReviewState(tier, approvals);
 composeSuggestionReviewComment(record); parseSuggestionReviewComment(body); composeSuggestionAppliedComment(record); parseSuggestionAppliedComment(body);
 // GitHub (Issues read and write only)
 createSuggestionOnGitHub(gh, payload, opts); listSuggestionsOnGitHub(gh, { state? }); getSuggestionOnGitHub(gh, n, gov, { outdated? });
@@ -283,6 +283,22 @@ reviewSuggestionOnGitHub(gh, n, { event, role?, message?, payloadSha? }, gov); l
 declineSuggestionOnGitHub(gh, n, reason, by?); syncSuggestionStateLabel(gh, n, labels, status);
 ```
 
+## storybook (storybook.ts)
+
+Reads a deployed or built Storybook without the repo: `index.json` (v4 for Storybook 7, v5 for 8 and later), else
+`stories.json` (v3). Entries are grouped by title into components (name = last title segment); test entries stay out
+of `stories`. A 404, an HTML answer from a host that falls back to `index.html`, or a body with no entries moves on to
+the next file. Errors carry a code: `invalid-url`, `not-found`, `not-json`, `private` (sign-in wall, Chromatic login
+answer, 401/403), `empty`, `http`, `network`. Pure, with an injected `fetch`; `@bridge-ds/visual` uses the parser for
+`storybook-static/index.json` and the iframe URL builder for its captures.
+
+```ts
+fetchStorybookIndex(base, { fetch?, signal? }): Promise<{ version; source: 'index.json' | 'stories.json'; entries; components }>;
+parseStorybookIndex(json, source?); groupStorybookComponents(entries): { title; name; group; stories; docs; tags }[];
+normalizeStorybookUrl(pasted): string;   // https only (http on localhost), drops ?path=, /index.html, /iframe.html
+storybookIframeUrl(base, id, { viewMode?, globals?, args? }); storybookManagerUrl(base, id, viewMode?); storybookIndexUrls(base);
+```
+
 ## history (history.ts, history-github.ts, history-demo.ts)
 
 What changed in the tokens, when, who changed it and why, and how to undo it safely.

package/bridge.config.schema.json

@@ -437,6 +437,11 @@
             }
           }
         },
+        "soloOwnerCanApproveBoth": {
+          "type": "boolean",
+          "description": "For a design system run by one person. When true and the owners resolve to exactly one person who holds both roles, that person's approval counts as the design and the tech approval, so Tier 2 and Tier 3 changes can be approved. The author of a change still never approves it. Default false: one person never covers both approvals alone.",
+          "default": false
+        },
         "rights": {
           "type": "object",
           "additionalProperties": false,

package/dist/audit/index.js

@@ -1,6 +1,6 @@
-import { i as isAuditable, a as auditFile } from "../report-DOnKUw8G.js";
-import { A, b, c, C, D, d, F, I, L, e, M, N, f, g, h, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, B, E, G, H, J, K, O, P, Q, R, S, T, U, V, W, X, Y, Z } from "../report-DOnKUw8G.js";
-import { p as pieceId, a as proposedTokenPath, t as tokenLabel } from "../prod-branch-BdMPKffE.js";
+import { i as isAuditable, a as auditFile } from "../report-BeWNSjPk.js";
+import { A, b, c, C, D, d, F, I, L, e, M, N, f, g, h, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, B, E, G, H, J, K, O, P, Q, R, S, T, U, V, W, X, Y, Z } from "../report-BeWNSjPk.js";
+import { p as pieceId, a as proposedTokenPath, t as tokenLabel } from "../prod-branch-6ftQWwdu.js";
 const lines = (text) => text.split(/\r?\n/);
 function lineBag(text) {
   const bag = /* @__PURE__ */ new Map();

package/dist/config.d.ts

@@ -114,6 +114,11 @@ export interface GovernanceConfig {
      * and anyone with write access may ship, as before the field existed.
      */
     rights?: Rights | undefined;
+    /**
+     * A design system run by one person: when the owners resolve to exactly one person holding both roles, that
+     * person's approval counts for design and tech. Default false: one person never covers both approvals alone.
+     */
+    soloOwnerCanApproveBoth?: boolean | undefined;
 }
 /** `bridge audit` settings: how product code that consumes the design system is measured. */
 export interface AuditConfig {

package/dist/index.d.ts

@@ -63,3 +63,4 @@ export * from './suggestions';
 export * from './suggestion-review';
 export * from './suggestions-github';
 export * from './suggestion-apply';
+export * from './storybook';

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, 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";
+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-6ftQWwdu.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, ch, ci, cj, t, ck, cl, cm, cn, co, cp, cq, cr } from "./prod-branch-6ftQWwdu.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-bH6-gZrE.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 as cp2, cq as cq2, cr as cr2, 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-bH6-gZrE.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;
@@ -3210,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,
@@ -3326,6 +3469,7 @@ export {
   aI2 as SUGGESTION_STATE_LABELS,
   aJ2 as SUGGESTION_STATUS_LABEL,
   aK2 as SUGGESTION_TOO_LARGE,
+  StorybookIndexError,
   aL2 as SuggestionError,
   TIER_AXIS,
   TIER_NAMES,
@@ -3515,6 +3659,7 @@ export {
   explorationTestBuildOnGitHub,
   explorationTryIt,
   explorationTryItOnGitHub,
+  fetchStorybookIndex,
   fidelityComponentLine,
   fidelityVerdict,
   bb as fieldChanges,
@@ -3560,6 +3705,7 @@ export {
   gitBlobSha,
   gitHubHistoryBackend,
   bl as globToRegExp,
+  groupStorybookComponents,
   bm as groupsPhrase,
   bL2 as hasSuggestionBlock,
   bM2 as hasWriteAccess,
@@ -3647,6 +3793,7 @@ export {
   newDraftSessionId,
   bC as nodesEqual,
   bD as normalizeRights,
+  normalizeStorybookUrl,
   oklch,
   oklchToLinear,
   onlyTokens,
@@ -3683,6 +3830,7 @@ export {
   parsePiecesRecord,
   cd2 as parseRepo,
   ce2 as parseRequestIssue,
+  parseStorybookIndex,
   cf2 as parseStructureChange,
   cg2 as parseSuggestionAppliedComment,
   ch2 as parseSuggestionIssue,
@@ -3705,11 +3853,11 @@ export {
   planReferences,
   cn2 as planRestore,
   co2 as planRevert,
-  cp as planSuggestionApply,
-  cq as planToJson,
+  cp2 as planSuggestionApply,
+  cq2 as planToJson,
   planTokenMerge,
   planTokenProposal,
-  cr as prNumberFromSubject,
+  cr2 as prNumberFromSubject,
   cs as prefillDocs,
   bO as previewComment,
   previewLinks,
@@ -3808,13 +3956,19 @@ export {
   showShare,
   slugify,
   c3 as snapshotUrl,
+  c4 as soloApprover,
+  c5 as soloOwnerOf,
+  c6 as soloOwnerSentence,
   cO as specHash,
   cP as specsUsage,
   stableCommand,
   startExplorationOnGitHub,
   stateSentence,
-  c4 as storybookUrl,
-  c5 as suggestNearestComment,
+  storybookIframeUrl,
+  storybookIndexUrls,
+  storybookManagerUrl,
+  c7 as storybookUrl,
+  c8 as suggestNearestComment,
   suggestTokenProposalOnGitHub,
   cQ as suggestionAllowedRoots,
   cR as suggestionAppliedComment,
@@ -3834,33 +3988,33 @@ export {
   d1 as summarizeCi,
   summarizeComponent,
   d2 as summarizeSuggestionApprovals,
-  c6 as summarizeTokenChange,
+  c9 as summarizeTokenChange,
   switchToPublishedOnGitHub,
   d3 as syncSuggestionStateLabel,
   takeMine,
-  c7 as tarballAssetName,
-  c8 as tarballUrl,
-  c9 as teamKey,
-  ca as teamKeyOf,
-  cb as teamUnreadableMessage,
-  cc as teamsIn,
+  ca as tarballAssetName,
+  cb as tarballUrl,
+  cc as teamKey,
+  cd as teamKeyOf,
+  ce as teamUnreadableMessage,
+  cf as teamsIn,
   threeWayDiff,
   tintedNeutral,
   d4 as titleOf,
   titleWithJiraKey,
-  cd as toAlias,
+  cg as toAlias,
   d5 as toChangeSummary,
   toConfigJson,
   toHex,
-  ce as toMap,
+  ch as toMap,
   toOklch,
-  cf as toPlain,
-  cg as tokenBump,
+  ci as toPlain,
+  cj as tokenBump,
   d6 as tokenCssVar,
   tokenFilesOf,
   d7 as tokenHistory,
   t as tokenLabel,
-  ch as tokenNode,
+  ck as tokenNode,
   tokenSuggestionPayload,
   tokenUsage,
   tokensPath,
@@ -3868,8 +4022,8 @@ export {
   tryInProductUrl,
   tryTogetherUrl,
   unpicked,
-  ci as unreadableShipTeams,
-  cj as unreadableTeams,
+  cl as unreadableShipTeams,
+  cm as unreadableTeams,
   d8 as unsafePathProblem,
   updatePendingDrafts,
   upsertToken,
@@ -3883,15 +4037,15 @@ export {
   validatePendingDrafts,
   validateProposal,
   validateSet,
-  ck as valueIn,
-  cl as valueToCss,
+  cn as valueIn,
+  co as valueToCss,
   valuesEqual,
   variantKeyOf,
   dd as variantName,
   de as versionTimeline,
-  cm as visualImpactProblems,
-  cn as whoCanShipSentence,
-  co as whyItExists,
+  cp as visualImpactProblems,
+  cq as whoCanShipSentence,
+  cr as whyItExists,
   df as withAuthorLine,
   withFigmaOrigin,
   withLink,