glimmer-dsl-libui 0.5.13 → 0.5.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ec966c5f1dcd6315fe94455e2a8257df7ed6274ada0d74419e53b9abeab99bb
-  data.tar.gz: 5f1f410e8a239735c1188d4a7bdad00f9fed6e34ba71ba5c2ac65f01b8f49037
+  metadata.gz: 99ed9eb0a65da64d13717cf3f967ceadc36c4a0eed74fcbb385bd5d19c812db2
+  data.tar.gz: f24060ff8ef38a93c1f3174d3e01102d61d2c0c8d8466b1e0d32fedc8972c9ea
 SHA512:
-  metadata.gz: 574718284c8933f27d088777e9ffd77a37922f3f51ec90e85026f1d86f572c84bea4d86141fc3b67bb5192769ac03e13dca791b3ce6b8d2ae88235008ba4cbcf
-  data.tar.gz: 87656800ed048be0ffc15520e5988b911fac60bcdb73db16fd962e5820d2d2c948a08a14c1c22aaef4543623d8f2c803c7d10e0c106bc40c13942bddaf83cfda
+  metadata.gz: def5540396a5cffc5f1271d3bb2664d008cf26db2f88207dc75bc23fa9915a2badfa45db8778e59644c99cbb0753147361556de25d118acd51e2dc211abd4bc8
+  data.tar.gz: 30ac47a92b4439aca5f3bc244514b400f810d8a9c855f64acf924544b448647d0d573d5218bc2e515ceb7bb469978b1e3e754d74d3ff86aea0b7d7247ee0e433

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Change Log
 
+## 0.5.16
+
+- `refined_table` custom control that renders a `table` with filtering and pagination, thus being able to handle a large data set (e.g. 50,000)
+- New examples/paginated_refined_table.rb
+
+## 0.5.15
+
+- Fix an issue with rendering table content changes when the number of rows changes with new content that is not a subset of the old content or a container of it
+
+## 0.5.14
+
+- Basic Child Window example
+- Modify default window closing behavior to autodetect if the window is a child window (not the main window), and if closed, ensure that does not quit the app.
+- Accept `true` and `false` as return values for `on_closing` window listener as aliases to `1` and `0`
+
 ## 0.5.13
 
 - Fix issue with rendering table content changes when having many rows

data/README.md

@@ -1,4 +1,4 @@
-# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.5.13
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.5.16
 ## Prerequisite-Free Ruby Desktop Development GUI Library
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-libui.svg)](http://badge.fury.io/rb/glimmer-dsl-libui)
 [![Join the chat at https://gitter.im/AndyObtiva/glimmer](https://badges.gitter.im/AndyObtiva/glimmer.svg)](https://gitter.im/AndyObtiva/glimmer?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
@@ -385,6 +385,7 @@ DSL | Platforms | Native? | Vector Graphics? | Pros | Cons | Prereqs
   - [Examples](#examples)
     - [Basic Examples](#basic-examples)
       - [Basic Window](#basic-window)
+      - [Basic Child Window](#basic-child-window)
       - [Basic Button](#basic-button)
       - [Basic Entry](#basic-entry)
       - [Simple Notepad](#simple-notepad)
@@ -417,6 +418,7 @@ DSL | Platforms | Native? | Vector Graphics? | Pros | Cons | Prereqs
       - [Editable Column Table](#editable-column-table)
       - [Editable Table](#editable-table)
       - [Form Table](#form-table)
+      - [Paginated Refined Table](#paginated-refined-table)
       - [Grid](#grid)
       - [Histogram](#histogram)
       - [Login](#login)
@@ -435,6 +437,7 @@ DSL | Platforms | Native? | Vector Graphics? | Pros | Cons | Prereqs
     - [i3off Gtk Ruby](#i3off-gtk-ruby)
     - [Chess](#chess)
     - [RubyCrumbler](#rubycrumbler)
+    - [Rubio-Radio](#rubio-radio)
   - [Process](#process)
   - [Resources](#resources)
   - [Help](#help)
@@ -581,7 +584,7 @@ gem install glimmer-dsl-libui
 Or install via Bundler `Gemfile`:
 
 ```ruby
-gem 'glimmer-dsl-libui', '~> 0.5.13'
+gem 'glimmer-dsl-libui', '~> 0.5.16'
 ```
 
 Test that installation worked by running the [Meta-Example](#examples):
@@ -763,6 +766,7 @@ Keyword(Args) | Properties | Listeners
 `quit_menu_item` | None | `on_clicked`
 `radio_buttons` | `selected` (`Integer`) | `on_selected`
 `rectangle(x as Numeric, y as Numeric, width as Numeric, height as Numeric)` |  `x` (`Numeric`), `y` (`Numeric`), `width` (`Numeric`), `height` (`Numeric`) | None
+`refined_table` | (EARLY ALPHA UNSTABLE API / CHECK SOURCE CODE FOR DETAILS) | (EARLY ALPHA UNSTABLE API / CHECK SOURCE CODE FOR DETAILS)
 `scrolling_area(width = main_window.width, height = main_window.height)` | `auto_draw_enabled` (Boolean), `size` (`Array` of `width` (`Numeric`) and `height` (`Numeric`)), `width` (`Numeric`), `height` (`Numeric`) | `on_draw(area_draw_params)`, `on_mouse_event(area_mouse_event)`, `on_mouse_down(area_mouse_event)`, `on_mouse_up(area_mouse_event)`, `on_mouse_drag_started(area_mouse_event)`, `on_mouse_dragged(area_mouse_event)`, `on_mouse_dropped(area_mouse_event)`, `on_mouse_entered`, `on_mouse_exited`, `on_key_event(area_key_event)`, `on_key_down(area_key_event)`, `on_key_up(area_key_event)`
 `search_entry` | `read_only` (Boolean), `text` (`String`) | `on_changed`
 `separator_menu_item` | None | None
@@ -990,6 +994,40 @@ Mac | Windows | Linux
 
 Learn more by checking out [examples](#examples).
 
+#### Refined Table
+
+[EARLY ALPHA FEATURE]
+
+`refined_table` is a custom control provided exclusively by Glimmer DSL for LibUI that includes filtering and pagination support out of the box and can handle very large amounts of data (e.g. 50,000 rows).
+
+It is currently an early alpha feature, so please test-drive and report issues if you encounter any.
+
+Also, the API might undergo big changes, so please keep that in mind.
+
+Example code:
+
+```ruby
+refined_table(
+  model_array: contacts,
+  table_columns: {
+    'Name'  => {button: {on_clicked: ->(row) {puts row}}},
+    'Colored Email' => :text_color,
+    'Phone' => {text: {editable: true}},
+    'City'  => :text,
+    'State' => :text,
+  },
+  table_editable: true,
+  per_page: 20, # row count per page
+  page: 5, # initial page
+)
+```
+
+Mac | Windows | Linux
+----|---------|------
+![glimmer-dsl-libui-mac-paginated-refined-table.png](images/glimmer-dsl-libui-mac-paginated-refined-table.png)| ![glimmer-dsl-libui-windows-paginated-refined-table.png](images/glimmer-dsl-libui-windows-paginated-refined-table.png)| ![glimmer-dsl-libui-linux-paginated-refined-table.png](images/glimmer-dsl-libui-linux-paginated-refined-table.png)
+
+Learn more in the [Paginated Refined Table](#paginated-refined-table) example.
+
 ### Area API
 
 The `area` control is a canvas-like control for drawing paths that can be used in one of two ways:
@@ -1615,8 +1653,7 @@ SpinnerExample.new.launch
 - All controls nested under a `horizontal_box`, `vertical_box`, and `form` have `stretchy` property (fill maximum space) as `true` by default (passed to `box_append`/`form_append` method)
 - If an event listener is repeated under a control (e.g. two `on_clicked {}` listeners under `button`), it does not overwrite the previous listener, yet it is added to an `Array` of listeners for the event. [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) provides multiple-event-listener support unlike [LibUI](https://github.com/kojix2/LibUI)
 - `window` instatiation args can be left off, having the following defaults when unspecified: `title` as `''`, `width` as `190`, `height` as `150`, and `has_menubar` as `true`)
-- `window` has an `on_closing` listener by default that quits application upon hitting the close button (can be overridden with a manual `on_closing` implementation that returns integer `1` for closing and `0` for remaining open). When creating/showing a child window other than the main window and then closing it, the entire app closes by default unless you implement an `on_closing` listener on the secondary child window that returns `1` at the end.
-
+- `window` has an `on_closing` listener by default that quits application upon hitting close button if window is the main window, not a child window (the behavior can be overridden with a manual `on_closing` implementation that returns integer `1`/`true` for closing and `0`/`false` for remaining open).
 - `group` has `title` property default to `''` if not specified in instantiation args, so it can be instantiated without args with `title` property specified in nested block (e.g. `group {title 'Address'; ...}`)
 - `button`, `checkbox`, and `label` have `text` default to `''` if not specified in instantiation args, so they can be instantiated without args with `text` property specified in nested block (e.g. `button {text 'Greet'; on_clicked {puts 'Hello'}}`)
 - `quit_menu_item` has an `on_clicked` listener by default that quits application upon selecting the quit menu item (can be overridden with a manual `on_clicked` implementation that returns integer `0` for success)
@@ -1905,7 +1942,7 @@ Learn more from custom keyword usage in [Method-Based Custom Keyword](#method-ba
 
 The [Observer Design Pattern](https://en.wikipedia.org/wiki/Observer_pattern) (a.k.a. Observer Pattern) is fundamental to building GUIs (Graphical User Interfaces) following the [MVC (Model View Controller) Architectural Pattern](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller) or any of its variations like [MVP (Model View Presenter)](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93presenter). In the original Smalltalk-MVC, the View observes the Model for changes and updates itself accordingly.
 
-![MVC - Model View Controller](https://www.researchgate.net/profile/Danny-Weyns/publication/269303611/figure/fig2/AS:858133056462866@1581606272800/Smalltalk80-MVC-pattern-View-and-Controller-work-as-a-pair-allowing-the-user-to-interact.ppm)
+![MVC - Model View Controller](https://developer.mozilla.org/en-US/docs/Glossary/MVC/model-view-controller-light-blue.png)
 
 [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) supports the [Observer Design Pattern](https://en.wikipedia.org/wiki/Observer_pattern) via the `observe(model, attribute_or_key=nil)` keyword, which can observe `Object` models with attributes, `Hash`es with keys, and `Array`s. It automatically enhances objects as needed to support automatically notifying observers of changes via `observable#notify_observers(attribute_or_key = nil)` method:
 - `Object` becomes `Glimmer::DataBinding::ObservableModel`, which supports observing specified `Object` model attributes.
@@ -1936,7 +1973,7 @@ Data-binding automatically takes advantage of the [Observer Pattern](#observer-p
 
 Data-binding supports utilizing the [MVP (Model View Presenter)](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93presenter) flavor of [MVC](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller) by observing both the View and a Presenter for changes and updating the opposite side upon encountering them. This enables writing more decoupled cleaner code that keeps View code and Model code disentangled and highly maintainable. For example, check out the Snake game presenters for [Grid](/examples/snake/presenter/grid.rb) and [Cell](/examples/snake/presenter/cell.rb), which act as proxies for the actual Snake game models [Snake](/examples/snake/model/snake.rb) and [Apple](/examples/snake/model/apple.rb), mediating synchronization of data between them and the [Snake View GUI](/examples/snake.rb).
 
-![MVP](https://www.researchgate.net/profile/Gilles-Perrouin/publication/320249584/figure/fig8/AS:668260987068418@1536337243385/Model-view-presenter-architecture.png)
+![MVP](https://upload.wikimedia.org/wikipedia/commons/d/dc/Model_View_Presenter_GUI_Design_Pattern.png)
 
 #### Bidirectional (Two-Way) Data-Binding
 
@@ -2643,6 +2680,50 @@ window { # first 3 args can be set via properties with 4th arg has_menubar=true
 }.show
 ```
 
+#### Basic Child Window
+
+[examples/basic_child_window.rb](examples/basic_child_window.rb)
+
+Run with this command from the root of the project if you cloned the project:
+
+```
+ruby -r './lib/glimmer-dsl-libui' examples/basic_child_window.rb
+```
+
+Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui):
+
+```
+ruby -r glimmer-dsl-libui -e "require 'examples/basic_child_window.rb'"
+```
+
+Mac | Windows | Linux
+----|---------|------
+![glimmer-dsl-libui-mac-basic-child-window.png](images/glimmer-dsl-libui-mac-basic-child-window.png) ![glimmer-dsl-libui-mac-basic-child-window-open.png](images/glimmer-dsl-libui-mac-basic-child-window-open.png) | ![glimmer-dsl-libui-windows-basic-child-window.png](images/glimmer-dsl-libui-windows-basic-child-window.png) ![glimmer-dsl-libui-windows-basic-child-window-open.png](images/glimmer-dsl-libui-windows-basic-child-window-open.png) | ![glimmer-dsl-libui-linux-basic-child-window.png](images/glimmer-dsl-libui-linux-basic-child-window.png) ![glimmer-dsl-libui-linux-basic-child-window-open.png](images/glimmer-dsl-libui-linux-basic-child-window-open.png)
+
+New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+
+```ruby
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('Main Window') {
+  button('Spawn Child Window') {
+    on_clicked do
+      window('Child Window') {
+        on_closing do
+          puts 'Child window is closing'
+        end
+      }.show
+    end
+  }
+  
+  on_closing do
+    puts 'Main window is closing'
+  end
+}.show
+```
+
 #### Basic Button
 
 [examples/basic_button.rb](examples/basic_button.rb)
@@ -7934,6 +8015,273 @@ window('Contacts', 600, 600) {
 }.show
 ```
 
+#### Paginated Refined Table
+
+[examples/paginated_refined_table.rb](examples/paginated_refined_table.rb)
+
+Run with this command from the root of the project if you cloned the project:
+
+```
+ruby -r './lib/glimmer-dsl-libui' examples/paginated_refined_table.rb
+```
+
+Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui):
+
+```
+ruby -r glimmer-dsl-libui -e "require 'examples/paginated_refined_table'"
+```
+
+Mac | Windows | Linux
+----|---------|------
+![glimmer-dsl-libui-mac-paginated-refined-table.png](images/glimmer-dsl-libui-mac-paginated-refined-table.png)| ![glimmer-dsl-libui-windows-paginated-refined-table.png](images/glimmer-dsl-libui-windows-paginated-refined-table.png)| ![glimmer-dsl-libui-linux-paginated-refined-table.png](images/glimmer-dsl-libui-linux-paginated-refined-table.png)
+
+New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+
+```ruby
+require 'glimmer-dsl-libui'
+
+class PaginatedRefinedTable
+  Contact = Struct.new(:name, :email, :phone, :city, :state)
+  
+  include Glimmer::LibUI::Application
+  
+  NAMES_FIRST = %w[
+    Liam
+    Noah
+    William
+    James
+    Oliver
+    Benjamin
+    Elijah
+    Lucas
+    Mason
+    Logan
+    Alexander
+    Ethan
+    Jacob
+    Michael
+    Daniel
+    Henry
+    Jackson
+    Sebastian
+    Aiden
+    Matthew
+    Samuel
+    David
+    Joseph
+    Carter
+    Owen
+    Wyatt
+    John
+    Jack
+    Luke
+    Jayden
+    Dylan
+    Grayson
+    Levi
+    Isaac
+    Gabriel
+    Julian
+    Mateo
+    Anthony
+    Jaxon
+    Lincoln
+    Joshua
+    Christopher
+    Andrew
+    Theodore
+    Caleb
+    Ryan
+    Asher
+    Nathan
+    Thomas
+    Leo
+    Isaiah
+    Charles
+    Josiah
+    Hudson
+    Christian
+    Hunter
+    Connor
+    Eli
+    Ezra
+    Aaron
+    Landon
+    Adrian
+    Jonathan
+    Nolan
+    Jeremiah
+    Easton
+    Elias
+    Colton
+    Cameron
+    Carson
+    Robert
+    Angel
+    Maverick
+    Nicholas
+    Dominic
+    Jaxson
+    Greyson
+    Adam
+    Ian
+    Austin
+    Santiago
+    Jordan
+    Cooper
+    Brayden
+    Roman
+    Evan
+    Ezekiel
+    Xaviar
+    Jose
+    Jace
+    Jameson
+    Leonardo
+    Axel
+    Everett
+    Kayden
+    Miles
+    Sawyer
+    Jason
+    Emma
+    Olivia
+    Bartholomew
+    Corey
+    Danielle
+    Eva
+    Felicity
+  ]
+  
+  NAMES_LAST = %w[
+    Smith
+    Johnson
+    Williams
+    Brown
+    Jones
+    Miller
+    Davis
+    Wilson
+    Anderson
+    Taylor
+    George
+    Harrington
+    Iverson
+    Jackson
+    Korby
+    Levinson
+  ]
+  
+  CITIES = [
+    'Bellesville',
+    'Lombardia',
+    'Steepleton',
+    'Deerenstein',
+    'Schwartz',
+    'Hollandia',
+    'Saint Pete',
+    'Grandville',
+    'London',
+    'Berlin',
+    'Elktown',
+    'Paris',
+    'Garrison',
+    'Muncy',
+    'St Louis',
+  ]
+  
+  STATES = [ 'AK', 'AL', 'AR', 'AZ', 'CA', 'CO', 'CT', 'DC', 'DE', 'FL', 'GA',
+             'HI', 'IA', 'ID', 'IL', 'IN', 'KS', 'KY', 'LA', 'MA', 'MD', 'ME',
+             'MI', 'MN', 'MO', 'MS', 'MT', 'NC', 'ND', 'NE', 'NH', 'NJ', 'NM',
+             'NV', 'NY', 'OH', 'OK', 'OR', 'PA', 'RI', 'SC', 'SD', 'TN', 'TX',
+             'UT', 'VA', 'VT', 'WA', 'WI', 'WV', 'WY']
+             
+  attr_accessor :contacts, :name, :email, :phone, :city, :state, :filter_value, :index
+  
+  before_body do
+    @contacts = 50_000.times.map do |n|
+      n += 1
+      first_name = NAMES_FIRST.sample
+      last_name = NAMES_LAST.sample
+      city = CITIES.sample
+      state = STATES.sample
+      Contact.new("#{first_name} #{last_name}", "#{first_name.downcase}#{n}@#{last_name.downcase}.com", '555-555-5555', city, state)
+    end
+  end
+  
+  body {
+    window("50,000 Paginated Contacts", 600, 700) {
+      margined true
+      
+      vertical_box {
+        form {
+          stretchy false
+          
+          entry {
+            label 'Name'
+            text <=> [self, :name] # bidirectional data-binding between entry text and self.name
+          }
+          
+          entry {
+            label 'Email'
+            text <=> [self, :email]
+          }
+          
+          entry {
+            label 'Phone'
+            text <=> [self, :phone]
+          }
+          
+          entry {
+            label 'City'
+            text <=> [self, :city]
+          }
+          
+          entry {
+            label 'State'
+            text <=> [self, :state]
+          }
+        }
+        
+        button('Save Contact') {
+          stretchy false
+          
+          on_clicked do
+            new_row = [name, email, phone, city, state]
+            if new_row.map(&:to_s).include?('')
+              msg_box_error('Validation Error!', 'All fields are required! Please make sure to enter a value for all fields.')
+            else
+              @contacts << Contact.new(*new_row) # automatically inserts a row into the table due to explicit data-binding
+              @unfiltered_contacts = @contacts.dup
+              self.name = '' # automatically clears name entry through explicit data-binding
+              self.email = ''
+              self.phone = ''
+              self.city = ''
+              self.state = ''
+            end
+          end
+        }
+        
+        refined_table(
+          model_array: contacts,
+          table_columns: {
+            'Name'  => :text,
+            'Email' => :text,
+            'Phone' => :text,
+            'City'  => :text,
+            'State' => :text,
+          },
+          table_editable: true,
+          per_page: 20,
+        )
+      }
+    }
+  }
+end
+
+PaginatedRefinedTable.launch
+```
+
 #### Grid
 
 [examples/grid.rb](examples/grid.rb)
@@ -11239,6 +11587,12 @@ MacOS | Windows | Linux
 | :---: | :---: | :---:
 ![mac_31](https://user-images.githubusercontent.com/72874215/159339948-b7ae1bf2-60c1-4dae-ac1a-4e13a6048ef0.gif)|![windows_4](https://user-images.githubusercontent.com/72874215/160242473-c38439be-0955-4e89-9f3f-b3d0567531fd.gif)|![rubycrumbler_linux](https://user-images.githubusercontent.com/72874215/160242460-99af1c8c-b43f-458d-bd69-1274a0bd9814.gif)
 
+### Rubio-Radio
+
+https://github.com/kojix2/rubio-radio
+
+![rubio radio screenshot](https://user-images.githubusercontent.com/5798442/171986696-24bedc38-3811-4c62-a5ad-89c09d015c8a.png)
+
 ## Process
 
 [Glimmer Process](https://github.com/AndyObtiva/glimmer/blob/master/PROCESS.md)

data/VERSION

@@ -1 +1 @@
-0.5.13
+0.5.16

data/examples/basic_child_window.rb

@@ -0,0 +1,19 @@
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('Main Window') {
+  button('Spawn Child Window') {
+    on_clicked do
+      window('Child Window') {
+        on_closing do
+          puts 'Child window is closing'
+        end
+      }.show
+    end
+  }
+  
+  on_closing do
+    puts 'Main window is closing'
+  end
+}.show

data/examples/paginated_refined_table.rb

@@ -0,0 +1,242 @@
+require 'glimmer-dsl-libui'
+
+class PaginatedRefinedTable
+  Contact = Struct.new(:name, :email, :phone, :city, :state)
+  
+  include Glimmer::LibUI::Application
+  
+  NAMES_FIRST = %w[
+    Liam
+    Noah
+    William
+    James
+    Oliver
+    Benjamin
+    Elijah
+    Lucas
+    Mason
+    Logan
+    Alexander
+    Ethan
+    Jacob
+    Michael
+    Daniel
+    Henry
+    Jackson
+    Sebastian
+    Aiden
+    Matthew
+    Samuel
+    David
+    Joseph
+    Carter
+    Owen
+    Wyatt
+    John
+    Jack
+    Luke
+    Jayden
+    Dylan
+    Grayson
+    Levi
+    Isaac
+    Gabriel
+    Julian
+    Mateo
+    Anthony
+    Jaxon
+    Lincoln
+    Joshua
+    Christopher
+    Andrew
+    Theodore
+    Caleb
+    Ryan
+    Asher
+    Nathan
+    Thomas
+    Leo
+    Isaiah
+    Charles
+    Josiah
+    Hudson
+    Christian
+    Hunter
+    Connor
+    Eli
+    Ezra
+    Aaron
+    Landon
+    Adrian
+    Jonathan
+    Nolan
+    Jeremiah
+    Easton
+    Elias
+    Colton
+    Cameron
+    Carson
+    Robert
+    Angel
+    Maverick
+    Nicholas
+    Dominic
+    Jaxson
+    Greyson
+    Adam
+    Ian
+    Austin
+    Santiago
+    Jordan
+    Cooper
+    Brayden
+    Roman
+    Evan
+    Ezekiel
+    Xaviar
+    Jose
+    Jace
+    Jameson
+    Leonardo
+    Axel
+    Everett
+    Kayden
+    Miles
+    Sawyer
+    Jason
+    Emma
+    Olivia
+    Bartholomew
+    Corey
+    Danielle
+    Eva
+    Felicity
+  ]
+  
+  NAMES_LAST = %w[
+    Smith
+    Johnson
+    Williams
+    Brown
+    Jones
+    Miller
+    Davis
+    Wilson
+    Anderson
+    Taylor
+    George
+    Harrington
+    Iverson
+    Jackson
+    Korby
+    Levinson
+  ]
+  
+  CITIES = [
+    'Bellesville',
+    'Lombardia',
+    'Steepleton',
+    'Deerenstein',
+    'Schwartz',
+    'Hollandia',
+    'Saint Pete',
+    'Grandville',
+    'London',
+    'Berlin',
+    'Elktown',
+    'Paris',
+    'Garrison',
+    'Muncy',
+    'St Louis',
+  ]
+  
+  STATES = [ 'AK', 'AL', 'AR', 'AZ', 'CA', 'CO', 'CT', 'DC', 'DE', 'FL', 'GA',
+             'HI', 'IA', 'ID', 'IL', 'IN', 'KS', 'KY', 'LA', 'MA', 'MD', 'ME',
+             'MI', 'MN', 'MO', 'MS', 'MT', 'NC', 'ND', 'NE', 'NH', 'NJ', 'NM',
+             'NV', 'NY', 'OH', 'OK', 'OR', 'PA', 'RI', 'SC', 'SD', 'TN', 'TX',
+             'UT', 'VA', 'VT', 'WA', 'WI', 'WV', 'WY']
+             
+  attr_accessor :contacts, :name, :email, :phone, :city, :state, :filter_value, :index
+  
+  before_body do
+    @contacts = 50_000.times.map do |n|
+      n += 1
+      first_name = NAMES_FIRST.sample
+      last_name = NAMES_LAST.sample
+      city = CITIES.sample
+      state = STATES.sample
+      Contact.new("#{first_name} #{last_name}", "#{first_name.downcase}#{n}@#{last_name.downcase}.com", '555-555-5555', city, state)
+    end
+  end
+  
+  body {
+    window("50,000 Paginated Contacts", 600, 700) {
+      margined true
+      
+      vertical_box {
+        form {
+          stretchy false
+          
+          entry {
+            label 'Name'
+            text <=> [self, :name] # bidirectional data-binding between entry text and self.name
+          }
+          
+          entry {
+            label 'Email'
+            text <=> [self, :email]
+          }
+          
+          entry {
+            label 'Phone'
+            text <=> [self, :phone]
+          }
+          
+          entry {
+            label 'City'
+            text <=> [self, :city]
+          }
+          
+          entry {
+            label 'State'
+            text <=> [self, :state]
+          }
+        }
+        
+        button('Save Contact') {
+          stretchy false
+          
+          on_clicked do
+            new_row = [name, email, phone, city, state]
+            if new_row.map(&:to_s).include?('')
+              msg_box_error('Validation Error!', 'All fields are required! Please make sure to enter a value for all fields.')
+            else
+              @contacts << Contact.new(*new_row) # automatically inserts a row into the table due to explicit data-binding
+              @unfiltered_contacts = @contacts.dup
+              self.name = '' # automatically clears name entry through explicit data-binding
+              self.email = ''
+              self.phone = ''
+              self.city = ''
+              self.state = ''
+            end
+          end
+        }
+        
+        refined_table(
+          model_array: contacts,
+          table_columns: {
+            'Name'  => {text: {editable: false}},
+            'Email' => :text,
+            'Phone' => :text,
+            'City'  => :text,
+            'State' => :text,
+          },
+          table_editable: true,
+          per_page: 20,
+        )
+      }
+    }
+  }
+end
+
+PaginatedRefinedTable.launch

data/lib/glimmer/libui/control_proxy/table_proxy.rb

@@ -129,7 +129,7 @@ module Glimmer
           model_attribute_observer = Glimmer::DataBinding::Observer.proc do
             new_value = model_binding.evaluate_property
             new_value = new_value.to_a if new_value.is_a?(Enumerator)
-            if model_binding.binding_options[:column_attributes] || (!new_value.empty? && !new_value.first.is_a?(Array))
+            if model_binding.binding_options[:column_attributes] || (!new_value.nil? && (!new_value.is_a?(String) || !new_value.empty?) && (!new_value.is_a?(Array) || !new_value.first.is_a?(Array)))
               @model_attribute_array_observer_registration&.deregister
               @model_attribute_array_observer_registration = model_attribute_observer.observe(new_value, @column_attributes, ignore_frozen: true, attribute_writer_type: [:attribute=, :set_attribute])
               model_attribute_observer.add_dependent(model_attribute_observer_registration => @model_attribute_array_observer_registration)
@@ -302,34 +302,38 @@ module Glimmer
         
         def register_cell_rows_observer
           @cell_rows_observer = Glimmer::DataBinding::Observer.proc do |new_cell_rows|
-            if @cell_rows.size < @last_cell_rows.size && @last_cell_rows.include_all?(*@cell_rows)
+            if @cell_rows.size < @last_cell_rows.size
               @last_cell_rows.each_with_index do |old_row_data, row|
-                if old_row_data != @cell_rows[row]
-                  ::LibUI.table_model_row_changed(model, row) if model && row
+                if old_row_data != @cell_rows[row] && model
+                  ::LibUI.table_model_row_changed(model, row)
                   notify_custom_listeners('on_changed', row, :changed, @cell_rows[row])
                 end
               end
               (@last_cell_rows.size - @cell_rows.size).times do |n|
                 row = @last_cell_rows.size - n - 1
-                ::LibUI.table_model_row_deleted(model, row) if model && row
-                notify_custom_listeners('on_changed', row, :deleted, @last_cell_rows[row])
+                if model
+                  ::LibUI.table_model_row_deleted(model, row)
+                  notify_custom_listeners('on_changed', row, :deleted, @last_cell_rows[row])
+                end
               end
-            elsif @cell_rows.size > @last_cell_rows.size && @cell_rows.include_all?(*@last_cell_rows)
+            elsif @cell_rows.size > @last_cell_rows.size
               (@cell_rows.size - @last_cell_rows.size).times do |n|
                 row = @last_cell_rows.size + n
-                ::LibUI.table_model_row_inserted(model, row) if model && row
-                notify_custom_listeners('on_changed', row, :inserted, @cell_rows[row])
+                if model
+                  ::LibUI.table_model_row_inserted(model, row)
+                  notify_custom_listeners('on_changed', row, :inserted, @cell_rows[row])
+                end
               end
               @cell_rows.each_with_index do |new_row_data, row|
-                if new_row_data != @last_cell_rows[row]
-                  ::LibUI.table_model_row_changed(model, row) if model && row
+                if new_row_data != @last_cell_rows[row] && model
+                  ::LibUI.table_model_row_changed(model, row)
                   notify_custom_listeners('on_changed', row, :changed, @cell_rows[row])
                 end
               end
             elsif @cell_rows != @last_cell_rows
               @cell_rows.each_with_index do |new_row_data, row|
-                if new_row_data != @last_cell_rows[row]
-                  ::LibUI.table_model_row_changed(model, row) if model && row
+                if new_row_data != @last_cell_rows[row] && model
+                  ::LibUI.table_model_row_changed(model, row)
                   notify_custom_listeners('on_changed', row, :changed, @cell_rows[row])
                 end
               end

data/lib/glimmer/libui/control_proxy/window_proxy.rb

@@ -80,10 +80,14 @@ module Glimmer
               return_value = nil
               @on_closing_listeners.each do |l|
                 return_value = l.call(self)
-                break if return_value.is_a?(Numeric)
+                break if return_value.is_a?(Numeric) || return_value.is_a?(TrueClass) || return_value.is_a?(FalseClass)
               end
               if return_value.is_a?(Numeric)
                 return_value
+              elsif return_value.is_a?(TrueClass) || return_value.is_a?(FalseClass)
+                return_value ? 1 : 0
+              elsif self != ControlProxy.main_window_proxy
+                1
               else
                 destroy
                 ::LibUI.quit

data/lib/glimmer/libui/custom_control/refined_table.rb

@@ -0,0 +1,153 @@
+class RefinedTable
+  include Glimmer::LibUI::CustomControl
+  
+  option :model_array, default: []
+  option :table_columns, default: []
+  option :table_editable, default: false
+  option :per_page, default: 10
+  option :page, default: 1
+  
+  attr_accessor :filtered_model_array, :filter_query, :filter_query_page_stack, :paginated_model_array
+  
+  before_body do
+    @filter_query = ''
+    @filter_query_page_stack = {}
+    @filtered_model_array = model_array.dup
+    @filtered_model_array_stack = {@filter_query => @filtered_model_array}
+    paginate_model_array
+  end
+  
+  body {
+    vertical_box {
+      table_filter
+
+      table_paginator
+      
+      @table = table {
+        table_columns.each do |column_name, column_details|
+          editable_value = on_clicked_value = nil
+          if column_details.is_a?(Symbol) || column_details.is_a?(String)
+            column_type = column_details
+          elsif column_details.is_a?(Hash)
+            column_type = column_details.keys.first
+            editable_value = column_details.values.first[:editable] || column_details.values.first['editable']
+            on_clicked_value = column_details.values.first[:on_clicked] || column_details.values.first['on_clicked']
+          end
+          
+          send("#{column_type}_column", column_name) {
+            editable editable_value unless editable_value.nil?
+            on_clicked(&on_clicked_value) unless on_clicked_value.nil?
+          }
+        end
+  
+        editable table_editable
+        cell_rows <=> [self, :paginated_model_array]
+      }
+    }
+  }
+  
+  def table_filter
+    search_entry {
+      stretchy false
+      text <=> [self, :filter_query,
+        before_write: ->(new_filter_query) {
+          if new_filter_query != filter_query
+            if !@filtered_model_array_stack.key?(new_filter_query)
+              @filtered_model_array_stack[new_filter_query] = model_array.dup.filter do |model|
+                @table.expand([model])[0].any? do |attribute_value|
+                  attribute_value.to_s.downcase.include?(new_filter_query.downcase)
+                end
+              end
+            end
+            @filtered_model_array = @filtered_model_array_stack[new_filter_query]
+            if new_filter_query.size > filter_query.size
+              @filter_query_page_stack[filter_query] = page
+            end
+            self.page = @filter_query_page_stack[new_filter_query] || correct_page(page)
+            paginate_model_array
+          end
+        }
+      ]
+    }
+  end
+  
+  def table_paginator
+    horizontal_box {
+      stretchy false
+
+      button('<<') {
+        on_clicked do
+          unless self.page == 0
+            self.page = 1
+            paginate_model_array
+          end
+        end
+      }
+      button('<') {
+        on_clicked do
+          unless self.page == 0
+            self.page = [page - 1, 1].max
+            paginate_model_array
+          end
+        end
+      }
+      entry {
+        text <=> [self, :page,
+                  on_read: :to_s,
+                  on_write: ->(val) { correct_page(val.to_i) },
+                  after_write: ->(val) { paginate_model_array },
+                 ]
+      }
+      button('>') {
+        on_clicked do
+          unless self.page == 0
+            self.page = [page + 1, page_count].min
+            paginate_model_array
+          end
+        end
+      }
+      button('>>') {
+        on_clicked do
+          unless self.page == 0
+            self.page = page_count
+            paginate_model_array
+          end
+        end
+      }
+    }
+  end
+  
+  def paginate_model_array
+    self.paginated_model_array = filtered_model_array[index, limit]
+  end
+  
+  def index
+    [per_page * (page - 1), 0].max
+  end
+  
+  def limit
+    [(filtered_model_array.count - index), per_page].min
+  end
+  
+  def page_count
+    (filtered_model_array.count.to_f / per_page.to_f).ceil
+  end
+  
+  def correct_page(page)
+    [[page, 1].max, page_count].min
+  end
+  
+  # Ensure proxying properties to @table if body_root (vertical_box) doesn't support them
+  
+  def respond_to?(method_name, *args, &block)
+    super || @table&.respond_to?(method_name, *args, &block)
+  end
+  
+  def method_missing(method_name, *args, &block)
+    if @table&.respond_to?(method_name, *args, &block)
+      @table&.send(method_name, *args, &block)
+    else
+      super
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-libui
 version: !ruby/object:Gem::Version
-  version: 0.5.13
+  version: 0.5.16
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-06-17 00:00:00.000000000 Z
+date: 2022-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: glimmer
@@ -285,6 +285,7 @@ files:
 - examples/basic_area3.rb
 - examples/basic_area4.rb
 - examples/basic_button.rb
+- examples/basic_child_window.rb
 - examples/basic_code_area.rb
 - examples/basic_draw_text.rb
 - examples/basic_draw_text2.rb
@@ -355,6 +356,7 @@ files:
 - examples/midi_player.rb
 - examples/midi_player2.rb
 - examples/midi_player3.rb
+- examples/paginated_refined_table.rb
 - examples/shape_coloring.rb
 - examples/simple_notepad.rb
 - examples/snake.rb
@@ -468,6 +470,7 @@ files:
 - lib/glimmer/libui/control_proxy/window_proxy.rb
 - lib/glimmer/libui/custom_control.rb
 - lib/glimmer/libui/custom_control/code_area.rb
+- lib/glimmer/libui/custom_control/refined_table.rb
 - lib/glimmer/libui/custom_window.rb
 - lib/glimmer/libui/data_bindable.rb
 - lib/glimmer/libui/image_path_renderer.rb
@@ -511,7 +514,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.3
+rubygems_version: 3.3.16
 signing_key:
 specification_version: 4
 summary: Glimmer DSL for LibUI