@bridge-ds/mcp 0.3.1 → 0.3.2

package/README.md

@@ -69,7 +69,7 @@ Working on the server itself: `npm run mcp:build` in a clone of this repo builds
 | `bridge_get_token_history` | Every change of one token, before and after per mode |
 | `bridge_plan_revert` | Dry run of a revert (or a one-token restore) against the current base, conflicts shown |
 | `bridge_propose_revert` | The revert as a local bridge/* branch or a draft PR labelled revert |
-| `bridge_audit` | Adoption in a product folder or file (local): token and component adoption, hardcoded values with the closest token, foreign components with the DS one to use, top files and fixes |
+| `bridge_audit` | Adoption in a product folder or file (local): CSS, SCSS, Less, TS/JS, TSX/JSX, Astro, Vue and Svelte. Token and component adoption, hardcoded values with the closest token, foreign and native components with the DS one to use, top files and fixes; `allowlist` and `bridge-audit-ignore-next-line: reason` comments leave known exceptions out, listed under `ignored` |
 | `bridge_list_requests` | Component change requests (issues labeled `component-change`) with status and linked pull requests |
 | `bridge_get_request` | One request with the component's files and a brief to implement it in a pull request that says "Closes #n" |
 | `bridge_create_request` | File a request as an issue labeled `component-change` (token required; `dryRun` previews; `exploration` targets an exploration branch) |

package/dist/{chunk-I3TL76GK.js → chunk-MTQCDV65.js}

@@ -774,6 +774,12 @@ function classifyAuth(status, detail, opts = {}) {
   }
   return {};
 }
+function rateLimitMessage(x) {
+  const when = x.resetsAt ? ` It resets at ${x.resetsAt.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" })}.` : "";
+  if (x.withToken) return `GitHub's hourly request limit for this token is used up.${when} Try again after that.`;
+  const hint = x.tokenHint ?? "add a GitHub token";
+  return `GitHub's hourly limit for requests without a token (60 an hour) is used up.${when} To keep going now, ${hint}: a token gets 5,000 requests an hour.`;
+}
 var DEFAULT_RETRY = { attempts: 3, baseDelayMs: 600, sleep: (ms) => new Promise((r) => setTimeout(r, ms)) };
 var isTransient = (status, detail) => status === 0 || status >= 500 || status === 429 || status === 403 && /secondary rate limit/i.test(detail);
 var API = "https://api.github.com";
@@ -877,12 +883,8 @@ var GitHubClient = class _GitHubClient {
       const remaining = res.headers?.get("x-ratelimit-remaining");
       const reset = res.headers?.get("x-ratelimit-reset");
       if ((res.status === 403 || res.status === 429) && remaining === "0") {
-        const when = reset ? new Date(Number(reset) * 1e3) : void 0;
-        throw new GitHubError(
-          429,
-          `GitHub's hourly request limit for this token is used up.${when ? ` It resets at ${when.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" })}.` : ""} Try again after that.`,
-          detail
-        );
+        const resetsAt = reset ? new Date(Number(reset) * 1e3) : void 0;
+        throw new GitHubError(429, rateLimitMessage({ withToken: Boolean(this.token), resetsAt, tokenHint: this.options.tokenHint }), detail);
       }
       const info = classifyAuth(res.status, detail, {
         path,
@@ -1853,10 +1855,10 @@ function planRestore(input) {
   const from = input.label ? ` from ${input.label}` : "";
   const planned = [{ key: keyOf(path, file), path, file, summary: `Set ${path} to ${show(input.value)} (${label})`, edit: { op: "set", path, file, value: input.value } }];
   const title = `Restore ${path} (${label})${from}`;
-  const item = input.item;
+  const item2 = input.item;
   const summary2 = [
     `Restores \`${path}\` in ${label} to ${show(input.value)}${from}.`,
-    ...item ? ["", `That value came from ${item.pr ? item.pr.url ? `[#${item.pr.number}](${item.pr.url})` : `#${item.pr.number}` : `commit ${item.sha.slice(0, 7)}`} ("${item.title}"), ${item.date.slice(0, 10)}, by ${item.author}.`] : []
+    ...item2 ? ["", `That value came from ${item2.pr ? item2.pr.url ? `[#${item2.pr.number}](${item2.pr.url})` : `#${item2.pr.number}` : `commit ${item2.sha.slice(0, 7)}`} ("${item2.title}"), ${item2.date.slice(0, 10)}, by ${item2.author}.`] : []
   ].join("\n");
   return finishPlan({ ...input, kind: "restore", title, prTitle: title, summary: summary2, planned, conflicts: [], skipped: [] });
 }
@@ -3298,29 +3300,29 @@ function sanitizeDraftText(raw) {
   const summary2 = typeof raw.summary === "string" ? sentences(cleanDraftText(raw.summary)) : "";
   return { title, summary: summary2 };
 }
-function sanitizeDocsResult(item, r) {
-  const task = item.docs.task;
+function sanitizeDocsResult(item2, r) {
+  const task = item2.docs.task;
   if (task.kind === "selection") {
     const raw = r.replacement ?? (r.docs && typeof r.docs === "object" ? r.docs[task.key] : void 0);
     const replacement = sanitizeDocsReplacement(raw);
-    if (!replacement) throw new Error(`Item "${item.id}" asks to rewrite a passage of ${task.key}: send {"id": "${item.id}", "replacement": "..."}.`);
+    if (!replacement) throw new Error(`Item "${item2.id}" asks to rewrite a passage of ${task.key}: send {"id": "${item2.id}", "replacement": "..."}.`);
     return { replacement };
   }
   try {
     const { sections: sections2, checked } = docsSectionsAnswer(task, r.docs ?? {});
     return { docs: sections2, checked };
   } catch {
-    throw new Error(`Item "${item.id}" asks for the sections ${docsTaskKeys(task).join(", ")}: send {"id": "${item.id}", "docs": {${task.keys.map((k) => `"${k}": ...`).join(", ")}}} in the shapes of its prompt.`);
+    throw new Error(`Item "${item2.id}" asks for the sections ${docsTaskKeys(task).join(", ")}: send {"id": "${item2.id}", "docs": {${task.keys.map((k) => `"${k}": ...`).join(", ")}}} in the shapes of its prompt.`);
   }
 }
-function sanitizeResultLines(item, raw) {
+function sanitizeResultLines(item2, raw) {
   if (raw === void 0 || raw === null) return [];
-  if (!Array.isArray(raw)) throw new Error(`lines for "${item.id}" must be a list of {"id", "line", "title"}.`);
-  const known = new Set((item.lines ?? []).map((l) => l.id));
+  if (!Array.isArray(raw)) throw new Error(`lines for "${item2.id}" must be a list of {"id", "line", "title"}.`);
+  const known = new Set((item2.lines ?? []).map((l) => l.id));
   const out = /* @__PURE__ */ new Map();
   for (const l of raw) {
     const id = typeof l?.id === "string" ? l.id : "";
-    if (!known.has(id)) throw new Error(`Item "${item.id}" has no change line "${id}".${known.size ? ` Use the line ids from bridge_pending_drafts: ${[...known].join(", ")}.` : " It lists no lines: leave lines out."}`);
+    if (!known.has(id)) throw new Error(`Item "${item2.id}" has no change line "${id}".${known.size ? ` Use the line ids from bridge_pending_drafts: ${[...known].join(", ")}.` : " It lists no lines: leave lines out."}`);
     const line = sanitizeDraftLine(l.line);
     const title = sanitizeDraftTitle(l.title);
     if (line || title) out.set(id, { id, line, ...title ? { title } : {} });
@@ -3337,13 +3339,13 @@ function mergeDraftResults(p, results, at = /* @__PURE__ */ new Date()) {
   const next = new Map((p.results ?? []).map((r) => [r.id, r]));
   for (const r of results) {
     if (!ids.has(r.id)) throw new Error(`Session ${p.sessionId} has no item "${r.id}". Use the ids from bridge_pending_drafts: ${[...ids].join(", ")}.`);
-    const item = p.items.find((i) => i.id === r.id);
-    if (item.scope === "docs") {
-      next.set(r.id, { id: r.id, title: "", summary: "", ...sanitizeDocsResult(item, r), by: "claude", at: at.toISOString() });
+    const item2 = p.items.find((i) => i.id === r.id);
+    if (item2.scope === "docs") {
+      next.set(r.id, { id: r.id, title: "", summary: "", ...sanitizeDocsResult(item2, r), by: "claude", at: at.toISOString() });
       continue;
     }
     const clean = sanitizeDraftText(r);
-    const lines = sanitizeResultLines(item, r.lines);
+    const lines = sanitizeResultLines(item2, r.lines);
     if (!clean.title && !clean.summary && !lines.length) throw new Error(`The result for "${r.id}" has no title and no summary, and no line.`);
     next.set(r.id, { id: r.id, title: clean.title, summary: clean.summary, ...lines.length ? { lines } : {}, by: "claude", at: at.toISOString() });
   }
@@ -3731,6 +3733,10 @@ var EQUIVALENTS = [
   [/^Badge$/, ["Badge"]],
   [/^(Chip|Tag|ChipField)$/, ["Tag", "Badge"]],
   [/^(Alert|AlertTitle|Callout)$/, ["Alert"]],
+  [/^(Banner|AnnouncementBar|TopBanner)$/, ["Banner", "Alert"]],
+  [/^(CodeBlock|Code|CodeSnippet|Snippet|Prism|SyntaxHighlighter|CopyBlock)$/, ["CodeBlock"]],
+  [/^(RadioCard|RadioCards|RadioTile|ChoiceCard|ChoiceCardGroup)$/, ["ChoiceCard", "RadioGroup"]],
+  [/^(Checklist|ChecklistItem|StepList)$/, ["Checklist"]],
   [/^(Snackbar|Toast|Toaster|Notification)$/, ["Toast"]],
   [/^(CircularProgress|Spinner|Loading|LoadingIndicator)$/, ["Spinner", "Progress"]],
   [/^(LinearProgress|Progress)$/, ["Progress"]],
@@ -4277,6 +4283,26 @@ var THEME_FNS = /^(createTheme|extendTheme|createMuiTheme|responsiveFontSizes|ex
 var CSS_TAGS = /^(styled(\.\w+|\(.*\)(\.attrs\(.*\))?)|css|keyframes|createGlobalStyle|injectGlobal|tw\.\w+)$/s;
 var MUI_SPACING_ATTR = /^([mp][trblxy]?|(margin|padding)(Top|Bottom|Left|Right|X|Y)?|gap|rowGap|columnGap|spacing)$/;
 var THEME_REF_RE = /\btheme\.(palette|spacing|shape|typography|shadows|zIndex|transitions|vars)\b/g;
+var DOM_RENDERER_RE = /^([a-z][A-Za-z0-9]*?)(Html|HTML|HtmlAttributes|Attributes|ClassName)$/;
+function domRendererComponent(fn, components) {
+  const m = DOM_RENDERER_RE.exec(fn);
+  if (!m) return void 0;
+  const pascal2 = m[1][0].toUpperCase() + m[1].slice(1);
+  if (components.has(pascal2)) return pascal2;
+  return [...components].filter((c) => pascal2.startsWith(c)).sort((a, b) => b.length - a.length)[0];
+}
+var LOOKALIKE_CLASSES = { pill: "Badge", badge: "Badge", chip: "Tag", tooltip: "Tooltip", tip: "Tooltip", "has-tip": "Tooltip" };
+var LOOKALIKE_ATTRS = { "data-tip": "Tooltip" };
+var HTML_CLASS_RE = /\bclass(?:Name)?\s*=\s*["']([^"'$]*)/g;
+var HTML_ATTR_RE = /\s(data-tip)\s*=/g;
+function lookalikesInClassList(list, components) {
+  const out = [];
+  for (const token of list.split(/\s+/)) {
+    const component = LOOKALIKE_CLASSES[token];
+    if (component && components.has(component) && !out.some((o) => o.component === component)) out.push({ token, component });
+  }
+  return out;
+}
 function kindFor(path) {
   return path.endsWith(".tsx") ? ts.ScriptKind.TSX : path.endsWith(".jsx") ? ts.ScriptKind.JSX : path.endsWith(".ts") || path.endsWith(".mts") || path.endsWith(".cts") ? ts.ScriptKind.TS : ts.ScriptKind.JSX;
 }
@@ -4296,6 +4322,78 @@ function contextForDeclaration(name, typeText) {
   if (/^(styles?|sx|classes)$|Styles?$|Sx$/.test(name)) return /sx$/i.test(name) ? "sx" : "styled";
   return null;
 }
+function importsOf(path, text) {
+  const sf = ts.createSourceFile(path, text, ts.ScriptTarget.Latest, false, kindFor(path));
+  const imports = /* @__PURE__ */ new Map();
+  for (const node of sf.statements) {
+    if (!ts.isImportDeclaration(node) || !ts.isStringLiteral(node.moduleSpecifier)) continue;
+    const mod = node.moduleSpecifier.text;
+    const c = node.importClause;
+    if (c?.name) imports.set(c.name.text, { module: mod, imported: "default" });
+    if (c?.namedBindings && ts.isNamespaceImport(c.namedBindings)) imports.set(c.namedBindings.name.text, { module: mod, imported: "*" });
+    if (c?.namedBindings && ts.isNamedImports(c.namedBindings)) for (const el of c.namedBindings.elements) imports.set(el.name.text, { module: mod, imported: (el.propertyName ?? el.name).text });
+  }
+  return imports;
+}
+function classifyTag(t, imports, ds) {
+  const { name } = t;
+  const at = { line: t.line, column: t.column };
+  if (/^[a-z][\w-]*$/.test(name)) {
+    if (!ds.nativeElements.includes(name)) return {};
+    if (name === "input" && t.type === "hidden") return {};
+    if (name === "a" && !t.hasHref) return {};
+    if (t.inRenderProp) return {};
+    const suggestion = nativeEquivalent(name, t.type, ds.components);
+    return { component: { ...at, name, kind: "native", library: "native", ...suggestion ? { suggestion } : {} } };
+  }
+  const root = name.split(".")[0];
+  const imp = imports.get(root);
+  const ns = imp?.imported === "*";
+  const shown = imp && !ns && imp.imported !== "default" ? [imp.imported, ...name.split(".").slice(1)].join(".") : name;
+  const leaf = ns && name.includes(".") ? name.split(".").slice(1).join(".") : shown;
+  if (imp) {
+    const kind = classifyModule(imp.module, ds.packages, ds.foreignLibraries);
+    if (isNonVisual(leaf.split(".").pop())) return {};
+    if (kind === "ds") return { ds: leaf };
+    if (kind === "charts") return { component: { ...at, name: shown, kind: "foreign", library: libraryLabel(imp.module, kind) } };
+    if (kind === "other" && isRouterLink(imp.module, imp.imported === "default" ? "default" : leaf)) {
+      if (t.inRenderProp) return {};
+      const suggestion = ds.components.has("Link") ? "Link" : void 0;
+      return { component: { ...at, name: shown, kind: "foreign", library: libraryLabel(imp.module, kind), ...suggestion ? { suggestion } : {} } };
+    }
+    if (kind === "foreign" || kind === "shadcn") {
+      const suggestion = (ns ? dsEquivalent(root, ds.components) : void 0) ?? dsEquivalent(leaf, ds.components);
+      return { component: { ...at, name: shown, kind: "foreign", library: libraryLabel(imp.module, kind), ...suggestion ? { suggestion } : {} } };
+    }
+    if (kind === "local" && ds.components.has(leaf.split(".")[0])) return { component: { ...at, name: leaf, kind: "recreated", library: "local", suggestion: leaf.split(".")[0] } };
+    return {};
+  }
+  if (ds.components.has(root)) return { localCandidate: { ...at, name, kind: "recreated", library: "local", suggestion: root } };
+  return {};
+}
+function tailwindFindings(hits, offset, pos, ds) {
+  const findings = [];
+  let themeRefs = 0;
+  for (const h of hits) {
+    if (h.kind === "scale") {
+      themeRefs++;
+      continue;
+    }
+    if (h.kind === "token") continue;
+    let cat = h.category;
+    const v = h.value;
+    const isColor = Boolean(parseCssColor(v));
+    if (cat === "color-or-size") cat = isColor ? "color" : "font-size";
+    else if (cat === "color-or-width") cat = isColor ? "color" : "border-width";
+    else if (cat === "color-or-shadow") cat = isColor ? "color" : "shadow";
+    else if (cat === "font") cat = /^\d{3}$/.test(v) ? "font-weight" : "font-family";
+    if (cat === "color" && !isColor) continue;
+    const suggestion = ds.suggest(cat, v);
+    const cap = h.kind === "palette" && suggestion && suggestion.confidence > 0.6 ? { ...suggestion, confidence: 0.6, level: "medium" } : suggestion;
+    findings.push({ ...pos(offset + h.index), category: cat, value: h.cls, source: "tailwind", ...cap ? { suggestion: cap } : {} });
+  }
+  return { findings, themeRefs };
+}
 function scanCode(path, text, ds) {
   const sf = ts.createSourceFile(path, text, ts.ScriptTarget.Latest, true, kindFor(path));
   const out = { findings: [], tokenUsages: 0, themeRefs: 0, ds: {}, components: [], definitions: [] };
@@ -4310,24 +4408,9 @@ function scanCode(path, text, ds) {
     out.findings.push({ ...pos(offset), category: h.category, ...property ? { property } : {}, value: h.text, source, ...suggestion ? { suggestion } : {} });
   };
   const addTailwind = (hits, offset) => {
-    for (const h of hits) {
-      if (h.kind === "scale") {
-        out.themeRefs++;
-        continue;
-      }
-      if (h.kind === "token") continue;
-      let cat = h.category;
-      const v = h.value;
-      const isColor = Boolean(parseCssColor(v));
-      if (cat === "color-or-size") cat = isColor ? "color" : "font-size";
-      else if (cat === "color-or-width") cat = isColor ? "color" : "border-width";
-      else if (cat === "color-or-shadow") cat = isColor ? "color" : "shadow";
-      else if (cat === "font") cat = /^\d{3}$/.test(v) ? "font-weight" : "font-family";
-      if (cat === "color" && !isColor) continue;
-      const suggestion = ds.suggest(cat, v);
-      const cap = h.kind === "palette" && suggestion && suggestion.confidence > 0.6 ? { ...suggestion, confidence: 0.6, level: "medium" } : suggestion;
-      out.findings.push({ ...pos(offset + h.index), category: cat, value: h.cls, source: "tailwind", ...cap ? { suggestion: cap } : {} });
-    }
+    const r = tailwindFindings(hits, offset, pos, ds);
+    out.themeRefs += r.themeRefs;
+    out.findings.push(...r.findings);
   };
   const styleValue = (key, node, ctx) => {
     const source = ctx === "sx" ? "sx" : ctx === "style" ? "style" : ctx === "theme" ? "theme" : "styled";
@@ -4388,13 +4471,18 @@ function scanCode(path, text, ds) {
     }
     for (const a of scan.applies) addTailwind(a.hits, start + a.start);
   };
+  const lookalike = (list, offset) => {
+    for (const l of lookalikesInClassList(list, ds.components)) out.components.push({ ...pos(offset), name: `.${l.token}`, kind: "recreated", library: "local", suggestion: l.component });
+  };
   const classLiteral = (node) => {
     if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node)) {
       handled.add(node);
+      lookalike(node.text, node.getStart(sf) + 1);
       addTailwind(scanClassString(node.text), node.getStart(sf) + 1);
     } else if (ts.isTemplateExpression(node)) {
       for (const p of [node.head, ...node.templateSpans.map((s) => s.literal)]) {
         handled.add(p);
+        lookalike(p.text, p.getStart(sf) + 1);
         addTailwind(scanClassString(p.text), p.getStart(sf) + 1);
       }
       node.templateSpans.forEach((s) => visit(s.expression, null, true));
@@ -4403,49 +4491,13 @@ function scanCode(path, text, ds) {
   const jsxName = (n) => n.getText(sf);
   const element = (node) => {
     const name = jsxName(node.tagName);
-    const at = pos(node.getStart(sf));
-    if (/^[a-z][\w-]*$/.test(name)) {
-      if (!ds.nativeElements.includes(name)) return;
-      const typeAttr = node.attributes.properties.find((p) => ts.isJsxAttribute(p) && p.name.getText(sf) === "type");
-      const type = typeAttr?.initializer && ts.isStringLiteral(typeAttr.initializer) ? typeAttr.initializer.text : void 0;
-      if (name === "input" && type === "hidden") return;
-      if (name === "a" && !node.attributes.properties.some((p) => ts.isJsxAttribute(p) && p.name.getText(sf) === "href")) return;
-      if (isRenderElement(node)) return;
-      const suggestion = nativeEquivalent(name, type, ds.components);
-      out.components.push({ ...at, name, kind: "native", library: "native", ...suggestion ? { suggestion } : {} });
-      return;
-    }
-    const root = name.split(".")[0];
-    const imp = imports.get(root);
-    const ns = imp?.imported === "*";
-    const shown = imp && !ns && imp.imported !== "default" ? [imp.imported, ...name.split(".").slice(1)].join(".") : name;
-    const leaf = ns && name.includes(".") ? name.split(".").slice(1).join(".") : shown;
-    if (imp) {
-      const kind = classifyModule(imp.module, ds.packages, ds.foreignLibraries);
-      if (isNonVisual(leaf.split(".").pop())) return;
-      if (kind === "ds") {
-        out.ds[leaf] = (out.ds[leaf] ?? 0) + 1;
-        return;
-      }
-      if (kind === "charts") {
-        out.components.push({ ...at, name: shown, kind: "foreign", library: libraryLabel(imp.module, kind) });
-        return;
-      }
-      if (kind === "other" && isRouterLink(imp.module, imp.imported === "default" ? "default" : leaf)) {
-        if (isRenderElement(node)) return;
-        const suggestion = ds.components.has("Link") ? "Link" : void 0;
-        out.components.push({ ...at, name: shown, kind: "foreign", library: libraryLabel(imp.module, kind), ...suggestion ? { suggestion } : {} });
-        return;
-      }
-      if (kind === "foreign" || kind === "shadcn") {
-        const suggestion = (ns ? dsEquivalent(root, ds.components) : void 0) ?? dsEquivalent(leaf, ds.components);
-        out.components.push({ ...at, name: shown, kind: "foreign", library: libraryLabel(imp.module, kind), ...suggestion ? { suggestion } : {} });
-        return;
-      }
-      if (kind === "local" && ds.components.has(leaf.split(".")[0])) out.components.push({ ...at, name: leaf, kind: "recreated", library: "local", suggestion: leaf.split(".")[0] });
-      return;
-    }
-    if (ds.components.has(root)) pendingLocal.push({ ...at, name, kind: "recreated", library: "local", suggestion: root });
+    const typeAttr = node.attributes.properties.find((p) => ts.isJsxAttribute(p) && p.name.getText(sf) === "type");
+    const type = typeAttr?.initializer && ts.isStringLiteral(typeAttr.initializer) ? typeAttr.initializer.text : void 0;
+    const hasHref = node.attributes.properties.some((p) => ts.isJsxAttribute(p) && p.name.getText(sf) === "href");
+    const r = classifyTag({ name, ...pos(node.getStart(sf)), ...type !== void 0 ? { type } : {}, hasHref, inRenderProp: isRenderElement(node) }, imports, ds);
+    if (r.ds) out.ds[r.ds] = (out.ds[r.ds] ?? 0) + 1;
+    if (r.component) out.components.push(r.component);
+    if (r.localCandidate) pendingLocal.push(r.localCandidate);
   };
   const pendingLocal = [];
   function visit(node, ctx, classCtx) {
@@ -4505,6 +4557,17 @@ function scanCode(path, text, ds) {
       cssTemplate(node.template);
       return;
     }
+    if (ts.isCallExpression(node) && ts.isIdentifier(node.expression)) {
+      const imp = imports.get(node.expression.text);
+      if (imp && imp.imported !== "*" && classifyModule(imp.module, ds.packages, ds.foreignLibraries) === "ds") {
+        const comp = domRendererComponent(imp.imported === "default" ? node.expression.text : imp.imported, ds.components);
+        if (comp) out.ds[comp] = (out.ds[comp] ?? 0) + 1;
+      }
+    }
+    if (ts.isBinaryExpression(node) && node.operatorToken.kind === ts.SyntaxKind.EqualsToken && ts.isPropertyAccessExpression(node.left) && node.left.name.text === "className") {
+      visit(node.left, ctx, classCtx);
+      return classLiteral(node.right);
+    }
     if (ts.isCallExpression(node)) {
       const callee = node.expression.getText(sf);
       if (CLASS_FNS.test(callee)) {
@@ -4549,6 +4612,14 @@ function scanCode(path, text, ds) {
   const literal = (node) => {
     if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node) || ts.isTemplateHead(node) || ts.isTemplateMiddle(node) || ts.isTemplateTail(node)) {
       const t = node.text;
+      if (!handled.has(node) && (t.includes("<") || ts.isTemplateMiddle(node) || ts.isTemplateTail(node))) {
+        const base = node.getStart(sf) + 1;
+        for (const m of t.matchAll(HTML_CLASS_RE)) for (const l of lookalikesInClassList(m[1], ds.components)) out.components.push({ ...pos(base + m.index), name: `.${l.token}`, kind: "recreated", library: "local", suggestion: l.component });
+        for (const m of t.matchAll(HTML_ATTR_RE)) {
+          const component = LOOKALIKE_ATTRS[m[1]];
+          if (component && ds.components.has(component)) out.components.push({ ...pos(base + m.index + 1), name: `[${m[1]}]`, kind: "recreated", library: "local", suggestion: component });
+        }
+      }
       for (const m of t.matchAll(/var\(\s*(--[\w-]+)/g)) {
         if (ds.isDsVar(m[1])) out.tokenUsages++;
         else out.themeRefs++;
@@ -4568,29 +4639,85 @@ function scanCode(path, text, ds) {
   return out;
 }
 
-// ../core/src/audit/types.ts
-var AUDIT_SCHEMA_VERSION = 1;
-var FINDING_CATEGORIES = ["color", "spacing", "size", "radius", "border-width", "shadow", "duration", "easing", "z-index", "font-family", "font-size", "font-weight", "line-height"];
-
-// ../core/src/audit/report.ts
-var AUDIT_EXTENSIONS = [".css", ".scss", ".sass", ".less", ".tsx", ".jsx", ".ts", ".js", ".mjs", ".cjs", ".mts", ".cts"];
-var AUDIT_IGNORE_DIRS = ["node_modules", "dist", "build", "out", "coverage", ".git", ".next", ".nuxt", ".astro", ".turbo", ".cache", ".vercel", "storybook-static", "vendor", "public"];
-var IGNORE_FILE = /\.d\.[cm]?ts$|\.(test|spec|stories|story)\.[cm]?[jt]sx?$|\.min\.(css|js)$|(^|\/)(vite|vitest|jest|webpack|rollup|eslint|postcss|tailwind|babel|next|astro|prettier|stylelint|tsup)\.config\.[cm]?[jt]s$/;
-function isAuditable(path) {
-  if (!AUDIT_EXTENSIONS.some((e) => path.endsWith(e))) return false;
-  if (IGNORE_FILE.test(path)) return false;
-  return !path.split("/").some((seg) => AUDIT_IGNORE_DIRS.includes(seg));
+// ../core/src/audit/ignore.ts
+var IGNORE_DIRECTIVE = "bridge-audit-ignore-next-line";
+function ignoreDirectives(text) {
+  const at = lineCol(text);
+  const out = [];
+  for (const m of text.matchAll(new RegExp(`${IGNORE_DIRECTIVE}\\b`, "g"))) {
+    const start = m.index;
+    const opener = /(<!--|\/\*|\/\/)(\s*)$/.exec(text.slice(Math.max(0, start - 200), start));
+    const open = opener?.[1];
+    if (!open || open === "//" && opener[2].includes("\n")) continue;
+    const from = start + m[0].length;
+    let end;
+    if (open === "//") {
+      end = text.indexOf("\n", from);
+      if (end < 0) end = text.length;
+    } else {
+      end = text.indexOf(open === "<!--" ? "-->" : "*/", from);
+      if (end < 0) continue;
+    }
+    const reason = text.slice(from, end).replace(/^\s*:?/, "").replace(/\s+/g, " ").trim();
+    out.push({ line: at(start).line, target: at(end).line + 1, reason });
+  }
+  return out;
 }
-var langOf = (path) => {
-  const ext = path.slice(path.lastIndexOf(".") + 1);
-  if (ext === "css") return "css";
-  if (ext === "scss" || ext === "sass") return "scss";
-  if (ext === "less") return "less";
-  if (ext === "tsx") return "tsx";
-  if (ext === "jsx") return "jsx";
-  if (/^[cm]?ts$/.test(ext)) return "ts";
-  return "js";
-};
+var item = (x, reason, via) => "category" in x ? { line: x.line, column: x.column, kind: "value", what: x.value, reason, via } : { line: x.line, column: x.column, kind: "component", what: x.name, reason, via };
+function applyIgnoreComments(text, findings, components) {
+  const errors = [];
+  const reasons = /* @__PURE__ */ new Map();
+  for (const d of ignoreDirectives(text)) {
+    if (!d.reason) {
+      errors.push({ line: d.line, message: `${IGNORE_DIRECTIVE} needs a reason after a colon (${IGNORE_DIRECTIVE}: why this one stays); nothing was ignored` });
+      continue;
+    }
+    if (!findings.some((f) => f.line === d.target) && !components.some((c) => c.line === d.target)) {
+      errors.push({ line: d.line, message: `${IGNORE_DIRECTIVE} ignores nothing: line ${d.target} has no finding; remove the comment` });
+      continue;
+    }
+    reasons.set(d.target, d.reason);
+  }
+  const ignored = [];
+  const keep = (xs) => xs.filter((x) => {
+    const r = reasons.get(x.line);
+    if (r === void 0) return true;
+    ignored.push(item(x, r, "comment"));
+    return false;
+  });
+  return { findings: keep(findings), components: keep(components), ignored, errors };
+}
+function applyAllowlist(entries, findings, components) {
+  const used = /* @__PURE__ */ new Set();
+  const ignored = [];
+  const keep = (xs) => xs.filter((x) => {
+    const what = "category" in x ? x.value : x.name;
+    const fits = (e) => e.line === x.line && (e.what === void 0 || e.what === what);
+    let i = entries.findIndex((e, k) => fits(e) && !used.has(k));
+    if (i < 0) i = entries.findIndex(fits);
+    if (i < 0) return true;
+    used.add(i);
+    ignored.push(item(x, entries[i].reason, "allowlist"));
+    return false;
+  });
+  return { findings: keep(findings), components: keep(components), ignored, used };
+}
+function parseAllowlist(json) {
+  const fail2 = (msg) => {
+    throw new Error(`allowlist: ${msg}`);
+  };
+  if (!json || typeof json !== "object" || !Array.isArray(json.entries)) fail2('expected { "entries": [...] }');
+  return json.entries.map((e, i) => {
+    const x = e;
+    if (typeof x.file !== "string" || !x.file) fail2(`entry ${i} needs "file"`);
+    if (typeof x.line !== "number" || !Number.isInteger(x.line) || x.line < 1) fail2(`entry ${i} (${x.file}) needs a "line" number`);
+    if (typeof x.reason !== "string" || !x.reason.trim()) fail2(`entry ${i} (${x.file}:${x.line}) needs a "reason"`);
+    if (x.what !== void 0 && typeof x.what !== "string") fail2(`entry ${i} (${x.file}:${x.line}): "what" must be a string`);
+    return { file: x.file, line: x.line, ...x.what !== void 0 ? { what: x.what } : {}, reason: x.reason.trim() };
+  });
+}
+
+// ../core/src/audit/style.ts
 function isSafeFix(h, s) {
   if (!s || s.level !== "exact") return false;
   switch (h.category) {
@@ -4615,49 +4742,346 @@ function isSafeFix(h, s) {
       return false;
   }
 }
-function auditFile(path, text, ds) {
-  const lang = langOf(path);
-  if (lang === "css" || lang === "scss" || lang === "less") {
-    const at = lineCol(text);
-    const scan = scanCssText(text, lang);
-    const findings = [];
-    let tokenUsages = 0;
-    let themeRefs = 0;
-    for (const d of scan.decls) {
-      for (const v of d.scan.vars) ds.isDsVar(v) ? tokenUsages++ : themeRefs++;
-      if (d.scan.themeRef) themeRefs++;
-      else if (lang !== "css" && !d.property.startsWith("$")) themeRefs += (d.value.match(/\$[\w-]+/g) ?? []).length;
-      const property = d.property.toLowerCase();
-      for (const h of d.scan.hits) {
-        const suggestion = ds.suggest(h.category, h.text, property);
-        const p = at(d.valueStart + h.index);
-        findings.push({ ...p, category: h.category, property, value: h.text, source: "css", ...suggestion ? { suggestion } : {}, ...isSafeFix(h, suggestion) ? { autofix: true } : {} });
+function auditCssText(text, lang, ds, opts) {
+  const base = opts.offset ?? 0;
+  const source = opts.source ?? "css";
+  const at = (o) => opts.pos(base + o);
+  const scan = scanCssText(text, lang);
+  const findings = [];
+  let tokenUsages = 0;
+  let themeRefs = 0;
+  for (const d of scan.decls) {
+    for (const v of d.scan.vars) ds.isDsVar(v) ? tokenUsages++ : themeRefs++;
+    if (d.scan.themeRef) themeRefs++;
+    else if (lang !== "css" && !d.property.startsWith("$")) themeRefs += (d.value.match(/\$[\w-]+/g) ?? []).length;
+    const property = d.property.toLowerCase();
+    for (const h of d.scan.hits) {
+      const suggestion = ds.suggest(h.category, h.text, property);
+      const autofix = source === "css" && isSafeFix(h, suggestion);
+      findings.push({ ...at(d.valueStart + h.index), category: h.category, property, value: h.text, source, ...suggestion ? { suggestion } : {}, ...autofix ? { autofix: true } : {} });
+    }
+  }
+  for (const a of scan.applies) {
+    for (const h of a.hits) {
+      if (h.kind === "scale") themeRefs++;
+      else if (h.kind !== "token" && h.value) {
+        const cat = parseCssColor(h.value) ? "color" : h.category === "color-or-size" ? "font-size" : h.category === "color-or-width" ? "border-width" : h.category === "color-or-shadow" ? "shadow" : h.category === "font" ? "font-family" : h.category;
+        const suggestion = ds.suggest(cat, h.value);
+        findings.push({ ...at(a.start + h.index), category: cat, value: h.cls, source: "tailwind", ...suggestion ? { suggestion } : {} });
+      } else if (h.kind === "token" && h.value) {
+        const v = /var\(\s*(--[\w-]+)/.exec(h.value)?.[1];
+        if (v && ds.isDsVar(v)) tokenUsages++;
+        else themeRefs++;
       }
     }
-    for (const a of scan.applies) {
-      for (const h of a.hits) {
-        if (h.kind === "scale") themeRefs++;
-        else if (h.kind !== "token" && h.value) {
-          const cat = parseCssColor(h.value) ? "color" : h.category === "color-or-size" ? "font-size" : h.category === "color-or-width" ? "border-width" : h.category === "color-or-shadow" ? "shadow" : h.category === "font" ? "font-family" : h.category;
-          const suggestion = ds.suggest(cat, h.value);
-          findings.push({ ...at(a.start + h.index), category: cat, value: h.cls, source: "tailwind", ...suggestion ? { suggestion } : {} });
-        } else if (h.kind === "token" && h.value) {
-          const v = /var\(\s*(--[\w-]+)/.exec(h.value)?.[1];
-          if (v && ds.isDsVar(v)) tokenUsages++;
-          else themeRefs++;
-        }
+  }
+  findings.sort((x, y) => x.line - y.line || x.column - y.column);
+  return { findings, tokenUsages, themeRefs };
+}
+
+// ../core/src/audit/markup.ts
+var MARKUP_EXTENSIONS = [".astro", ".vue", ".svelte"];
+function mask2(text, ranges, keepInside) {
+  const inside = new Uint8Array(text.length);
+  for (const r of ranges) inside.fill(1, r.start, r.end);
+  let out = "";
+  for (let i = 0; i < text.length; i++) {
+    const c = text[i];
+    out += c === "\n" || Boolean(inside[i]) === keepInside ? c : " ";
+  }
+  return out;
+}
+var attrOf = (attrs, name) => new RegExp(`(?:^|\\s)${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s>]+))`, "i").exec(attrs)?.slice(1).find((v) => v !== void 0);
+var isCodeScript = (attrs) => {
+  const type = attrOf(attrs, "type")?.toLowerCase();
+  return !type || ["module", "text/javascript", "application/javascript", "text/typescript", "ts", "text/babel"].includes(type);
+};
+function markupBlocks(text, lang) {
+  const nonTemplate = [];
+  let frontmatter;
+  let from = 0;
+  if (lang === "astro") {
+    const open = /^\s*---[^\S\n]*\n/.exec(text);
+    if (open) {
+      const close = /\n---[^\S\n]*(\n|$)/g;
+      close.lastIndex = open[0].length - 1;
+      const m = close.exec(text);
+      if (m) {
+        frontmatter = { start: open[0].length, end: m.index + 1 };
+        from = m.index + m[0].length;
+        nonTemplate.push({ start: 0, end: from });
+      }
+    }
+  }
+  const scripts = [];
+  const styles = [];
+  const re = /<(script|style)\b((?:[^>"']|"[^"]*"|'[^']*')*)>([\s\S]*?)<\/\1\s*>/gi;
+  re.lastIndex = from;
+  for (let m; m = re.exec(text); ) {
+    const contentStart = m.index + m[0].indexOf(">", m[1].length + 1 + m[2].length) + 1;
+    const block = { start: contentStart, end: contentStart + m[3].length, attrs: m[2] };
+    (m[1].toLowerCase() === "script" ? scripts : styles).push(block);
+    nonTemplate.push({ start: m.index, end: m.index + m[0].length });
+  }
+  for (const m of text.slice(from).matchAll(/<!--[\s\S]*?-->/g)) nonTemplate.push({ start: from + m.index, end: from + m.index + m[0].length });
+  return { ...frontmatter ? { frontmatter } : {}, scripts, styles, nonTemplate };
+}
+function closeBrace(s, i) {
+  let depth = 0;
+  for (let k = i; k < s.length; k++) {
+    const c = s[k];
+    if (c === "{") depth++;
+    else if (c === "}") {
+      if (--depth === 0) return k + 1;
+    } else if (c === '"' || c === "'") {
+      const e = s.indexOf(c, k + 1);
+      if (e < 0) return s.length;
+      k = e;
+    } else if (c === "`") {
+      for (k++; k < s.length && s[k] !== "`"; k++) {
+        if (s[k] === "\\") k++;
+        else if (s[k] === "$" && s[k + 1] === "{") k = closeBrace(s, k + 1) - 1;
+      }
+    }
+  }
+  return s.length;
+}
+function readTag(s, i, lang) {
+  const attrs = [];
+  let k = i;
+  while (k < s.length) {
+    while (k < s.length && /\s/.test(s[k])) k++;
+    const c = s[k];
+    if (c === void 0) break;
+    if (c === ">") return { attrs, end: k + 1, selfClosing: false };
+    if (c === "/" && s[k + 1] === ">") return { attrs, end: k + 2, selfClosing: true };
+    if (c === "{") {
+      const e = closeBrace(s, k);
+      const inner = s.slice(k + 1, e - 1).trim();
+      attrs.push(inner.startsWith("...") ? { name: "", kind: "spread", value: inner, valueStart: k + 1 } : { name: inner, kind: "expr", value: inner, valueStart: k + 1 });
+      k = e;
+      continue;
+    }
+    const nm = /^[^\s=>/"'{]+/.exec(s.slice(k, k + 200));
+    if (!nm) {
+      k++;
+      continue;
+    }
+    const name = nm[0];
+    k += name.length;
+    let j = k;
+    while (j < s.length && /\s/.test(s[j])) j++;
+    if (s[j] !== "=") {
+      attrs.push({ name, kind: "bare", value: "", valueStart: k });
+      continue;
+    }
+    j++;
+    while (j < s.length && /\s/.test(s[j])) j++;
+    const q = s[j];
+    const bound = lang === "vue" && /^(:|v-bind:|v-on:|@|v-)/.test(name);
+    if (q === '"' || q === "'") {
+      const e = s.indexOf(q, j + 1);
+      const end = e < 0 ? s.length : e;
+      attrs.push({ name, kind: bound ? "expr" : "static", value: s.slice(j + 1, end), valueStart: j + 1 });
+      k = end + 1;
+    } else if (q === "{") {
+      const e = closeBrace(s, j);
+      attrs.push({ name, kind: "expr", value: s.slice(j + 1, e - 1), valueStart: j + 1 });
+      k = e;
+    } else {
+      const m = /^[^\s>]+/.exec(s.slice(j));
+      const v = m?.[0].replace(/\/$/, "") ?? "";
+      attrs.push({ name, kind: "static", value: v, valueStart: j });
+      k = j + v.length;
+    }
+  }
+  return { attrs, end: s.length, selfClosing: false };
+}
+var attrName = (n) => n.replace(/^(v-bind:|:|bind:)/, "");
+var pascal = (kebab) => kebab.replace(/(^|-)([a-z0-9])/g, (_m, _d, c) => c.toUpperCase());
+var NO_COLOR_ATTR_TAGS = /* @__PURE__ */ new Set(["meta", "link"]);
+function scanMarkup(path, text, lang, ds) {
+  const out = { findings: [], tokenUsages: 0, themeRefs: 0, ds: {}, components: [], definitions: [] };
+  const pos = lineCol(text);
+  const blocks = markupBlocks(text, lang);
+  const imports = /* @__PURE__ */ new Map();
+  const merge = (c) => {
+    out.findings.push(...c.findings);
+    out.tokenUsages += c.tokenUsages;
+    out.themeRefs += c.themeRefs;
+    for (const [n, k] of Object.entries(c.ds)) out.ds[n] = (out.ds[n] ?? 0) + k;
+    out.components.push(...c.components);
+    out.definitions.push(...c.definitions);
+  };
+  const codeRanges = [...blocks.frontmatter ? [{ ...blocks.frontmatter, attrs: "" }] : [], ...blocks.scripts.filter((b) => isCodeScript(b.attrs))];
+  for (const r of codeRanges) {
+    const jsx = /^(tsx|jsx)$/i.test(attrOf(r.attrs, "lang") ?? "");
+    const code2 = mask2(text, [r], true);
+    const file = `${path}.${jsx ? "tsx" : "ts"}`;
+    merge(scanCode(file, code2, ds));
+    for (const [k, v] of importsOf(file, code2)) imports.set(k, v);
+  }
+  for (const b of blocks.styles) {
+    const l = (attrOf(b.attrs, "lang") ?? "css").toLowerCase();
+    const r = auditCssText(text.slice(b.start, b.end), l === "scss" || l === "sass" ? "scss" : l === "less" ? "less" : "css", ds, { pos, offset: b.start });
+    out.findings.push(...r.findings);
+    out.tokenUsages += r.tokenUsages;
+    out.themeRefs += r.themeRefs;
+  }
+  const scanExpr = (prefix, expr, offset, suffix, keepLookalikes = false) => {
+    const { line, column } = pos(offset);
+    const src = line >= 2 ? `${"\n".repeat(line - 2)}${prefix}
+${" ".repeat(column - 1)}${expr}${suffix}` : `${prefix}${expr}${suffix}`;
+    const c = scanCode(`${path}.tsx`, src, ds);
+    merge({ ...c, components: keepLookalikes ? c.components.filter((x) => x.kind === "recreated" && x.name.startsWith(".")) : [], definitions: [], ds: {} });
+  };
+  const styleAttr = (a) => {
+    if (a.kind === "static") {
+      const css = lang === "svelte" ? a.value.replace(/\{[^}]*\}/g, (m) => " ".repeat(m.length)) : a.value;
+      const r = auditCssText(css, "css", ds, { pos, offset: a.valueStart, source: "style" });
+      out.findings.push(...r.findings);
+      out.tokenUsages += r.tokenUsages;
+      out.themeRefs += r.themeRefs;
+      return;
+    }
+    const str2 = /^(\s*)([`'"])([\s\S]*)\2\s*$/.exec(a.value);
+    if (str2) {
+      const body = str2[3].replace(/\$\{[^}]*\}/g, (m) => " ".repeat(m.length));
+      const r = auditCssText(body, "css", ds, { pos, offset: a.valueStart + str2[1].length + 1, source: "style" });
+      out.findings.push(...r.findings);
+      out.tokenUsages += r.tokenUsages;
+      out.themeRefs += r.themeRefs;
+      return;
+    }
+    scanExpr("const style: CSSProperties =", a.value, a.valueStart, ";");
+  };
+  const tpl = mask2(text, blocks.nonTemplate, false);
+  const pending = [];
+  let noscript = 0;
+  const TAG = /<(\/?)([A-Za-z][\w.:-]*)/g;
+  for (let m; m = TAG.exec(tpl); ) {
+    const raw = m[2];
+    if (m[1]) {
+      if (raw.toLowerCase() === "noscript") noscript = Math.max(0, noscript - 1);
+      continue;
+    }
+    const tag = readTag(tpl, m.index + m[0].length, lang);
+    TAG.lastIndex = tag.end;
+    const lower = raw.toLowerCase();
+    if (lower === "noscript" && !tag.selfClosing) {
+      noscript++;
+      continue;
+    }
+    const attrs = tag.attrs;
+    const get = (n) => attrs.find((a) => attrName(a.name) === n);
+    for (const a of attrs) {
+      const n = attrName(a.name);
+      if (n === "style") styleAttr(a);
+      else if (lang === "svelte" && a.name.startsWith("style:") && a.kind === "static") {
+        const prop = a.name.slice(6).split("|")[0];
+        const r2 = auditCssText(`${prop}:${a.value}`, "css", ds, { pos, offset: a.valueStart - prop.length - 1, source: "style" });
+        out.findings.push(...r2.findings);
+        out.tokenUsages += r2.tokenUsages;
+        out.themeRefs += r2.themeRefs;
+      } else if (/^(class|className|class:list)$/.test(n)) {
+        if (a.kind === "static") {
+          for (const l of lookalikesInClassList(a.value, ds.components)) out.components.push({ ...pos(a.valueStart), name: `.${l.token}`, kind: "recreated", library: "local", suggestion: l.component });
+          const r2 = tailwindFindings(scanClassString(a.value), a.valueStart, pos, ds);
+          out.findings.push(...r2.findings);
+          out.themeRefs += r2.themeRefs;
+        } else if (a.kind === "expr") scanExpr("cn(", a.value, a.valueStart, ")", true);
+      } else if (LOOKALIKE_ATTRS[n] && ds.components.has(LOOKALIKE_ATTRS[n])) {
+        out.components.push({ ...pos(a.valueStart - a.name.length - 1), name: `[${n}]`, kind: "recreated", library: "local", suggestion: LOOKALIKE_ATTRS[n] });
+      } else if (a.kind === "static" && !NO_COLOR_ATTR_TAGS.has(lower) && isColorLiteral(a.value)) {
+        const suggestion = ds.suggest("color", a.value.trim(), n);
+        out.findings.push({ ...pos(a.valueStart), category: "color", property: n, value: a.value.trim(), source: "jsx-attr", ...suggestion ? { suggestion } : {} });
       }
     }
-    findings.sort((x, y) => x.line - y.line || x.column - y.column);
-    return { path, lang, tokenUsages, themeRefs, hardcoded: findings.length, dsComponents: 0, otherComponents: 0, findings, components: [], definitions: [], dsByName: {} };
+    let name = raw;
+    if (raw.includes(":")) continue;
+    if (raw.includes("-")) {
+      if (!imports.has(pascal(raw))) continue;
+      name = pascal(raw);
+    }
+    const isNative = /^[a-z]/.test(name) && !name.includes(".");
+    if (isNative && noscript > 0) continue;
+    const type = get("type");
+    const r = classifyTag({ name, ...pos(m.index), ...type?.kind === "static" ? { type: type.value } : {}, hasHref: Boolean(get("href")) }, imports, ds);
+    if (r.ds) out.ds[r.ds] = (out.ds[r.ds] ?? 0) + 1;
+    if (r.component) out.components.push(r.component);
+    if (r.localCandidate) pending.push(r.localCandidate);
+  }
+  const base = /([^/]+)\.(astro|vue|svelte)$/.exec(path)?.[1];
+  if (base && /^[A-Z][A-Za-z0-9]*$/.test(base)) out.definitions.push({ name: base, line: 1 });
+  const defined = new Set(out.definitions.map((d) => d.name));
+  out.components.push(...pending.filter((f) => defined.has(f.suggestion)));
+  out.findings.sort((a, b) => a.line - b.line || a.column - b.column);
+  out.components.sort((a, b) => a.line - b.line || a.column - b.column);
+  return out;
+}
+
+// ../core/src/audit/types.ts
+var AUDIT_SCHEMA_VERSION = 1;
+var FINDING_CATEGORIES = ["color", "spacing", "size", "radius", "border-width", "shadow", "duration", "easing", "z-index", "font-family", "font-size", "font-weight", "line-height"];
+
+// ../core/src/audit/report.ts
+var AUDIT_EXTENSIONS = [".css", ".scss", ".sass", ".less", ".tsx", ".jsx", ".ts", ".js", ".mjs", ".cjs", ".mts", ".cts", ...MARKUP_EXTENSIONS];
+var AUDIT_IGNORE_DIRS = ["node_modules", "dist", "build", "out", "coverage", ".git", ".next", ".nuxt", ".astro", ".turbo", ".cache", ".vercel", "storybook-static", "vendor", "public"];
+var IGNORE_FILE = /\.d\.[cm]?ts$|\.(test|spec|stories|story)\.[cm]?[jt]sx?$|\.min\.(css|js)$|(^|\/)(vite|vitest|jest|webpack|rollup|eslint|postcss|tailwind|babel|next|astro|prettier|stylelint|tsup)\.config\.[cm]?[jt]s$/;
+function isAuditable(path) {
+  if (!AUDIT_EXTENSIONS.some((e) => path.endsWith(e))) return false;
+  if (IGNORE_FILE.test(path)) return false;
+  return !path.split("/").some((seg) => AUDIT_IGNORE_DIRS.includes(seg));
+}
+var langOf = (path) => {
+  const ext = path.slice(path.lastIndexOf(".") + 1);
+  if (ext === "css") return "css";
+  if (ext === "scss" || ext === "sass") return "scss";
+  if (ext === "less") return "less";
+  if (ext === "tsx") return "tsx";
+  if (ext === "jsx") return "jsx";
+  if (/^[cm]?ts$/.test(ext)) return "ts";
+  if (ext === "astro" || ext === "vue" || ext === "svelte") return ext;
+  return "js";
+};
+function auditFile(path, text, ds) {
+  const lang = langOf(path);
+  if (lang === "css" || lang === "scss" || lang === "less") {
+    const r = auditCssText(text, lang, ds, { pos: lineCol(text) });
+    return withIgnores(text, { path, lang, tokenUsages: r.tokenUsages, themeRefs: r.themeRefs, hardcoded: 0, dsComponents: 0, otherComponents: 0, findings: r.findings, components: [], definitions: [], dsByName: {} });
   }
-  const c = scanCode(path, text, ds);
+  const c = lang === "astro" || lang === "vue" || lang === "svelte" ? scanMarkup(path, text, lang, ds) : scanCode(path, text, ds);
   const dsCount = Object.values(c.ds).reduce((a, b) => a + b, 0);
-  return { path, lang, tokenUsages: c.tokenUsages, themeRefs: c.themeRefs, hardcoded: c.findings.length, dsComponents: dsCount, otherComponents: c.components.length, findings: c.findings, components: c.components, definitions: c.definitions, dsByName: c.ds };
+  return withIgnores(text, { path, lang, tokenUsages: c.tokenUsages, themeRefs: c.themeRefs, hardcoded: 0, dsComponents: dsCount, otherComponents: 0, findings: c.findings, components: c.components, definitions: c.definitions, dsByName: c.ds });
+}
+function withIgnores(text, f) {
+  const r = applyIgnoreComments(text, f.findings, f.components);
+  return {
+    ...f,
+    findings: r.findings,
+    components: r.components,
+    hardcoded: r.findings.length,
+    otherComponents: r.components.length,
+    ...r.ignored.length ? { ignored: r.ignored } : {},
+    ...r.errors.length ? { ignoreErrors: r.errors } : {}
+  };
 }
 var pct = (num2, den) => den > 0 ? Math.round(num2 / den * 1e3) / 10 : null;
 function buildAuditReport(input, ds) {
-  const reports = input.files.map((f) => auditFile(f.path, f.text, ds));
+  const allow = input.allowlist ?? [];
+  const usedAllow = /* @__PURE__ */ new Set();
+  const reports = input.files.map((f) => {
+    const r = auditFile(f.path, f.text, ds);
+    const idx = allow.flatMap((e, i) => e.file === f.path ? [i] : []);
+    if (!idx.length) return r;
+    const a = applyAllowlist(idx.map((i) => allow[i]), r.findings, r.components);
+    a.used.forEach((k) => usedAllow.add(idx[k]));
+    if (!a.ignored.length) return r;
+    const ignored = [...r.ignored ?? [], ...a.ignored].sort((x, y) => x.line - y.line || x.column - y.column);
+    return { ...r, findings: a.findings, components: a.components, hardcoded: a.findings.length, otherComponents: a.components.length, ignored };
+  });
+  const ignoredItems = reports.flatMap((r) => (r.ignored ?? []).map((x) => ({ file: r.path, ...x })));
+  const staleAllowlist = allow.filter((_e, i) => !usedAllow.has(i));
   const files = reports.map(({ definitions: _d, dsByName: _n, ...r }) => r);
   const byCategory = {};
   const fixes = /* @__PURE__ */ new Map();
@@ -4717,6 +5141,15 @@ function buildAuditReport(input, ds) {
     topFiles,
     topFixes,
     files: files.sort((a, b) => a.path.localeCompare(b.path)),
+    ...ignoredItems.length || staleAllowlist.length ? {
+      ignored: {
+        total: ignoredItems.length,
+        comment: ignoredItems.filter((x) => x.via === "comment").length,
+        allowlist: ignoredItems.filter((x) => x.via === "allowlist").length,
+        items: ignoredItems,
+        staleAllowlist
+      }
+    } : {},
     history: []
   };
 }
@@ -5030,6 +5463,9 @@ function collectAuditFiles(target, exclude = []) {
   }
   return { root: abs, files, skipped };
 }
+function loadAllowlist(path) {
+  return parseAllowlist(JSON.parse(readFileSync(path, "utf8")));
+}
 
 // src/config.ts
 var SCHEMA_URL = "https://raw.githubusercontent.com/peterbono/ai-design-system-demo/main/packages/core/bridge.config.schema.json";
@@ -5287,7 +5723,8 @@ function client(repo, o, rules) {
     ...o.apiUrl ? { apiUrl: o.apiUrl } : {},
     ...o.rawUrl ? { rawUrl: o.rawUrl } : {},
     protectedBranches: rules.protectedBranches,
-    branchPrefix: rules.branchPrefix
+    branchPrefix: rules.branchPrefix,
+    tokenHint: "set GITHUB_TOKEN (or BRIDGE_GITHUB_TOKEN) in the environment of the Bridge MCP server, read access to this repository is enough"
   });
 }
 var BridgeContext = class _BridgeContext {
@@ -6656,7 +7093,8 @@ async function auditOp(ctx, a) {
   if (!existsSync2(target)) throw new Error(`No such file or folder: ${target}`);
   const ds = await designSystemIndex(ctx);
   const { files, skipped } = collectAuditFiles(target, config.audit?.exclude ?? []);
-  let report = buildAuditReport({ files, skipped, target: a.path, ...a.label ? { label: a.label } : {} }, ds);
+  const allowlist = a.allowlist ? loadAllowlist(isAbsolute(a.allowlist) ? a.allowlist : resolve3(ctx.root, a.allowlist)) : void 0;
+  let report = buildAuditReport({ files, skipped, target: a.path, ...a.label ? { label: a.label } : {}, ...allowlist ? { allowlist } : {} }, ds);
   if (a.baseline) report = compareWithBaseline(report, JSON.parse(readFileSync2(isAbsolute(a.baseline) ? a.baseline : resolve3(ctx.root, a.baseline), "utf8")));
   const limit = a.limit ?? 10;
   const single = files.length === 1;
@@ -6673,6 +7111,8 @@ async function auditOp(ctx, a) {
       native: report.components.native,
       recreated: report.components.recreated
     },
+    ...report.ignored ? { ignored: { total: report.ignored.total, comment: report.ignored.comment, allowlist: report.ignored.allowlist, items: report.ignored.items.slice(0, limit * 5), staleAllowlist: report.ignored.staleAllowlist } } : {},
+    ...report.files.some((f) => f.ignoreErrors?.length) ? { ignoreErrors: report.files.flatMap((f) => (f.ignoreErrors ?? []).map((e) => ({ file: f.path, ...e }))) } : {},
     topFiles: report.topFiles.slice(0, limit),
     topFixes: report.topFixes.slice(0, limit).map((f) => ({ value: f.value, category: f.category, count: f.count, ...f.suggestion ? { use: `var(${f.suggestion.cssVar})`, token: f.suggestion.token, tokenValue: f.suggestion.value, ...f.suggestion.mode ? { mode: f.suggestion.mode } : {}, confidence: f.suggestion.level } : { use: null } })),
     ...withFindings ? {
@@ -6807,19 +7247,19 @@ async function buildPlan(ctx, a, tool) {
       file = v[v.length - 1].file;
     }
     let value = r.value;
-    let item;
+    let item2;
     if (value === void 0) {
       if (!r.entry) throw new Error("restore needs value, or entry (the history entry whose value to put back).");
       const e = findEntry(report.entries, r.entry);
       const items = tokenHistory([e], path, config).filter((i) => !file || i.file === file);
       if (!items.length) throw new Error(`${e.id} did not change ${path}${file ? ` in ${file}` : ""}. bridge_get_token_history lists the changes of a token.`);
       if (items.length > 1 && !file) throw new Error(`${e.id} changed ${path} in ${items.map((i) => i.file).join(", ")}. Pass mode (for example {"theme":"dark"}) or file.`);
-      item = items[0];
-      file ??= item.file;
-      value = r.side === "before" ? item.before : item.after;
-      if (value === void 0) throw new Error(`${path} has no ${r.side ?? "after"} value in ${e.id} (it was ${item.kind}).`);
+      item2 = items[0];
+      file ??= item2.file;
+      value = r.side === "before" ? item2.before : item2.after;
+      if (value === void 0) throw new Error(`${path} has no ${r.side ?? "after"} value in ${e.id} (it was ${item2.kind}).`);
     }
-    return planRestore({ current, path, ...file ? { file } : {}, value, ...item ? { item, label: item.pr ? `#${item.pr.number}` : item.entryId } : {}, pairs, tool });
+    return planRestore({ current, path, ...file ? { file } : {}, value, ...item2 ? { item: item2, label: item2.pr ? `#${item2.pr.number}` : item2.entryId } : {}, pairs, tool });
   }
   const entry = findEntry(report.entries, a.target);
   const later = report.entries.filter((e) => e.id !== entry.id && Date.parse(e.date) >= Date.parse(entry.date));
@@ -7176,11 +7616,11 @@ async function pendingDrafts(ctx, a) {
   const images = [];
   if (a.images !== false) {
     for (const s of sessions) {
-      for (const item of s.items) {
-        for (const img of item.images ?? []) {
+      for (const item2 of s.items) {
+        for (const img of item2.images ?? []) {
           if (images.length >= IMAGES_PER_CALL || !img.path) continue;
           const f = await gh.getFileBase64(img.path, REQUESTS_BRANCH).catch(() => void 0);
-          if (f && f.size <= IMAGE_INLINE_MAX) images.push({ sessionId: s.sessionId, itemId: item.id, label: img.label, ...img.line ? { line: img.line } : {}, base64: f.base64 });
+          if (f && f.size <= IMAGE_INLINE_MAX) images.push({ sessionId: s.sessionId, itemId: item2.id, label: img.label, ...img.line ? { line: img.line } : {}, base64: f.base64 });
         }
       }
     }
@@ -7212,7 +7652,7 @@ async function writeDrafts(ctx, a) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.3.1" : "dev";
+var VERSION = true ? "0.3.2" : "dev";
 var ok = (data) => ({ content: [{ type: "text", text: typeof data === "string" ? data : JSON.stringify(data, null, 2) }] });
 var fail = (e) => ({ content: [{ type: "text", text: `Error: ${e.message ?? String(e)}` }], isError: true });
 var run = (fn) => async (a) => {
@@ -7570,13 +8010,14 @@ function createServer(ctx) {
     "bridge_audit",
     {
       title: "Audit design system adoption",
-      description: "Measure how a product codebase uses this design system (local only). Scans CSS, SCSS, style/sx/styled objects, CSS-in-JS and Tailwind classes for hardcoded colors, spacing, radii, shadows, durations, z-index and fonts, each with the closest token (colors by deltaE across every mode) and a confidence; and JSX for DS components versus foreign UI libraries (MUI, react-admin, Radix, shadcn/ui...), native elements and re-created DS components. Returns token and component adoption, counts by category, top files and top fixes; for a single file (or findings: true) the findings with line numbers.",
+      description: "Measure how a product codebase uses this design system (local only). Reads CSS, SCSS, Less, TS/JS, TSX/JSX, and Astro, Vue and Svelte files (template markup, frontmatter and <script> blocks, <style> blocks). Finds hardcoded colors, spacing, radii, shadows, durations, z-index and fonts in style sheets, style attributes, style/sx/styled objects, CSS-in-JS and Tailwind classes, each with the closest token (colors by deltaE across every mode) and a confidence; and in JSX and template markup, DS components versus foreign UI libraries (MUI, react-admin, Radix, shadcn/ui...), native elements a DS component should render, and re-created DS components. Hidden inputs and elements inside <noscript> do not count. A `bridge-audit-ignore-next-line: reason` comment on the line above leaves one exception out; an allowlist file lists known file:line exceptions; both need a reason and stay listed under `ignored`. Returns token and component adoption, counts by category, top files and top fixes; for a single file (or findings: true) the findings with line numbers.",
       inputSchema: {
         path: z.string().min(1).describe("Product folder or file, absolute or relative to the design system repo root."),
         baseline: z.string().optional().describe("Earlier report from `bridge audit --json` to compare with (progress per metric and file)."),
         label: z.string().optional(),
         limit: z.number().int().min(1).max(50).optional().describe("Top files and fixes to return. Default 10."),
-        findings: z.boolean().optional().describe("Include per-file findings with line numbers. Default: only when auditing one file.")
+        findings: z.boolean().optional().describe("Include per-file findings with line numbers. Default: only when auditing one file."),
+        allowlist: z.string().optional().describe('Allowlist file of known exceptions: { "entries": [{ "file", "line", "what"?, "reason" }] }, paths relative to the audited folder.')
       },
       annotations: RO
     },

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   VERSION,
   optionsFromArgv,
   serveStdio
-} from "./chunk-I3TL76GK.js";
+} from "./chunk-MTQCDV65.js";
 import "./chunk-X455XY4E.js";
 
 // src/index.ts

package/dist/lib.js

@@ -23,7 +23,7 @@ import {
   parseDocsReply,
   requests_exports,
   serveStdio
-} from "./chunk-I3TL76GK.js";
+} from "./chunk-MTQCDV65.js";
 import {
   CONFIG_FILE,
   loadConfig,

package/dist/ops.d.ts

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

package/package.json

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