@opsydyn/elysia-spectral 0.5.2 → 1.1.1

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [1.1.1](https://github.com/opsydyn/elysia-spectral/compare/v1.1.0...v1.1.1) (2026-04-28)
+
+
+### Bug Fixes
+
+* trigger release pipeline ([50a07c1](https://github.com/opsydyn/elysia-spectral/commit/50a07c172eac778355d66c942affe9dcccc048b7))
+
+## [1.1.0](https://github.com/opsydyn/elysia-spectral/compare/v1.0.0...v1.1.0) (2026-04-28)
+
+
+### Features
+
+* add HTML dashboard endpoint ([beba3cc](https://github.com/opsydyn/elysia-spectral/commit/beba3cc529960c443cb536dd3f4ce33ecb589cb8))
+* redesign lint dashboard with monospace UI and interactive filters ([23ab4bb](https://github.com/opsydyn/elysia-spectral/commit/23ab4bbfde3b55074101256814f10daeaae0097b))
+
+
+### Bug Fixes
+
+* stamp result.durationMs before threshold enforcement ([cafcf46](https://github.com/opsydyn/elysia-spectral/commit/cafcf4635bf72b0eb9848352901ec5725eca9501))
+
+## [1.0.0](https://github.com/opsydyn/elysia-spectral/compare/v0.5.2...v1.0.0) (2026-04-15)
+
+
+### ⚠ BREAKING CHANGES
+
+* result.artifacts paths are now relative (e.g. "./artifacts/openapi-lint.json") rather than absolute. Callers that used the path directly to open the file should resolve it with path.resolve().
+
+### Features
+
+* add durationMs, failOn to LintRunResult; relativise artifact paths ([421a20f](https://github.com/opsydyn/elysia-spectral/commit/421a20f6bf655432bceff8369c63bf4762edbc24))
+
 ## [0.5.2](https://github.com/opsydyn/elysia-spectral/compare/v0.5.1...v0.5.2) (2026-04-15)
 
 

package/README.md

@@ -63,6 +63,35 @@ Current package scope:
 - reusable runtime for CI and tests
 - opt-in healthcheck endpoint for cached and fresh runs
 
+## Data flow
+
+```mermaid
+flowchart TD
+    A["Elysia routes\n(TypeScript + t.Object schemas)"]
+    B["@elysiajs/openapi\ngenerates OpenAPI spec at runtime"]
+    C["PublicSpecProvider\nfetches /openapi/json"]
+    D["lintOpenApi\nSpectral rules engine"]
+    E["LintRunResult\n{ ok, source, summary, findings }"]
+
+    F["Console output"]
+    G["JSON report\nopenapi-lint.json"]
+    H["OpenAPI snapshot\n*.open-api.json"]
+    I["SARIF\nGitHub code scanning"]
+    J["JUnit\nCI test reporters"]
+    K["Bruno collection\n.yml / .json"]
+
+    A -->|"route schemas are\nthe source of truth"| B
+    B -->|"spec JSON"| C
+    C -->|"spec JSON"| D
+    D -->|"findings + summary"| E
+    E --> F
+    E --> G
+    E --> H
+    E --> I
+    E --> J
+    E --> K
+```
+
 ## Tutorial
 
 ### Add OpenAPI linting to an Elysia app
@@ -153,6 +182,10 @@ bun run src/index.ts
 - `./artifacts/openapi-lint.json` contains the full lint result
 - `./<package-name>.open-api.json` contains the generated OpenAPI snapshot
 
+A passing run:
+
+![OpenAPI lint pass banner](ship-it.png)
+
 If startup fails, the terminal output includes:
 
 - the failing rule code
@@ -160,6 +193,8 @@ If startup fails, the terminal output includes:
 - a fix hint when one is known
 - a spec reference in `open-api.json#/json/pointer` form
 
+![OpenAPI lint error output](errrors.png)
+
 ### Choose a preset
 
 Three first-party presets are available. Import them directly or set `preset` in the plugin options.

package/dist/core/index.d.mts

@@ -1,2 +1,2 @@
-import { a as createOpenApiLintRuntime, c as ResolvedRulesetCandidate, d as RulesetResolverContext, f as RulesetResolverInput, g as lintOpenApi, h as loadRuleset, i as OpenApiLintArtifactWriteError, l as RulesetLoadError, m as loadResolvedRuleset, n as enforceThreshold, o as LoadResolvedRulesetOptions, p as defaultRulesetResolvers, r as shouldFail, s as LoadedRuleset, t as OpenApiLintThresholdError, u as RulesetResolver } from "../index-11HnbLDN.mjs";
+import { a as createOpenApiLintRuntime, c as ResolvedRulesetCandidate, d as RulesetResolverContext, f as RulesetResolverInput, g as lintOpenApi, h as loadRuleset, i as OpenApiLintArtifactWriteError, l as RulesetLoadError, m as loadResolvedRuleset, n as enforceThreshold, o as LoadResolvedRulesetOptions, p as defaultRulesetResolvers, r as shouldFail, s as LoadedRuleset, t as OpenApiLintThresholdError, u as RulesetResolver } from "../index-Dx83hCT9.mjs";
 export { LoadResolvedRulesetOptions, LoadedRuleset, OpenApiLintArtifactWriteError, OpenApiLintThresholdError, ResolvedRulesetCandidate, RulesetLoadError, RulesetResolver, RulesetResolverContext, RulesetResolverInput, createOpenApiLintRuntime, defaultRulesetResolvers, enforceThreshold, lintOpenApi, loadResolvedRuleset, loadRuleset, shouldFail };

package/dist/core/index.mjs

@@ -1,2 +1,2 @@
-import { a as enforceThreshold, d as RulesetLoadError, f as defaultRulesetResolvers, g as lintOpenApi, i as OpenApiLintThresholdError, m as loadRuleset, n as createOpenApiLintRuntime, o as shouldFail, p as loadResolvedRuleset, t as OpenApiLintArtifactWriteError } from "../core-DTKNy6TU.mjs";
+import { a as enforceThreshold, d as RulesetLoadError, f as defaultRulesetResolvers, g as lintOpenApi, i as OpenApiLintThresholdError, m as loadRuleset, n as createOpenApiLintRuntime, o as shouldFail, p as loadResolvedRuleset, t as OpenApiLintArtifactWriteError } from "../core-BLJeXQ15.mjs";
 export { OpenApiLintArtifactWriteError, OpenApiLintThresholdError, RulesetLoadError, createOpenApiLintRuntime, defaultRulesetResolvers, enforceThreshold, lintOpenApi, loadResolvedRuleset, loadRuleset, shouldFail };

package/dist/{core-DTKNy6TU.mjs → core-BLJeXQ15.mjs}

@@ -55,6 +55,8 @@ const normalizeFindings = (diagnostics, spec) => {
 		ok: summary.error === 0,
 		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
 		source: "manual",
+		failOn: "error",
+		durationMs: null,
 		summary,
 		findings
 	};
@@ -1198,19 +1200,21 @@ const createOpenApiLintRuntime = (options = {}) => {
 					else if (loadedRuleset.source?.path) reporter.ruleset(`OpenAPI lint loaded ruleset ${loadedRuleset.source.path}.`);
 					const result = await lintOpenApi(spec, loadedRuleset.ruleset);
 					result.source = source;
-					result.ok = !shouldFail(result, options.failOn ?? "error");
+					result.failOn = options.failOn ?? "error";
+					result.ok = !shouldFail(result, result.failOn);
 					await writeOutputSinks(result, spec, options, artifactWriteFailureMode);
 					runtime.latest = result;
+					finalizeRuntimeRun(runtime, startedAt);
+					result.durationMs = runtime.durationMs;
 					reporter.complete("OpenAPI lint completed.");
 					enforceThreshold(result, options.failOn ?? "error");
 					runtime.status = "passed";
 					runtime.lastSuccess = result;
-					finalizeRuntimeRun(runtime, startedAt);
 					return result;
 				} catch (error) {
 					runtime.status = "failed";
 					runtime.lastFailure = toRuntimeFailure(error);
-					finalizeRuntimeRun(runtime, startedAt);
+					if (runtime.durationMs === null) finalizeRuntimeRun(runtime, startedAt);
 					throw error;
 				}
 			})();
@@ -1264,9 +1268,18 @@ const writeOutputSinks = async (result, spec, options, artifactWriteFailureMode)
 		throw error;
 	}
 };
+const relativiseArtifacts = (artifacts) => {
+	const cwd = process.cwd();
+	const result = {};
+	for (const [key, value] of Object.entries(artifacts)) if (typeof value === "string" && path.isAbsolute(value)) {
+		const rel = path.relative(cwd, value);
+		result[key] = rel.startsWith(".") ? rel : `./${rel}`;
+	} else result[key] = value;
+	return result;
+};
 const mergeArtifacts = (current, next) => ({
 	...current,
-	...next
+	...relativiseArtifacts(next)
 });
 const resolveStartupMode = (options = {}) => {
 	if (options.startup?.mode) return options.startup.mode;

package/dist/{index-11HnbLDN.d.mts → index-Dx83hCT9.d.mts}

@@ -36,6 +36,9 @@ type SpectralPluginOptions = {
   healthcheck?: false | {
     path?: string;
   };
+  dashboard?: false | {
+    path?: string;
+  };
   output?: {
     console?: boolean;
     jsonReportPath?: string;
@@ -85,6 +88,8 @@ type LintRunResult = {
   ok: boolean;
   generatedAt: string;
   source: LintRunSource;
+  failOn: SeverityThreshold;
+  durationMs: number | null;
   summary: {
     error: number;
     warn: number;

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { A as SpectralLogger, C as OpenApiLintRuntime, D as OpenApiLintSinkContext, E as OpenApiLintSink, M as StartupLintMode, O as PresetName, S as OpenApiLintArtifacts, T as OpenApiLintRuntimeStatus, _ as ArtifactWriteFailureMode, a as createOpenApiLintRuntime, b as LintRunSource, c as ResolvedRulesetCandidate, d as RulesetResolverContext, f as RulesetResolverInput, g as lintOpenApi, h as loadRuleset, i as OpenApiLintArtifactWriteError, j as SpectralPluginOptions, k as SeverityThreshold, l as RulesetLoadError, m as loadResolvedRuleset, n as enforceThreshold, o as LoadResolvedRulesetOptions, p as defaultRulesetResolvers, r as shouldFail, s as LoadedRuleset, t as OpenApiLintThresholdError, u as RulesetResolver, v as LintFinding, w as OpenApiLintRuntimeFailure, x as LintSeverity, y as LintRunResult } from "./index-11HnbLDN.mjs";
+import { A as SpectralLogger, C as OpenApiLintRuntime, D as OpenApiLintSinkContext, E as OpenApiLintSink, M as StartupLintMode, O as PresetName, S as OpenApiLintArtifacts, T as OpenApiLintRuntimeStatus, _ as ArtifactWriteFailureMode, a as createOpenApiLintRuntime, b as LintRunSource, c as ResolvedRulesetCandidate, d as RulesetResolverContext, f as RulesetResolverInput, g as lintOpenApi, h as loadRuleset, i as OpenApiLintArtifactWriteError, j as SpectralPluginOptions, k as SeverityThreshold, l as RulesetLoadError, m as loadResolvedRuleset, n as enforceThreshold, o as LoadResolvedRulesetOptions, p as defaultRulesetResolvers, r as shouldFail, s as LoadedRuleset, t as OpenApiLintThresholdError, u as RulesetResolver, v as LintFinding, w as OpenApiLintRuntimeFailure, x as LintSeverity, y as LintRunResult } from "./index-Dx83hCT9.mjs";
 import { RulesetDefinition } from "@stoplight/spectral-core";
 import { Elysia } from "elysia";
 

package/dist/index.mjs

@@ -1,5 +1,212 @@
-import { a as enforceThreshold, c as strict, d as RulesetLoadError, f as defaultRulesetResolvers, g as lintOpenApi, h as recommended, i as OpenApiLintThresholdError, l as server, m as loadRuleset, n as createOpenApiLintRuntime, o as shouldFail, p as loadResolvedRuleset, r as resolveStartupMode, s as presets, t as OpenApiLintArtifactWriteError, u as resolveReporter } from "./core-DTKNy6TU.mjs";
+import { a as enforceThreshold, c as strict, d as RulesetLoadError, f as defaultRulesetResolvers, g as lintOpenApi, h as recommended, i as OpenApiLintThresholdError, l as server, m as loadRuleset, n as createOpenApiLintRuntime, o as shouldFail, p as loadResolvedRuleset, r as resolveStartupMode, s as presets, t as OpenApiLintArtifactWriteError, u as resolveReporter } from "./core-BLJeXQ15.mjs";
 import { Elysia } from "elysia";
+//#region src/output/dashboard.ts
+const renderDashboard = (input) => {
+	const { result, threshold, cached, error, refreshPath } = input;
+	const body = error && !result ? renderError(error) : result ? renderReport(result, threshold, cached) : renderEmpty();
+	return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width,initial-scale=1" />
+<title>Elysia Spectral Lint Dashboard</title>
+<style>${styles}</style>
+</head>
+<body>
+<header>
+  <div class="brand">
+    <span class="dot" aria-hidden="true"></span>
+    <h1>Elysia Spectral Lint</h1>
+  </div>
+  <div class="actions">
+    <kbd title="Press r to re-run">r</kbd>
+    <a class="refresh" href="${`${escapeAttr(refreshPath)}?fresh=1`}" data-refresh>Re-run</a>
+  </div>
+</header>
+<main>${body}</main>
+<script>${script}<\/script>
+</body>
+</html>`;
+};
+const renderEmpty = () => `<p class="empty">No lint result yet. <a href="?fresh=1">Run now</a>.</p>`;
+const renderError = (message) => `<div class="banner banner-fail"><strong>Lint runtime error</strong><p>${escapeText(message)}</p></div>`;
+const renderReport = (result, threshold, cached) => {
+	return `${result.ok ? `<div class="banner banner-pass"><strong>Pass</strong> at threshold "${escapeText(threshold)}"<span class="tagline">SPEC IS TIGHT, SHIP IT RIGHT</span></div>` : `<div class="banner banner-fail"><strong>Fail</strong> at threshold "${escapeText(threshold)}"</div>`}${`
+<dl class="meta">
+  <div><dt>Generated</dt><dd>${escapeText(result.generatedAt)}<span class="muted-line" data-relative-time="${escapeAttr(result.generatedAt)}"></span></dd></div>
+  <div><dt>Source</dt><dd>${escapeText(result.source)}</dd></div>
+  <div><dt>Duration</dt><dd>${result.durationMs ?? "—"} ms</dd></div>
+  <div><dt>Cached</dt><dd>${cached ? "yes" : "no"}</dd></div>
+</dl>`}${`
+<ul class="summary" data-filter-bar>
+  <li class="sev-all is-active" data-filter="all" tabindex="0"><span>${result.summary.total}</span> total</li>
+  <li class="sev-error" data-filter="error" tabindex="0"><span>${result.summary.error}</span> error</li>
+  <li class="sev-warn" data-filter="warn" tabindex="0"><span>${result.summary.warn}</span> warn</li>
+  <li class="sev-info" data-filter="info" tabindex="0"><span>${result.summary.info}</span> info</li>
+  <li class="sev-hint" data-filter="hint" tabindex="0"><span>${result.summary.hint}</span> hint</li>
+</ul>`}${renderArtifacts(result.artifacts)}${renderFindings(result.findings)}`;
+};
+const renderArtifacts = (artifacts) => {
+	if (!artifacts || Object.keys(artifacts).length === 0) return "";
+	return `<section><h2>Artifacts</h2><ul class="artifacts">${Object.entries(artifacts).map(([key, value]) => `<li><code>${escapeText(key)}</code><span class="path">${escapeText(String(value))}</span><button class="copy" type="button" data-copy="${escapeAttr(String(value))}" title="Copy path">copy</button></li>`).join("")}</ul></section>`;
+};
+const renderFindings = (findings) => {
+	if (findings.length === 0) return `<section><h2>Findings</h2><p class="empty">No findings.</p></section>`;
+	const rows = findings.map((finding) => {
+		const operation = finding.operation?.method && finding.operation?.path ? `${finding.operation.method.toUpperCase()} ${finding.operation.path}` : "—";
+		const recommendation = finding.recommendation ? `<p class="recommendation">${escapeText(finding.recommendation)}</p>` : "";
+		const haystack = [
+			finding.code,
+			finding.message,
+			operation,
+			finding.documentPointer ?? ""
+		].join(" ").toLowerCase();
+		return `<tr class="sev-${finding.severity}" data-severity="${escapeAttr(finding.severity)}" data-haystack="${escapeAttr(haystack)}">
+  <td><span class="badge">${finding.severity}</span></td>
+  <td><code>${escapeText(finding.code)}</code></td>
+  <td>${escapeText(operation)}</td>
+  <td>${escapeText(finding.message)}${recommendation}<code class="pointer">${escapeText(finding.documentPointer ?? "")}</code></td>
+</tr>`;
+	}).join("");
+	return `<section>
+<div class="findings-head">
+  <h2>Findings (${findings.length})</h2>
+  <input type="search" data-search placeholder="Filter rule, path, message…" aria-label="Filter findings" />
+</div>
+<table>
+  <thead><tr><th>Severity</th><th>Rule</th><th>Operation</th><th>Detail</th></tr></thead>
+  <tbody data-findings>${rows}</tbody>
+</table>
+<p class="empty hidden" data-empty-findings>No findings match the current filter.</p>
+</section>`;
+};
+const escapeText = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+const escapeAttr = escapeText;
+const styles = `
+:root { color-scheme: light dark; --bg:#0b0d10; --fg:#e6e6e6; --muted:#8a93a0; --line:#1f242b; --surface:#11151a; --pass:#3ddc97; --fail:#ff5d5d; --warn:#f5a623; --info:#5dade2; --hint:#bdc3c7; --mono: ui-monospace, SFMono-Regular, "JetBrains Mono", Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+@media (prefers-color-scheme: light) { :root { --bg:#fafafa; --fg:#1a1a1a; --muted:#6b7380; --line:#e3e6eb; --surface:#ffffff; } }
+* { box-sizing: border-box; }
+body { margin:0; font-family: var(--mono); font-feature-settings: "calt" 0, "liga" 0, "ss01"; background:var(--bg); color:var(--fg); font-size:13px; line-height:1.5; }
+header { position:sticky; top:0; z-index:10; display:flex; align-items:center; justify-content:space-between; padding:12px 24px; border-bottom:1px solid var(--line); background:color-mix(in srgb, var(--bg) 92%, transparent); backdrop-filter: blur(8px); }
+.brand { display:flex; align-items:center; gap:10px; }
+.dot { width:8px; height:8px; border-radius:50%; background:var(--pass); box-shadow:0 0 0 3px color-mix(in srgb, var(--pass) 25%, transparent); }
+h1 { margin:0; font-size:13px; font-weight:600; letter-spacing:.02em; text-transform:uppercase; }
+.actions { display:flex; align-items:center; gap:10px; }
+kbd { font-family:var(--mono); font-size:11px; padding:2px 6px; border:1px solid var(--line); border-bottom-width:2px; border-radius:4px; color:var(--muted); background:var(--surface); }
+.refresh { color:var(--fg); text-decoration:none; padding:6px 12px; border:1px solid var(--line); border-radius:6px; font-size:12px; font-family:var(--mono); background:var(--surface); transition:border-color .15s, transform .05s; }
+.refresh:hover { border-color:var(--muted); }
+.refresh:active { transform: translateY(1px); }
+main { padding:24px; max-width:1100px; margin:0 auto; }
+.banner { padding:12px 16px; border-radius:8px; margin-bottom:16px; font-size:13px; }
+.banner-pass { background: color-mix(in srgb, var(--pass) 14%, transparent); border:1px solid color-mix(in srgb, var(--pass) 60%, var(--line)); }
+.banner-fail { background: color-mix(in srgb, var(--fail) 14%, transparent); border:1px solid color-mix(in srgb, var(--fail) 60%, var(--line)); }
+.tagline { display:block; margin-top:6px; font-weight:700; letter-spacing:.12em; color:var(--pass); text-transform:uppercase; font-size:11px; }
+.meta { display:grid; grid-template-columns: repeat(auto-fit, minmax(180px,1fr)); gap:8px; margin:0 0 16px; padding:0; }
+.meta div { background:var(--surface); border:1px solid var(--line); border-radius:6px; padding:8px 12px; }
+.meta dt { color:var(--muted); font-size:10px; text-transform:uppercase; letter-spacing:.06em; margin-bottom:4px; }
+.meta dd { margin:0; font-size:12px; }
+.muted-line { display:block; color:var(--muted); font-size:11px; margin-top:2px; }
+.summary { list-style:none; padding:0; margin:0 0 24px; display:flex; gap:6px; flex-wrap:wrap; }
+.summary li { padding:6px 12px; border:1px solid var(--line); border-radius:999px; font-size:12px; color:var(--muted); cursor:pointer; user-select:none; transition:border-color .12s, background .12s; }
+.summary li:hover { border-color:var(--muted); }
+.summary li:focus { outline:2px solid color-mix(in srgb, var(--info) 60%, transparent); outline-offset:2px; }
+.summary li.is-active { background: color-mix(in srgb, var(--fg) 8%, transparent); border-color:var(--muted); color:var(--fg); }
+.summary li span { color:var(--fg); font-weight:600; margin-right:6px; }
+.summary .sev-error span { color:var(--fail); }
+.summary .sev-warn span { color:var(--warn); }
+.summary .sev-info span { color:var(--info); }
+section { margin-top:24px; }
+h2 { font-size:11px; text-transform:uppercase; letter-spacing:.06em; color:var(--muted); margin:0 0 12px; font-weight:600; }
+.findings-head { display:flex; align-items:center; justify-content:space-between; gap:12px; margin-bottom:8px; }
+.findings-head h2 { margin:0; }
+[data-search] { font-family:var(--mono); font-size:12px; padding:6px 10px; min-width:240px; background:var(--surface); color:var(--fg); border:1px solid var(--line); border-radius:6px; }
+[data-search]:focus { outline:none; border-color:var(--muted); }
+.artifacts { list-style:none; padding:0; margin:0; }
+.artifacts li { display:flex; align-items:center; gap:12px; padding:6px 0; border-bottom:1px solid var(--line); font-size:12px; }
+.artifacts code { color:var(--muted); min-width:160px; }
+.artifacts .path { flex:1; word-break:break-all; }
+.copy { font-family:var(--mono); font-size:11px; padding:2px 8px; border:1px solid var(--line); background:var(--surface); color:var(--muted); border-radius:4px; cursor:pointer; }
+.copy:hover { color:var(--fg); border-color:var(--muted); }
+.copy.copied { color:var(--pass); border-color:var(--pass); }
+table { width:100%; border-collapse:collapse; font-size:12px; }
+th, td { text-align:left; padding:8px 12px; border-bottom:1px solid var(--line); vertical-align:top; }
+th { color:var(--muted); font-weight:500; font-size:10px; text-transform:uppercase; letter-spacing:.06em; }
+tbody tr:hover { background: color-mix(in srgb, var(--fg) 4%, transparent); }
+tr.is-hidden { display:none; }
+.badge { display:inline-block; padding:2px 8px; border-radius:4px; font-size:10px; text-transform:uppercase; letter-spacing:.06em; font-family:var(--mono); }
+.sev-error .badge { background: color-mix(in srgb, var(--fail) 22%, transparent); color:var(--fail); }
+.sev-warn .badge { background: color-mix(in srgb, var(--warn) 22%, transparent); color:var(--warn); }
+.sev-info .badge { background: color-mix(in srgb, var(--info) 22%, transparent); color:var(--info); }
+.sev-hint .badge { background: color-mix(in srgb, var(--hint) 22%, transparent); color:var(--hint); }
+.recommendation { margin:4px 0 0; color:var(--muted); font-size:11px; }
+.pointer { display:block; margin-top:4px; color:var(--muted); font-size:11px; }
+.empty { color:var(--muted); font-size:12px; }
+.hidden { display:none; }
+`;
+const script = `
+(() => {
+  const rel = (iso) => {
+    const t = Date.parse(iso); if (Number.isNaN(t)) return '';
+    const s = Math.round((Date.now() - t) / 1000);
+    if (s < 60) return s + 's ago';
+    if (s < 3600) return Math.round(s/60) + 'm ago';
+    if (s < 86400) return Math.round(s/3600) + 'h ago';
+    return Math.round(s/86400) + 'd ago';
+  };
+  for (const el of document.querySelectorAll('[data-relative-time]')) {
+    el.textContent = rel(el.getAttribute('data-relative-time'));
+  }
+
+  const rows = Array.from(document.querySelectorAll('[data-findings] tr'));
+  const search = document.querySelector('[data-search]');
+  const empty = document.querySelector('[data-empty-findings]');
+  const chips = Array.from(document.querySelectorAll('[data-filter]'));
+  let activeSeverity = 'all';
+  let query = '';
+
+  const apply = () => {
+    let visible = 0;
+    for (const tr of rows) {
+      const sev = tr.getAttribute('data-severity');
+      const hay = tr.getAttribute('data-haystack') || '';
+      const sevOk = activeSeverity === 'all' || sev === activeSeverity;
+      const qOk = !query || hay.includes(query);
+      const show = sevOk && qOk;
+      tr.classList.toggle('is-hidden', !show);
+      if (show) visible += 1;
+    }
+    if (empty) empty.classList.toggle('hidden', visible !== 0 || rows.length === 0);
+  };
+
+  for (const chip of chips) {
+    const select = () => {
+      activeSeverity = chip.getAttribute('data-filter') || 'all';
+      for (const c of chips) c.classList.toggle('is-active', c === chip);
+      apply();
+    };
+    chip.addEventListener('click', select);
+    chip.addEventListener('keydown', (e) => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); select(); } });
+  }
+
+  if (search) {
+    search.addEventListener('input', () => { query = search.value.trim().toLowerCase(); apply(); });
+  }
+
+  for (const btn of document.querySelectorAll('[data-copy]')) {
+    btn.addEventListener('click', async () => {
+      const value = btn.getAttribute('data-copy') || '';
+      try { await navigator.clipboard.writeText(value); btn.classList.add('copied'); btn.textContent = 'copied'; setTimeout(() => { btn.classList.remove('copied'); btn.textContent = 'copy'; }, 1200); } catch {}
+    });
+  }
+
+  document.addEventListener('keydown', (e) => {
+    if (e.target && (e.target.tagName === 'INPUT' || e.target.tagName === 'TEXTAREA')) return;
+    if (e.key === 'r') { const link = document.querySelector('[data-refresh]'); if (link) link.click(); }
+    if (e.key === '/' && search) { e.preventDefault(); search.focus(); }
+  });
+})();
+`;
+//#endregion
 //#region src/plugin.ts
 const spectralPlugin = (options = {}) => {
 	const runtime = createOpenApiLintRuntime(options);
@@ -79,6 +286,52 @@ const spectralPlugin = (options = {}) => {
 			summary: "OpenAPI lint healthcheck"
 		} });
 	}
+	if (options.dashboard) {
+		const dashboardPath = options.dashboard.path ?? "/__openapi/dashboard";
+		plugin = plugin.get(dashboardPath, async ({ request, set }) => {
+			const fresh = new URL(request.url).searchParams.get("fresh") === "1";
+			const threshold = options.failOn ?? "error";
+			const currentApp = hostAppRef.current;
+			set.headers["content-type"] = "text/html; charset=utf-8";
+			if (!currentApp) {
+				set.status = 503;
+				return renderDashboard({
+					result: null,
+					threshold,
+					cached: false,
+					error: "OpenAPI lint runtime is not initialized yet.",
+					refreshPath: dashboardPath
+				});
+			}
+			try {
+				const usedCache = !fresh && runtime.latest !== null;
+				return renderDashboard({
+					result: usedCache ? runtime.latest : await runtime.run(currentApp, "manual"),
+					threshold,
+					cached: usedCache,
+					refreshPath: dashboardPath
+				});
+			} catch (error) {
+				if (error instanceof OpenApiLintThresholdError) return renderDashboard({
+					result: error.result,
+					threshold,
+					cached: false,
+					refreshPath: dashboardPath
+				});
+				set.status = 500;
+				return renderDashboard({
+					result: null,
+					threshold,
+					cached: false,
+					error: error instanceof Error ? error.message : String(error),
+					refreshPath: dashboardPath
+				});
+			}
+		}, { detail: {
+			hide: true,
+			summary: "OpenAPI lint dashboard"
+		} });
+	}
 	return plugin;
 };
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opsydyn/elysia-spectral",
-  "version": "0.5.2",
+  "version": "1.1.1",
   "description": "Thin Elysia plugin that lints generated OpenAPI documents with Spectral.",
   "packageManager": "bun@1.3.11",
   "publishConfig": {
@@ -38,7 +38,8 @@
     "build": "tsdown",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
-    "test:watch": "bun test --watch"
+    "test:watch": "bun test --watch",
+    "bench": "RUN_BENCH=1 bun test ./test/benchmark"
   },
   "keywords": [
     "elysia",
@@ -82,6 +83,7 @@
     "@types/node": "^25.6.0",
     "@types/signale": "^1.4.7",
     "elysia": "^1.4.0",
+    "fast-check": "^4.7.0",
     "tsdown": "^0.21.8",
     "typescript": "^5.8.3"
   }