@qa-guru/allure-notifications-core

Allure 3 summary/results → native collage PNG buffer for line 6.0.*.

Native PNG (locked)

Production collage uses @napi-rs/canvas (Skia via N-API).

| | | |--|--| | Runtime PNG | @napi-rs/canvas only | | Not used | Playwright, Puppeteer, Sharp-as-draw, browser screenshot | | Playwright | tests only (elsewhere — builder e2e); never production render |

Depends on @qa-guru/allure-notifications-config + @qa-guru/allure-report-kit (CORNER_RATIO / TIER_GAP_RATIO, STATUS_COLORS.passed = #94ca66).

API

import { parseConfig } from "@qa-guru/allure-notifications-config";
import {
  loadQualityGateCollageData,
  loadReportAnalytics,
  renderCollagePng,
} from "@qa-guru/allure-notifications-core";

const config = parseConfig(/* config.json */);
const analytics = await loadReportAnalytics(config);
const qualityGates = await loadQualityGateCollageData(config);
const testsTable = await loadTestsTableCollageData(config);
const png: Buffer = await renderCollagePng(config, analytics, qualityGates, testsTable);

Quality gates (chart.profile=kit)

Kit-only tiles allureQualityGate / sonarQualityGate (type: qualityGate) render via renderQualityGatePng (kit IR) when chart.profile === "kit". Under profile: "default" they silent-skip (parse OK, no tile).

| Field | Role | |-------|------| | chart.allureQualityGatePath | KitQualityGateData JSON (explicit) | | (fallback) | <allureFolder>/widgets/kit-panels/allureQualityGate.json | | chart.sonarQualityGatePath | Sonar projectStatus JSON → kit sonarProjectStatusToQualityGateOptions |

Missing data when profile=kit and a QG tile is present → fail (QualityGateDataMissingError).

Tests table (chart.profile=kit)

Kit-only tile testsTable (type: testsTable) renders via renderTestsTablePng (canvas, name | status | trend | stability) when chart.profile === "kit". Under profile: "default" it silent-skips (parse OK, no tile).

| Field | Role | |-------|------| | chart.testsTablePath | KitTestsTableData JSON (explicit) | | (fallback) | <allureFolder>/widgets/kit-panels/testsTable.json |

Missing data when profile=kit and a testsTable tile is present → fail (TestsTableDataMissingError).

const testsTable = await loadTestsTableCollageData(config);
const png: Buffer = await renderCollagePng(config, analytics, qualityGates, testsTable);

Free-layout collage panels:

| Kind | Types | |------|--------| | Real (analytics) | currentStatus · testingPyramid · … · statusAgePyramid | | Kit-only (profile=kit) | qualityGate + id allureQualityGate | sonarQualityGate · testsTable | | Empty-state | Unknown tile types → themed card (No data yet), not silent-drop. Real panels keep the tile with an honest caption when their series is missing (No history data / No environment data / …). |

History source (Java HistoryAnalytics / ReportAnalyticsBuilder parity + A3 catalog series): Allure 3 history.jsonl via chart.historyPath or auto-discover next to report/results (and parents). Typical A3 lines carry status, duration/start/stop, environment, and labels — used for transitions, growth, coverage, problems-by-env, duration trend, age pyramid, and stability. Minimal history (id+status only) still drives transitions / growth / age; duration / environment / labeled coverage→empty captions. Without history → history panels show "No history data" (tile kept). stabilityDistribution can fall back to current *-result.json labels. pyramidFallback: "suites" → real SuitesPanel when no known layers.

Verify

pnpm --filter @qa-guru/allure-notifications-core test

Canon: monorepo docs/allure-notifications/canon/CANON.md + collage-cb870-free-dogfood-5.0.3.png.

Visual gate (dogfood vs Java CB-870)

| Check | Threshold | |-------|-----------| | Full-frame pixel match | sample 128×160, RGB Δ≤28, floor ≥0.90 | | aHash 16×16 | Hamming ≤40 / 256 | | Panel regions (pie / pyramid / durations) | crop→64×80, Δ≤30, floor ≥0.85 | | Palette | unit green #94ca66 count >500; outer bg #222 >100 |

Fail-closed when docs/allure-notifications/canon/ is present (zds/CI). Silent skip only outside zds (standalone GH checkout without that tree). Playwright is never used for PNG production render.