libui_paradise 0.2.49 → 0.3.9

data/lib/libui_paradise/libui_classes/libui_classes.rb

@@ -11,6 +11,13 @@ module Extensions # === LibuiParadise::Extensions
   require 'libui_paradise/libui_classes/box.rb'
   require 'libui_paradise/libui_classes/grid.rb'
 
+  # ========================================================================= #
+  # === grid
+  # ========================================================================= #
+  def grid
+    ::LibUI.new_grid
+  end
+
   # ========================================================================= #
   # === button                                                   (button tag)
   #
@@ -23,8 +30,38 @@ module Extensions # === LibuiParadise::Extensions
     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
+    return ::LibuiParadise::Extensions.button(text)
+  end; alias ui_button     button # === ui_button
+       alias create_button button # === create_button
+
+  # ========================================================================= #
+  # === LibuiParadise::Extensions.tab
+  #
+  # This could be also called "notebook_tab" - see the alias on the
+  # bottom.
+  # ========================================================================= #
+  def self.tab
+    _ = ::LibUI.new_tab # Create a new notebook-tab here.
+    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.msg_box
@@ -91,11 +128,16 @@ module Extensions # === LibuiParadise::Extensions
     case main_window
     # ======================================================================= #
     # === :default_window
+    #
+    # Note that LibuiParadise.main_window? may be nil.
     # ======================================================================= #
     when :default_window,
          :default
       main_window = ::LibuiParadise.main_window?
     end
+    if description_to_use.is_a? Array
+      description_to_use = description_to_use.join(' ').strip
+    end
     _ = ::LibUI.msg_box(
       main_window,
       title_to_use,
@@ -228,27 +270,6 @@ module Extensions # === LibuiParadise::Extensions
     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
   #
@@ -378,6 +399,7 @@ module Extensions # === LibuiParadise::Extensions
     )
     _ = LibuiParadise.window(the_title, width, height, has_menubar)
     _.is_margined
+    #_.intelligent_exit # This does not work right now.
     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
@@ -738,24 +760,6 @@ module Extensions # === LibuiParadise::Extensions
        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)
   # ========================================================================= #
@@ -1031,6 +1035,24 @@ module Extensions # === LibuiParadise::Extensions
   end; alias ui_scrolling_area  scrolling_area # === ui_scrolling_area
        alias ui_scrolled_window scrolling_area # === ui_scrolling_window
 
+  # ========================================================================= #
+  # === LibuiParadise::Extensions.table
+  #
+  # The argument to this method 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
+
   # ========================================================================= #
   # === bold_button
   #
@@ -1242,34 +1264,6 @@ module Extensions # === LibuiParadise::Extensions
     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
   #
@@ -1325,6 +1319,30 @@ module Extensions # === LibuiParadise::Extensions
     Gem.win_platform?
   end
 
+  # ========================================================================= #
+  # === ui_open_file
+  #
+  # This method can be used as a wrapper towards an "open local file"
+  # functionality.
+  # ========================================================================= #
+  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
+
 end
 
 # =========================================================================== #
@@ -1400,7 +1418,8 @@ end; self.instance_eval { alias ui_table table } # === LibuiParadise.ui_table
 # =========================================================================== #
 def self.spinbox(
     start_point =   0,
-    end_point   = 100
+    end_point   = 100,
+    increment   =   1 # This is currently ignored.
   )
   ::LibuiParadise::Extensions.spinbox(start_point, end_point)
 end; self.instance_eval { alias ui_spinbox    spinbox } # === LibuiParadise.ui_spinbox
@@ -1590,10 +1609,33 @@ def self.entry(
   ::LibuiParadise::Extensions.entry(optional_text)
 end; self.instance_eval { alias ui_entry entry } # === LibuiParadise.ui_entry
 
+# =========================================================================== #
+# === LibuiParadise.set_main_window
+# =========================================================================== #
+def self.set_main_window(i)
+  ::LibuiParadise::Extensions.set_main_window(i)
+end
+
+# =========================================================================== #
+# === LibuiParadise.create_tab
+# =========================================================================== #
+def self.create_tab
+  LibuiParadise::Extensions.tab
+end; self.instance_eval { alias tab create_tab } # === LibuiParadise.tab
+
+# =========================================================================== #
+# === LibuiParadise.create_grid
+# =========================================================================== #
+def self.create_grid
+  ::LibUI.new_grid
+end; self.instance_eval { alias grid create_grid } # === LibuiParadise.grid
+
 # =========================================================================== #
 # === LibuiParadise.open_file
 #
-# Simple delegator towards LibuiParadise::Extensions.open_file().
+# This method is a simple delegator towards
+# the LibuiParadise::Extensions.open_file()
+# functionality.
 # =========================================================================== #
 def self.open_file(
     main_window = LibuiParadise::Extensions.main_window?
@@ -1601,11 +1643,4 @@ def self.open_file(
   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

data/lib/libui_paradise/project/project.rb

@@ -8,7 +8,7 @@
 module LibuiParadise
 
   # ========================================================================= #
-  # === PROJECT_BASE_DIRECTORY
+  # === LibuiParadise::PROJECT_BASE_DIRECTORY
   # ========================================================================= #
   PROJECT_BASE_DIRECTORY =
     File.absolute_path("#{__dir__}/..")+'/'
@@ -25,4 +25,8 @@ module LibuiParadise
        self.instance_eval { alias project_base_dir?       project_base_dir? } # === LibuiParadise.project_base_dir?
        self.instance_eval { alias project_base_directory? project_base_dir? } # === LibuiParadise.project_base_directory?
 
+end
+
+if __FILE__ == $PROGRAM_NAME
+  puts LibuiParadise.project_base_dir?  
 end

data/lib/libui_paradise/prototype/prototype.rb

@@ -12,9 +12,7 @@ module LibUI
 
 class Prototype # === LibuiParadise::GUI::LibUI::Prototype
 
-  alias e puts
-
-  require 'libui_paradise'
+  require 'libui_paradise/extensions/extensions.rb'
   include LibuiParadise::Extensions
 
   # require 'bioroebe/gui/shared_code/levensthein_distance/levensthein_distance_module.rb'

data/lib/libui_paradise/requires/require_the_libui_paradise_project.rb

@@ -6,7 +6,7 @@
 # =========================================================================== #
 require 'libui_paradise/extensions/extensions.rb' # This also pulls in another file, called pointer.rb.
 require 'libui_paradise/project/project.rb'
-require 'libui_paradise/toplevel_methods/misc.rb'
 require 'libui_paradise/requires/require_the_libui_classes.rb'
+require 'libui_paradise/colours/colours.rb'
 
 LibuiParadise.do_require_the_libui_classes

data/lib/libui_paradise/version/version.rb

@@ -7,11 +7,11 @@ module LibuiParadise
   # ========================================================================= #
   # === VERSION
   # ========================================================================= #
-  VERSION = '0.2.49'
+  VERSION = '0.3.9'
 
   # ========================================================================= #
   # === LAST_UPDATE
   # ========================================================================= #
-  LAST_UPDATE = '09.10.2022'
+  LAST_UPDATE = '12.12.2023'
 
 end

data/libui_paradise.gemspec

@@ -15,15 +15,16 @@ Gem::Specification.new { |s|
 This project bundles together some custom bindings and code to the
 official (upstream) ruby-libui interface. ruby-libui, in turn,
 makes available code written in the libui project. You can find
-the libui project here: https://github.com/andlabs/libui
-and the ruby-libui bindings maintained by kojix2 here:
-https://rubygems.org/gems/libui
+the libui project here: https://github.com/andlabs/libui and 
+the ruby-libui bindings maintained by kojix2 here:
+
+  https://rubygems.org/gems/libui
 
 For more documentation about the libui_paradise gem, please have a look
 at the official homepage of this gem at rubygems.org, at its
 documentation/ link on the bottom right hand side (or just use
 this link directly:
-https://www.rubydoc.info/gems/libui_paradise/
+  https://www.rubydoc.info/gems/libui_paradise/
 )
 
   EOF

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: libui_paradise
 version: !ruby/object:Gem::Version
-  version: 0.2.49
+  version: 0.3.9
 platform: ruby
 authors:
 - Robert A. Heiler
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-10-09 00:00:00.000000000 Z
+date: 2023-12-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: libui
@@ -24,28 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: |2+
-
-  This project bundles together some custom bindings and code to the
-  official (upstream) ruby-libui interface. ruby-libui, in turn,
-  makes available code written in the libui project. You can find
-  the libui project here: https://github.com/andlabs/libui
-  and the ruby-libui bindings maintained by kojix2 here:
-  https://rubygems.org/gems/libui
-
-  For more documentation about the libui_paradise gem, please have a look
-  at the official homepage of this gem at rubygems.org, at its
-  documentation/ link on the bottom right hand side (or just use
-  this link directly:
-  https://www.rubydoc.info/gems/libui_paradise/
-  )
-
+description: "\nThis project bundles together some custom bindings and code to the\nofficial
+  (upstream) ruby-libui interface. ruby-libui, in turn,\nmakes available code written
+  in the libui project. You can find\nthe libui project here: https://github.com/andlabs/libui
+  and \nthe ruby-libui bindings maintained by kojix2 here:\n\n  https://rubygems.org/gems/libui\n\nFor
+  more documentation about the libui_paradise gem, please have a look\nat the official
+  homepage of this gem at rubygems.org, at its\ndocumentation/ link on the bottom
+  right hand side (or just use\nthis link directly:\n  https://www.rubydoc.info/gems/libui_paradise/\n)\n\n"
 email: shevy@inbox.lt
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - README.md
+- bin/libui_message
 - doc/README.gen
 - doc/SNIPPETS.md
 - doc/todo/todo.md
@@ -98,13 +90,14 @@ files:
 - lib/libui_paradise/examples/simple/007_control_gallery.rb
 - lib/libui_paradise/examples/simple/008_basic_area_example.rb
 - lib/libui_paradise/examples/simple/009_spectrum.rb
+- lib/libui_paradise/examples/simple/010_font_button.rb
+- lib/libui_paradise/examples/simple/011_simple_notepad.rb
+- lib/libui_paradise/examples/simple/012_table_example.rb
 - lib/libui_paradise/examples/simple/README.md
 - lib/libui_paradise/experimental/dsl.rb
-- lib/libui_paradise/extensions/counters.rb
 - lib/libui_paradise/extensions/extensions.rb
-- lib/libui_paradise/extensions/hash_fiddle_pointer_widgets.rb
-- lib/libui_paradise/extensions/misc.rb
-- lib/libui_paradise/fiddle/pointer.rb
+- lib/libui_paradise/extensions/toplevel_counters.rb
+- lib/libui_paradise/fiddle/fiddle.rb
 - lib/libui_paradise/generic_window/README.md
 - lib/libui_paradise/generic_window/generic_window.rb
 - lib/libui_paradise/images/LIBUI_PARADISE_LOGO.png
@@ -118,7 +111,6 @@ files:
 - lib/libui_paradise/prototype/prototype.rb
 - lib/libui_paradise/requires/require_the_libui_classes.rb
 - lib/libui_paradise/requires/require_the_libui_paradise_project.rb
-- lib/libui_paradise/toplevel_methods/misc.rb
 - lib/libui_paradise/version/version.rb
 - libui_paradise.gemspec
 - test/testing_generic_window.rb
@@ -139,18 +131,17 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.3.7
+      version: 3.4.22
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.4.22
 signing_key:
 specification_version: 4
 summary: 'This project bundles together some custom bindings and code to the official
   (upstream) ruby-libui interface. ruby-libui, in turn, makes available code written
   in the libui project. You can find the libui project here: https://github.com/andlabs/libui
-  and the ruby-libui bindings maintained by kojix2 here: https://rubygems.org/gems/libui  For
+  and  the ruby-libui bindings maintained by kojix2 here:  https://rubygems.org/gems/libui  For
   more documentation about the libui_paradise gem, please have a look at the official
   homepage of this gem at rubygems.org, at its documentation/ link on the bottom right
   hand side (or just use this link directly: https://www.rubydoc.info/gems/libui_paradise/
   )'
 test_files: []
-...

data/lib/libui_paradise/extensions/counters.rb

@@ -1,58 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'libui_paradise/extensions/counters.rb
-# =========================================================================== #
-module LibuiParadise
-
-# =========================================================================== #
-# === @counter_left
-# =========================================================================== #
-@counter_left = 0
-
-# =========================================================================== #
-# === LibuiParadise.counter_left?
-# =========================================================================== #
-def self.counter_left?
-  @counter_left
-end; self.instance_eval { alias counter_left  counter_left? } # === LibuiParadise.counter_left
-     self.instance_eval { alias left_counter  counter_left? } # === LibuiParadise.left_counter
-     self.instance_eval { alias left_counter? counter_left? } # === LibuiParadise.left_counter?
-
-# =========================================================================== #
-# === LibuiParadise.counter_left=
-# =========================================================================== #
-def self.counter_left=(i = 1)
-  @counter_left = i
-end
-
-# =========================================================================== #
-# === @counter_top
-# =========================================================================== #
-@counter_top = 0
-
-# =========================================================================== #
-# === LibuiParadise.counter_top?
-# =========================================================================== #
-def self.counter_top?
-  @counter_top
-end; self.instance_eval { alias counter_top  counter_top? } # === LibuiParadise.counter_top
-     self.instance_eval { alias top_counter  counter_top? } # === LibuiParadise.top_counter
-     self.instance_eval { alias top_counter? counter_top? } # === LibuiParadise.top_counter?
-
-# =========================================================================== #
-# === LibuiParadise.counter_top=
-# =========================================================================== #
-def self.counter_top=(i = 1)
-  @counter_top = i
-end
-
-# =========================================================================== #
-# === LibuiParadise.counters?
-# =========================================================================== #
-def self.counters?
-  return [@counter_left, @counter_top]
-end
-
-end

data/lib/libui_paradise/extensions/hash_fiddle_pointer_widgets.rb

@@ -1,150 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'libui_paradise/extensions/hash_fiddle_pointer_widgets.rb'
-# =========================================================================== #
-module LibuiParadise
-
-module Extensions # === LibuiParadise::Extensions
-
-  # ========================================================================= #
-  # === @hash_fiddle_pointer_widgets
-  #
-  # This hash will contain all widgets, via pointer.
-  # ========================================================================= #
-  @hash_fiddle_pointer_widgets = {}
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-  # ========================================================================= # 
-  def self.hash_fiddle_pointer_widgets?
-    @hash_fiddle_pointer_widgets
-  end
-
-  # ========================================================================= #
-  # === main_hash?
-  #
-  # Access the main hash defined above.
-  # ========================================================================= #
-  def main_hash?
-    ::LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-  end; alias toplevel_hash? main_hash? # === toplevel_hash?
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.register_this_fiddle_pointer_widget
-  #
-  # This method registers the particular widget in use.
-  #
-  # Every new_* method available via LibUI.new* that creates a new widget
-  # has to be registered via this method here, by calling it.
-  #
-  # That way we have a main Hash that contains lots of Fiddle::Pointers
-  # and we can, at a later time, modify these Fiddle::Pointer or call
-  # toplevel methods with these registered pointers. This will only
-  # work if we have registered these pointers, though, which is why
-  # each method that creates a new libui-widget has to make use of
-  # this method here.
-  #
-  # The only exception to the above rule is the main window. The
-  # main window is always stored in the @main_window variable instead.
-  #
-  # Perhaps it should also use the method here, but I found it simpler
-  # to just refer to it via @main_window or main_window?. (Note that
-  # in future releases of the libui_paradise gem, @main_window will
-  # probably be removed and integrated just like any other
-  # libui-widget. But this has not been done yet, so it is retained
-  # as-is right now.)
-  #
-  # The mandatory entries given to this method must be of the
-  # following format:
-  #
-  #   object_id -> [:the_fiddle_pointer_widget, :the_type]
-  #
-  # In other words, a key (as an Integer), and an Array as
-  # its primary value.
-  #
-  # The object_id will be determined automatically, so it can
-  # be omitted. It is the value that is simply returned by
-  # calling the .object_id method, so we do not have to do
-  # anything else here.
-  #
-  # The very last argument of the two-member Array should be a
-  # symbol, such as :grid. This is automatically ensured via a
-  # call to __method__ which returns a Symbol. That way we can
-  # then call the correct method internally, once we know we
-  # have a :grid or any other widget.
-  # ========================================================================= #
-  def self.register_this_fiddle_pointer_widget(
-      the_fiddle_pointer_widget,
-      the_type_of_the_widget = nil
-    )
-    # ======================================================================= #
-    # Determine the object-id automatically next:
-    # ======================================================================= #
-    object_id_to_use = the_fiddle_pointer_widget.object_id
-    # ======================================================================= #
-    # Then, store it on the main Hash.
-    # ======================================================================= #
-    @hash_fiddle_pointer_widgets[object_id_to_use] =
-      [
-        the_fiddle_pointer_widget,
-        the_type_of_the_widget
-      ]
-  end; self.instance_eval { alias add_to_the_registered_widgets register_this_fiddle_pointer_widget } # === LibuiParadise::Extensions.add_to_the_registered_widgets
-
-  # ========================================================================= #
-  # === LibuiParadise::Extensions.current_widget_pointer?
-  # ========================================================================= #
-  def self.current_widget_pointer?
-    LibuiParadise::Extensions.hash_fiddle_pointer_widgets?.values.last.first
-  end
-
-  # ========================================================================= #
-  # === last_pointer?
-  #
-  # This used to return the "current" widget pointer, but past September
-  # 2021 this is rarely in use anymore. Use current_widget_pointer? 
-  # instead, based on the main Hash that keeps all widgets registered.
-  # ========================================================================= #
-  def last_pointer?
-    LibuiParadise::Extensions.current_widget_pointer?
-  end; alias current_pointer?        last_pointer? # === current_pointer?
-       alias current_widget_pointer? last_pointer? # === current_widget_pointer?
-
-  # ========================================================================= #
-  # === current_widget_pointer_type?
-  # ========================================================================= #
-  def current_widget_pointer_type?
-    LibuiParadise::Extensions.hash_fiddle_pointer_widgets?.values.last.last
-  end
-
-  # ========================================================================= #
-  # === register_this_fiddle_pointer_widget
-  # ========================================================================= #
-  def register_this_fiddle_pointer_widget(
-      the_fiddle_pointer_widget,
-      the_type_of_the_widget = nil
-    )
-    ::LibuiParadise::Extensions.register_this_fiddle_pointer_widget(
-      the_fiddle_pointer_widget,
-      the_type_of_the_widget
-    )
-  end; alias add_to_the_registered_widgets register_this_fiddle_pointer_widget # === add_to_the_registered_widgets
-
-end
-
-# ========================================================================= #
-# === LibuiParadise.register_this_fiddle_pointer_widget
-# ========================================================================= #
-def self.register_this_fiddle_pointer_widget(
-    the_fiddle_pointer_widget,
-    the_type_of_the_widget = nil
-  )
-  ::LibuiParadise::Extensions.register_this_fiddle_pointer_widget(
-    the_fiddle_pointer_widget,
-    the_type_of_the_widget
-  )
-end; self.instance_eval { alias add_to_the_registered_widgets register_this_fiddle_pointer_widget } # === LibuiParadise.add_to_the_registered_widgets
-
-end