@code-pushup/utils 0.18.1 → 0.20.0

package/index.js

@@ -75,25 +75,15 @@ function executionMetaSchema(options = {
     duration: z.number({ description: options.descriptionDuration })
   });
 }
-function slugSchema(description = "Unique ID (human-readable, URL-safe)") {
-  return z.string({ description }).regex(slugRegex, {
-    message: "The slug has to follow the pattern [0-9a-z] followed by multiple optional groups of -[0-9a-z]. e.g. my-slug"
-  }).max(MAX_SLUG_LENGTH, {
-    message: `slug can be max ${MAX_SLUG_LENGTH} characters long`
-  });
-}
-function descriptionSchema(description = "Description (markdown)") {
-  return z.string({ description }).max(MAX_DESCRIPTION_LENGTH).optional();
-}
-function docsUrlSchema(description = "Documentation site") {
-  return urlSchema(description).optional().or(z.string().max(0));
-}
-function urlSchema(description) {
-  return z.string({ description }).url();
-}
-function titleSchema(description = "Descriptive name") {
-  return z.string({ description }).max(MAX_TITLE_LENGTH);
-}
+var slugSchema = z.string({ description: "Unique ID (human-readable, URL-safe)" }).regex(slugRegex, {
+  message: "The slug has to follow the pattern [0-9a-z] followed by multiple optional groups of -[0-9a-z]. e.g. my-slug"
+}).max(MAX_SLUG_LENGTH, {
+  message: `slug can be max ${MAX_SLUG_LENGTH} characters long`
+});
+var descriptionSchema = z.string({ description: "Description (markdown)" }).max(MAX_DESCRIPTION_LENGTH).optional();
+var urlSchema = z.string().url();
+var docsUrlSchema = urlSchema.optional().or(z.literal("")).describe("Documentation site");
+var titleSchema = z.string({ description: "Descriptive name" }).max(MAX_TITLE_LENGTH);
 function metaSchema(options) {
   const {
     descriptionDescription,
@@ -103,24 +93,19 @@ function metaSchema(options) {
   } = options ?? {};
   return z.object(
     {
-      title: titleSchema(titleDescription),
-      description: descriptionSchema(descriptionDescription),
-      docsUrl: docsUrlSchema(docsUrlDescription)
+      title: titleDescription ? titleSchema.describe(titleDescription) : titleSchema,
+      description: descriptionDescription ? descriptionSchema.describe(descriptionDescription) : descriptionSchema,
+      docsUrl: docsUrlDescription ? docsUrlSchema.describe(docsUrlDescription) : docsUrlSchema
     },
     { description }
   );
 }
-function filePathSchema(description) {
-  return z.string({ description }).trim().min(1, { message: "path is invalid" });
-}
-function fileNameSchema(description) {
-  return z.string({ description }).trim().regex(filenameRegex, {
-    message: `The filename has to be valid`
-  }).min(1, { message: "file name is invalid" });
-}
-function positiveIntSchema(description) {
-  return z.number({ description }).int().nonnegative();
-}
+var filePathSchema = z.string().trim().min(1, { message: "path is invalid" });
+var fileNameSchema = z.string().trim().regex(filenameRegex, {
+  message: `The filename has to be valid`
+}).min(1, { message: "file name is invalid" });
+var positiveIntSchema = z.number().int().positive();
+var nonnegativeIntSchema = z.number().int().nonnegative();
 function packageVersionSchema(options) {
   const { versionDescription = "NPM version of the package", required } = options ?? {};
   const packageSchema = z.string({ description: "NPM package name" });
@@ -133,14 +118,14 @@ function packageVersionSchema(options) {
     { description: "NPM package name and version of a published package" }
   );
 }
-function weightSchema(description = "Coefficient for the given score (use weight 0 if only for display)") {
-  return positiveIntSchema(description);
-}
+var weightSchema = nonnegativeIntSchema.describe(
+  "Coefficient for the given score (use weight 0 if only for display)"
+);
 function weightedRefSchema(description, slugDescription) {
   return z.object(
     {
-      slug: slugSchema(slugDescription),
-      weight: weightSchema("Weight used to calculate score")
+      slug: slugSchema.describe(slugDescription),
+      weight: weightSchema.describe("Weight used to calculate score")
     },
     { description }
   );
@@ -148,14 +133,14 @@ function weightedRefSchema(description, slugDescription) {
 function scorableSchema(description, refSchema, duplicateCheckFn, duplicateMessageFn) {
   return z.object(
     {
-      slug: slugSchema('Human-readable unique ID, e.g. "performance"'),
+      slug: slugSchema.describe('Human-readable unique ID, e.g. "performance"'),
       refs: z.array(refSchema).min(1).refine(
         (refs) => !duplicateCheckFn(refs),
         (refs) => ({
           message: duplicateMessageFn(refs)
         })
-      ).refine(hasWeightedRefsInCategories, () => ({
-        message: `In a category there has to be at least one ref with weight > 0`
+      ).refine(hasNonZeroWeightedRef, () => ({
+        message: "In a category there has to be at least one ref with weight > 0"
       }))
     },
     { description }
@@ -164,13 +149,13 @@ function scorableSchema(description, refSchema, duplicateCheckFn, duplicateMessa
 var materialIconSchema = z.enum(MATERIAL_ICONS, {
   description: "Icon from VSCode Material Icons extension"
 });
-function hasWeightedRefsInCategories(categoryRefs) {
-  return categoryRefs.reduce((acc, { weight }) => weight + acc, 0) !== 0;
+function hasNonZeroWeightedRef(refs) {
+  return refs.reduce((acc, { weight }) => weight + acc, 0) !== 0;
 }
 
 // packages/models/src/lib/audit.ts
 var auditSchema = z2.object({
-  slug: slugSchema("ID (unique within plugin)")
+  slug: slugSchema.describe("ID (unique within plugin)")
 }).merge(
   metaSchema({
     titleDescription: "Descriptive name",
@@ -197,17 +182,20 @@ function getDuplicateSlugsInAudits(audits) {
   return hasDuplicateStrings(audits.map(({ slug }) => slug));
 }
 
-// packages/models/src/lib/audit-issue.ts
+// packages/models/src/lib/audit-output.ts
+import { z as z4 } from "zod";
+
+// packages/models/src/lib/issue.ts
 import { z as z3 } from "zod";
 var sourceFileLocationSchema = z3.object(
   {
-    file: filePathSchema("Relative path to source file in Git repo"),
+    file: filePathSchema.describe("Relative path to source file in Git repo"),
     position: z3.object(
       {
-        startLine: positiveIntSchema("Start line"),
-        startColumn: positiveIntSchema("Start column").optional(),
-        endLine: positiveIntSchema("End line").optional(),
-        endColumn: positiveIntSchema("End column").optional()
+        startLine: positiveIntSchema.describe("Start line"),
+        startColumn: positiveIntSchema.describe("Start column").optional(),
+        endLine: positiveIntSchema.describe("End line").optional(),
+        endColumn: positiveIntSchema.describe("End column").optional()
       },
       { description: "Location in file" }
     ).optional()
@@ -227,21 +215,21 @@ var issueSchema = z3.object(
 );
 
 // packages/models/src/lib/audit-output.ts
-import { z as z4 } from "zod";
+var auditDetailsSchema = z4.object(
+  {
+    issues: z4.array(issueSchema, { description: "List of findings" })
+  },
+  { description: "Detailed information" }
+);
 var auditOutputSchema = z4.object(
   {
-    slug: slugSchema("Reference to audit"),
+    slug: slugSchema.describe("Reference to audit"),
     displayValue: z4.string({ description: "Formatted value (e.g. '0.9 s', '2.1 MB')" }).optional(),
-    value: positiveIntSchema("Raw numeric value"),
+    value: nonnegativeIntSchema.describe("Raw numeric value"),
     score: z4.number({
       description: "Value between 0 and 1"
     }).min(0).max(1),
-    details: z4.object(
-      {
-        issues: z4.array(issueSchema, { description: "List of findings" })
-      },
-      { description: "Detailed information" }
-    ).optional()
+    details: auditDetailsSchema.optional()
   },
   { description: "Audit information" }
 );
@@ -271,7 +259,7 @@ var categoryRefSchema = weightedRefSchema(
     type: z5.enum(["audit", "group"], {
       description: "Discriminant for reference kind, affects where `slug` is looked up"
     }),
-    plugin: slugSchema(
+    plugin: slugSchema.describe(
       "Plugin slug (plugin should contain referenced audit or group)"
     )
   })
@@ -331,10 +319,8 @@ import { z as z11 } from "zod";
 import { z as z6 } from "zod";
 var formatSchema = z6.enum(["json", "md"]);
 var persistConfigSchema = z6.object({
-  outputDir: filePathSchema("Artifacts folder").optional(),
-  filename: fileNameSchema(
-    "Artifacts file name (without extension)"
-  ).optional(),
+  outputDir: filePathSchema.describe("Artifacts folder").optional(),
+  filename: fileNameSchema.describe("Artifacts file name (without extension)").optional(),
   format: z6.array(formatSchema).optional()
 });
 
@@ -395,7 +381,7 @@ var runnerConfigSchema = z8.object(
       description: "Shell command to execute"
     }),
     args: z8.array(z8.string({ description: "Command arguments" })).optional(),
-    outputFile: filePathSchema("Output path"),
+    outputFile: filePathSchema.describe("Output path"),
     outputTransform: outputTransformSchema.optional()
   },
   {
@@ -415,7 +401,7 @@ var pluginMetaSchema = packageVersionSchema().merge(
   })
 ).merge(
   z9.object({
-    slug: slugSchema("Unique plugin slug within core config"),
+    slug: slugSchema.describe("Unique plugin slug within core config"),
     icon: materialIconSchema
   })
 );
@@ -448,12 +434,14 @@ function getMissingRefsFromGroups(pluginCfg) {
 // packages/models/src/lib/upload-config.ts
 import { z as z10 } from "zod";
 var uploadConfigSchema = z10.object({
-  server: urlSchema("URL of deployed portal API"),
+  server: urlSchema.describe("URL of deployed portal API"),
   apiKey: z10.string({
     description: "API key with write access to portal (use `process.env` for security)"
   }),
-  organization: slugSchema("Organization slug from Code PushUp portal"),
-  project: slugSchema("Project slug from Code PushUp portal"),
+  organization: slugSchema.describe(
+    "Organization slug from Code PushUp portal"
+  ),
+  project: slugSchema.describe("Project slug from Code PushUp portal"),
   timeout: z10.number({ description: "Request timeout in minutes (default is 5)" }).positive().int().optional()
 });
 
@@ -1017,16 +1005,140 @@ function executeProcess(cfg) {
   });
 }
 
+// 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 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 capitalize(text) {
+  return `${text.charAt(0).toLocaleUpperCase()}${text.slice(
+    1
+  )}`;
+}
+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/filter-by-slug.ts
+function filterGroupsByAuditSlug(groups, auditSlugs) {
+  const slugs = toArray(auditSlugs);
+  if (slugs.length === 0) {
+    return groups;
+  }
+  return groups.map((group) => ({
+    ...group,
+    refs: filterSlug(group.refs, slugs)
+  })).filter((group) => group.refs.length);
+}
+function filterAuditsBySlug(list, auditSlugs) {
+  const slugs = toArray(auditSlugs);
+  if (slugs.length === 0) {
+    return list;
+  }
+  return filterSlug(list, slugs);
+}
+function filterSlug(refs, slugOrSlugs) {
+  const slugs = toArray(slugOrSlugs);
+  return refs.filter(({ slug }) => slugs.includes(slug));
+}
+
 // packages/utils/src/lib/git.ts
+import { isAbsolute, join as join3, relative } from "node:path";
 import { simpleGit } from "simple-git";
-var git = simpleGit();
-async function getLatestCommit() {
+async function getLatestCommit(git = simpleGit()) {
   const log = await git.log({
     maxCount: 1,
     format: { hash: "%H", message: "%s", author: "%an", date: "%ad" }
   });
   return log.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 toGitPath(path, git = simpleGit()) {
+  const gitRoot = await getGitRoot(git);
+  return formatGitPath(path, gitRoot);
+}
 function validateCommitData(commitData, options = {}) {
   const { throwError = false } = options;
   if (!commitData) {
@@ -1049,18 +1161,24 @@ function groupByStatus(results) {
   );
 }
 
-// packages/utils/src/lib/progress.ts
+// packages/utils/src/lib/logging.ts
 import chalk2 from "chalk";
+function link(text) {
+  return chalk2.underline(chalk2.blueBright(text));
+}
+
+// packages/utils/src/lib/progress.ts
+import chalk3 from "chalk";
 import { MultiProgressBars } from "multi-progress-bars";
 var barStyles = {
-  active: (s) => chalk2.green(s),
-  done: (s) => chalk2.gray(s),
-  idle: (s) => chalk2.gray(s)
+  active: (s) => chalk3.green(s),
+  done: (s) => chalk3.gray(s),
+  idle: (s) => chalk3.gray(s)
 };
 var messageStyles = {
-  active: (s) => chalk2.black(s),
-  done: (s) => chalk2.green(chalk2.bold(s)),
-  idle: (s) => chalk2.gray(s)
+  active: (s) => chalk3.black(s),
+  done: (s) => chalk3.green(chalk3.bold(s)),
+  idle: (s) => chalk3.gray(s)
 };
 var mpb;
 function getSingletonProgressBars(options) {
@@ -1140,7 +1258,7 @@ function h3(text) {
 }
 
 // packages/utils/src/lib/reports/md/link.ts
-function link(href, text) {
+function link2(href, text) {
   return `[${text || href}](${href})`;
 }
 
@@ -1191,7 +1309,7 @@ function generateMdReport(report, commitData) {
     (printCategories ? reportToCategoriesSection(report) + NEW_LINE + NEW_LINE : "") + // audits section
     reportToAuditsSection(report) + NEW_LINE + NEW_LINE + // about section
     reportToAboutSection(report, commitData) + NEW_LINE + NEW_LINE + // footer section
-    `${FOOTER_PREFIX} ${link(README_LINK, "Code PushUp")}`
+    `${FOOTER_PREFIX} ${link2(README_LINK, "Code PushUp")}`
   );
 }
 function reportToHeaderSection() {
@@ -1202,7 +1320,7 @@ function reportToOverviewSection(report) {
   const tableContent = [
     reportOverviewTableHeaders,
     ...categories.map(({ title, refs, score }) => [
-      link(`#${slugify(title)}`, title),
+      link2(`#${slugify(title)}`, title),
       `${getRoundScoreMarker(score)} ${style(formatReportScore(score))}`,
       countCategoryAudits(refs, plugins).toString()
     ])
@@ -1234,7 +1352,7 @@ function reportToCategoriesSection(report) {
 }
 function auditItemToCategorySection(audit, plugins) {
   const pluginTitle = getPluginNameFromSlug(audit.plugin, plugins);
-  const auditTitle = link(
+  const auditTitle = link2(
     `#${slugify(audit.title)}-${slugify(pluginTitle)}`,
     audit.title
   );
@@ -1251,7 +1369,7 @@ function groupItemToCategorySection(group, plugins) {
     `${getRoundScoreMarker(groupScore)} ${group.title} (_${pluginTitle}_)`
   );
   const groupAudits = group.audits.reduce((acc, audit) => {
-    const auditTitle = link(
+    const auditTitle = link2(
       `#${slugify(audit.title)}-${slugify(pluginTitle)}`,
       audit.title
     );
@@ -1338,7 +1456,7 @@ function getDocsAndDescription({
   description
 }) {
   if (docsUrl) {
-    const docsLink = link(docsUrl, "\u{1F4D6} Docs");
+    const docsLink = link2(docsUrl, "\u{1F4D6} Docs");
     if (!description) {
       return docsLink + NEW_LINE + NEW_LINE;
     }
@@ -1359,7 +1477,7 @@ function getAuditResult(audit, isHtml = false) {
 
 // packages/utils/src/lib/reports/generate-stdout-summary.ts
 import cliui from "@isaacs/cliui";
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 import CliTable3 from "cli-table3";
 function addLine(line = "") {
   return line + NEW_LINE;
@@ -1370,7 +1488,7 @@ function generateStdoutSummary(report) {
 }
 function reportToHeaderSection2(report) {
   const { packageName, version } = report;
-  return `${chalk3.bold(reportHeadlineText)} - ${packageName}@${version}`;
+  return `${chalk4.bold(reportHeadlineText)} - ${packageName}@${version}`;
 }
 function reportToDetailSection(report) {
   const { plugins } = report;
@@ -1390,13 +1508,13 @@ function reportToDetailSection(report) {
           padding: [0, 3, 0, 0]
         },
         {
-          text: chalk3.cyanBright(audit.displayValue || `${audit.value}`),
+          text: chalk4.cyanBright(audit.displayValue || `${audit.value}`),
           width: 10,
           padding: [0, 0, 0, 0]
         }
       );
     });
-    return acc + addLine() + addLine(chalk3.magentaBright.bold(`${title} audits`)) + addLine() + addLine(ui.toString()) + addLine();
+    return acc + addLine() + addLine(chalk4.magentaBright.bold(`${title} audits`)) + addLine() + addLine(ui.toString()) + addLine();
   }, "");
 }
 function reportToOverviewSection2({
@@ -1419,11 +1537,11 @@ function reportToOverviewSection2({
       countCategoryAudits(refs, plugins)
     ])
   );
-  return addLine(chalk3.magentaBright.bold("Categories")) + addLine() + addLine(table.toString());
+  return addLine(chalk4.magentaBright.bold("Categories")) + addLine() + addLine(table.toString());
 }
 function withColor({ score, text }) {
   const formattedScore = text ?? formatReportScore(score);
-  const style2 = text ? chalk3 : chalk3.bold;
+  const style2 = text ? chalk4 : chalk4.bold;
   if (score >= SCORE_COLOR_RANGE.GREEN_MIN) {
     return style2.green(formattedScore);
   }
@@ -1433,99 +1551,6 @@ function withColor({ score, text }) {
   return style2.red(formattedScore);
 }
 
-// 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 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, options) {
-  const unixPath = path.replace(/\\/g, "/");
-  if (options?.toRelative) {
-    return unixPath.replace(`${process.cwd().replace(/\\/g, "/")}/`, "");
-  }
-  return unixPath;
-}
-function toUnixNewlines(text) {
-  return platform() === "win32" ? text.replace(/\r\n/g, "\n") : text;
-}
-function capitalize(text) {
-  return `${text.charAt(0).toLocaleUpperCase()}${text.slice(
-    1
-  )}`;
-}
-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/reports/scoring.ts
 var GroupRefInvalidError = class extends Error {
   constructor(auditSlug, pluginSlug) {
@@ -1685,35 +1710,6 @@ var verboseUtils = (verbose = false) => ({
   log: getLogVerbose(verbose),
   exec: getExecVerbose(verbose)
 });
-
-// packages/utils/src/lib/logging.ts
-import chalk4 from "chalk";
-function link2(text) {
-  return chalk4.underline(chalk4.blueBright(text));
-}
-
-// packages/utils/src/lib/filter-by-slug.ts
-function filterGroupsByAuditSlug(groups, auditSlugs) {
-  const slugs = toArray(auditSlugs);
-  if (slugs.length === 0) {
-    return groups;
-  }
-  return groups.map((group) => ({
-    ...group,
-    refs: filterSlug(group.refs, slugs)
-  })).filter((group) => group.refs.length);
-}
-function filterAuditsBySlug(list, auditSlugs) {
-  const slugs = toArray(auditSlugs);
-  if (slugs.length === 0) {
-    return list;
-  }
-  return filterSlug(list, slugs);
-}
-function filterSlug(refs, slugOrSlugs) {
-  const slugs = toArray(slugOrSlugs);
-  return refs.filter(({ slug }) => slugs.includes(slug));
-}
 export {
   CODE_PUSHUP_DOMAIN,
   FOOTER_PREFIX,
@@ -1737,16 +1733,17 @@ export {
   findLineNumberInText,
   formatBytes,
   formatDuration,
+  formatGitPath,
   generateMdReport,
   generateStdoutSummary,
+  getGitRoot,
   getLatestCommit,
   getProgressBar,
-  git,
   groupByStatus,
   importEsmModule,
   isPromiseFulfilledResult,
   isPromiseRejectedResult,
-  link2 as link,
+  link,
   loadReport,
   logMultipleFileResults,
   logMultipleResults,
@@ -1764,6 +1761,7 @@ export {
   slugify,
   sortReport,
   toArray,
+  toGitPath,
   toNumberPrecision,
   toOrdinal,
   toUnixNewlines,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@code-pushup/utils",
-  "version": "0.18.1",
+  "version": "0.20.0",
   "dependencies": {
     "@code-pushup/models": "*",
     "bundle-require": "^4.0.1",

package/src/index.d.ts

@@ -1,11 +1,13 @@
 export { exists } from '@code-pushup/models';
 export { ProcessConfig, ProcessError, ProcessObserver, ProcessResult, executeProcess, } from './lib/execute-process';
 export { CrawlFileSystemOptions, FileResult, MultipleFileResults, crawlFileSystem, directoryExists, ensureDirectoryExists, fileExists, findLineNumberInText, importEsmModule, logMultipleFileResults, pluginWorkDir, readJsonFile, readTextFile, removeDirectoryIfExists, } from './lib/file-system';
+export { filterAuditsBySlug, filterGroupsByAuditSlug, } from './lib/filter-by-slug';
 export { formatBytes, formatDuration, pluralize, pluralizeToken, slugify, truncateDescription, truncateIssueMessage, truncateText, truncateTitle, } from './lib/formatting';
-export { getLatestCommit, git, validateCommitData } from './lib/git';
+export { formatGitPath, getGitRoot, getLatestCommit, toGitPath, validateCommitData, } from './lib/git';
 export { groupByStatus } from './lib/group-by-status';
 export { isPromiseFulfilledResult, isPromiseRejectedResult, } from './lib/guards';
 export { logMultipleResults } from './lib/log-results';
+export { link } from './lib/logging';
 export { ProgressBar, getProgressBar } from './lib/progress';
 export { TERMINAL_WIDTH } from './lib/reports/constants';
 export { generateMdReport } from './lib/reports/generate-md-report';
@@ -15,5 +17,3 @@ export { sortReport } from './lib/reports/sorting';
 export { CODE_PUSHUP_DOMAIN, FOOTER_PREFIX, README_LINK, calcDuration, compareIssueSeverity, loadReport, portalCommitDashboardLink, } from './lib/reports/utils';
 export { CliArgsObject, capitalize, countOccurrences, distinct, factorOf, objectToCliArgs, objectToEntries, objectToKeys, toArray, toNumberPrecision, toOrdinal, toUnixNewlines, toUnixPath, } from './lib/transform';
 export { verboseUtils } from './lib/verbose-utils';
-export { link } from './lib/logging';
-export { filterAuditsBySlug, filterGroupsByAuditSlug, } from './lib/filter-by-slug';

package/src/lib/git.d.ts

@@ -4,13 +4,15 @@ export type CommitData = {
     author: string;
     date: string;
 };
-export declare const git: import("simple-git").SimpleGit;
-export declare function getLatestCommit(): Promise<({
+export declare function getLatestCommit(git?: import("simple-git").SimpleGit): Promise<({
     hash: string;
     message: string;
     author: string;
     date: string;
 } & import("simple-git").ListLogLine) | null>;
-export declare function validateCommitData(commitData?: unknown, options?: {
+export declare function getGitRoot(git?: import("simple-git").SimpleGit): Promise<string>;
+export declare function formatGitPath(path: string, gitRoot: string): string;
+export declare function toGitPath(path: string, git?: import("simple-git").SimpleGit): Promise<string>;
+export declare function validateCommitData(commitData: CommitData | null, options?: {
     throwError?: boolean;
 }): commitData is CommitData;

package/src/lib/transform.d.ts

@@ -22,9 +22,7 @@ Record<string, ArgumentValue | undefined> | {
  * });
  */
 export declare function objectToCliArgs<T extends object = Record<string, ArgumentValue>>(params?: CliArgsObject<T>): string[];
-export declare function toUnixPath(path: string, options?: {
-    toRelative?: boolean;
-}): string;
+export declare function toUnixPath(path: string): string;
 export declare function toUnixNewlines(text: string): string;
 export declare function capitalize<T extends string>(text: T): Capitalize<T>;
 export declare function toNumberPrecision(value: number, decimalPlaces: number): number;