@jpeakai/mermaidjs-lint 0.4.2 → 0.5.0

package/README.md

@@ -28,7 +28,7 @@ Installed as a dev dependency, the command is `mermaidjs-lint`, and `--help` lis
 
 Three tenets are guarantees about every diagram the tool passes, and the fourth is a commitment about the tool.
 
-- **Readable in light and dark.** Declared fills, label colours and borders are scored as the host draws them, on nodes, erDiagram rows and edge labels, in both themes.
+- **Readable in light and dark.** Declared fills, label colours and borders are scored as the host draws them, on nodes, erDiagram rows, edge labels and sequence diagrams, in both themes.
 - **Renders.** Every diagram parses with the mermaid parsers this package ships, and every mermaid fence is closed.
 - **Simple enough to follow.** Node count and visual complexity are scored against a density preset, so an oversized diagram is flagged to be split.
 - **Extensible.** A plugin adds rules of your own, which run through the same config, fix engine and verification as the built-ins.
@@ -54,7 +54,7 @@ It does not compare edge endpoints, edge labels or node text, so review the diff
 ## Requirements and compatibility
 
 - **Runtime:** Bun, or Node `>=20` as the `engines` field of `package.json` states.
-- **Mermaid:** the parse rules use the `mermaid` package, at `^11.14.0`, and `@mermaid-js/parser`, both installed with this package.
+- **Mermaid:** the parse and contrast rules use the `mermaid` package at exactly `11.17.2`, and `@mermaid-js/parser`, both installed with this package. The pin holds sequence diagram colours, which change between mermaid releases.
 - **Your host's mermaid may differ.** GitHub and other hosts draw diagrams with their own mermaid version. A diagram type newer than the host's may parse here and still fail to draw there.
 
 `npm ls mermaid` in your project prints the mermaid version a run uses.

package/dist/bin.js

@@ -9,7 +9,7 @@ import { parseArgs } from "node:util";
 // package.json
 var package_default = {
   name: "@jpeakai/mermaidjs-lint",
-  version: "0.4.2",
+  version: "0.5.0",
   type: "module",
   description: "Deterministic lint gates and verified fixers for Mermaid diagrams in markdown",
   license: "MIT",
@@ -67,7 +67,7 @@ var package_default = {
     "mdast-util-from-markdown": "^2.0.3",
     "mdast-util-frontmatter": "^2.0.1",
     "mdast-util-gfm": "^3.1.0",
-    mermaid: "^11.14.0",
+    mermaid: "11.17.2",
     "micromark-extension-frontmatter": "^2.0.0",
     "micromark-extension-gfm": "^3.0.0"
   },
@@ -395,6 +395,7 @@ var getMermaid = async () => {
   mermaidCore = (await import("mermaid")).default;
   return mermaidCore;
 };
+var getMermaidCore = async () => await getMermaid();
 var LANGIUM_TYPES = {
   "architecture-beta": "architecture",
   architecture: "architecture",
@@ -1250,6 +1251,139 @@ var scoreForProfile = (directives, profile, keyword) => {
     return scoreMkdocs(directives);
   return keyword === "erDiagram" ? scoreEr(directives) : scoreGithub(directives);
 };
+var SEQUENCE_THEMES = ["base", "default", "dark", "forest", "neutral"];
+var LINE = { NOTE: 2, ACTIVE_START: 17, RECT_START: 22, AUTONUMBER: 26 };
+var FRAME_STARTS = new Set([10, 12, 15, 19, 27, 30, 32]);
+var sequenceFeatures = (db) => {
+  const messages = db.getMessages();
+  const has = (type) => messages.some((m) => m.type === type);
+  return {
+    humanActor: [...db.getActors().values()].some((a) => a.type === "actor"),
+    note: has(LINE.NOTE),
+    frame: messages.some((m) => FRAME_STARTS.has(m.type)),
+    activation: has(LINE.ACTIVE_START),
+    numbered: messages.some((m) => m.type === LINE.AUTONUMBER && m.message?.visible !== false),
+    rects: messages.filter((m) => m.type === LINE.RECT_START).map((m) => String(m.message))
+  };
+};
+var resolveVariables = (mermaid, config, themes) => {
+  const prior = mermaid.mermaidAPI.getSiteConfig();
+  try {
+    const out = {};
+    for (const t of THEMES) {
+      mermaid.initialize({ ...structuredClone(config), theme: themes[t] });
+      out[t] = { ...mermaid.mermaidAPI.getSiteConfig().themeVariables };
+    }
+    return out;
+  } finally {
+    mermaid.initialize(prior);
+  }
+};
+var themeVariable = (selector, line) => ({
+  kind: "themeVariables",
+  selector,
+  properties: {},
+  spans: {},
+  line
+});
+var scoreSequence = async (source, profile) => {
+  const pairs = [];
+  const skipped = [];
+  const lines = source.split(`
+`);
+  const keywordLine = lines.findIndex((l) => /^\s*sequenceDiagram\b/.test(l)) + 1;
+  const lineOf = (key) => {
+    const found = lines.findLastIndex((l) => new RegExp(`\\b${key}["']?\\s*:`).test(l));
+    return found < 0 ? keywordLine : found + 1;
+  };
+  const rectLines = lines.flatMap((l, i) => /^\s*rect\s/.test(l) ? [i + 1] : []);
+  const mermaid = await getMermaidCore();
+  let config;
+  let db;
+  try {
+    config = (await mermaid.parse(source)).config;
+    db = (await mermaid.mermaidAPI.getDiagramFromText(source)).db;
+  } catch {
+    return { pairs, skipped };
+  }
+  const block = (selector, reason) => {
+    skipped.push({ selector, line: lineOf(selector), reason, blocking: true });
+    return { pairs, skipped };
+  };
+  if (config.themeCSS !== undefined)
+    return block("themeCSS", "themeCSS restyles the diagram with CSS the audit cannot model");
+  const pinned = config.theme;
+  if (pinned !== undefined && !SEQUENCE_THEMES.includes(String(pinned))) {
+    return block("theme", `the ${String(pinned)} theme is not modelled, only ${SEQUENCE_THEMES.join(", ")}`);
+  }
+  const features = sequenceFeatures(db);
+  const host = profile === "mkdocs-material";
+  const theme = (fallback) => pinned === undefined ? fallback : String(pinned);
+  let variables;
+  try {
+    variables = resolveVariables(mermaid, config, { light: theme("default"), dark: theme(host ? "default" : "dark") });
+  } catch (err) {
+    return block("themeVariables", `Mermaid could not resolve the theme: ${message(err)}`);
+  }
+  for (const t of THEMES) {
+    const page = (host ? MKDOCS_MATERIAL : GITHUB)[t].bg;
+    const vars = variables[t];
+    const color = (key) => {
+      const value = vars[key];
+      if (typeof value !== "string")
+        throw new Error(`${key} is not a resolved colour`);
+      return value;
+    };
+    const pair = (kind, fgKey, bg, suffix = "", at) => {
+      const selector = fgKey + suffix;
+      const line = at ?? lineOf(fgKey);
+      try {
+        const box = compositeOver("key" in bg ? color(bg.key) : bg.colour, page);
+        pairs.push({ ...scoreHostPair(kind, themeVariable(selector, line), t, color(fgKey), box), advisory: host });
+      } catch (err) {
+        skipped.push({ selector, line, reason: `${t} sequence pair unparseable: ${message(err)}`, blocking: true });
+      }
+    };
+    const onPage = { colour: page };
+    if (host) {
+      pair("border", "actorLineColor", onPage);
+      pair("border", "signalColor", onPage, " (arrowhead)");
+      if (features.activation)
+        pair("border", "activationBorderColor", { key: "activationBkgColor" });
+      continue;
+    }
+    pair("text", "actorTextColor", { key: "actorBkg" });
+    pair("border", "actorBorder", { key: "actorBkg" });
+    if (features.humanActor) {
+      pair("text", "actorTextColor", onPage, " (human actor label)");
+      pair("border", "actorBorder", onPage, " (human actor glyph)");
+    }
+    pair("border", "actorLineColor", onPage);
+    pair("text", "signalTextColor", onPage);
+    pair("border", "signalColor", onPage);
+    if (features.note)
+      pair("text", "noteTextColor", { key: "noteBkgColor" });
+    if (features.frame) {
+      pair("text", "labelTextColor", { key: "labelBoxBkgColor" });
+      pair("text", "loopTextColor", onPage);
+      pair("border", "labelBoxBorderColor", onPage, " (loop frame)");
+    }
+    if (features.activation)
+      pair("border", "activationBorderColor", { key: "activationBkgColor" });
+    if (features.numbered)
+      pair("text", "sequenceNumberColor", { key: "signalColor" });
+    for (const [i, rect] of features.rects.entries()) {
+      const fill = { colour: rect };
+      const at = rectLines[i];
+      pair("text", "signalTextColor", fill, " (rect)", at);
+      pair("border", "signalColor", fill, " (rect)", at);
+      if (features.frame)
+        pair("text", "loopTextColor", fill, " (rect)", at);
+    }
+  }
+  return { pairs, skipped };
+};
+var scoreDiagram = (source, directives, profile, keyword) => keyword === "sequenceDiagram" ? scoreSequence(source, profile) : Promise.resolve(scoreForProfile(directives, profile, keyword));
 var detectProfile = (filePath) => {
   let dir = dirname(resolve(filePath));
   for (let i = 0;i < 20; i++) {
@@ -1452,7 +1586,7 @@ var contrastOf = (diagram, profile) => {
   }
   let result = byProfile.get(profile);
   if (!result) {
-    result = scoreForProfile(diagram.directives, profile, diagram.keyword);
+    result = scoreDiagram(diagram.source, diagram.directives, profile, diagram.keyword);
     byProfile.set(profile, result);
   }
   return result;
@@ -1565,11 +1699,11 @@ var contrastBorderBelowUiMinimum = {
   category: "contrast",
   summary: "a border below 3:1 against its fill",
   options: CONTRAST_OPTIONS,
-  check: (ctx) => {
+  check: async (ctx) => {
     const profile = profileOf(ctx);
     const found = [];
     for (const diagram of ctx.doc.diagrams) {
-      for (const p of contrastOf(diagram, profile).pairs) {
+      for (const p of (await contrastOf(diagram, profile)).pairs) {
         if (p.kind !== "border" || p.passes || p.advisory)
           continue;
         const line = fileLine(diagram, p.line);
@@ -1579,7 +1713,7 @@ var contrastBorderBelowUiMinimum = {
           endLine: line,
           rule: RULE.BORDER,
           message: `${p.directive.kind} ${p.selector}: border ${p.assessment.ratio.toFixed(2)}:1 < ${AA_NON_TEXT2} ` + `(${p.foreground} on ${p.background}${p.theme ? `, ${p.theme}` : ""})`,
-          remediation: "Darken the stroke or lighten the fill until the ratio reaches 3:1."
+          remediation: p.directive.kind === "themeVariables" ? "Set the theme variable to a colour that reaches 3:1 on its background in both themes, or remove it and let the theme set it." : "Darken the stroke or lighten the fill until the ratio reaches 3:1."
         });
       }
     }
@@ -1593,11 +1727,11 @@ var contrastDirectiveUnauditable = {
   category: "contrast",
   summary: "a style directive whose contrast cannot be audited",
   options: CONTRAST_OPTIONS,
-  check: (ctx) => {
+  check: async (ctx) => {
     const profile = profileOf(ctx);
     const found = [];
     for (const diagram of ctx.doc.diagrams) {
-      for (const s of contrastOf(diagram, profile).skipped) {
+      for (const s of (await contrastOf(diagram, profile)).skipped) {
         if (!s.blocking)
           continue;
         const line = fileLine(diagram, s.line);
@@ -1607,7 +1741,7 @@ var contrastDirectiveUnauditable = {
           endLine: line,
           rule: RULE.UNAUDITABLE,
           message: `${s.selector}: unaudited, ${s.reason}`,
-          remediation: "Declare the missing property or fix the colour so the pair can be scored."
+          remediation: "Declare the missing property, fix the colour, or remove the config the audit cannot model, so the pair can be scored."
         });
       }
     }
@@ -1624,11 +1758,11 @@ var contrastTextBelowAa = {
   category: "contrast",
   summary: "label text below 4.5:1 against its fill",
   options: CONTRAST_OPTIONS,
-  check: (ctx) => {
+  check: async (ctx) => {
     const profile = profileOf(ctx);
     const found = [];
     for (const diagram of ctx.doc.diagrams) {
-      for (const p of contrastOf(diagram, profile).pairs) {
+      for (const p of (await contrastOf(diagram, profile)).pairs) {
         if (p.kind !== "text" || p.passes)
           continue;
         const where = [p.theme, p.row].filter(Boolean).join("/");
@@ -1639,19 +1773,19 @@ var contrastTextBelowAa = {
           endLine: line,
           rule: RULE.TEXT,
           message: `${p.directive.kind} ${p.selector}: text ${p.assessment.ratio.toFixed(2)}:1 < ${AA_NORMAL2} ` + `(${p.foreground} on ${p.background}${where ? `, ${where}` : ""})`,
-          remediation: profile === "mkdocs-material" ? "The host theme forces the label text, so change the fill until the host text reads on it in both themes." : p.directive.kind === "linkStyle" ? "An edge label sits on Mermaid's own label box, light in one theme and grey in the other, and no one colour reads on both, so drop color: from the linkStyle and let the theme set the label text." : "Darken or lighten the fill, or change color:, until the ratio reaches 4.5:1 in every theme."
+          remediation: profile === "mkdocs-material" ? "The host theme forces the label text, so change the fill until the host text reads on it in both themes." : p.directive.kind === "themeVariables" ? "A sequence diagram colour is a theme variable, and text with no box of its own sits on the page, so set the variable to a colour that reads on its background in both themes, or remove it and let the theme set it." : p.directive.kind === "linkStyle" ? "An edge label sits on Mermaid's own label box, light in one theme and grey in the other, and no one colour reads on both, so drop color: from the linkStyle and let the theme set the label text." : "Darken or lighten the fill, or change color:, until the ratio reaches 4.5:1 in every theme."
         });
       }
     }
     return found;
   },
-  fix: (ctx) => {
+  fix: async (ctx) => {
     const profile = profileOf(ctx);
     if (profile === "mkdocs-material")
       return [];
     const edits = [];
     for (const diagram of ctx.doc.diagrams) {
-      const { pairs } = contrastOf(diagram, profile);
+      const { pairs } = await contrastOf(diagram, profile);
       const failing = new Set(pairs.filter((p) => p.kind === "text" && !p.passes).map((p) => p.directive));
       for (const directive of failing) {
         const span = directive.spans.color;
@@ -2269,7 +2403,7 @@ var RULE_KEY = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
 
 // src/plugins/runtime.ts
 var canImportTypeScript = (runtime = process) => typeof runtime.versions.bun === "string" || Boolean(runtime.features.typescript);
-var TYPESCRIPT_HELP = "TypeScript cannot be imported by this runtime. Run with Bun (bunx --bun @jpeakai/mermaidjs-lint), use Node 22.18 or newer, or write a .js or .mjs file";
+var TYPESCRIPT_HELP = "TypeScript cannot be imported by this runtime. Run with Bun (bunx --bun @jpeakai/mermaidjs-lint), use Node 22.18 or newer (23.6 or newer on Node 23), or write a .js or .mjs file";
 
 // src/plugins/load.ts
 var isRecord3 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);

package/dist/index.js

@@ -317,6 +317,7 @@ var getMermaid = async () => {
   mermaidCore = (await import("mermaid")).default;
   return mermaidCore;
 };
+var getMermaidCore = async () => await getMermaid();
 var LANGIUM_TYPES = {
   "architecture-beta": "architecture",
   architecture: "architecture",
@@ -1172,6 +1173,139 @@ var scoreForProfile = (directives, profile, keyword) => {
     return scoreMkdocs(directives);
   return keyword === "erDiagram" ? scoreEr(directives) : scoreGithub(directives);
 };
+var SEQUENCE_THEMES = ["base", "default", "dark", "forest", "neutral"];
+var LINE = { NOTE: 2, ACTIVE_START: 17, RECT_START: 22, AUTONUMBER: 26 };
+var FRAME_STARTS = new Set([10, 12, 15, 19, 27, 30, 32]);
+var sequenceFeatures = (db) => {
+  const messages = db.getMessages();
+  const has = (type) => messages.some((m) => m.type === type);
+  return {
+    humanActor: [...db.getActors().values()].some((a) => a.type === "actor"),
+    note: has(LINE.NOTE),
+    frame: messages.some((m) => FRAME_STARTS.has(m.type)),
+    activation: has(LINE.ACTIVE_START),
+    numbered: messages.some((m) => m.type === LINE.AUTONUMBER && m.message?.visible !== false),
+    rects: messages.filter((m) => m.type === LINE.RECT_START).map((m) => String(m.message))
+  };
+};
+var resolveVariables = (mermaid, config, themes) => {
+  const prior = mermaid.mermaidAPI.getSiteConfig();
+  try {
+    const out = {};
+    for (const t of THEMES) {
+      mermaid.initialize({ ...structuredClone(config), theme: themes[t] });
+      out[t] = { ...mermaid.mermaidAPI.getSiteConfig().themeVariables };
+    }
+    return out;
+  } finally {
+    mermaid.initialize(prior);
+  }
+};
+var themeVariable = (selector, line) => ({
+  kind: "themeVariables",
+  selector,
+  properties: {},
+  spans: {},
+  line
+});
+var scoreSequence = async (source, profile) => {
+  const pairs = [];
+  const skipped = [];
+  const lines = source.split(`
+`);
+  const keywordLine = lines.findIndex((l) => /^\s*sequenceDiagram\b/.test(l)) + 1;
+  const lineOf = (key) => {
+    const found = lines.findLastIndex((l) => new RegExp(`\\b${key}["']?\\s*:`).test(l));
+    return found < 0 ? keywordLine : found + 1;
+  };
+  const rectLines = lines.flatMap((l, i) => /^\s*rect\s/.test(l) ? [i + 1] : []);
+  const mermaid = await getMermaidCore();
+  let config;
+  let db;
+  try {
+    config = (await mermaid.parse(source)).config;
+    db = (await mermaid.mermaidAPI.getDiagramFromText(source)).db;
+  } catch {
+    return { pairs, skipped };
+  }
+  const block = (selector, reason) => {
+    skipped.push({ selector, line: lineOf(selector), reason, blocking: true });
+    return { pairs, skipped };
+  };
+  if (config.themeCSS !== undefined)
+    return block("themeCSS", "themeCSS restyles the diagram with CSS the audit cannot model");
+  const pinned = config.theme;
+  if (pinned !== undefined && !SEQUENCE_THEMES.includes(String(pinned))) {
+    return block("theme", `the ${String(pinned)} theme is not modelled, only ${SEQUENCE_THEMES.join(", ")}`);
+  }
+  const features = sequenceFeatures(db);
+  const host = profile === "mkdocs-material";
+  const theme = (fallback) => pinned === undefined ? fallback : String(pinned);
+  let variables;
+  try {
+    variables = resolveVariables(mermaid, config, { light: theme("default"), dark: theme(host ? "default" : "dark") });
+  } catch (err) {
+    return block("themeVariables", `Mermaid could not resolve the theme: ${message(err)}`);
+  }
+  for (const t of THEMES) {
+    const page = (host ? MKDOCS_MATERIAL : GITHUB)[t].bg;
+    const vars = variables[t];
+    const color = (key) => {
+      const value = vars[key];
+      if (typeof value !== "string")
+        throw new Error(`${key} is not a resolved colour`);
+      return value;
+    };
+    const pair = (kind, fgKey, bg, suffix = "", at) => {
+      const selector = fgKey + suffix;
+      const line = at ?? lineOf(fgKey);
+      try {
+        const box = compositeOver("key" in bg ? color(bg.key) : bg.colour, page);
+        pairs.push({ ...scoreHostPair(kind, themeVariable(selector, line), t, color(fgKey), box), advisory: host });
+      } catch (err) {
+        skipped.push({ selector, line, reason: `${t} sequence pair unparseable: ${message(err)}`, blocking: true });
+      }
+    };
+    const onPage = { colour: page };
+    if (host) {
+      pair("border", "actorLineColor", onPage);
+      pair("border", "signalColor", onPage, " (arrowhead)");
+      if (features.activation)
+        pair("border", "activationBorderColor", { key: "activationBkgColor" });
+      continue;
+    }
+    pair("text", "actorTextColor", { key: "actorBkg" });
+    pair("border", "actorBorder", { key: "actorBkg" });
+    if (features.humanActor) {
+      pair("text", "actorTextColor", onPage, " (human actor label)");
+      pair("border", "actorBorder", onPage, " (human actor glyph)");
+    }
+    pair("border", "actorLineColor", onPage);
+    pair("text", "signalTextColor", onPage);
+    pair("border", "signalColor", onPage);
+    if (features.note)
+      pair("text", "noteTextColor", { key: "noteBkgColor" });
+    if (features.frame) {
+      pair("text", "labelTextColor", { key: "labelBoxBkgColor" });
+      pair("text", "loopTextColor", onPage);
+      pair("border", "labelBoxBorderColor", onPage, " (loop frame)");
+    }
+    if (features.activation)
+      pair("border", "activationBorderColor", { key: "activationBkgColor" });
+    if (features.numbered)
+      pair("text", "sequenceNumberColor", { key: "signalColor" });
+    for (const [i, rect] of features.rects.entries()) {
+      const fill = { colour: rect };
+      const at = rectLines[i];
+      pair("text", "signalTextColor", fill, " (rect)", at);
+      pair("border", "signalColor", fill, " (rect)", at);
+      if (features.frame)
+        pair("text", "loopTextColor", fill, " (rect)", at);
+    }
+  }
+  return { pairs, skipped };
+};
+var scoreDiagram = (source, directives, profile, keyword) => keyword === "sequenceDiagram" ? scoreSequence(source, profile) : Promise.resolve(scoreForProfile(directives, profile, keyword));
 var detectProfile = (filePath) => {
   let dir = dirname(resolve(filePath));
   for (let i = 0;i < 20; i++) {
@@ -1374,7 +1508,7 @@ var contrastOf = (diagram, profile) => {
   }
   let result = byProfile.get(profile);
   if (!result) {
-    result = scoreForProfile(diagram.directives, profile, diagram.keyword);
+    result = scoreDiagram(diagram.source, diagram.directives, profile, diagram.keyword);
     byProfile.set(profile, result);
   }
   return result;
@@ -1487,11 +1621,11 @@ var contrastBorderBelowUiMinimum = {
   category: "contrast",
   summary: "a border below 3:1 against its fill",
   options: CONTRAST_OPTIONS,
-  check: (ctx) => {
+  check: async (ctx) => {
     const profile = profileOf(ctx);
     const found = [];
     for (const diagram of ctx.doc.diagrams) {
-      for (const p of contrastOf(diagram, profile).pairs) {
+      for (const p of (await contrastOf(diagram, profile)).pairs) {
         if (p.kind !== "border" || p.passes || p.advisory)
           continue;
         const line = fileLine(diagram, p.line);
@@ -1501,7 +1635,7 @@ var contrastBorderBelowUiMinimum = {
           endLine: line,
           rule: RULE.BORDER,
           message: `${p.directive.kind} ${p.selector}: border ${p.assessment.ratio.toFixed(2)}:1 < ${AA_NON_TEXT2} ` + `(${p.foreground} on ${p.background}${p.theme ? `, ${p.theme}` : ""})`,
-          remediation: "Darken the stroke or lighten the fill until the ratio reaches 3:1."
+          remediation: p.directive.kind === "themeVariables" ? "Set the theme variable to a colour that reaches 3:1 on its background in both themes, or remove it and let the theme set it." : "Darken the stroke or lighten the fill until the ratio reaches 3:1."
         });
       }
     }
@@ -1515,11 +1649,11 @@ var contrastDirectiveUnauditable = {
   category: "contrast",
   summary: "a style directive whose contrast cannot be audited",
   options: CONTRAST_OPTIONS,
-  check: (ctx) => {
+  check: async (ctx) => {
     const profile = profileOf(ctx);
     const found = [];
     for (const diagram of ctx.doc.diagrams) {
-      for (const s of contrastOf(diagram, profile).skipped) {
+      for (const s of (await contrastOf(diagram, profile)).skipped) {
         if (!s.blocking)
           continue;
         const line = fileLine(diagram, s.line);
@@ -1529,7 +1663,7 @@ var contrastDirectiveUnauditable = {
           endLine: line,
           rule: RULE.UNAUDITABLE,
           message: `${s.selector}: unaudited, ${s.reason}`,
-          remediation: "Declare the missing property or fix the colour so the pair can be scored."
+          remediation: "Declare the missing property, fix the colour, or remove the config the audit cannot model, so the pair can be scored."
         });
       }
     }
@@ -1546,11 +1680,11 @@ var contrastTextBelowAa = {
   category: "contrast",
   summary: "label text below 4.5:1 against its fill",
   options: CONTRAST_OPTIONS,
-  check: (ctx) => {
+  check: async (ctx) => {
     const profile = profileOf(ctx);
     const found = [];
     for (const diagram of ctx.doc.diagrams) {
-      for (const p of contrastOf(diagram, profile).pairs) {
+      for (const p of (await contrastOf(diagram, profile)).pairs) {
         if (p.kind !== "text" || p.passes)
           continue;
         const where = [p.theme, p.row].filter(Boolean).join("/");
@@ -1561,19 +1695,19 @@ var contrastTextBelowAa = {
           endLine: line,
           rule: RULE.TEXT,
           message: `${p.directive.kind} ${p.selector}: text ${p.assessment.ratio.toFixed(2)}:1 < ${AA_NORMAL2} ` + `(${p.foreground} on ${p.background}${where ? `, ${where}` : ""})`,
-          remediation: profile === "mkdocs-material" ? "The host theme forces the label text, so change the fill until the host text reads on it in both themes." : p.directive.kind === "linkStyle" ? "An edge label sits on Mermaid's own label box, light in one theme and grey in the other, and no one colour reads on both, so drop color: from the linkStyle and let the theme set the label text." : "Darken or lighten the fill, or change color:, until the ratio reaches 4.5:1 in every theme."
+          remediation: profile === "mkdocs-material" ? "The host theme forces the label text, so change the fill until the host text reads on it in both themes." : p.directive.kind === "themeVariables" ? "A sequence diagram colour is a theme variable, and text with no box of its own sits on the page, so set the variable to a colour that reads on its background in both themes, or remove it and let the theme set it." : p.directive.kind === "linkStyle" ? "An edge label sits on Mermaid's own label box, light in one theme and grey in the other, and no one colour reads on both, so drop color: from the linkStyle and let the theme set the label text." : "Darken or lighten the fill, or change color:, until the ratio reaches 4.5:1 in every theme."
         });
       }
     }
     return found;
   },
-  fix: (ctx) => {
+  fix: async (ctx) => {
     const profile = profileOf(ctx);
     if (profile === "mkdocs-material")
       return [];
     const edits = [];
     for (const diagram of ctx.doc.diagrams) {
-      const { pairs } = contrastOf(diagram, profile);
+      const { pairs } = await contrastOf(diagram, profile);
       const failing = new Set(pairs.filter((p) => p.kind === "text" && !p.passes).map((p) => p.directive));
       for (const directive of failing) {
         const span = directive.spans.color;
@@ -1783,7 +1917,7 @@ import { parseArgs } from "node:util";
 // package.json
 var package_default = {
   name: "@jpeakai/mermaidjs-lint",
-  version: "0.4.2",
+  version: "0.5.0",
   type: "module",
   description: "Deterministic lint gates and verified fixers for Mermaid diagrams in markdown",
   license: "MIT",
@@ -1841,7 +1975,7 @@ var package_default = {
     "mdast-util-from-markdown": "^2.0.3",
     "mdast-util-frontmatter": "^2.0.1",
     "mdast-util-gfm": "^3.1.0",
-    mermaid: "^11.14.0",
+    mermaid: "11.17.2",
     "micromark-extension-frontmatter": "^2.0.0",
     "micromark-extension-gfm": "^3.0.0"
   },
@@ -2269,7 +2403,7 @@ var RULE_KEY = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
 
 // src/plugins/runtime.ts
 var canImportTypeScript = (runtime = process) => typeof runtime.versions.bun === "string" || Boolean(runtime.features.typescript);
-var TYPESCRIPT_HELP = "TypeScript cannot be imported by this runtime. Run with Bun (bunx --bun @jpeakai/mermaidjs-lint), use Node 22.18 or newer, or write a .js or .mjs file";
+var TYPESCRIPT_HELP = "TypeScript cannot be imported by this runtime. Run with Bun (bunx --bun @jpeakai/mermaidjs-lint), use Node 22.18 or newer (23.6 or newer on Node 23), or write a .js or .mjs file";
 
 // src/plugins/load.ts
 var isRecord3 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);