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

package/build/generate-critical-css.js

@@ -0,0 +1,162 @@
+import { BrowserInterface } from './browser-interface.js';
+import { CSSFileSet } from './css-file-set.js';
+import { SuccessTargetError, EmptyCSSError } from './errors.js';
+import { removeIgnoredPseudoElements } from './ignored-pseudo-elements.js';
+import { minifyCss } from './minify-css.js';
+const noop = () => {
+    // No op.
+};
+/**
+ * Collate and return a CSSFileSet object describing all the CSS files used by
+ * the set of URLs provided.
+ *
+ * Errors that occur during this process are collated, but not thrown yet.
+ *
+ * @param {BrowserInterface} browserInterface - interface to access pages
+ * @param {string[]}         urls             - list of URLs to scan for CSS files
+ * @param {number}           maxPages         - number of pages to process at most
+ * @return {Array} - Two member array; CSSFileSet, and an object containing errors that occurred at each URL.
+ */
+async function collateCssFiles(browserInterface, urls, maxPages) {
+    const cssFiles = new CSSFileSet(browserInterface);
+    const errors = {};
+    let successes = 0;
+    for (const url of urls) {
+        try {
+            const cssIncludes = await browserInterface.getCssIncludes(url);
+            // Convert relative URLs to absolute.
+            const relativeUrls = Object.keys(cssIncludes);
+            const absoluteIncludes = relativeUrls.reduce((set, relative) => {
+                try {
+                    const absolute = new URL(relative, url).toString();
+                    set[absolute] = cssIncludes[relative];
+                }
+                catch (err) {
+                    // Ignore invalid URLs.
+                    // eslint-disable-next-line no-console
+                    console.log(`Could not absolutify URL: ${relative}`);
+                }
+                return set;
+            }, {});
+            await cssFiles.addMultiple(url, absoluteIncludes);
+            const internalStyles = await browserInterface.getInternalStyles(url);
+            await cssFiles.addInternalStyles(url, internalStyles);
+            // Abort early if we hit the critical mass
+            successes++;
+            if (successes >= maxPages) {
+                break;
+            }
+        }
+        catch (err) {
+            errors[url] = err;
+        }
+    }
+    return [cssFiles, errors];
+}
+/**
+ * Get CSS selectors for above the fold content for the valid URLs.
+ *
+ * @param {object}           param                  - All the parameters as object.
+ * @param {BrowserInterface} param.browserInterface - Interface to access pages
+ * @param {object}           param.selectorPages    - All the CSS selectors to URLs map object
+ * @param {string[]}         param.validUrls        - List of all the valid URLs
+ * @param {Array}            param.viewports        - Browser viewports
+ * @param {number}           param.maxPages         - Maximum number of pages to process
+ * @param {Function}         param.updateProgress   - Update progress callback function
+ *
+ * @return {Set<string>} - List of above the fold selectors.
+ */
+async function getAboveFoldSelectors({ browserInterface, selectorPages, validUrls, viewports, maxPages, updateProgress, }) {
+    // For each selector string, create a "trimmed" version with the stuff JavaScript can't handle cut out.
+    const trimmedSelectors = Object.keys(selectorPages).reduce((set, selector) => {
+        set[selector] = removeIgnoredPseudoElements(selector);
+        return set;
+    }, {});
+    // Go through all the URLs looking for above-the-fold selectors, and selectors which may be "dangerous"
+    // i.e.: may match elements on pages that do not include their CSS file.
+    const aboveFoldSelectors = new Set();
+    const dangerousSelectors = new Set();
+    for (const url of validUrls.slice(0, maxPages)) {
+        // Work out which CSS selectors match any element on this page.
+        const pageSelectors = await browserInterface.runInPage(url, null, BrowserInterface.innerFindMatchingSelectors, trimmedSelectors);
+        // Check for selectors which may match this page, but are not included in this page's CSS.
+        pageSelectors
+            .filter(s => !selectorPages[s].has(url))
+            .forEach(s => dangerousSelectors.add(s));
+        // Collate all above-fold selectors for all viewport sizes.
+        for (const size of viewports) {
+            updateProgress();
+            const pageAboveFold = await browserInterface.runInPage(url, size, BrowserInterface.innerFindAboveFoldSelectors, trimmedSelectors, pageSelectors);
+            pageAboveFold.forEach(s => aboveFoldSelectors.add(s));
+        }
+    }
+    // Remove dangerous selectors from above fold set.
+    for (const dangerousSelector of dangerousSelectors) {
+        aboveFoldSelectors.delete(dangerousSelector);
+    }
+    return aboveFoldSelectors;
+}
+/**
+ * Generates critical CSS for the given URLs and viewports.
+ *
+ * @param {object}           root0                  - The options object
+ * @param {BrowserInterface} root0.browserInterface - Interface to interact with the browser
+ * @param {Function}         root0.progressCallback - Optional callback function to report progress
+ * @param {string[]}         root0.urls             - Array of URLs to generate critical CSS for
+ * @param {Viewport[]}       root0.viewports        - Array of viewport sizes to consider
+ * @param {FilterSpec}       root0.filters          - Optional filters to apply to the CSS
+ * @param {number}           root0.successRatio     - Ratio of successful URLs required (default: 1)
+ * @param {number}           root0.maxPages         - Maximum number of pages to process (default: 10)
+ * @return {Promise<[string, Error[]]>} A promise that resolves to an array containing the critical CSS string and an array of errors.
+ */
+export async function generateCriticalCSS({ browserInterface, progressCallback, urls, viewports, filters, successRatio = 1, maxPages = 10, }) {
+    // Success threshold is calculated based on the success ratio of "the number of URLs provided", or "maxPages" whichever is lower.
+    // See 268-gh-Automattic/boost-cloud
+    const successUrlsThreshold = Math.ceil(Math.min(urls.length, maxPages) * successRatio);
+    try {
+        progressCallback = progressCallback || noop;
+        let progress = 0;
+        const progressSteps = 1 + urls.length * viewports.length;
+        const updateProgress = () => progressCallback(++progress, progressSteps);
+        // Collate all CSS Files used by all valid URLs.
+        const [cssFiles, cssFileErrors] = await collateCssFiles(browserInterface, urls, maxPages);
+        updateProgress();
+        // Verify there are enough valid URLs to carry on with.
+        const validUrls = browserInterface.filterValidUrls(urls);
+        if (validUrls.length < successUrlsThreshold) {
+            throw new SuccessTargetError(cssFileErrors);
+        }
+        // Trim ignored rules out of all CSS ASTs.
+        cssFiles.applyFilters(filters || {});
+        // Gather a record of all selectors, and which page URLs each is referenced by.
+        const selectorPages = cssFiles.collateSelectorPages();
+        // Get CSS selectors for above the fold.
+        const aboveFoldSelectors = await getAboveFoldSelectors({
+            browserInterface,
+            selectorPages,
+            validUrls,
+            viewports,
+            maxPages,
+            updateProgress,
+        });
+        // Prune each AST for above-fold selector list. Note: this prunes a clone.
+        const asts = cssFiles.prunedAsts(aboveFoldSelectors);
+        // Convert ASTs to CSS.
+        const [css, cssErrors] = minifyCss(asts.map(ast => ast.toCSS()).join('\n'));
+        // If there is no Critical CSS, it means the URLs did not have any CSS in their external style sheet(s).
+        if (!css) {
+            const emptyCSSErrors = {};
+            for (const url of validUrls) {
+                emptyCSSErrors[url] = new EmptyCSSError({ url });
+            }
+            throw new SuccessTargetError(emptyCSSErrors);
+        }
+        // Collect warnings / errors together.
+        const warnings = cssFiles.getErrors().concat(cssErrors.map(s => new Error(s)));
+        return [css, warnings];
+    }
+    finally {
+        browserInterface.cleanup();
+    }
+}
+//# sourceMappingURL=generate-critical-css.js.map

package/build/generate-critical-css.js.map

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

package/build/ignored-pseudo-elements.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Remove pseudo elements that are ignored while matching elements above the fold.
+ *
+ * @param {string} selector - selector to filter.
+ *
+ * @return {string} selector with ignored pseudo elements removed.
+ */
+export declare function removeIgnoredPseudoElements(selector: string): string;

package/build/ignored-pseudo-elements.js

@@ -0,0 +1,35 @@
+const ignoredPseudoElements = [
+    'after',
+    'before',
+    'first-(line|letter)',
+    '(input-)?placeholder',
+    'scrollbar',
+    'search(results-)?decoration',
+    'search-(cancel|results)-button',
+];
+let removePseudoElementRegex;
+/**
+ * Builds a RegExp for finding pseudo elements that should be ignored while matching
+ * elements that are above the fold.
+ *
+ * @return {RegExp} A RegExp to use when removing unwanted pseudo elements.
+ */
+function getRemovePseudoElementRegex() {
+    if (removePseudoElementRegex) {
+        return removePseudoElementRegex;
+    }
+    const allIgnored = ignoredPseudoElements.join('|');
+    removePseudoElementRegex = new RegExp('::?(-(moz|ms|webkit)-)?(' + allIgnored + ')');
+    return removePseudoElementRegex;
+}
+/**
+ * Remove pseudo elements that are ignored while matching elements above the fold.
+ *
+ * @param {string} selector - selector to filter.
+ *
+ * @return {string} selector with ignored pseudo elements removed.
+ */
+export function removeIgnoredPseudoElements(selector) {
+    return selector.replace(getRemovePseudoElementRegex(), '').trim();
+}
+//# sourceMappingURL=ignored-pseudo-elements.js.map

package/build/ignored-pseudo-elements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignored-pseudo-elements.js","sourceRoot":"","sources":["../src/ignored-pseudo-elements.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAAG;IAC7B,OAAO;IACP,QAAQ;IACR,qBAAqB;IACrB,sBAAsB;IACtB,WAAW;IACX,6BAA6B;IAC7B,gCAAgC;CAChC,CAAC;AAEF,IAAI,wBAAgC,CAAC;AAErC;;;;;GAKG;AACH,SAAS,2BAA2B;IACnC,IAAK,wBAAwB,EAAG;QAC/B,OAAO,wBAAwB,CAAC;KAChC;IAED,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAE,GAAG,CAAE,CAAC;IACrD,wBAAwB,GAAG,IAAI,MAAM,CAAE,0BAA0B,GAAG,UAAU,GAAG,GAAG,CAAE,CAAC;IAEvF,OAAO,wBAAwB,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAE,QAAgB;IAC5D,OAAO,QAAQ,CAAC,OAAO,CAAE,2BAA2B,EAAE,EAAE,EAAE,CAAE,CAAC,IAAI,EAAE,CAAC;AACrE,CAAC"}

package/build/minify-css.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Minifies the given CSS, returning it as a string. Any errors that occur are returned
+ * in the second positional return value.
+ *
+ * If the CSS fails to minify, the original content will be returned instead.
+ *
+ * @param {string} css - CSS to minify.
+ *
+ * @return {[ string, string[] ]} - Minified CSS and a list of errors returned.
+ */
+export declare function minifyCss(css: string): [string, string[]];

package/build/minify-css.js

@@ -0,0 +1,19 @@
+import CleanCSS from 'clean-css';
+/**
+ * Minifies the given CSS, returning it as a string. Any errors that occur are returned
+ * in the second positional return value.
+ *
+ * If the CSS fails to minify, the original content will be returned instead.
+ *
+ * @param {string} css - CSS to minify.
+ *
+ * @return {[ string, string[] ]} - Minified CSS and a list of errors returned.
+ */
+export function minifyCss(css) {
+    const result = new CleanCSS().minify(css);
+    if (!result.styles) {
+        return [css, result.errors];
+    }
+    return [result.styles, result.errors];
+}
+//# sourceMappingURL=minify-css.js.map

package/build/minify-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minify-css.js","sourceRoot":"","sources":["../src/minify-css.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAE,GAAW;IACrC,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC,MAAM,CAAE,GAAG,CAAE,CAAC;IAE5C,IAAK,CAAE,MAAM,CAAC,MAAM,EAAG;QACtB,OAAO,CAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAE,CAAC;KAC9B;IAED,OAAO,CAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAE,CAAC;AACzC,CAAC"}

package/build/object-promise-all.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Given an object full of promises, resolves all of them and returns an object containing resultant values.
+ * Roughly equivalent of Promise.all, but applies to an object.
+ *
+ * @param {object} object - containing promises to resolve
+ * @return {object} - Promise which resolves to an object containing resultant values
+ */
+export declare function objectPromiseAll<ValueType>(object: {
+    [key: string]: Promise<ValueType>;
+}): Promise<{
+    [key: string]: ValueType;
+}>;

package/build/object-promise-all.js

@@ -0,0 +1,16 @@
+/**
+ * Given an object full of promises, resolves all of them and returns an object containing resultant values.
+ * Roughly equivalent of Promise.all, but applies to an object.
+ *
+ * @param {object} object - containing promises to resolve
+ * @return {object} - Promise which resolves to an object containing resultant values
+ */
+export async function objectPromiseAll(object) {
+    const keys = Object.keys(object);
+    const values = await Promise.all(keys.map(key => object[key]));
+    return keys.reduce((acc, key, index) => {
+        acc[key] = values[index];
+        return acc;
+    }, {});
+}
+//# sourceMappingURL=object-promise-all.js.map

package/build/object-promise-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-promise-all.js","sourceRoot":"","sources":["../src/object-promise-all.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAe,MAEpD;IACA,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAE,MAAM,CAAE,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAE,IAAI,CAAC,GAAG,CAAE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAE,GAAG,CAAE,CAAE,CAAE,CAAC;IAErE,OAAO,IAAI,CAAC,MAAM,CACjB,CAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAG,EAAE;QACrB,GAAG,CAAE,GAAG,CAAE,GAAG,MAAM,CAAE,KAAK,CAAE,CAAC;QAC7B,OAAO,GAAG,CAAC;IACZ,CAAC,EACD,EAAoC,CACpC,CAAC;AACH,CAAC"}

package/build/playwright.d.ts

@@ -0,0 +1,5 @@
+export { BrowserInterfacePlaywright } from './browser-interface-playwright.js';
+export { BrowserInterface } from './browser-interface.js';
+export { generateCriticalCSS } from './generate-critical-css.js';
+export * from './errors.js';
+export declare const version = "0.0.11";

package/build/playwright.js

@@ -0,0 +1,6 @@
+export { BrowserInterfacePlaywright } from './browser-interface-playwright.js';
+export { BrowserInterface } from './browser-interface.js';
+export { generateCriticalCSS } from './generate-critical-css.js';
+export * from './errors.js';
+export const version = '0.0.11';
+//# sourceMappingURL=playwright.js.map

package/build/playwright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.js","sourceRoot":"","sources":["../src/playwright.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,cAAc,aAAa,CAAC;AAE5B,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC"}

package/build/style-ast.d.ts

@@ -0,0 +1,164 @@
+import * as csstree from 'css-tree';
+import { AtRuleFilter, FilterSpec, PropertiesFilter } from './types.js';
+/**
+ * Represents an Abstract Syntax Tree for a CSS file (as generated by css-tree) and contains helper
+ * methods for pruning and rearranging it.
+ */
+export declare class StyleAST {
+    private css;
+    private ast;
+    private errors;
+    constructor(css: string, ast: csstree.CssNode, errors: Error[]);
+    /**
+     * Given a base URL (where the CSS file this AST was built from), find all relative URLs and
+     * convert them to absolute.
+     *
+     * @param {string} base - base URL for relative URLs.
+     */
+    absolutifyUrls(base: string): void;
+    /**
+     * Returns a new StyleAST with content from this one pruned based on the specified contentWindow
+     * and criticalSelectors to keep.
+     *
+     * Removes:
+     * - Irrelevant media queries
+     * - Selectors not included in criticalSelectors
+     * - Excluded properties
+     * - Large embeds
+     * - Empty rules
+     *
+     * @param {Set< string >} criticalSelectors - Set of selectors to keep in the new AST.
+     *
+     * @return {StyleAST} - New AST with pruned contents.
+     */
+    pruned(criticalSelectors: Set<string>): StyleAST;
+    /**
+     * Given an AST node, returns the original text it was compiled from in the source CSS.
+     *
+     * @param {object} node - Node from the AST.
+     * @return {string} original text the node was compiled from.
+     */
+    originalText(node: csstree.CssNode): string;
+    /**
+     * Applies filters to the properties or atRules in this AST. Mutates the AST in-place.
+     *
+     * @param {FilterSpec} filters - Object containing property and atRule filter functions.
+     */
+    applyFilters(filters: FilterSpec): void;
+    /**
+     * Applies a filter to the properties in this AST. Mutates the AST in-place.
+     *
+     * @param {Function} filter - to apply.
+     */
+    applyPropertiesFilter(filter: PropertiesFilter): void;
+    /**
+     * Applies a filter to the atRules in this AST. Mutates the AST in-place.
+     *
+     * @param {Function} filter - to apply.
+     */
+    applyAtRulesFilter(filter: AtRuleFilter): void;
+    /**
+     * Remove variables that do not appear in the usedVariables set. Returns a count of variables
+     * that were removed.
+     *
+     * @param {Set< string >} usedVariables - Set of used variables to keep.
+     * @return {number} variables pruned.
+     */
+    pruneUnusedVariables(usedVariables: Set<string>): number;
+    /**
+     * Find all variables that are used and return them as a Set.
+     * @return {Set< string >} Set of used variables.
+     */
+    getUsedVariables(): Set<string>;
+    /**
+     * Remove all comments from the syntax tree.
+     */
+    pruneComments(): void;
+    /**
+     * Remove media queries that only apply to print.
+     */
+    pruneMediaQueries(): void;
+    /**
+     * Remove unwanted at-rules.
+     *
+     * @param { string[] } names - Names of at-rules to remove, excluding the at symbol.
+     */
+    pruneAtRules(names: string[]): void;
+    /**
+     * Returns true if the given CSS rule object relates to animation keyframes.
+     *
+     * @param {csstree.WalkContext} rule - CSS rule.
+     * @return {boolean} True if the rule is a keyframe rule, false otherwise.
+     */
+    static isKeyframeRule(rule: csstree.WalkContext): boolean;
+    /**
+     * Walks this AST and calls the specified callback with each selector found (as text).
+     * Skips any selectors in the excludedSelectors constant.
+     *
+     * @param {Function} callback - Callback to call with each selector.
+     */
+    forEachSelector(callback: (selector: string) => void): void;
+    /**
+     * Remove any selectors not listed in the criticalSelectors set, deleting any
+     * rules that no longer have any selectors in their prelude.
+     *
+     * @param {Set< string >} criticalSelector - Set of critical selectors.
+     */
+    pruneNonCriticalSelectors(criticalSelector: Set<string>): void;
+    /**
+     * Remove any Base64 embedded content which exceeds maxBase64Length.
+     */
+    pruneLargeBase64Embeds(): void;
+    /**
+     * Remove any properties that match the regular expressions in the excludedProperties constant.
+     */
+    pruneExcludedProperties(): void;
+    /**
+     * Remove any fonts which are not in the specified whitelist.
+     *
+     * @param {Set< string >} fontWhitelist - Whitelisted font.
+     */
+    pruneNonCriticalFonts(fontWhitelist: Set<string>): void;
+    /**
+     * Returns a count of the rules in this Style AST.
+     *
+     * @return {number} rules in this AST.
+     */
+    ruleCount(): number;
+    /**
+     * Returns a list of font families that are used by any rule in this AST.
+     *
+     * @return {Set<string>} Set of used fonts.
+     */
+    getUsedFontFamilies(): Set<string>;
+    /**
+     * Given an AST node, read it as a value based on its type. Removes quote marks from
+     * string types if present.
+     *
+     * @param {csstree.CssNode} node - AST node.
+     * @return {string} The value of the node as a string.
+     */
+    static readValue(node: csstree.CssNode): string;
+    /**
+     * Returns true if the specified media query node is relevant to screen rendering.
+     *
+     * @param {object} mediaQueryNode - Media Query AST node to examine.
+     *
+     * @return {boolean} true if the media query is relevant to screens.
+     */
+    static isUsefulMediaQuery(mediaQueryNode: csstree.MediaQuery): boolean;
+    /**
+     * Returns this AST converted to CSS.
+     *
+     * @return {string} this AST represented in CSS.
+     */
+    toCSS(): string;
+    /**
+     * Static method to parse a block of CSS and return a new StyleAST object which represents it.
+     *
+     * @param {string} css - CSS to parse.
+     *
+     * @return {StyleAST} new parse AST based on the CSS.
+     */
+    static parse(css: string): StyleAST;
+}