Compass/web/lib/util/string-or-string-array-to-text.ts

import { filterDefined } from 'common/util/array'

export default function stringOrStringArrayToText(fields: {
  text: string[] | string | null | undefined
  preText?: string
  postText?: string
  asSentence?: boolean
  capitalizeFirstLetterOption?: boolean
}): string | null {
  const {
    text,
    preText = '',
    postText = '',
    asSentence,
    capitalizeFirstLetterOption,
  } = fields

  if (!text || text.length < 1) {
    return null
  }

  const formatText = capitalizeFirstLetterOption
    ? (text: string) => text.charAt(0).toUpperCase() + text.slice(1)
    : (text: string) => text

  if (Array.isArray(text)) {
    let formattedText = ''

    if (asSentence) {
      formattedText =
        text.slice(0, -1).map(formatText).join(', ') +
        (text.length > 1 ? ' and ' : '') +
        formatText(text[text.length - 1])
    } else {
      formattedText = filterDefined(text).map(formatText).join(' • ')
    }

    return `${preText} ${formattedText} ${postText}`.trim()
  }

  return `${preText} ${formatText(text)} ${postText}`.trim()
}