@technobuddha/library/src/single-line.ts

A large library of useful functions

import { empty, space } from './unicode.ts';
import { zipperMerge } from './zipper-merge.ts';

/**
 * Joins a template literal into a single line string by removing line breaks and leading whitespace,
 * then interleaving the provided arguments. The result is a trimmed, single-line string.
 * @param template - The template strings array from a tagged template literal.
 * @param args - The values to be interpolated into the template.
 * @returns A single-line string with all line breaks and leading whitespace removed.
 * @group String
 * @category Operations
 */
export function singleLine(template: TemplateStringsArray, ...args: unknown[]): string {
  return zipperMerge(
    template.map((t) => t.replaceAll(/[\r\n]+\s*/gu, space)),
    args,
  )
    .flat()
    .join(empty)
    .trim();
}