# frozen_string_literal: true require 'unicode/display_width' require 'unicode_utils/each_grapheme' require_relative 'ansi' require_relative 'fold' module Strings module Wrap DEFAULT_WIDTH = 80 NEWLINE = "\n".freeze SPACE = ' '.freeze LINE_BREAK = "\r\n+|\r+|\n+".freeze # Wrap a text into lines no longer than wrap_at length. # Preserves existing lines and existing word boundaries. # # @example # Strings::Wrap.wrap("Some longish text", 8) # # => >Some # >longish # >text # # @api public def wrap(text, wrap_at = DEFAULT_WIDTH) if text.length < wrap_at.to_i || wrap_at.to_i.zero? return text end ansi_stack = [] text.split(%r{#{LINE_BREAK}}, -1).map do |paragraph| format_paragraph(paragraph, wrap_at, ansi_stack) end * NEWLINE end module_function :wrap # Format paragraph to be maximum of wrap_at length # # @param [String] paragraph # the paragraph to format # @param [Integer] wrap_at # the maximum length to wrap the paragraph # # @return [Array[String]] # the wrapped lines # # @api private def format_paragraph(paragraph, wrap_at, ansi_stack) cleared_para = Fold.fold(paragraph) lines = [] line = [] word = [] ansi = [] ansi_matched = false word_length = 0 line_length = 0 char_length = 0 # visible char length text_length = display_width(cleared_para) total_length = 0 UnicodeUtils.each_grapheme(cleared_para) do |char| # we found ansi let's consume if char == Strings::ANSI::CSI || ansi.length > 0 ansi << char if Strings::ANSI.only_ansi?(ansi.join) ansi_matched = true elsif ansi_matched ansi_stack << [ansi[0...-1].join, line_length + word_length] ansi_matched = false ansi = [] end next if ansi.length > 0 end char_length = display_width(char) total_length += char_length if line_length + word_length + char_length <= wrap_at if char == SPACE || total_length == text_length line << word.join + char line_length += word_length + char_length word = [] word_length = 0 else word << char word_length += char_length end next end if char == SPACE # ends with space lines << insert_ansi(ansi_stack, line.join) line = [] line_length = 0 word << char word_length += char_length elsif word_length + char_length <= wrap_at lines << insert_ansi(ansi_stack, line.join) line = [word.join + char] line_length = word_length + char_length word = [] word_length = 0 else # hyphenate word - too long to fit a line lines << insert_ansi(ansi_stack, word.join) line_length = 0 word = [char] word_length = char_length end end lines << insert_ansi(ansi_stack, line.join) unless line.empty? lines << insert_ansi(ansi_stack, word.join) unless word.empty? lines end module_function :format_paragraph # Insert ANSI code into string # # Check if there are any ANSI states, if present # insert ANSI codes at given positions unwinding the stack. # # @param [Array[Array[String, Integer]]] ansi_stack # the ANSI codes to apply # # @param [String] string # the string to insert ANSI codes into # # @return [String] # # @api private def insert_ansi(ansi_stack, string) return string if ansi_stack.empty? to_remove = 0 reset_index = -1 output = string.dup resetting = false ansi_stack.reverse_each do |state| if state[0] =~ /#{Regexp.quote(Strings::ANSI::RESET)}/ resetting = true reset_index = state[1] to_remove += 2 next elsif !resetting reset_index = -1 resetting = false end color, color_index = *state output.insert(reset_index, Strings::ANSI::RESET).insert(color_index, color) end ansi_stack.pop(to_remove) # remove used states output end module_function :insert_ansi # Visible width of a string # # @api private def display_width(string) Unicode::DisplayWidth.of(Strings::ANSI.sanitize(string)) end module_function :display_width end # Wrap end # Strings