libui_paradise 0.2.49 → 0.4.13

data/lib/libui_paradise/libui_classes/libui_classes.rb

@@ -2,1610 +2,24 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# require 'libui_paradise/libui_classes/libui_classes.rb
+# require 'libui_paradise/libui_classes/libui_classes.rb'
 # =========================================================================== #
 module LibuiParadise
 
-module Extensions # === LibuiParadise::Extensions
-
-  require 'libui_paradise/libui_classes/box.rb'
-  require 'libui_paradise/libui_classes/grid.rb'
-
-  # ========================================================================= #
-  # === button                                                   (button tag)
-  #
-  # This method will create a libui-button.
-  # ========================================================================= #
-  def button(
-      text = ''
-    )
-    text = text.to_s.dup
-    if text.start_with? '_'
-      text[0,1] = '' # Right now we do not support accelerators.
-    end
-    ::LibuiParadise::Extensions.button(text)
-  end; alias ui_button button # === ui_button
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.msg_box
-  #
-  # Official API documentation for dialogs in libui can be found here:
-  #
-  #   https://github.com/andlabs/libui/blob/master/unix/stddialogs.c
-  #
-  # For libui-ng it can be found here:
-  #
-  #   https://github.com/libui-ng/libui-ng/blob/master/unix/stddialogs.c
-  #
-  # The API signature for msgbox in Libui is as follows:
-  #
-  #   GtkWindow *parent
-  #   const char *title
-  #   const char *description
-  #   GtkMessageType type
-  #   GtkButtonsType buttons
-  #
-  # So the first string is the title and the second string is the
-  # description that will be shown to the user.
-  #
-  # The following method is a convenience-wrapper over UI.msg_box().
-  #
-  # A Hash can also be passed into this method, to allow for more
-  # flexibility. The following line of code will demonstrate how
-  # this can then be used, via a Hash:
-  #
-  #   message_box(
-  #      text: 'Hello world!'
-  #   )
-  #
-  # Or more verbose:
-  #
-  #   LibuiParadise::Extensions.message_box(text: 'Hello world!')
-  #
-  # ========================================================================= #
-  def self.msg_box(
-      main_window        = :default_window,
-      title_to_use       = '',
-      description_to_use = ''
-    )
-    # ======================================================================= #
-    # === Handle Hashes first
-    # ======================================================================= #
-    if main_window.is_a? Hash
-      # ===================================================================== #
-      # === :text
-      # ===================================================================== #
-      if main_window.has_key? :text
-        description_to_use = main_window.delete(:text)
-      end
-      # ===================================================================== #
-      # === :title_to_use
-      # ===================================================================== #
-      if main_window.has_key? :title_to_use
-        title_to_use = main_window.delete(:title_to_use)
-      end
-      if main_window and main_window.empty? # Handle empty Hashes as well here.
-        main_window = :default_window
-      end
-    end
-    case main_window
-    # ======================================================================= #
-    # === :default_window
-    # ======================================================================= #
-    when :default_window,
-         :default
-      main_window = ::LibuiParadise.main_window?
-    end
-    _ = ::LibUI.msg_box(
-      main_window,
-      title_to_use,
-      description_to_use
-    )
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_msg_box             msg_box } # === LibuiParadise::Extensions.ui_msg_box
-       self.instance_eval { alias message_to_the_user    msg_box } # === LibuiParadise::Extensions.message_to_the_user
-       self.instance_eval { alias message_box            msg_box } # === LibuiParadise::Extensions.message_box
-       self.instance_eval { alias popup_over_this_widget msg_box } # === LibuiParadise::Extensions.popup_over_this_widget
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.message_box_error
-  # ========================================================================= #
-  def self.message_box_error(
-      main_window  = LibuiParadise.main_window?,
-      title_to_use = '',
-      whatever     = ''
-    )
-    case main_window
-    # ======================================================================= #
-    # === :default
-    # ======================================================================= #
-    when :default
-      main_window = LibuiParadise.main_window?
-    end
-    _ = ::LibUI.msg_box_error(
-      main_window,
-      title_to_use,
-      whatever
-    )
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_msg_box_error          message_box_error } # === LibuiParadise::Extensions.ui_msg_box_error
-       self.instance_eval { alias ui_error_msg              message_box_error } # === LibuiParadise::Extensions.ui_error_msg
-       self.instance_eval { alias ui_error_message          message_box_error } # === LibuiParadise::Extensions.ui_error_message
-       self.instance_eval { alias error_message_to_the_user message_box_error } # === LibuiParadise::Extensions.error_message_to_the_user
-       self.instance_eval { alias error_msg                 message_box_error } # === LibuiParadise::Extensions.error_msg
-
-  # ========================================================================= #
-  # === message_box_error
-  # ========================================================================= #
-  def message_box_error(
-      main_window  = LibuiParadise.main_window?,
-      title_to_use = '',
-      whatever     = ''
-    )
-    return ::LibuiParadise::Extensions.message_box_error(
-      main_window,
-      title_to_use,
-      whatever
-    )
-  end; alias ui_msg_box_error          message_box_error # === ui_msg_box_error
-       alias ui_error_message          message_box_error # === ui_error_message
-       alias ui_error_msg              message_box_error # === ui_error_msg
-       alias error_message_to_the_user message_box_error # === error_message_to_the_user
-
-  # ========================================================================= #
-  # === error_msg
-  # ========================================================================= #
-  def error_msg(text)
-    message_box_error(:default, text)
-  end
-
-  # ========================================================================= #
-  # === ui_msg_box
-  #
-  # This method is a convenience-wrapper over UI.msg_box().
-  # ========================================================================= #
-  def ui_msg_box(
-      main_window  = :default_window,
-      title_to_use = '',
-      whatever     = ''
-    )
-    ::LibuiParadise::Extensions.msg_box(
-      main_window,
-      title_to_use,
-      whatever
-    )
-  end; alias message_to_the_user    ui_msg_box # === message_to_the_user
-       alias message_box            ui_msg_box # === message_box
-       alias popup_over_this_widget ui_msg_box # === popup_over_this_widget
-       alias popup_message          ui_msg_box # === popup_message
-       # alias msg_box                ui_msg_box # === msg_box
-       # ^^^ this would lead to an error.
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.wrapper_new_progress_bar
-  #
-  # The name of this method contains "wrapper_" because there already
-  # exists a method called LibUI.new_progress_bar().
-  #
-  # The upstream C API for the libui-progressbar can be found here:
-  #
-  #   https://github.com/andlabs/libui/blob/master/unix/progressbar.c
-  #
-  # ========================================================================= #
-  def self.wrapper_new_progress_bar
-    _ = ::LibUI.new_progress_bar
-    add_to_the_registered_widgets(_, :new_progress_bar)
-    return _
-  end
-
-  # ========================================================================= #
-  # === wrapper_new_progress_bar
-  # ========================================================================= #
-  def wrapper_new_progress_bar
-    return ::LibuiParadise::Extensions.wrapper_new_progress_bar
-  end; alias progress_bar wrapper_new_progress_bar # === progress_bar
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.open_file
-  #
-  # This method can be used to open a local file, via a button, the
-  # "open-file" button. Furthermore a begin/rescue clause is used to
-  # avoid "NULL pointer given" errors. At a later time we may
-  # have to fine-tune this, but for now this shall suffice.
-  # ========================================================================= #
-  def self.open_file(
-      main_window = ::LibuiParadise::Extensions.main_window?
-    )
-    begin
-      _ = ::LibUI.open_file(main_window)
-      add_to_the_registered_widgets(_, __method__)
-      return _
-    rescue ArgumentError => _error # Rescue #<ArgumentError: NULL pointer given> here.
-      # pp _error
-      return nil
-    end
-  end; self.instance_eval { alias ui_open_file open_file } # === LibuiParadise::Extensions.ui_open_file
-
-  # ========================================================================= #
-  # === ui_open_file
-  # ========================================================================= #
-  def ui_open_file(
-      main_window = ::LibuiParadise::Extensions.main_window?
-    )
-    return ::LibuiParadise::Extensions.open_file(main_window)
-  end
-
   # ========================================================================= #
-  # === open_file
-  #
-  # This here creates a problem, because ::Libui.open_file is already
-  # defined. We'd have to use an alias to make this work.
-  # ========================================================================= #
-  # def open_file(
-  #     main_window = LibuiParadise::Extensions.main_window?
-  #   )
-  #   return ::LibuiParadise::Extensions.open_file(main_window)
-  # end; alias ui_open_file open_file # === ui_open_file
-
-  # ========================================================================= #
-  # === @main_window
-  #
-  # This variable can be used to keep track of the main window in use.
-  # ========================================================================= #
-  @main_window = nil
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.main_window?
-  # ========================================================================= #
-  def self.main_window?
-    @main_window
-  end
-
-  # ========================================================================= #
-  # === main_window?
-  # ========================================================================= #
-  def main_window?
-    ::LibuiParadise::Extensions.main_window?
-  end
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.set_main_window
-  # ========================================================================= #
-  def self.set_main_window(i)
-    @main_window = i
-  end
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.window                         (window tag)
-  #
-  # This method will create a new main-window.
-  #
-  # It will also call UI.simple_exit(). This is done mostly so that we
-  # can omit that line whenever we use e. g. ui_main_window().
-  # ========================================================================= #
-  def self.window(
-      the_title   = '',  # Pick a title for the window here.
-      width       = 500, # width  in n pixels.
-      height      = 300, # height in n pixels.
-      has_menubar =   1, # hasMenubar or has not.
-      &block
-    )
-    case the_title
-    # ======================================================================= #
-    # === :filename
-    # ======================================================================= #
-    when :filename,
-         :file_name
-      # ===================================================================== #
-      # __FILE__ contains the desired name. We only need the raw name, though.
-      # Well, in 2022 it was realized that the real filename is stored in
-      # $PROGRAM_NAME, so ...
-      # ===================================================================== #
-      the_title = File.basename($PROGRAM_NAME) # (__FILE__)
-    end
-    raw_has_menubar = 0
-    if has_menubar.is_a? Numeric
-      raw_has_menubar = has_menubar
-    end
-    # ======================================================================= #
-    # Instantiate a new main-window next:
-    # ======================================================================= #
-    main_window = LibUI.new_window(
-      the_title,
-      width,
-      height,
-      raw_has_menubar
-    )
-    set_main_window(main_window) # Keep a reference stored here.
-    # ======================================================================= #
-    # Since as of 30.08.2021 we will also register the main-window.
-    #
-    # In the long run we may obsolete and deprecate @main_window, since
-    # it is no longer needed - but for now we will retain that variable.
-    # ======================================================================= #
-    add_to_the_registered_widgets(main_window, __method__)
-    if has_menubar and has_menubar.is_a?(Hash)
-      if has_menubar.has_key? :margin
-        if has_menubar[:margin] == true
-          main_window.has_margin
-        end
-      end
-    end
-    ::LibUI.simple_exit(main_window)
-    if block_given?
-      yield
-    end
-    return main_window # Always return it here.
-  end; self.instance_eval { alias main_window     window } # === LibuiParadise::Extensions.main_window
-       self.instance_eval { alias ui_main_window  window } # === LibuiParadise::Extensions.ui_main_window
-       self.instance_eval { alias margined_window window } # === LibuiParadise::Extensions.margined_window
-       self.instance_eval { alias ui_window       window } # === LibuiParadise::Extensions.ui_window
-       self.instance_eval { alias window_or_vbox  window } # === LibuiParadise::Extensions.window_or_vbox
-
-  # ========================================================================= #
-  # === window
-  # ========================================================================= #
-  def window(
-      the_title   = '',  # Pick a title for the window here.
-      width       = 500, # width  in n pixels.
-      height      = 300, # height in n pixels.
-      has_menubar =   1  # hasMenubar or has not.
-    )
-    LibuiParadise::Extensions.window(
-      the_title, width, height, has_menubar
-    )
-  end; alias main_window    window # === main_window
-
-  # ========================================================================= #
-  # === ui_margined_main_window
-  #
-  # This variant is like ui_main_window() but it will automatically
-  # put a margin on the window, via .is_margined().
-  #
-  # Note that the variant name "ui_padded_main_window" is a misnomer,
-  # since it is a margin rather than padding - but I found that it
-  # is easier to not care about this, so for the time being (September
-  # 2021) this is how it is. It may be subject to change in the future,
-  # though.
-  # ========================================================================= #
-  def ui_margined_main_window(
-      the_title   = '',  # Pick a title for the window here.
-      width       = 500, # width  in n pixels.
-      height      = 300, # height in n pixels.
-      has_menubar =   1  # hasMenubar or has not.
-    )
-    _ = LibuiParadise.window(the_title, width, height, has_menubar)
-    _.is_margined
-    return _
-  end; alias ui_margined_window    ui_margined_main_window # === ui_margined_window
-       alias ui_padded_main_window ui_margined_main_window # === ui_padded_main_window
-       alias margined_window       ui_margined_main_window # === margined_window
-       alias padded_window         ui_margined_main_window # === padded_window
-       alias ui_padded_window      ui_margined_main_window # === ui_padded_window
-       alias padded_main_window    ui_margined_main_window # === padded_main_window
-       alias ui_main_window        ui_margined_main_window # === ui_main_window
-       alias ui_window             ui_margined_main_window # === ui_window
-       alias window_or_vbox        ui_margined_main_window # === window_or_vbox
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.slider
-  # ========================================================================= #
-  def self.slider(
-      start_value =   0,
-      end_value   = 100
-    )
-    _ = ::LibUI.new_slider(start_value, end_value)
-    # ======================================================================= #
-    # Register it at once:
-    # ======================================================================= #
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_slider slider } # === LibuiParadise::Extensions.ui_slider
-
-  # ========================================================================= #
-  # === slider
-  # ========================================================================= #
-  def slider(
-      start_value =   0,
-      end_value   = 100
-    )
-    return ::LibuiParadise::Extensions.slider(start_value, end_value)
-  end; alias ui_slider slider # === ui_slider
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.horizontal_separator
+  # === LibuiParadise.horizontal_separator
   #
   # This method will add a new horizontal separator. The name "hsep"
   # is a shorter alias to this.
   # ========================================================================= #
   def self.horizontal_separator
     ::LibUI.new_horizontal_separator
-  end; self.instance_eval { alias ui_hseparator     horizontal_separator } # === LibuiParadise::Extensions.ui_hseparator
-       self.instance_eval { alias ui_hsep           horizontal_separator } # === LibuiParadise::Extensions.ui_hsep
-       self.instance_eval { alias hspacer           horizontal_separator } # === LibuiParadise::Extensions.hspacer
-       self.instance_eval { alias horizontal_spacer horizontal_separator } # === LibuiParadise::Extensions.horizontal_spacer
-       self.instance_eval { alias hsep              horizontal_separator } # === LibuiParadise::Extensions.hsept
-
-  # ========================================================================= #
-  # === horizontal_separator
-  # ========================================================================= #
-  def horizontal_separator
-    ::LibuiParadise::Extensions.horizontal_separator
-  end; alias ui_hseparator     horizontal_separator # === ui_hseparator
-       alias ui_hsep           horizontal_separator # === ui_hsep
-       alias hspacer           horizontal_separator # === hspacer
-       alias horizontal_spacer horizontal_separator # === horizontal_spacer
-       alias hsep              horizontal_separator # === hsep
-       alias libui_hsep        horizontal_separator # === libui_hsep
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.search_entry
-  # ========================================================================= #
-  def self.search_entry
-    _ = ::LibUI.new_search_entry
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_search_entry search_entry } # === LibuiParadise::Extensions.ui_search_entry
-
-  # ========================================================================= #
-  # === search_entry
-  # ========================================================================= #
-  def search_entry
-    ::LibuiParadise::Extensions.search_entry
-  end; alias ui_search_entry search_entry # === ui_search_entry
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.entry                           (entry tag)
-  #
-  # The upstream C API for libui-entry can be found here:
-  #
-  #   https://github.com/andlabs/libui/blob/master/unix/entry.c
-  #
-  # This method is tapping into LibUI.new_entry.
-  #
-  # Usage example:
-  #
-  #   entry1 = LibUI.entry('ATG')
-  #
-  # ========================================================================= #
-  def self.entry(
-      optional_text = ''
-    )
-    optional_text = optional_text.to_s
-    entry = ::LibUI.new_entry
-    unless optional_text.empty?
-      ::LibUI.entry_set_text(entry, optional_text)
-    end
-    add_to_the_registered_widgets(entry, __method__)
-    return entry
-  end; self.instance_eval { alias ui_entry entry } # === LibuiParadise::Extensions.ui_entry
-
-  # ========================================================================= #
-  # === entry                                                     (entry tag)
-  #
-  # This method is tapping into LibUI.new_entry.
-  #
-  # An alias exists to this method, called hcentered_entry. This currently
-  # does not work for libui, and is thus only added for compatibility
-  # reasons.
-  #
-  # Usage example:
-  #
-  #   entry1 = ui_entry('ATG')
-  #
-  # ========================================================================= #
-  def entry(
-      optional_text = ''
-    )
-    ::LibuiParadise::Extensions.entry(optional_text)
-  end; alias ui_entry        entry # === ui_entry
-       alias hcentered_entry entry # === hcentered_entry
-       alias create_entry    entry # === create_entry
-
-  # ========================================================================= #
-  # === text?
-  #
-  # This method will guarantee a String to be returned.
-  #
-  # This is a bit weird, though. We may have to remove this method one
-  # day. I forgot why I added it to entry.rb specifically. After all
-  # other widgets also should respond to .text?.
-  # ========================================================================= #
-  def text?(from_this_pointer)
-    _ = ::LibUI.entry_text(from_this_pointer).to_s
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.non_wrapping_multiline_entry
-  #
-  # The upstream C API for the non-wrapping multiline edit can be found here:
-  #
-  #   https://raw.githubusercontent.com/andlabs/libui/master/unix/multilineentry.c
-  #
-  # ========================================================================= #
-  def self.non_wrapping_multiline_entry
-    _ = ::LibUI.new_non_wrapping_multiline_entry
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.font                  (font tag, fonts tag)
-  # ========================================================================= #
-  def self.font(&block)
-    use_this_font = ::LibUI::FFI::FontDescriptor.malloc
-    if block_given?
-      yielded = yield
-      if yielded.is_a? Hash
-        # =================================================================== #
-        # === :font_size
-        # =================================================================== #
-        if yielded.has_key? :font_size
-          use_this_font.Size = yielded.delete(:font_size)
-        end
-        # =================================================================== #
-        # === :font_family
-        # =================================================================== #
-        if yielded.has_key? :font_family
-          use_this_font.Family = yielded.delete(:font_family)
-        end
-        # =================================================================== #
-        # === :stretch
-        # =================================================================== #
-        if yielded.has_key? :stretch
-          use_this_font.Stretch = yielded.delete(:stretch)
-        end
-        # =================================================================== #
-        # === :weight
-        # =================================================================== #
-        if yielded.has_key? :weight
-          use_this_font.Weight = yielded.delete(:weight)
-        end
-        # =================================================================== #
-        # === :italic
-        # =================================================================== #
-        if yielded.has_key? :italic
-          _ = yielded.delete(:italic_family)
-          if _ == true
-            _ = 1
-          elsif _ == false
-            _ = 0
-          end
-          use_this_font.Italic = _
-        end
-      end
-    end
-    return use_this_font
-  end; self.instance_eval { alias ui_font         font } # === LibuiParadise::Extensions.ui_font
-       self.instance_eval { alias font_descriptor font } # === LibuiParadise::Extensions.font_descriptor
-
-  # ========================================================================= #
-  # === font
-  # ========================================================================= #
-  def font(&block)
-    LibuiParadise::Extensions.font(&block)
-  end; alias ui_font         font # === ui_font
-       alias font_descriptor font # === font_descriptor
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.non_wrapping_multiline_entry
-  # ========================================================================= #
-  def non_wrapping_multiline_entry
-    return ::LibuiParadise::Extensions.non_wrapping_multiline_entry
-  end
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.menu                             (menu tag)
-  # ========================================================================= #
-  def self.menu(title = '')
-    _ = ::LibUI.new_menu(title)
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_menu menu } # === ui_menu
-
-  # ========================================================================= #
-  # === menu                                                       (menu tag)
-  # ========================================================================= #
-  def menu(
-      title = ''
-    )
-    return ::LibuiParadise::Extensions.menu(title)
-  end; alias ui_menu menu # === ui_menu
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.vertical_separator
-  #
-  # This method will add a new vertical separator.
-  # ========================================================================= #
-  def self.vertical_separator
-    ::LibUI.new_vertical_separator
-  end; self.instance_eval { alias ui_vseparator     vertical_separator } # === LibuiParadise::Extensions.ui_verticalseparator
-       self.instance_eval { alias ui_vsep           vertical_separator } # === LibuiParadise::Extensions.ui_vsep
-       self.instance_eval { alias vspacer           vertical_separator } # === LibuiParadise::Extensions.vspacer
-       self.instance_eval { alias vertical_spacer   vertical_separator } # === LibuiParadise::Extensions.vertical_spacer
-       self.instance_eval { alias vsep              vertical_separator } # === LibuiParadise::Extensions.vsept
-
-  # ========================================================================= #
-  # === vertical_separator
-  # ========================================================================= #
-  def vertical_separator
-    ::LibuiParadise::Extensions.vertical_separator
-  end; alias ui_vseparator     vertical_separator # === ui_vseparator
-       alias ui_vsep           vertical_separator # === ui_vsep
-       alias vertical_spacer   vertical_separator # === vertical_spacer
-       alias vspacer           vertical_separator # === vspacer
-       alias vsep              vertical_separator # === vsep
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.spinbox
-  #
-  # This method will return a spin-button, also called a spin-box.
-  #
-  # The first argument is the start value; the second argument is the end
-  # value.
-  # ========================================================================= #
-  def self.spinbox(
-      start_point =   0,
-      end_point   = 100
-    )
-    if start_point.is_a? Hash
-      # ===================================================================== #
-      # === :end
-      # ===================================================================== #
-      if start_point.has_key? :end
-        end_point = start_point[:end]
-      end
-      # ===================================================================== #
-      # === :start
-      # ===================================================================== #
-      if start_point.has_key? :start
-        start_point = start_point[:start]
-      end
-    end
-    _ = ::LibUI.new_spinbox(start_point.to_i, end_point.to_i)
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_spinbox    spinbox } # === LibuiParadise::Extensions.ui_spinbox
-       self.instance_eval { alias ui_spinbutton spinbox } # === LibuiParadise::Extensions.ui_spinbutton
-       self.instance_eval { alias spinbutton    spinbox } # === LibuiParadise::Extensions.spinbutton
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.password_entry
-  #
-  # This method will create and returns a new password entry widget. This
-  # means that input will be "disguised" via the '*' character.
-  #
-  # Usage example:
-  #
-  #   entry = LibuiParadise::Extensions.password_entry
-  #
-  # ========================================================================= #
-  def self.password_entry
-    entry = ::LibUI.new_password_entry
-    add_to_the_registered_widgets(entry, __method__)
-    return entry
-  end; self.instance_eval { alias ui_password_entry password_entry } # === LibuiParadise::Extensions.ui_password_entry
-
-  # ========================================================================= #
-  # === password_entry
-  #
-  # Usage example:
-  #
-  #   entry = ui_password_entry
-  #
-  # ========================================================================= #
-  def password_entry
-    ::LibuiParadise::Extensions.password_entry
-  end; alias ui_password_entry password_entry # === ui_password_entry
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.text_layout
-  # ========================================================================= #
-  def self.text_layout(
-      i = ''
-    )
-    _ = ::LibUI.draw_new_text_layout(i.to_s)
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end
-
-  # ========================================================================= #
-  # === text_layout
-  # ========================================================================= #
-  def text_layout(
-      i = ''
-    )
-    ::LibuiParadise::Extensions.text_layout(i)
-  end
-
-  # ========================================================================= #
-  # === spinbox
-  #
-  # This method will return a spin-button, also called a spin-box.
-  # ========================================================================= #
-  def spinbox(
-      start_point =   0,
-      end_point   = 100
-    )
-    ::LibuiParadise::Extensions.spinbox(start_point, end_point)
-  end; alias ui_spinbox           spinbox # === ui_spinbox
-       alias ui_spinbutton        spinbox # === ui_spinbutton
-       alias up_and_down_counter  spinbox # === up_and_down_counter
-       alias spinbutton           spinbox # === spinbutton
-       alias centered_spin_button spinbox # === centered_spin_button
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.table
-  #
-  # The argument should be of type table_params.
-  #
-  # Example for this:
-  #
-  #   table_params = LibUI::FFI::TableParams.malloc
-  #   table_params.Model = model
-  #   table_params.RowBackgroundColorModelColumn = -1
-  #
-  # ========================================================================= #
-  def self.table(i)
-    _ = ::LibUI.new_table(i)
-    LibuiParadise::Extensions.register_this_fiddle_pointer_widget(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_table table } # === LibuiParadise::Extensions.ui_table
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.checkbox                     (checkbox tag)
-  # ========================================================================= #
-  def self.checkbox(i = '')
-    _ = ::LibUI.new_checkbox(i)
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end
-
-  # ========================================================================= #
-  # === checkbox
-  # ========================================================================= #
-  def checkbox(i = '')
-    ::LibuiParadise::Extensions.checkbox(i)
-  end; alias ui_checkbox     checkbox # === ui_checkbox
-       alias ui_check_button checkbox # === ui_check_button
-
-  # ========================================================================= #
-  # === checked_checkbox
-  # ========================================================================= #
-  def checked_checkbox(i = '')
-    _ = checkbox(i)
-    _.is_active
-    return _
-  end
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.button                         (button tag)
-  #
-  # The upstream API for buttons, in C, can be found here:
-  #
-  #   https://raw.githubusercontent.com/andlabs/libui/master/unix/button.c
-  #
-  # ========================================================================= #
-  def self.button(text)
-    _ = ::LibUI.new_button(text)
-    ::LibuiParadise::Extensions.register_this_fiddle_pointer_widget(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_button button } # === LibuiParadise::Extensions.ui_button
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.multiline_entry       (multiline_entry tag)
-  #
-  # The upstream code for the linux-variant for a multiline-entry can
-  # be found here:
-  #
-  #   https://raw.githubusercontent.com/andlabs/libui/master/unix/multilineentry.c
-  #
-  # A multiline-entry, also known more traditionally as a "textview",
-  # is a widget that allows the user to input text and modify that
-  # text as well.
-  # ========================================================================= #
-  def self.multiline_entry(optional_content = nil)
-    _ = ::LibUI.new_multiline_entry
-    add_to_the_registered_widgets(_, __method__)
-    if optional_content and optional_content.is_a?(String) and !optional_content.empty?
-      _.set_text(optional_content)
-    end
-    return _
-  end; self.instance_eval { alias ui_multiline_entry multiline_entry } # === LibuiParadise::Extensions.ui_multiline_entry
-       self.instance_eval { alias textview           multiline_entry } # === LibuiParadise::Extensions.textview
-       self.instance_eval { alias text_view          multiline_entry } # === LibuiParadise::Extensions.text_view
-       self.instance_eval { alias ui_text_view       multiline_entry } # === LibuiParadise::Extensions.ui_text_view
-       self.instance_eval { alias ui_textview        multiline_entry } # === LibuiParadise::Extensions.ui_textview
-       self.instance_eval { alias ui_text_buffer     multiline_entry } # === LibuiParadise::Extensions.ui_text_buffer
-       self.instance_eval { alias input_field        multiline_entry } # === LibuiParadise::Extensions.input_field
-       self.instance_eval { alias input              multiline_entry } # === LibuiParadise::Extensions.input
-
-  # ========================================================================= #
-  # === Libuiparadise::Extensions.image
-  #
-  # This is currently limited to .png files only, due to ChunkyPng.
-  #
-  # At some later point in the future this limitation may be lifted. For
-  # now it has to remain in place.
-  # ========================================================================= #
-  def self.image(
-      this_file,
-      width  = :try_to_infer_automatically,
-      height = :infer_automatically
-    )
-    if (width  == :infer_automatically) or
-       (height == :infer_automatically)
-      unless Object.const_defined? :ChunkyPNG
-        begin
-          require 'chunky_png'
-        rescue LoadError; end
-      end
-      canvas = ChunkyPNG::Canvas.from_file(this_file)
-      data   = canvas.to_rgba_stream
-      width  = canvas.width
-      height = canvas.height
-      _ = ::LibUI.new_image(width, height) # Create the image here.
-      add_to_the_registered_widgets(_, __method__)
-      ::LibUI.image_append(
-        _,
-        data,
-        width,
-        height,
-        width
-      )
-      return _
-    end
-    nil
-  end; self.instance_eval { alias ui_image image } # === LibuiParadise::Extensions.ui_image
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.font_button
-  #
-  # Create a new font button via this method.
-  # ========================================================================= #
-  def self.font_button
-    _ = ::LibUI.new_font_button
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_font_button font_button } # === Libuiparadise::Extensions.ui_font_button
-
-  # ========================================================================= #
-  # === font_button
-  #
-  # Create a new font button via this method.
-  # ========================================================================= #
-  def font_button
-    return ::LibuiParadise::Extensions.font_button
-  end; alias ui_font_button font_button # === ui_font_button
-
-  # ========================================================================= #
-  # === image
-  #
-  # This is currently limited to .png files only, due to ChunkyPng.
-  #
-  # At some later point in the future this limitation may be lifted. For
-  # now it has to remain in place.
-  # ========================================================================= #
-  def image(
-      this_file,
-      width  = :try_to_infer_automatically,
-      height = :infer_automatically
-    )
-    Libuiparadise::Extensions.image(
-      this_file, width, height
-    )
-  end; alias ui_image image # === ui_image
-
-  # ========================================================================= #
-  # === multiline_entry
-  # ========================================================================= #
-  def multiline_entry(optional_content = nil)
-    ::LibuiParadise::Extensions.multiline_entry(optional_content)
-  end; alias ui_multiline_entry multiline_entry # === ui_multiline_entry
-       alias textview           multiline_entry # === textview
-       alias text_view          multiline_entry # === text_view
-       alias ui_text_view       multiline_entry # === ui_text_view
-       alias ui_textview        multiline_entry # === ui_textview
-       alias ui_text_buffer     multiline_entry # === ui_text_buffer
-       alias input_field        multiline_entry # === input_field
-       alias input              multiline_entry # === input
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.radio_buttons
-  #
-  # This method will create some radio buttons.
-  #
-  # You can pass an Array into this method, which should be an Array of
-  # Strings. This is optional. If such an Array is given, though, then
-  # these entries will become radio-buttons, with the associated label
-  # (the text they display) becoming the label right next to the radio
-  # button element (that round circle that the user can select via
-  # the mouse cursor).
-  # ========================================================================= #
-  def self.radio_buttons(
-      optional_array = []
-    )
-    _ = ::LibUI.new_radio_buttons
-    if optional_array and optional_array.is_a?(Array) and !optional_array.empty?
-      optional_array.each {|this_element|
-        ::LibUI.radio_buttons_append(_, this_element)
-      }
-    end
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_radio_buttons radio_buttons } # === LibuiParadise::Extensionsui_radio_buttons
-
-  # ========================================================================= #
-  # === radio_buttons
-  # ========================================================================= #
-  def radio_buttons(optional_array = [])
-    return ::LibuiParadise::Extensions.radio_buttons(optional_array)
-  end; alias ui_radio_buttons radio_buttons # === ui_radio_buttons
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.new_colour_button
-  #
-  # The upstream API for a colour-button (in C) can be found here:
-  #
-  #   https://github.com/andlabs/libui/blob/master/unix/colorbutton.c
-  #
-  # ========================================================================= #
-  def self.colour_button
-    _ = ::LibUI.new_color_button
-    ::LibuiParadise::Extensions.register_this_fiddle_pointer_widget(_, __method__)
-    return _
-  end; self.instance_eval { alias new_colour_button colour_button } # === LibuiParadise::Extensions.new_colour_button
-       self.instance_eval { alias new_color_button  colour_button } # === LibuiParadise::Extensions.new_color_button
-       self.instance_eval { alias ui_colour_button  colour_button } # === LibuiParadise::Extensions.ui_colour_button
-
-  # ========================================================================= #
-  # === colour_button
-  # ========================================================================= #
-  def colour_button
-    ::LibuiParadise::Extensions.new_colour_button
-  end; alias color_button     colour_button # === color_button
-       alias ui_colour_button colour_button # === ui_color_button
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.scrolling_area
-  #
-  # It seems as if scrolling is not yet easily available in libui.
-  #
-  # The upstream API is like this:
-  #
-  #   uiArea *area = uiNewScrollingArea(&handler, 400, 400);
-  #
-  # The two numbers are width and height, as integers, respectively.
-  # In total three arguments are required. The first argument is
-  # a so-called "AreaHandler".
-  #
-  # The code may be found here:
-  #
-  #   https://github.com/andlabs/libui/blob/master/windows/areascroll.cpp
-  #
-  # ========================================================================= #
-  def self.scrolling_area(
-      widget,
-      width           = 400,
-      height          = 400
-    )
-    case width
-    when :default, nil
-      width = 400
-    end
-    case height
-    when :default, nil
-      height = 400
-    end
-    _ = ::LibUI.new_scrolling_area(widget, width, height)
-    # ======================================================================= #
-    # The next part does not yet work - is it even possible to add widgets
-    # to a scrolling area in libui?
-    # if optional_widget
-    #   _.add(optional_widget)
-    # end
-    # ======================================================================= #
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_scrolling_area  scrolling_area } # === LibuiParadise::Extensions.ui_scrolling_area
-       self.instance_eval { alias ui_scrolled_window scrolling_area } # === LibuiParadise::Extensions.ui_scrolling_window
-
-  # ========================================================================= #
-  # === scrolling_area
-  #
-  # It seems as if scrolling is not yet easily available in libui.
-  #
-  # The upstream API is like this:
-  #
-  #   uiArea *area = uiNewScrollingArea(&handler, 400, 400);
-  #
-  # ========================================================================= #
-  def scrolling_area(
-      optional_widget = nil
-    )
-    LibuiParadise::Extensions.scrolling_area(optional_widget)
-  end; alias ui_scrolling_area  scrolling_area # === ui_scrolling_area
-       alias ui_scrolled_window scrolling_area # === ui_scrolling_window
-
-  # ========================================================================= #
-  # === bold_button
-  #
-  # This currently does not work. We have to wait until upstream libui
-  # supports bold font text.
-  # ========================================================================= #
-  def bold_button(i)
-    button(i)
-  end
-
-  # ========================================================================= #
-  # === quit_button                                                (quit tag)
-  #
-  # This method can be used to, by default, implement a quit button
-  # that, upon a click-event, will cause the application to exit
-  # and close/quit.
-  # ========================================================================= #
-  def quit_button(
-      optional_arguments = {}
-    )
-    use_this_text = 'Quit'
-    if optional_arguments and optional_arguments.is_a?(Hash)
-      # ===================================================================== #
-      # === :text
-      # ===================================================================== #
-      if optional_arguments.has_key? :text
-        use_this_text = optional_arguments.delete(:text)
-      end
-    end
-    if block_given?
-      yielded = yield
-      case yielded
-      # ===================================================================== #
-      # === :with_emoji
-      # ===================================================================== #
-      when :with_emoji,
-           :with_icon
-        use_this_text = use_this_text.to_s.dup
-        use_this_text << ' 🛑'
-      end
-    end
-    quit_button = button(use_this_text)
-    quit_button.on_clicked {
-      ::LibUI.quit
-      0
-    }
-    return quit_button
-  end; alias ui_quit_button quit_button # === ui_quit_button
-
-  # ========================================================================= #
-  # === table
-  # ========================================================================= #
-  def table(i)
-    ::LibuiParadise::Extensions.table(i)
-  end; alias ui_table table # === ui_table
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.editable_combobox
-  #
-  # This is a combo-box that the user can modify.
-  # ========================================================================= #
-  def self.editable_combobox(
-      optional_array = nil, &block
-    )
-    _ = ::LibUI.new_editable_combobox
-    if block_given?
-      optional_array = yield
-    end
-    if optional_array and optional_array.is_a?(Array)
-      append_this_array_to_that_combobox(optional_array, _)
-    end
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias editable_combo_box    editable_combobox } # === LibuiParadise::Extensions.editable_combo_box
-       self.instance_eval { alias ui_editable_combo_box editable_combobox } # === LibuiParadise::Extensions.ui_editable_combo_box
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.combobox
-  # ========================================================================= #
-  def self.combobox(
-      optional_array = nil, &block
-    )
-    combobox = ::LibUI.new_combobox
-    # ======================================================================= #
-    # Register it at once:
-    # ======================================================================= #
-    add_to_the_registered_widgets(combobox, __method__)
-    if block_given?
-      optional_array = yield
-    end
-    if optional_array and optional_array.is_a?(Array)
-      # append_this_array_to_that_combobox(optional_array, combobox)
-      combobox.append_this_array(optional_array)
-    end
-    return combobox
-  end; self.instance_eval { alias combo_box    combobox } # === LibuiParadise::Extensions.combo_box
-       self.instance_eval { alias ui_combo_box combobox } # === LibuiParadise::Extensions.ui_combo_box
-       self.instance_eval { alias ui_combobox  combobox } # === LibuiParadise::Extensions.ui_combobox
-
-  # ========================================================================= #
-  # === selected?
-  #
-  # Unsure whether this works. It appears to work, but I am not even
-  # certain as to why.
-  # ========================================================================= #
-  def selected?(pointer)
-    ::LibUI.combobox_selected(pointer).to_s
-  end
-
-  # ========================================================================= #
-  # === combobox
-  #
-  # The first argument can be an Array.
-  # ========================================================================= #
-  def combobox(
-      optional_array = nil, &block
-    )
-    return ::LibuiParadise::Extensions.combobox(optional_array, &block)
-  end; alias combo_box       combobox # === combo_box
-       alias ui_combo_box    combobox # === ui_combo_box
-       alias ui_combobox     combobox # === ui_combobox
-       alias combo_box_entry combobox # === combo_box_entry
-       alias libui_combo_box combobox # === libui_combo_box
-
-  # ========================================================================= #
-  # === editable_combobox
-  # ========================================================================= #
-  def editable_combobox(
-      optional_array = nil, &block
-    )
-    return ::LibuiParadise::Extensions(optional_array, &block)
-  end; alias editable_combo_box    editable_combobox # === editable_combo_box
-       alias ui_editable_combo_box editable_combobox # === ui_editable_combo_box
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.label                (text tag, label tag)
-  #
-  # Add text to the widget at hand. This is actually called a "label".
-  # ========================================================================= #
-  def self.label(
-      i = ''
-    )
-    if i.include? '</'
-      # ===================================================================== #
-      # For now we must remove "HTML tags" from the given input. Perhaps
-      # at some later point in time we can retain them.
-      # ===================================================================== #
-      i = i.dup if i.frozen?
-      i.gsub!(%r{<[^>]+>}, '')
-    end
-    _ = ::LibUI.new_label(i.to_s)
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias text     label } # === LibuiParadise::Extensions.text
-       self.instance_eval { alias ui_text  label } # === LibuiParadise::Extensions.ui_text
-       self.instance_eval { alias ui_label label } # === LibuiParadise::Extensions.ui_label
-
-  # ========================================================================= #
-  # === label
-  #
-  # The last two aliases, left_aligned_label, should be different, but
-  # right now I don't know how to do this in libui.
-  # ========================================================================= #
-  def label(
-      i = ''
-    )
-    ::LibuiParadise::Extensions.label(i)
-  end; alias text               label # === text
-       alias ui_text            label # === ui_text
-       alias ui_label           label # === ui_label
-       alias left_aligned_label label # === left_aligned_label
-       alias left_aligned_text  label # === left_aligned_text
-
-  # ========================================================================= #
-  # === bold_label
-  #
-  # This currently does not work properly. We may have to re-examine this
-  # eventually at a later point.
-  # ========================================================================= #
-  def bold_label(i = '')
-    return label(i)
-  end
-
-  # ========================================================================= #
-  # === bold_text
-  #
-  # This currently does NOT make the text bold - the method exists solely
-  # as a placeholder, until upstream libui supports bold text as such.
-  # ========================================================================= #
-  def bold_text(i = '')
-    return label(i)
-  end
-
-  # ========================================================================= #
-  # === bold_text_left_aligned
-  # ========================================================================= #
-  def bold_text_left_aligned(i = '')
-    return label(i)
-  end; alias left_aligned_bold_label bold_text_left_aligned # === left_aligned_bold_label
-
-  # ========================================================================= #
-  # === fancy_text
-  #
-  # This text variant can be styled.
-  # ========================================================================= #
-  def fancy_text(i = '')
-    _ = LibUI.new_attributed_string(i.to_s)
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; alias attributed_string fancy_text # === attributed_string
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.tab
-  #
-  # This could be also called "notebook_tab".
-  # ========================================================================= #
-  def self.tab
-    _ = ::LibUI.new_tab
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias ui_tab       tab } # === LibuiParadise::Extensions.ui_tab
-       self.instance_eval { alias ui_tabs      tab } # === LibuiParadise::Extensions.ui_tabs
-       self.instance_eval { alias notebook     tab } # === LibuiParadise::Extensions.notebook
-       self.instance_eval { alias ui_notebook  tab } # === LibuiParadise::Extensions.ui_notebook
-       self.instance_eval { alias notebook_tab tab } # === LibuiParadise::Extensions.notebook_tab
-
-  # ========================================================================= #
-  # === tab
-  #
-  # This could be also called "notebook_tab".
-  # ========================================================================= #
-  def tab
-    ::LibuiParadise::Extensions.tab
-  end; alias ui_tab       tab # === ui_tab
-       alias ui_tabs      tab # === ui_tabs
-       alias notebook     tab # === notebook
-       alias ui_notebook  tab # === ui_notebook
-       alias notebook_tab tab # === notebook_tab
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.area
-  #
-  # AreaHandler defines the functionality needed for handling events from
-  # an Area.
-  #
-  # Upstream documentation, at the least for Go, can be found here:
-  #
-  #   https://github.com/andlabs/ui/blob/master/areahandler.go
-  #
-  # ========================================================================= #
-  def self.area(
-      i = :use_new_area_handler
-    )
-    case i
-    # ======================================================================= #
-    # === :use_new_area_handler
-    # ======================================================================= #
-    when :use_new_area_handler,
-         :default
-      # ===================================================================== #
-      # malloc a new area-handled next:
-      # ===================================================================== #
-      i = ::LibUI::FFI::AreaHandler.malloc
-      i.to_ptr.free = Fiddle::RUBY_FREE # This one is done in upstream LibUI as well.
-    end
-    _ = ::LibUI.new_area(i) # Our new area, with the given handler.
-    add_to_the_registered_widgets(_, __method__)
-    return _
-  end; self.instance_eval { alias area_handler area } # === LibuiParadise::Extensions.area_handler
-
-  # ========================================================================= #
-  # === area
-  #
-  # AreaHandler defines the functionality needed for handling events
-  # from an Area.
-  #
-  # Upstream documentation, at the least for Go, can be found here:
-  #
-  #   https://github.com/andlabs/ui/blob/master/areahandler.go
-  #
-  # ========================================================================= #
-  def area(
-      i = :use_new_area_handler
-    )
-    return ::LibuiParadise::Extensions.area(i)
-  end; alias area_handler area # === area_handler
-
-  # ========================================================================= #
-  # === is_on_windows?
-  # ========================================================================= #
-  def is_on_windows?
-    Gem.win_platform?
-  end
-
-end
-
-# =========================================================================== #
-# === LibuiParadise.window
-# =========================================================================== #
-def self.window(
-    the_title   = '',  # Pick a title for the window here.
-    width       = 500, # width  in n pixels.
-    height      = 300, # height in n pixels.
-    has_menubar =   1  # hasMenubar or has not.
-  )
-  ::LibuiParadise::Extensions.window(
-    the_title,
-    width,
-    height,
-    has_menubar
-  )
-end; self.instance_eval { alias main_window           window } # === LibuiParadise.main_window
-     self.instance_eval { alias margined_window       window } # === LibuiParadise.margined_window
-     self.instance_eval { alias ui_window             window } # === LibuiParadise.ui_window
-     self.instance_eval { alias ui_main_window        window } # === LibuiParadise.ui_main_window
-     self.instance_eval { alias ui_padded_main_window window } # === LibuiParadise.margined_window
-     self.instance_eval { alias padded_window         window } # === LibuiParadise.padded_window
-     self.instance_eval { alias padded_main_window    window } # === LibuiParadise.padded_main_window
-     self.instance_eval { alias window_or_vbox        window } # === LibuiParadise.window_or_vbox
-
-# =========================================================================== #
-# === LibuiParadise.main_window?
-# =========================================================================== #
-def self.main_window?
-  LibuiParadise::Extensions.main_window?
-end
-
-# =========================================================================== #
-# === LibuiParadise::Extensions.editable_combobox
-# =========================================================================== #
-def self.editable_combobox(
-    optional_array = nil, &block
-  )
-  return ::LibuiParadise::Extensions.editable_combobox(optional_array, &block)
-end; self.instance_eval { alias editable_combo_box    editable_combobox } # === LibuiParadise.editable_combo_box
-     self.instance_eval { alias ui_editable_combo_box editable_combobox } # === LibuiParadise.ui_editable_combo_box
-
-# ========================================================================= #
-# === LibuiParadise.label
-#
-# Toplevel method to create a new label, aka new text.
-# ========================================================================= #
-def self.label(
-    i = ''
-  )
-  ::LibuiParadise::Extensions.label(i)
-end; self.instance_eval { alias text     label } # === LibuiParadise.text
-     self.instance_eval { alias ui_text  label } # === LibuiParadise.ui_text
-     self.instance_eval { alias ui_label label } # === LibuiParadise.ui_label
-
-# ========================================================================= #
-# === LibuiParadise.string
-# ========================================================================= #
-def self.string(i = '')
-  return ::LibUI.new_attributed_string(i)
-end; self.instance_eval { alias fancy_text string } # === LibuiParadise.fancy_text
-
-# =========================================================================== #
-# === LibuiParadise.table
-# =========================================================================== #
-def self.table(i)
-  ::LibuiParadise::Extensions.table(i)
-end; self.instance_eval { alias ui_table table } # === LibuiParadise.ui_table
-
-# =========================================================================== #
-# === LibuiParadise.spinbox
-# =========================================================================== #
-def self.spinbox(
-    start_point =   0,
-    end_point   = 100
-  )
-  ::LibuiParadise::Extensions.spinbox(start_point, end_point)
-end; self.instance_eval { alias ui_spinbox    spinbox } # === LibuiParadise.ui_spinbox
-     self.instance_eval { alias ui_spinbutton spinbox } # === LibuiParadise.ui_spinbutton
-     self.instance_eval { alias spinbutton    spinbox } # === LibuiParadise.spinbutton
-
-# =========================================================================== #
-# === LibuiParadise.slider
-# =========================================================================== #
-def self.slider(
-    start_value =   0,
-    end_value   = 100
-  )
-  ::LibuiParadise::Extensions.slider(start_value, end_value)
-end; self.instance_eval { alias ui_slider slider } # === LibuiParadise.ui_slider
-
-# =========================================================================== #
-# === LibuiParadise.button
-# =========================================================================== #
-def self.button(text)
-  ::LibuiParadise::Extensions.button(text)
-end
-
-# =========================================================================== #
-# === LibuiParadise.checkbox
-# =========================================================================== #
-def self.checkbox(i = '')
-  ::LibuiParadise::Extensions.checkbox(i)
-end
-
-# =========================================================================== #
-# === LibuiParadise.msg_box
-# =========================================================================== #
-def self.msg_box(
-    main_window  = :default_window,
-    title_to_use = '',
-    whatever     = ''
-  )
-  if main_window.is_a?(String) and title_to_use.is_a?(String) and
-    title_to_use.empty?
-    title_to_use = main_window.dup
-    main_window = :default_window
-  end
-  ::LibuiParadise::Extensions.msg_box(
-    main_window,
-    title_to_use,
-    whatever
-  )
-end; self.instance_eval { alias ui_msg_box             msg_box } # === LibuiParadise.ui_msg_box
-     self.instance_eval { alias message_to_the_user    msg_box } # === LibuiParadise.message_to_the_user
-     self.instance_eval { alias message_box            msg_box } # === LibuiParadise.message_box
-     self.instance_eval { alias popup_over_this_widget msg_box } # === LibuiParadise.popup_over_this_widget
-     self.instance_eval { alias popup_message          msg_box } # === LibuiParadise.popup_message
-
-# =========================================================================== #
-# === LibuiParadise.new_progress_bar
-# =========================================================================== #
-def self.new_progress_bar
-  return ::LibuiParadise::Extensions.new_progress_bar
-end
-
-# ========================================================================= #
-# === LibuiParadise.vertical_separator
-# ========================================================================= #
-def self.vertical_separator
-  ::LibuiParadise::Extensions.vertical_separator
-end; self.instance_eval { alias ui_vseparator vertical_separator } # === LibuiParadise.ui_vseparator
-     self.instance_eval { alias ui_vsep       vertical_separator } # === LibuiParadise.ui_vsep
-     self.instance_eval { alias vsep          vertical_separator } # === LibuiParadise.vsep
-
-# =========================================================================== #
-# === LibuiParadise.text_layout
-# =========================================================================== #
-def self.text_layout(
-    i = ''
-  )
-  ::LibuiParadise::Extensions.text_layout(i)
-end
-
-# =========================================================================== #
-# === LibuiParadise.search_entry
-# =========================================================================== #
-def self.search_entry
-  ::LibuiParadise::Extensions.search_entry
-end; self.instance_eval { alias ui_search_entry search_entry } # === LibuiParadise.ui_search_entry
-
-# =========================================================================== #
-# === LibuiParadise.scrolling_area
-# =========================================================================== #
-def self.scrolling_area(
-    widget,
-    width  = :default,
-    height = :default
-  )
-  ::LibuiParadise::Extensions.scrolling_area(widget, width, height)
-end
-
-# =========================================================================== #
-# === LibuiParadise.radio_buttons
-# =========================================================================== #
-def self.radio_buttons(optional_array = [])
-  return ::LibuiParadise::Extensions.radio_buttons(optional_array)
-end
-
-# =========================================================================== #
-# === LibuiParadise.password_entry
-# =========================================================================== #
-def self.password_entry
-  ::LibuiParadise::Extensions.password_entry
-end; self.instance_eval { alias ui_password_entry password_entry } # === LibuiParadise.ui_password_entry
-
-# =========================================================================== #
-# === LibuiParadise.non_wrapping_multiline_entry
-# =========================================================================== #
-def self.non_wrapping_multiline_entry
-  return ::LibuiParadise::Extensions.non_wrapping_multiline_entry
-end
-
-# =========================================================================== #
-# === LibuiParadise.multiline_entry
-# =========================================================================== #
-def self.multiline_entry(optional_content = nil)
-  ::LibuiParadise::Extensions.multiline_entry(optional_content)
-end; self.instance_eval { alias textview           multiline_entry } # === LibuiParadise.textview
-     self.instance_eval { alias text_view          multiline_entry } # === LibuiParadise.text_view
-     self.instance_eval { alias ui_text_view       multiline_entry } # === LibuiParadise.ui_text_view
-     self.instance_eval { alias ui_textview        multiline_entry } # === LibuiParadise.ui_textview
-     self.instance_eval { alias ui_text_buffer     multiline_entry } # === LibuiParadise.ui_text_buffer
-     self.instance_eval { alias input_field        multiline_entry } # === LibuiParadise.input_field
-
-# =========================================================================== #
-# === LibuiParadise.menu
-# =========================================================================== #
-def self.menu(title = '')
-  return LibuiParadise::Extensions.menu(title)
-end; self.instance_eval { alias ui_menu menu } # === LibuiParadise.ui_menu
-
-# ========================================================================= #
-# === Libuiparadise.image
-# ========================================================================= #
-def self.image(
-    this_file,
-    width  = :try_to_infer_automatically,
-    height = :infer_automatically
-  )
-  ::LibuiParadise::Extensions.image(
-    this_file, width, height
-  )
-end; self.instance_eval { alias ui_image image } # === LibuiParadise.ui_image
-
-# =========================================================================== #
-# === LibuiParadise.colour_button
-# =========================================================================== #
-def self.colour_button
-  ::LibuiParadise::Extensions.new_colour_button
-end; self.instance_eval { alias color_button colour_button } # === LibuiParadise.color_button
-
-# =========================================================================== #
-# === LibuiParadise.font_button
-# =========================================================================== #
-def self.font_button
-  return ::LibuiParadise::Extensions.font_button
-end
-
-# ========================================================================= #
-# === LibuiParadise.horizontal_separator
-# ========================================================================= #
-def self.horizontal_separator
-  ::LibuiParadise::Extensions.horizontal_separator
-end; self.instance_eval { alias ui_hseparator horizontal_separator } # === LibuiParadise.ui_hseparator
-     self.instance_eval { alias ui_hsep       horizontal_separator } # === LibuiParadise.ui_hsep
-     self.instance_eval { alias hsep          horizontal_separator } # === LibuiParadise.hsep
-
-# =========================================================================== #
-# === LibuiParadise.font
-# =========================================================================== #
-def self.font(&block)
-  ::LibuiParadise::Extensions.font(&block)
-end
-
-# =========================================================================== #
-# === LibuiParadise.entry
-# =========================================================================== #
-def self.entry(
-    optional_text = ''
-  )
-  ::LibuiParadise::Extensions.entry(optional_text)
-end; self.instance_eval { alias ui_entry entry } # === LibuiParadise.ui_entry
-
-# =========================================================================== #
-# === LibuiParadise.open_file
-#
-# Simple delegator towards LibuiParadise::Extensions.open_file().
-# =========================================================================== #
-def self.open_file(
-    main_window = LibuiParadise::Extensions.main_window?
-  )
-  return ::LibuiParadise::Extensions.open_file(main_window)
-end; self.instance_eval { alias ui_open_file open_file } # === LibuiParadise.ui_open_file
-
-# =========================================================================== #
-# === LibuiParadise.set_main_window
-# =========================================================================== #
-def self.set_main_window(i)
-  ::LibuiParadise::Extensions.set_main_window(i)
-end
+  end; self.instance_eval { alias ui_hseparator            horizontal_separator } # === LibuiParadise.ui_hseparator
+       self.instance_eval { alias ui_hsep                  horizontal_separator } # === LibuiParadise.ui_hsep
+       self.instance_eval { alias hspacer                  horizontal_separator } # === LibuiParadise.hspacer
+       self.instance_eval { alias horizontal_spacer        horizontal_separator } # === LibuiParadise.horizontal_spacer
+       self.instance_eval { alias hsep                     horizontal_separator } # === LibuiParadise.hsep
+       self.instance_eval { alias libui_hsep               horizontal_separator } # === LibuiParadise.libui_hsep
+       self.instance_eval { alias new_horizontal_separator horizontal_separator } # === LibuiParadise.new_horizontal_separator
 
 end