@code-pushup/utils 0.35.0 → 0.42.0

package/index.js

@@ -1,5 +1,372 @@
-// packages/models/src/lib/audit.ts
-import { z as z2 } from "zod";
+// packages/utils/src/lib/text-formats/constants.ts
+var NEW_LINE = "\n";
+var TAB = "  ";
+var SPACE = " ";
+
+// packages/utils/src/lib/text-formats/html/details.ts
+function details(title, content, cfg = { open: false }) {
+  return `<details${cfg.open ? " open" : ""}>${NEW_LINE}<summary>${title}</summary>${NEW_LINE}${// ⚠️ The blank line is needed to ensure Markdown in content is rendered correctly.
+  NEW_LINE}${content}${NEW_LINE}${// @TODO in the future we could consider adding it only if the content ends with a code block
+  // ⚠️ The blank line ensure Markdown in content is rendered correctly.
+  NEW_LINE}</details>${// ⚠️ The blank line is needed to ensure Markdown after details is rendered correctly.
+  NEW_LINE}`;
+}
+
+// packages/utils/src/lib/text-formats/html/font-style.ts
+var boldElement = "b";
+function bold(text) {
+  return `<${boldElement}>${text}</${boldElement}>`;
+}
+var italicElement = "i";
+function italic(text) {
+  return `<${italicElement}>${text}</${italicElement}>`;
+}
+var codeElement = "code";
+function code(text) {
+  return `<${codeElement}>${text}</${codeElement}>`;
+}
+
+// packages/utils/src/lib/text-formats/html/link.ts
+function link(href, text) {
+  return `<a href="${href}">${text || href}"</a>`;
+}
+
+// packages/utils/src/lib/transform.ts
+import { platform } from "node:os";
+function toArray(val) {
+  return Array.isArray(val) ? val : [val];
+}
+function objectToKeys(obj) {
+  return Object.keys(obj);
+}
+function objectToEntries(obj) {
+  return Object.entries(obj);
+}
+function objectFromEntries(entries) {
+  return Object.fromEntries(entries);
+}
+function countOccurrences(values) {
+  return values.reduce(
+    (acc, value) => ({ ...acc, [value]: (acc[value] ?? 0) + 1 }),
+    {}
+  );
+}
+function distinct(array) {
+  return [...new Set(array)];
+}
+function deepClone(obj) {
+  return obj == null || typeof obj !== "object" ? obj : structuredClone(obj);
+}
+function factorOf(items, filterFn) {
+  const itemCount = items.length;
+  if (!itemCount) {
+    return 1;
+  }
+  const filterCount = items.filter(filterFn).length;
+  return filterCount === 0 ? 1 : (itemCount - filterCount) / itemCount;
+}
+function objectToCliArgs(params) {
+  if (!params) {
+    return [];
+  }
+  return Object.entries(params).flatMap(([key, value]) => {
+    if (key === "_") {
+      return Array.isArray(value) ? value : [`${value}`];
+    }
+    const prefix = key.length === 1 ? "-" : "--";
+    if (Array.isArray(value)) {
+      return value.map((v) => `${prefix}${key}="${v}"`);
+    }
+    if (Array.isArray(value)) {
+      return value.map((v) => `${prefix}${key}="${v}"`);
+    }
+    if (typeof value === "string") {
+      return [`${prefix}${key}="${value}"`];
+    }
+    if (typeof value === "number") {
+      return [`${prefix}${key}=${value}`];
+    }
+    if (typeof value === "boolean") {
+      return [`${prefix}${value ? "" : "no-"}${key}`];
+    }
+    throw new Error(`Unsupported type ${typeof value} for key ${key}`);
+  });
+}
+function toUnixPath(path) {
+  return path.replace(/\\/g, "/");
+}
+function toUnixNewlines(text) {
+  return platform() === "win32" ? text.replace(/\r\n/g, "\n") : text;
+}
+function fromJsonLines(jsonLines) {
+  const unifiedNewLines = toUnixNewlines(jsonLines).trim();
+  return JSON.parse(`[${unifiedNewLines.split("\n").join(",")}]`);
+}
+function toJsonLines(json) {
+  return json.map((item) => JSON.stringify(item)).join("\n");
+}
+function capitalize(text) {
+  return `${text.charAt(0).toLocaleUpperCase()}${text.slice(
+    1
+  )}`;
+}
+function apostrophize(text, upperCase) {
+  const lastCharMatch = text.match(/(\w)\W*$/);
+  const lastChar = lastCharMatch?.[1] ?? "";
+  return `${text}'${lastChar.toLocaleLowerCase() === "s" ? "" : upperCase ? "S" : "s"}`;
+}
+function toNumberPrecision(value, decimalPlaces) {
+  return Number(
+    `${Math.round(
+      Number.parseFloat(`${value}e${decimalPlaces}`)
+    )}e-${decimalPlaces}`
+  );
+}
+function toOrdinal(value) {
+  if (value % 10 === 1 && value % 100 !== 11) {
+    return `${value}st`;
+  }
+  if (value % 10 === 2 && value % 100 !== 12) {
+    return `${value}nd`;
+  }
+  if (value % 10 === 3 && value % 100 !== 13) {
+    return `${value}rd`;
+  }
+  return `${value}th`;
+}
+
+// packages/utils/src/lib/table.ts
+function rowToStringArray({ rows, columns = [] }) {
+  if (Array.isArray(rows.at(0)) && typeof columns.at(0) === "object") {
+    throw new TypeError(
+      "Column can`t be object when rows are primitive values"
+    );
+  }
+  return rows.map((row) => {
+    if (Array.isArray(row)) {
+      return row.map(String);
+    }
+    const objectRow = row;
+    if (columns.length === 0 || typeof columns.at(0) === "string") {
+      return Object.values(objectRow).map(String);
+    }
+    return columns.map(
+      ({ key }) => String(objectRow[key])
+    );
+  });
+}
+function columnsToStringArray({ rows, columns = [] }) {
+  const firstRow = rows.at(0);
+  const primitiveRows = Array.isArray(firstRow);
+  if (typeof columns.at(0) === "string" && !primitiveRows) {
+    throw new Error("invalid union type. Caught by model parsing.");
+  }
+  if (columns.length === 0) {
+    if (Array.isArray(firstRow)) {
+      return firstRow.map((_, idx) => String(idx));
+    }
+    return Object.keys(firstRow);
+  }
+  if (typeof columns.at(0) === "string") {
+    return columns.map(String);
+  }
+  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({
+  rows,
+  columns = []
+}) {
+  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 firstObject = rows.at(0);
+  return Object.keys(firstObject).map(
+    (key, idx) => getColumnAlignmentForKeyAndIndex(key, idx, columns)
+  );
+}
+
+// packages/utils/src/lib/text-formats/html/table.ts
+function wrap(elem, content) {
+  return `<${elem}>${content}</${elem}>${NEW_LINE}`;
+}
+function wrapRow(content) {
+  const elem = "tr";
+  return `<${elem}>${NEW_LINE}${content}</${elem}>${NEW_LINE}`;
+}
+function table(tableData) {
+  if (tableData.rows.length === 0) {
+    throw new Error("Data can't be empty");
+  }
+  const tableHeaderCols = columnsToStringArray(tableData).map((s) => wrap("th", s)).join("");
+  const tableHeaderRow = wrapRow(tableHeaderCols);
+  const tableBody = rowToStringArray(tableData).map((arr) => {
+    const columns = arr.map((s) => wrap("td", s)).join("");
+    return wrapRow(columns);
+  }).join("");
+  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) {
+  return `${contents.filter(Boolean).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,
+  italic,
+  code,
+  link,
+  details,
+  table
+};
 
 // packages/models/src/lib/implementation/schemas.ts
 import { MATERIAL_ICONS } from "vscode-material-icons";
@@ -66,6 +433,7 @@ function missingRefsForCategoriesErrorMsg(categories, plugins) {
 }
 
 // packages/models/src/lib/implementation/schemas.ts
+var primitiveValueSchema = z.union([z.string(), z.number()]);
 function executionMetaSchema(options = {
   descriptionDate: "Execution start date and time",
   descriptionDuration: "Execution duration in ms"
@@ -157,6 +525,7 @@ function hasNonZeroWeightedRef(refs) {
 }
 
 // packages/models/src/lib/audit.ts
+import { z as z2 } from "zod";
 var auditSchema = z2.object({
   slug: slugSchema.describe("ID (unique within plugin)")
 }).merge(
@@ -186,7 +555,7 @@ function getDuplicateSlugsInAudits(audits) {
 }
 
 // packages/models/src/lib/audit-output.ts
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 
 // packages/models/src/lib/issue.ts
 import { z as z3 } from "zod";
@@ -217,16 +586,61 @@ var issueSchema = z3.object(
   { description: "Issue information" }
 );
 
+// packages/models/src/lib/table.ts
+import { z as z4 } from "zod";
+var tableAlignmentSchema = z4.enum(["left", "center", "right"], {
+  description: "Cell alignment"
+});
+var tableColumnObjectSchema = z4.object({
+  key: z4.string(),
+  label: z4.string().optional(),
+  align: tableAlignmentSchema.optional()
+});
+var tableRowObjectSchema = z4.record(primitiveValueSchema, {
+  description: "Object row"
+});
+var tableRowPrimitiveSchema = z4.array(primitiveValueSchema, {
+  description: "Primitive row"
+});
+var tableSharedSchema = z4.object({
+  title: z4.string().optional().describe("Display title for table")
+});
+var tablePrimitiveSchema = tableSharedSchema.merge(
+  z4.object(
+    {
+      columns: z4.array(tableAlignmentSchema).optional(),
+      rows: z4.array(tableRowPrimitiveSchema)
+    },
+    { description: "Table with primitive rows and optional alignment columns" }
+  )
+);
+var tableObjectSchema = tableSharedSchema.merge(
+  z4.object(
+    {
+      columns: z4.union([
+        z4.array(tableAlignmentSchema),
+        z4.array(tableColumnObjectSchema)
+      ]).optional(),
+      rows: z4.array(tableRowObjectSchema)
+    },
+    {
+      description: "Table with object rows and optional alignment or object columns"
+    }
+  )
+);
+var tableSchema = (description = "Table information") => z4.union([tablePrimitiveSchema, tableObjectSchema], { description });
+
 // packages/models/src/lib/audit-output.ts
 var auditValueSchema = nonnegativeIntSchema.describe("Raw numeric value");
-var auditDisplayValueSchema = z4.string({ description: "Formatted value (e.g. '0.9 s', '2.1 MB')" }).optional();
-var auditDetailsSchema = z4.object(
+var auditDisplayValueSchema = z5.string({ description: "Formatted value (e.g. '0.9 s', '2.1 MB')" }).optional();
+var auditDetailsSchema = z5.object(
   {
-    issues: z4.array(issueSchema, { description: "List of findings" })
+    issues: z5.array(issueSchema, { description: "List of findings" }).optional(),
+    table: tableSchema("Table of related findings").optional()
   },
   { description: "Detailed information" }
 );
-var auditOutputSchema = z4.object(
+var auditOutputSchema = z5.object(
   {
     slug: slugSchema.describe("Reference to audit"),
     displayValue: auditDisplayValueSchema,
@@ -236,7 +650,7 @@ var auditOutputSchema = z4.object(
   },
   { description: "Audit information" }
 );
-var auditOutputsSchema = z4.array(auditOutputSchema, {
+var auditOutputsSchema = z5.array(auditOutputSchema, {
   description: "List of JSON formatted audit output emitted by the runner process of a plugin"
 }).refine(
   (audits) => !getDuplicateSlugsInAudits2(audits),
@@ -253,13 +667,13 @@ function getDuplicateSlugsInAudits2(audits) {
 }
 
 // packages/models/src/lib/category-config.ts
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 var categoryRefSchema = weightedRefSchema(
   "Weighted references to audits and/or groups for the category",
   "Slug of an audit or group (depending on `type`)"
 ).merge(
-  z5.object({
-    type: z5.enum(["audit", "group"], {
+  z6.object({
+    type: z6.enum(["audit", "group"], {
       description: "Discriminant for reference kind, affects where `slug` is looked up"
     }),
     plugin: slugSchema.describe(
@@ -280,8 +694,8 @@ var categoryConfigSchema = scorableSchema(
     description: "Meta info for category"
   })
 ).merge(
-  z5.object({
-    isBinary: z5.boolean({
+  z6.object({
+    isBinary: z6.boolean({
       description: 'Is this a binary category (i.e. only a perfect score considered a "pass")?'
     }).optional()
   })
@@ -297,7 +711,7 @@ function getDuplicateRefsInCategoryMetrics(metrics) {
     metrics.map(({ slug, type, plugin }) => `${type} :: ${plugin} / ${slug}`)
   );
 }
-var categoriesSchema = z5.array(categoryConfigSchema, {
+var categoriesSchema = z6.array(categoryConfigSchema, {
   description: "Categorization of individual audits"
 }).refine(
   (categoryCfg) => !getDuplicateSlugCategories(categoryCfg),
@@ -316,18 +730,18 @@ function getDuplicateSlugCategories(categories) {
 }
 
 // packages/models/src/lib/commit.ts
-import { z as z6 } from "zod";
-var commitSchema = z6.object(
+import { z as z7 } from "zod";
+var commitSchema = z7.object(
   {
-    hash: z6.string({ description: "Commit SHA (full)" }).regex(
+    hash: z7.string({ description: "Commit SHA (full)" }).regex(
       /^[\da-f]{40}$/,
       "Commit SHA should be a 40-character hexadecimal string"
     ),
-    message: z6.string({ description: "Commit message" }),
-    date: z6.coerce.date({
+    message: z7.string({ description: "Commit message" }),
+    date: z7.coerce.date({
       description: "Date and time when commit was authored"
     }),
-    author: z6.string({
+    author: z7.string({
       description: "Commit author name"
     }).trim()
   },
@@ -335,22 +749,22 @@ var commitSchema = z6.object(
 );
 
 // packages/models/src/lib/core-config.ts
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 
 // packages/models/src/lib/persist-config.ts
-import { z as z7 } from "zod";
-var formatSchema = z7.enum(["json", "md"]);
-var persistConfigSchema = z7.object({
+import { z as z8 } from "zod";
+var formatSchema = z8.enum(["json", "md"]);
+var persistConfigSchema = z8.object({
   outputDir: filePathSchema.describe("Artifacts folder").optional(),
   filename: fileNameSchema.describe("Artifacts file name (without extension)").optional(),
-  format: z7.array(formatSchema).optional()
+  format: z8.array(formatSchema).optional()
 });
 
 // packages/models/src/lib/plugin-config.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 
 // packages/models/src/lib/group.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 var groupRefSchema = weightedRefSchema(
   "Weighted reference to a group",
   "Reference slug to a group within this plugin (e.g. 'max-lines')"
@@ -367,7 +781,7 @@ var groupSchema = scorableSchema(
   getDuplicateRefsInGroups,
   duplicateRefsInGroupsErrorMsg
 ).merge(groupMetaSchema);
-var groupsSchema = z8.array(groupSchema, {
+var groupsSchema = z9.array(groupSchema, {
   description: "List of groups"
 }).optional().refine(
   (groups) => !getDuplicateSlugsInGroups(groups),
@@ -395,14 +809,14 @@ function getDuplicateSlugsInGroups(groups) {
 }
 
 // packages/models/src/lib/runner-config.ts
-import { z as z9 } from "zod";
-var outputTransformSchema = z9.function().args(z9.unknown()).returns(z9.union([auditOutputsSchema, z9.promise(auditOutputsSchema)]));
-var runnerConfigSchema = z9.object(
+import { z as z10 } from "zod";
+var outputTransformSchema = z10.function().args(z10.unknown()).returns(z10.union([auditOutputsSchema, z10.promise(auditOutputsSchema)]));
+var runnerConfigSchema = z10.object(
   {
-    command: z9.string({
+    command: z10.string({
       description: "Shell command to execute"
     }),
-    args: z9.array(z9.string({ description: "Command arguments" })).optional(),
+    args: z10.array(z10.string({ description: "Command arguments" })).optional(),
     outputFile: filePathSchema.describe("Output path"),
     outputTransform: outputTransformSchema.optional()
   },
@@ -410,8 +824,8 @@ var runnerConfigSchema = z9.object(
     description: "How to execute runner"
   }
 );
-var onProgressSchema = z9.function().args(z9.unknown()).returns(z9.void());
-var runnerFunctionSchema = z9.function().args(onProgressSchema.optional()).returns(z9.union([auditOutputsSchema, z9.promise(auditOutputsSchema)]));
+var onProgressSchema = z10.function().args(z10.unknown()).returns(z10.void());
+var runnerFunctionSchema = z10.function().args(onProgressSchema.optional()).returns(z10.union([auditOutputsSchema, z10.promise(auditOutputsSchema)]));
 
 // packages/models/src/lib/plugin-config.ts
 var pluginMetaSchema = packageVersionSchema().merge(
@@ -422,13 +836,13 @@ var pluginMetaSchema = packageVersionSchema().merge(
     description: "Plugin metadata"
   })
 ).merge(
-  z10.object({
+  z11.object({
     slug: slugSchema.describe("Unique plugin slug within core config"),
     icon: materialIconSchema
   })
 );
-var pluginDataSchema = z10.object({
-  runner: z10.union([runnerConfigSchema, runnerFunctionSchema]),
+var pluginDataSchema = z11.object({
+  runner: z11.union([runnerConfigSchema, runnerFunctionSchema]),
   audits: pluginAuditsSchema,
   groups: groupsSchema
 });
@@ -454,22 +868,22 @@ function getMissingRefsFromGroups(pluginCfg) {
 }
 
 // packages/models/src/lib/upload-config.ts
-import { z as z11 } from "zod";
-var uploadConfigSchema = z11.object({
+import { z as z12 } from "zod";
+var uploadConfigSchema = z12.object({
   server: urlSchema.describe("URL of deployed portal API"),
-  apiKey: z11.string({
+  apiKey: z12.string({
     description: "API key with write access to portal (use `process.env` for security)"
   }),
   organization: slugSchema.describe(
     "Organization slug from Code PushUp portal"
   ),
   project: slugSchema.describe("Project slug from Code PushUp portal"),
-  timeout: z11.number({ description: "Request timeout in minutes (default is 5)" }).positive().int().optional()
+  timeout: z12.number({ description: "Request timeout in minutes (default is 5)" }).positive().int().optional()
 });
 
 // packages/models/src/lib/core-config.ts
-var unrefinedCoreConfigSchema = z12.object({
-  plugins: z12.array(pluginConfigSchema, {
+var unrefinedCoreConfigSchema = z13.object({
+  plugins: z13.array(pluginConfigSchema, {
     description: "List of plugins to be used (official, community-provided, or custom)"
   }).min(1),
   /** portal configuration for persisting results */
@@ -492,7 +906,7 @@ function refineCoreConfig(schema) {
 }
 
 // packages/models/src/lib/report.ts
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 var auditReportSchema = auditSchema.merge(auditOutputSchema);
 var pluginReportSchema = pluginMetaSchema.merge(
   executionMetaSchema({
@@ -500,9 +914,9 @@ var pluginReportSchema = pluginMetaSchema.merge(
     descriptionDuration: "Duration of the plugin run in ms"
   })
 ).merge(
-  z13.object({
-    audits: z13.array(auditReportSchema).min(1),
-    groups: z13.array(groupSchema).optional()
+  z14.object({
+    audits: z14.array(auditReportSchema).min(1),
+    groups: z14.array(groupSchema).optional()
   })
 ).refine(
   (pluginReport) => !getMissingRefsFromGroups2(pluginReport.audits, pluginReport.groups ?? []),
@@ -536,10 +950,10 @@ var reportSchema = packageVersionSchema({
     descriptionDuration: "Duration of the collect run in ms"
   })
 ).merge(
-  z13.object(
+  z14.object(
     {
-      categories: z13.array(categoryConfigSchema),
-      plugins: z13.array(pluginReportSchema).min(1),
+      categories: z14.array(categoryConfigSchema),
+      plugins: z14.array(pluginReportSchema).min(1),
       commit: commitSchema.describe("Git commit for which report was collected").nullable()
     },
     { description: "Collect output data" }
@@ -555,36 +969,40 @@ var reportSchema = packageVersionSchema({
 );
 
 // packages/models/src/lib/reports-diff.ts
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 function makeComparisonSchema(schema) {
   const sharedDescription = schema.description || "Result";
-  return z14.object({
+  return z15.object({
     before: schema.describe(`${sharedDescription} (source commit)`),
     after: schema.describe(`${sharedDescription} (target commit)`)
   });
 }
 function makeArraysComparisonSchema(diffSchema, resultSchema, description) {
-  return z14.object(
+  return z15.object(
     {
-      changed: z14.array(diffSchema),
-      unchanged: z14.array(resultSchema),
-      added: z14.array(resultSchema),
-      removed: z14.array(resultSchema)
+      changed: z15.array(diffSchema),
+      unchanged: z15.array(resultSchema),
+      added: z15.array(resultSchema),
+      removed: z15.array(resultSchema)
     },
     { description }
   );
 }
-var scorableMetaSchema = z14.object({ slug: slugSchema, title: titleSchema });
+var scorableMetaSchema = z15.object({
+  slug: slugSchema,
+  title: titleSchema,
+  docsUrl: docsUrlSchema
+});
 var scorableWithPluginMetaSchema = scorableMetaSchema.merge(
-  z14.object({
-    plugin: pluginMetaSchema.pick({ slug: true, title: true }).describe("Plugin which defines it")
+  z15.object({
+    plugin: pluginMetaSchema.pick({ slug: true, title: true, docsUrl: true }).describe("Plugin which defines it")
   })
 );
 var scorableDiffSchema = scorableMetaSchema.merge(
-  z14.object({
+  z15.object({
     scores: makeComparisonSchema(scoreSchema).merge(
-      z14.object({
-        diff: z14.number().min(-1).max(1).describe("Score change (`scores.after - scores.before`)")
+      z15.object({
+        diff: z15.number().min(-1).max(1).describe("Score change (`scores.after - scores.before`)")
       })
     ).describe("Score comparison")
   })
@@ -595,10 +1013,10 @@ var scorableWithPluginDiffSchema = scorableDiffSchema.merge(
 var categoryDiffSchema = scorableDiffSchema;
 var groupDiffSchema = scorableWithPluginDiffSchema;
 var auditDiffSchema = scorableWithPluginDiffSchema.merge(
-  z14.object({
+  z15.object({
     values: makeComparisonSchema(auditValueSchema).merge(
-      z14.object({
-        diff: z14.number().int().describe("Value change (`values.after - values.before`)")
+      z15.object({
+        diff: z15.number().int().describe("Value change (`values.after - values.before`)")
       })
     ).describe("Audit `value` comparison"),
     displayValues: makeComparisonSchema(auditDisplayValueSchema).describe(
@@ -607,15 +1025,15 @@ var auditDiffSchema = scorableWithPluginDiffSchema.merge(
   })
 );
 var categoryResultSchema = scorableMetaSchema.merge(
-  z14.object({ score: scoreSchema })
+  z15.object({ score: scoreSchema })
 );
 var groupResultSchema = scorableWithPluginMetaSchema.merge(
-  z14.object({ score: scoreSchema })
+  z15.object({ score: scoreSchema })
 );
 var auditResultSchema = scorableWithPluginMetaSchema.merge(
   auditOutputSchema.pick({ score: true, value: true, displayValue: true })
 );
-var reportsDiffSchema = z14.object({
+var reportsDiffSchema = z15.object({
   commits: makeComparisonSchema(commitSchema).nullable().describe("Commits identifying compared reports"),
   categories: makeArraysComparisonSchema(
     categoryDiffSchema,
@@ -778,40 +1196,48 @@ import chalk from "chalk";
 
 // packages/utils/src/lib/reports/constants.ts
 var TERMINAL_WIDTH = 80;
-var NEW_LINE = "\n";
 var SCORE_COLOR_RANGE = {
   GREEN_MIN: 0.9,
   YELLOW_MIN: 0.5
 };
+var CATEGORIES_TITLE = "\u{1F3F7} Categories";
 var FOOTER_PREFIX = "Made with \u2764 by";
 var CODE_PUSHUP_DOMAIN = "code-pushup.dev";
-var README_LINK = "https://github.com/flowup/quality-metrics-cli#readme";
+var README_LINK = "https://github.com/code-pushup/cli#readme";
 var reportHeadlineText = "Code PushUp Report";
 var reportOverviewTableHeaders = [
-  "\u{1F3F7} Category",
-  "\u2B50 Score",
-  "\u{1F6E1} Audits"
+  {
+    key: "category",
+    label: "\u{1F3F7} Category",
+    align: "left"
+  },
+  {
+    key: "score",
+    label: "\u2B50 Score"
+  },
+  {
+    key: "audits",
+    label: "\u{1F6E1} Audits"
+  }
 ];
 var reportRawOverviewTableHeaders = ["Category", "Score", "Audits"];
-var reportMetaTableHeaders = [
-  "Commit",
-  "Version",
-  "Duration",
-  "Plugins",
-  "Categories",
-  "Audits"
-];
-var pluginMetaTableHeaders = [
-  "Plugin",
-  "Audits",
-  "Version",
-  "Duration"
-];
-var detailsTableHeaders = [
-  "Severity",
-  "Message",
-  "Source file",
-  "Line(s)"
+var issuesTableHeadings = [
+  {
+    key: "severity",
+    label: "Severity"
+  },
+  {
+    key: "message",
+    label: "Message"
+  },
+  {
+    key: "file",
+    label: "Source file"
+  },
+  {
+    key: "line",
+    label: "Line(s)"
+  }
 ];
 
 // packages/utils/src/lib/logging.ts
@@ -837,7 +1263,7 @@ function logListItem(args) {
   singletonisaacUi.rows = [];
   singletonUiInstance?.logger.log(content);
 }
-function link(text) {
+function link3(text) {
   return chalk.underline(chalk.blueBright(text));
 }
 
@@ -904,7 +1330,7 @@ async function ensureDirectoryExists(baseDir) {
     await mkdir(baseDir, { recursive: true });
     return;
   } catch (error) {
-    ui().logger.error(error.message);
+    ui().logger.info(error.message);
     if (error.code !== "EEXIST") {
       throw error;
     }
@@ -969,127 +1395,40 @@ async function crawlFileSystem(options) {
   return resultsNestedArray.flat();
 }
 function findLineNumberInText(content, pattern) {
-  const lines = content.split(/\r?\n/);
-  const lineNumber = lines.findIndex((line) => line.includes(pattern)) + 1;
+  const lines6 = content.split(/\r?\n/);
+  const lineNumber = lines6.findIndex((line) => line.includes(pattern)) + 1;
   return lineNumber === 0 ? null : lineNumber;
 }
 
-// packages/utils/src/lib/reports/md/details.ts
-function details(title, content, cfg = { open: false }) {
-  return `<details${cfg.open ? " open" : ""}>
-<summary>${title}</summary>
-
-${content}
-
-</details>
-`;
-}
-
-// packages/utils/src/lib/reports/md/font-style.ts
-var stylesMap = {
-  i: "_",
-  // italic
-  b: "**",
-  // bold
-  s: "~",
-  // strike through
-  c: "`"
-  // code
-};
-function style(text, styles = ["b"]) {
-  return styles.reduce((t, s) => `${stylesMap[s]}${t}${stylesMap[s]}`, text);
-}
-
-// packages/utils/src/lib/reports/md/headline.ts
-function headline(text, hierarchy = 1) {
-  return `${"#".repeat(hierarchy)} ${text}`;
-}
-function h1(text) {
-  return headline(text, 1);
-}
-function h2(text) {
-  return headline(text, 2);
-}
-function h3(text) {
-  return headline(text, 3);
-}
-
-// packages/utils/src/lib/reports/md/image.ts
-function image(src, alt) {
-  return `![${alt}](${src})`;
-}
-
-// packages/utils/src/lib/reports/md/link.ts
-function link2(href, text) {
-  return `[${text || href}](${href})`;
-}
-
-// packages/utils/src/lib/reports/md/list.ts
-function li(text, order = "unordered") {
-  const style2 = order === "unordered" ? "-" : "- [ ]";
-  return `${style2} ${text}`;
-}
-
-// packages/utils/src/lib/reports/md/paragraphs.ts
-function paragraphs(...sections) {
-  return sections.filter(Boolean).join("\n\n");
-}
-
-// packages/utils/src/lib/reports/md/table.ts
-var alignString = /* @__PURE__ */ new Map([
-  ["l", ":--"],
-  ["c", ":--:"],
-  ["r", "--:"]
-]);
-function tableMd(data, align) {
-  if (data.length === 0) {
-    throw new Error("Data can't be empty");
-  }
-  const alignmentSetting = align ?? data[0]?.map(() => "c");
-  const tableContent = data.map((arr) => `|${arr.join("|")}|`);
-  const alignmentRow = `|${alignmentSetting?.map((s) => alignString.get(s)).join("|")}|`;
-  return tableContent[0] + NEW_LINE + alignmentRow + NEW_LINE + tableContent.slice(1).join(NEW_LINE);
-}
-function tableHtml(data) {
-  if (data.length === 0) {
-    throw new Error("Data can't be empty");
-  }
-  const tableContent = data.map((arr, index) => {
-    if (index === 0) {
-      const headerRow = arr.map((s) => `<th>${s}</th>`).join("");
-      return `<tr>${headerRow}</tr>`;
-    }
-    const row = arr.map((s) => `<td>${s}</td>`).join("");
-    return `<tr>${row}</tr>`;
-  });
-  return `<table>${tableContent.join("")}</table>`;
-}
-
 // packages/utils/src/lib/reports/utils.ts
+var { image: image2, bold: boldMd } = md;
 function formatReportScore(score) {
   return Math.round(score * 100).toString();
 }
 function formatScoreWithColor(score, options) {
-  const styledNumber = options?.skipBold ? formatReportScore(score) : style(formatReportScore(score));
-  return `${getRoundScoreMarker(score)} ${styledNumber}`;
-}
-function getRoundScoreMarker(score) {
-  if (score >= SCORE_COLOR_RANGE.GREEN_MIN) {
-    return "\u{1F7E2}";
-  }
-  if (score >= SCORE_COLOR_RANGE.YELLOW_MIN) {
-    return "\u{1F7E1}";
+  const styledNumber = options?.skipBold ? formatReportScore(score) : boldMd(formatReportScore(score));
+  return `${scoreMarker(score)} ${styledNumber}`;
+}
+var MARKERS = {
+  circle: {
+    red: "\u{1F534}",
+    yellow: "\u{1F7E1}",
+    green: "\u{1F7E2}"
+  },
+  square: {
+    red: "\u{1F7E5}",
+    yellow: "\u{1F7E8}",
+    green: "\u{1F7E9}"
   }
-  return "\u{1F534}";
-}
-function getSquaredScoreMarker(score) {
+};
+function scoreMarker(score, markerType = "circle") {
   if (score >= SCORE_COLOR_RANGE.GREEN_MIN) {
-    return "\u{1F7E9}";
+    return MARKERS[markerType].green;
   }
   if (score >= SCORE_COLOR_RANGE.YELLOW_MIN) {
-    return "\u{1F7E8}";
+    return MARKERS[markerType].yellow;
   }
-  return "\u{1F7E5}";
+  return MARKERS[markerType].red;
 }
 function getDiffMarker(diff) {
   if (diff > 0) {
@@ -1105,7 +1444,7 @@ function colorByScoreDiff(text, diff) {
   return shieldsBadge(text, color);
 }
 function shieldsBadge(text, color) {
-  return image(
+  return image2(
     `https://img.shields.io/badge/${encodeURIComponent(text)}-${color}`,
     text
   );
@@ -1115,7 +1454,7 @@ function formatDiffNumber(diff) {
   const sign = diff < 0 ? "\u2212" : "+";
   return `${sign}${number}`;
 }
-function getSeverityIcon(severity) {
+function severityMarker(severity) {
   if (severity === "error") {
     return "\u{1F6A8}";
   }
@@ -1306,13 +1645,13 @@ function executeProcess(cfg) {
     process2.on("error", (err) => {
       stderr += err.toString();
     });
-    process2.on("close", (code) => {
+    process2.on("close", (code3) => {
       const timings = { date, duration: calcDuration(start) };
-      if (code === 0 || ignoreExitCode) {
+      if (code3 === 0 || ignoreExitCode) {
         onComplete?.();
-        resolve({ code, stdout, stderr, ...timings });
+        resolve({ code: code3, stdout, stderr, ...timings });
       } else {
-        const errorMsg = new ProcessError({ code, stdout, stderr, ...timings });
+        const errorMsg = new ProcessError({ code: code3, stdout, stderr, ...timings });
         onError?.(errorMsg);
         reject(errorMsg);
       }
@@ -1328,165 +1667,181 @@ function filterItemRefsBy(items, refFilterFn) {
   })).filter((item) => item.refs.length);
 }
 
-// packages/utils/src/lib/git.ts
+// packages/utils/src/lib/git/git.ts
 import { isAbsolute, join as join3, relative } from "node:path";
 import { simpleGit } from "simple-git";
-
-// packages/utils/src/lib/transform.ts
-import { platform } from "node:os";
-function toArray(val) {
-  return Array.isArray(val) ? val : [val];
-}
-function objectToKeys(obj) {
-  return Object.keys(obj);
-}
-function objectToEntries(obj) {
-  return Object.entries(obj);
-}
-function objectFromEntries(entries) {
-  return Object.fromEntries(entries);
-}
-function countOccurrences(values) {
-  return values.reduce(
-    (acc, value) => ({ ...acc, [value]: (acc[value] ?? 0) + 1 }),
-    {}
-  );
+function getGitRoot(git = simpleGit()) {
+  return git.revparse("--show-toplevel");
 }
-function distinct(array) {
-  return [...new Set(array)];
+function formatGitPath(path, gitRoot) {
+  const absolutePath = isAbsolute(path) ? path : join3(process.cwd(), path);
+  const relativePath = relative(gitRoot, absolutePath);
+  return toUnixPath(relativePath);
 }
-function deepClone(obj) {
-  return obj == null || typeof obj !== "object" ? obj : structuredClone(obj);
+async function toGitPath(path, git = simpleGit()) {
+  const gitRoot = await getGitRoot(git);
+  return formatGitPath(path, gitRoot);
 }
-function factorOf(items, filterFn) {
-  const itemCount = items.length;
-  if (!itemCount) {
-    return 1;
+var GitStatusError = class _GitStatusError extends Error {
+  static ignoredProps = /* @__PURE__ */ new Set(["current", "tracking"]);
+  static getReducedStatus(status) {
+    return Object.fromEntries(
+      Object.entries(status).filter(([key]) => !this.ignoredProps.has(key)).filter(
+        (entry) => {
+          const value = entry[1];
+          if (value == null) {
+            return false;
+          }
+          if (Array.isArray(value) && value.length === 0) {
+            return false;
+          }
+          if (typeof value === "number" && value === 0) {
+            return false;
+          }
+          return !(typeof value === "boolean" && !value);
+        }
+      )
+    );
   }
-  const filterCount = items.filter(filterFn).length;
-  return filterCount === 0 ? 1 : (itemCount - filterCount) / itemCount;
-}
-function objectToCliArgs(params) {
-  if (!params) {
-    return [];
+  constructor(status) {
+    super(
+      `Working directory needs to be clean before we you can proceed. Commit your local changes or stash them: 
+ ${JSON.stringify(
+        _GitStatusError.getReducedStatus(status),
+        null,
+        2
+      )}`
+    );
+  }
+};
+async function guardAgainstLocalChanges(git = simpleGit()) {
+  const status = await git.status(["-s"]);
+  if (status.files.length > 0) {
+    throw new GitStatusError(status);
   }
-  return Object.entries(params).flatMap(([key, value]) => {
-    if (key === "_") {
-      return Array.isArray(value) ? value : [`${value}`];
-    }
-    const prefix = key.length === 1 ? "-" : "--";
-    if (Array.isArray(value)) {
-      return value.map((v) => `${prefix}${key}="${v}"`);
-    }
-    if (Array.isArray(value)) {
-      return value.map((v) => `${prefix}${key}="${v}"`);
-    }
-    if (typeof value === "string") {
-      return [`${prefix}${key}="${value}"`];
-    }
-    if (typeof value === "number") {
-      return [`${prefix}${key}=${value}`];
-    }
-    if (typeof value === "boolean") {
-      return [`${prefix}${value ? "" : "no-"}${key}`];
-    }
-    throw new Error(`Unsupported type ${typeof value} for key ${key}`);
-  });
-}
-function toUnixPath(path) {
-  return path.replace(/\\/g, "/");
-}
-function toUnixNewlines(text) {
-  return platform() === "win32" ? text.replace(/\r\n/g, "\n") : text;
-}
-function fromJsonLines(jsonLines) {
-  const unifiedNewLines = toUnixNewlines(jsonLines).trim();
-  return JSON.parse(`[${unifiedNewLines.split("\n").join(",")}]`);
-}
-function toJsonLines(json) {
-  return json.map((item) => JSON.stringify(item)).join("\n");
-}
-function capitalize(text) {
-  return `${text.charAt(0).toLocaleUpperCase()}${text.slice(
-    1
-  )}`;
-}
-function apostrophize(text, upperCase) {
-  const lastCharMatch = text.match(/(\w)\W*$/);
-  const lastChar = lastCharMatch?.[1] ?? "";
-  return `${text}'${lastChar.toLocaleLowerCase() === "s" ? "" : upperCase ? "S" : "s"}`;
-}
-function toNumberPrecision(value, decimalPlaces) {
-  return Number(
-    `${Math.round(
-      Number.parseFloat(`${value}e${decimalPlaces}`)
-    )}e-${decimalPlaces}`
-  );
 }
-function toOrdinal(value) {
-  if (value % 10 === 1 && value % 100 !== 11) {
-    return `${value}st`;
+async function safeCheckout(branchOrHash, forceCleanStatus = false, git = simpleGit()) {
+  if (forceCleanStatus) {
+    await git.raw(["reset", "--hard"]);
+    await git.clean(["f", "d"]);
+    ui().logger.info(`git status cleaned`);
   }
-  if (value % 10 === 2 && value % 100 !== 12) {
-    return `${value}nd`;
+  await guardAgainstLocalChanges(git);
+  await git.checkout(branchOrHash);
+}
+
+// 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";
+function normalizeSemver(semverString) {
+  if (semverString.startsWith("v") || semverString.startsWith("V")) {
+    return semverString.slice(1);
   }
-  if (value % 10 === 3 && value % 100 !== 13) {
-    return `${value}rd`;
+  if (semverString.includes("@")) {
+    return semverString.split("@").at(-1) ?? "";
   }
-  return `${value}th`;
+  return semverString;
+}
+function isSemver(semverString = "") {
+  return valid(normalizeSemver(semverString)) != null;
+}
+function sortSemvers(semverStrings) {
+  return semverStrings.map(normalizeSemver).filter(isSemver).sort(rcompare);
 }
 
-// packages/utils/src/lib/git.ts
-async function getLatestCommit(git = simpleGit()) {
+// packages/utils/src/lib/git/git.commits-and-tags.ts
+async function getLatestCommit(git = simpleGit2()) {
   const log2 = await git.log({
     maxCount: 1,
+    // git log -1 --pretty=format:"%H %s %an %aI" - See: https://git-scm.com/docs/pretty-formats
     format: { hash: "%H", message: "%s", author: "%an", date: "%aI" }
   });
-  if (!log2.latest) {
-    return null;
-  }
   return commitSchema.parse(log2.latest);
 }
-function getGitRoot(git = simpleGit()) {
-  return git.revparse("--show-toplevel");
-}
-function formatGitPath(path, gitRoot) {
-  const absolutePath = isAbsolute(path) ? path : join3(process.cwd(), path);
-  const relativePath = relative(gitRoot, absolutePath);
-  return toUnixPath(relativePath);
+async function getCurrentBranchOrTag(git = simpleGit2()) {
+  return await git.branch().then((r) => r.current) || // If no current branch, try to get the tag
+  // @TODO use simple git
+  await git.raw(["describe", "--tags", "--exact-match"]).then((out) => out.trim());
 }
-async function toGitPath(path, git = simpleGit()) {
-  const gitRoot = await getGitRoot(git);
-  return formatGitPath(path, gitRoot);
-}
-async function guardAgainstLocalChanges(git = simpleGit()) {
-  const isClean = await git.status(["-s"]).then((r) => r.files.length === 0);
-  if (!isClean) {
+function validateFilter({ from, to }) {
+  if (to && !from) {
     throw new Error(
-      "Working directory needs to be clean before we you can proceed. Commit your local changes or stash them."
+      `filter needs the "from" option defined to accept the "to" option.
+`
     );
   }
 }
-async function getCurrentBranchOrTag(git = simpleGit()) {
-  try {
-    const branch = await git.branch().then((r) => r.current);
-    if (branch) {
-      return branch;
-    } else {
-      return await git.raw(["describe", "--tags", "--exact-match"]).then((out) => out.trim());
-    }
-  } catch {
-    throw new Error("Could not get current tag or branch.");
+function filterLogs(allTags, opt) {
+  if (!opt) {
+    return allTags;
   }
+  validateFilter(opt);
+  const { from, to, maxCount } = opt;
+  const finIndex = (tagName, fallback) => {
+    const idx = allTags.indexOf(tagName ?? "");
+    if (idx > -1) {
+      return idx;
+    }
+    return fallback;
+  };
+  const fromIndex = finIndex(from, 0);
+  const toIndex = finIndex(to, void 0);
+  return allTags.slice(fromIndex, toIndex ? toIndex + 1 : toIndex).slice(0, maxCount ?? void 0);
 }
-async function safeCheckout(branchOrHash, forceCleanStatus = false, git = simpleGit()) {
-  if (forceCleanStatus) {
-    await git.raw(["reset", "--hard"]);
-    await git.clean(["f", "d"]);
-    ui().logger.info(`git status cleaned`);
+async function getHashFromTag(tag, git = simpleGit2()) {
+  const tagDetails = await git.show(["--no-patch", "--format=%H", tag]);
+  const hash = tagDetails.trim();
+  return {
+    hash: hash.split("\n").at(-1) ?? "",
+    message: tag
+  };
+}
+async function getSemverTags(opt = {}, git = simpleGit2()) {
+  validateFilter(opt);
+  const { targetBranch, ...options } = opt;
+  let currentBranch;
+  if (targetBranch) {
+    currentBranch = await getCurrentBranchOrTag(git);
+    await git.checkout(targetBranch);
+  }
+  const tagsRaw = await git.tag([
+    "--merged",
+    targetBranch ?? await getCurrentBranchOrTag(git)
+  ]);
+  const allTags = tagsRaw.split(/\n/).map((tag) => tag.trim()).filter(Boolean).filter(isSemver);
+  const relevantTags = filterLogs(allTags, options);
+  const tagsWithHashes = await Promise.all(
+    relevantTags.map((tag) => getHashFromTag(tag, git))
+  );
+  if (currentBranch) {
+    await git.checkout(currentBranch);
+  }
+  return tagsWithHashes;
+}
+async function getHashes(options = {}, git = simpleGit2()) {
+  const { targetBranch, from, to, maxCount, ...opt } = options;
+  validateFilter({ from, to });
+  let currentBranch;
+  if (targetBranch) {
+    currentBranch = await getCurrentBranchOrTag(git);
+    await git.checkout(targetBranch);
+  }
+  const logs = await git.log({
+    ...opt,
+    format: {
+      hash: "%H",
+      message: "%s"
+    },
+    from,
+    to,
+    maxCount
+  });
+  if (targetBranch) {
+    await git.checkout(currentBranch);
   }
-  await guardAgainstLocalChanges(git);
-  await git.checkout(branchOrHash);
+  return [...logs.all];
 }
 
 // packages/utils/src/lib/group-by-status.ts
@@ -1564,44 +1919,65 @@ function listAuditsFromAllPlugins(report) {
   );
 }
 
-// packages/utils/src/lib/reports/generate-md-report.ts
-function generateMdReport(report) {
-  const printCategories = report.categories.length > 0;
-  return (
-    // header section
-    // eslint-disable-next-line prefer-template
-    reportToHeaderSection() + NEW_LINE + // categories overview section
-    (printCategories ? reportToOverviewSection(report) + NEW_LINE + NEW_LINE : "") + // categories section
-    (printCategories ? reportToCategoriesSection(report) + NEW_LINE + NEW_LINE : "") + // audits section
-    reportToAuditsSection(report) + NEW_LINE + NEW_LINE + // about section
-    reportToAboutSection(report) + NEW_LINE + NEW_LINE + // footer section
-    `${FOOTER_PREFIX} ${link2(README_LINK, "Code PushUp")}`
+// packages/utils/src/lib/reports/formatting.ts
+var { headline: headline2, lines: lines2, link: link4, section: section2, table: table3 } = md;
+function tableSection(tableData, options) {
+  if (tableData.rows.length === 0) {
+    return "";
+  }
+  const { level = 4 } = options ?? {};
+  const render = (h7, l) => l === 0 ? h7 : headline2(h7, l);
+  return lines2(
+    tableData.title && render(tableData.title, level),
+    table3(tableData)
   );
 }
-function reportToHeaderSection() {
-  return headline(reportHeadlineText) + NEW_LINE;
+function metaDescription({
+  docsUrl,
+  description
+}) {
+  if (docsUrl) {
+    const docsLink = link4(docsUrl, "\u{1F4D6} Docs");
+    if (!description) {
+      return section2(docsLink);
+    }
+    const parsedDescription = description.toString().endsWith("```") ? `${description}${NEW_LINE + NEW_LINE}` : `${description}${SPACE}`;
+    return section2(`${parsedDescription}${docsLink}`);
+  }
+  if (description && description.trim().length > 0) {
+    return section2(description);
+  }
+  return "";
 }
-function reportToOverviewSection(report) {
+
+// packages/utils/src/lib/reports/generate-md-report-categoy-section.ts
+var { link: link5, section: section3, h2: h22, lines: lines3, li: li2, bold: boldMd2, h3: h32, indentation: indentation2 } = md;
+function categoriesOverviewSection(report) {
   const { categories, plugins } = report;
-  const tableContent = [
-    reportOverviewTableHeaders,
-    ...categories.map(({ title, refs, score }) => [
-      link2(`#${slugify(title)}`, title),
-      `${getRoundScoreMarker(score)} ${style(formatReportScore(score))}`,
-      countCategoryAudits(refs, plugins).toString()
-    ])
-  ];
-  return tableMd(tableContent, ["l", "c", "c"]);
+  if (categories.length > 0 && plugins.length > 0) {
+    const tableContent = {
+      columns: reportOverviewTableHeaders,
+      rows: categories.map(({ title, refs, score }) => ({
+        // The heading "ID" is inferred from the heading text in Markdown.
+        category: link5(`#${slugify(title)}`, title),
+        score: `${scoreMarker(score)}${SPACE}${boldMd2(
+          formatReportScore(score)
+        )}`,
+        audits: countCategoryAudits(refs, plugins).toString()
+      }))
+    };
+    return tableSection(tableContent);
+  }
+  return "";
 }
-function reportToCategoriesSection(report) {
+function categoriesDetailsSection(report) {
   const { categories, plugins } = report;
-  const categoryDetails = categories.reduce((acc, category) => {
-    const categoryTitle = h3(category.title);
-    const categoryScore = `${getRoundScoreMarker(
+  const categoryDetails = categories.flatMap((category) => {
+    const categoryTitle = h32(category.title);
+    const categoryScore = `${scoreMarker(
       category.score
-    )} Score:  ${style(formatReportScore(category.score))}`;
-    const categoryDocs = getDocsAndDescription(category);
-    const categoryMDItems = category.refs.reduce((refAcc, ref) => {
+    )}${SPACE}Score:  ${boldMd2(formatReportScore(category.score))}`;
+    const categoryMDItems = category.refs.map((ref) => {
       if (ref.type === "group") {
         const group = getSortableGroupByRef(ref, plugins);
         const groupAudits = group.refs.map(
@@ -1611,151 +1987,240 @@ function reportToCategoriesSection(report) {
           )
         );
         const pluginTitle = getPluginNameFromSlug(ref.plugin, plugins);
-        const mdGroupItem = groupItemToCategorySection(
-          group,
-          groupAudits,
-          pluginTitle
-        );
-        return refAcc + mdGroupItem + NEW_LINE;
+        return categoryGroupItem(group, groupAudits, pluginTitle);
       } else {
         const audit = getSortableAuditByRef(ref, plugins);
         const pluginTitle = getPluginNameFromSlug(ref.plugin, plugins);
-        const mdAuditItem = auditItemToCategorySection(audit, pluginTitle);
-        return refAcc + mdAuditItem + NEW_LINE;
+        return categoryRef(audit, pluginTitle);
       }
-    }, "");
-    return acc + NEW_LINE + categoryTitle + NEW_LINE + NEW_LINE + categoryDocs + categoryScore + NEW_LINE + categoryMDItems;
-  }, "");
-  return h2("\u{1F3F7} Categories") + NEW_LINE + categoryDetails;
-}
-function auditItemToCategorySection(audit, pluginTitle) {
-  const auditTitle = link2(
-    `#${slugify(audit.title)}-${slugify(pluginTitle)}`,
-    audit.title
+    });
+    return section3(
+      categoryTitle,
+      metaDescription(category),
+      categoryScore,
+      ...categoryMDItems
+    );
+  });
+  return lines3(h22(CATEGORIES_TITLE), ...categoryDetails);
+}
+function categoryRef({ title, score, value, displayValue }, pluginTitle) {
+  const auditTitleAsLink = link5(
+    `#${slugify(title)}-${slugify(pluginTitle)}`,
+    title
   );
-  return li(
-    `${getSquaredScoreMarker(
-      audit.score
-    )} ${auditTitle} (_${pluginTitle}_) - ${getAuditResult(audit)}`
+  const marker = scoreMarker(score, "square");
+  return li2(
+    `${marker}${SPACE}${auditTitleAsLink}${SPACE}(_${pluginTitle}_) - ${boldMd2(
+      (displayValue || value).toString()
+    )}`
   );
 }
-function groupItemToCategorySection(group, groupAudits, pluginTitle) {
-  const groupScore = Number(formatReportScore(group.score || 0));
-  const groupTitle = li(
-    `${getRoundScoreMarker(groupScore)} ${group.title} (_${pluginTitle}_)`
+function categoryGroupItem({ score = 0, title }, groupAudits, pluginTitle) {
+  const groupTitle = li2(
+    `${scoreMarker(score)}${SPACE}${title}${SPACE}(_${pluginTitle}_)`
   );
-  const auditTitles = groupAudits.reduce((acc, audit) => {
-    const auditTitle = link2(
-      `#${slugify(audit.title)}-${slugify(pluginTitle)}`,
-      audit.title
-    );
-    return `${acc}  ${li(
-      `${getSquaredScoreMarker(audit.score)} ${auditTitle} - ${getAuditResult(
-        audit
-      )}`
-    )}${NEW_LINE}`;
-  }, "");
-  return groupTitle + NEW_LINE + auditTitles;
-}
-function reportToAuditsSection(report) {
-  const auditsSection = report.plugins.reduce((pluginAcc, plugin) => {
-    const auditsData = plugin.audits.reduce((auditAcc, audit) => {
-      const auditTitle = `${audit.title} (${getPluginNameFromSlug(
-        plugin.slug,
-        report.plugins
-      )})`;
-      return auditAcc + h3(auditTitle) + NEW_LINE + NEW_LINE + reportToDetailsSection(audit) + NEW_LINE + NEW_LINE + getDocsAndDescription(audit);
-    }, "");
-    return pluginAcc + auditsData;
-  }, "");
-  return h2("\u{1F6E1}\uFE0F Audits") + NEW_LINE + NEW_LINE + auditsSection;
-}
-function reportToDetailsSection(audit) {
-  const detailsTitle = `${getSquaredScoreMarker(audit.score)} ${getAuditResult(
-    audit,
-    true
-  )} (score: ${formatReportScore(audit.score)})`;
-  if (!audit.details?.issues.length) {
-    return detailsTitle;
-  }
-  const detailsTableData = [
-    detailsTableHeaders,
-    ...audit.details.issues.map((issue) => {
-      const severity = `${getSeverityIcon(issue.severity)} <i>${issue.severity}</i>`;
-      const message = issue.message;
-      if (!issue.source) {
-        return [severity, message, "", ""];
-      }
-      const file = `<code>${issue.source.file}</code>`;
-      if (!issue.source.position) {
-        return [severity, message, file, ""];
-      }
-      const { startLine, endLine } = issue.source.position;
-      const line = `${startLine || ""}${endLine && startLine !== endLine ? `-${endLine}` : ""}`;
-      return [severity, message, file, line];
-    })
-  ];
-  const detailsTable = `<h4>Issues</h4>${tableHtml(detailsTableData)}`;
-  return details(detailsTitle, detailsTable);
-}
-function reportToAboutSection(report) {
-  const date = formatDate(/* @__PURE__ */ new Date());
-  const { duration, version, commit, plugins, categories } = report;
-  const commitInfo = commit ? `${commit.message} (${commit.hash})` : "N/A";
-  const reportMetaTable = [
-    reportMetaTableHeaders,
-    [
-      commitInfo,
-      style(version || "", ["c"]),
-      formatDuration(duration),
-      plugins.length.toString(),
-      categories.length.toString(),
-      plugins.reduce((acc, { audits }) => acc + audits.length, 0).toString()
-    ]
-  ];
-  const pluginMetaTable = [
-    pluginMetaTableHeaders,
-    ...plugins.map((plugin) => [
-      plugin.title,
-      plugin.audits.length.toString(),
-      style(plugin.version || "", ["c"]),
-      formatDuration(plugin.duration)
-    ])
-  ];
-  return (
-    // eslint-disable-next-line prefer-template
-    h2("About") + NEW_LINE + NEW_LINE + `Report was created by [Code PushUp](${README_LINK}) on ${date}.` + NEW_LINE + NEW_LINE + tableMd(reportMetaTable, ["l", "c", "c", "c", "c", "c"]) + NEW_LINE + NEW_LINE + "The following plugins were run:" + NEW_LINE + NEW_LINE + tableMd(pluginMetaTable, ["l", "c", "c", "c"])
+  const auditTitles = groupAudits.map(
+    ({ title: auditTitle, score: auditScore, value, displayValue }) => {
+      const auditTitleLink = link5(
+        `#${slugify(auditTitle)}-${slugify(pluginTitle)}`,
+        auditTitle
+      );
+      const marker = scoreMarker(auditScore, "square");
+      return indentation2(
+        li2(
+          `${marker}${SPACE}${auditTitleLink} - ${boldMd2(
+            String(displayValue ?? value)
+          )}`
+        )
+      );
+    }
   );
+  return lines3(groupTitle, ...auditTitles);
 }
-function getDocsAndDescription({
-  docsUrl,
-  description
+
+// packages/utils/src/lib/reports/generate-md-report.ts
+var { h1: h12, h2: h23, h3: h33, lines: lines4, link: link6, section: section4, code: codeMd } = md;
+var { bold: boldHtml, details: details2 } = html;
+function auditDetailsAuditValue({
+  score,
+  value,
+  displayValue
 }) {
-  if (docsUrl) {
-    const docsLink = link2(docsUrl, "\u{1F4D6} Docs");
-    if (!description) {
-      return docsLink + NEW_LINE + NEW_LINE;
-    }
-    if (description.endsWith("```")) {
-      return description + NEW_LINE + NEW_LINE + docsLink + NEW_LINE + NEW_LINE;
-    }
-    return `${description} ${docsLink}${NEW_LINE}${NEW_LINE}`;
-  }
-  if (description) {
-    return description + NEW_LINE + NEW_LINE;
+  return `${scoreMarker(score, "square")} ${boldHtml(
+    String(displayValue ?? value)
+  )} (score: ${formatReportScore(score)})`;
+}
+function generateMdReport(report) {
+  const printCategories = report.categories.length > 0;
+  return lines4(
+    h12(reportHeadlineText),
+    printCategories ? categoriesOverviewSection(report) : "",
+    printCategories ? categoriesDetailsSection(report) : "",
+    auditsSection(report),
+    aboutSection(report),
+    `${FOOTER_PREFIX}${SPACE}${link6(README_LINK, "Code PushUp")}`
+  );
+}
+function auditDetailsIssues(issues = []) {
+  if (issues.length === 0) {
+    return "";
   }
-  return "";
+  const detailsTableData = {
+    title: "Issues",
+    columns: issuesTableHeadings,
+    rows: issues.map(
+      ({ severity: severityVal, message, source: sourceVal }) => {
+        const severity = `${severityMarker(severityVal)} <i>${severityVal}</i>`;
+        if (!sourceVal) {
+          return { severity, message, file: "", line: "" };
+        }
+        const file = `<code>${sourceVal.file}</code>`;
+        if (!sourceVal.position) {
+          return { severity, message, file, line: "" };
+        }
+        const { startLine, endLine } = sourceVal.position;
+        const line = `${startLine || ""}${endLine && startLine !== endLine ? `-${endLine}` : ""}`;
+        return { severity, message, file, line };
+      }
+    )
+  };
+  return tableSection(detailsTableData);
+}
+function auditDetails(audit) {
+  const { table: table5, issues = [] } = audit.details ?? {};
+  const detailsValue = auditDetailsAuditValue(audit);
+  if (issues.length === 0 && table5 == null) {
+    return section4(detailsValue);
+  }
+  const tableSectionContent = table5 == null ? "" : tableSection(table5);
+  const issuesSectionContent = issues.length > 0 ? auditDetailsIssues(issues) : "";
+  return details2(
+    detailsValue,
+    lines4(tableSectionContent, issuesSectionContent)
+  );
+}
+function auditsSection({
+  plugins
+}) {
+  const content = plugins.flatMap(
+    ({ slug, audits }) => audits.flatMap((audit) => {
+      const auditTitle = `${audit.title}${SPACE}(${getPluginNameFromSlug(
+        slug,
+        plugins
+      )})`;
+      const detailsContent = auditDetails(audit);
+      const descriptionContent = metaDescription(audit);
+      return [h33(auditTitle), detailsContent, descriptionContent];
+    })
+  );
+  return section4(h23("\u{1F6E1}\uFE0F Audits"), ...content);
+}
+function aboutSection(report) {
+  const { date, plugins } = report;
+  const reportMetaTable = reportMetaData(report);
+  const pluginMetaTable = reportPluginMeta({ plugins });
+  return lines4(
+    h23("About"),
+    section4(
+      `Report was created by [Code PushUp](${README_LINK}) on ${formatDate(
+        new Date(date)
+      )}.`
+    ),
+    tableSection(pluginMetaTable),
+    tableSection(reportMetaTable)
+  );
+}
+function reportPluginMeta({ plugins }) {
+  return {
+    columns: [
+      {
+        key: "plugin",
+        align: "left"
+      },
+      {
+        key: "audits"
+      },
+      {
+        key: "version"
+      },
+      {
+        key: "duration"
+      }
+    ],
+    rows: plugins.map(
+      ({
+        title: pluginTitle,
+        audits,
+        version: pluginVersion,
+        duration: pluginDuration
+      }) => ({
+        plugin: pluginTitle,
+        audits: audits.length.toString(),
+        version: codeMd(pluginVersion || ""),
+        duration: formatDuration(pluginDuration)
+      })
+    )
+  };
 }
-function getAuditResult(audit, isHtml = false) {
-  const { displayValue, value } = audit;
-  return isHtml ? `<b>${displayValue || value}</b>` : style(String(displayValue || value));
+function reportMetaData({
+  commit,
+  version,
+  duration,
+  plugins,
+  categories
+}) {
+  const commitInfo = commit ? `${commit.message}${SPACE}(${commit.hash})` : "N/A";
+  return {
+    columns: [
+      {
+        key: "commit",
+        align: "left"
+      },
+      {
+        key: "version"
+      },
+      {
+        key: "duration"
+      },
+      {
+        key: "plugins"
+      },
+      {
+        key: "categories"
+      },
+      {
+        key: "audits"
+      }
+    ],
+    rows: [
+      {
+        commit: commitInfo,
+        version: codeMd(version || ""),
+        duration: formatDuration(duration),
+        plugins: plugins.length,
+        categories: categories.length,
+        audits: plugins.reduce((acc, { audits }) => acc + audits.length, 0).toString()
+      }
+    ]
+  };
 }
 
 // packages/utils/src/lib/reports/generate-md-reports-diff.ts
+var {
+  h1: h13,
+  h2: h24,
+  lines: lines5,
+  link: link7,
+  bold: boldMd3,
+  italic: italicMd,
+  table: table4,
+  section: section5
+} = md;
+var { details: details3 } = html;
 var MAX_ROWS = 100;
 function generateMdReportsDiff(diff) {
-  return paragraphs(
-    formatDiffHeaderSection(diff),
+  return lines5(
+    section5(formatDiffHeaderSection(diff)),
     formatDiffCategoriesSection(diff),
     formatDiffGroupsSection(diff),
     formatDiffAuditsSection(diff)
@@ -1763,12 +2228,12 @@ function generateMdReportsDiff(diff) {
 }
 function formatDiffHeaderSection(diff) {
   const outcomeTexts = {
-    positive: `\u{1F973} Code PushUp report has ${style("improved")}`,
-    negative: `\u{1F61F} Code PushUp report has ${style("regressed")}`,
-    mixed: `\u{1F928} Code PushUp report has both ${style(
+    positive: `\u{1F973} Code PushUp report has ${boldMd3("improved")}`,
+    negative: `\u{1F61F} Code PushUp report has ${boldMd3("regressed")}`,
+    mixed: `\u{1F928} Code PushUp report has both ${boldMd3(
       "improvements and regressions"
     )}`,
-    unchanged: `\u{1F610} Code PushUp report is ${style("unchanged")}`
+    unchanged: `\u{1F610} Code PushUp report is ${boldMd3("unchanged")}`
   };
   const outcome = mergeDiffOutcomes(
     changesToDiffOutcomes([
@@ -1778,8 +2243,8 @@ function formatDiffHeaderSection(diff) {
     ])
   );
   const styleCommits = (commits) => `compared target commit ${commits.after.hash} with source commit ${commits.before.hash}`;
-  return paragraphs(
-    h1("Code PushUp"),
+  return lines5(
+    h13("Code PushUp"),
     diff.commits ? `${outcomeTexts[outcome]} \u2013 ${styleCommits(diff.commits)}.` : `${outcomeTexts[outcome]}.`
   );
 }
@@ -1790,102 +2255,104 @@ function formatDiffCategoriesSection(diff) {
   if (categoriesCount === 0) {
     return "";
   }
-  return paragraphs(
-    h2("\u{1F3F7}\uFE0F Categories"),
-    categoriesCount > 0 && tableMd(
-      [
-        [
-          "\u{1F3F7}\uFE0F Category",
-          hasChanges ? "\u2B50 Current score" : "\u2B50 Score",
-          "\u2B50 Previous score",
-          "\u{1F504} Score change"
-        ],
-        ...sortChanges(changed).map((category) => [
-          category.title,
-          formatScoreWithColor(category.scores.after),
-          formatScoreWithColor(category.scores.before, { skipBold: true }),
-          formatScoreChange(category.scores.diff)
-        ]),
-        ...added.map((category) => [
-          category.title,
-          formatScoreWithColor(category.score),
-          style("n/a (\\*)", ["i"]),
-          style("n/a (\\*)", ["i"])
-        ]),
-        ...unchanged.map((category) => [
-          category.title,
-          formatScoreWithColor(category.score),
-          formatScoreWithColor(category.score, { skipBold: true }),
-          "\u2013"
-        ])
-      ].map((row) => hasChanges ? row : row.slice(0, 2)),
-      hasChanges ? ["l", "c", "c", "c"] : ["l", "c"]
-    ),
-    added.length > 0 && style("(\\*) New category.", ["i"])
+  const columns = [
+    { key: "category", label: "\u{1F3F7}\uFE0F Category", align: "left" },
+    { key: "after", label: hasChanges ? "\u2B50 Current score" : "\u2B50 Score" },
+    { key: "before", label: "\u2B50 Previous score" },
+    { key: "change", label: "\u{1F504} Score change" }
+  ];
+  return lines5(
+    h24("\u{1F3F7}\uFE0F Categories"),
+    categoriesCount > 0 && table4({
+      columns: hasChanges ? columns : columns.slice(0, 2),
+      rows: [
+        ...sortChanges(changed).map((category) => ({
+          category: formatTitle(category),
+          after: formatScoreWithColor(category.scores.after),
+          before: formatScoreWithColor(category.scores.before, {
+            skipBold: true
+          }),
+          change: formatScoreChange(category.scores.diff)
+        })),
+        ...added.map((category) => ({
+          category: formatTitle(category),
+          after: formatScoreWithColor(category.score),
+          before: italicMd("n/a (\\*)"),
+          change: italicMd("n/a (\\*)")
+        })),
+        ...unchanged.map((category) => ({
+          category: formatTitle(category),
+          after: formatScoreWithColor(category.score),
+          before: formatScoreWithColor(category.score, { skipBold: true }),
+          change: "\u2013"
+        }))
+      ].map(
+        (row) => hasChanges ? row : { category: row.category, after: row.after }
+      )
+    }),
+    added.length > 0 && section5(italicMd("(\\*) New category."))
   );
 }
 function formatDiffGroupsSection(diff) {
   if (diff.groups.changed.length + diff.groups.unchanged.length === 0) {
     return "";
   }
-  return paragraphs(
-    h2("\u{1F5C3}\uFE0F Groups"),
+  return lines5(
+    h24("\u{1F5C3}\uFE0F Groups"),
     formatGroupsOrAuditsDetails("group", diff.groups, {
-      headings: [
-        "\u{1F50C} Plugin",
-        "\u{1F5C3}\uFE0F Group",
-        "\u2B50 Current score",
-        "\u2B50 Previous score",
-        "\u{1F504} Score change"
+      columns: [
+        { key: "plugin", label: "\u{1F50C} Plugin", align: "left" },
+        { key: "group", label: "\u{1F5C3}\uFE0F Group", align: "left" },
+        { key: "after", label: "\u2B50 Current score" },
+        { key: "before", label: "\u2B50 Previous score" },
+        { key: "change", label: "\u{1F504} Score change" }
       ],
-      rows: sortChanges(diff.groups.changed).map((group) => [
-        group.plugin.title,
-        group.title,
-        formatScoreWithColor(group.scores.after),
-        formatScoreWithColor(group.scores.before, { skipBold: true }),
-        formatScoreChange(group.scores.diff)
-      ]),
-      align: ["l", "l", "c", "c", "c"]
+      rows: sortChanges(diff.groups.changed).map((group) => ({
+        plugin: formatTitle(group.plugin),
+        group: formatTitle(group),
+        after: formatScoreWithColor(group.scores.after),
+        before: formatScoreWithColor(group.scores.before, { skipBold: true }),
+        change: formatScoreChange(group.scores.diff)
+      }))
     })
   );
 }
 function formatDiffAuditsSection(diff) {
-  return paragraphs(
-    h2("\u{1F6E1}\uFE0F Audits"),
+  return lines5(
+    h24("\u{1F6E1}\uFE0F Audits"),
     formatGroupsOrAuditsDetails("audit", diff.audits, {
-      headings: [
-        "\u{1F50C} Plugin",
-        "\u{1F6E1}\uFE0F Audit",
-        "\u{1F4CF} Current value",
-        "\u{1F4CF} Previous value",
-        "\u{1F504} Value change"
+      columns: [
+        { key: "plugin", label: "\u{1F50C} Plugin", align: "left" },
+        { key: "audit", label: "\u{1F6E1}\uFE0F Audit", align: "left" },
+        { key: "after", label: "\u{1F4CF} Current value" },
+        { key: "before", label: "\u{1F4CF} Previous value" },
+        { key: "change", label: "\u{1F504} Value change" }
       ],
-      rows: sortChanges(diff.audits.changed).map((audit) => [
-        audit.plugin.title,
-        audit.title,
-        `${getSquaredScoreMarker(audit.scores.after)} ${style(
+      rows: sortChanges(diff.audits.changed).map((audit) => ({
+        plugin: formatTitle(audit.plugin),
+        audit: formatTitle(audit),
+        after: `${scoreMarker(audit.scores.after, "square")} ${boldMd3(
           audit.displayValues.after || audit.values.after.toString()
         )}`,
-        `${getSquaredScoreMarker(audit.scores.before)} ${audit.displayValues.before || audit.values.before.toString()}`,
-        formatValueChange(audit)
-      ]),
-      align: ["l", "l", "c", "c", "c"]
+        before: `${scoreMarker(audit.scores.before, "square")} ${audit.displayValues.before || audit.values.before.toString()}`,
+        change: formatValueChange(audit)
+      }))
     })
   );
 }
-function formatGroupsOrAuditsDetails(token, { changed, unchanged }, table) {
-  return changed.length === 0 ? summarizeUnchanged(token, { changed, unchanged }) : details(
+function formatGroupsOrAuditsDetails(token, { changed, unchanged }, tableData) {
+  return changed.length === 0 ? summarizeUnchanged(token, { changed, unchanged }) : details3(
     summarizeDiffOutcomes(changesToDiffOutcomes(changed), token),
-    paragraphs(
-      tableMd(
-        [table.headings, ...table.rows.slice(0, MAX_ROWS)],
-        table.align
-      ),
-      changed.length > MAX_ROWS && style(
+    lines5(
+      table4({
+        ...tableData,
+        rows: tableData.rows.slice(0, MAX_ROWS)
+        // use never to avoid typing problem
+      }),
+      changed.length > MAX_ROWS && italicMd(
         `Only the ${MAX_ROWS} most affected ${pluralize(
           token
-        )} are listed above for brevity.`,
-        ["i"]
+        )} are listed above for brevity.`
       ),
       unchanged.length > 0 && summarizeUnchanged(token, { changed, unchanged })
     )
@@ -1906,11 +2373,13 @@ function formatValueChange({
   return colorByScoreDiff(`${marker} ${text}`, scores.diff);
 }
 function summarizeUnchanged(token, { changed, unchanged }) {
-  return [
-    changed.length > 0 ? pluralizeToken(`other ${token}`, unchanged.length) : `All of ${pluralizeToken(token, unchanged.length)}`,
-    unchanged.length === 1 ? "is" : "are",
-    "unchanged."
-  ].join(" ");
+  return section5(
+    [
+      changed.length > 0 ? pluralizeToken(`other ${token}`, unchanged.length) : `All of ${pluralizeToken(token, unchanged.length)}`,
+      unchanged.length === 1 ? "is" : "are",
+      "unchanged."
+    ].join(" ")
+  );
 }
 function summarizeDiffOutcomes(outcomes, token) {
   return objectToEntries(countDiffOutcomes(outcomes)).filter(
@@ -1930,6 +2399,15 @@ function summarizeDiffOutcomes(outcomes, token) {
     }
   }).join(", ");
 }
+function formatTitle({
+  title,
+  docsUrl
+}) {
+  if (docsUrl) {
+    return link7(docsUrl, title);
+  }
+  return title;
+}
 function sortChanges(changes) {
   return [...changes].sort(
     (a, b) => Math.abs(b.scores.diff) - Math.abs(a.scores.diff) || Math.abs(b.values?.diff ?? 0) - Math.abs(a.values?.diff ?? 0)
@@ -1977,7 +2455,7 @@ function log(msg = "") {
 }
 function logStdoutSummary(report) {
   const printCategories = report.categories.length > 0;
-  log(reportToHeaderSection2(report));
+  log(reportToHeaderSection(report));
   log();
   logPlugins(report);
   if (printCategories) {
@@ -1986,7 +2464,7 @@ function logStdoutSummary(report) {
   log(`${FOOTER_PREFIX} ${CODE_PUSHUP_DOMAIN}`);
   log();
 }
-function reportToHeaderSection2(report) {
+function reportToHeaderSection(report) {
   const { packageName, version } = report;
   return `${chalk4.bold(reportHeadlineText)} - ${packageName}@${version}`;
 }
@@ -2026,16 +2504,16 @@ function logCategories({ categories, plugins }) {
     applyScoreColor({ score }),
     countCategoryAudits(refs, plugins)
   ]);
-  const table = ui().table();
-  table.columnWidths([TERMINAL_WIDTH - 9 - 10 - 4, 9, 10]);
-  table.head(
+  const table5 = ui().table();
+  table5.columnWidths([TERMINAL_WIDTH - 9 - 10 - 4, 9, 10]);
+  table5.head(
     reportRawOverviewTableHeaders.map((heading, idx) => ({
       content: chalk4.cyan(heading),
       hAlign: hAlign(idx)
     }))
   );
   rows.forEach(
-    (row) => table.row(
+    (row) => table5.row(
       row.map((content, idx) => ({
         content: content.toString(),
         hAlign: hAlign(idx)
@@ -2044,19 +2522,19 @@ function logCategories({ categories, plugins }) {
   );
   log(chalk4.magentaBright.bold("Categories"));
   log();
-  table.render();
+  table5.render();
   log();
 }
 function applyScoreColor({ score, text }) {
   const formattedScore = text ?? formatReportScore(score);
-  const style2 = text ? chalk4 : chalk4.bold;
+  const style = text ? chalk4 : chalk4.bold;
   if (score >= SCORE_COLOR_RANGE.GREEN_MIN) {
-    return style2.green(formattedScore);
+    return style.green(formattedScore);
   }
   if (score >= SCORE_COLOR_RANGE.YELLOW_MIN) {
-    return style2.yellow(formattedScore);
+    return style.yellow(formattedScore);
   }
-  return style2.red(formattedScore);
+  return style.red(formattedScore);
 }
 
 // packages/utils/src/lib/reports/scoring.ts
@@ -2218,8 +2696,11 @@ var verboseUtils = (verbose = false) => ({
 export {
   CODE_PUSHUP_DOMAIN,
   FOOTER_PREFIX,
+  NEW_LINE,
   ProcessError,
   README_LINK,
+  SPACE,
+  TAB,
   TERMINAL_WIDTH,
   apostrophize,
   calcDuration,
@@ -2245,13 +2726,19 @@ export {
   generateMdReportsDiff,
   getCurrentBranchOrTag,
   getGitRoot,
+  getHashFromTag,
+  getHashes,
   getLatestCommit,
   getProgressBar,
+  getSemverTags,
   groupByStatus,
+  guardAgainstLocalChanges,
+  html,
   importEsmModule,
   isPromiseFulfilledResult,
   isPromiseRejectedResult,
-  link,
+  isSemver,
+  link3 as link,
   listAuditsFromAllPlugins,
   listGroupsFromAllPlugins,
   loadReport,
@@ -2259,6 +2746,8 @@ export {
   logMultipleResults,
   logStdoutSummary,
   matchArrayItemsByKey,
+  md,
+  normalizeSemver,
   objectFromEntries,
   objectToCliArgs,
   objectToEntries,
@@ -2273,6 +2762,7 @@ export {
   scoreReport,
   slugify,
   sortReport,
+  sortSemvers,
   toArray,
   toGitPath,
   toJsonLines,