@code-pushup/lighthouse-plugin 0.55.0 → 0.57.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@code-pushup/lighthouse-plugin",
-  "version": "0.55.0",
+  "version": "0.57.0",
   "license": "MIT",
   "description": "Code PushUp plugin for measuring web performance and quality with Lighthouse 🔥",
   "homepage": "https://github.com/code-pushup/cli/tree/main/packages/plugin-lighthouse#readme",
@@ -35,14 +35,15 @@
     "access": "public"
   },
   "type": "module",
-  "main": "./index.js",
-  "types": "./src/index.d.ts",
   "dependencies": {
-    "@code-pushup/models": "0.55.0",
-    "@code-pushup/utils": "0.55.0",
+    "@code-pushup/models": "0.57.0",
+    "@code-pushup/utils": "0.57.0",
     "ansis": "^3.3.0",
     "chrome-launcher": "^1.1.1",
     "lighthouse": "^12.0.0",
     "lighthouse-logger": "2.0.1"
-  }
-}
+  },
+  "module": "./src/index.js",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts"
+}

package/src/index.d.ts

@@ -1,7 +1,7 @@
-import { lighthousePlugin } from './lib/lighthouse-plugin';
-export { LIGHTHOUSE_REPORT_NAME } from './lib/runner';
-export { DEFAULT_CHROME_FLAGS, LIGHTHOUSE_PLUGIN_SLUG, LIGHTHOUSE_OUTPUT_PATH, } from './lib/constants';
-export { lighthouseAuditRef, lighthouseGroupRef, type LighthouseGroupSlugs, } from './lib/utils';
-export type { LighthouseOptions } from './lib/types';
-export { lighthousePlugin } from './lib/lighthouse-plugin';
+import { lighthousePlugin } from './lib/lighthouse-plugin.js';
+export { LIGHTHOUSE_REPORT_NAME } from './lib/runner/constants.js';
+export { DEFAULT_CHROME_FLAGS, LIGHTHOUSE_PLUGIN_SLUG, LIGHTHOUSE_OUTPUT_PATH, } from './lib/constants.js';
+export { lighthouseAuditRef, lighthouseGroupRef, type LighthouseGroupSlugs, } from './lib/utils.js';
+export type { LighthouseOptions } from './lib/types.js';
+export { lighthousePlugin } from './lib/lighthouse-plugin.js';
 export default lighthousePlugin;

package/src/index.js

@@ -0,0 +1,7 @@
+import { lighthousePlugin } from './lib/lighthouse-plugin.js';
+export { LIGHTHOUSE_REPORT_NAME } from './lib/runner/constants.js';
+export { DEFAULT_CHROME_FLAGS, LIGHTHOUSE_PLUGIN_SLUG, LIGHTHOUSE_OUTPUT_PATH, } from './lib/constants.js';
+export { lighthouseAuditRef, lighthouseGroupRef, } from './lib/utils.js';
+export { lighthousePlugin } from './lib/lighthouse-plugin.js';
+export default lighthousePlugin;
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/plugin-lighthouse/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,eAAe,gBAAgB,CAAC"}

package/src/lib/constants.js

@@ -0,0 +1,8 @@
+import { DEFAULT_FLAGS } from 'chrome-launcher/dist/flags.js';
+import path from 'node:path';
+import { DEFAULT_PERSIST_OUTPUT_DIR } from '@code-pushup/models';
+// headless is needed to pass CI on Linux and Windows (locally it works without headless too)
+export const DEFAULT_CHROME_FLAGS = [...DEFAULT_FLAGS, '--headless'];
+export const LIGHTHOUSE_PLUGIN_SLUG = 'lighthouse';
+export const LIGHTHOUSE_OUTPUT_PATH = path.join(DEFAULT_PERSIST_OUTPUT_DIR, LIGHTHOUSE_PLUGIN_SLUG);
+//# sourceMappingURL=constants.js.map

package/src/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../packages/plugin-lighthouse/src/lib/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAEjE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAG,aAAa,EAAE,YAAY,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,sBAAsB,GAAG,YAAY,CAAC;AACnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,IAAI,CAC7C,0BAA0B,EAC1B,sBAAsB,CACvB,CAAC"}

package/src/lib/lighthouse-plugin.d.ts

@@ -1,3 +1,3 @@
 import type { PluginConfig } from '@code-pushup/models';
-import type { LighthouseOptions } from './types';
+import type { LighthouseOptions } from './types.js';
 export declare function lighthousePlugin(url: string, flags?: LighthouseOptions): PluginConfig;

package/src/lib/lighthouse-plugin.js

@@ -0,0 +1,27 @@
+import { createRequire } from 'node:module';
+import { LIGHTHOUSE_PLUGIN_SLUG } from './constants.js';
+import { normalizeFlags } from './normalize-flags.js';
+import { LIGHTHOUSE_GROUPS, LIGHTHOUSE_NAVIGATION_AUDITS, } from './runner/constants.js';
+import { createRunnerFunction } from './runner/runner.js';
+import { filterAuditsAndGroupsByOnlyOptions } from './utils.js';
+export function lighthousePlugin(url, flags) {
+    const { skipAudits, onlyAudits, onlyCategories, ...unparsedFlags } = normalizeFlags(flags ?? {});
+    const { audits, groups } = filterAuditsAndGroupsByOnlyOptions(LIGHTHOUSE_NAVIGATION_AUDITS, LIGHTHOUSE_GROUPS, { skipAudits, onlyAudits, onlyCategories });
+    const packageJson = createRequire(import.meta.url)('../../package.json');
+    return {
+        slug: LIGHTHOUSE_PLUGIN_SLUG,
+        packageName: packageJson.name,
+        version: packageJson.version,
+        title: 'Lighthouse',
+        icon: 'lighthouse',
+        audits,
+        groups,
+        runner: createRunnerFunction(url, {
+            skipAudits,
+            onlyAudits,
+            onlyCategories,
+            ...unparsedFlags,
+        }),
+    };
+}
+//# sourceMappingURL=lighthouse-plugin.js.map

package/src/lib/lighthouse-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lighthouse-plugin.js","sourceRoot":"","sources":["../../../../../packages/plugin-lighthouse/src/lib/lighthouse-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,KAAyB;IAEzB,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE,GAChE,cAAc,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAE9B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,kCAAkC,CAC3D,4BAA4B,EAC5B,iBAAiB,EACjB,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,CAC3C,CAAC;IAEF,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAChD,oBAAoB,CACkB,CAAC;IAEzC,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,WAAW,CAAC,IAAI;QAC7B,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,YAAY;QAClB,MAAM;QACN,MAAM;QACN,MAAM,EAAE,oBAAoB,CAAC,GAAG,EAAE;YAChC,UAAU;YACV,UAAU;YACV,cAAc;YACd,GAAG,aAAa;SACjB,CAAC;KACH,CAAC;AACJ,CAAC"}

package/src/lib/normalize-flags.d.ts

@@ -1,5 +1,5 @@
-import { type LighthouseCliFlags } from './runner';
-import type { LighthouseOptions } from './types';
+import type { LighthouseCliFlags } from './runner/types.js';
+import type { LighthouseOptions } from './types.js';
 export declare const DEFAULT_LIGHTHOUSE_OPTIONS: {
     onlyGroups: never[];
     verbose: false;

package/src/lib/normalize-flags.js

@@ -0,0 +1,55 @@
+import { bold, yellow } from 'ansis';
+import { ui } from '@code-pushup/utils';
+import { LIGHTHOUSE_PLUGIN_SLUG } from './constants.js';
+import { DEFAULT_CLI_FLAGS } from './runner/constants.js';
+const { onlyCategories, ...originalDefaultCliFlags } = DEFAULT_CLI_FLAGS;
+export const DEFAULT_LIGHTHOUSE_OPTIONS = {
+    ...originalDefaultCliFlags,
+    onlyGroups: onlyCategories,
+};
+// NOTE:
+// This is an intermediate variable to get `UnsupportedCliFlags`. For unknown reasons `typescript@5.3.3` doesn't work otherwise.
+const lighthouseUnsupportedCliFlags = [
+    'precomputedLanternDataPath', // Path to the file where precomputed lantern data should be read from.
+    'chromeIgnoreDefaultFlags', // ignore default flags from Lighthouse CLI
+    // No error reporting implemented as in the source Sentry was involved
+    // See: https://github.com/GoogleChrome/lighthouse/blob/d8ccf70692216b7fa047a4eaa2d1277b0b7fe947/cli/bin.js#L124
+    'enableErrorReporting', // enable error reporting
+    // lighthouse CLI specific debug logs
+    'list-all-audits', // Prints a list of all available audits and exits.
+    'list-locales', // Prints a list of all supported locales and exits.
+    'list-trace-categories', // Prints a list of all required trace categories and exits.
+];
+const LIGHTHOUSE_UNSUPPORTED_CLI_FLAGS = new Set(lighthouseUnsupportedCliFlags);
+const REFINED_STRING_OR_STRING_ARRAY = new Set([
+    'onlyAudits',
+    'onlyCategories',
+    'skipAudits',
+    'budgets',
+    'chromeFlags',
+]);
+export function normalizeFlags(flags) {
+    const prefilledFlags = { ...DEFAULT_LIGHTHOUSE_OPTIONS, ...flags };
+    logUnsupportedFlagsInUse(prefilledFlags);
+    return Object.fromEntries(Object.entries(prefilledFlags)
+        .filter(([flagName]) => !LIGHTHOUSE_UNSUPPORTED_CLI_FLAGS.has(flagName))
+        // in code-pushup lighthouse categories are mapped as groups, therefor we had to rename "onlyCategories" to "onlyGroups" for the user of the plugin as it was confusing
+        .map(([key, v]) => [key === 'onlyGroups' ? 'onlyCategories' : key, v])
+        // onlyAudits and onlyCategories cannot be empty arrays, otherwise skipAudits is ignored by lighthouse
+        .filter(([_, v]) => !(Array.isArray(v) && v.length === 0))
+        // undefined | string | string[] => string[] (empty for undefined)
+        .map(([key, v]) => {
+        if (!REFINED_STRING_OR_STRING_ARRAY.has(key)) {
+            return [key, v];
+        }
+        return [key, Array.isArray(v) ? v : v == null ? [] : [v]];
+    }));
+}
+export function logUnsupportedFlagsInUse(flags, displayCount = 3) {
+    const unsupportedFlagsInUse = Object.keys(flags).filter(flag => LIGHTHOUSE_UNSUPPORTED_CLI_FLAGS.has(flag));
+    if (unsupportedFlagsInUse.length > 0) {
+        const postFix = (count) => count > displayCount ? ` and ${count - displayCount} more.` : '';
+        ui().logger.debug(`${yellow('⚠')} Plugin ${bold(LIGHTHOUSE_PLUGIN_SLUG)} used unsupported flags: ${bold(unsupportedFlagsInUse.slice(0, displayCount).join(', '))}${postFix(unsupportedFlagsInUse.length)}`);
+    }
+}
+//# sourceMappingURL=normalize-flags.js.map

package/src/lib/normalize-flags.js.map

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

package/src/lib/runner/constants.js

@@ -0,0 +1,78 @@
+import { defaultConfig, } from 'lighthouse';
+import path from 'node:path';
+import { DEFAULT_CHROME_FLAGS, LIGHTHOUSE_OUTPUT_PATH } from '../constants.js';
+const { audits, categories } = defaultConfig;
+// internal intermediate variable to derive the relevant audits
+const allRawLighthouseAudits = await Promise.all((audits ?? []).map(loadLighthouseAudit));
+export const PLUGIN_SLUG = 'lighthouse';
+export const LIGHTHOUSE_NAVIGATION_AUDITS = allRawLighthouseAudits
+    // This plugin only supports the "navigation" mode of Lighthouse in the current implementation
+    // If we don't exclude other audits we throw in the plugin output validation as some of the provided audits are not included in `lighthouse-report.json`
+    .filter(audit => audit.meta.supportedModes == null ||
+    (Array.isArray(audit.meta.supportedModes) &&
+        audit.meta.supportedModes.includes('navigation')))
+    .map(audit => ({
+    slug: audit.meta.id,
+    title: getMetaString(audit.meta.title),
+    description: getMetaString(audit.meta.description),
+}));
+const navigationAuditSlugs = new Set(LIGHTHOUSE_NAVIGATION_AUDITS.map(({ slug }) => slug));
+export const LIGHTHOUSE_GROUPS = Object.entries(categories ?? {}).map(([id, category]) => ({
+    slug: id,
+    title: getMetaString(category.title),
+    ...(category.description && {
+        description: getMetaString(category.description),
+    }),
+    refs: category.auditRefs
+        .filter(({ id: auditSlug }) => navigationAuditSlugs.has(auditSlug))
+        .map(ref => ({
+        slug: ref.id,
+        weight: ref.weight,
+    })),
+}));
+function getMetaString(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    return value.formattedDefault;
+}
+async function loadLighthouseAudit(value) {
+    // the passed value directly includes the implementation as JS object
+    //   shape: { implementation: typeof LHAudit; options?: {}; }
+    if (typeof value === 'object' && 'implementation' in value) {
+        return value.implementation;
+    }
+    // the passed value is a `LH.Audit` class instance
+    //   shape: LHAudit
+    if (typeof value === 'function') {
+        return value;
+    }
+    // the passed value is the path directly
+    //   shape: string
+    // otherwise it is a JS object maintaining a `path` property
+    //   shape: { path: string, options?: {}; }
+    const file = typeof value === 'string' ? value : value.path;
+    const module = (await import(`lighthouse/core/audits/${file}.js`));
+    return module.default;
+}
+export const LIGHTHOUSE_REPORT_NAME = 'lighthouse-report.json';
+export const DEFAULT_CLI_FLAGS = {
+    // default values extracted from
+    // https://github.com/GoogleChrome/lighthouse/blob/7d80178c37a1b600ea8f092fc0b098029799a659/cli/cli-flags.js#L80
+    verbose: false,
+    saveAssets: false,
+    chromeFlags: DEFAULT_CHROME_FLAGS,
+    port: 0,
+    hostname: '127.0.0.1',
+    view: false,
+    channel: 'cli',
+    // custom overwrites in favour of the plugin
+    // hide logs by default
+    quiet: true,
+    onlyAudits: [],
+    skipAudits: [],
+    onlyCategories: [],
+    output: ['json'],
+    outputPath: path.join(LIGHTHOUSE_OUTPUT_PATH, LIGHTHOUSE_REPORT_NAME),
+};
+//# sourceMappingURL=constants.js.map

package/src/lib/runner/constants.js.map

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

package/src/lib/runner/details/details.js

@@ -0,0 +1,40 @@
+import { bold, yellow } from 'ansis';
+import { ui } from '@code-pushup/utils';
+import { PLUGIN_SLUG } from '../constants.js';
+import { parseOpportunityToAuditDetailsTable } from './opportunity.type.js';
+import { parseTableToAuditDetailsTable } from './table.type.js';
+export function toAuditDetails(details) {
+    if (details == null) {
+        return {};
+    }
+    const { type } = details;
+    switch (type) {
+        case 'table':
+            const table = parseTableToAuditDetailsTable(details);
+            return table ? { table } : {};
+        case 'opportunity':
+            const opportunity = parseOpportunityToAuditDetailsTable(details);
+            return opportunity ? { table: opportunity } : {};
+    }
+    return {};
+}
+// @TODO implement all details
+export const unsupportedDetailTypes = new Set([
+    'debugdata',
+    'treemap-data',
+    'screenshot',
+    'filmstrip',
+    'criticalrequestchain',
+]);
+export function logUnsupportedDetails(lhrAudits, { displayCount = 3 } = {}) {
+    const slugsWithDetailParsingErrors = [
+        ...new Set(lhrAudits
+            .filter(({ details }) => unsupportedDetailTypes.has(details?.type))
+            .map(({ details }) => details?.type)),
+    ];
+    if (slugsWithDetailParsingErrors.length > 0) {
+        const postFix = (count) => count > displayCount ? ` and ${count - displayCount} more.` : '';
+        ui().logger.debug(`${yellow('⚠')} Plugin ${bold(PLUGIN_SLUG)} skipped parsing of unsupported audit details: ${bold(slugsWithDetailParsingErrors.slice(0, displayCount).join(', '))}${postFix(slugsWithDetailParsingErrors.length)}`);
+    }
+}
+//# sourceMappingURL=details.js.map

package/src/lib/runner/details/details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.js","sourceRoot":"","sources":["../../../../../../../packages/plugin-lighthouse/src/lib/runner/details/details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAKrC,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,UAAU,cAAc,CAC5B,OAAsB;IAEtB,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEzB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,MAAM,KAAK,GAAsB,6BAA6B,CAAC,OAAO,CAAC,CAAC;YACxE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,KAAK,aAAa;YAChB,MAAM,WAAW,GACf,mCAAmC,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,8BAA8B;AAC9B,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IAC5C,WAAW;IACX,cAAc;IACd,YAAY;IACZ,WAAW;IACX,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CACnC,SAAmB,EACnB,EAAE,YAAY,GAAG,CAAC,KAAgC,EAAE;IAEpD,MAAM,4BAA4B,GAAG;QACnC,GAAG,IAAI,GAAG,CACR,SAAS;aACN,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CACtB,sBAAsB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAc,CAAC,CACpD;aACA,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CACvC;KACF,CAAC;IACF,IAAI,4BAA4B,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,EAAE,CAChC,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,KAAK,GAAG,YAAY,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CACf,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,IAAI,CAC3B,WAAW,CACZ,kDAAkD,IAAI,CACrD,4BAA4B,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC/D,GAAG,OAAO,CAAC,4BAA4B,CAAC,MAAM,CAAC,EAAE,CACnD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/src/lib/runner/details/item-value.js

@@ -0,0 +1,120 @@
+import { bold } from 'ansis';
+import { formatBytes, formatDuration, html, truncateText, ui, } from '@code-pushup/utils';
+export function trimSlice(item, maxLength = 0) {
+    const str = String(item).trim();
+    return maxLength > 0 ? str.slice(0, maxLength) : str;
+}
+export function parseNodeValue(node) {
+    const { selector = '' } = node ?? {};
+    return selector;
+}
+// eslint-disable-next-line max-lines-per-function
+export function formatTableItemPropertyValue(itemValue, itemValueFormat) {
+    // null
+    if (itemValue == null) {
+        return '';
+    }
+    // Primitive Values
+    if (itemValueFormat == null) {
+        if (typeof itemValue === 'string') {
+            return trimSlice(itemValue);
+        }
+        if (typeof itemValue === 'number') {
+            return Number(itemValue);
+        }
+        if (typeof itemValue === 'boolean') {
+            return itemValue;
+        }
+    }
+    const parsedItemValue = parseTableItemPropertyValue(itemValue);
+    /* eslint-disable @typescript-eslint/no-magic-numbers */
+    switch (itemValueFormat) {
+        case 'bytes':
+            return formatBytes(Number(parsedItemValue));
+        case 'code':
+            return html.code(trimSlice(parsedItemValue));
+        case 'link':
+            const link = parsedItemValue;
+            return html.link(link.url, link.text);
+        case 'url':
+            const url = parsedItemValue;
+            return html.link(url);
+        case 'timespanMs':
+        case 'ms':
+            return formatDuration(Number(parsedItemValue));
+        case 'node':
+            return parseNodeValue(itemValue);
+        case 'source-location':
+            return truncateText(String(parsedItemValue), 200);
+        case 'numeric':
+            const num = Number(parsedItemValue);
+            if (num.toFixed(3).toString().endsWith('.000')) {
+                return String(num);
+            }
+            return String(num.toFixed(3));
+        case 'text':
+            return truncateText(String(parsedItemValue), 500);
+        case 'multi': // @TODO
+            // @TODO log verbose first, then implement data type
+            ui().logger.info(`Format type ${bold('multi')} is not implemented`);
+            return '';
+        case 'thumbnail': // @TODO
+            // @TODO log verbose first, then implement data type
+            ui().logger.info(`Format type ${bold('thumbnail')} is not implemented`);
+            return '';
+    }
+    /* eslint-enable @typescript-eslint/no-magic-numbers */
+    return itemValue;
+}
+export function parseSimpleItemValue(item) {
+    if (typeof item === 'object') {
+        const value = item.value;
+        if (typeof value === 'object') {
+            return value.formattedDefault;
+        }
+        return value;
+    }
+    return item;
+}
+// @TODO extract Link type from logic
+export function parseTableItemPropertyValue(itemValue) {
+    if (itemValue == null) {
+        return '';
+    }
+    // Primitive Values
+    if (typeof itemValue === 'string' ||
+        typeof itemValue === 'number' ||
+        typeof itemValue === 'boolean') {
+        return parseSimpleItemValue(itemValue);
+    }
+    // Object Values
+    const objectValue = itemValue;
+    const { type } = objectValue;
+    switch (type) {
+        case 'code':
+        case 'url':
+            return String(parseSimpleItemValue(objectValue));
+        case 'node':
+            return parseNodeValue(objectValue);
+        case 'link':
+            return objectValue;
+        case 'numeric':
+            return Number(parseSimpleItemValue(objectValue));
+        case 'source-location':
+            const { url } = objectValue;
+            return String(url);
+        case 'subitems':
+            // @TODO log verbose first, then implement data type
+            ui().logger.info(`Value type ${bold('subitems')} is not implemented`);
+            return '';
+        case 'debugdata':
+            // @TODO log verbose first, then implement data type
+            ui().logger.info(`Value type ${bold('debugdata')} is not implemented`, {
+                silent: true,
+            });
+            return '';
+    }
+    // IcuMessage
+    return parseSimpleItemValue(objectValue);
+}
+//# sourceMappingURL=item-value.js.map

package/src/lib/runner/details/item-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-value.js","sourceRoot":"","sources":["../../../../../../../packages/plugin-lighthouse/src/lib/runner/details/item-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAG7B,OAAO,EACL,WAAW,EACX,cAAc,EACd,IAAI,EACJ,YAAY,EACZ,EAAE,GACH,MAAM,oBAAoB,CAAC;AAc5B,MAAM,UAAU,SAAS,CAAC,IAAyB,EAAE,SAAS,GAAG,CAAC;IAChE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAwB;IACrD,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IACrC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,4BAA4B,CAC1C,SAA6B,EAC7B,eAAuC;IAEvC,OAAO;IACP,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,mBAAmB;IACnB,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,OAAO,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAE/D,wDAAwD;IACxD,QAAQ,eAAe,EAAE,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,WAAW,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;QAC9C,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,eAAyB,CAAC,CAAC,CAAC;QACzD,KAAK,MAAM;YACT,MAAM,IAAI,GAAG,eAAoC,CAAC;YAClD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,KAAK,KAAK;YACR,MAAM,GAAG,GAAG,eAAyB,CAAC;YACtC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,KAAK,YAAY,CAAC;QAClB,KAAK,IAAI;YACP,OAAO,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;QACjD,KAAK,MAAM;YACT,OAAO,cAAc,CAAC,SAA8B,CAAC,CAAC;QACxD,KAAK,iBAAiB;YACpB,OAAO,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,CAAC;QACpD,KAAK,SAAS;YACZ,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;YACpC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,KAAK,MAAM;YACT,OAAO,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,CAAC;QACpD,KAAK,OAAO,EAAE,QAAQ;YACpB,oDAAoD;YACpD,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;YACpE,OAAO,EAAE,CAAC;QACZ,KAAK,WAAW,EAAE,QAAQ;YACxB,oDAAoD;YACpD,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;YACxE,OAAO,EAAE,CAAC;IACd,CAAC;IACD,uDAAuD;IAEvD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAqB;IAErB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,gBAAgB,CAAC;QAChC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,2BAA2B,CACzC,SAA6B;IAE7B,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,mBAAmB;IACnB,IACE,OAAO,SAAS,KAAK,QAAQ;QAC7B,OAAO,SAAS,KAAK,QAAQ;QAC7B,OAAO,SAAS,KAAK,SAAS,EAC9B,CAAC;QACD,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,gBAAgB;IAChB,MAAM,WAAW,GAAG,SAA4B,CAAC;IACjD,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC;IAC7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC;QACnD,KAAK,MAAM;YACT,OAAO,cAAc,CAAC,WAAW,CAAC,CAAC;QACrC,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC;QACnD,KAAK,iBAAiB;YACpB,MAAM,EAAE,GAAG,EAAE,GAAG,WAAW,CAAC;YAC5B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,KAAK,UAAU;YACb,oDAAoD;YACpD,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;YACtE,OAAO,EAAE,CAAC;QACZ,KAAK,WAAW;YACd,oDAAoD;YACpD,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE;gBACrE,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;YACH,OAAO,EAAE,CAAC;IACd,CAAC;IACD,aAAa;IACb,OAAO,oBAAoB,CAAC,WAA8B,CAAC,CAAC;AAC9D,CAAC"}

package/src/lib/runner/details/opportunity.type.js

@@ -0,0 +1,49 @@
+import { tableSchema, } from '@code-pushup/models';
+import { formatBytes, formatDuration, html } from '@code-pushup/utils';
+import { parseTableColumns, parseTableEntry } from './table.type.js';
+import { LighthouseAuditDetailsParsingError } from './utils.js';
+export function parseOpportunityToAuditDetailsTable(details) {
+    const { headings: rawHeadings, items } = details;
+    if (items.length === 0) {
+        return undefined;
+    }
+    try {
+        return tableSchema().parse({
+            title: 'Opportunity',
+            columns: parseTableColumns(rawHeadings),
+            rows: items.map(row => parseOpportunityItemToTableRow(row, rawHeadings)),
+        });
+    }
+    catch (error) {
+        throw new LighthouseAuditDetailsParsingError('opportunity', { items, headings: rawHeadings }, error.message.toString());
+    }
+}
+export function parseOpportunityItemToTableRow(opportunityItem, headings) {
+    const keys = new Set(headings.map(({ key }) => key));
+    const valueTypesByKey = new Map(headings.map(({ key, valueType }) => [key, valueType]));
+    return {
+        ...Object.fromEntries(Object.entries(opportunityItem)
+            // forward only properties with a given value
+            .filter(([key]) => keys.has(key))
+            .map(([key, value]) => {
+            const valueType = valueTypesByKey.get(key);
+            return parseOpportunityEntry([key, value], valueType);
+        })),
+    };
+}
+export function parseOpportunityEntry([key, value], valueType) {
+    switch (key) {
+        case 'url':
+            return [key, html.link(String(value))];
+        case 'wastedPercent':
+            return [key, `${Number(value).toFixed(2)} %`];
+        case 'totalBytes':
+        case 'wastedBytes':
+            return [key, formatBytes(Number(value))];
+        case 'wastedMs':
+            return [key, formatDuration(Number(value))];
+        default:
+            return parseTableEntry([key, value], valueType);
+    }
+}
+//# sourceMappingURL=opportunity.type.js.map

package/src/lib/runner/details/opportunity.type.js.map

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

package/src/lib/runner/details/table.type.js

@@ -0,0 +1,42 @@
+import { tableSchema, } from '@code-pushup/models';
+import { formatTableItemPropertyValue } from './item-value.js';
+import { LighthouseAuditDetailsParsingError } from './utils.js';
+export function parseTableToAuditDetailsTable(details) {
+    const { headings: rawHeadings, items } = details;
+    if (items.length === 0) {
+        return undefined;
+    }
+    try {
+        return tableSchema().parse({
+            columns: parseTableColumns(rawHeadings),
+            rows: items.map(row => parseTableRow(row, rawHeadings)),
+        });
+    }
+    catch (error) {
+        throw new LighthouseAuditDetailsParsingError('table', { items, headings: rawHeadings }, error.message.toString());
+    }
+}
+export function parseTableColumns(rawHeadings) {
+    return rawHeadings.map(({ key, label }) => ({
+        key: key ?? '',
+        ...(typeof label === 'string' && label.length > 0 ? { label } : {}),
+        align: 'left',
+    }));
+}
+export function parseTableRow(tableItem, headings) {
+    const keys = new Set(headings.map(({ key }) => key));
+    const valueTypesByKey = new Map(headings.map(({ key, valueType }) => [key, valueType]));
+    return Object.fromEntries(Object.entries(tableItem)
+        .filter(([key]) => keys.has(key))
+        .map(([key, value]) => {
+        const valueType = valueTypesByKey.get(key);
+        return parseTableEntry([key, value], valueType);
+    }));
+}
+export function parseTableEntry([key, value], valueType) {
+    if (value == null) {
+        return [key, value];
+    }
+    return [key, formatTableItemPropertyValue(value, valueType)];
+}
+//# sourceMappingURL=table.type.js.map

package/src/lib/runner/details/table.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.type.js","sourceRoot":"","sources":["../../../../../../../packages/plugin-lighthouse/src/lib/runner/details/table.type.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,UAAU,6BAA6B,CAC3C,OAAsB;IAEtB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAEjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,WAAW,EAAE,CAAC,KAAK,CAAC;YACzB,OAAO,EAAE,iBAAiB,CAAC,WAAW,CAAC;YACvC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kCAAkC,CAC1C,OAAO,EACP,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,EAC/B,KAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,CACpC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,WAAyC;IAEzC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1C,GAAG,EAAE,GAAG,IAAI,EAAE;QACd,GAAG,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,KAAK,EAAE,MAAM;KACd,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,SAA4B,EAC5B,QAAsC;IAEtC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CACvD,CAAC;IAEF,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;SACtB,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACpB,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,eAAe,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;IAClD,CAAC,CAAC,CACa,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,CAAC,GAAG,EAAE,KAAK,CAAwB,EACnC,SAAiC;IAEjC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,4BAA4B,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/src/lib/runner/details/utils.js

@@ -0,0 +1,7 @@
+import { bold } from 'ansis';
+export class LighthouseAuditDetailsParsingError extends Error {
+    constructor(type, rawTable, error) {
+        super(`Parsing lighthouse report details ${bold(type)} failed: \nRaw data:\n ${JSON.stringify(rawTable, null, 2)}\n${error}`);
+    }
+}
+//# sourceMappingURL=utils.js.map

package/src/lib/runner/details/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../../../packages/plugin-lighthouse/src/lib/runner/details/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAG7B,MAAM,OAAO,kCAAmC,SAAQ,KAAK;IAC3D,YACE,IAAqB,EACrB,QAAiC,EACjC,KAAa;QAEb,KAAK,CACH,qCAAqC,IAAI,CACvC,IAAI,CACL,0BAA0B,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,KAAK,EAAE,CACzE,CAAC;IACJ,CAAC;CACF"}

package/src/lib/runner/runner.d.ts

@@ -1,3 +1,3 @@
 import type { RunnerFunction } from '@code-pushup/models';
-import type { LighthouseCliFlags } from './types';
+import type { LighthouseCliFlags } from './types.js';
 export declare function createRunnerFunction(urlUnderTest: string, flags?: LighthouseCliFlags): RunnerFunction;

package/src/lib/runner/runner.js

@@ -0,0 +1,28 @@
+import { runLighthouse } from 'lighthouse/cli/run.js';
+import path from 'node:path';
+import { ensureDirectoryExists } from '@code-pushup/utils';
+import { DEFAULT_CLI_FLAGS } from './constants.js';
+import { determineAndSetLogLevel, getConfig, normalizeAuditOutputs, toAuditOutputs, } from './utils.js';
+export function createRunnerFunction(urlUnderTest, flags = DEFAULT_CLI_FLAGS) {
+    return async () => {
+        const { configPath, preset, outputPath, ...parsedFlags } = flags;
+        const logLevel = determineAndSetLogLevel(parsedFlags);
+        const config = await getConfig({ configPath, preset });
+        if (outputPath) {
+            await ensureDirectoryExists(path.dirname(outputPath));
+        }
+        const enrichedFlags = {
+            ...parsedFlags,
+            logLevel,
+            outputPath,
+        };
+        const runnerResult = await runLighthouse(urlUnderTest, enrichedFlags, config);
+        if (runnerResult == null) {
+            throw new Error('Lighthouse did not produce a result.');
+        }
+        const { lhr } = runnerResult;
+        const auditOutputs = toAuditOutputs(Object.values(lhr.audits), flags);
+        return normalizeAuditOutputs(auditOutputs, enrichedFlags);
+    };
+}
+//# sourceMappingURL=runner.js.map

package/src/lib/runner/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../../../../packages/plugin-lighthouse/src/lib/runner/runner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EACL,uBAAuB,EACvB,SAAS,EACT,qBAAqB,EACrB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,oBAAoB,CAClC,YAAoB,EACpB,QAA4B,iBAAiB;IAE7C,OAAO,KAAK,IAA2B,EAAE;QACvC,MAAM,EACJ,UAAU,EACV,MAAM,EACN,UAAU,EACV,GAAG,WAAW,EACf,GAAgC,KAAK,CAAC;QAEvC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QACvD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,aAAa,GAAG;YACpB,GAAG,WAAW;YACd,QAAQ;YACR,UAAU;SACX,CAAC;QAEF,MAAM,YAAY,GAAY,MAAM,aAAa,CAC/C,YAAY,EACZ,aAAa,EACb,MAAM,CACP,CAAC;QAEF,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,GAAG,YAA4B,CAAC;QAC7C,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;QAEtE,OAAO,qBAAqB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC"}

package/src/lib/runner/types.d.ts

@@ -1,4 +1,4 @@
-import type { LighthouseOptions } from '../types';
+import type { LighthouseOptions } from '../types.js';
 export type NormalizedFlags = {
     chromeFlags: string[];
     onlyAudits: string[];

package/src/lib/runner/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/src/lib/runner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../packages/plugin-lighthouse/src/lib/runner/types.ts"],"names":[],"mappings":""}