@automattic/jetpack-critical-css-gen 0.1.0 → 1.0.0

package/build-node/browser-interface-playwright.d.ts

@@ -1,53 +0,0 @@
-import { BrowserContext, Page } from 'playwright-core';
-import { BrowserInterface, BrowserRunnable, FetchOptions } from './browser-interface.js';
-import { Viewport } from './types.js';
-export type Tab = {
-    page: Page;
-    statusCode: number | null;
-};
-export type TabsByUrl = {
-    [url: string]: Tab;
-};
-export declare class BrowserInterfacePlaywright extends BrowserInterface {
-    private context;
-    private urls;
-    private tabs;
-    /**
-     * Creates a new BrowserInterfacePlaywright instance.
-     *
-     * @param {BrowserContext} context - The playwright browser context to work with.
-     * @param {string[]}       urls    - Array of urls to evaluate. The reason we are taking this as an argument is because we want to load all of them in parallel.
-     */
-    constructor(context: BrowserContext, urls: string[]);
-    private getTabs;
-    /**
-     * Open an array of urls in a new browser context.
-     *
-     * Take a browser instance and an array of urls to open in new tabs.
-     *
-     * @param {BrowserContext} context - Browser context to use.
-     * @param {string[]}       urls    - Array of urls to open.
-     * @return {Promise< TabsByUrl >} Promise resolving to the browser context.
-     */
-    private openUrls;
-    /**
-     * Open url in a new tab in a given browserContext.
-     *
-     * @param {BrowserContext} browserContext - Browser context to use.
-     * @param {string}         url            - Url to open.
-     * @return {Promise<Page>} Promise resolving to the page instance.
-     */
-    private newTab;
-    runInPage<ReturnType>(pageUrl: string, viewport: Viewport | null, method: BrowserRunnable<ReturnType>, ...args: unknown[]): Promise<ReturnType>;
-    /**
-     * Replacement for browser.fetch, uses node's fetch to simulate the same
-     * interface.
-     *
-     * @param {string} url     - URL to fetch.
-     * @param {object} options - Fetch options.
-     * @param {string} _role   - 'css' or 'html' indicating what kind of thing is being fetched.
-     * @return {Promise<Response>} A promise that resolves to the fetch response.
-     */
-    fetch(url: string, options: FetchOptions, _role: 'css' | 'html'): Promise<Response>;
-    private isOkStatus;
-}

package/build-node/browser-interface-playwright.js

@@ -1,94 +0,0 @@
-import { BrowserInterface } from './browser-interface.js';
-import { HttpError } from './errors.js';
-import { objectPromiseAll } from './object-promise-all.js';
-const PAGE_GOTO_TIMEOUT_MS = 5 * 60 * 1000;
-export class BrowserInterfacePlaywright extends BrowserInterface {
-    /**
-     * Creates a new BrowserInterfacePlaywright instance.
-     *
-     * @param {BrowserContext} context - The playwright browser context to work with.
-     * @param {string[]}       urls    - Array of urls to evaluate. The reason we are taking this as an argument is because we want to load all of them in parallel.
-     */
-    constructor(context, urls) {
-        super();
-        this.context = context;
-        this.urls = urls;
-    }
-    async getTabs() {
-        if (typeof this.tabs === 'undefined') {
-            await this.openUrls(this.context, this.urls);
-        }
-        return this.tabs;
-    }
-    /**
-     * Open an array of urls in a new browser context.
-     *
-     * Take a browser instance and an array of urls to open in new tabs.
-     *
-     * @param {BrowserContext} context - Browser context to use.
-     * @param {string[]}       urls    - Array of urls to open.
-     * @return {Promise< TabsByUrl >} Promise resolving to the browser context.
-     */
-    async openUrls(context, urls) {
-        this.tabs = await objectPromiseAll(urls.reduce((set, url) => {
-            set[url] = this.newTab(context, url);
-            return set;
-        }, {}));
-    }
-    /**
-     * Open url in a new tab in a given browserContext.
-     *
-     * @param {BrowserContext} browserContext - Browser context to use.
-     * @param {string}         url            - Url to open.
-     * @return {Promise<Page>} Promise resolving to the page instance.
-     */
-    async newTab(browserContext, url) {
-        const tab = {
-            page: await browserContext.newPage(),
-            statusCode: null,
-        };
-        tab.page.on('response', async (response) => {
-            if (response.url() === url) {
-                tab.statusCode = response.status();
-            }
-        });
-        await tab.page.goto(url, { timeout: PAGE_GOTO_TIMEOUT_MS });
-        return tab;
-    }
-    async runInPage(pageUrl, viewport, method, ...args) {
-        const tabs = await this.getTabs();
-        const tab = tabs[pageUrl];
-        if (!tab || !tab.page) {
-            throw new Error(`Playwright interface does not include URL ${pageUrl}`);
-        }
-        // Bail early if the page returned a non-200 status code.
-        if (!tab.statusCode || !this.isOkStatus(tab.statusCode)) {
-            const error = new HttpError({ url: pageUrl, code: tab.statusCode });
-            this.trackUrlError(pageUrl, error);
-            throw error;
-        }
-        if (viewport) {
-            await tab.page.setViewportSize(viewport);
-        }
-        // The inner window in Playwright is the directly accessible main window object.
-        // The evaluating method does not need a separate window object.
-        // Call inner method within the Playwright context.
-        return tab.page.evaluate(method, { innerWindow: null, args });
-    }
-    /**
-     * Replacement for browser.fetch, uses node's fetch to simulate the same
-     * interface.
-     *
-     * @param {string} url     - URL to fetch.
-     * @param {object} options - Fetch options.
-     * @param {string} _role   - 'css' or 'html' indicating what kind of thing is being fetched.
-     * @return {Promise<Response>} A promise that resolves to the fetch response.
-     */
-    async fetch(url, options, _role) {
-        return fetch(url, options);
-    }
-    isOkStatus(statusCode) {
-        return statusCode >= 200 && statusCode < 300;
-    }
-}
-//# sourceMappingURL=browser-interface-playwright.js.map

package/build-node/browser-interface-playwright.js.map

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

package/build-node/browser-interface.d.ts

@@ -1,77 +0,0 @@
-import type { Viewport } from './types.js';
-export type BrowserRunnable<ReturnType> = (arg: unknown) => ReturnType;
-export interface FetchOptions {
-    method?: 'POST' | 'GET';
-}
-export interface FetchResponse {
-    ok: boolean;
-    status: number;
-    text: () => Promise<string>;
-}
-export declare class BrowserInterface {
-    private urlErrors;
-    constructor();
-    trackUrlError(url: string, error: Error): void;
-    filterValidUrls(urls: string[]): string[];
-    runInPage<ReturnType>(_pageUrl: string, _viewport: Viewport | null, _method: BrowserRunnable<ReturnType>, ..._args: unknown[]): Promise<ReturnType>;
-    /**
-     * Context-specific wrapper for fetch; uses window.fetch in browsers, or a
-     * node library when using Puppeteer.
-     *
-     * @param {string}         _url     - The URL to fetch
-     * @param {FetchOptions}   _options - Fetch options
-     * @param {'css' | 'html'} _role    - Role of the fetch operation
-     */
-    fetch(_url: string, _options: FetchOptions, _role: 'css' | 'html'): Promise<FetchResponse>;
-    cleanup(): Promise<void>;
-    getCssIncludes(pageUrl: string): Promise<{
-        [url: string]: {
-            media: string;
-        };
-    }>;
-    static innerGetCssIncludes({ innerWindow }: {
-        innerWindow: any;
-    }): any;
-    getInternalStyles(pageUrl: string): Promise<string>;
-    /**
-     * Get all internal styles as a combined string from the window.
-     *
-     * @param {object} wrappedArgs             - Object containing the inner window.
-     * @param {Window} wrappedArgs.innerWindow - Window inside the browser interface.
-     * @return {string} Combined internal styles as a string.
-     */
-    static innerGetInternalStyles({ innerWindow }: {
-        innerWindow: any;
-    }): string;
-    /**
-     * Given a set of CSS selectors (as object keys), along with "simplified" versions
-     * for easy querySelector calling (values), return an array of selectors which match
-     * _any_ element on the page.
-     *
-     * @param {object}   wrappedArgs             - Object containing the inner window and arguments.
-     * @param {Window}   wrappedArgs.innerWindow - Window inside the browser interface.
-     * @param {Object[]} wrappedArgs.args        - Array of arguments.
-     *                                           {Object} wrappedArgs.args[selectors] - Map containing selectors (object keys), and simplified versions for easy matching (values).
-     * @return {string[]} Array of selectors matching above-the-fold elements.
-     */
-    static innerFindMatchingSelectors({ innerWindow, args: [selectors] }: {
-        innerWindow: any;
-        args: [any];
-    }): string[];
-    /**
-     * Given a set of CSS selectors (as object keys), along with "simplified" versions
-     * for easy querySelector calling (values), return an array of selectors which match
-     * any above-the-fold element on the page.
-     *
-     * @param {object}   wrappedArgs             - Object containing the inner window and arguments.
-     * @param {Window}   wrappedArgs.innerWindow - Window inside the browser interface.
-     * @param {Object[]} wrappedArgs.args        - Array of arguments.
-     *                                           {Object} wrappedArgs.args[selectors] - Map containing selectors (object keys), and simplified versions for easy matching (values).
-     *                                           {string[]} wrappedArgs.args[pageSelectors] - String array containing selectors that appear anywhere on this page (as returned by innerFindMatchingSelectors) - should be a subset of keys in selectors.
-     * @return {string[]} Array of selectors matching above-the-fold elements.
-     */
-    static innerFindAboveFoldSelectors({ innerWindow, args: [selectors, pageSelectors], }: {
-        innerWindow: any;
-        args: [any, any];
-    }): string[];
-}

package/build-node/browser-interface.js

@@ -1,124 +0,0 @@
-export class BrowserInterface {
-    constructor() {
-        this.urlErrors = {};
-    }
-    trackUrlError(url, error) {
-        this.urlErrors[url] = error;
-    }
-    filterValidUrls(urls) {
-        return urls.filter(url => !this.urlErrors[url]);
-    }
-    async runInPage(_pageUrl, _viewport, _method, ..._args) {
-        throw new Error('Undefined interface method: BrowserInterface.runInPage()');
-    }
-    /**
-     * Context-specific wrapper for fetch; uses window.fetch in browsers, or a
-     * node library when using Puppeteer.
-     *
-     * @param {string}         _url     - The URL to fetch
-     * @param {FetchOptions}   _options - Fetch options
-     * @param {'css' | 'html'} _role    - Role of the fetch operation
-     */
-    async fetch(_url, _options, _role) {
-        throw new Error('Undefined interface method: BrowserInterface.fetch()');
-    }
-    async cleanup() {
-        // No-op.
-    }
-    async getCssIncludes(pageUrl) {
-        return await this.runInPage(pageUrl, null, BrowserInterface.innerGetCssIncludes);
-    }
-    static innerGetCssIncludes({ innerWindow }) {
-        innerWindow = null === innerWindow ? window : innerWindow;
-        return [...innerWindow.document.getElementsByTagName('link')]
-            .filter(link => link.rel === 'stylesheet')
-            .reduce((set, link) => {
-            set[link.href] = {
-                media: link.media || null,
-            };
-            return set;
-        }, {});
-    }
-    async getInternalStyles(pageUrl) {
-        return await this.runInPage(pageUrl, null, BrowserInterface.innerGetInternalStyles);
-    }
-    /**
-     * Get all internal styles as a combined string from the window.
-     *
-     * @param {object} wrappedArgs             - Object containing the inner window.
-     * @param {Window} wrappedArgs.innerWindow - Window inside the browser interface.
-     * @return {string} Combined internal styles as a string.
-     */
-    static innerGetInternalStyles({ innerWindow }) {
-        innerWindow = null === innerWindow ? window : innerWindow;
-        const styleElements = Array.from(innerWindow.document.getElementsByTagName('style'));
-        return styleElements.reduce((styles, style) => {
-            styles += style.innerText;
-            return styles;
-        }, '');
-    }
-    /**
-     * Given a set of CSS selectors (as object keys), along with "simplified" versions
-     * for easy querySelector calling (values), return an array of selectors which match
-     * _any_ element on the page.
-     *
-     * @param {object}   wrappedArgs             - Object containing the inner window and arguments.
-     * @param {Window}   wrappedArgs.innerWindow - Window inside the browser interface.
-     * @param {Object[]} wrappedArgs.args        - Array of arguments.
-     *                                           {Object} wrappedArgs.args[selectors] - Map containing selectors (object keys), and simplified versions for easy matching (values).
-     * @return {string[]} Array of selectors matching above-the-fold elements.
-     */
-    static innerFindMatchingSelectors({ innerWindow, args: [selectors] }) {
-        innerWindow = null === innerWindow ? window : innerWindow;
-        return Object.keys(selectors).filter(selector => {
-            try {
-                return !!innerWindow.document.querySelector(selectors[selector]);
-            }
-            catch (err) {
-                // Ignore invalid selectors.
-                return false;
-            }
-        });
-    }
-    /**
-     * Given a set of CSS selectors (as object keys), along with "simplified" versions
-     * for easy querySelector calling (values), return an array of selectors which match
-     * any above-the-fold element on the page.
-     *
-     * @param {object}   wrappedArgs             - Object containing the inner window and arguments.
-     * @param {Window}   wrappedArgs.innerWindow - Window inside the browser interface.
-     * @param {Object[]} wrappedArgs.args        - Array of arguments.
-     *                                           {Object} wrappedArgs.args[selectors] - Map containing selectors (object keys), and simplified versions for easy matching (values).
-     *                                           {string[]} wrappedArgs.args[pageSelectors] - String array containing selectors that appear anywhere on this page (as returned by innerFindMatchingSelectors) - should be a subset of keys in selectors.
-     * @return {string[]} Array of selectors matching above-the-fold elements.
-     */
-    static innerFindAboveFoldSelectors({ innerWindow, args: [selectors, pageSelectors], }) {
-        /**
-         * Inner helper function used inside browser / iframe to check if the given
-         * element is "above the fold".
-         *
-         * @param {HTMLElement} element - Element to check.
-         */
-        innerWindow = null === innerWindow ? window : innerWindow;
-        const isAboveFold = element => {
-            const originalClearStyle = element.style.clear || '';
-            element.style.clear = 'none';
-            const rect = element.getBoundingClientRect();
-            element.style.clear = originalClearStyle;
-            return rect.top < innerWindow.innerHeight;
-        };
-        return pageSelectors.filter(s => {
-            if ('*' === selectors[s]) {
-                return true;
-            }
-            const matches = innerWindow.document.querySelectorAll(selectors[s]);
-            for (const match of matches) {
-                if (isAboveFold(match)) {
-                    return true;
-                }
-            }
-            return false;
-        });
-    }
-}
-//# sourceMappingURL=browser-interface.js.map

package/build-node/browser-interface.js.map

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

package/build-node/css-file-set.d.ts

@@ -1,100 +0,0 @@
-import { BrowserInterface } from './browser-interface.js';
-import { StyleAST } from './style-ast.js';
-import { FilterSpec } from './types.js';
-type CSSFile = {
-    css: string;
-    ast: StyleAST;
-    pages: string[];
-    urls: string[];
-};
-/**
- * Represents a set of CSS files found on one or more HTML page. Automatically de-duplicates
- * CSS files by URL and by content, and parses each into an Abstract Syntax Tree. Also tracks
- * all errors that occur while loading or parsing CSS.
- */
-export declare class CSSFileSet {
-    private browserInterface;
-    private knownUrls;
-    private cssFiles;
-    private errors;
-    private internalStyles;
-    constructor(browserInterface: BrowserInterface);
-    /**
-     * Add a set of CSS URLs from an HTML page to this set.
-     *
-     * @param {string} page        - URL of the page the CSS URLs were found on.
-     * @param {object} cssIncludes - Included CSS Files. Keyed by URL.
-     */
-    addMultiple(page: string, cssIncludes: {
-        [url: string]: {
-            media: string;
-        };
-    }): Promise<void>;
-    addInternalStyles(page: string, internalStyles: string): Promise<void>;
-    /**
-     * Add a CSS URL from an HTML page to this set.
-     *
-     * @param {string} page     - URL of the page the CSS URL was found on.
-     * @param {string} cssUrl   - The CSS file URL.
-     * @param {object} settings - Additional settings for the CSS file.
-     */
-    add(page: string, cssUrl: string, settings?: {
-        [url: string]: string;
-    }): Promise<void>;
-    /**
-     * Collates an object describing the selectors found in the CSS files in this set, and which
-     * HTML page URLs include them (via CSS files)
-     *
-     * @return {object} - An object with selector text keys, each containing a Set of page URLs (strings)
-     */
-    collateSelectorPages(): {
-        [selector: string]: Set<string>;
-    };
-    /**
-     * Applies filters to the properties or atRules in each AST in this set of CSS files.
-     * Mutates each AST in-place.
-     *
-     * @param {FilterSpec} filters - Object containing property and atRule filter functions.
-     */
-    applyFilters(filters: FilterSpec): void;
-    /**
-     * Returns a new AST which is pruned appropriately for the specified contentWindow, and the
-     * set of selectors that are worth keeping. (i.e.: appear above the fold).
-     *
-     * @param {Set<string>} usefulSelectors - Set of selectors to keep.
-     * @return {StyleAST[]} Array of pruned StyleAST objects.
-     */
-    prunedAsts(usefulSelectors: Set<string>): StyleAST[];
-    /**
-     * Internal method: Store the specified css found at the cssUrl for an HTML page,
-     * de-duplicating CSS files by content along the way.
-     *
-     * @param {string} page   - URL of HTML page this CSS file was found on.
-     * @param {string} cssUrl - URL of the CSS file.
-     * @param {string} css    - Content of the CSS File.
-     */
-    storeCss(page: string, cssUrl: string, css: string): void;
-    /**
-     * Internal method: Add an extra reference to a previously known CSS file found either
-     * on a new HTML page, or at a new URL.
-     *
-     * @param {string} page         - URL of the page this CSS file was found on.
-     * @param {string} cssUrl       - URL of the CSS File.
-     * @param {object} matchingFile - Internal CSS File object.
-     */
-    addExtraReference(page: string, cssUrl: string, matchingFile: CSSFile): void;
-    /**
-     * Stores an error that occurred while fetching or parsing CSS at the given URL.
-     *
-     * @param {string} url - CSS URL that failed to fetch or parse.
-     * @param {Error}  err - Error object describing the problem.
-     */
-    storeError(url: string, err: Error): void;
-    /**
-     * Returns a list of errors that occurred while fetching or parsing these CSS files.
-     *
-     * @return {Error[]} - List of errors that occurred.
-     */
-    getErrors(): Error[];
-}
-export {};

package/build-node/css-file-set.js

@@ -1,210 +0,0 @@
-import { HttpError, UnknownError, UrlError } from './errors.js';
-import { StyleAST } from './style-ast.js';
-// Maximum number of iterations when pruning unused variables.
-const maxVarPruneIterations = 10;
-/**
- * Represents a set of CSS files found on one or more HTML page. Automatically de-duplicates
- * CSS files by URL and by content, and parses each into an Abstract Syntax Tree. Also tracks
- * all errors that occur while loading or parsing CSS.
- */
-export class CSSFileSet {
-    constructor(browserInterface) {
-        this.browserInterface = browserInterface;
-        this.internalStyles = {};
-        this.knownUrls = {};
-        this.cssFiles = [];
-        this.errors = [];
-    }
-    /**
-     * Add a set of CSS URLs from an HTML page to this set.
-     *
-     * @param {string} page        - URL of the page the CSS URLs were found on.
-     * @param {object} cssIncludes - Included CSS Files. Keyed by URL.
-     */
-    async addMultiple(page, cssIncludes) {
-        await Promise.all(Object.keys(cssIncludes).map(url => this.add(page, url, cssIncludes[url])));
-    }
-    async addInternalStyles(page, internalStyles) {
-        this.internalStyles[page] = StyleAST.parse(internalStyles);
-    }
-    /**
-     * Add a CSS URL from an HTML page to this set.
-     *
-     * @param {string} page     - URL of the page the CSS URL was found on.
-     * @param {string} cssUrl   - The CSS file URL.
-     * @param {object} settings - Additional settings for the CSS file.
-     */
-    async add(page, cssUrl, settings = {}) {
-        // Add by reference if we already know this file.
-        if (Object.prototype.hasOwnProperty.call(this.knownUrls, cssUrl)) {
-            if (this.knownUrls[cssUrl] instanceof Error) {
-                // We already know this URL failed. Bail early.
-                return;
-            }
-            this.addExtraReference(page, cssUrl, this.knownUrls[cssUrl]);
-            return;
-        }
-        // Try to load this URL.
-        try {
-            const response = await this.browserInterface.fetch(cssUrl, {}, 'css');
-            if (!response.ok) {
-                throw new HttpError({ code: response.status, url: cssUrl });
-            }
-            let css = await response.text();
-            // If there is an implied media query from the css's <link> tag, wrap the CSS in it.
-            if (settings.media) {
-                css = '@media ' + settings.media + ' {\n' + css + '\n}';
-            }
-            this.storeCss(page, cssUrl, css);
-        }
-        catch (err) {
-            let wrappedError = err;
-            // Wrap any unfamiliar fetch errors in an unknown error.
-            if (!(err instanceof UrlError)) {
-                wrappedError = new UnknownError({
-                    url: cssUrl,
-                    message: err.message,
-                });
-            }
-            this.storeError(cssUrl, wrappedError);
-        }
-    }
-    /**
-     * Collates an object describing the selectors found in the CSS files in this set, and which
-     * HTML page URLs include them (via CSS files)
-     *
-     * @return {object} - An object with selector text keys, each containing a Set of page URLs (strings)
-     */
-    collateSelectorPages() {
-        const selectors = {};
-        for (const file of this.cssFiles) {
-            file.ast.forEachSelector(selector => {
-                if (!selectors[selector]) {
-                    selectors[selector] = new Set();
-                }
-                file.pages.forEach(pageUrl => selectors[selector].add(pageUrl));
-            });
-        }
-        return selectors;
-    }
-    /**
-     * Applies filters to the properties or atRules in each AST in this set of CSS files.
-     * Mutates each AST in-place.
-     *
-     * @param {FilterSpec} filters - Object containing property and atRule filter functions.
-     */
-    applyFilters(filters) {
-        for (const file of this.cssFiles) {
-            file.ast.applyFilters(filters);
-        }
-    }
-    /**
-     * Returns a new AST which is pruned appropriately for the specified contentWindow, and the
-     * set of selectors that are worth keeping. (i.e.: appear above the fold).
-     *
-     * @param {Set<string>} usefulSelectors - Set of selectors to keep.
-     * @return {StyleAST[]} Array of pruned StyleAST objects.
-     */
-    prunedAsts(usefulSelectors) {
-        // Perform basic pruning.
-        let asts = this.cssFiles.map(file => {
-            return file.ast.pruned(usefulSelectors);
-        });
-        const internallyUsedVariables = new Set();
-        Object.values(this.internalStyles).reduce((set, ast) => {
-            ast.getUsedVariables().forEach(v => set.add(v));
-            return set;
-        }, internallyUsedVariables);
-        // Repeatedly prune unused variables (up to maxVarPruneIterations), to catch vars which are
-        // only used to define other vars which aren't used.
-        let prevUsedVariables;
-        for (let i = 0; i < maxVarPruneIterations; i++) {
-            // Gather the set of used variables.
-            const usedVariables = asts.reduce((set, ast) => {
-                ast.getUsedVariables().forEach(v => set.add(v));
-                return set;
-            }, new Set());
-            // If the number of used vars hasn't changed since last iteration, stop early.
-            if (prevUsedVariables && prevUsedVariables.size === usedVariables.size) {
-                break;
-            }
-            // Prune unused variables, keep a sum of pruned variables.
-            const prunedCount = asts.reduce((sum, ast) => {
-                sum += ast.pruneUnusedVariables(new Set([...usedVariables, ...internallyUsedVariables]));
-                return sum;
-            }, 0);
-            // If no variables were pruned this iteration, stop early.
-            if (prunedCount === 0) {
-                break;
-            }
-            prevUsedVariables = usedVariables;
-        }
-        // Find all fonts used across all ASTs, and prune all that are not referenced.
-        const fontWhitelist = asts.reduce((set, ast) => {
-            ast.getUsedFontFamilies().forEach(font => set.add(font));
-            return set;
-        }, new Set());
-        // Remove any fonts that aren't used above the fold.
-        asts.forEach(ast => ast.pruneNonCriticalFonts(fontWhitelist));
-        // Throw away any ASTs without rules.
-        asts = asts.filter(ast => ast.ruleCount() > 0);
-        return asts;
-    }
-    /**
-     * Internal method: Store the specified css found at the cssUrl for an HTML page,
-     * de-duplicating CSS files by content along the way.
-     *
-     * @param {string} page   - URL of HTML page this CSS file was found on.
-     * @param {string} cssUrl - URL of the CSS file.
-     * @param {string} css    - Content of the CSS File.
-     */
-    storeCss(page, cssUrl, css) {
-        // De-duplicate css contents in case cache busters in URLs or WAFs, etc confound URL de-duplication.
-        const matchingFile = this.cssFiles.find(file => file.css === css);
-        if (matchingFile) {
-            this.addExtraReference(page, cssUrl, matchingFile);
-            return;
-        }
-        // Parse the CSS into an AST.
-        const ast = StyleAST.parse(css);
-        // Make sure relative URLs in the AST are absolute.
-        ast.absolutifyUrls(cssUrl);
-        const file = { css, ast, pages: [page], urls: [cssUrl] };
-        this.knownUrls[cssUrl] = file;
-        this.cssFiles.push(file);
-    }
-    /**
-     * Internal method: Add an extra reference to a previously known CSS file found either
-     * on a new HTML page, or at a new URL.
-     *
-     * @param {string} page         - URL of the page this CSS file was found on.
-     * @param {string} cssUrl       - URL of the CSS File.
-     * @param {object} matchingFile - Internal CSS File object.
-     */
-    addExtraReference(page, cssUrl, matchingFile) {
-        this.knownUrls[cssUrl] = matchingFile;
-        matchingFile.pages.push(page);
-        if (!matchingFile.urls.includes(cssUrl)) {
-            matchingFile.urls.push(cssUrl);
-        }
-    }
-    /**
-     * Stores an error that occurred while fetching or parsing CSS at the given URL.
-     *
-     * @param {string} url - CSS URL that failed to fetch or parse.
-     * @param {Error}  err - Error object describing the problem.
-     */
-    storeError(url, err) {
-        this.knownUrls[url] = err;
-        this.errors.push(err);
-    }
-    /**
-     * Returns a list of errors that occurred while fetching or parsing these CSS files.
-     *
-     * @return {Error[]} - List of errors that occurred.
-     */
-    getErrors() {
-        return this.errors;
-    }
-}
-//# sourceMappingURL=css-file-set.js.map