@vizejs/vite-plugin-musea 0.500.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.
@@ -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-DENP7L3t.mjs";
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 };
@@ -1,2 +1,2 @@
1
- import { a as generateA11yJsonReport, i as generateA11yHtmlReport, n as resolveAxeSource, r as computeA11ySummary, t as MuseaA11yRunner } from "../a11y-DuFu75hl.mjs";
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 { a as waitForMountedPreview, i as observePreviewReady, n as buildVariantUrl } from "./utils-ChmPv0qc.mjs";
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
- constructor(options = {}) {
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
- for (const art of artFiles) for (const variant of art.variants) {
247
- if (variant.skipVrt) continue;
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 ctx = await (await chromium.launch({ headless: true })).newContext({ viewport: {
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: ctx
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, variant.name) : buildVariantUrl(baseUrl, art.path, variant.name);
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
- const result = await this.auditPage(page, art.path, variant.name);
274
- results.push(result);
281
+ return await this.auditPage(page, art.path, variantName);
275
282
  } catch (error) {
276
- results.push({
283
+ return {
277
284
  artPath: art.path,
278
- variantName: variant.name,
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-DuFu75hl.mjs.map
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, \"&amp;\")\n .replace(/</g, \"&lt;\")\n .replace(/>/g, \"&gt;\")\n .replace(/\"/g, \"&quot;\")\n .replace(/'/g, \"&#x27;\");\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
- export { waitForMountedPreview as a, observePreviewReady as i, buildVariantUrl as n, computeSummary as r, buildSnapshotName as t };
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=utils-ChmPv0qc.mjs.map
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":";;;AAGA,eAAsB,oBAAoB,MAA2B;CACnE,MAAM,KAAK,oBAAoB;EAC7B,OAAO,iBAAiB,YAAY,UAAU;GAC5C,IACE,MAAM,WAAW,UACjB,MAAM,WAAW,OAAO,SAAS,UACjC,MAAM,MAAM,SAAS,eAErB,QAAQ,IAAI,QAAQ,mBAAmB,IAAI;EAC/C,CAAC;CACH,CAAC;AACH;AAEA,eAAsB,sBAAsB,MAA2B;CACrE,MAAM,KAAK,sBAAsB,QAAQ,IAAI,QAAQ,iBAAiB,MAAM,MAAM,KAAA,GAAW,EAC3F,SAAS,IACX,CAAC;AACH;;;;;;ACNA,SAAgB,gBACd,SACA,SACA,aACA,kBAAkB,cACV;CACR,MAAM,cAAc,mBAAmB,OAAO;CAC9C,MAAM,iBAAiB,mBAAmB,WAAW;CACrD,MAAM,QAAQ,gBAAgB,QAAQ,cAAc,EAAE;CACtD,OAAO,GAAG,QAAQ,QAAQ,QAAQ,EAAE,EAAE,GAAG,QAAQ,GAAG,MAAM,KAAK,GAAG,cAAc,YAAY,WAAW;AACzG;;;;AAKA,SAAgB,kBACd,SACA,aACA,UACQ;CACR,MAAM,cAAc,KAAK,SAAS,SAAS,UAAU;CACrD,MAAM,eAAe,SAAS,QAAQ,GAAG,SAAS,MAAM,GAAG,SAAS;CACpE,OAAO,GAAG,uBAAuB,WAAW,EAAE,IAAI,uBAChD,WACF,EAAE,IAAI,uBAAuB,YAAY,EAAE;AAC7C;AAEA,SAAS,uBAAuB,OAAuB;CACrD,MAAM,UAAU,mBAAmB,KAAK;CACxC,OAAO,QAAQ,WAAW,IAAI,YAAY;AAC5C;;;;AAKA,SAAgB,eAAe,SAAsB,WAA+B;CAClF,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,KAAK,EAAE;CAC9C,OAAO;EACL,OAAO,QAAQ;EACf,QAAQ,QAAQ,QAAQ,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE;EACpD,QAAQ,QAAQ,QAAQ,MAAM,CAAC,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE;EACrD,KAAK,QAAQ,QAAQ,MAAM,EAAE,KAAK,EAAE;EACpC,SAAS;EACT;EACA,UAAU,KAAK,IAAI,IAAI;CACzB;AACF;;;ACpDA,SAAgB,wBAAwB,SAAqC;CAC3E,IAAI,YAAY,KAAA,KAAa,CAAC,OAAO,SAAS,OAAO,GACnD,OAAO;CAET,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,CAAC;AACxC;AAEA,SAAgB,cACd,UACA,kBACU;CACV,MAAM,OAAiB,CAAC;CACxB,KAAK,MAAM,OAAO,UAChB,KAAK,MAAM,WAAW,IAAI,UAAU;EAClC,IAAI,QAAQ,SACV;EAGF,MAAM,YAAY,QAAQ,MAAM,WAC5B,CAAC,QAAQ,KAAK,QAA0B,IACxC;EAEJ,KAAK,MAAM,YAAY,WACrB,KAAK,KAAK;GAAE;GAAK,aAAa,QAAQ;GAAM;EAAS,CAAC;CAE1D;CAEF,OAAO;AACT;AAEA,eAAsB,mBACpB,MACA,aACA,QACc;CACd,MAAM,UAAU,MAAM,KAAe,EAAE,QAAQ,KAAK,OAAO,SAAS,IAAI;CACxE,IAAI,eAAe;CAEnB,eAAe,YAA2B;EACxC,OAAO,MAAM;GACX,MAAM,WAAW;GACjB,MAAM,MAAM,KAAK;GACjB,IAAI,CAAC,KACH;GAEF,QAAQ,YAAY,MAAM,OAAO,GAAG;EACtC;CACF;CAEA,MAAM,gBAAgB,KAAK,IAAI,wBAAwB,WAAW,GAAG,KAAK,MAAM;CAChF,MAAM,QAAQ,IAAI,MAAM,KAAK,EAAE,QAAQ,cAAc,SAAS,UAAU,CAAC,CAAC;CAC1E,OAAO,QAAQ,QAAQ,WAAwB,WAAW,IAAI;AAChE;;;AC1DA,SAAgB,2BACd,gBAA+B,CAAC,GAChC,eAAyB,CAAC,GACX;CACf,MAAM,OAAO,CAAC,GAAG,cAAc,GAAI,cAAc,QAAQ,CAAC,CAAE;CAC5D,OAAO;EACL,UAAU;EACV,GAAG;EACH,GAAI,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,CAAC;CACpC;AACF;AAEA,SAAgB,eACd,UACA,gBAA+B,CAAC,GAChC,eAAyB,CAAC,GACR;CAClB,OAAO,SAAS,OAAO,2BAA2B,eAAe,YAAY,CAAC;AAChF"}
@@ -1,4 +1,4 @@
1
- import { l as MuseaVrtOptions } from "../index-ZFHsOEPD.mjs";
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;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cli/index.ts"],"mappings":";;;KAoCK,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,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"}
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"}
@@ -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-B-sFFEcK.mjs";
4
- import { a as normalizeVrtWorkerCount, i as MuseaVrtRunner, n as generateVrtJsonReport, o as normalizeSnapshotIdentity, r as generateVrtReport } from "../vrt-dFU3k2J6.mjs";
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() {