@vizejs/vite-plugin-musea 0.501.0 → 0.503.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/a11y/index.d.mts +1 -1
- package/dist/a11y/index.mjs +1 -1
- package/dist/{a11y-DuFu75hl.mjs → a11y-CYZszxM7.mjs} +23 -17
- package/dist/a11y-CYZszxM7.mjs.map +1 -0
- package/dist/{utils-ChmPv0qc.mjs → browser-launch-L43ulIaZ.mjs} +49 -2
- package/dist/browser-launch-L43ulIaZ.mjs.map +1 -0
- package/dist/cli/index.d.mts +4 -1
- package/dist/cli/index.d.mts.map +1 -1
- package/dist/cli/index.mjs +45 -7
- package/dist/cli/index.mjs.map +1 -1
- package/dist/{index-DENP7L3t.d.mts → index-CYEDgY-M.d.mts} +7 -6
- package/dist/index-CYEDgY-M.d.mts.map +1 -0
- package/dist/{index-ZFHsOEPD.d.mts → index-CbChC9Bf.d.mts} +20 -2
- package/dist/index-CbChC9Bf.d.mts.map +1 -0
- package/dist/index.d.mts +3 -3
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +72 -63
- package/dist/index.mjs.map +1 -1
- package/dist/{options-B-sFFEcK.mjs → options-BwF3nGEB.mjs} +241 -121
- package/dist/options-BwF3nGEB.mjs.map +1 -0
- package/dist/{vrt-dFU3k2J6.mjs → vrt-C7wgh92N.mjs} +15 -45
- package/dist/vrt-C7wgh92N.mjs.map +1 -0
- package/dist/{vrt-nAWyjDmd.d.mts → vrt-DNoUalLH.d.mts} +2 -2
- package/dist/{vrt-nAWyjDmd.d.mts.map → vrt-DNoUalLH.d.mts.map} +1 -1
- package/dist/vrt.d.mts +1 -1
- package/dist/vrt.mjs +2 -1
- package/package.json +4 -4
- package/dist/a11y-DuFu75hl.mjs.map +0 -1
- package/dist/index-DENP7L3t.d.mts.map +0 -1
- package/dist/index-ZFHsOEPD.d.mts.map +0 -1
- package/dist/options-B-sFFEcK.mjs.map +0 -1
- package/dist/utils-ChmPv0qc.mjs.map +0 -1
- package/dist/vrt-dFU3k2J6.mjs.map +0 -1
package/dist/a11y/index.d.mts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { a as generateA11yHtmlReport, i as computeA11ySummary, n as MuseaA11yRunner, o as generateA11yJsonReport, r as resolveAxeSource, t as A11ySummary } from "../index-
|
|
1
|
+
import { a as generateA11yHtmlReport, i as computeA11ySummary, n as MuseaA11yRunner, o as generateA11yJsonReport, r as resolveAxeSource, t as A11ySummary } from "../index-CYEDgY-M.mjs";
|
|
2
2
|
export { A11ySummary, MuseaA11yRunner, computeA11ySummary, generateA11yHtmlReport, generateA11yJsonReport, resolveAxeSource };
|
package/dist/a11y/index.mjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { a as generateA11yJsonReport, i as generateA11yHtmlReport, n as resolveAxeSource, r as computeA11ySummary, t as MuseaA11yRunner } from "../a11y-
|
|
1
|
+
import { a as generateA11yJsonReport, i as generateA11yHtmlReport, n as resolveAxeSource, r as computeA11ySummary, t as MuseaA11yRunner } from "../a11y-CYZszxM7.mjs";
|
|
2
2
|
export { MuseaA11yRunner, computeA11ySummary, generateA11yHtmlReport, generateA11yJsonReport, resolveAxeSource };
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { t as escapeHtml$1 } from "./utils-BloA9YP9.mjs";
|
|
2
|
-
import {
|
|
2
|
+
import { c as observePreviewReady, i as runJobsWithWorkers, l as waitForMountedPreview, o as buildVariantUrl, t as launchChromium } from "./browser-launch-L43ulIaZ.mjs";
|
|
3
3
|
import path from "node:path";
|
|
4
4
|
//#region src/a11y/node-report.ts
|
|
5
5
|
function nodeDetails(result) {
|
|
@@ -224,27 +224,31 @@ async function resolveAxeSource() {
|
|
|
224
224
|
*/
|
|
225
225
|
var MuseaA11yRunner = class {
|
|
226
226
|
options;
|
|
227
|
-
|
|
227
|
+
launchOptions;
|
|
228
|
+
constructor(options = {}, launchOptions = {}) {
|
|
228
229
|
this.options = {
|
|
229
230
|
enabled: options.enabled ?? true,
|
|
230
231
|
includeRules: options.includeRules ?? [],
|
|
231
232
|
excludeRules: options.excludeRules ?? [],
|
|
232
233
|
level: options.level ?? "AA"
|
|
233
234
|
};
|
|
235
|
+
this.launchOptions = launchOptions;
|
|
234
236
|
}
|
|
235
237
|
/**
|
|
236
238
|
* Run a11y audits on all art file variants.
|
|
237
|
-
* Reuses VRT runner's browser if available.
|
|
239
|
+
* Reuses the VRT runner's browser and worker limit if available.
|
|
238
240
|
*/
|
|
239
241
|
async runAudits(artFiles, baseUrl, vrtRunner) {
|
|
240
|
-
const results = [];
|
|
241
242
|
const defaultViewport = {
|
|
242
243
|
width: 1280,
|
|
243
244
|
height: 720,
|
|
244
245
|
name: "desktop"
|
|
245
246
|
};
|
|
246
|
-
|
|
247
|
-
|
|
247
|
+
return runJobsWithWorkers(artFiles.flatMap((art) => art.variants.filter((variant) => !variant.skipVrt).map((variant) => ({
|
|
248
|
+
art,
|
|
249
|
+
variantName: variant.name,
|
|
250
|
+
viewport: defaultViewport
|
|
251
|
+
}))), vrtRunner?.getOptions().workers ?? 1, async ({ art, variantName }) => {
|
|
248
252
|
let page = null;
|
|
249
253
|
let context = null;
|
|
250
254
|
try {
|
|
@@ -253,39 +257,41 @@ var MuseaA11yRunner = class {
|
|
|
253
257
|
page = context.page;
|
|
254
258
|
} else {
|
|
255
259
|
const { chromium } = await import("playwright");
|
|
256
|
-
const
|
|
260
|
+
const browser = await launchChromium(chromium, this.launchOptions);
|
|
261
|
+
const ctx = await browser.newContext({ viewport: {
|
|
257
262
|
width: defaultViewport.width,
|
|
258
263
|
height: defaultViewport.height
|
|
259
264
|
} });
|
|
260
265
|
page = await ctx.newPage();
|
|
261
266
|
context = {
|
|
262
267
|
page,
|
|
263
|
-
context:
|
|
268
|
+
context: { close: async () => {
|
|
269
|
+
await ctx.close();
|
|
270
|
+
await browser.close();
|
|
271
|
+
} }
|
|
264
272
|
};
|
|
265
273
|
}
|
|
266
|
-
const variantUrl = vrtRunner ? vrtRunner.getPreviewUrl(baseUrl, art.path,
|
|
274
|
+
const variantUrl = vrtRunner ? vrtRunner.getPreviewUrl(baseUrl, art.path, variantName) : buildVariantUrl(baseUrl, art.path, variantName);
|
|
267
275
|
const waitForReady = vrtRunner?.getCapture().waitForPreviewReady;
|
|
268
276
|
if (waitForReady) await observePreviewReady(page);
|
|
269
277
|
await page.goto(variantUrl, { waitUntil: "networkidle" });
|
|
270
278
|
if (waitForReady) await waitForMountedPreview(page);
|
|
271
279
|
await page.waitForSelector(".musea-variant", { timeout: 1e4 });
|
|
272
280
|
await page.waitForTimeout(200);
|
|
273
|
-
|
|
274
|
-
results.push(result);
|
|
281
|
+
return await this.auditPage(page, art.path, variantName);
|
|
275
282
|
} catch (error) {
|
|
276
|
-
|
|
283
|
+
return {
|
|
277
284
|
artPath: art.path,
|
|
278
|
-
variantName
|
|
285
|
+
variantName,
|
|
279
286
|
violations: [],
|
|
280
287
|
passes: 0,
|
|
281
288
|
incomplete: 0,
|
|
282
289
|
error: error instanceof Error ? error.message : String(error)
|
|
283
|
-
}
|
|
290
|
+
};
|
|
284
291
|
} finally {
|
|
285
292
|
if (context) await context.context.close();
|
|
286
293
|
}
|
|
287
|
-
}
|
|
288
|
-
return results;
|
|
294
|
+
});
|
|
289
295
|
}
|
|
290
296
|
/**
|
|
291
297
|
* Audit a single page using axe-core.
|
|
@@ -387,4 +393,4 @@ var MuseaA11yRunner = class {
|
|
|
387
393
|
//#endregion
|
|
388
394
|
export { generateA11yJsonReport as a, generateA11yHtmlReport as i, resolveAxeSource as n, computeA11ySummary as r, MuseaA11yRunner as t };
|
|
389
395
|
|
|
390
|
-
//# sourceMappingURL=a11y-
|
|
396
|
+
//# sourceMappingURL=a11y-CYZszxM7.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"a11y-CYZszxM7.mjs","names":["escapeHtml"],"sources":["../src/a11y/node-report.ts","../src/a11y/report.ts","../src/a11y/index.ts"],"sourcesContent":["import type { A11yViolation } from \"../types/index.js\";\nimport { escapeHtml } from \"../utils.js\";\n\nexport function nodeDetails(result: A11yViolation): string {\n return (result.targets ?? [])\n .map((node) => {\n const selectors = node.target\n .map((target) => (typeof target === \"string\" ? target : JSON.stringify(target)))\n .join(\", \");\n const checks = JSON.stringify({ any: node.any, all: node.all, none: node.none }, null, 2);\n return `<details class=\"node-details\"><summary><code>${escapeHtml(selectors)}</code></summary>\n <pre>${escapeHtml(node.html)}</pre>\n ${node.failureSummary ? `<pre>${escapeHtml(node.failureSummary)}</pre>` : \"\"}\n <pre>${escapeHtml(checks)}</pre></details>`;\n })\n .join(\"\");\n}\n","/**\n * A11y report generation for Musea.\n *\n * Generates HTML and JSON reports from accessibility audit results,\n * plus summary statistics computation.\n */\n\nimport type { A11yResult } from \"../types/index.js\";\nimport type { A11ySummary } from \"./index.js\";\nimport path from \"node:path\";\nimport { nodeDetails } from \"./node-report.js\";\n\n/**\n * Compute a11y summary statistics from results.\n */\nexport function computeA11ySummary(results: A11yResult[]): A11ySummary {\n const components = new Set(results.map((r) => r.artPath));\n const allViolations = results.flatMap((r) => r.violations);\n\n return {\n totalComponents: components.size,\n totalVariants: results.length,\n erroredVariants: results.filter((r) => r.error !== undefined).length,\n totalViolations: allViolations.length,\n criticalCount: allViolations.filter((v) => v.impact === \"critical\").length,\n seriousCount: allViolations.filter((v) => v.impact === \"serious\").length,\n moderateCount: allViolations.filter((v) => v.impact === \"moderate\").length,\n minorCount: allViolations.filter((v) => v.impact === \"minor\").length,\n };\n}\n\n/**\n * Generate HTML report from a11y results.\n */\nexport function generateA11yHtmlReport(results: A11yResult[], summary: A11ySummary): string {\n const timestamp = new Date().toLocaleString(\"ja-JP\", {\n year: \"numeric\",\n month: \"2-digit\",\n day: \"2-digit\",\n hour: \"2-digit\",\n minute: \"2-digit\",\n });\n\n const impactColor = (impact: string): string => {\n switch (impact) {\n case \"critical\":\n return \"#f87171\";\n case \"serious\":\n return \"#fb923c\";\n case \"moderate\":\n return \"#fbbf24\";\n case \"minor\":\n return \"#60a5fa\";\n default:\n return \"#7b8494\";\n }\n };\n\n const errorItems = results\n .filter((r) => r.error !== undefined)\n .map(\n (r) => `\n <div class=\"result\">\n <div class=\"result-header\">\n <div class=\"result-info\">\n <span class=\"result-name\">${escapeHtml(path.basename(r.artPath, \".art.vue\"))} / ${escapeHtml(r.variantName)}</span>\n <span class=\"result-count\">audit did not run</span>\n </div>\n </div>\n <p style=\"padding:0.75rem 1rem;color:#f87171\"><code>${escapeHtml(r.error ?? \"\")}</code></p>\n </div>`,\n )\n .join(\"\");\n\n const resultItems = results\n .filter((r) => r.violations.length > 0 || r.incomplete > 0)\n .map((r) => {\n const artName = path.basename(r.artPath, \".art.vue\");\n const findings = [\n ...r.violations.map((v) => ({ v, review: false })),\n ...(r.incompleteResults ?? []).map((v) => ({ v, review: true })),\n ];\n const violationRows = findings\n .map(\n ({ v, review }) => `\n <tr>\n <td><span style=\"color:${impactColor(v.impact ?? \"unknown\")};font-weight:600;text-transform:uppercase;font-size:0.6875rem\">${escapeHtml(review ? \"needs review\" : (v.impact ?? \"unknown\"))}</span></td>\n <td><code>${escapeHtml(v.id)}</code></td>\n <td>${escapeHtml(v.description)}${nodeDetails(v)}</td>\n <td>${v.nodes}</td>\n <td>${v.helpUrl ? `<a href=\"${escapeHtml(v.helpUrl)}\" target=\"_blank\" style=\"color:#60a5fa\">docs</a>` : \"\"}</td>\n </tr>`,\n )\n .join(\"\");\n\n return `\n <div class=\"result\">\n <div class=\"result-header\">\n <div class=\"result-info\">\n <span class=\"result-name\">${escapeHtml(artName)} / ${escapeHtml(r.variantName)}</span>\n <span class=\"result-count\">${r.violations.length} violation(s), ${r.incomplete} need review</span>\n </div>\n </div>\n <table class=\"violations-table\">\n <thead><tr><th>Impact</th><th>Rule</th><th>Description</th><th>Nodes</th><th>Help</th></tr></thead>\n <tbody>${violationRows}</tbody>\n </table>\n </div>`;\n })\n .join(\"\");\n\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <title>A11y Report - Musea</title>\n <style>\n :root {\n --musea-bg-primary: #0d0d0d;\n --musea-bg-secondary: #1a1815;\n --musea-bg-tertiary: #252220;\n --musea-accent: #a34828;\n --musea-text: #e6e9f0;\n --musea-text-muted: #7b8494;\n --musea-border: #3a3530;\n }\n * { box-sizing: border-box; margin: 0; padding: 0; }\n body {\n font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;\n background: var(--musea-bg-primary);\n color: var(--musea-text);\n min-height: 100vh;\n line-height: 1.5;\n }\n .header {\n background: var(--musea-bg-secondary);\n border-bottom: 1px solid var(--musea-border);\n padding: 1rem 2rem;\n display: flex;\n align-items: center;\n justify-content: space-between;\n }\n .logo { font-size: 1.25rem; font-weight: 700; color: var(--musea-accent); }\n .header-meta { color: var(--musea-text-muted); font-size: 0.8125rem; }\n .main { max-width: 1200px; margin: 0 auto; padding: 2rem; }\n .summary { display: grid; grid-template-columns: repeat(auto-fit, minmax(120px, 1fr)); gap: 1rem; margin-bottom: 2rem; }\n .stat { background: var(--musea-bg-secondary); border: 1px solid var(--musea-border); border-radius: 8px; padding: 1rem; text-align: center; }\n .stat-value { font-size: 1.75rem; font-weight: 700; font-variant-numeric: tabular-nums; }\n .stat-label { color: var(--musea-text-muted); font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.08em; }\n .stat.critical .stat-value { color: #f87171; }\n .stat.serious .stat-value { color: #fb923c; }\n .stat.moderate .stat-value { color: #fbbf24; }\n .stat.minor .stat-value { color: #60a5fa; }\n .stat.total .stat-value { color: var(--musea-text); }\n .results { display: flex; flex-direction: column; gap: 1rem; }\n .result { background: var(--musea-bg-secondary); border: 1px solid var(--musea-border); border-radius: 8px; overflow: hidden; }\n .result-header { padding: 1rem; background: var(--musea-bg-tertiary); display: flex; justify-content: space-between; align-items: center; }\n .result-name { font-weight: 600; }\n .result-count { color: var(--musea-text-muted); font-size: 0.8125rem; }\n .violations-table { width: 100%; border-collapse: collapse; font-size: 0.8125rem; }\n .violations-table th { padding: 0.75rem 1rem; text-align: left; color: var(--musea-text-muted); font-weight: 500; font-size: 0.6875rem; text-transform: uppercase; letter-spacing: 0.08em; border-bottom: 1px solid var(--musea-border); }\n .violations-table td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--musea-border); }\n .violations-table code { background: var(--musea-bg-tertiary); padding: 0.125rem 0.375rem; border-radius: 3px; font-size: 0.75rem; }\n .node-details { margin-top: 0.5rem; }\n .node-details pre { white-space: pre-wrap; overflow-wrap: anywhere; margin-top: 0.5rem; }\n .all-clear { background: rgba(74, 222, 128, 0.1); border: 1px solid rgba(74, 222, 128, 0.2); border-radius: 8px; padding: 2rem; text-align: center; }\n .all-clear-text { color: #4ade80; font-weight: 600; }\n </style>\n</head>\n<body>\n <header class=\"header\">\n <div><span class=\"logo\">Musea</span> <span style=\"color:var(--musea-text-muted);font-size:0.875rem;margin-left:1rem\">Accessibility Report</span></div>\n <div class=\"header-meta\">${timestamp}</div>\n </header>\n <main class=\"main\">\n <div class=\"summary\">\n <div class=\"stat total\"><div class=\"stat-value\">${summary.totalViolations}</div><div class=\"stat-label\">Violations</div></div>\n <div class=\"stat critical\"><div class=\"stat-value\">${summary.criticalCount}</div><div class=\"stat-label\">Critical</div></div>\n <div class=\"stat serious\"><div class=\"stat-value\">${summary.seriousCount}</div><div class=\"stat-label\">Serious</div></div>\n <div class=\"stat moderate\"><div class=\"stat-value\">${summary.moderateCount}</div><div class=\"stat-label\">Moderate</div></div>\n <div class=\"stat minor\"><div class=\"stat-value\">${summary.minorCount}</div><div class=\"stat-label\">Minor</div></div>\n <div class=\"stat critical\"><div class=\"stat-value\">${summary.erroredVariants}</div><div class=\"stat-label\">Not audited</div></div>\n </div>\n ${\n summary.totalViolations === 0 &&\n summary.erroredVariants === 0 &&\n !results.some((r) => r.incomplete > 0)\n ? `<div class=\"all-clear\"><div class=\"all-clear-text\">No accessibility violations found across ${summary.totalVariants} variant(s)</div></div>`\n : `<div class=\"results\">${errorItems}${resultItems}</div>`\n }\n </main>\n</body>\n</html>`;\n}\n\n/**\n * Generate JSON report for CI integration.\n */\nexport function generateA11yJsonReport(results: A11yResult[]): string {\n const summary = computeA11ySummary(results);\n return JSON.stringify(\n {\n timestamp: new Date().toISOString(),\n summary,\n results: results.map((r) => ({\n art: path.basename(r.artPath, \".art.vue\"),\n variant: r.variantName,\n violations: r.violations,\n passes: r.passes,\n incomplete: r.incomplete,\n ...(r.incompleteResults === undefined ? {} : { incompleteResults: r.incompleteResults }),\n ...(r.error === undefined ? {} : { error: r.error }),\n })),\n },\n null,\n 2,\n );\n}\n\nfunction escapeHtml(str: string): string {\n return str\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/\"/g, \""\")\n .replace(/'/g, \"'\");\n}\n","/**\n * Accessibility (a11y) testing module for Musea.\n * Uses axe-core for automated accessibility auditing via Playwright.\n */\n\nimport type { LaunchOptions, Page } from \"playwright\";\nimport type { AxeResults, Result } from \"axe-core\";\nimport type {\n ArtFileInfo,\n A11yResult,\n A11yViolation,\n A11yOptions,\n ViewportConfig,\n} from \"../types/index.js\";\nimport type { MuseaVrtRunner } from \"../vrt.js\";\nimport { runJobsWithWorkers } from \"../vrt/jobs.js\";\nimport { buildVariantUrl } from \"../vrt/utils.js\";\nimport { observePreviewReady, waitForMountedPreview } from \"../vrt/preview-ready.js\";\nimport { launchChromium } from \"../vrt/browser-launch.js\";\n\nimport { computeA11ySummary, generateA11yHtmlReport, generateA11yJsonReport } from \"./report.js\";\n\n// Re-export report functions so consumers importing from a11y.js still work\nexport { computeA11ySummary, generateA11yHtmlReport, generateA11yJsonReport } from \"./report.js\";\n\n/**\n * A11y audit summary.\n */\nexport interface A11ySummary {\n totalComponents: number;\n totalVariants: number;\n /** Variants whose audit could not run at all; see `A11yResult.error`. */\n erroredVariants: number;\n totalViolations: number;\n criticalCount: number;\n seriousCount: number;\n moderateCount: number;\n minorCount: number;\n}\n\n/**\n * Read axe-core's injectable browser bundle.\n *\n * axe-core ships CommonJS (`\"main\": \"axe.js\"`, no `exports` map), so under\n * ESM its exports arrive on the namespace's `default` and `source` is not\n * interop-detected as a named export: `(await import(\"axe-core\")).source`\n * is `undefined`. Injecting that injects nothing, leaves `window.axe`\n * undefined, and the audit dies later as `Cannot read properties of\n * undefined (reading 'run')` — a failure that points at the wrong line. So\n * read both shapes and fail here, where the cause is still legible.\n */\nexport async function resolveAxeSource(): Promise<string> {\n let namespace: { source?: unknown; default?: { source?: unknown } };\n try {\n namespace = await import(\"axe-core\");\n } catch (cause) {\n throw new Error(\n \"axe-core is not installed. Install it as a peer dependency: npm install axe-core\",\n { cause },\n );\n }\n\n const source = namespace.source ?? namespace.default?.source;\n if (typeof source !== \"string\" || source.length === 0) {\n throw new Error(\n \"axe-core is installed but exposes no `source` bundle to inject. \" +\n \"Expected a non-empty string on either the module namespace or its \" +\n \"default export; check that the installed axe-core version is >= 4.\",\n );\n }\n return source;\n}\n\n/**\n * A11y runner using axe-core via Playwright.\n */\nexport class MuseaA11yRunner {\n private options: Required<A11yOptions>;\n private launchOptions: LaunchOptions;\n\n constructor(options: A11yOptions = {}, launchOptions: LaunchOptions = {}) {\n this.options = {\n enabled: options.enabled ?? true,\n includeRules: options.includeRules ?? [],\n excludeRules: options.excludeRules ?? [],\n level: options.level ?? \"AA\",\n };\n this.launchOptions = launchOptions;\n }\n\n /**\n * Run a11y audits on all art file variants.\n * Reuses the VRT runner's browser and worker limit if available.\n */\n async runAudits(\n artFiles: ArtFileInfo[],\n baseUrl: string,\n vrtRunner?: MuseaVrtRunner,\n ): Promise<A11yResult[]> {\n const defaultViewport: ViewportConfig = { width: 1280, height: 720, name: \"desktop\" };\n const jobs = artFiles.flatMap((art) =>\n art.variants\n .filter((variant) => !variant.skipVrt)\n .map((variant) => ({ art, variantName: variant.name, viewport: defaultViewport })),\n );\n const workers = vrtRunner?.getOptions().workers ?? 1;\n\n return runJobsWithWorkers(jobs, workers, async ({ art, variantName }) => {\n let page: Page | null = null;\n let context: { page: Page; context: { close(): Promise<void> } } | null = null;\n\n try {\n if (vrtRunner) {\n context = await vrtRunner.createPage(defaultViewport);\n page = context.page;\n } else {\n // Standalone mode: launch own browser\n const { chromium } = await import(\"playwright\");\n const browser = await launchChromium(chromium, this.launchOptions);\n const ctx = await browser.newContext({\n viewport: { width: defaultViewport.width, height: defaultViewport.height },\n });\n page = await ctx.newPage();\n context = {\n page,\n context: {\n close: async () => {\n await ctx.close();\n await browser.close();\n },\n },\n };\n }\n\n const variantUrl = vrtRunner\n ? vrtRunner.getPreviewUrl(baseUrl, art.path, variantName)\n : buildVariantUrl(baseUrl, art.path, variantName);\n const waitForReady = vrtRunner?.getCapture().waitForPreviewReady;\n if (waitForReady) await observePreviewReady(page);\n await page.goto(variantUrl, { waitUntil: \"networkidle\" });\n if (waitForReady) await waitForMountedPreview(page);\n await page.waitForSelector(\".musea-variant\", { timeout: 10000 });\n await page.waitForTimeout(200);\n\n return await this.auditPage(page, art.path, variantName);\n } catch (error) {\n return {\n artPath: art.path,\n variantName,\n violations: [],\n passes: 0,\n incomplete: 0,\n error: error instanceof Error ? error.message : String(error),\n };\n } finally {\n if (context) {\n await context.context.close();\n }\n }\n });\n }\n\n /**\n * Audit a single page using axe-core.\n */\n async auditPage(page: Page, artPath: string, variantName: string): Promise<A11yResult> {\n // Inject axe-core into the page\n const axeSource = await resolveAxeSource();\n await page.evaluate(axeSource);\n\n // Build axe-core run options\n const runOptions = this.buildAxeOptions();\n\n // Run axe-core\n const axeResult = (await page.evaluate((opts) => {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return (window as any).axe.run(document, opts);\n }, runOptions)) as AxeResults;\n\n // Map to our result format\n const mapResult = (result: Result): A11yViolation => ({\n id: result.id,\n impact: result.impact ?? null,\n description: result.description,\n helpUrl: result.helpUrl,\n nodes: result.nodes.length,\n targets: result.nodes.map((node) => ({\n target: node.target,\n html: node.html,\n failureSummary: node.failureSummary,\n any: node.any.map(({ id, impact, message, data }) => ({ id, impact, message, data })),\n all: node.all.map(({ id, impact, message, data }) => ({ id, impact, message, data })),\n none: node.none.map(({ id, impact, message, data }) => ({ id, impact, message, data })),\n })),\n });\n const violations = axeResult.violations.map(mapResult);\n\n return {\n artPath,\n variantName,\n violations,\n passes: axeResult.passes.length,\n incomplete: axeResult.incomplete.length,\n incompleteResults: axeResult.incomplete.map(mapResult),\n };\n }\n\n /**\n * Get summary statistics from results.\n */\n getSummary(results: A11yResult[]): A11ySummary {\n return computeA11ySummary(results);\n }\n\n /**\n * Generate HTML report.\n */\n generateHtmlReport(results: A11yResult[]): string {\n const summary = this.getSummary(results);\n return generateA11yHtmlReport(results, summary);\n }\n\n /**\n * Generate JSON report for CI integration.\n */\n generateJsonReport(results: A11yResult[]): string {\n return generateA11yJsonReport(results);\n }\n\n /**\n * Build axe-core run options from configuration.\n */\n private buildAxeOptions(): Record<string, unknown> {\n const runOnly: Record<string, unknown> = {};\n\n // Set WCAG level\n const tags: string[] = [];\n switch (this.options.level) {\n case \"A\":\n tags.push(\"wcag2a\", \"wcag21a\");\n break;\n case \"AA\":\n tags.push(\"wcag2a\", \"wcag2aa\", \"wcag21a\", \"wcag21aa\", \"wcag22aa\");\n break;\n case \"AAA\":\n tags.push(\"wcag2a\", \"wcag2aa\", \"wcag2aaa\", \"wcag21a\", \"wcag21aa\", \"wcag22aa\");\n break;\n }\n\n if (tags.length > 0) {\n runOnly.type = \"tag\";\n runOnly.values = tags;\n }\n\n const rules: Record<string, { enabled: boolean }> = {};\n\n for (const ruleId of this.options.includeRules) {\n rules[ruleId] = { enabled: true };\n }\n for (const ruleId of this.options.excludeRules) {\n rules[ruleId] = { enabled: false };\n }\n\n return {\n ...(Object.keys(runOnly).length > 0 ? { runOnly } : {}),\n ...(Object.keys(rules).length > 0 ? { rules } : {}),\n };\n }\n}\n"],"mappings":"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"}
|
|
@@ -50,6 +50,53 @@ function computeSummary(results, startTime) {
|
|
|
50
50
|
};
|
|
51
51
|
}
|
|
52
52
|
//#endregion
|
|
53
|
-
|
|
53
|
+
//#region src/vrt/jobs.ts
|
|
54
|
+
function normalizeVrtWorkerCount(workers) {
|
|
55
|
+
if (workers === void 0 || !Number.isFinite(workers)) return 1;
|
|
56
|
+
return Math.max(1, Math.floor(workers));
|
|
57
|
+
}
|
|
58
|
+
function createVrtJobs(artFiles, defaultViewports) {
|
|
59
|
+
const jobs = [];
|
|
60
|
+
for (const art of artFiles) for (const variant of art.variants) {
|
|
61
|
+
if (variant.skipVrt) continue;
|
|
62
|
+
const viewports = variant.args?.viewport ? [variant.args.viewport] : defaultViewports;
|
|
63
|
+
for (const viewport of viewports) jobs.push({
|
|
64
|
+
art,
|
|
65
|
+
variantName: variant.name,
|
|
66
|
+
viewport
|
|
67
|
+
});
|
|
68
|
+
}
|
|
69
|
+
return jobs;
|
|
70
|
+
}
|
|
71
|
+
async function runJobsWithWorkers(jobs, workerCount, runJob) {
|
|
72
|
+
const results = Array.from({ length: jobs.length }, () => null);
|
|
73
|
+
let nextJobIndex = 0;
|
|
74
|
+
async function runWorker() {
|
|
75
|
+
while (true) {
|
|
76
|
+
const jobIndex = nextJobIndex++;
|
|
77
|
+
const job = jobs[jobIndex];
|
|
78
|
+
if (!job) return;
|
|
79
|
+
results[jobIndex] = await runJob(job);
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
const activeWorkers = Math.min(normalizeVrtWorkerCount(workerCount), jobs.length);
|
|
83
|
+
await Promise.all(Array.from({ length: activeWorkers }, () => runWorker()));
|
|
84
|
+
return results.filter((result) => result !== null);
|
|
85
|
+
}
|
|
86
|
+
//#endregion
|
|
87
|
+
//#region src/vrt/browser-launch.ts
|
|
88
|
+
function mergeChromiumLaunchOptions(launchOptions = {}, internalArgs = []) {
|
|
89
|
+
const args = [...internalArgs, ...launchOptions.args ?? []];
|
|
90
|
+
return {
|
|
91
|
+
headless: true,
|
|
92
|
+
...launchOptions,
|
|
93
|
+
...args.length > 0 ? { args } : {}
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
function launchChromium(chromium, launchOptions = {}, internalArgs = []) {
|
|
97
|
+
return chromium.launch(mergeChromiumLaunchOptions(launchOptions, internalArgs));
|
|
98
|
+
}
|
|
99
|
+
//#endregion
|
|
100
|
+
export { buildSnapshotName as a, observePreviewReady as c, runJobsWithWorkers as i, waitForMountedPreview as l, createVrtJobs as n, buildVariantUrl as o, normalizeVrtWorkerCount as r, computeSummary as s, launchChromium as t };
|
|
54
101
|
|
|
55
|
-
//# sourceMappingURL=
|
|
102
|
+
//# sourceMappingURL=browser-launch-L43ulIaZ.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"browser-launch-L43ulIaZ.mjs","names":[],"sources":["../src/vrt/preview-ready.ts","../src/vrt/utils.ts","../src/vrt/jobs.ts","../src/vrt/browser-launch.ts"],"sourcesContent":["import type { Page } from \"playwright\";\n\n/** Attach before navigation, because async setup may finish before goto returns. */\nexport async function observePreviewReady(page: Page): Promise<void> {\n await page.addInitScript(() => {\n window.addEventListener(\"message\", (event) => {\n if (\n event.source === window &&\n event.origin === window.location.origin &&\n event.data?.type === \"musea:ready\"\n )\n Reflect.set(window, \"__museaVrtReady\", true);\n });\n });\n}\n\nexport async function waitForMountedPreview(page: Page): Promise<void> {\n await page.waitForFunction(() => Reflect.get(window, \"__museaVrtReady\") === true, undefined, {\n timeout: 10000,\n });\n}\n","/**\n * Utility functions for VRT runner.\n *\n * Includes summary generation, URL builders, and helpers\n * used across the runner modules.\n */\n\nimport type { VrtResult, VrtSummary } from \"./types.js\";\nimport type { ViewportConfig } from \"../types/index.js\";\nimport path from \"node:path\";\n\n/**\n * Build URL for variant preview.\n */\nexport function buildVariantUrl(\n baseUrl: string,\n artPath: string,\n variantName: string,\n previewBasePath = \"/__musea__\",\n): string {\n const encodedPath = encodeURIComponent(artPath);\n const encodedVariant = encodeURIComponent(variantName);\n const route = previewBasePath.replace(/^\\/+|\\/+$/g, \"\");\n return `${baseUrl.replace(/\\/+$/, \"\")}/${route ? `${route}/` : \"\"}preview?art=${encodedPath}&variant=${encodedVariant}`;\n}\n\n/**\n * Build a filesystem-safe snapshot file name for a VRT capture.\n */\nexport function buildSnapshotName(\n artPath: string,\n variantName: string,\n viewport: ViewportConfig,\n): string {\n const artBaseName = path.basename(artPath, \".art.vue\");\n const viewportName = viewport.name || `${viewport.width}x${viewport.height}`;\n return `${encodeSnapshotNamePart(artBaseName)}--${encodeSnapshotNamePart(\n variantName,\n )}--${encodeSnapshotNamePart(viewportName)}.png`;\n}\n\nfunction encodeSnapshotNamePart(value: string): string {\n const encoded = encodeURIComponent(value);\n return encoded.length === 0 ? \"unnamed\" : encoded;\n}\n\n/**\n * Compute VRT summary statistics from a list of results.\n */\nexport function computeSummary(results: VrtResult[], startTime: number): VrtSummary {\n const errors = results.filter((r) => r.error).length;\n return {\n total: results.length,\n passed: results.filter((r) => r.passed && !r.isNew).length,\n failed: results.filter((r) => !r.passed && !r.error).length,\n new: results.filter((r) => r.isNew).length,\n skipped: 0,\n errors,\n duration: Date.now() - startTime,\n };\n}\n","import type { ArtFileInfo, ViewportConfig } from \"../types/index.js\";\n\nexport type VrtJob = {\n art: ArtFileInfo;\n variantName: string;\n viewport: ViewportConfig;\n};\n\nexport function normalizeVrtWorkerCount(workers: number | undefined): number {\n if (workers === undefined || !Number.isFinite(workers)) {\n return 1;\n }\n return Math.max(1, Math.floor(workers));\n}\n\nexport function createVrtJobs(\n artFiles: ArtFileInfo[],\n defaultViewports: ViewportConfig[],\n): VrtJob[] {\n const jobs: VrtJob[] = [];\n for (const art of artFiles) {\n for (const variant of art.variants) {\n if (variant.skipVrt) {\n continue;\n }\n\n const viewports = variant.args?.viewport\n ? [variant.args.viewport as ViewportConfig]\n : defaultViewports;\n\n for (const viewport of viewports) {\n jobs.push({ art, variantName: variant.name, viewport });\n }\n }\n }\n return jobs;\n}\n\nexport async function runJobsWithWorkers<T>(\n jobs: readonly VrtJob[],\n workerCount: number,\n runJob: (job: VrtJob) => Promise<T | null>,\n): Promise<T[]> {\n const results = Array.from<T | null>({ length: jobs.length }, () => null);\n let nextJobIndex = 0;\n\n async function runWorker(): Promise<void> {\n while (true) {\n const jobIndex = nextJobIndex++;\n const job = jobs[jobIndex];\n if (!job) {\n return;\n }\n results[jobIndex] = await runJob(job);\n }\n }\n\n const activeWorkers = Math.min(normalizeVrtWorkerCount(workerCount), jobs.length);\n await Promise.all(Array.from({ length: activeWorkers }, () => runWorker()));\n return results.filter((result): result is T => result !== null);\n}\n","import type { Browser, BrowserType, LaunchOptions } from \"playwright\";\n\nexport function mergeChromiumLaunchOptions(\n launchOptions: LaunchOptions = {},\n internalArgs: string[] = [],\n): LaunchOptions {\n const args = [...internalArgs, ...(launchOptions.args ?? [])];\n return {\n headless: true,\n ...launchOptions,\n ...(args.length > 0 ? { args } : {}),\n };\n}\n\nexport function launchChromium(\n chromium: Pick<BrowserType, \"launch\">,\n launchOptions: LaunchOptions = {},\n internalArgs: string[] = [],\n): Promise<Browser> {\n return chromium.launch(mergeChromiumLaunchOptions(launchOptions, internalArgs));\n}\n"],"mappings":"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"}
|
package/dist/cli/index.d.mts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { l as MuseaVrtOptions } from "../index-
|
|
1
|
+
import { l as MuseaVrtOptions } from "../index-CbChC9Bf.mjs";
|
|
2
2
|
|
|
3
3
|
//#region src/cli/index.d.ts
|
|
4
4
|
type Command = "run" | "approve" | "clean" | "generate" | "serve";
|
|
@@ -10,8 +10,11 @@ interface CliOptions {
|
|
|
10
10
|
output: string;
|
|
11
11
|
threshold: number;
|
|
12
12
|
thresholdProvided: boolean;
|
|
13
|
+
colorThreshold: number;
|
|
14
|
+
colorThresholdProvided: boolean;
|
|
13
15
|
workers: number;
|
|
14
16
|
workersProvided: boolean;
|
|
17
|
+
browserArgs: string[];
|
|
15
18
|
json: boolean;
|
|
16
19
|
ci: boolean;
|
|
17
20
|
a11y: boolean;
|
package/dist/cli/index.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cli/index.ts"],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cli/index.ts"],"mappings":";;;KAsCK,OAAA;AAAA,UAEY,UAAA;EACf,OAAA,EAAS,OAAA;EACT,MAAA;EACA,MAAA;EACA,SAAA;EACA,MAAA;EACA,SAAA;EACA,iBAAA;EACA,cAAA;EACA,sBAAA;EACA,OAAA;EACA,eAAA;EACA,WAAA;EACA,IAAA;EACA,EAAA;EACA,IAAA;EACA,IAAA;EACA,OAAA;EACA,OAAA;EACA,aAAA;EACA,GAAA,GAAM,eAAA;EACN,UAAA;EACA,eAAA;EACA,WAAA,GAAc,MAAA,SAAe,MAAA;EAC7B,WAAA;EACA,kBAAA,GAAqB,MAAA;EACrB,oBAAA;AAAA;AAAA,iBAGc,SAAA,CAAU,IAAA,aAAiB,UAAU"}
|
package/dist/cli/index.mjs
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { a as scanArtFiles } from "../utils-BloA9YP9.mjs";
|
|
3
|
-
import { a as attachArtReportOwner, i as assertArtReportOwnership, n as readMuseaOptions, o as resolveArtReportTarget, r as processMuseaArtFile, s as publicBasePathFromViteBase } from "../options-
|
|
4
|
-
import { a as
|
|
3
|
+
import { a as attachArtReportOwner, i as assertArtReportOwnership, n as readMuseaOptions, o as resolveArtReportTarget, r as processMuseaArtFile, s as publicBasePathFromViteBase } from "../options-BwF3nGEB.mjs";
|
|
4
|
+
import { a as normalizeSnapshotIdentity, i as MuseaVrtRunner, n as generateVrtJsonReport, r as generateVrtReport } from "../vrt-C7wgh92N.mjs";
|
|
5
|
+
import { r as normalizeVrtWorkerCount } from "../browser-launch-L43ulIaZ.mjs";
|
|
5
6
|
import fs, { realpathSync } from "node:fs";
|
|
6
7
|
import path from "node:path";
|
|
7
8
|
import { randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
|
|
@@ -10,6 +11,11 @@ import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
|
|
|
10
11
|
import { loadConfig, resolveViteConfigExport } from "@vizejs/vite-plugin";
|
|
11
12
|
import { loadConfigFromFile } from "vite";
|
|
12
13
|
import { createServer } from "node:http";
|
|
14
|
+
//#region src/cli/errors.ts
|
|
15
|
+
function formatCliError(error) {
|
|
16
|
+
return error instanceof Error ? error.message : String(error);
|
|
17
|
+
}
|
|
18
|
+
//#endregion
|
|
13
19
|
//#region src/cli/utils.ts
|
|
14
20
|
/** Parse a single .art.vue file into an ArtFileInfo structure. */
|
|
15
21
|
async function parseArtFile(filePath) {
|
|
@@ -38,6 +44,10 @@ function isArtFileInput(filePath) {
|
|
|
38
44
|
}
|
|
39
45
|
function createVrtOptions(options) {
|
|
40
46
|
const configured = withoutA11y(options.vrt);
|
|
47
|
+
const comparison = options.colorThresholdProvided ? {
|
|
48
|
+
...configured.comparison,
|
|
49
|
+
colorThreshold: options.colorThreshold
|
|
50
|
+
} : configured.comparison;
|
|
41
51
|
const vrtOptions = {
|
|
42
52
|
...configured,
|
|
43
53
|
...options.projectRoot !== void 0 ? { projectRoot: options.projectRoot } : {},
|
|
@@ -47,6 +57,7 @@ function createVrtOptions(options) {
|
|
|
47
57
|
waitForPreviewReady: true,
|
|
48
58
|
...configured.capture
|
|
49
59
|
},
|
|
60
|
+
...comparison !== void 0 ? { comparison } : {},
|
|
50
61
|
...options.previewBasePath !== void 0 ? { previewBasePath: options.previewBasePath } : {},
|
|
51
62
|
...options.previewUrls !== void 0 ? { previewUrls: options.previewUrls } : {},
|
|
52
63
|
snapshotDir: resolveVrtSnapshotDir(options, configured.snapshotDir),
|
|
@@ -54,6 +65,10 @@ function createVrtOptions(options) {
|
|
|
54
65
|
};
|
|
55
66
|
const workers = options.workersProvided ? options.workers : configured.workers;
|
|
56
67
|
if (workers !== void 0) vrtOptions.workers = normalizeVrtWorkerCount(workers);
|
|
68
|
+
if (options.browserArgs.length > 0) vrtOptions.launchOptions = {
|
|
69
|
+
...configured.launchOptions,
|
|
70
|
+
args: [...configured.launchOptions?.args ?? [], ...options.browserArgs]
|
|
71
|
+
};
|
|
57
72
|
return vrtOptions;
|
|
58
73
|
}
|
|
59
74
|
/**
|
|
@@ -73,7 +88,7 @@ function withoutA11y(vrt) {
|
|
|
73
88
|
}
|
|
74
89
|
/** Options object `musea-vrt --a11y` passes to `MuseaA11yRunner`. */
|
|
75
90
|
function createA11yRunner(options, Runner) {
|
|
76
|
-
return new Runner(options.vrt?.a11y);
|
|
91
|
+
return new Runner(options.vrt?.a11y, createVrtOptions(options).launchOptions);
|
|
77
92
|
}
|
|
78
93
|
async function runVrt(options, artFiles) {
|
|
79
94
|
const totalVariants = artFiles.reduce((sum, art) => sum + art.variants.filter((v) => !v.skipVrt).length, 0);
|
|
@@ -665,6 +680,7 @@ async function runServe(options) {
|
|
|
665
680
|
* -c, --config Path to Vite config (default: Vite config discovery)
|
|
666
681
|
* -o, --output Output directory for reports (default: .vize)
|
|
667
682
|
* -t, --threshold Diff threshold percentage (default: 0.1)
|
|
683
|
+
* --color-threshold Per-pixel color threshold, 0-1 (default: 0.1)
|
|
668
684
|
* -w, --workers Number of concurrent captures (default: 1)
|
|
669
685
|
* --json Output JSON report instead of HTML
|
|
670
686
|
* --ci CI mode - exit with non-zero code on failures
|
|
@@ -678,8 +694,11 @@ function parseArgs(args) {
|
|
|
678
694
|
output: ".vize",
|
|
679
695
|
threshold: .1,
|
|
680
696
|
thresholdProvided: false,
|
|
697
|
+
colorThreshold: .1,
|
|
698
|
+
colorThresholdProvided: false,
|
|
681
699
|
workers: 1,
|
|
682
700
|
workersProvided: false,
|
|
701
|
+
browserArgs: [],
|
|
683
702
|
json: false,
|
|
684
703
|
ci: false,
|
|
685
704
|
a11y: false,
|
|
@@ -729,6 +748,10 @@ function parseArgs(args) {
|
|
|
729
748
|
options.threshold = parseThreshold(args[++i]);
|
|
730
749
|
options.thresholdProvided = true;
|
|
731
750
|
break;
|
|
751
|
+
case "--color-threshold":
|
|
752
|
+
options.colorThreshold = parseColorThreshold(args[++i]);
|
|
753
|
+
options.colorThresholdProvided = true;
|
|
754
|
+
break;
|
|
732
755
|
case "-w":
|
|
733
756
|
case "--workers":
|
|
734
757
|
options.workers = parseWorkers(args[++i]);
|
|
@@ -743,6 +766,12 @@ function parseArgs(args) {
|
|
|
743
766
|
case "--a11y":
|
|
744
767
|
options.a11y = true;
|
|
745
768
|
break;
|
|
769
|
+
case "--browser-arg": {
|
|
770
|
+
const browserArg = args[++i];
|
|
771
|
+
if (browserArg === void 0) throw new Error("--browser-arg requires a value");
|
|
772
|
+
options.browserArgs.push(browserArg);
|
|
773
|
+
break;
|
|
774
|
+
}
|
|
746
775
|
case "-b":
|
|
747
776
|
case "--base-url":
|
|
748
777
|
options.baseUrl = args[++i] || "http://localhost:5173";
|
|
@@ -765,6 +794,10 @@ function parseThreshold(value) {
|
|
|
765
794
|
const threshold = Number.parseFloat(value ?? "");
|
|
766
795
|
return Number.isFinite(threshold) ? threshold : .1;
|
|
767
796
|
}
|
|
797
|
+
function parseColorThreshold(value) {
|
|
798
|
+
const threshold = Number.parseFloat(value ?? "");
|
|
799
|
+
return Number.isFinite(threshold) && threshold >= 0 && threshold <= 1 ? threshold : .1;
|
|
800
|
+
}
|
|
768
801
|
function printHelp() {
|
|
769
802
|
console.log(`
|
|
770
803
|
Musea VRT - Visual Regression Testing for Component Gallery
|
|
@@ -785,6 +818,7 @@ Options:
|
|
|
785
818
|
-c, --config <path> Path to Vite config file (default: Vite config discovery)
|
|
786
819
|
-o, --output <dir> Output directory for reports (default: .vize)
|
|
787
820
|
-t, --threshold <n> Diff threshold percentage (default: 0.1)
|
|
821
|
+
--color-threshold <n> Per-pixel color threshold, 0-1 (default: 0.1)
|
|
788
822
|
-b, --base-url <url> Base URL for dev server (default: http://localhost:5173)
|
|
789
823
|
--gallery-url <url> Capture a built hosted gallery using its static manifest
|
|
790
824
|
--adopt-legacy-snapshots Adopt reviewed, unambiguous legacy PNG baselines once
|
|
@@ -792,6 +826,7 @@ Options:
|
|
|
792
826
|
--json Output JSON report instead of HTML
|
|
793
827
|
--ci CI mode - exit with non-zero code on failures
|
|
794
828
|
--a11y Run accessibility audits alongside VRT
|
|
829
|
+
--browser-arg <arg> Add a Chromium launch argument (repeatable)
|
|
795
830
|
-h, --help Show this help message
|
|
796
831
|
|
|
797
832
|
Examples:
|
|
@@ -813,6 +848,9 @@ Examples:
|
|
|
813
848
|
# Capture variants concurrently
|
|
814
849
|
musea-vrt --workers 8
|
|
815
850
|
|
|
851
|
+
# Stabilize Chromium rasterization
|
|
852
|
+
musea-vrt --browser-arg --disable-partial-raster
|
|
853
|
+
|
|
816
854
|
# Approve all failed snapshots
|
|
817
855
|
musea-vrt approve
|
|
818
856
|
|
|
@@ -842,7 +880,7 @@ async function main() {
|
|
|
842
880
|
try {
|
|
843
881
|
await runGenerate(options);
|
|
844
882
|
} catch (error) {
|
|
845
|
-
console.error("\n Error:", error);
|
|
883
|
+
console.error("\n Error:", formatCliError(error));
|
|
846
884
|
process.exit(1);
|
|
847
885
|
}
|
|
848
886
|
return;
|
|
@@ -854,7 +892,7 @@ async function main() {
|
|
|
854
892
|
try {
|
|
855
893
|
await runServe(options);
|
|
856
894
|
} catch (error) {
|
|
857
|
-
console.error("\n Error:", error);
|
|
895
|
+
console.error("\n Error:", formatCliError(error));
|
|
858
896
|
process.exit(1);
|
|
859
897
|
}
|
|
860
898
|
return;
|
|
@@ -896,12 +934,12 @@ async function main() {
|
|
|
896
934
|
case "generate": break;
|
|
897
935
|
}
|
|
898
936
|
} catch (error) {
|
|
899
|
-
console.error("\n Error:", error);
|
|
937
|
+
console.error("\n Error:", formatCliError(error));
|
|
900
938
|
process.exit(1);
|
|
901
939
|
}
|
|
902
940
|
}
|
|
903
941
|
if (isDirectRun()) main().catch((error) => {
|
|
904
|
-
console.error("Fatal error:", error);
|
|
942
|
+
console.error("Fatal error:", formatCliError(error));
|
|
905
943
|
process.exit(1);
|
|
906
944
|
});
|
|
907
945
|
function isDirectRun() {
|