@vizejs/vite-plugin-musea 0.501.0 → 0.502.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 +2 -1
- package/dist/cli/index.d.mts.map +1 -1
- package/dist/cli/index.mjs +28 -7
- package/dist/cli/index.mjs.map +1 -1
- package/dist/{index-DENP7L3t.d.mts → index-BXI8gTfW.d.mts} +7 -6
- package/dist/index-BXI8gTfW.d.mts.map +1 -0
- package/dist/{index-ZFHsOEPD.d.mts → index-CPq3wpG5.d.mts} +5 -1
- package/dist/index-CPq3wpG5.d.mts.map +1 -0
- package/dist/index.d.mts +3 -3
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +49 -14
- package/dist/index.mjs.map +1 -1
- package/dist/{options-B-sFFEcK.mjs → options-BRid4Hkx.mjs} +2 -2
- package/dist/{options-B-sFFEcK.mjs.map → options-BRid4Hkx.mjs.map} +1 -1
- package/dist/{vrt-nAWyjDmd.d.mts → vrt-CLASQfpd.d.mts} +2 -2
- package/dist/{vrt-nAWyjDmd.d.mts.map → vrt-CLASQfpd.d.mts.map} +1 -1
- package/dist/{vrt-dFU3k2J6.mjs → vrt-DdWm07iR.mjs} +11 -43
- package/dist/vrt-DdWm07iR.mjs.map +1 -0
- 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/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-BXI8gTfW.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-CPq3wpG5.mjs";
|
|
2
2
|
|
|
3
3
|
//#region src/cli/index.d.ts
|
|
4
4
|
type Command = "run" | "approve" | "clean" | "generate" | "serve";
|
|
@@ -12,6 +12,7 @@ interface CliOptions {
|
|
|
12
12
|
thresholdProvided: boolean;
|
|
13
13
|
workers: number;
|
|
14
14
|
workersProvided: boolean;
|
|
15
|
+
browserArgs: string[];
|
|
15
16
|
json: boolean;
|
|
16
17
|
ci: boolean;
|
|
17
18
|
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":";;;KAqCK,OAAA;AAAA,UAEY,UAAA;EACf,OAAA,EAAS,OAAA;EACT,MAAA;EACA,MAAA;EACA,SAAA;EACA,MAAA;EACA,SAAA;EACA,iBAAA;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-BRid4Hkx.mjs";
|
|
4
|
+
import { a as normalizeSnapshotIdentity, i as MuseaVrtRunner, n as generateVrtJsonReport, r as generateVrtReport } from "../vrt-DdWm07iR.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) {
|
|
@@ -54,6 +60,10 @@ function createVrtOptions(options) {
|
|
|
54
60
|
};
|
|
55
61
|
const workers = options.workersProvided ? options.workers : configured.workers;
|
|
56
62
|
if (workers !== void 0) vrtOptions.workers = normalizeVrtWorkerCount(workers);
|
|
63
|
+
if (options.browserArgs.length > 0) vrtOptions.launchOptions = {
|
|
64
|
+
...configured.launchOptions,
|
|
65
|
+
args: [...configured.launchOptions?.args ?? [], ...options.browserArgs]
|
|
66
|
+
};
|
|
57
67
|
return vrtOptions;
|
|
58
68
|
}
|
|
59
69
|
/**
|
|
@@ -73,7 +83,7 @@ function withoutA11y(vrt) {
|
|
|
73
83
|
}
|
|
74
84
|
/** Options object `musea-vrt --a11y` passes to `MuseaA11yRunner`. */
|
|
75
85
|
function createA11yRunner(options, Runner) {
|
|
76
|
-
return new Runner(options.vrt?.a11y);
|
|
86
|
+
return new Runner(options.vrt?.a11y, createVrtOptions(options).launchOptions);
|
|
77
87
|
}
|
|
78
88
|
async function runVrt(options, artFiles) {
|
|
79
89
|
const totalVariants = artFiles.reduce((sum, art) => sum + art.variants.filter((v) => !v.skipVrt).length, 0);
|
|
@@ -680,6 +690,7 @@ function parseArgs(args) {
|
|
|
680
690
|
thresholdProvided: false,
|
|
681
691
|
workers: 1,
|
|
682
692
|
workersProvided: false,
|
|
693
|
+
browserArgs: [],
|
|
683
694
|
json: false,
|
|
684
695
|
ci: false,
|
|
685
696
|
a11y: false,
|
|
@@ -743,6 +754,12 @@ function parseArgs(args) {
|
|
|
743
754
|
case "--a11y":
|
|
744
755
|
options.a11y = true;
|
|
745
756
|
break;
|
|
757
|
+
case "--browser-arg": {
|
|
758
|
+
const browserArg = args[++i];
|
|
759
|
+
if (browserArg === void 0) throw new Error("--browser-arg requires a value");
|
|
760
|
+
options.browserArgs.push(browserArg);
|
|
761
|
+
break;
|
|
762
|
+
}
|
|
746
763
|
case "-b":
|
|
747
764
|
case "--base-url":
|
|
748
765
|
options.baseUrl = args[++i] || "http://localhost:5173";
|
|
@@ -792,6 +809,7 @@ Options:
|
|
|
792
809
|
--json Output JSON report instead of HTML
|
|
793
810
|
--ci CI mode - exit with non-zero code on failures
|
|
794
811
|
--a11y Run accessibility audits alongside VRT
|
|
812
|
+
--browser-arg <arg> Add a Chromium launch argument (repeatable)
|
|
795
813
|
-h, --help Show this help message
|
|
796
814
|
|
|
797
815
|
Examples:
|
|
@@ -813,6 +831,9 @@ Examples:
|
|
|
813
831
|
# Capture variants concurrently
|
|
814
832
|
musea-vrt --workers 8
|
|
815
833
|
|
|
834
|
+
# Stabilize Chromium rasterization
|
|
835
|
+
musea-vrt --browser-arg --disable-partial-raster
|
|
836
|
+
|
|
816
837
|
# Approve all failed snapshots
|
|
817
838
|
musea-vrt approve
|
|
818
839
|
|
|
@@ -842,7 +863,7 @@ async function main() {
|
|
|
842
863
|
try {
|
|
843
864
|
await runGenerate(options);
|
|
844
865
|
} catch (error) {
|
|
845
|
-
console.error("\n Error:", error);
|
|
866
|
+
console.error("\n Error:", formatCliError(error));
|
|
846
867
|
process.exit(1);
|
|
847
868
|
}
|
|
848
869
|
return;
|
|
@@ -854,7 +875,7 @@ async function main() {
|
|
|
854
875
|
try {
|
|
855
876
|
await runServe(options);
|
|
856
877
|
} catch (error) {
|
|
857
|
-
console.error("\n Error:", error);
|
|
878
|
+
console.error("\n Error:", formatCliError(error));
|
|
858
879
|
process.exit(1);
|
|
859
880
|
}
|
|
860
881
|
return;
|
|
@@ -896,12 +917,12 @@ async function main() {
|
|
|
896
917
|
case "generate": break;
|
|
897
918
|
}
|
|
898
919
|
} catch (error) {
|
|
899
|
-
console.error("\n Error:", error);
|
|
920
|
+
console.error("\n Error:", formatCliError(error));
|
|
900
921
|
process.exit(1);
|
|
901
922
|
}
|
|
902
923
|
}
|
|
903
924
|
if (isDirectRun()) main().catch((error) => {
|
|
904
|
-
console.error("Fatal error:", error);
|
|
925
|
+
console.error("Fatal error:", formatCliError(error));
|
|
905
926
|
process.exit(1);
|
|
906
927
|
});
|
|
907
928
|
function isDirectRun() {
|