fluid_cli 0.1.2

data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_stack.rb

@@ -0,0 +1,67 @@
+# typed: true
+# frozen_string_literal: true
+
+module CLI
+  module UI
+    module Frame
+      module FrameStack
+        class StackItem
+          #: CLI::UI::Color
+          attr_reader :color
+
+          #: CLI::UI::Frame::FrameStyle
+          attr_reader :frame_style
+
+          #: (CLI::UI::colorable color_name, frame_stylable style_name) -> void
+          def initialize(color_name, style_name)
+            @color = CLI::UI.resolve_color(color_name)
+            @frame_style = CLI::UI.resolve_style(style_name)
+          end
+        end
+
+        class << self
+          # Fetch all items off the frame stack
+          #: -> Array[StackItem]
+          def items
+            Thread.current[:cliui_frame_stack] ||= []
+          end
+
+          # Push a new item onto the frame stack.
+          #
+          # Either an item or a :color/:style pair should be pushed onto the stack.
+          #
+          # ==== Attributes
+          #
+          # * +item+ a +StackItem+ to push onto the stack. Defaults to nil
+          #
+          # ==== Options
+          #
+          # * +:color+ the color of the new stack item. Defaults to nil
+          # * +:style+ the style of the new stack item. Defaults to nil
+          #
+          # ==== Raises
+          #
+          # If both an item and a color/style pair are given, raises an +ArgumentError+
+          # If the given item is not a +StackItem+, raises an +ArgumentError+
+          #
+          #: (?StackItem? item, ?color: CLI::UI::Color?, ?style: CLI::UI::Frame::FrameStyle?) -> void
+          def push(item = nil, color: nil, style: nil)
+            if color.nil? != style.nil? || item.nil? == color.nil?
+              raise ArgumentError, 'Must give one of item or color: and style:'
+            end
+
+            c = color #: as !nil
+            s = style #: as !nil
+            items.push(item || StackItem.new(c, s))
+          end
+
+          # Removes and returns the last stack item off the stack
+          #: -> StackItem?
+          def pop
+            items.pop
+          end
+        end
+      end
+    end
+  end
+end

data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_style/box.rb

@@ -0,0 +1,179 @@
+# typed: true
+# frozen_string_literal: true
+
+module CLI
+  module UI
+    module Frame
+      module FrameStyle
+        module Box
+          extend FrameStyle
+
+          VERTICAL    = '┃'
+          HORIZONTAL  = '━'
+          DIVIDER     = '┣'
+          TOP_LEFT    = '┏'
+          BOTTOM_LEFT = '┗'
+
+          class << self
+            # @override
+            #: -> Symbol
+            def style_name
+              :box
+            end
+
+            # @override
+            #: -> String
+            def prefix
+              VERTICAL
+            end
+
+            # Draws the "Open" line for this frame style
+            #
+            # ==== Attributes
+            #
+            # * +text+ - (required) the text/title to output in the frame
+            #
+            # ==== Options
+            #
+            # * +:color+ - (required) The color of the frame.
+            #
+            # ==== Output:
+            #
+            #   ┏━━ Open ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+            #
+            # @override
+            #: (String text, color: CLI::UI::Color) -> String
+            def start(text, color:)
+              edge(text, color: color, first: TOP_LEFT)
+            end
+
+            # Draws a "divider" line for the current frame style
+            #
+            # ==== Attributes
+            #
+            # * +text+ - (required) the text/title to output in the frame
+            #
+            # ==== Options
+            #
+            # * +:color+ - (required) The color of the frame.
+            #
+            # ==== Output:
+            #
+            #   ┣━━ Divider ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+            #
+            # @override
+            #: (String text, color: CLI::UI::Color) -> String
+            def divider(text, color:)
+              edge(text, color: color, first: DIVIDER)
+            end
+
+            # Draws the "Close" line for this frame style
+            #
+            # ==== Attributes
+            #
+            # * +text+ - (required) the text/title to output in the frame
+            #
+            # ==== Options
+            #
+            # * +:color+ - (required) The color of the frame.
+            # * +:right_text+ - Text to print at the right of the line. Defaults to nil
+            #
+            # ==== Output:
+            #
+            #   ┗━━ Close ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+            #
+            # @override
+            #: (String text, color: CLI::UI::Color, ?right_text: String?) -> String
+            def close(text, color:, right_text: nil)
+              edge(text, color: color, right_text: right_text, first: BOTTOM_LEFT)
+            end
+
+            private
+
+            #: (String text, color: CLI::UI::Color, first: String, ?right_text: String?) -> String
+            def edge(text, color:, first:, right_text: nil)
+              color = CLI::UI.resolve_color(color)
+
+              preamble = +''
+
+              preamble << color.code if CLI::UI.enable_color?
+              preamble << first << (HORIZONTAL * 2)
+
+              unless text.empty?
+                preamble << ' ' << CLI::UI.resolve_text("{{#{color.name}:#{text}}}") << ' '
+              end
+
+              termwidth = CLI::UI::Terminal.width
+
+              suffix = +''
+
+              if right_text
+                suffix << ' ' << right_text << ' '
+              end
+
+              preamble_width = CLI::UI::ANSI.printing_width(preamble)
+              preamble_start = Frame.prefix_width
+              # If prefix_width is non-zero, we need to subtract the width of
+              # the final space, since we're going to write over it.
+              preamble_start -= 1 if preamble_start.nonzero?
+              preamble_end = preamble_start + preamble_width
+
+              suffix_width = CLI::UI::ANSI.printing_width(suffix)
+              suffix_end   = termwidth - 2
+              suffix_start = suffix_end - suffix_width
+
+              if preamble_end > suffix_start
+                suffix = ''
+                # if preamble_end > termwidth
+                # we *could* truncate it, but let's just let it overflow to the
+                # next line and call it poor usage of this API.
+              end
+
+              o = +''
+
+              unless CLI::UI.enable_cursor?
+                linewidth = [0, termwidth - (preamble_end + suffix_width + 1)].max
+
+                o << color.code if CLI::UI.enable_color?
+                o << preamble
+                o << color.code if CLI::UI.enable_color?
+                o << (HORIZONTAL * linewidth)
+                o << color.code if CLI::UI.enable_color?
+                o << suffix
+                o << CLI::UI::Color::RESET.code if CLI::UI.enable_color?
+                o << "\n"
+                return o
+              end
+
+              # Jumping around the line can cause some unwanted flashes
+              o << CLI::UI::ANSI.hide_cursor
+
+              # reset to column 1 so that things like ^C don't ruin formatting
+              o << "\r"
+
+              # This code will print out a full line with the given preamble and
+              # suffix, as exemplified below.
+              #
+              # preamble_start                         suffix_start
+              # |                 preamble_end         |            suffix_end
+              # |                 |                    |            | termwidth
+              # |                 |                    |            | |
+              # V                 V                    V            V V
+              # --- Preamble text --------------------- suffix text --
+              o << color.code if CLI::UI.enable_color?
+              o << print_at_x(preamble_start, HORIZONTAL * (termwidth - preamble_start)) # draw a full line
+              o << print_at_x(preamble_start, preamble)
+              o << color.code if CLI::UI.enable_color?
+              o << print_at_x(suffix_start, suffix)
+              o << CLI::UI::Color::RESET.code if CLI::UI.enable_color?
+              o << CLI::UI::ANSI.show_cursor
+              o << "\n"
+
+              o
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_style/bracket.rb

@@ -0,0 +1,152 @@
+# typed: true
+# frozen_string_literal: true
+
+module CLI
+  module UI
+    module Frame
+      module FrameStyle
+        module Bracket
+          extend FrameStyle
+
+          VERTICAL    = '┃'
+          HORIZONTAL  = '━'
+          DIVIDER     = '┣'
+          TOP_LEFT    = '┏'
+          BOTTOM_LEFT = '┗'
+
+          class << self
+            # @override
+            #: -> Symbol
+            def style_name
+              :bracket
+            end
+
+            # @override
+            #: -> String
+            def prefix
+              VERTICAL
+            end
+
+            # Draws the "Open" line for this frame style
+            #
+            # ==== Attributes
+            #
+            # * +text+ - (required) the text/title to output in the frame
+            #
+            # ==== Options
+            #
+            # * +:color+ - (required) The color of the frame.
+            #
+            # ==== Output
+            #
+            #   ┏━━ Open
+            #
+            # @override
+            #: (String text, color: CLI::UI::Color) -> String
+            def start(text, color:)
+              edge(text, color: color, first: TOP_LEFT)
+            end
+
+            # Draws a "divider" line for the current frame style
+            #
+            # ==== Attributes
+            #
+            # * +text+ - (required) the text/title to output in the frame
+            #
+            # ==== Options
+            #
+            # * +:color+ - (required) The color of the frame.
+            #
+            # ==== Output:
+            #
+            #   ┣━━ Divider
+            #
+            # @override
+            #: (String text, color: CLI::UI::Color) -> String
+            def divider(text, color:)
+              edge(text, color: color, first: DIVIDER)
+            end
+
+            # Draws the "Close" line for this frame style
+            #
+            # ==== Attributes
+            #
+            # * +text+ - (required) the text/title to output in the frame
+            #
+            # ==== Options
+            #
+            # * +:color+ - (required) The color of the frame.
+            # * +:right_text+ - Text to print at the right of the line. Defaults to nil
+            #
+            # ==== Output:
+            #
+            #   ┗━━ Close
+            #
+            # @override
+            #: (String text, color: CLI::UI::Color, ?right_text: String?) -> String
+            def close(text, color:, right_text: nil)
+              edge(text, color: color, right_text: right_text, first: BOTTOM_LEFT)
+            end
+
+            private
+
+            #: (String text, color: CLI::UI::Color, first: String, ?right_text: String?) -> String
+            def edge(text, color:, first:, right_text: nil)
+              color = CLI::UI.resolve_color(color)
+
+              preamble = +''
+
+              preamble << color.code if CLI::UI.enable_color?
+              preamble << first << (HORIZONTAL * 2)
+
+              unless text.empty?
+                preamble << ' ' << CLI::UI.resolve_text("{{#{color.name}:#{text}}}") << ' '
+              end
+
+              suffix = +''
+
+              if right_text
+                suffix << ' ' << right_text << ' '
+              end
+
+              o = +''
+
+              unless CLI::UI.enable_cursor?
+                o << color.code if CLI::UI.enable_color?
+                o << preamble
+                o << color.code if CLI::UI.enable_color?
+                o << suffix
+                o << CLI::UI::Color::RESET.code if CLI::UI.enable_color?
+                o << "\n"
+
+                return o
+              end
+
+              preamble_start = Frame.prefix_width
+
+              # If prefix_width is non-zero, we need to subtract the width of
+              # the final space, since we're going to write over it.
+              preamble_start -= 1 if preamble_start.nonzero?
+
+              # Jumping around the line can cause some unwanted flashes
+              o << CLI::UI::ANSI.hide_cursor
+
+              # reset to column 1 so that things like ^C don't ruin formatting
+              o << "\r"
+
+              o << color.code if CLI::UI.enable_color?
+              o << print_at_x(preamble_start, preamble)
+              o << color.code if CLI::UI.enable_color?
+              o << suffix
+              o << CLI::UI::Color::RESET.code if CLI::UI.enable_color?
+              o << CLI::UI::ANSI.show_cursor
+              o << "\n"
+
+              o
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_style.rb

@@ -0,0 +1,127 @@
+# typed: true
+# frozen_string_literal: true
+
+require 'cli/ui/frame'
+
+module CLI
+  module UI
+    module Frame
+      # @abstract
+      module FrameStyle
+        include Kernel
+
+        autoload(:Box, 'cli/ui/frame/frame_style/box')
+        autoload(:Bracket, 'cli/ui/frame/frame_style/bracket')
+
+        MAP = {
+          box: -> { FrameStyle::Box },
+          bracket: -> { FrameStyle::Bracket },
+        }
+
+        class << self
+          # Lookup a frame style via its name
+          #
+          # ==== Attributes
+          #
+          # * +symbol+ - frame style name to lookup
+          #: ((String | Symbol) name) -> FrameStyle
+          def lookup(name)
+            MAP.fetch(name.to_sym).call
+          rescue KeyError
+            raise(InvalidFrameStyleName, name)
+          end
+        end
+
+        # @abstract
+        #: -> Symbol
+        def style_name
+          raise(NotImplementedError)
+        end
+
+        # Returns the character(s) that should be printed at the beginning
+        # of lines inside this frame
+        # @abstract
+        #: -> String
+        def prefix
+          raise(NotImplementedError)
+        end
+
+        # Returns the printing width of the prefix
+        #: -> Integer
+        def prefix_width
+          CLI::UI::ANSI.printing_width(prefix)
+        end
+
+        # Draws the "Open" line for this frame style
+        #
+        # ==== Attributes
+        #
+        # * +text+ - (required) the text/title to output in the frame
+        #
+        # ==== Options
+        #
+        # * +:color+ - (required) The color of the frame.
+        #
+        # @abstract
+        #: (String, color: CLI::UI::Color) -> String
+        def start(text, color:)
+          raise(NotImplementedError)
+        end
+
+        # Draws the "Close" line for this frame style
+        #
+        # ==== Attributes
+        #
+        # * +text+ - (required) the text/title to output in the frame
+        #
+        # ==== Options
+        #
+        # * +:color+ - (required) The color of the frame.
+        # * +:right_text+ - Text to print at the right of the line. Defaults to nil
+        #
+        # @abstract
+        #: (String, color: CLI::UI::Color, ?right_text: String?) -> String
+        def close(text, color:, right_text: nil)
+          raise(NotImplementedError)
+        end
+
+        # Draws a "divider" line for the current frame style
+        #
+        # ==== Attributes
+        #
+        # * +text+ - (required) the text/title to output in the frame
+        #
+        # ==== Options
+        #
+        # * +:color+ - (required) The color of the frame.
+        #
+        # @abstract
+        #: (String, color: CLI::UI::Color) -> String
+        def divider(text, color:)
+          raise(NotImplementedError)
+        end
+
+        #: (Integer x, String str) -> String
+        def print_at_x(x, str)
+          CLI::UI::ANSI.cursor_horizontal_absolute(1 + x) + str
+        end
+
+        class InvalidFrameStyleName < ArgumentError
+          #: ((String | Symbol) name) -> void
+          def initialize(name)
+            super
+            @name = name
+          end
+
+          #: -> String
+          def message
+            keys = FrameStyle::MAP.keys.map(&:inspect).join(', ')
+            "invalid frame style: #{@name.inspect} " \
+              '-- must be one of CLI::UI::Frame::FrameStyle::MAP ' \
+              "(#{keys})"
+          end
+        end
+      end
+    end
+  end
+end