docs: function truncate(str, options) {
    options = assign({
      length: 24,
      omission: '...'
    }, options);
  
    if (GraphemeBreaker.countBreaks(str) <= options.length) {
      return str;
    }
  
    var length = options.length - options.omission.length;
  
    if (length < 0) {
      length = 0;
    }
  
    return slice(str, 0, length) + options.omission;
  }