/**
 * Crops a string to a specified length and appends and appends an ellipsis
 * (configurable, but defaults to `" …"`).
 *
 * It is clever enough to only crop at word boundries, and accounts for the
 * length of the added ellipsis before deciding to crop.
 *
 * The input string is trimmed and all types of whitespace is collapsed to
 * a single, normal space.
 */
export default function cropText(str: string, length: number, ellipsis?: string): string;