);
}
function highlight(src, lang) {
const esc = (s) => s.replace(/&/g, '&').replace(//g, '>');
let s = esc(src);
if (lang === 'json' || lang === 'js' || lang === 'ts') {
s = s.replace(/("[^&]*?")(\s*:)/g, '$1$2');
s = s.replace(/:\s*("[^&]*?")/g, ': $1');
s = s.replace(/\b(true|false|null)\b/g, '$1');
s = s.replace(/\b(\d+(\.\d+)?)\b/g, '$1');
} else if (lang === 'yaml' || lang === 'yml') {
s = s.replace(/^(\s*)([a-z][\w-]*)(:)/gm, '$1$2$3');
s = s.replace(/(:\s*)([\w.\-/@]+)$/gm, '$1$2');
s = s.replace(/(^|\s)(#.*)$/gm, '$1$2');
s = s.replace(/\b(true|false)\b/g, '$1');
} else if (lang === 'sh' || lang === 'bash') {
s = s.replace(/(^|\s)(#.*)$/gm, '$1$2');
} else if (lang === 'md') {
s = s.replace(/(\$[a-z]+\$)/g, '$1');
s = s.replace(/(#{1,3}\s.*)/g, '$1');
}
return s;
}
// ───────────────────────── Top Nav ─────────────────────────
function TopNav({ dark, setDark }) {
return (
);
}
// ───────────────────────── Hero ─────────────────────────
const LANGS = ['Python', 'TypeScript', 'Go', 'Java', 'Ruby', 'JavaScript'];
function Hero() {
const [pct, setPct] = useState(0);
const [replaced, setReplaced] = useState(false);
const [langIdx, setLangIdx] = useState(0);
useEffect(() => {
let raf, start;
const target = 98;
const dur = 1600;
const tick = (t) => {
if (!start) start = t;
const k = Math.min(1, (t - start) / dur);
const eased = 1 - Math.pow(1 - k, 3);
setPct(Math.round(target * eased));
if (k < 1) raf = requestAnimationFrame(tick);
else setTimeout(() => setReplaced(true), 200);
};
raf = requestAnimationFrame(tick);
return () => cancelAnimationFrame(raf);
}, []);
useEffect(() => {
if (!replaced) return;
const id = setInterval(() => setReplaced((v) => !v), 3400);
return () => clearInterval(id);
}, [replaced]);
useEffect(() => {
const id = setInterval(() => setLangIdx((i) => (i + 1) % LANGS.length), 1800);
return () => clearInterval(id);
}, []);
return (
open source · MIT
Coverage badges for{' '}
{LANGS[langIdx]}
. Any language. One README token.
Run as a GitHub Action for any language, or as an
npm CLI for JavaScript. Drop a $coverage$ token in your README — it gets
replaced with a live SVG badge after every test run.
);
}
// ───────────────────────── FAQ ─────────────────────────
const FAQS = [
{
q: 'Does this only work for JavaScript?',
a: 'No. The GitHub Action works for any language that emits one of four supported coverage formats: istanbul, lcov, cobertura, or coverage-py. Python, Go, Java, Ruby, .NET — they all just work.',
},
{
q: 'Does it hit shields.io at runtime?',
a: "No. Badges are written into your repo and served from there. Your README keeps working when third parties don't.",
},
{
q: 'Action or npm — which should I use?',
a: 'GitHub Action for anything non-JS, or if you want zero local setup. The npm package for JS / TS projects that want a local script you can also run in CI.',
},
{
q: 'Will the Action commit to my repo?',
a: 'Only if you set commit: true. Otherwise it just updates the README in the workflow run; you can pipe it into your own commit step.',
},
{
q: 'Will it overwrite my README formatting?',
a: 'No. Only the $coverage$ tokens (and friends) are replaced. Everything else stays put.',
},
{
q: 'How do I pin a badge color or style?',
a: 'Set them per badge in .badge-config. Action inputs win over config values, so you can override per-workflow.',
},
{
q: 'My language is not in the list — can I still use it?',
a: 'Yes, as long as your test runner can output one of the four supported report types (istanbul, lcov, cobertura, or coverage-py). Many languages have converters — for example, Go uses gcov2lcov to turn its native .out file into lcov format. Check if your tool has a reporter plugin for one of these formats.',
},
];
function FAQ() {
const [open, setOpen] = useState(0);
return (
{FAQS.map((f, i) => (
{open === i &&
{f.a}
}
))}
);
}
// ───────────────────────── Section + TOC ─────────────────────────
function Section({ id, eyebrow, title, children }) {
return (
}-${encodeURIComponent(value)}-${color.replace('#',){kind=icon}
) : (