@code-pushup/lighthouse-plugin 0.47.0 → 0.49.0

package/index.js

@@ -1,6 +1,6 @@
 // packages/plugin-lighthouse/package.json
 var name = "@code-pushup/lighthouse-plugin";
-var version = "0.47.0";
+var version = "0.49.0";
 
 // packages/plugin-lighthouse/src/lib/constants.ts
 import { join } from "node:path";
@@ -711,11 +711,18 @@ var LIGHTHOUSE_OUTPUT_PATH = join(
 );
 
 // packages/plugin-lighthouse/src/lib/normalize-flags.ts
-import chalk8 from "chalk";
+import { bold as bold9, yellow as yellow2 } from "ansis";
+
+// packages/utils/src/lib/reports/utils.ts
+import ansis from "ansis";
+import { md } from "build-md";
+
+// packages/utils/src/lib/reports/constants.ts
+var TERMINAL_WIDTH = 80;
 
 // packages/utils/src/lib/file-system.ts
+import { bold, gray } from "ansis";
 import { bundleRequire } from "bundle-require";
-import chalk2 from "chalk";
 import { mkdir, readFile, readdir, rm, stat } from "node:fs/promises";
 
 // packages/utils/src/lib/formatting.ts
@@ -760,12 +767,7 @@ function truncateText(text, options) {
 // packages/utils/src/lib/logging.ts
 import isaacs_cliui from "@isaacs/cliui";
 import { cliui } from "@poppinss/cliui";
-import chalk from "chalk";
-
-// packages/utils/src/lib/reports/constants.ts
-var TERMINAL_WIDTH = 80;
-
-// packages/utils/src/lib/logging.ts
+import { underline } from "ansis";
 var singletonUiInstance;
 function ui() {
   if (singletonUiInstance === void 0) {
@@ -817,9 +819,42 @@ async function importModule(options) {
   return mod;
 }
 
+// packages/utils/src/lib/filter.ts
+function filterItemRefsBy(items, refFilterFn) {
+  return items.map((item) => ({
+    ...item,
+    refs: item.refs.filter(refFilterFn)
+  })).filter((item) => item.refs.length);
+}
+
+// packages/utils/src/lib/git/git.ts
+import { simpleGit } from "simple-git";
+
+// packages/utils/src/lib/transform.ts
+function toArray(val) {
+  return Array.isArray(val) ? val : [val];
+}
+function capitalize(text) {
+  return `${text.charAt(0).toLocaleUpperCase()}${text.slice(
+    1
+  )}`;
+}
+
+// packages/utils/src/lib/git/git.commits-and-tags.ts
+import { simpleGit as simpleGit2 } from "simple-git";
+
+// packages/utils/src/lib/semver.ts
+import { rcompare, valid } from "semver";
+
+// packages/utils/src/lib/progress.ts
+import { black, bold as bold2, gray as gray2, green } from "ansis";
+import { MultiProgressBars } from "multi-progress-bars";
+
+// packages/utils/src/lib/reports/generate-md-report.ts
+import { MarkdownDocument as MarkdownDocument3, md as md4 } from "build-md";
+
 // packages/utils/src/lib/text-formats/constants.ts
 var NEW_LINE = "\n";
-var TAB = "  ";
 
 // packages/utils/src/lib/text-formats/html/details.ts
 function details(title, content, cfg = { open: false }) {
@@ -832,7 +867,7 @@ function details(title, content, cfg = { open: false }) {
 
 // packages/utils/src/lib/text-formats/html/font-style.ts
 var boldElement = "b";
-function bold(text) {
+function bold3(text) {
   return `<${boldElement}>${text}</${boldElement}>`;
 }
 var italicElement = "i";
@@ -849,16 +884,6 @@ function link(href, text) {
   return `<a href="${href}">${text || href}</a>`;
 }
 
-// packages/utils/src/lib/transform.ts
-function toArray(val) {
-  return Array.isArray(val) ? val : [val];
-}
-function capitalize(text) {
-  return `${text.charAt(0).toLocaleUpperCase()}${text.slice(
-    1
-  )}`;
-}
-
 // packages/utils/src/lib/text-formats/table.ts
 function rowToStringArray({ rows, columns = [] }) {
   if (Array.isArray(rows.at(0)) && typeof columns.at(0) === "object") {
@@ -902,51 +927,6 @@ function columnsToStringArray({
   const cols = columns;
   return cols.map(({ label, key }) => label ?? capitalize(key));
 }
-function getColumnAlignmentForKeyAndIndex(targetKey, targetIdx, columns = []) {
-  const column = columns.at(targetIdx) ?? columns.find((col) => col.key === targetKey);
-  if (typeof column === "string") {
-    return column;
-  } else if (typeof column === "object") {
-    return column.align ?? "center";
-  } else {
-    return "center";
-  }
-}
-function getColumnAlignmentForIndex(targetIdx, columns = []) {
-  const column = columns.at(targetIdx);
-  if (column == null) {
-    return "center";
-  } else if (typeof column === "string") {
-    return column;
-  } else if (typeof column === "object") {
-    return column.align ?? "center";
-  } else {
-    return "center";
-  }
-}
-function getColumnAlignments(tableData) {
-  const { rows, columns = [] } = tableData;
-  if (rows.at(0) == null) {
-    throw new Error("first row can`t be undefined.");
-  }
-  if (Array.isArray(rows.at(0))) {
-    const firstPrimitiveRow = rows.at(0);
-    return Array.from({ length: firstPrimitiveRow.length }).map(
-      (_, idx) => getColumnAlignmentForIndex(idx, columns)
-    );
-  }
-  const biggestRow = [...rows].sort((a, b) => Object.keys(a).length - Object.keys(b).length).at(-1);
-  if (columns.length > 0) {
-    return columns.map(
-      (column, idx) => typeof column === "string" ? column : getColumnAlignmentForKeyAndIndex(
-        column.key,
-        idx,
-        columns
-      )
-    );
-  }
-  return Object.keys(biggestRow ?? {}).map((_) => "center");
-}
 
 // packages/utils/src/lib/text-formats/html/table.ts
 function wrap(elem, content) {
@@ -969,135 +949,9 @@ function table(tableData) {
   return wrap("table", `${NEW_LINE}${tableHeaderRow}${tableBody}`);
 }
 
-// packages/utils/src/lib/text-formats/md/font-style.ts
-var boldWrap = "**";
-function bold2(text) {
-  return `${boldWrap}${text}${boldWrap}`;
-}
-var italicWrap = "_";
-function italic2(text) {
-  return `${italicWrap}${text}${italicWrap}`;
-}
-var strikeThroughWrap = "~";
-function strikeThrough(text) {
-  return `${strikeThroughWrap}${text}${strikeThroughWrap}`;
-}
-var codeWrap = "`";
-function code2(text) {
-  return `${codeWrap}${text}${codeWrap}`;
-}
-
-// packages/utils/src/lib/text-formats/md/headline.ts
-function headline(text, hierarchy = 1) {
-  return `${"#".repeat(hierarchy)} ${text}${NEW_LINE}`;
-}
-function h(text, hierarchy = 1) {
-  return headline(text, hierarchy);
-}
-function h1(text) {
-  return headline(text, 1);
-}
-function h2(text) {
-  return headline(text, 2);
-}
-function h3(text) {
-  return headline(text, 3);
-}
-function h4(text) {
-  return headline(text, 4);
-}
-function h5(text) {
-  return headline(text, 5);
-}
-function h6(text) {
-  return headline(text, 6);
-}
-
-// packages/utils/src/lib/text-formats/md/image.ts
-function image(src, alt) {
-  return `![${alt}](${src})`;
-}
-
-// packages/utils/src/lib/text-formats/md/link.ts
-function link2(href, text) {
-  return `[${text || href}](${href})`;
-}
-
-// packages/utils/src/lib/text-formats/md/list.ts
-function li(text, order = "unordered") {
-  const style = order === "unordered" ? "-" : "- [ ]";
-  return `${style} ${text}`;
-}
-function indentation(text, level = 1) {
-  return `${TAB.repeat(level)}${text}`;
-}
-
-// packages/utils/src/lib/text-formats/md/paragraphs.ts
-function paragraphs(...sections) {
-  return sections.filter(Boolean).join(`${NEW_LINE}${NEW_LINE}`);
-}
-
-// packages/utils/src/lib/text-formats/md/section.ts
-function section(...contents) {
-  return `${lines(...contents)}${NEW_LINE}`;
-}
-function lines(...contents) {
-  const filteredContent = contents.filter(
-    (value) => value != null && value !== "" && value !== false
-  );
-  return `${filteredContent.join(NEW_LINE)}`;
-}
-
-// packages/utils/src/lib/text-formats/md/table.ts
-var alignString = /* @__PURE__ */ new Map([
-  ["left", ":--"],
-  ["center", ":--:"],
-  ["right", "--:"]
-]);
-function tableRow(rows) {
-  return `|${rows.join("|")}|`;
-}
-function table2(data) {
-  if (data.rows.length === 0) {
-    throw new Error("Data can't be empty");
-  }
-  const alignmentRow = getColumnAlignments(data).map(
-    (s) => alignString.get(s) ?? String(alignString.get("center"))
-  );
-  return section(
-    `${lines(
-      tableRow(columnsToStringArray(data)),
-      tableRow(alignmentRow),
-      ...rowToStringArray(data).map(tableRow)
-    )}`
-  );
-}
-
 // packages/utils/src/lib/text-formats/index.ts
-var md = {
-  bold: bold2,
-  italic: italic2,
-  strikeThrough,
-  code: code2,
-  link: link2,
-  image,
-  headline,
-  h,
-  h1,
-  h2,
-  h3,
-  h4,
-  h5,
-  h6,
-  indentation,
-  lines,
-  li,
-  section,
-  paragraphs,
-  table: table2
-};
 var html = {
-  bold,
+  bold: bold3,
   italic,
   code,
   link,
@@ -1105,55 +959,20 @@ var html = {
   table
 };
 
-// packages/utils/src/lib/reports/utils.ts
-var { image: image2, bold: boldMd } = md;
-
-// packages/utils/src/lib/filter.ts
-function filterItemRefsBy(items, refFilterFn) {
-  return items.map((item) => ({
-    ...item,
-    refs: item.refs.filter(refFilterFn)
-  })).filter((item) => item.refs.length);
-}
-
-// packages/utils/src/lib/git/git.ts
-import { simpleGit } from "simple-git";
-
-// packages/utils/src/lib/git/git.commits-and-tags.ts
-import { simpleGit as simpleGit2 } from "simple-git";
-
-// packages/utils/src/lib/semver.ts
-import { rcompare, valid } from "semver";
-
-// packages/utils/src/lib/progress.ts
-import chalk3 from "chalk";
-import { MultiProgressBars } from "multi-progress-bars";
-
 // packages/utils/src/lib/reports/formatting.ts
-var { headline: headline2, lines: lines2, link: link3, section: section2, table: table3 } = md;
+import { MarkdownDocument, md as md2 } from "build-md";
 
 // packages/utils/src/lib/reports/generate-md-report-categoy-section.ts
-var { link: link4, section: section3, h2: h22, lines: lines3, li: li2, bold: boldMd2, h3: h32, indentation: indentation2 } = md;
-
-// packages/utils/src/lib/reports/generate-md-report.ts
-var { h1: h12, h2: h23, h3: h33, lines: lines4, link: link5, section: section4, code: codeMd } = md;
-var { bold: boldHtml, details: details2 } = html;
+import { MarkdownDocument as MarkdownDocument2, md as md3 } from "build-md";
 
 // packages/utils/src/lib/reports/generate-md-reports-diff.ts
-var {
-  h1: h13,
-  h2: h24,
-  lines: lines5,
-  link: link6,
-  bold: boldMd3,
-  italic: italicMd,
-  table: table4,
-  section: section5
-} = md;
-var { details: details3 } = html;
+import {
+  MarkdownDocument as MarkdownDocument4,
+  md as md5
+} from "build-md";
 
 // packages/utils/src/lib/reports/log-stdout-summary.ts
-import chalk4 from "chalk";
+import { bold as bold4, cyan, cyanBright, green as green2, red } from "ansis";
 
 // packages/plugin-lighthouse/src/lib/runner/runner.ts
 import { runLighthouse } from "lighthouse/cli/run.js";
@@ -1232,17 +1051,17 @@ var DEFAULT_CLI_FLAGS = {
 };
 
 // packages/plugin-lighthouse/src/lib/runner/utils.ts
-import chalk7 from "chalk";
+import { bold as bold8 } from "ansis";
 import log from "lighthouse-logger";
 import desktopConfig from "lighthouse/core/config/desktop-config.js";
 import experimentalConfig from "lighthouse/core/config/experimental-config.js";
 import perfConfig from "lighthouse/core/config/perf-config.js";
 
 // packages/plugin-lighthouse/src/lib/runner/details/details.ts
-import chalk6 from "chalk";
+import { bold as bold7, yellow } from "ansis";
 
 // packages/plugin-lighthouse/src/lib/runner/details/item-value.ts
-import chalk5 from "chalk";
+import { bold as bold5 } from "ansis";
 function trimSlice(item, maxLength = 0) {
   const str = String(item).trim();
   return maxLength > 0 ? str.slice(0, maxLength) : str;
@@ -1273,8 +1092,8 @@ function formatTableItemPropertyValue(itemValue, itemValueFormat) {
     case "code":
       return html.code(trimSlice(parsedItemValue));
     case "link":
-      const link8 = parsedItemValue;
-      return html.link(link8.url, link8.text);
+      const link3 = parsedItemValue;
+      return html.link(link3.url, link3.text);
     case "url":
       const url = parsedItemValue;
       return html.link(url);
@@ -1294,18 +1113,13 @@ function formatTableItemPropertyValue(itemValue, itemValueFormat) {
     case "text":
       return truncateText(String(parsedItemValue), 500);
     case "multi":
-      ui().logger.info(`Format type ${chalk5.bold("multi")} is not implemented`);
+      ui().logger.info(`Format type ${bold5("multi")} is not implemented`);
       return "";
     case "thumbnail":
-      ui().logger.info(
-        `Format type ${chalk5.bold("thumbnail")} is not implemented`
-      );
-      return "";
-    case null:
+      ui().logger.info(`Format type ${bold5("thumbnail")} is not implemented`);
       return "";
-    default:
-      return itemValue;
   }
+  return itemValue;
 }
 function parseSimpleItemValue(item) {
   if (typeof item === "object") {
@@ -1340,35 +1154,56 @@ function parseTableItemPropertyValue(itemValue) {
       const { url } = objectValue;
       return String(url);
     case "subitems":
-      ui().logger.info(
-        `Value type ${chalk5.bold("subitems")} is not implemented`
-      );
+      ui().logger.info(`Value type ${bold5("subitems")} is not implemented`);
       return "";
     case "debugdata":
-      ui().logger.info(
-        `Value type ${chalk5.bold("debugdata")} is not implemented`,
-        { silent: true }
-      );
+      ui().logger.info(`Value type ${bold5("debugdata")} is not implemented`, {
+        silent: true
+      });
       return "";
   }
   return parseSimpleItemValue(objectValue);
 }
 
+// packages/plugin-lighthouse/src/lib/runner/details/utils.ts
+import { bold as bold6 } from "ansis";
+var LighthouseAuditDetailsParsingError = class extends Error {
+  constructor(type, rawTable, error) {
+    super(
+      `Parsing lighthouse report details ${bold6(
+        type
+      )} failed: 
+Raw data:
+ ${JSON.stringify(rawTable, null, 2)}
+${error}`
+    );
+  }
+};
+
 // packages/plugin-lighthouse/src/lib/runner/details/table.type.ts
-function parseTableToAuditDetailsTable(details4) {
-  const { headings: rawHeadings, items } = details4;
+function parseTableToAuditDetailsTable(details2) {
+  const { headings: rawHeadings, items } = details2;
   if (items.length === 0) {
     return void 0;
   }
-  return {
-    columns: parseTableColumns(rawHeadings),
-    rows: items.map((row) => parseTableRow(row, rawHeadings))
-  };
+  try {
+    return tableSchema().parse({
+      title: "Table",
+      columns: parseTableColumns(rawHeadings),
+      rows: items.map((row) => parseTableRow(row, rawHeadings))
+    });
+  } catch (error) {
+    throw new LighthouseAuditDetailsParsingError(
+      "table",
+      { items, headings: rawHeadings },
+      error.message.toString()
+    );
+  }
 }
 function parseTableColumns(rawHeadings) {
   return rawHeadings.map(({ key, label }) => ({
     key: key ?? "",
-    label: typeof label === "string" ? label : void 0,
+    ...typeof label === "string" && label.length > 0 ? { label } : {},
     align: "left"
   }));
 }
@@ -1391,40 +1226,73 @@ function parseTableEntry([key, value], valueType) {
   return [key, formatTableItemPropertyValue(value, valueType)];
 }
 
-// packages/plugin-lighthouse/src/lib/runner/details/details.ts
-function toAuditDetails(details4) {
-  if (details4 == null) {
-    return void 0;
-  }
-  const { type } = details4;
-  if (type !== "table") {
+// packages/plugin-lighthouse/src/lib/runner/details/opportunity.type.ts
+function parseOpportunityToAuditDetailsTable(details2) {
+  const { headings: rawHeadings, items } = details2;
+  if (items.length === 0) {
     return void 0;
   }
-  const rawTable = parseTableToAuditDetailsTable(details4);
-  if (rawTable != null) {
-    const result = tableSchema().safeParse(rawTable);
-    if (result.success) {
-      return {
-        table: result.data
-      };
-    }
-    throw new Error(
-      `Parsing details ${chalk6.bold(
-        type
-      )} failed: 
-Raw data:
- ${JSON.stringify(
-        rawTable,
-        null,
-        2
-      )}
-${result.error.toString()}`
+  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()
     );
   }
-  return void 0;
+}
+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).filter(([key]) => keys.has(key)).map(([key, value]) => {
+        const valueType = valueTypesByKey.get(key);
+        return parseOpportunityEntry([key, value], valueType);
+      })
+    )
+  };
+}
+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);
+  }
+}
+
+// packages/plugin-lighthouse/src/lib/runner/details/details.ts
+function toAuditDetails(details2) {
+  if (details2 == null) {
+    return {};
+  }
+  const { type } = details2;
+  switch (type) {
+    case "table":
+      const table2 = parseTableToAuditDetailsTable(details2);
+      return table2 ? { table: table2 } : {};
+    case "opportunity":
+      const opportunity = parseOpportunityToAuditDetailsTable(details2);
+      return opportunity ? { table: opportunity } : {};
+  }
+  return {};
 }
 var unsupportedDetailTypes = /* @__PURE__ */ new Set([
-  "opportunity",
   "debugdata",
   "treemap-data",
   "screenshot",
@@ -1435,16 +1303,16 @@ function logUnsupportedDetails(lhrAudits, { displayCount = 3 } = {}) {
   const slugsWithDetailParsingErrors = [
     ...new Set(
       lhrAudits.filter(
-        ({ details: details4 }) => unsupportedDetailTypes.has(details4?.type)
-      ).map(({ details: details4 }) => details4?.type)
+        ({ details: details2 }) => unsupportedDetailTypes.has(details2?.type)
+      ).map(({ details: details2 }) => details2?.type)
     )
   ];
   if (slugsWithDetailParsingErrors.length > 0) {
     const postFix = (count) => count > displayCount ? ` and ${count - displayCount} more.` : "";
     ui().logger.debug(
-      `${chalk6.yellow("\u26A0")} Plugin ${chalk6.bold(
+      `${yellow("\u26A0")} Plugin ${bold7(
         PLUGIN_SLUG
-      )} skipped parsing of unsupported audit details: ${chalk6.bold(
+      )} skipped parsing of unsupported audit details: ${bold7(
         slugsWithDetailParsingErrors.slice(0, displayCount).join(", ")
       )}${postFix(slugsWithDetailParsingErrors.length)}`
     );
@@ -1458,9 +1326,9 @@ function normalizeAuditOutputs(auditOutputs, flags = { skipAudits: [] }) {
     const doSkip = toSkip.has(slug);
     if (doSkip) {
       ui().logger.info(
-        `Audit ${chalk7.bold(
+        `Audit ${bold8(
           slug
-        )} was included in audit outputs of lighthouse but listed under ${chalk7.bold(
+        )} was included in audit outputs of lighthouse but listed under ${bold8(
           "skipAudits"
         )}.`
       );
@@ -1468,6 +1336,13 @@ function normalizeAuditOutputs(auditOutputs, flags = { skipAudits: [] }) {
     return !doSkip;
   });
 }
+var LighthouseAuditParsingError = class extends Error {
+  constructor(slug, error) {
+    super(`
+Audit ${bold8(slug)} failed parsing details: 
+${error.message}`);
+  }
+};
 function toAuditOutputs(lhrAudits, { verbose = false } = {}) {
   if (verbose) {
     logUnsupportedDetails(lhrAudits);
@@ -1478,7 +1353,7 @@ function toAuditOutputs(lhrAudits, { verbose = false } = {}) {
       score,
       numericValue: value = 0,
       // not every audit has a numericValue
-      details: details4,
+      details: details2,
       displayValue
     }) => {
       const auditOutput = {
@@ -1488,16 +1363,12 @@ function toAuditOutputs(lhrAudits, { verbose = false } = {}) {
         value,
         displayValue
       };
-      if (details4 != null) {
+      if (details2 != null) {
         try {
-          const parsedDetails = toAuditDetails(details4);
-          return parsedDetails ? { ...auditOutput, details: parsedDetails } : auditOutput;
+          const parsedDetails = toAuditDetails(details2);
+          return Object.keys(parsedDetails).length > 0 ? { ...auditOutput, details: parsedDetails } : auditOutput;
         } catch (error) {
-          throw new Error(
-            `
-Audit ${chalk7.bold(slug)} failed parsing details: 
-${error.message}`
-          );
+          throw new LighthouseAuditParsingError(slug, error);
         }
       }
       return auditOutput;
@@ -1629,9 +1500,9 @@ function logUnsupportedFlagsInUse(flags, displayCount = 3) {
   if (unsupportedFlagsInUse.length > 0) {
     const postFix = (count) => count > displayCount ? ` and ${count - displayCount} more.` : "";
     ui().logger.debug(
-      `${chalk8.yellow("\u26A0")} Plugin ${chalk8.bold(
+      `${yellow2("\u26A0")} Plugin ${bold9(
         LIGHTHOUSE_PLUGIN_SLUG
-      )} used unsupported flags: ${chalk8.bold(
+      )} used unsupported flags: ${bold9(
         unsupportedFlagsInUse.slice(0, displayCount).join(", ")
       )}${postFix(unsupportedFlagsInUse.length)}`
     );

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@code-pushup/lighthouse-plugin",
-  "version": "0.47.0",
+  "version": "0.49.0",
   "license": "MIT",
   "dependencies": {
-    "@code-pushup/models": "0.47.0",
+    "@code-pushup/models": "0.49.0",
+    "@code-pushup/utils": "0.49.0",
+    "ansis": "^3.3.0",
     "lighthouse": "^12.0.0",
-    "@code-pushup/utils": "0.47.0",
-    "lighthouse-logger": "2.0.1",
-    "chalk": "^5.3.0"
+    "lighthouse-logger": "2.0.1"
   },
   "homepage": "https://github.com/code-pushup/cli#readme",
   "bugs": {

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

@@ -2,7 +2,7 @@ import type { FormattedIcu } from 'lighthouse';
 import type Details from 'lighthouse/types/lhr/audit-details';
 import { Result } from 'lighthouse/types/lhr/audit-result';
 import { AuditDetails } from '@code-pushup/models';
-export declare function toAuditDetails<T extends FormattedIcu<Details>>(details: T | undefined): AuditDetails | undefined;
+export declare function toAuditDetails<T extends FormattedIcu<Details>>(details: T | undefined): AuditDetails;
 export declare const unsupportedDetailTypes: Set<string>;
 export declare function logUnsupportedDetails(lhrAudits: Result[], { displayCount }?: {
     displayCount?: number;

package/src/lib/runner/details/opportunity.type.d.ts

@@ -0,0 +1,8 @@
+import type Details from 'lighthouse/types/lhr/audit-details';
+import { Table, TableRowObject } from '@code-pushup/models';
+export declare function parseOpportunityToAuditDetailsTable(details: Details.Opportunity): Table | undefined;
+export declare function parseOpportunityItemToTableRow(opportunityItem: Details.OpportunityItem, headings: Details.TableColumnHeading[]): TableRowObject;
+export declare function parseOpportunityEntry([key, value]: [
+    keyof Details.OpportunityItem,
+    Details.OpportunityItem[string]
+], valueType: Details.ItemValueType): string[] | [keyof Details.TableItem, Details.ItemValue | undefined];

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

@@ -0,0 +1,4 @@
+import Details from 'lighthouse/types/lhr/audit-details';
+export declare class LighthouseAuditDetailsParsingError extends Error {
+    constructor(type: Details['type'], rawTable: Record<string, unknown>, error: string);
+}

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

@@ -4,10 +4,12 @@ import { AuditOutputs } from '@code-pushup/models';
 import type { LighthouseOptions } from '../types';
 import { LighthouseCliFlags } from './types';
 export declare function normalizeAuditOutputs(auditOutputs: AuditOutputs, flags?: LighthouseOptions): AuditOutputs;
+export declare class LighthouseAuditParsingError extends Error {
+    constructor(slug: string, error: Error);
+}
 export declare function toAuditOutputs(lhrAudits: Result[], { verbose }?: {
     verbose?: boolean;
 }): AuditOutputs;
-export declare const unsupportedDetailTypes: Set<string>;
 export type LighthouseLogLevel = 'verbose' | 'error' | 'info' | 'silent' | 'warn' | undefined;
 export declare function determineAndSetLogLevel({ verbose, quiet, }?: {
     verbose?: boolean;