@code-pushup/utils 0.48.0 → 0.50.0

package/package.json

@@ -1,19 +1,21 @@
 {
   "name": "@code-pushup/utils",
-  "version": "0.48.0",
+  "version": "0.50.0",
+  "description": "Low-level utilities (helper functions, etc.) used by Code PushUp CLI",
   "dependencies": {
-    "@code-pushup/models": "0.48.0",
+    "@code-pushup/models": "0.50.0",
+    "@isaacs/cliui": "^8.0.2",
+    "@poppinss/cliui": "^6.4.0",
+    "ansis": "^3.3.0",
+    "build-md": "^0.4.2",
     "bundle-require": "^4.0.1",
     "esbuild": "^0.19.2",
-    "chalk": "^5.3.0",
-    "@isaacs/cliui": "^8.0.2",
-    "simple-git": "^3.20.0",
     "multi-progress-bars": "^5.0.3",
-    "@poppinss/cliui": "^6.4.0",
-    "semver": "^7.6.0"
+    "semver": "^7.6.0",
+    "simple-git": "^3.20.0"
   },
   "license": "MIT",
-  "homepage": "https://github.com/code-pushup/cli#readme",
+  "homepage": "https://github.com/code-pushup/cli/tree/main/packages/utils#readme",
   "bugs": {
     "url": "https://github.com/code-pushup/cli/issues"
   },
@@ -22,33 +24,6 @@
     "url": "git+https://github.com/code-pushup/cli.git",
     "directory": "packages/utils"
   },
-  "contributors": [
-    {
-      "name": "Igor Katsuba",
-      "email": "igor@katsuba.dev",
-      "url": "https://katsuba.dev"
-    },
-    {
-      "name": "Kateřina Pilátová",
-      "email": "katerina.pilatova@flowup.cz",
-      "url": "https://github.com/Tlacenka"
-    },
-    {
-      "name": "Matěj Chalk",
-      "email": "matej.chalk@flowup.cz",
-      "url": "https://github.com/matejchalk"
-    },
-    {
-      "name": "Michael Hladky",
-      "email": "michael.hladky@push-based.io",
-      "url": "https://push-based.io"
-    },
-    {
-      "name": "Michael Seredenko",
-      "email": "misha.seredenko@push-based.io",
-      "url": "https://github.com/MishaSeredenkoPushBased"
-    }
-  ],
   "type": "module",
   "main": "./index.js",
   "types": "./src/index.d.ts"

package/src/index.d.ts

@@ -1,28 +1,30 @@
 export { exists } from '@code-pushup/models';
-export { Diff, comparePairs, matchArrayItemsByKey } from './lib/diff';
-export { ProcessConfig, ProcessError, ProcessObserver, ProcessResult, executeProcess, } from './lib/execute-process';
-export { CrawlFileSystemOptions, FileResult, MultipleFileResults, crawlFileSystem, directoryExists, ensureDirectoryExists, fileExists, filePathToCliArg, findLineNumberInText, importModule, logMultipleFileResults, pluginWorkDir, readJsonFile, readTextFile, removeDirectoryIfExists, } from './lib/file-system';
+export { type Diff, comparePairs, matchArrayItemsByKey } from './lib/diff';
+export { stringifyError } from './lib/errors';
+export { type ProcessConfig, ProcessError, type ProcessObserver, type ProcessResult, executeProcess, } from './lib/execute-process';
+export { type CrawlFileSystemOptions, type FileResult, type MultipleFileResults, crawlFileSystem, directoryExists, ensureDirectoryExists, fileExists, filePathToCliArg, findLineNumberInText, importModule, logMultipleFileResults, pluginWorkDir, readJsonFile, readTextFile, removeDirectoryIfExists, } from './lib/file-system';
 export { filterItemRefsBy } from './lib/filter';
 export { formatBytes, formatDuration, pluralize, pluralizeToken, slugify, truncateDescription, truncateIssueMessage, truncateText, truncateTitle, } from './lib/formatting';
 export { formatGitPath, getGitRoot, guardAgainstLocalChanges, safeCheckout, toGitPath, } from './lib/git/git';
-export { LogResult, getCurrentBranchOrTag, getHashFromTag, getHashes, getLatestCommit, getSemverTags, } from './lib/git/git.commits-and-tags';
+export { type LogResult, getCurrentBranchOrTag, getHashFromTag, getHashes, getLatestCommit, getSemverTags, } from './lib/git/git.commits-and-tags';
 export { groupByStatus } from './lib/group-by-status';
 export { isPromiseFulfilledResult, isPromiseRejectedResult, } from './lib/guards';
 export { logMultipleResults } from './lib/log-results';
-export { CliUi, Column, link, ui } from './lib/logging';
+export { type CliUi, type Column, link, ui } from './lib/logging';
 export { mergeConfigs } from './lib/merge-configs';
-export { ProgressBar, getProgressBar } from './lib/progress';
+export { type ProgressBar, getProgressBar } from './lib/progress';
 export { CODE_PUSHUP_DOMAIN, FOOTER_PREFIX, README_LINK, TERMINAL_WIDTH, } from './lib/reports/constants';
 export { listAuditsFromAllPlugins, listGroupsFromAllPlugins, } from './lib/reports/flatten-plugins';
 export { generateMdReport } from './lib/reports/generate-md-report';
-export { generateMdReportsDiff } from './lib/reports/generate-md-reports-diff';
+export { generateMdReportsDiff, generateMdReportsDiffForMonorepo, } from './lib/reports/generate-md-reports-diff';
+export { loadReport } from './lib/reports/load-report';
 export { logStdoutSummary } from './lib/reports/log-stdout-summary';
 export { scoreReport } from './lib/reports/scoring';
 export { sortReport } from './lib/reports/sorting';
-export { ScoredCategoryConfig, ScoredGroup, ScoredReport, } from './lib/reports/types';
-export { calcDuration, compareIssueSeverity, loadReport, } from './lib/reports/utils';
+export type { ScoredCategoryConfig, ScoredGroup, ScoredReport, } from './lib/reports/types';
+export { calcDuration, compareIssueSeverity, formatReportScore, } from './lib/reports/utils';
 export { isSemver, normalizeSemver, sortSemvers } from './lib/semver';
 export * from './lib/text-formats';
-export { CliArgsObject, apostrophize, capitalize, countOccurrences, distinct, factorOf, fromJsonLines, objectFromEntries, objectToCliArgs, objectToEntries, objectToKeys, toArray, toJsonLines, toNumberPrecision, toOrdinal, toUnixNewlines, toUnixPath, } from './lib/transform';
-export { ExcludeNullFromPropertyTypes } from './lib/types';
+export { type CliArgsObject, capitalize, countOccurrences, distinct, factorOf, fromJsonLines, objectFromEntries, objectToCliArgs, objectToEntries, objectToKeys, toArray, toJsonLines, toNumberPrecision, toOrdinal, toUnixNewlines, toUnixPath, } from './lib/transform';
+export type { ExcludeNullFromPropertyTypes, ExtractArray, ExtractArrays, ItemOrArray, Prettify, WithRequired, } from './lib/types';
 export { verboseUtils } from './lib/verbose-utils';

package/src/lib/errors.d.ts

@@ -0,0 +1 @@
+export declare function stringifyError(error: unknown): string;

package/src/lib/execute-process.d.ts

@@ -1,3 +1,5 @@
+/// <reference types="node" />
+import { type ChildProcess, type SpawnOptionsWithStdioTuple, type StdioPipe } from 'node:child_process';
 /**
  * Represents the process result.
  * @category Types
@@ -66,10 +68,9 @@ export declare class ProcessError extends Error {
  * args: ['--version']
  *
  */
-export type ProcessConfig = {
+export type ProcessConfig = Omit<SpawnOptionsWithStdioTuple<StdioPipe, StdioPipe, StdioPipe>, 'stdio'> & {
     command: string;
     args?: string[];
-    cwd?: string;
     observer?: ProcessObserver;
     ignoreExitCode?: boolean;
 };
@@ -87,7 +88,8 @@ export type ProcessConfig = {
  *  }
  */
 export type ProcessObserver = {
-    onStdout?: (stdout: string) => void;
+    onStdout?: (stdout: string, sourceProcess?: ChildProcess) => void;
+    onStderr?: (stderr: string, sourceProcess?: ChildProcess) => void;
     onError?: (error: ProcessError) => void;
     onComplete?: () => void;
 };

package/src/lib/git/git.commits-and-tags.d.ts

@@ -1,5 +1,5 @@
-import { LogOptions as SimpleGitLogOptions } from 'simple-git';
-import { Commit } from '@code-pushup/models';
+import { type LogOptions as SimpleGitLogOptions } from 'simple-git';
+import { type Commit } from '@code-pushup/models';
 export declare function getLatestCommit(git?: import("simple-git").SimpleGit): Promise<Commit | null>;
 export declare function getCurrentBranchOrTag(git?: import("simple-git").SimpleGit): Promise<string>;
 export type LogResult = {

package/src/lib/git/git.d.ts

@@ -1,4 +1,4 @@
-import { StatusResult } from 'simple-git';
+import { type StatusResult } from 'simple-git';
 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>;

package/src/lib/merge-configs.d.ts

@@ -1,2 +1,2 @@
-import { CoreConfig } from '@code-pushup/models';
+import type { CoreConfig } from '@code-pushup/models';
 export declare function mergeConfigs(config: CoreConfig, ...configs: Partial<CoreConfig>[]): Partial<CoreConfig>;

package/src/lib/progress.d.ts

@@ -1,4 +1,4 @@
-import { CtorOptions, MultiProgressBars } from 'multi-progress-bars';
+import { type CtorOptions, MultiProgressBars } from 'multi-progress-bars';
 type BarStyles = 'active' | 'done' | 'idle';
 type StatusStyles = Record<BarStyles, (s: string) => string>;
 export declare const barStyles: StatusStyles;

package/src/lib/reports/constants.d.ts

@@ -3,33 +3,8 @@ export declare const SCORE_COLOR_RANGE: {
     GREEN_MIN: number;
     YELLOW_MIN: number;
 };
-export declare const CATEGORIES_TITLE = "\uD83C\uDFF7 Categories";
 export declare const FOOTER_PREFIX = "Made with \u2764 by";
 export declare const CODE_PUSHUP_DOMAIN = "code-pushup.dev";
 export declare const README_LINK = "https://github.com/code-pushup/cli#readme";
-export declare const reportHeadlineText = "Code PushUp Report";
-export declare const reportOverviewTableHeaders: [{
-    readonly key: "category";
-    readonly label: "🏷 Category";
-    readonly align: "left";
-}, {
-    readonly key: "score";
-    readonly label: "⭐ Score";
-}, {
-    readonly key: "audits";
-    readonly label: "🛡 Audits";
-}];
-export declare const reportRawOverviewTableHeaders: string[];
-export declare const issuesTableHeadings: [{
-    readonly key: "severity";
-    readonly label: "Severity";
-}, {
-    readonly key: "message";
-    readonly label: "Message";
-}, {
-    readonly key: "file";
-    readonly label: "Source file";
-}, {
-    readonly key: "line";
-    readonly label: "Line(s)";
-}];
+export declare const REPORT_HEADLINE_TEXT = "Code PushUp Report";
+export declare const REPORT_RAW_OVERVIEW_TABLE_HEADERS: string[];

package/src/lib/reports/flatten-plugins.d.ts

@@ -1,4 +1,4 @@
-import { Report } from '@code-pushup/models';
+import type { Report } from '@code-pushup/models';
 export declare function listGroupsFromAllPlugins<T extends Report>(report: T): {
     plugin: T['plugins'][number];
     group: NonNullable<T['plugins'][number]['groups']>[number];

package/src/lib/reports/formatting.d.ts

@@ -1,6 +1,6 @@
-import { AuditReport, Table } from '@code-pushup/models';
-import { Hierarchy } from '../text-formats';
+import { type HeadingLevel, type InlineText, MarkdownDocument } from 'build-md';
+import type { AuditReport, Table } from '@code-pushup/models';
 export declare function tableSection(tableData: Table, options?: {
-    level?: Hierarchy | 0;
-}): string;
-export declare function metaDescription({ docsUrl, description, }: Pick<AuditReport, 'docsUrl' | 'description'>): string;
+    level?: HeadingLevel;
+}): MarkdownDocument | null;
+export declare function metaDescription(audit: Pick<AuditReport, 'docsUrl' | 'description'>): InlineText;

package/src/lib/reports/generate-md-report-categoy-section.d.ts

@@ -1,6 +1,8 @@
-import { AuditReport } from '@code-pushup/models';
-import { ScoredGroup, ScoredReport } from './types';
-export declare function categoriesOverviewSection(report: Pick<ScoredReport, 'categories' | 'plugins'>): string;
-export declare function categoriesDetailsSection(report: Pick<ScoredReport, 'categories' | 'plugins'>): string;
-export declare function categoryRef({ title, score, value, displayValue }: AuditReport, pluginTitle: string): string;
-export declare function categoryGroupItem({ score, title }: ScoredGroup, groupAudits: AuditReport[], pluginTitle: string): string;
+import { type InlineText, MarkdownDocument } from 'build-md';
+import type { AuditReport } from '@code-pushup/models';
+import type { ScoredGroup, ScoredReport } from './types';
+export declare function categoriesOverviewSection(report: Pick<ScoredReport, 'categories' | 'plugins'>): MarkdownDocument;
+export declare function categoriesDetailsSection(report: Pick<ScoredReport, 'categories' | 'plugins'>): MarkdownDocument;
+export declare function categoryRef({ title, score, value, displayValue }: AuditReport, pluginTitle: string): InlineText;
+export declare function categoryGroupItem({ score, title }: ScoredGroup, groupAudits: AuditReport[], pluginTitle: string): InlineText;
+export declare function binaryIconSuffix(score: number, isBinary: boolean | undefined): string;

package/src/lib/reports/generate-md-report.d.ts

@@ -1,10 +1,11 @@
-import { AuditReport, Issue, Report, Table } from '@code-pushup/models';
-import { ScoredReport } from './types';
-export declare function auditDetailsAuditValue({ score, value, displayValue, }: AuditReport): string;
+import { type InlineText, MarkdownDocument } from 'build-md';
+import type { AuditReport, Issue, Report } from '@code-pushup/models';
+import type { ScoredReport } from './types';
+export declare function auditDetailsAuditValue({ score, value, displayValue, }: AuditReport): InlineText;
 export declare function generateMdReport(report: ScoredReport): string;
-export declare function auditDetailsIssues(issues?: Issue[]): string;
-export declare function auditDetails(audit: AuditReport): string;
-export declare function auditsSection({ plugins, }: Pick<ScoredReport, 'plugins'>): string;
-export declare function aboutSection(report: Omit<ScoredReport, 'packageName'>): string;
-export declare function reportPluginMeta({ plugins }: Pick<Report, 'plugins'>): Table;
-export declare function reportMetaData({ commit, version, duration, plugins, categories, }: Pick<ScoredReport, 'date' | 'duration' | 'version' | 'commit' | 'plugins' | 'categories'>): Table;
+export declare function auditDetailsIssues(issues?: Issue[]): MarkdownDocument | null;
+export declare function auditDetails(audit: AuditReport): MarkdownDocument;
+export declare function auditsSection({ plugins, }: Pick<ScoredReport, 'plugins'>): MarkdownDocument;
+export declare function aboutSection(report: Omit<ScoredReport, 'packageName'>): MarkdownDocument;
+export declare function pluginMetaTable({ plugins, }: Pick<Report, 'plugins'>): Parameters<MarkdownDocument['table']>;
+export declare function reportMetaTable({ commit, version, duration, plugins, categories, }: Pick<ScoredReport, 'date' | 'duration' | 'version' | 'commit' | 'plugins' | 'categories'>): Parameters<MarkdownDocument['table']>;

package/src/lib/reports/generate-md-reports-diff-utils.d.ts

@@ -0,0 +1,29 @@
+import { type InlineText, MarkdownDocument } from 'build-md';
+import type { ReportsDiff } from '@code-pushup/models';
+import type { DiffOutcome } from './types';
+export declare function summarizeUnchanged(token: string, { changed, unchanged }: {
+    changed: unknown[];
+    unchanged: unknown[];
+}): string;
+export declare function summarizeDiffOutcomes(outcomes: DiffOutcome[], token: string): string;
+export declare function createGroupsOrAuditsDetails<T extends 'group' | 'audit'>(token: T, { changed, unchanged }: ReportsDiff[`${T}s`], ...[columns, rows]: Parameters<MarkdownDocument['table']>): MarkdownDocument;
+export declare function formatTitle({ title, docsUrl, }: {
+    title: string;
+    docsUrl?: string;
+}): InlineText;
+export declare function formatPortalLink(portalUrl: string | undefined): InlineText | undefined;
+type Change = {
+    scores: {
+        diff: number;
+    };
+    values?: {
+        diff: number;
+    };
+};
+export declare function sortChanges<T extends Change>(changes: T[]): T[];
+export declare function getDiffChanges(diff: ReportsDiff): Change[];
+export declare function changesToDiffOutcomes(changes: Change[]): DiffOutcome[];
+export declare function mergeDiffOutcomes(outcomes: DiffOutcome[]): DiffOutcome;
+export declare function formatReportOutcome(outcome: DiffOutcome, commits?: ReportsDiff['commits']): InlineText;
+export declare function compareDiffsBy<T extends 'categories' | 'groups' | 'audits'>(type: T, a: ReportsDiff, b: ReportsDiff): number;
+export {};

package/src/lib/reports/generate-md-reports-diff.d.ts

@@ -1,2 +1,5 @@
-import { ReportsDiff } from '@code-pushup/models';
+import type { ReportsDiff } from '@code-pushup/models';
+import type { WithRequired } from '../types';
 export declare function generateMdReportsDiff(diff: ReportsDiff): string;
+export type LabeledDiff = WithRequired<ReportsDiff, 'label'>;
+export declare function generateMdReportsDiffForMonorepo(diffs: LabeledDiff[]): string;

package/src/lib/reports/load-report.d.ts

@@ -0,0 +1,6 @@
+import { type Format, type PersistConfig, type Report } from '@code-pushup/models';
+type LoadedReportFormat<T extends Format> = T extends 'json' ? Report : string;
+export declare function loadReport<T extends Format>(options: Required<Omit<PersistConfig, 'format'>> & {
+    format: T;
+}): Promise<LoadedReportFormat<T>>;
+export {};

package/src/lib/reports/log-stdout-summary.d.ts

@@ -1,2 +1,4 @@
-import { ScoredReport } from './types';
+import type { ScoredReport } from './types';
 export declare function logStdoutSummary(report: ScoredReport): void;
+export declare function logCategories({ categories, plugins }: ScoredReport): void;
+export declare function binaryIconPrefix(score: number, isBinary: boolean | undefined): string;

package/src/lib/reports/scoring.d.ts

@@ -1,5 +1,5 @@
-import { Report } from '@code-pushup/models';
-import { ScoredReport } from './types';
+import type { Report } from '@code-pushup/models';
+import type { ScoredReport } from './types';
 export declare class GroupRefInvalidError extends Error {
     constructor(auditSlug: string, pluginSlug: string);
 }

package/src/lib/reports/sorting.d.ts

@@ -1,2 +1,6 @@
-import { ScoredReport } from './types';
+import type { CategoryRef, Group } from '@code-pushup/models';
+import type { ScoredReport, SortableAuditReport, SortableGroup } from './types';
+export declare function getSortableAuditByRef({ slug, weight, plugin }: CategoryRef, plugins: ScoredReport['plugins']): SortableAuditReport;
+export declare function getSortedGroupAudits(group: Group, plugin: string, plugins: ScoredReport['plugins']): SortableAuditReport[];
+export declare function getSortableGroupByRef({ plugin, slug, weight }: CategoryRef, plugins: ScoredReport['plugins']): SortableGroup;
 export declare function sortReport(report: ScoredReport): ScoredReport;

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

@@ -1,4 +1,4 @@
-import { AuditReport, CategoryConfig, Group, PluginReport, Report } from '@code-pushup/models';
+import type { AuditReport, CategoryConfig, Group, PluginReport, Report } from '@code-pushup/models';
 export type ScoredCategoryConfig = CategoryConfig & {
     score: number;
 };

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

@@ -1,32 +1,38 @@
-import { AuditReport, CategoryRef, IssueSeverity as CliIssueSeverity, Format, Group, Issue, PersistConfig, Report } from '@code-pushup/models';
-import { ScoredReport, SortableAuditReport, SortableGroup } from './types';
+import { type Ansis } from 'ansis';
+import { type InlineText } from 'build-md';
+import type { AuditDiff, AuditReport, CategoryRef, IssueSeverity as CliIssueSeverity, Issue } from '@code-pushup/models';
+import type { ScoredReport, SortableAuditReport, SortableGroup } from './types';
 export declare function formatReportScore(score: number): string;
 export declare function formatScoreWithColor(score: number, options?: {
     skipBold?: boolean;
-}): string;
+}): InlineText;
 export type MarkerShape = 'circle' | 'square';
 export type ScoreColors = 'red' | 'yellow' | 'green';
 export declare const MARKERS: Record<MarkerShape, Record<ScoreColors, string>>;
 export declare function scoreMarker(score: number, markerType?: MarkerShape): string;
 export declare function getDiffMarker(diff: number): string;
-export declare function colorByScoreDiff(text: string, diff: number): string;
-export declare function shieldsBadge(text: string, color: string): string;
+export declare function colorByScoreDiff(text: string, diff: number): InlineText;
+export declare function shieldsBadge(text: string, color: string): InlineText;
 export declare function formatDiffNumber(diff: number): string;
 export declare function severityMarker(severity: 'info' | 'warning' | 'error'): string;
+export declare function formatScoreChange(diff: number): InlineText;
+export declare function formatValueChange({ values, scores, }: Pick<AuditDiff, 'values' | 'scores'>): InlineText;
 export declare function calcDuration(start: number, stop?: number): number;
 export declare function countWeightedRefs(refs: CategoryRef[]): number;
 export declare function countCategoryAudits(refs: CategoryRef[], plugins: ScoredReport['plugins']): number;
-export declare function getSortableAuditByRef({ slug, weight, plugin }: CategoryRef, plugins: ScoredReport['plugins']): SortableAuditReport;
-export declare function getSortableGroupByRef({ plugin, slug, weight }: CategoryRef, plugins: ScoredReport['plugins']): SortableGroup;
-export declare function getSortedGroupAudits(group: Group, plugin: string, plugins: ScoredReport['plugins']): SortableAuditReport[];
 export declare function compareCategoryAuditsAndGroups(a: SortableAuditReport | SortableGroup, b: SortableAuditReport | SortableGroup): number;
 export declare function compareAudits(a: AuditReport, b: AuditReport): number;
 export declare function compareIssueSeverity(severity1: CliIssueSeverity, severity2: CliIssueSeverity): number;
-type LoadedReportFormat<T extends Format> = T extends 'json' ? Report : string;
-export declare function loadReport<T extends Format>(options: Required<Omit<PersistConfig, 'format'>> & {
-    format: T;
-}): Promise<LoadedReportFormat<T>>;
 export declare function throwIsNotPresentError(itemName: string, presentPlace: string): never;
 export declare function getPluginNameFromSlug(slug: string, plugins: ScoredReport['plugins']): string;
 export declare function compareIssues(a: Issue, b: Issue): number;
-export {};
+export declare function applyScoreColor({ score, text }: {
+    score: number;
+    text?: string;
+}, style?: Ansis): string;
+export declare function targetScoreIcon(score: number, targetScore?: number, options?: {
+    passIcon?: string;
+    failIcon?: string;
+    prefix?: string;
+    postfix?: string;
+}): string;

package/src/lib/text-formats/constants.d.ts

@@ -1,3 +1,11 @@
 export declare const NEW_LINE = "\n";
 export declare const TAB = "  ";
 export declare const SPACE = " ";
+export declare const HIERARCHY: {
+    readonly level_1: 1;
+    readonly level_2: 2;
+    readonly level_3: 3;
+    readonly level_4: 4;
+    readonly level_5: 5;
+    readonly level_6: 6;
+};

package/src/lib/text-formats/html/table.d.ts

@@ -1,2 +1,2 @@
-import { Table } from '@code-pushup/models';
+import type { Table } from '@code-pushup/models';
 export declare function table(tableData: Table): string;

package/src/lib/text-formats/index.d.ts

@@ -1,44 +1,13 @@
 import { details } from './html/details';
-import { bold as boldHtml, code as codeHtml, italic as italicHtml } from './html/font-style';
-import { link as linkHtml } from './html/link';
-import { table as tableHtml } from './html/table';
-import { bold as boldMd, code as codeMd, italic as italicMd, strikeThrough as strikeThroughMd } from './md/font-style';
-import { h, h1, h2, h3, h4, h5, h6, headline } from './md/headline';
-import { image } from './md/image';
-import { link as linkMd } from './md/link';
-import { indentation, li } from './md/list';
-import { paragraphs } from './md/paragraphs';
-import { lines, section } from './md/section';
-import { table as tableMd } from './md/table';
-export { NEW_LINE, SPACE, TAB } from './constants';
-export { Hierarchy } from './types';
-export declare const md: {
-    bold: typeof boldMd;
-    italic: typeof italicMd;
-    strikeThrough: typeof strikeThroughMd;
-    code: typeof codeMd;
-    link: typeof linkMd;
-    image: typeof image;
-    headline: typeof headline;
-    h: typeof h;
-    h1: typeof h1;
-    h2: typeof h2;
-    h3: typeof h3;
-    h4: typeof h4;
-    h5: typeof h5;
-    h6: typeof h6;
-    indentation: typeof indentation;
-    lines: typeof lines;
-    li: typeof li;
-    section: typeof section;
-    paragraphs: typeof paragraphs;
-    table: typeof tableMd;
-};
+import { bold, code, italic } from './html/font-style';
+import { link } from './html/link';
+import { table } from './html/table';
+export { NEW_LINE, SPACE, TAB, HIERARCHY } from './constants';
 export declare const html: {
-    bold: typeof boldHtml;
-    italic: typeof italicHtml;
-    code: typeof codeHtml;
-    link: typeof linkHtml;
+    bold: typeof bold;
+    italic: typeof italic;
+    code: typeof code;
+    link: typeof link;
     details: typeof details;
-    table: typeof tableHtml;
+    table: typeof table;
 };

package/src/lib/text-formats/table.d.ts

@@ -1,4 +1,4 @@
-import { Table, TableAlignment, TableColumnObject, TableColumnPrimitive } from '@code-pushup/models';
+import type { Table, TableAlignment, TableColumnObject, TableColumnPrimitive } from '@code-pushup/models';
 export declare function rowToStringArray({ rows, columns }: Table): string[][];
 export declare function columnsToStringArray({ rows, columns, }: Pick<Table, 'columns' | 'rows'>): string[];
 export declare function getColumnAlignmentForKeyAndIndex(targetKey: string, targetIdx: number, columns?: TableColumnObject[]): TableAlignment;

package/src/lib/transform.d.ts

@@ -28,7 +28,6 @@ export declare function toUnixNewlines(text: string): string;
 export declare function fromJsonLines<T = unknown>(jsonLines: string): T;
 export declare function toJsonLines<T>(json: T[]): string;
 export declare function capitalize<T extends string>(text: T): Capitalize<T>;
-export declare function apostrophize(text: string, upperCase?: boolean): string;
 export declare function toNumberPrecision(value: number, decimalPlaces: number): number;
 export declare function toOrdinal(value: number): string;
 export {};

package/src/lib/types.d.ts

@@ -1,3 +1,12 @@
 export type ExcludeNullFromPropertyTypes<T> = {
     [P in keyof T]: Exclude<T[P], null>;
 };
+export type ItemOrArray<T> = T | T[];
+export type ExtractArray<T> = T extends Array<unknown> ? T : never;
+export type ExtractArrays<T extends Record<string, unknown>> = {
+    [K in keyof T]: ExtractArray<T[K]>;
+};
+export type WithRequired<T, K extends keyof T> = Prettify<Omit<T, K> & Required<Pick<T, K>>>;
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+};

package/src/lib/text-formats/md/font-style.d.ts

@@ -1,4 +0,0 @@
-export declare function bold(text: string): string;
-export declare function italic(text: string): string;
-export declare function strikeThrough(text: string): string;
-export declare function code(text: string): string;

package/src/lib/text-formats/md/headline.d.ts

@@ -1,14 +0,0 @@
-import { Hierarchy } from '../types';
-/**
- * \# {text} // hierarchy set to 1
- *
- * \## {text} // hierarchy set to 2
- */
-export declare function headline(text: string, hierarchy?: Hierarchy): string;
-export declare function h(text: string, hierarchy?: Hierarchy): string;
-export declare function h1(text: string): string;
-export declare function h2(text: string): string;
-export declare function h3(text: string): string;
-export declare function h4(text: string): string;
-export declare function h5(text: string): string;
-export declare function h6(text: string): string;

package/src/lib/text-formats/md/image.d.ts

@@ -1 +0,0 @@
-export declare function image(src: string, alt: string): string;

package/src/lib/text-formats/md/link.d.ts

@@ -1 +0,0 @@
-export declare function link(href: string, text?: string): string;

package/src/lib/text-formats/md/list.d.ts

@@ -1,7 +0,0 @@
-export type Order = 'unordered' | 'checkbox';
-/**
- * - {text}
- */
-export declare function li(text: string, order?: Order): string;
-export type Indentations = 1 | 2 | 3;
-export declare function indentation(text: string, level?: Indentations): string;

package/src/lib/text-formats/md/paragraphs.d.ts

@@ -1 +0,0 @@
-export declare function paragraphs(...sections: (string | undefined | boolean)[]): string;

package/src/lib/text-formats/md/section.d.ts

@@ -1,2 +0,0 @@
-export declare function section(...contents: (string | undefined | boolean)[]): string;
-export declare function lines(...contents: (string | undefined | boolean | number)[]): string;

package/src/lib/text-formats/md/table.d.ts

@@ -1,9 +0,0 @@
-import { Table } from '@code-pushup/models';
-/**
- * | Table Header 1  | Table Header 2 |
- * | :-------------- | -------------: |
- * |  String 1       |  1             |
- * |  String 1       |  2             |
- * |  String 1       |  3             |
- */
-export declare function table(data: Table): string;

package/src/lib/text-formats/types.d.ts

@@ -1 +0,0 @@
-export type Hierarchy = 1 | 2 | 3 | 4 | 5 | 6;