matches.ts

export type NormalizerFn = (textToNormalize: string) => string;

export type TextMatch = string | RegExp;
export type TextMatchOptions = {
  exact?: boolean;
  normalizer?: NormalizerFn;
};

export function matches(
  matcher: TextMatch,
  text: string | undefined,
  normalizer: NormalizerFn = getDefaultNormalizer(),
  exact: boolean = true,
): boolean {
  if (typeof text !== 'string') {
    return false;
  }

  const normalizedText = normalizer(text);
  if (typeof matcher === 'string') {
    const normalizedMatcher = normalizer(matcher);
    return exact
      ? normalizedText === normalizedMatcher
      : normalizedText.toLowerCase().includes(normalizedMatcher.toLowerCase());
  } else {
    // Reset state for global regexes: https://stackoverflow.com/a/1520839/484499
    matcher.lastIndex = 0;
    return matcher.test(normalizedText);
  }
}

type NormalizerConfig = {
  trim?: boolean;
  collapseWhitespace?: boolean;
};

export function getDefaultNormalizer({
  trim = true,
  collapseWhitespace = true,
}: NormalizerConfig = {}): NormalizerFn {
  return (text: string) => {
    let normalizedText = text;
    normalizedText = trim ? normalizedText.trim() : normalizedText;
    normalizedText = collapseWhitespace ? normalizedText.replace(/\s+/g, ' ') : normalizedText;
    return normalizedText;
  };
}