refactor(utils): move and rename ansis link utility

Author: matejchalk

packages/cli/src/lib/collect/collect-command.ts

@@ -4,7 +4,7 @@ import {
   type CollectAndPersistReportsOptions,
   collectAndPersistReports,
 } from '@code-pushup/core';
-import { link, logger, ui } from '@code-pushup/utils';
+import { formatAsciiLink, logger, ui } from '@code-pushup/utils';
 import { CLI_NAME } from '../constants.js';
 import {
   collectSuccessfulLog,
@@ -51,15 +51,15 @@ export function renderUploadAutorunHint(): void {
       )}`,
     )
     .add(
-      `  ${link(
+      `  ${formatAsciiLink(
         'https://github.com/code-pushup/cli/tree/main/packages/cli#upload-command',
       )}`,
     )
     .add(
       `${ansis.gray('❯')} npx code-pushup autorun - ${ansis.gray('Run collect & upload')}`,
     )
     .add(
-      `  ${link(
+      `  ${formatAsciiLink(
         'https://github.com/code-pushup/cli/tree/main/packages/cli#autorun-command',
       )}`,
     )

packages/cli/src/lib/implementation/logging.ts

@@ -1,17 +1,17 @@
 import ansis from 'ansis';
-import { link, logger, ui } from '@code-pushup/utils';
+import { formatAsciiLink, logger, ui } from '@code-pushup/utils';
 
 export function renderConfigureCategoriesHint(): void {
   logger.debug(
-    `💡 Configure categories to see the scores in an overview table. See: ${link(
+    `💡 Configure categories to see the scores in an overview table. See: ${formatAsciiLink(
       'https://github.com/code-pushup/cli/blob/main/packages/cli/README.md',
     )}`,
     { force: true },
   );
 }
 export function uploadSuccessfulLog(url: string): void {
   logger.info(ansis.green('Upload successful!'));
-  logger.info(link(url));
+  logger.info(formatAsciiLink(url));
 }
 
 export function collectSuccessfulLog(): void {
@@ -30,17 +30,17 @@ export function renderIntegratePortalHint(): void {
       )}`,
     )
     .add(
-      `  ${link(
+      `  ${formatAsciiLink(
         'https://github.com/code-pushup/cli/tree/main/packages/cli#upload-command',
       )}`,
     )
     .add(
-      `${ansis.gray('❯')} ${ansis.gray('Portal Integration')} - ${link(
+      `${ansis.gray('❯')} ${ansis.gray('Portal Integration')} - ${formatAsciiLink(
         'https://github.com/code-pushup/cli/blob/main/packages/cli/README.md#portal-integration',
       )}`,
     )
     .add(
-      `${ansis.gray('❯')} ${ansis.gray('Upload Command')} - ${link(
+      `${ansis.gray('❯')} ${ansis.gray('Upload Command')} - ${formatAsciiLink(
         'https://github.com/code-pushup/cli/blob/main/packages/cli/README.md#portal-integration',
       )}`,
     )

packages/plugin-lighthouse/src/lib/runner/runner.ts

@@ -5,11 +5,10 @@ import type { AuditOutputs, RunnerFunction } from '@code-pushup/models';
 import {
   addIndex,
   ensureDirectoryExists,
-  link,
+  formatAsciiLink,
   logger,
   shouldExpandForUrls,
   stringifyError,
-  ui,
 } from '@code-pushup/utils';
 import type { LighthouseOptions } from '../types.js';
 import { DEFAULT_CLI_FLAGS } from './constants.js';
@@ -82,7 +81,7 @@ async function runLighthouseForUrl(
 
   if (runnerResult == null) {
     throw new Error(
-      `Lighthouse did not produce a result for URL: ${link(url)}`,
+      `Lighthouse did not produce a result for URL: ${formatAsciiLink(url)}`,
     );
   }
 

packages/utils/src/index.ts

@@ -88,7 +88,7 @@ export {
 export { interpolate } from './lib/interpolate.js';
 export { logMultipleResults } from './lib/log-results.js';
 export { Logger, logger } from './lib/logger.js';
-export { link, ui, type CliUi } from './lib/logging.js';
+export { ui, type CliUi } from './lib/logging.js';
 export { mergeConfigs } from './lib/merge-configs.js';
 export {
   addIndex,
@@ -144,6 +144,9 @@ export {
   formatReportScore,
 } from './lib/reports/utils.js';
 export { isSemver, normalizeSemver, sortSemvers } from './lib/semver.js';
+export { formatAsciiLink } from './lib/text-formats/ascii/link.js';
+export { formatAsciiTable } from './lib/text-formats/ascii/table.js';
+export { formatAsciiTree } from './lib/text-formats/ascii/tree.js';
 export * from './lib/text-formats/index.js';
 export {
   countOccurrences,

packages/utils/src/lib/logging.ts

@@ -1,5 +1,4 @@
 import { cliui } from '@poppinss/cliui';
-import ansis from 'ansis';
 
 // TODO: remove once logger is used everywhere
 
@@ -12,7 +11,3 @@ export function ui(): CliUi {
   cliUISingleton ??= cliui();
   return cliUISingleton;
 }
-
-export function link(text: string) {
-  return ansis.underline.blueBright(text);
-}

packages/utils/src/lib/text-formats/ascii/link.ts

@@ -0,0 +1,5 @@
+import ansis from 'ansis';
+
+export function formatAsciiLink(url: string): string {
+  return ansis.underline.blueBright(url);
+}