laxy-verify 0.1.0

package/dist/dev-server.js

@@ -0,0 +1,81 @@
+import { spawn } from "child_process";
+import http from "http";
+import { readFileSync, readdirSync } from "fs";
+import { join } from "path";
+import { detectRuntimeFromFiles, getDevCommandCandidates, parseProjectPackageJson, } from "./project-runtime.js";
+function waitForPort(port, timeoutMs = 30000) {
+    const start = Date.now();
+    return new Promise((resolve, reject) => {
+        const check = () => {
+            const req = http.get(`http://localhost:${port}`, (res) => {
+                res.resume();
+                resolve(res.statusCode ?? 0);
+            });
+            req.on("error", () => {
+                if (Date.now() - start > timeoutMs) {
+                    reject(new Error(`Dev server did not respond on port ${port} within ${timeoutMs / 1000}s`));
+                }
+                else {
+                    setTimeout(check, 1000);
+                }
+            });
+            req.setTimeout(3000, () => {
+                req.destroy();
+                if (Date.now() - start > timeoutMs) {
+                    reject(new Error(`Dev server timed out on port ${port}`));
+                }
+                else {
+                    setTimeout(check, 1000);
+                }
+            });
+        };
+        check();
+    });
+}
+export async function startDevServer(projectPath, port) {
+    const pkgContent = readFileSync(join(projectPath, "package.json"), "utf-8");
+    const packageJson = parseProjectPackageJson(pkgContent);
+    const candidateFiles = readdirSync(projectPath).filter((f) => !f.startsWith("."));
+    const runtime = detectRuntimeFromFiles(candidateFiles, packageJson);
+    const npm = process.platform === "win32" ? "npm.cmd" : "npm";
+    const npx = process.platform === "win32" ? "npx.cmd" : "npx";
+    const devCommands = getDevCommandCandidates(runtime, { port, npmCommand: npm, npxCommand: npx });
+    if (devCommands.length === 0) {
+        throw new Error("No dev server command found");
+    }
+    const command = devCommands[0];
+    const cmd = process.platform === "win32" ? `chcp 65001 > nul && ${command.cmd}` : command.cmd;
+    const child = spawn(cmd, command.args, {
+        cwd: projectPath,
+        shell: true,
+        env: { ...process.env, PORT: String(port) },
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    // Drain stdout/stderr to prevent buffer blocking
+    child.stdout?.resume();
+    child.stderr?.resume();
+    const statusCode = await waitForPort(port);
+    if (statusCode !== 200 && statusCode !== 304) {
+        child.kill();
+        throw new Error(`Dev server returned HTTP ${statusCode}. Check environment variables.`);
+    }
+    return {
+        process: child,
+        port,
+        url: `http://localhost:${port}`,
+    };
+}
+export function stopDevServer(handle) {
+    try {
+        if (process.platform === "win32") {
+            spawn("taskkill", ["/pid", String(handle.process.pid), "/f", "/t"], { shell: true });
+        }
+        else {
+            handle.process.kill("SIGTERM");
+        }
+    }
+    catch {
+        // already dead
+    }
+}
+//# sourceMappingURL=dev-server.js.map

package/dist/dev-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.js","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"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"}

package/dist/lighthouse-runner.d.ts

@@ -0,0 +1,10 @@
+import type { LighthouseScores } from "./verification.js";
+export interface LighthouseResult {
+    scores: LighthouseScores | null;
+    error?: string;
+}
+export declare function runLighthouse(projectPath: string, options?: {
+    port?: number;
+    runs?: number;
+    ciMode?: boolean;
+}): Promise<LighthouseResult>;

package/dist/lighthouse-runner.js

@@ -0,0 +1,99 @@
+import { execFileSync } from "child_process";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { startDevServer, stopDevServer } from "./dev-server.js";
+function findLhciManifest(tmpDir) {
+    // lhci stores results in .lighthouseci/ directory
+    const lhciDir = join(tmpDir, ".lighthouseci");
+    if (!existsSync(lhciDir))
+        return null;
+    const manifest = join(lhciDir, "manifest.json");
+    if (existsSync(manifest))
+        return manifest;
+    return null;
+}
+function parseLhciResults(projectPath) {
+    const manifest = findLhciManifest(projectPath);
+    if (!manifest)
+        return null;
+    try {
+        const entries = JSON.parse(readFileSync(manifest, "utf-8"));
+        if (!Array.isArray(entries) || entries.length === 0)
+            return null;
+        // Use the median run (middle entry) or last entry
+        const entry = entries[Math.floor(entries.length / 2)];
+        const reportPath = join(projectPath, ".lighthouseci", entry.jsonPath || "");
+        if (!existsSync(reportPath))
+            return null;
+        const report = JSON.parse(readFileSync(reportPath, "utf-8"));
+        const cat = report.categories;
+        if (!cat)
+            return null;
+        const score = (key) => Math.round((cat[key]?.score ?? 0) * 100);
+        return {
+            performance: score("performance"),
+            accessibility: score("accessibility"),
+            bestPractices: score("best-practices"),
+            seo: score("seo"),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export async function runLighthouse(projectPath, options = {}) {
+    const port = options.port ?? 3000;
+    const runs = options.runs ?? (options.ciMode ? 3 : 1);
+    let serverHandle = null;
+    try {
+        // Start dev server
+        serverHandle = await startDevServer(projectPath, port);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Dev server failed to start";
+        return { scores: null, error: msg };
+    }
+    try {
+        const url = `http://localhost:${port}`;
+        // Run lhci collect
+        const npx = process.platform === "win32" ? "npx.cmd" : "npx";
+        const lhciArgs = [
+            "-y", "@lhci/cli", "collect",
+            `--url=${url}`,
+            `--numberOfRuns=${runs}`,
+            "--settings.formFactor=desktop",
+            "--settings.screenEmulation.disabled=true",
+            "--settings.throttlingMethod=provided",
+            "--settings.onlyCategories=performance,accessibility,best-practices,seo",
+        ];
+        if (process.env.CI) {
+            lhciArgs.push("--settings.chromeFlags=--no-sandbox --disable-gpu --headless");
+        }
+        try {
+            execFileSync(npx, lhciArgs, {
+                cwd: projectPath,
+                timeout: 120000,
+                stdio: "pipe",
+                env: { ...process.env, LHCI_BUILD_CONTEXT__CURRENT_HASH: "cli" },
+            });
+        }
+        catch (err) {
+            // lhci collect may exit non-zero even on success, check for results
+            const scores = parseLhciResults(projectPath);
+            if (scores)
+                return { scores };
+            const msg = err instanceof Error ? err.message : "Lighthouse execution failed";
+            return { scores: null, error: `Lighthouse failed: ${msg.slice(0, 200)}` };
+        }
+        const scores = parseLhciResults(projectPath);
+        if (!scores) {
+            return { scores: null, error: "Lighthouse completed but produced no parseable results" };
+        }
+        return { scores };
+    }
+    finally {
+        if (serverHandle)
+            stopDevServer(serverHandle);
+    }
+}
+//# sourceMappingURL=lighthouse-runner.js.map

package/dist/lighthouse-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lighthouse-runner.js","sourceRoot":"","sources":["../src/lighthouse-runner.ts"],"names":[],"mappings":"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"}

package/dist/project-runtime.d.ts

@@ -0,0 +1,32 @@
+export interface ProjectPackageJson {
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+export interface RuntimeDetection {
+    packageJson: ProjectPackageJson | null;
+    hasPackageJson: boolean;
+    hasNext: boolean;
+    hasVite: boolean;
+    hasReactScripts: boolean;
+    hasIndexHtml: boolean;
+    hasNextConfig: boolean;
+    hasViteConfig: boolean;
+}
+export interface CommandSpec {
+    label: string;
+    cmd: string;
+    args: string[];
+}
+export declare function parseProjectPackageJson(content: string | null | undefined): ProjectPackageJson | null;
+export declare function detectRuntimeFromFiles(fileNamesInput: Iterable<string>, packageJson: ProjectPackageJson | null): RuntimeDetection;
+export declare function getBuildCommandCandidates(runtime: RuntimeDetection, options: {
+    npmCommand: string;
+    npxCommand: string;
+}): CommandSpec[];
+export declare function getDevCommandCandidates(runtime: RuntimeDetection, options: {
+    port: number;
+    npmCommand: string;
+    npxCommand: string;
+}): CommandSpec[];

package/dist/project-runtime.js

@@ -0,0 +1,99 @@
+function hasFile(fileNames, matcher) {
+    if (typeof matcher === "string") {
+        return fileNames.some((f) => f === matcher || f.endsWith(`/${matcher}`));
+    }
+    return fileNames.some((f) => matcher.test(f));
+}
+function getAllDependencies(pkg) {
+    return { ...(pkg?.dependencies || {}), ...(pkg?.devDependencies || {}) };
+}
+function hasScript(script) {
+    return typeof script === "string" && script.trim().length > 0;
+}
+function addCommand(commands, seen, label, cmd, args) {
+    const key = [cmd, ...args].join("\0");
+    if (seen.has(key))
+        return;
+    seen.add(key);
+    commands.push({ label, cmd, args });
+}
+export function parseProjectPackageJson(content) {
+    if (!content)
+        return null;
+    try {
+        const parsed = JSON.parse(content);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function detectRuntimeFromFiles(fileNamesInput, packageJson) {
+    const fileNames = Array.from(fileNamesInput);
+    const allDeps = getAllDependencies(packageJson);
+    const hasNextConfig = hasFile(fileNames, /(^|\/)next\.config\.(js|mjs|ts|cjs)$/);
+    const hasViteConfig = hasFile(fileNames, /(^|\/)vite\.config\.(js|mjs|ts|cjs)$/);
+    return {
+        packageJson,
+        hasPackageJson: hasFile(fileNames, "package.json") || packageJson !== null,
+        hasNextConfig,
+        hasViteConfig,
+        hasIndexHtml: hasFile(fileNames, "index.html"),
+        hasNext: hasNextConfig || Boolean(allDeps.next),
+        hasVite: hasViteConfig || Boolean(allDeps.vite),
+        hasReactScripts: Boolean(allDeps["react-scripts"]),
+    };
+}
+export function getBuildCommandCandidates(runtime, options) {
+    const commands = [];
+    const seen = new Set();
+    const scripts = runtime.packageJson?.scripts || {};
+    if (hasScript(scripts.build)) {
+        addCommand(commands, seen, "npm run build", options.npmCommand, ["run", "build"]);
+    }
+    if (runtime.hasNext) {
+        addCommand(commands, seen, "npx next build", options.npxCommand, ["-y", "next", "build"]);
+    }
+    if (runtime.hasVite) {
+        addCommand(commands, seen, "npx vite build", options.npxCommand, ["-y", "vite", "build"]);
+    }
+    if (runtime.hasReactScripts) {
+        addCommand(commands, seen, "npx react-scripts build", options.npxCommand, ["-y", "react-scripts", "build"]);
+    }
+    return commands;
+}
+export function getDevCommandCandidates(runtime, options) {
+    const commands = [];
+    const seen = new Set();
+    const scripts = runtime.packageJson?.scripts || {};
+    const port = String(options.port);
+    const devScript = scripts.dev;
+    const startScript = scripts.start;
+    if (hasScript(devScript)) {
+        if (runtime.hasNext || /\bnext\b/i.test(devScript)) {
+            addCommand(commands, seen, "npm run dev", options.npmCommand, ["run", "dev", "--", "-H", "0.0.0.0", "-p", port]);
+        }
+        else if (runtime.hasVite || /\bvite\b/i.test(devScript)) {
+            addCommand(commands, seen, "npm run dev", options.npmCommand, ["run", "dev", "--", "--host", "0.0.0.0", "--port", port]);
+        }
+        else {
+            addCommand(commands, seen, "npm run dev", options.npmCommand, ["run", "dev"]);
+        }
+    }
+    if (!hasScript(devScript) && hasScript(startScript)) {
+        addCommand(commands, seen, "npm run start", options.npmCommand, ["run", "start"]);
+    }
+    if (runtime.hasNext) {
+        addCommand(commands, seen, "npx next dev", options.npxCommand, ["-y", "next", "dev", "-H", "0.0.0.0", "-p", port]);
+    }
+    if (runtime.hasVite) {
+        addCommand(commands, seen, "npx vite", options.npxCommand, ["-y", "vite", "--host", "0.0.0.0", "--port", port]);
+    }
+    if (runtime.hasIndexHtml) {
+        addCommand(commands, seen, "npx serve", options.npxCommand, ["-y", "serve", "-l", port, "--no-clipboard"]);
+    }
+    return commands;
+}
+//# sourceMappingURL=project-runtime.js.map

package/dist/project-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-runtime.js","sourceRoot":"","sources":["../src/project-runtime.ts"],"names":[],"mappings":"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"}

package/dist/reporter.d.ts

@@ -0,0 +1,21 @@
+import type { VerificationGrade, LighthouseScores } from "./verification.js";
+import type { LaxyConfig } from "./config.js";
+import { getImprovementRecommendations } from "./verification.js";
+export interface VerifyReport {
+    grade: VerificationGrade;
+    build: {
+        success: boolean;
+        errors: string[];
+        duration: number;
+    };
+    lighthouse: {
+        scores: LighthouseScores | null;
+        error?: string;
+    };
+    thresholds: LaxyConfig["thresholds"];
+    recommendations: ReturnType<typeof getImprovementRecommendations>;
+}
+export declare function formatConsole(report: VerifyReport): string;
+export declare function formatJson(report: VerifyReport): string;
+export declare function formatMarkdown(report: VerifyReport): string;
+export declare function formatReport(report: VerifyReport, format: "console" | "json" | "md"): string;

package/dist/reporter.js

@@ -0,0 +1,100 @@
+const GRADE_LABELS = {
+    gold: { emoji: "\u{1F3C6}", label: "Gold" },
+    silver: { emoji: "\u2705", label: "Silver" },
+    bronze: { emoji: "\u{1F528}", label: "Bronze" },
+    unverified: { emoji: "\u26A0\uFE0F", label: "Unverified" },
+};
+export function formatConsole(report) {
+    const g = GRADE_LABELS[report.grade];
+    const lines = [];
+    lines.push("");
+    lines.push(`  Laxy Verify — ${g.emoji} ${g.label}`);
+    lines.push("  " + "=".repeat(40));
+    lines.push("");
+    // Build
+    lines.push(`  Build:          ${report.build.success ? "PASS" : "FAIL"} (${report.build.duration}ms)`);
+    // Lighthouse
+    if (report.lighthouse.scores) {
+        const s = report.lighthouse.scores;
+        const t = report.thresholds;
+        const check = (score, threshold) => score >= threshold ? "PASS" : "FAIL";
+        lines.push(`  Performance:    ${s.performance} (threshold ${t.performance}) ${check(s.performance, t.performance)}`);
+        lines.push(`  Accessibility:  ${s.accessibility} (threshold ${t.accessibility}) ${check(s.accessibility, t.accessibility)}`);
+        lines.push(`  SEO:            ${s.seo} (threshold ${t.seo}) ${check(s.seo, t.seo)}`);
+        lines.push(`  Best Practices: ${s.bestPractices} (threshold ${t.bestPractices}) ${check(s.bestPractices, t.bestPractices)}`);
+    }
+    else if (report.lighthouse.error) {
+        lines.push(`  Lighthouse:     SKIPPED — ${report.lighthouse.error}`);
+    }
+    lines.push("");
+    // Errors
+    if (report.build.errors.length > 0) {
+        lines.push("  Errors:");
+        for (const err of report.build.errors.slice(0, 5)) {
+            lines.push(`    - ${err}`);
+        }
+        lines.push("");
+    }
+    // Recommendations
+    if (report.recommendations.length > 0) {
+        lines.push("  Recommendations:");
+        for (const rec of report.recommendations.slice(0, 3)) {
+            lines.push(`    [${rec.priority}] ${rec.title}`);
+            lines.push(`      ${rec.action}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+export function formatJson(report) {
+    return JSON.stringify(report, null, 2);
+}
+export function formatMarkdown(report) {
+    const g = GRADE_LABELS[report.grade];
+    const lines = [];
+    lines.push(`<!-- laxy-verify -->`);
+    lines.push(`## Laxy Verify — ${g.label} ${g.emoji}`);
+    lines.push("");
+    lines.push("| Category | Score | Threshold | Status |");
+    lines.push("|----------|-------|-----------|--------|");
+    lines.push(`| Build | ${report.build.success ? "PASS" : "FAIL"} | — | ${report.build.success ? "\u2705" : "\u274C"} |`);
+    if (report.lighthouse.scores) {
+        const s = report.lighthouse.scores;
+        const t = report.thresholds;
+        const row = (label, score, threshold) => {
+            const pass = score >= threshold;
+            return `| ${label} | ${score} | ${threshold} | ${pass ? "\u2705" : "\u274C"} |`;
+        };
+        lines.push(row("Performance", s.performance, t.performance));
+        lines.push(row("Accessibility", s.accessibility, t.accessibility));
+        lines.push(row("SEO", s.seo, t.seo));
+        lines.push(row("Best Practices", s.bestPractices, t.bestPractices));
+    }
+    else if (report.lighthouse.error) {
+        lines.push(`| Lighthouse | SKIPPED | — | \u26A0\uFE0F |`);
+    }
+    lines.push("");
+    if (report.recommendations.length > 0) {
+        lines.push("<details><summary>Recommendations</summary>");
+        lines.push("");
+        for (const rec of report.recommendations) {
+            lines.push(`- **[${rec.priority}] ${rec.title}**: ${rec.action}`);
+        }
+        lines.push("");
+        lines.push("</details>");
+        lines.push("");
+    }
+    if (report.grade !== "gold") {
+        lines.push("> Want Gold? Add E2E tests with [Laxy](https://github.com/psungmin24/Laxy)");
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+export function formatReport(report, format) {
+    switch (format) {
+        case "json": return formatJson(report);
+        case "md": return formatMarkdown(report);
+        default: return formatConsole(report);
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"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"}

package/dist/verification.d.ts

@@ -0,0 +1,42 @@
+export type VerificationGrade = "gold" | "silver" | "bronze" | "unverified";
+export interface LighthouseScores {
+    performance: number;
+    accessibility: number;
+    bestPractices: number;
+    seo: number;
+}
+export interface VerificationInput {
+    buildSuccess?: boolean;
+    e2ePassed?: number;
+    e2eTotal?: number;
+    lighthouseScores?: LighthouseScores;
+}
+export declare const LH_THRESHOLDS: {
+    performance: number;
+    accessibility: number;
+    seo: number;
+    bestPractices: number;
+};
+export declare const LH_CI_THRESHOLDS: {
+    performance: number;
+    accessibility: number;
+    seo: number;
+    bestPractices: number;
+};
+export declare function getLighthousePass(lh: LighthouseScores | undefined, thresholds?: {
+    performance: number;
+    accessibility: number;
+    seo: number;
+    bestPractices: number;
+}): boolean;
+export declare function getVerificationGrade(input: VerificationInput): VerificationGrade;
+export interface ImprovementRule {
+    category: "build" | "performance" | "accessibility" | "seo" | "bestPractices" | "e2e";
+    priority: "critical" | "high" | "medium";
+    title: string;
+    description: string;
+    action: string;
+}
+export declare function getImprovementRecommendations(input: VerificationInput & {
+    buildErrors?: string[];
+}): ImprovementRule[];

package/dist/verification.js

@@ -0,0 +1,105 @@
+export const LH_THRESHOLDS = {
+    performance: 70,
+    accessibility: 85,
+    seo: 80,
+    bestPractices: 80,
+};
+export const LH_CI_THRESHOLDS = {
+    performance: 60, // CI mode: 10 points relaxed
+    accessibility: 85,
+    seo: 80,
+    bestPractices: 80,
+};
+export function getLighthousePass(lh, thresholds = LH_THRESHOLDS) {
+    if (!lh)
+        return false;
+    return (lh.performance >= thresholds.performance &&
+        lh.accessibility >= thresholds.accessibility &&
+        lh.seo >= thresholds.seo &&
+        lh.bestPractices >= thresholds.bestPractices);
+}
+export function getVerificationGrade(input) {
+    const buildOk = input.buildSuccess === true;
+    const e2eOk = typeof input.e2ePassed === "number" &&
+        typeof input.e2eTotal === "number" &&
+        input.e2eTotal > 0 &&
+        input.e2ePassed === input.e2eTotal;
+    const lhOk = getLighthousePass(input.lighthouseScores);
+    if (buildOk && e2eOk && lhOk)
+        return "gold";
+    if (buildOk && e2eOk)
+        return "silver";
+    if (buildOk && lhOk)
+        return "silver"; // CLI path: no E2E, build+LH = Silver
+    if (buildOk)
+        return "bronze";
+    return "unverified";
+}
+export function getImprovementRecommendations(input) {
+    const rules = [];
+    if (input.buildSuccess === false) {
+        const errors = input.buildErrors ?? [];
+        if (errors.some((e) => /TS\d+|type/i.test(e))) {
+            rules.push({
+                category: "build",
+                priority: "critical",
+                title: "TypeScript type error",
+                description: "TypeScript compilation errors are blocking the production build.",
+                action: "Check the file:line location in error messages and fix type mismatches.",
+            });
+        }
+        if (errors.some((e) => /Module not found|Cannot find module|Failed to resolve/i.test(e))) {
+            rules.push({
+                category: "build",
+                priority: "critical",
+                title: "Module resolution failure",
+                description: "An imported module or file cannot be found.",
+                action: "Check import paths and ensure required packages are in package.json.",
+            });
+        }
+        if (errors.some((e) => /SyntaxError|Unexpected token/i.test(e))) {
+            rules.push({
+                category: "build",
+                priority: "critical",
+                title: "Syntax error",
+                description: "JavaScript or TypeScript parsing error detected.",
+                action: "Check brackets, commas, string terminators, and JSX syntax.",
+            });
+        }
+        if (rules.filter((r) => r.category === "build").length === 0) {
+            rules.push({
+                category: "build",
+                priority: "critical",
+                title: "Build failed",
+                description: "The production build failed.",
+                action: "Check the first real error in build output and fix it.",
+            });
+        }
+    }
+    const lh = input.lighthouseScores;
+    if (lh) {
+        const checks = [
+            { key: "performance", category: "performance", label: "Performance", tip: "Optimize images, remove unused JS, apply code splitting." },
+            { key: "accessibility", category: "accessibility", label: "Accessibility", tip: "Add alt text, aria-labels, ensure sufficient color contrast." },
+            { key: "seo", category: "seo", label: "SEO", tip: "Add title, meta description, robots.txt, sitemap.xml." },
+            { key: "bestPractices", category: "bestPractices", label: "Best Practices", tip: "Fix console errors, update libraries, check resource references." },
+        ];
+        for (const c of checks) {
+            const score = lh[c.key];
+            const threshold = LH_THRESHOLDS[c.key];
+            if (score < threshold) {
+                const gap = threshold - score;
+                rules.push({
+                    category: c.category,
+                    priority: gap >= 20 ? "high" : "medium",
+                    title: `${c.label} below threshold (${score} / target ${threshold})`,
+                    description: `${c.label} score does not meet the required threshold.`,
+                    action: c.tip,
+                });
+            }
+        }
+    }
+    const priorityOrder = { critical: 0, high: 1, medium: 2 };
+    return rules.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority]);
+}
+//# sourceMappingURL=verification.js.map

package/dist/verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.js","sourceRoot":"","sources":["../src/verification.ts"],"names":[],"mappings":"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"}