@navinjoseph/web-perf-core 1.0.0-beta.3

package/dist/browser.js

@@ -0,0 +1,178 @@
+import { JSDOM, VirtualConsole } from "jsdom";
+import fetch from "node-fetch";
+/**
+ * Load a URL using jsdom with Shadow DOM support
+ */
+export async function loadPage(url, options = {}) {
+    const timeout = options.timeout || 10000; // 10 second default
+    const maxSize = options.maxSize || 10_000_000; // 10MB default
+    try {
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        const response = await fetch(url, {
+            headers: {
+                "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
+            },
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
+        }
+        // Check content size before downloading
+        const contentLength = response.headers.get("content-length");
+        if (contentLength && parseInt(contentLength) > maxSize) {
+            throw new Error(`Page too large: ${contentLength} bytes (max: ${maxSize} bytes)`);
+        }
+        const html = await response.text();
+        // Check actual HTML size
+        if (html.length > maxSize) {
+            throw new Error(`HTML too large: ${html.length} bytes (max: ${maxSize} bytes)`);
+        }
+        // Create virtual console to suppress script errors from external scripts
+        const virtualConsole = new VirtualConsole();
+        virtualConsole.on("jsdomError", (error) => {
+            // Silently ignore JSDOM script errors from external scripts
+            // These are typically from third-party scripts that use APIs not supported by JSDOM
+            if (!error.message.includes("Could not parse CSS stylesheet")) {
+                // Only log non-CSS errors for debugging if needed
+                // console.error("JSDOM Error:", error.message);
+            }
+        });
+        // Create jsdom instance with Shadow DOM support
+        // Performance optimization: disable resource loading and script execution
+        // Most audits only need static HTML structure
+        const dom = new JSDOM(html, {
+            url,
+            pretendToBeVisual: true,
+            // Don't load external resources (huge perf gain) - omit resources option to disable
+            runScripts: !options.allowJs ? "outside-only" : undefined, // Only run scripts we inject (like axe-core)
+            virtualConsole,
+            beforeParse(window) {
+                // Polyfill browser APIs not supported by JSDOM
+                addBrowserPolyfills(window);
+                // Polyfill ShadowDOM if needed
+                if (!window.Element.prototype.attachShadow) {
+                    window.Element.prototype.attachShadow = function () {
+                        return this;
+                    };
+                }
+            },
+        });
+        return {
+            document: dom.window.document,
+            window: dom.window,
+            html,
+            url,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to load page ${url}: ${message}`);
+    }
+}
+/**
+ * Get all elements including shadow DOM
+ */
+export function getAllElements(element) {
+    const elements = [element];
+    // Add children
+    for (const child of element.children) {
+        elements.push(...getAllElements(child));
+    }
+    // Add shadow DOM children if available
+    if (element.shadowRoot) {
+        for (const child of element.shadowRoot.children) {
+            elements.push(...getAllElements(child));
+        }
+    }
+    return elements;
+}
+/**
+ * Build selector for an element (including shadow DOM path)
+ */
+/**
+ * Add polyfills for browser APIs not supported by JSDOM
+ */
+function addBrowserPolyfills(window) {
+    // Polyfill ReadableStream and related APIs
+    if (typeof window.ReadableStream === "undefined") {
+        window.ReadableStream = class ReadableStream {
+            constructor() {
+                // Minimal polyfill - just prevents errors
+            }
+            getReader() {
+                return {
+                    read: () => Promise.resolve({ done: true, value: undefined }),
+                    releaseLock: () => { },
+                    closed: Promise.resolve(),
+                    cancel: () => Promise.resolve(),
+                };
+            }
+        };
+    }
+    // Polyfill WritableStream
+    if (typeof window.WritableStream === "undefined") {
+        window.WritableStream = class WritableStream {
+            constructor() { }
+            getWriter() {
+                return {
+                    write: () => Promise.resolve(),
+                    close: () => Promise.resolve(),
+                    abort: () => Promise.resolve(),
+                    closed: Promise.resolve(),
+                    ready: Promise.resolve(),
+                    releaseLock: () => { },
+                };
+            }
+        };
+    }
+    // Polyfill TransformStream
+    if (typeof window.TransformStream === "undefined") {
+        window.TransformStream = class TransformStream {
+            readable;
+            writable;
+            constructor() {
+                this.readable = new window.ReadableStream();
+                this.writable = new window.WritableStream();
+            }
+        };
+    }
+    // Ensure window.window exists (some libraries expect this)
+    if (!window.window) {
+        window.window = window;
+    }
+    // Polyfill requestAnimationFrame if needed
+    if (!window.requestAnimationFrame) {
+        window.requestAnimationFrame = (callback) => {
+            return window.setTimeout(() => callback(Date.now()), 16);
+        };
+    }
+    // Polyfill cancelAnimationFrame if needed
+    if (!window.cancelAnimationFrame) {
+        window.cancelAnimationFrame = (id) => {
+            window.clearTimeout(id);
+        };
+    }
+}
+export function buildSelector(element) {
+    const path = [];
+    let current = element;
+    while (current && current.nodeType === 1) {
+        let selector = current.tagName.toLowerCase();
+        if (current.id) {
+            selector += `#${current.id}`;
+        }
+        else if (current.className) {
+            const classes = current.className.split(/\s+/).slice(0, 2).join(".");
+            if (classes) {
+                selector += `.${classes}`;
+            }
+        }
+        path.unshift(selector);
+        current = current.parentElement;
+    }
+    return path.join(" > ");
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAa,cAAc,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,MAAM,YAAY,CAAC;AAS/B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAW,EACX,UAAqE,EAAE;IAEvE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,oBAAoB;IAC9D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC,CAAC,eAAe;IAE9D,IAAI,CAAC;QACH,sCAAsC;QACtC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAEhE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE;gBACP,YAAY,EACV,8DAA8D;aACjE;YACD,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,YAAY,CAAC,SAAS,CAAC,CAAC;QAExB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,wCAAwC;QACxC,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC7D,IAAI,aAAa,IAAI,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CACb,mBAAmB,aAAa,gBAAgB,OAAO,SAAS,CACjE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,yBAAyB;QACzB,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,CAAC,MAAM,gBAAgB,OAAO,SAAS,CAC/D,CAAC;QACJ,CAAC;QAED,yEAAyE;QACzE,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;QAC5C,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;YACxC,4DAA4D;YAC5D,oFAAoF;YACpF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE,CAAC;gBAC9D,kDAAkD;gBAClD,gDAAgD;YAClD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,gDAAgD;QAChD,0EAA0E;QAC1E,8CAA8C;QAC9C,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE;YAC1B,GAAG;YACH,iBAAiB,EAAE,IAAI;YACvB,oFAAoF;YACpF,UAAU,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,EAAE,6CAA6C;YACxG,cAAc;YACd,WAAW,CAAC,MAAiB;gBAC3B,+CAA+C;gBAC/C,mBAAmB,CAAC,MAAM,CAAC,CAAC;gBAE5B,+BAA+B;gBAC/B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;oBAC3C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,GAAG;wBACtC,OAAO,IAA6B,CAAC;oBACvC,CAAC,CAAC;gBACJ,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ;YAC7B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI;YACJ,GAAG;SACJ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,KAAK,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,QAAQ,GAAc,CAAC,OAAO,CAAC,CAAC;IAEtC,eAAe;IACf,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YAChD,QAAQ,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH;;GAEG;AACH,SAAS,mBAAmB,CAAC,MAAiB;IAC5C,2CAA2C;IAC3C,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,WAAW,EAAE,CAAC;QAChD,MAAc,CAAC,cAAc,GAAG,MAAM,cAAc;YACnD;gBACE,0CAA0C;YAC5C,CAAC;YACD,SAAS;gBACP,OAAO;oBACL,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;oBAC7D,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;oBACrB,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE;oBACzB,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;iBAChC,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,WAAW,EAAE,CAAC;QAChD,MAAc,CAAC,cAAc,GAAG,MAAM,cAAc;YACnD,gBAAe,CAAC;YAChB,SAAS;gBACP,OAAO;oBACL,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;oBAC9B,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;oBAC9B,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;oBAC9B,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE;oBACzB,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE;oBACxB,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;iBACtB,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,WAAW,EAAE,CAAC;QACjD,MAAc,CAAC,eAAe,GAAG,MAAM,eAAe;YACrD,QAAQ,CAAM;YACd,QAAQ,CAAM;YACd;gBACE,IAAI,CAAC,QAAQ,GAAG,IAAK,MAAc,CAAC,cAAc,EAAE,CAAC;gBACrD,IAAI,CAAC,QAAQ,GAAG,IAAK,MAAc,CAAC,cAAc,EAAE,CAAC;YACvD,CAAC;SACF,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,IAAI,CAAE,MAAc,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAc,CAAC,MAAM,GAAG,MAAM,CAAC;IAClC,CAAC;IAED,2CAA2C;IAC3C,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAClC,MAAM,CAAC,qBAAqB,GAAG,CAAC,QAA8B,EAAE,EAAE;YAChE,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;QACjC,MAAM,CAAC,oBAAoB,GAAG,CAAC,EAAU,EAAE,EAAE;YAC3C,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,OAAO,GAAmB,OAAO,CAAC;IAEtC,OAAO,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACzC,IAAI,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAE7C,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,QAAQ,IAAI,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;QAC/B,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrE,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,IAAI,IAAI,OAAO,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAClC,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC"}

package/dist/dom-collector.d.ts

@@ -0,0 +1,45 @@
+import { BrowserPage } from "./browser.js";
+/**
+ * Cached DOM elements to avoid multiple queries
+ * This provides massive performance improvement by traversing DOM once
+ */
+export type CollectedElements = {
+    scripts: HTMLScriptElement[];
+    scriptsWithSrc: HTMLScriptElement[];
+    inlineScripts: HTMLScriptElement[];
+    inlineHeadScripts: HTMLScriptElement[];
+    stylesheets: HTMLLinkElement[];
+    styleLinks: HTMLLinkElement[];
+    fontLinks: HTMLLinkElement[];
+    images: HTMLImageElement[];
+    links: HTMLAnchorElement[];
+    passwordFields: HTMLInputElement[];
+    iframes: HTMLIFrameElement[];
+    metaCharset: HTMLMetaElement | null;
+    metaHttpEquiv: HTMLMetaElement | null;
+    metaRefresh: HTMLMetaElement | null;
+    metaViewport: HTMLMetaElement | null;
+    googleFontsLinks: HTMLLinkElement[];
+    googleFontsPreconnect: HTMLLinkElement | null;
+    fontPreloads: HTMLLinkElement[];
+    marquee: Element[];
+    blink: Element[];
+    font: Element[];
+    center: Element[];
+    elementsWithId: Element[];
+    allElements: Element[];
+};
+/**
+ * Collect all DOM elements in a single traversal
+ * This is much faster than multiple querySelectorAll calls
+ */
+export declare function collectDOMElements(page: BrowserPage): CollectedElements;
+/**
+ * Find render-blocking CSS stylesheets
+ */
+export declare function findBlockingCSS(stylesheets: HTMLLinkElement[]): HTMLLinkElement[];
+/**
+ * Find duplicate IDs in collected elements
+ */
+export declare function findDuplicateIds(elementsWithId: Element[]): Map<string, Element[]>;
+//# sourceMappingURL=dom-collector.d.ts.map

package/dist/dom-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-collector.d.ts","sourceRoot":"","sources":["../src/dom-collector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAE9B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;IAGvC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,SAAS,EAAE,eAAe,EAAE,CAAC;IAG7B,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAG3B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAG3B,cAAc,EAAE,gBAAgB,EAAE,CAAC;IAGnC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAG7B,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IAGrC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,qBAAqB,EAAE,eAAe,GAAG,IAAI,CAAC;IAG9C,YAAY,EAAE,eAAe,EAAE,CAAC;IAGhC,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,MAAM,EAAE,OAAO,EAAE,CAAC;IAGlB,cAAc,EAAE,OAAO,EAAE,CAAC;IAG1B,WAAW,EAAE,OAAO,EAAE,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,iBAAiB,CAuJvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,eAAe,EAAE,GAC7B,eAAe,EAAE,CAOnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,OAAO,EAAE,GACxB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAsBxB"}

package/dist/dom-collector.js

@@ -0,0 +1,173 @@
+/**
+ * Collect all DOM elements in a single traversal
+ * This is much faster than multiple querySelectorAll calls
+ */
+export function collectDOMElements(page) {
+    const doc = page.document;
+    // Initialize collections
+    const collected = {
+        scripts: [],
+        scriptsWithSrc: [],
+        inlineScripts: [],
+        inlineHeadScripts: [],
+        stylesheets: [],
+        styleLinks: [],
+        fontLinks: [],
+        images: [],
+        links: [],
+        passwordFields: [],
+        iframes: [],
+        metaCharset: null,
+        metaHttpEquiv: null,
+        metaRefresh: null,
+        metaViewport: null,
+        googleFontsLinks: [],
+        googleFontsPreconnect: null,
+        fontPreloads: [],
+        marquee: [],
+        blink: [],
+        font: [],
+        center: [],
+        elementsWithId: [],
+        allElements: [],
+    };
+    // Single traversal of all elements
+    const allElements = doc.querySelectorAll("*");
+    collected.allElements = Array.from(allElements);
+    allElements.forEach((element) => {
+        const tagName = element.tagName.toLowerCase();
+        // Scripts
+        if (tagName === "script") {
+            const script = element;
+            collected.scripts.push(script);
+            if (script.hasAttribute("src")) {
+                collected.scriptsWithSrc.push(script);
+            }
+            else {
+                collected.inlineScripts.push(script);
+                if (script.closest("head")) {
+                    collected.inlineHeadScripts.push(script);
+                }
+            }
+        }
+        // Links (stylesheets, fonts, preloads)
+        else if (tagName === "link") {
+            const link = element;
+            const rel = link.getAttribute("rel");
+            const href = link.getAttribute("href") || "";
+            if (rel === "stylesheet") {
+                collected.stylesheets.push(link);
+                collected.styleLinks.push(link);
+                // Font links
+                if (href.includes("font")) {
+                    collected.fontLinks.push(link);
+                }
+                // Google Fonts
+                if (href.includes("fonts.googleapis.com")) {
+                    collected.googleFontsLinks.push(link);
+                }
+            }
+            // Font preloads
+            if (rel === "preload" && link.getAttribute("as") === "font") {
+                collected.fontPreloads.push(link);
+            }
+            // Google Fonts preconnect
+            if (rel === "preconnect" &&
+                (href.includes("fonts.googleapis.com") ||
+                    href.includes("fonts.gstatic.com"))) {
+                collected.googleFontsPreconnect = link;
+            }
+        }
+        // Images
+        else if (tagName === "img") {
+            collected.images.push(element);
+        }
+        // Anchors
+        else if (tagName === "a") {
+            collected.links.push(element);
+        }
+        // Iframes
+        else if (tagName === "iframe") {
+            collected.iframes.push(element);
+        }
+        // Input fields
+        else if (tagName === "input") {
+            const input = element;
+            if (input.type === "password") {
+                collected.passwordFields.push(input);
+            }
+        }
+        // Meta tags
+        else if (tagName === "meta") {
+            const meta = element;
+            const charset = meta.getAttribute("charset");
+            const httpEquiv = meta.getAttribute("http-equiv");
+            const name = meta.getAttribute("name");
+            if (charset) {
+                collected.metaCharset = meta;
+            }
+            if (httpEquiv === "Content-Type") {
+                collected.metaHttpEquiv = meta;
+            }
+            if (httpEquiv === "refresh") {
+                collected.metaRefresh = meta;
+            }
+            if (name === "viewport") {
+                collected.metaViewport = meta;
+            }
+        }
+        // Deprecated elements
+        else if (tagName === "marquee") {
+            collected.marquee.push(element);
+        }
+        else if (tagName === "blink") {
+            collected.blink.push(element);
+        }
+        else if (tagName === "font") {
+            collected.font.push(element);
+        }
+        else if (tagName === "center") {
+            collected.center.push(element);
+        }
+        // Elements with IDs
+        if (element.hasAttribute("id")) {
+            collected.elementsWithId.push(element);
+        }
+    });
+    return collected;
+}
+/**
+ * Find render-blocking CSS stylesheets
+ */
+export function findBlockingCSS(stylesheets) {
+    return stylesheets.filter((link) => {
+        const media = link.getAttribute("media");
+        const disabled = link.hasAttribute("disabled");
+        // Blocking if no media attribute (or media="all") and not disabled
+        return !disabled && (!media || media === "all" || media === "screen");
+    });
+}
+/**
+ * Find duplicate IDs in collected elements
+ */
+export function findDuplicateIds(elementsWithId) {
+    const idCount = new Map();
+    elementsWithId.forEach((element) => {
+        const id = element.getAttribute("id");
+        if (id) {
+            if (!idCount.has(id)) {
+                idCount.set(id, []);
+            }
+            idCount.get(id).push(element);
+        }
+    });
+    // Filter to only duplicates
+    const duplicates = new Map();
+    idCount.forEach((elements, id) => {
+        if (elements.length > 1) {
+            duplicates.set(id, elements);
+        }
+    });
+    return duplicates;
+}
+//# sourceMappingURL=dom-collector.js.map

package/dist/dom-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-collector.js","sourceRoot":"","sources":["../src/dom-collector.ts"],"names":[],"mappings":"AAwDA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAiB;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;IAE1B,yBAAyB;IACzB,MAAM,SAAS,GAAsB;QACnC,OAAO,EAAE,EAAE;QACX,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,EAAE;QACjB,iBAAiB,EAAE,EAAE;QACrB,WAAW,EAAE,EAAE;QACf,UAAU,EAAE,EAAE;QACd,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;QACT,cAAc,EAAE,EAAE;QAClB,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,IAAI;QAClB,gBAAgB,EAAE,EAAE;QACpB,qBAAqB,EAAE,IAAI;QAC3B,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,EAAE;QACR,MAAM,EAAE,EAAE;QACV,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,EAAE;KAChB,CAAC;IAEF,mCAAmC;IACnC,MAAM,WAAW,GAAG,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC9C,SAAS,CAAC,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEhD,WAAW,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAE9C,UAAU;QACV,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,OAA4B,CAAC;YAC5C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE/B,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3B,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;QACH,CAAC;QAED,uCAAuC;aAClC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,OAA0B,CAAC;YACxC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAE7C,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;gBACzB,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEhC,aAAa;gBACb,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjC,CAAC;gBAED,eAAe;gBACf,IAAI,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;oBAC1C,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;YAED,gBAAgB;YAChB,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;gBAC5D,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,CAAC;YAED,0BAA0B;YAC1B,IACE,GAAG,KAAK,YAAY;gBACpB,CAAC,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC;oBACpC,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,EACrC,CAAC;gBACD,SAAS,CAAC,qBAAqB,GAAG,IAAI,CAAC;YACzC,CAAC;QACH,CAAC;QAED,SAAS;aACJ,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YAC3B,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAA2B,CAAC,CAAC;QACrD,CAAC;QAED,UAAU;aACL,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACzB,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,OAA4B,CAAC,CAAC;QACrD,CAAC;QAED,UAAU;aACL,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC9B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,OAA4B,CAAC,CAAC;QACvD,CAAC;QAED,eAAe;aACV,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,OAA2B,CAAC;YAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC9B,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,YAAY;aACP,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,OAA0B,CAAC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAEvC,IAAI,OAAO,EAAE,CAAC;gBACZ,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC;YAC/B,CAAC;YACD,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;gBACjC,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC;YACjC,CAAC;YACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC;YAC/B,CAAC;YACD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;gBACxB,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC;YAChC,CAAC;QACH,CAAC;QAED,sBAAsB;aACjB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YAC/B,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;aAAM,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YAC9B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,oBAAoB;QACpB,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,WAA8B;IAE9B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC/C,mEAAmE;QACnE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,QAAQ,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,cAAyB;IAEzB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE7C,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACjC,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACtB,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,4BAA4B;IAC5B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;IAChD,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE;QAC/B,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/formatter.d.ts

@@ -0,0 +1,60 @@
+import { Issue, PendingCheck, Summary, AuditReport } from "./types.js";
+/**
+ * Format audit results into a complete audit report
+ */
+export declare function formatResults(url: string, startTime: number, endTime: number, allIssues: Issue[], allPassed: PendingCheck[], allIncomplete?: Issue[]): AuditReport;
+/**
+ * Generate summary statistics from issues
+ */
+export declare function generateSummary(issues: Issue[]): Summary;
+/**
+ * Merge multiple audit results into a single array
+ */
+export declare function mergeAuditResults(results: Array<{
+    issues: Issue[];
+    passed: PendingCheck[];
+}>): {
+    issues: Issue[];
+    passed: PendingCheck[];
+};
+/**
+ * Apply threshold checking to determine if audit passed
+ */
+export declare function checkThresholds(summary: Summary, thresholds?: {
+    critical?: number;
+    serious?: number;
+    moderate?: number;
+    minor?: number;
+}): {
+    passed: boolean;
+    violations: string[];
+};
+/**
+ * Sort issues by severity and then by category
+ */
+export declare function sortIssues(issues: Issue[]): Issue[];
+/**
+ * Group issues by category
+ */
+export declare function groupByCategory(issues: Issue[]): Record<string, Issue[]>;
+/**
+ * Group issues by severity
+ */
+export declare function groupBySeverity(issues: Issue[]): Record<string, Issue[]>;
+/**
+ * Filter issues by severity
+ */
+export declare function filterBySeverity(issues: Issue[], severities: Array<"critical" | "serious" | "moderate" | "minor">): Issue[];
+/**
+ * Filter issues by category
+ */
+export declare function filterByCategory(issues: Issue[], categories: string[]): Issue[];
+/**
+ * Get top N issues by severity
+ */
+export declare function getTopIssues(issues: Issue[], count: number): Issue[];
+/**
+ * Calculate percentage of passed checks
+ */
+export declare function calculatePassRate(passed: number, total: number): number;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvE;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,KAAK,EAAE,EAClB,SAAS,EAAE,YAAY,EAAE,EACzB,aAAa,GAAE,KAAK,EAAO,GAC1B,WAAW,CAeb;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAmCxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,GAC1D;IAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAA;CAAE,CAU7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CA+C3C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAanD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAWxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAaxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,EAAE,EACf,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC,GAC/D,KAAK,EAAE,CAET;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,EAAE,EACf,UAAU,EAAE,MAAM,EAAE,GACnB,KAAK,EAAE,CAET;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,CAEpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvE"}

package/dist/formatter.js

@@ -0,0 +1,164 @@
+/**
+ * Format audit results into a complete audit report
+ */
+export function formatResults(url, startTime, endTime, allIssues, allPassed, allIncomplete = []) {
+    const duration = endTime - startTime;
+    // Generate summary statistics
+    const summary = generateSummary(allIssues);
+    return {
+        url,
+        timestamp: startTime,
+        duration,
+        issues: allIssues,
+        passed: allPassed,
+        incomplete: allIncomplete,
+        summary,
+    };
+}
+/**
+ * Generate summary statistics from issues
+ */
+export function generateSummary(issues) {
+    const summary = {
+        total: issues.length,
+        bySeverity: {
+            critical: 0,
+            serious: 0,
+            moderate: 0,
+            minor: 0,
+        },
+        byCategory: {
+            images: 0,
+            interactive: 0,
+            forms: 0,
+            color: 0,
+            document: 0,
+            structure: 0,
+            aria: 0,
+            technical: 0,
+        },
+        passed: 0,
+    };
+    // Count by severity
+    issues.forEach((issue) => {
+        summary.bySeverity[issue.severity]++;
+    });
+    // Count by category
+    issues.forEach((issue) => {
+        if (issue.category in summary.byCategory) {
+            summary.byCategory[issue.category]++;
+        }
+    });
+    return summary;
+}
+/**
+ * Merge multiple audit results into a single array
+ */
+export function mergeAuditResults(results) {
+    const allIssues = [];
+    const allPassed = [];
+    results.forEach((result) => {
+        allIssues.push(...result.issues);
+        allPassed.push(...result.passed);
+    });
+    return { issues: allIssues, passed: allPassed };
+}
+/**
+ * Apply threshold checking to determine if audit passed
+ */
+export function checkThresholds(summary, thresholds) {
+    if (!thresholds) {
+        return { passed: true, violations: [] };
+    }
+    const violations = [];
+    if (thresholds.critical !== undefined &&
+        summary.bySeverity.critical > thresholds.critical) {
+        violations.push(`Critical issues: ${summary.bySeverity.critical} (threshold: ${thresholds.critical})`);
+    }
+    if (thresholds.serious !== undefined &&
+        summary.bySeverity.serious > thresholds.serious) {
+        violations.push(`Serious issues: ${summary.bySeverity.serious} (threshold: ${thresholds.serious})`);
+    }
+    if (thresholds.moderate !== undefined &&
+        summary.bySeverity.moderate > thresholds.moderate) {
+        violations.push(`Moderate issues: ${summary.bySeverity.moderate} (threshold: ${thresholds.moderate})`);
+    }
+    if (thresholds.minor !== undefined &&
+        summary.bySeverity.minor > thresholds.minor) {
+        violations.push(`Minor issues: ${summary.bySeverity.minor} (threshold: ${thresholds.minor})`);
+    }
+    return {
+        passed: violations.length === 0,
+        violations,
+    };
+}
+/**
+ * Sort issues by severity and then by category
+ */
+export function sortIssues(issues) {
+    const severityOrder = { critical: 0, serious: 1, moderate: 2, minor: 3 };
+    return issues.slice().sort((a, b) => {
+        // First sort by severity
+        const severityDiff = severityOrder[a.severity] - severityOrder[b.severity];
+        if (severityDiff !== 0) {
+            return severityDiff;
+        }
+        // Then by category
+        return a.category.localeCompare(b.category);
+    });
+}
+/**
+ * Group issues by category
+ */
+export function groupByCategory(issues) {
+    const grouped = {};
+    issues.forEach((issue) => {
+        if (!grouped[issue.category]) {
+            grouped[issue.category] = [];
+        }
+        grouped[issue.category].push(issue);
+    });
+    return grouped;
+}
+/**
+ * Group issues by severity
+ */
+export function groupBySeverity(issues) {
+    const grouped = {
+        critical: [],
+        serious: [],
+        moderate: [],
+        minor: [],
+    };
+    issues.forEach((issue) => {
+        grouped[issue.severity].push(issue);
+    });
+    return grouped;
+}
+/**
+ * Filter issues by severity
+ */
+export function filterBySeverity(issues, severities) {
+    return issues.filter((issue) => severities.includes(issue.severity));
+}
+/**
+ * Filter issues by category
+ */
+export function filterByCategory(issues, categories) {
+    return issues.filter((issue) => categories.includes(issue.category));
+}
+/**
+ * Get top N issues by severity
+ */
+export function getTopIssues(issues, count) {
+    return sortIssues(issues).slice(0, count);
+}
+/**
+ * Calculate percentage of passed checks
+ */
+export function calculatePassRate(passed, total) {
+    if (total === 0)
+        return 100;
+    return Math.round((passed / total) * 100);
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAW,EACX,SAAiB,EACjB,OAAe,EACf,SAAkB,EAClB,SAAyB,EACzB,gBAAyB,EAAE;IAE3B,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAErC,8BAA8B;IAC9B,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAE3C,OAAO;QACL,GAAG;QACH,SAAS,EAAE,SAAS;QACpB,QAAQ;QACR,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,aAAa;QACzB,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,MAAM,OAAO,GAAY;QACvB,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,UAAU,EAAE;YACV,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,CAAC;SACT;QACD,UAAU,EAAE;YACV,MAAM,EAAE,CAAC;YACT,WAAW,EAAE,CAAC;YACd,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,CAAC;YACZ,IAAI,EAAE,CAAC;YACP,SAAS,EAAE,CAAC;SACb;QACD,MAAM,EAAE,CAAC;KACV,CAAC;IAEF,oBAAoB;IACpB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,IAAI,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACzC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA2D;IAE3D,MAAM,SAAS,GAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAmB,EAAE,CAAC;IAErC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,UAKC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,IACE,UAAU,CAAC,QAAQ,KAAK,SAAS;QACjC,OAAO,CAAC,UAAU,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,EACjD,CAAC;QACD,UAAU,CAAC,IAAI,CACb,oBAAoB,OAAO,CAAC,UAAU,CAAC,QAAQ,gBAAgB,UAAU,CAAC,QAAQ,GAAG,CACtF,CAAC;IACJ,CAAC;IAED,IACE,UAAU,CAAC,OAAO,KAAK,SAAS;QAChC,OAAO,CAAC,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,EAC/C,CAAC;QACD,UAAU,CAAC,IAAI,CACb,mBAAmB,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,UAAU,CAAC,OAAO,GAAG,CACnF,CAAC;IACJ,CAAC;IAED,IACE,UAAU,CAAC,QAAQ,KAAK,SAAS;QACjC,OAAO,CAAC,UAAU,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,EACjD,CAAC;QACD,UAAU,CAAC,IAAI,CACb,oBAAoB,OAAO,CAAC,UAAU,CAAC,QAAQ,gBAAgB,UAAU,CAAC,QAAQ,GAAG,CACtF,CAAC;IACJ,CAAC;IAED,IACE,UAAU,CAAC,KAAK,KAAK,SAAS;QAC9B,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,EAC3C,CAAC;QACD,UAAU,CAAC,IAAI,CACb,iBAAiB,OAAO,CAAC,UAAU,CAAC,KAAK,gBAAgB,UAAU,CAAC,KAAK,GAAG,CAC7E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;QAC/B,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe;IACxC,MAAM,aAAa,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAEzE,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAClC,yBAAyB;QACzB,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC3E,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,mBAAmB;QACnB,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,MAAM,OAAO,GAA4B;QACvC,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAe,EACf,UAAgE;IAEhE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAe,EACf,UAAoB;IAEpB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAe,EAAE,KAAa;IACzD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,KAAa;IAC7D,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;AAC5C,CAAC"}