glimmer-dsl-swt 4.24.3.0 → 4.24.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90fac650eedadc1e677e27563bda759e5aa1ea7b2d5b6627129f906516c21a82
-  data.tar.gz: 4098c6d271799034a18747154236426cde6c7b83eca4030d5d1292f8bc0f52e2
+  metadata.gz: 81eb61402ae45b2e3782b9c10dc6b0374e39fb7f74351d2ed940719fbd6e4ec3
+  data.tar.gz: dfa93b670ddc363dd2dc602920d5e24510202b179f7e7740ee8abc50fc91eee4
 SHA512:
-  metadata.gz: 97d0b7a8a715410c6772b4cbb8cd45052c5d0db5e3c7b6f78a62fd9d8f23536dc467727b4441e0585f339674e63d4f9c3e622cdaea04a968e80ffde5ea6ea5f6
-  data.tar.gz: 159d537c854c56d6502a8ed248f5b54fe76590a411d5013d5f40844dd816c1212e49692e42b882c7262267de859580491ce4c9f015972f4b0baaea5169a0dddd
+  metadata.gz: 46bee26330ce88284c85f263b0db58dda6dfb76cd2d2f37938c881f6567d74cd0a514565625a6c21da53b91e119fd31185dda8b22626e357fb79612e9013f6fe
+  data.tar.gz: '049762158e8e4015ec1a157edd148212078a106b753b9ad4f6111ab49746fe2934471382b4c5c20d9ee00a9abca8d8c22866c1c3ecd7aa733ccc5aeb28eb6c7b'

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Change Log
 
+## 4.24.4.0
+
+- Save `WidgetBinding` instances on `WidgetProxy` objects via `widget_bindings` attribute
+- Support specifying `@children_owner` in any custom widget for which adding children will not add them under the `body_root` (e.g. a composite wrapping a table will designate the table as the `@children_owner` for adding `table_column`s)
+- Add explicit `shell_proxy` method to `Glimmer::UI::CustomWidget` that delegates to `body_root` to avoid annoying false negative error every time that method is called
+- Optimize `table` data-binding performance for single-model update scenarios
+- Fix issue with data-binding a table as the body root of a custom widget when customizing column_attributes
+
+## 4.24.3.2
+
+- Have `table` data-binding infer model attribute names from column names by convention (no need to specify `column_properties`)
+- Support `table` data-binding `column_properties` mapping of column names to model attribute names via a `Hash`
+- Support `table` data-binding alias of `column_attributes` in place of `column_properties` because the word 'attribute' is more Ruby-idiomatic than 'property' in the Ruby world
+- Handle boundary condition of font height reaching 0 on repeated zoom out of `code_text`
+- Battleship Video Tutorial in Glimmer Meta-Sample
+
+## 4.24.3.1
+
+- `code_text` default behavior support of zoom in (CMD+= on Mac, CTRL+= on Win/Linux), zoom out (CMD+- on Mac, CTRL+- on Win/Linux), and restore original font height (CMD+0 on Mac, CTRL+0 on Win/Linux).
+
 ## 4.24.3.0
 
 - Support `table` `items` data-binding of table row cell `background`, `foreground`, `font`, `image` to model attributes by convention based on specified `column_properties` (e.g. for `column_properties` model `name` attribute, automatically assume model `name_background` provides `[r, g, b]` array of color)

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 SWT 4.24.3.0
+# [<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 SWT 4.24.4.0
 ## JRuby Desktop Development GUI Framework
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-swt.svg)](http://badge.fury.io/rb/glimmer-dsl-swt)
 [![Travis CI](https://travis-ci.com/AndyObtiva/glimmer-dsl-swt.svg?branch=master)](https://travis-ci.com/github/AndyObtiva/glimmer-dsl-swt)
@@ -21,7 +21,7 @@ Featured in JRuby Cookbook](http://shop.oreilly.com/product/9780596519650.do) an
 
 ![Eclipse SWT RCP NASA Mars Rover](/images/glimmer-eclipse-swt-rcp-nasa-mars-rover.png)
 
-[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.24.3.0 includes [SWT 4.24](https://download.eclipse.org/eclipse/downloads/drops4/R-4.24-202206070700/), which was released on June 7, 2022. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT.
+[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.24.4.0 includes [SWT 4.24](https://download.eclipse.org/eclipse/downloads/drops4/R-4.24-202206070700/), which was released on June 7, 2022. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT.
 
 **Starting in version 4.20.0.0, [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) comes with the new [***Shine***](/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#shine) syntax** for highly intuitive and visually expressive View/Model Attribute Mapping, relying on `<=>` for bidirectional (two-way) data-binding and `<=` for unidirectional (one-way) data-binding, providing an alternative to the `bind` keyword. That was [originally conceived back in 2007](https://andymaleh.blogspot.com/2007/12/data-shining-in-glimmer.html).
 
@@ -338,7 +338,7 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.24.3.0
+jgem install glimmer-dsl-swt -v 4.24.4.0
 ```
 
 `jgem` is JRuby's version of `gem` command.
@@ -366,7 +366,7 @@ Note: if you're using activerecord or activesupport, keep in mind that Glimmer u
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer-dsl-swt', '~> 4.24.3.0'
+gem 'glimmer-dsl-swt', '~> 4.24.4.0'
 ```
 
 And, then run:
@@ -389,7 +389,7 @@ glimmer
 ```
 
 ```
-Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.24.3.0
+Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.24.4.0
       
 Usage: glimmer [--bundler] [--pd] [--quiet] [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
 

data/VERSION

@@ -1 +1 @@
-4.24.3.0
+4.24.4.0

data/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md

@@ -54,9 +54,11 @@ This guide should help you get started with Glimmer DSL for SWT. For more advanc
     - [Combo](#combo)
     - [List](#list)
     - [Table](#table)
+      - [Table Item Properties](#table-item-properties)
       - [Table Selection](#table-selection)
       - [Table Editing](#table-editing)
       - [Table Sorting](#table-sorting)
+      - [Refined Table with Pagination](#refined-table-with-pagination)
     - [Tree](#tree)
     - [DateTime](#datetime)
   - [Observer](#observer)
@@ -3996,13 +3998,13 @@ You may learn more about Glimmer's data-binding syntax by reading the code under
 
 The SWT Tree widget renders a multi-column data table, such as a contact listing or a sales report.
 
-To data-bind a Table, you need the main model, the collection property, and the text display attribute for each table column.
+To data-bind a Table, you need the main model and the collection property. The text for each row cell will be inferred from column names as underscored model attributes. For example, for a column named "Full Name", it is assumed by convention that the model has a `full_name` attribute.
 
-This involves using the `bind` keyword mentioned above in addition to a special `column_properties` keyword that takes the table column text attribute methods.
+Data-binding involves using the `<=` operator (one-way data-binding) or `<=>` operator (two-way data-binding), and an optional `column_attributes` kwarg (alias: `column_properties`) that takes an array that maps table columns to model attributes or a hash that maps column name strings to model attributes.
 
-It assumes you have defined the table columns via `table_column` widget.
+It assumes you have already defined table columns via the `table_column` `table`-nested widget.
 
-Example:
+Example (automatically inferring table items' [rows'] model attributes by convention from column names):
 
 ```ruby
 shell {
@@ -4019,8 +4021,10 @@ shell {
       text "Adult"
       width 120
     }
-    items <=> [group, :people, column_properties: [:name, :age, :adult]]
+    
+    items <=> [group, :people]
     selection <=> [group, :selected_person]
+    
     on_mouse_up do |event|
       @table.edit_table_item(event.table_item, event.column_index)
     end
@@ -4028,15 +4032,71 @@ shell {
 }
 ```
 
-The code above includes two data-bindings:
-- Table `items`, which first bind to the model collection property (group.people), and then maps each column property (name, age, adult) for displaying each table item column.
-- Table `selection`, which binds the single table item selected by the user to the attribute denoted by the `bind` keyword (or binds multiple table items selected for a table with `:multi` SWT style)
+The code above includes two data-bindings and a listener:
+- Table `items`, which first data-binds to the model collection property (group.people), and then maps each column to a model attribute (name, age, adult) for displaying each table item column.
+- Table `selection`, which data-binds the single table item (row) selected by the user to the model attribute denoted by `<=>` (or data-binds multiple table items to a model attribute array value for a table with `:multi` SWT style)
 - The `on_mouse_up` event handler invokes `@table.edit_table_item(event.table_item, event.column_index)` to start edit mode on the clicked table item cell, and then saves or cancel depending on whether the user hits ENTER or ESC once done editing (or focus-out after either making a change or not making any changes.)
 
-Additionally, Table `items` data-binding automatically stores each node model unto the SWT TableItem object via `setData` method. This enables things like searchability.
+Example (specifying `column_attributes` explicitly because some diverge from column names):
+
+```ruby
+shell {
+  @table = table {
+    table_column {
+      text "Full Name"
+      width 120
+    }
+    table_column {
+      text "Age in Years"
+      width 120
+    }
+    table_column {
+      text "Adult"
+      width 120
+    }
+    
+    items <=> [group, :people, column_attributes: {'Full Name' => :name, 'Age in Years' => :age}]
+    selection <=> [group, :selected_person]
+    
+    on_mouse_up do |event|
+      @table.edit_table_item(event.table_item, event.column_index)
+    end
+  }
+}
+```
+
+Example (specifying `column_attributes` explicitly because all diverge from column names):
+
+```ruby
+shell {
+  @table = table {
+    table_column {
+      text "Full Name"
+      width 120
+    }
+    table_column {
+      text "Age in Years"
+      width 120
+    }
+    table_column {
+      text "Is Adult"
+      width 120
+    }
+    
+    items <=> [group, :people, column_attributes: [:name, :age, :adult]]
+    selection <=> [group, :selected_person]
+    
+    on_mouse_up do |event|
+      @table.edit_table_item(event.table_item, event.column_index)
+    end
+  }
+}
+```
+
+Additionally, Table `items` data-binding automatically stores each row model in the [SWT `TableItem`](https://help.eclipse.org/latest/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/widgets/TableItem.html) object representing it, by using the `set_data` method. This enables things like searchability.
 
-The table widget in Glimmer is represented by a subclass of `WidgetProxy` called `TableProxy`.
-TableProxy includes a `search` method that takes a block to look for a table item.
+The table widget in Glimmer is represented by a subclass of `Glimmer::SWT::WidgetProxy` called `Glimmer::SWT::TableProxy`.
+`Glimmer::SWT::TableProxy` includes a `search` method that takes a block to look for a table item.
 
 Example:
 
@@ -4044,18 +4104,21 @@ Example:
 found_array = @table.search { |table_item| table_item.getData == company.owner }
 ```
 
-This finds a person. The array is a Java array. This enables easy passing of it to SWT `Table#setSelection` method, which expects a Java array of `TableItem` objects.
+This finds a person. The array is a Java array. This enables easy passing of it to SWT `Table#setSelection` method, which expects a Java array of [`TableItem`](https://help.eclipse.org/latest/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/widgets/TableItem.html) objects.
 
 To edit a table, you must invoke `TableProxy#edit_selected_table_item(column_index, before_write: nil, after_write: nil, after_cancel: nil)` or `TableProxy#edit_table_item(table_item, column_index, before_write: nil, after_write: nil, after_cancel: nil)`.
 This automatically leverages the SWT TableEditor custom class behind the scenes, displaying a text widget to the user to change the selected or
 passed table item text into something else.
 It automatically persists the change to `items` data-bound model on ENTER/FOCUS-OUT or cancels on ESC/NO-CHANGE.
 
+Note that `table` is designed to expect about 100 rows only, not more than that, or otherwise it will not offer a user-friendly experience due to requiring users to scroll through a lot of data.
+If you need to display a table with more than 100 rows, then you need to employ pagination. That is already supported in the [Refined Table (`refined_table`)](#refined-table-with-pagination) custom widget documented below.
+
 ##### Table Item Properties
 
 When data-binding a `table`'s `items`, extra [`TableItem` properties](https://help.eclipse.org/latest/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/widgets/TableItem.html) are data-bound automatically by convention for `background` color, `foreground` color, `font`, and `image` if corresponding properties (attributes) are available on the model.
 
-That means that if `column_properties` were `[:name, :age, :adult]`, then the following [`TableItem` properties](https://help.eclipse.org/latest/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/widgets/TableItem.html) are also data-bound by convention:
+That means that if `column_attributes` were `[:name, :age, :adult]`, then the following [`TableItem` properties](https://help.eclipse.org/latest/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/widgets/TableItem.html) are also data-bound by convention:
 - `background` to `:name_background, :age_background, :adult_background` model attributes
 - `foreground` to `:name_foreground, :age_foreground, :adult_foreground` model attributes
 - `font` to `:name_font, :age_font, :adult_font` model attributes
@@ -4104,7 +4167,7 @@ shell {
       text "Adult"
       width 120
     }
-    items bind(group, :people), column_properties(:name, :age, :adult)
+    items <=> [group, :people]
     selection bind(group, :selected_person)
   }
 }
@@ -4131,7 +4194,7 @@ shell {
       width 120
       editor :checkbox
     }
-    items bind(group, :people), column_properties(:name, :age, :adult)
+    items <=> [group, :people]
     selection bind(group, :selected_person)
   }
 }
@@ -4170,7 +4233,7 @@ shell {
       # assume there is a `Person#industry_options` property method on the model to provide items to the `combo`
       editor :combo, :read_only # passes :ready_only SWT style to `combo` widget
     }
-    items bind(group, :people), column_properties(:formatted_date, :industry)
+    items <=> [group, :people, column_attributes: {'Date of Birth' => :formatted_date}]
     selection bind(group, :selected_person)
   }
 }
@@ -4229,7 +4292,7 @@ Example:
       sort { |d1, d2| d1.to_date <=> d2.to_date }
     }
     additional_sort_properties :project_name, :duration_in_hours, :name
-    items bind(Task, :list), column_properties(:name, :project_name, :duration, :priority, :start_date)
+    items <=> [Task, :list, column_attributes: [:name, :project_name, :duration, :priority, :start_date]]
     # ...
   }
 # ...
@@ -4242,7 +4305,52 @@ Here is an explanation of the example above:
 - Task Start Date table column has a custom sort comparator block
 - Additional (secondary) sort properties are applied when sorting by Task, Project, or Duration in the order specified
 
-`bind(model, :property, read_only_sort: true)` could be used with items to make sorting not propagate sorting changes to model.
+`<= [model, :property, read_only_sort: true]` could be used with items to make sorting not propagate sorting changes to model.
+
+##### Refined Table with Pagination
+
+**(ALPHA FEATURE)**
+
+`refined_table` is a custom widget that can handle very large amounts of data by applying pagination.
+
+Just use like a standard `table`, but data-bind models to a `model_array` property instead of `items`. `refined_table` will take care of the rest.
+
+Options:
+- `per_page` (default: `10`): specifies how many rows to display per page
+- `page` (default: `1` if table is filled and `0` otherwise): specifies initial page
+
+Note that currently `refined_table` only supports displaying a **read-only** table (meaning it can read updates from the model, but it cannot write back to the model through table editing cells).
+
+Example taken from [Hello, Refined Table!](/docs/reference/GLIMMER_SAMPLES.md#hello-refined-table):
+
+![hello refined table](/images/glimmer-hello-refined-table.png)
+
+```ruby
+      #... more code precedes
+      
+      refined_table(per_page: 20) {
+        table_column {
+          width 100
+          text 'Date'
+        }
+        table_column {
+          width 200
+          text 'Ballpark'
+        }
+        table_column {
+          width 150
+          text 'Home Team'
+        }
+        table_column {
+          width 150
+          text 'Away Team'
+        }
+        
+        model_array <= [@baseball_season, :games, column_attributes: {'Home Team' => :home_team_name, 'Away Team' => :away_team_name}]
+      }
+      
+      #...more code follows
+```
 
 #### Tree
 
@@ -4825,7 +4933,7 @@ You may see another example at the [Hello, Radio Group!](/docs/reference/GLIMMER
 
 ##### Code Text Custom Widget
 
-`code_text` is a Glimmer built-in custom widget that displays syntax highlighted code (e.g. Ruby/JavaScript/HTML code) for 204 languages (see [options](#code-text-options) for the full list) by automating customizations for the SWT [StyledText](https://help.eclipse.org/2020-09/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/custom/StyledText.html) widget.
+`code_text` is a Glimmer built-in custom widget that displays syntax highlighted code (e.g. Ruby/JavaScript/HTML code) for 204 languages (see [options](#code-text-options) for the full list) by automating customizations for the SWT [StyledText](https://help.eclipse.org/2020-09/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/custom/StyledText.html) widget, including ability to zoom font in and out, or restore original font height (more details below).
 
 To utilize, simply use `code_text` in place of the multi-line `text` and `styled_text` widgets. If you set the `code_text` `text` property value to multi-line code content (e.g. Ruby/JavaScript/HTML code), it automatically styles it with syntax highlighting.
 
@@ -5151,6 +5259,9 @@ This adds some default keyboard shortcuts:
 - CMD+A (CTRL+A on Windows/Linux) to select all
 - CTRL+A on Mac to jump to beginning of line
 - CTRL+E on Mac to jump to end of line
+- CMD+= (CTRL+= on Windows/Linux) to zoom in (bump font height up by 1)
+- CMD+- (CTRL+- on Windows/Linux) to zoom out (bump font height down by 1)
+- CMD+0 (CTRL+0 on Windows/Linux) to restore to original font height
 - Attempts to add proper indentation upon adding a new line when hitting ENTER (currently supporting Ruby only)
 
 If you prefer it to be vanilla with no default key event listeners, then pass the `default_behavior: false` option.

data/docs/reference/GLIMMER_SAMPLES.md

@@ -41,6 +41,7 @@
     - [Hello, Slider!](#hello-slider)
     - [Hello, Spinner!](#hello-spinner)
     - [Hello, Table!](#hello-table)
+    - [Hello, Refined Table!](#hello-refined-table)
     - [Hello, Link!](#hello-link)
     - [Hello, Dialog!](#hello-dialog)
     - [Hello, Code Text!](#hello-code-text)
@@ -730,7 +731,7 @@ Hello, Spinner!
 
 #### Hello, Table!
 
-This sample demonstrates the use of [table](#table) widget in Glimmer, including data-binding, multi-type editing, sorting, and filtering.
+This sample demonstrates the use of [table](/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#table) widget in Glimmer, including data-binding, multi-type editing, sorting, and filtering.
 
 Code:
 
@@ -780,6 +781,18 @@ Hello, Table! Game Booked Rows
 
 ![Hello Table game booked rows](/images/glimmer-hello-table-game-booked-rows.png)
 
+#### Hello, Refined Table!
+
+This sample demonstrates the use of the [`refined_table` widget](/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#refined-table-with-pagination), which provides a paginated `table` that can handle very large amounts of data.
+
+Code:
+
+[samples/hello/hello_refined_table.rb](/samples/hello/hello_refined_table.rb)
+
+Hello, Refined Table!
+
+![Hello Refined Table](/images/glimmer-hello-refined-table.png)
+
 #### Hello, Link!
 
 This sample demonstrates the use of the `link` widget in Glimmer, including identifying which link was clicked and performing an action (displaying help) based on its location.
@@ -820,17 +833,29 @@ Code:
 
 [samples/hello/hello_code_text.rb](/samples/hello/hello_code_text.rb)
 
-Hello, Code Text! Ruby Language / Glimmer Theme / Show Line Numbers (default width of 4)
+Hello, Code Text! HTML Language / GitHub Theme / No Line Numbers
 
-![Hello Code Text Ruby](/images/glimmer-hello-code-text-ruby.png)
+![Hello Code Text HTML](/images/glimmer-hello-code-text-html.png)
 
 Hello, Code Text! JavaScript Language / Pastie Theme / Show Line Numbers (custom width of 2)
 
 ![Hello Code Text JavaScript](/images/glimmer-hello-code-text-javascript.png)
 
-Hello, Code Text! HTML Language / GitHub Theme / No Line Numbers
+Hello, Code Text! Ruby Language / Glimmer Theme / Show Line Numbers (default width of 4)
 
-![Hello Code Text HTML](/images/glimmer-hello-code-text-html.png)
+![Hello Code Text Ruby](/images/glimmer-hello-code-text-ruby.png)
+
+Hello, Code Text! Zoom In (via keyboard shortcut CMD+= on Mac, CTRL+= on Win/Linux)
+
+![Hello Code Text Zoom In](/images/glimmer-hello-code-text-zoom-in.png)
+
+Hello, Code Text! Zoom Out (via keyboard shortcut CMD+- on Mac, CTRL+- on Win/Linux)
+
+![Hello Code Text Zoom Out](/images/glimmer-hello-code-text-zoom-out.png)
+
+Hello, Code Text! Restore Original Font Height (via keyboard shortcut CMD+0 on Mac, CTRL+0 on Win/Linux)
+
+![Hello Code Text Restore Original Font Height](/images/glimmer-hello-code-text-ruby.png)
 
 #### Hello, Canvas!
 

data/lib/glimmer/data_binding/table_items_binding.rb

@@ -39,16 +39,12 @@ module Glimmer
       TABLE_ITEM_PROPERTIES = %w[background foreground font image]
 
       def initialize(parent, model_binding, column_properties = nil)
-        @table = parent
+        @table = parent.is_a?(Glimmer::SWT::TableProxy) ? parent : parent.body_root # assume custom widget in latter case
         @model_binding = model_binding
         @read_only_sort = @model_binding.binding_options[:read_only_sort]
-        @column_properties = @model_binding.binding_options[:column_properties] || @model_binding.binding_options[:column_attributes] || column_properties
         @table.editable = false if @model_binding.binding_options[:read_only]
-        if @table.respond_to?(:column_properties=)
-          @table.column_properties = @column_properties
-        else # assume custom widget
-          @table.body_root.column_properties = @column_properties
-        end
+        @table.column_properties = @model_binding.binding_options[:column_properties] || @model_binding.binding_options[:column_attributes] || column_properties
+        @column_properties = @table.column_properties # normalized column properties
         Glimmer::SWT::DisplayProxy.instance.auto_exec(override_sync_exec: @model_binding.binding_options[:sync_exec], override_async_exec: @model_binding.binding_options[:async_exec]) do
           @table.swt_widget.data = @model_binding
           @table.swt_widget.set_data('table_items_binding', self)
@@ -67,6 +63,7 @@ module Glimmer
         Glimmer::SWT::DisplayProxy.instance.auto_exec(override_sync_exec: @model_binding.binding_options[:sync_exec], override_async_exec: @model_binding.binding_options[:async_exec]) do
           new_model_collection = model_binding_evaluated_property = @model_binding.evaluate_property unless internal_sort # this ensures applying converters (e.g. :on_read)
           return if same_table_data?(new_model_collection)
+          
           if same_model_collection?(new_model_collection)
             new_model_collection_attribute_values = model_collection_attribute_values(new_model_collection)
             @table.swt_widget.items.each_with_index do |table_item, row_index|
@@ -83,24 +80,38 @@ module Glimmer
             @last_model_collection_attribute_values = new_model_collection_attribute_values
           else
             if new_model_collection and new_model_collection.is_a?(Array)
-              remove_dependent(@table_observer_registration => @table_items_observer_registration) if @table_items_observer_registration
-              @table_items_observer_registration&.unobserve
-              # TODO observe and update table items piecemeal per model instead of passing @column_properties
-              # TODO ensure unobserving models when they are no longer part of the table
-              @table_items_observer_registration = observe(new_model_collection, @column_properties)
-              add_dependent(@table_observer_registration => @table_items_observer_registration)
-              @table_items_property_observer_registration ||= {}
+              @model_observer_registrations ||= {}
+              new_model_collection.each do |model|
+                @model_observer_registrations[model] ||= {}
+                @column_properties.each do |column_property|
+                  old_model_observer_registration = @model_observer_registrations[model][column_property]
+                  remove_dependent(@table_observer_registration => old_model_observer_registration) if old_model_observer_registration
+                  old_model_observer_registration&.unobserve
+                  model_observer_registration = observe(model, column_property)
+                  @model_observer_registrations[model][column_property] = model_observer_registration
+                  add_dependent(@table_observer_registration => model_observer_registration)
+                end
+              end
+
               if !same_model_collection_with_different_sort?(new_model_collection)
-                TABLE_ITEM_PROPERTIES.each do |table_item_property|
-                  remove_dependent(@table_observer_registration => @table_items_property_observer_registration[table_item_property]) if @table_items_property_observer_registration[table_item_property]
-                  @table_items_property_observer_registration[table_item_property]&.unobserve
-                  property_properties = @column_properties.map {|property| "#{property}_#{table_item_property}" }
-                  @table_items_property_observer_registration[table_item_property] = observe(new_model_collection, property_properties)
-                  add_dependent(@table_observer_registration => @table_items_property_observer_registration[table_item_property])
+                new_model_collection.each do |model|
+                  TABLE_ITEM_PROPERTIES.each do |table_item_property|
+                    @column_properties.each do |column_property|
+                      column_property = "#{column_property}_#{table_item_property}"
+                      old_model_observer_registration = @model_observer_registrations[model][column_property]
+                      remove_dependent(@table_observer_registration => old_model_observer_registration) if old_model_observer_registration
+                      old_model_observer_registration&.unobserve
+                      model_observer_registration = observe(model, column_property)
+                      @model_observer_registrations[model][column_property] = model_observer_registration
+                      add_dependent(@table_observer_registration => model_observer_registration)
+                    end
+                  end
                 end
               end
+              
               @model_collection = new_model_collection
             end
+            
             populate_table(@model_collection, @table, @column_properties, internal_sort: internal_sort)
           end
         end

data/lib/glimmer/data_binding/widget_binding.rb

@@ -31,7 +31,8 @@ module Glimmer
       include Observable
       include Observer
 
-      attr_reader :widget, :property
+      attr_reader :widget, :property, :model_binding
+      
       def initialize(widget, property, sync_exec: nil, async_exec: nil)
         @widget = widget
         @property = property
@@ -40,17 +41,35 @@ module Glimmer
         SWT::DisplayProxy.instance.auto_exec(override_sync_exec: @sync_exec, override_async_exec: @async_exec) do
           if @widget.is_a?(Glimmer::SWT::WidgetProxy) && @widget.respond_to?(:on_widget_disposed)
             @widget.on_widget_disposed do |dispose_event|
-              deregister_all_observables unless @widget.shell_proxy.last_shell_closing?
+              unless @widget.shell_proxy.last_shell_closing?
+                @widget_proxy.widget_bindings.delete(self)
+                deregister_all_observables
+              end
             end
           end
           # TODO look into hooking on_shape_disposed without slowing down shapes in samples like Tetris
         end
+        # TODO try to come up with a more comprehensive and cleaner solution to miscallenous objects like MessageBoxProxy with regards to @widget_proxy
+        @widget_proxy = widget.is_a?(Glimmer::SWT::WidgetProxy) ? widget : (widget.respond_to?(:body_root) ? widget.body_root : widget)
+      end
+      
+      def observe(*args)
+        if @widget_proxy.respond_to?(:widget_bindings)
+          # TODO try to come up with a more comprehensive and cleaner solution to miscallenous objects like MessageBoxProxy with regards to the following code
+          # assumes only one observation
+          @model_binding = args.first if args.size == 1
+          @widget_proxy.widget_bindings << self
+        end
+        super
       end
       
       def call(value)
         SWT::DisplayProxy.instance.auto_exec(override_sync_exec: @sync_exec, override_async_exec: @async_exec) do
           if @widget.respond_to?(:disposed?) && @widget.disposed?
-            deregister_all_observables unless @widget.shell_proxy.last_shell_closing?
+            unless @widget.shell_proxy.last_shell_closing?
+              @widget_proxy.widget_bindings.delete(self)
+              deregister_all_observables
+            end
             return
           end
           # need the rescue false for a scenario with tree items not being equal to model objects raising an exception
@@ -62,7 +81,10 @@ module Glimmer
       
       def evaluate_property
         if @widget.respond_to?(:disposed?) && @widget.disposed?
-          deregister_all_observables unless @widget.shell_proxy.last_shell_closing?
+          unless @widget.shell_proxy.last_shell_closing?
+            @widget_proxy.widget_bindings.delete(self)
+            deregister_all_observables
+          end
           return
         end
         @widget.get_attribute(@property)

data/lib/glimmer/dsl/swt/custom_widget_expression.rb

@@ -26,6 +26,7 @@ require 'glimmer/dsl/top_level_expression'
 require 'glimmer/ui/custom_widget'
 require 'glimmer/ui/custom_shell'
 require 'glimmer/swt/custom/code_text'
+require 'glimmer/swt/custom/refined_table'
 require 'glimmer/swt/custom/radio_group'
 require 'glimmer/swt/custom/checkbox_group'
 

data/lib/glimmer/swt/custom/code_text.rb

@@ -42,6 +42,7 @@ module Glimmer
         
         REGEX_COLOR_HEX6 = /^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/
         FONT_NAMES_PREFERRED = ['Consolas', 'Courier', 'Monospace', 'Liberation Mono']
+        SHORTCUT_KEY_COMMAND = OS.mac? ? :command : :ctrl
         
         # TODO support auto language detection
               
@@ -145,7 +146,7 @@ module Glimmer
         
         body {
           if lines
-            composite {
+            @composite = composite {
               grid_layout(2, false)
               
               @line_numbers_styled_text_proxy = styled_text(swt(swt(swt_style), :h_scroll!, :v_scroll!)) {
@@ -204,12 +205,18 @@ module Glimmer
               on_key_pressed { |event|
                 character = event.keyCode.chr rescue nil
                 case [event.stateMask, character]
-                when [(OS.mac? ? swt(:command) : swt(:ctrl)), 'a']
+                when [swt(SHORTCUT_KEY_COMMAND), 'a']
                   @styled_text_proxy.selectAll
                 when [(swt(:ctrl) if OS.mac?), 'a']
                   jump_to_beginning_of_line
                 when [(swt(:ctrl) if OS.mac?), 'e']
                   jump_to_end_of_line
+                when [swt(SHORTCUT_KEY_COMMAND), '=']
+                  bump_font_height_up
+                when [swt(SHORTCUT_KEY_COMMAND), '-']
+                  bump_font_height_down
+                when [swt(SHORTCUT_KEY_COMMAND), '0']
+                  restore_font_height
                 end
               }
               on_verify_text { |verify_event|
@@ -333,6 +340,36 @@ module Glimmer
           @font_name ||= all_font_names.find {|font_name| font_name.downcase.include?('mono')}
           @font_name
         end
+        
+        def bump_font_height_up
+          @original_font_height ||= font_datum.height
+          new_font_height = font_datum.height + 1
+          update_font_height(new_font_height)
+        end
+        
+        def bump_font_height_down
+          @original_font_height ||= font_datum.height
+          new_font_height = (font_datum.height - 1) == 0 ? font_datum.height : (font_datum.height - 1)
+          update_font_height(new_font_height)
+        end
+        
+        def restore_font_height
+          return if @original_font_height.nil?
+          update_font_height(@original_font_height)
+          @original_font_height = nil
+        end
+        
+        def update_font_height(new_font_height)
+          return if new_font_height.nil?
+          @styled_text_proxy.font = {name: font_datum.name, height: new_font_height, style: font_datum.style}
+          @line_numbers_styled_text_proxy&.font = {name: font_datum.name, height: new_font_height, style: font_datum.style}
+          @body_root.shell_proxy.layout(true, true)
+          @body_root.shell_proxy.pack_same_size
+        end
+        
+        def font_datum
+          @styled_text_proxy.font.font_data.first
+        end
       end
     end
   end

data/lib/glimmer/swt/custom/refined_table.rb

@@ -0,0 +1,182 @@
+# Copyright (c) 2007-2022 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer/ui/custom_widget'
+
+module Glimmer
+  module SWT
+    module Custom
+      # RefinedTable is a customization of Table with support for Filtering/Pagination
+      class RefinedTable
+        include Glimmer::UI::CustomWidget
+        
+        option :per_page, default: 10
+        option :page, default: 0
+        option :model_array
+        
+        attr_accessor :refined_model_array
+        attr_reader :table_proxy, :page_text_proxy
+        
+        before_body do
+          self.model_array ||= []
+          self.refined_model_array = []
+        end
+        
+        after_body do
+          Glimmer::DataBinding::Observer.proc do |new_widget_bindings|
+            new_widget_bindings.each do |new_widget_binding|
+              if new_widget_binding.property.to_s == 'model_array' && !@data_bound
+                @data_bound = true
+                model_binding = new_widget_binding.model_binding
+                observe(self, :model_array) do
+                  paginate
+                end
+                @table_proxy.content {
+                  items(dsl: true) <=> [self, :refined_model_array, model_binding.binding_options.merge(read_only: true)]
+                }
+                paginate
+              end
+            end
+          end.observe(body_root.widget_bindings)
+        end
+        
+        body {
+          composite {
+            composite {
+              layout_data(:fill, :center, true, false)
+              
+              fill_layout(:horizontal)
+              
+              button {
+                text '<<'
+                
+                on_widget_selected do
+                  self.page = first_page
+                  paginate
+                end
+              }
+              
+              button {
+                text '<'
+                
+                on_widget_selected do
+                  self.page -= 1
+                  paginate
+                end
+              }
+              
+              @page_text_proxy = text(:border, :center) {
+                text <= [self, :page, on_read: ->(value) { "#{value} of #{page_count}" }]
+                
+                on_focus_gained do
+                  @page_text_proxy.select_all
+                end
+                
+                on_focus_lost do
+                  self.page = @page_text_proxy.text.to_i
+                  paginate
+                end
+                
+                on_key_pressed do |key_event|
+                  if key_event.keyCode == swt(:cr)
+                    self.page = @page_text_proxy.text.to_i
+                    paginate
+                  end
+                end
+              }
+              
+              button {
+                text '>'
+                
+                on_widget_selected do
+                  self.page += 1
+                  paginate
+                end
+              }
+              
+              button {
+                text '>>'
+                
+                on_widget_selected do
+                  self.page = last_page
+                  paginate
+                end
+              }
+            }
+            
+            @children_owner = @table_proxy = table(swt_style)
+          }
+        }
+        
+        def table_block=(block)
+          @table_proxy.content(&block)
+        end
+        
+        def method_missing(method_name, *args, &block)
+          dsl_mode = @dsl_mode || args.last.is_a?(Hash) && args.last[:dsl]
+          if dsl_mode
+            args.pop if args.last.is_a?(Hash) && args.last[:dsl]
+            super(method_name, *args, &block)
+          elsif @table_proxy&.respond_to?(method_name, *args, &block)
+            @table_proxy&.send(method_name, *args, &block)
+          else
+            super
+          end
+        end
+        
+        def respond_to?(method_name, *args, &block)
+          dsl_mode = @dsl_mode || args.last.is_a?(Hash) && args.last[:dsl]
+          if dsl_mode
+            args = args[0...-1] if args.last.is_a?(Hash) && args.last[:dsl]
+            super(method_name, *args, &block)
+          else
+            super || @table_proxy&.respond_to?(method_name, *args, &block)
+          end
+        end
+        
+        def page_count
+          (model_array && (model_array.count / per_page.to_f).ceil) || 0
+        end
+        
+        def corrected_page(initial_page_value = nil)
+          correct_page = initial_page_value || page
+          correct_page = [correct_page, page_count].min
+          correct_page = [correct_page, 1].max
+          correct_page = (model_array&.count.to_i > 0) ? (correct_page > 0 ? correct_page : 1) : 0
+          correct_page
+        end
+        
+        def first_page
+          (model_array&.count.to_i > 0) ? 1 : 0
+        end
+        
+        def last_page
+          page_count
+        end
+        
+        def paginate
+          self.page = corrected_page(page)
+          self.refined_model_array = model_array[(page - 1) * per_page, per_page]
+        end
+      end
+    end
+  end
+end

data/lib/glimmer/swt/table_proxy.rb

@@ -246,7 +246,8 @@ module Glimmer
       end
       
       attr_reader :table_editor, :table_editor_widget_proxy, :sort_property, :sort_direction, :sort_block, :sort_type, :sort_by_block, :additional_sort_properties, :editor, :editable
-      attr_accessor :column_properties
+      attr_writer :column_properties
+      alias column_attributes= column_properties=
       alias editable? editable
       
       def initialize(underscored_widget_name, parent, args)
@@ -258,6 +259,19 @@ module Glimmer
         @table_editor.minimumHeight = 20
         self.editable = editable_style
       end
+      
+      def column_properties
+        if @column_properties.nil?
+          swt_widget.columns.to_a.map(&:text).map(&:underscore)
+        elsif @column_properties.is_a?(Hash)
+          @column_properties = swt_widget.columns.to_a.map(&:text).map do |column_name|
+            @column_properties[column_name] || column_name.underscore
+          end
+        else
+          @column_properties
+        end
+      end
+      alias column_attributes column_properties
 
       def items
         auto_exec do

data/lib/glimmer/swt/widget_proxy.rb

@@ -159,7 +159,8 @@ module Glimmer
             @parent_proxy = parent
             styles, extra_options = extract_args(underscored_widget_name, args)
             swt_widget_class = self.class.swt_widget_class_for(underscored_widget_name)
-            @swt_widget = swt_widget_class.new(@parent_proxy.swt_widget, style(underscored_widget_name, styles), *extra_options)
+            swt_widget_producer = @parent_proxy.respond_to?(:children_owner) ? @parent_proxy.children_owner : @parent_proxy
+            @swt_widget = swt_widget_class.new(swt_widget_producer.swt_widget, style(underscored_widget_name, styles), *extra_options)
           else
             @swt_widget = swt_widget
             underscored_widget_name = self.class.underscored_widget_name(@swt_widget)
@@ -769,6 +770,10 @@ module Glimmer
           end
         end
       end
+      
+      def widget_bindings
+        @widget_bindings ||= []
+      end
 
       def content(&block)
         auto_exec do

data/lib/glimmer/ui/custom_widget.rb

@@ -271,6 +271,14 @@ module Glimmer
         "#{attribute_name}="
       end
       
+      def shell_proxy
+        @body_root.shell_proxy
+      end
+      
+      def children_owner
+        @children_owner || @body_root
+      end
+      
       def disposed?
         swt_widget.isDisposed
       end

data/samples/elaborate/contact_manager.rb

@@ -144,7 +144,7 @@ class ContactManager
             width 200
           }
           
-          items <=> [@contact_manager_presenter, :results, column_properties: [:first_name, :last_name, :email]]
+          items <=> [@contact_manager_presenter, :results]
           
           on_mouse_up do |event|
             table_proxy.edit_table_item(event.table_item, event.column_index)

data/samples/elaborate/meta_sample/tutorials.yml

@@ -29,3 +29,4 @@ Parking: kw-6icVgDR4
 Hello, Custom Widget!: aJHLo5yLDZc
 Hello, Custom Shell!: c8Eb8GWM_XQ
 Hello, Custom Shape!: H3J8ecp30Ak
+Battleship: b00OWeLZOt8

data/samples/elaborate/meta_sample.rb

@@ -41,9 +41,11 @@ class Sample
     
     def ensure_user_glimmer_directory
       unless @ensured_glimmer_directory
-        FileUtils.rm_rf(user_glimmer_directory)
-        FileUtils.cp_r(glimmer_directory, user_glimmer_directory)
-        @ensured_glimmer_directory = true
+        Thread.new do
+          FileUtils.rm_rf(user_glimmer_directory)
+          FileUtils.cp_r(glimmer_directory, user_glimmer_directory)
+          @ensured_glimmer_directory = true
+        end
       end
     end
     
@@ -123,11 +125,11 @@ class Sample
   end
     
   def file_relative_path
-    file.sub(self.class.glimmer_directory, '')
+    file.sub(Sample.glimmer_directory, '')
   end
   
   def user_file
-    File.join(self.class.user_glimmer_directory, file_relative_path)
+    File.join(Sample.user_glimmer_directory, file_relative_path)
   end
     
   def user_file_parent_directory
@@ -209,10 +211,10 @@ class SampleDirectory
       @samples.each do |sample|
         observe(sample, :selected) do |new_selected_value|
           if new_selected_value
-            self.class.all_samples.reject {|a_sample| a_sample.name == sample.name}.each do |other_sample|
+            SampleDirectory.all_samples.reject {|a_sample| a_sample.name == sample.name}.each do |other_sample|
               other_sample.selected = false
             end
-            self.class.selected_sample = sample
+            SampleDirectory.selected_sample = sample
           end
         end
       end
@@ -227,8 +229,8 @@ class SampleDirectory
   def selected_sample_name=(selected_name)
     @selected_sample_name = selected_name
     unless selected_name.nil?
-      (self.class.sample_directories - [self]).each { |sample_dir| sample_dir.selected_sample_name = nil }
-      self.class.selected_sample = samples.detect { |sample| sample.name == @selected_sample_name }
+      (SampleDirectory.sample_directories - [self]).each { |sample_dir| sample_dir.selected_sample_name = nil }
+      SampleDirectory.selected_sample = samples.detect { |sample| sample.name == @selected_sample_name }
     end
   end
   

data/samples/elaborate/tetris/view/high_score_dialog.rb

@@ -66,7 +66,7 @@ class Tetris
               text 'Level'
             }
             
-            items <=> [game, :high_scores, read_only_sort: true, column_properties: [:name, :score, :lines, :level]]
+            items <=> [game, :high_scores, read_only_sort: true]
           }
           composite {
             row_layout :horizontal

data/samples/hello/hello_custom_shell.rb

@@ -157,19 +157,19 @@ class HelloCustomShell
         layout_data :fill, :fill, true, true
       
         table_column {
-          text 'Date:'
+          text 'Date'
           width 180
         }
         table_column {
-          text 'Subject:'
+          text 'Subject'
           width 180
         }
         table_column {
-          text 'From:'
+          text 'From'
           width 360
         }
         
-        items <=> [@email_system, :emails, column_properties: [:date, :subject, :from]]
+        items <=> [@email_system, :emails]
         selection <=> [@email_system, :selected_email]
         
         on_mouse_up do |event|

data/samples/hello/hello_refined_table.rb

@@ -0,0 +1,159 @@
+# Copyright (c) 2007-2022 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer-dsl-swt'
+require 'date'
+
+class HelloRefinedTable
+  BaseballTeam = Struct.new(:name, :town, :ballpark, keyword_init: true) do
+    class << self
+      def all
+        @all ||= [
+          {town: 'Chicago', name: 'White Sox', ballpark: 'Guaranteed Rate Field'},
+          {town: 'Cleveland', name: 'Indians', ballpark: 'Progressive Field'},
+          {town: 'Detroit', name: 'Tigers', ballpark: 'Comerica Park'},
+          {town: 'Kansas City', name: 'Royals', ballpark: 'Kauffman Stadium'},
+          {town: 'Minnesota', name: 'Twins', ballpark: 'Target Field'},
+          {town: 'Baltimore', name: 'Orioles', ballpark: 'Oriole Park at Camden Yards'},
+          {town: 'Boston', name: 'Red Sox', ballpark: 'Fenway Park'},
+          {town: 'New York', name: 'Yankees', ballpark: 'Comerica Park'},
+          {town: 'Tampa Bay', name: 'Rays', ballpark: 'Tropicana Field'},
+          {town: 'Toronto', name: 'Blue Jays', ballpark: 'Rogers Centre'},
+          {town: 'Houston', name: 'Astros', ballpark: 'Minute Maid Park'},
+          {town: 'Los Angeles', name: 'Angels', ballpark: 'Angel Stadium'},
+          {town: 'Oakland', name: 'Athletics', ballpark: 'RingCentral Coliseum'},
+          {town: 'Seattle', name: 'Mariners', ballpark: 'T-Mobile Park'},
+          {town: 'Texas', name: 'Rangers', ballpark: 'Globe Life Field'},
+          {town: 'Chicago', name: 'Cubs', ballpark: 'Wrigley Field'},
+          {town: 'Cincinnati', name: 'Reds', ballpark: 'Great American Ball Park'},
+          {town: 'Milwaukee', name: 'Brewers', ballpark: 'American Family Field'},
+          {town: 'Pittsburgh', name: 'Pirates', ballpark: 'PNC Park'},
+          {town: 'St. Louis', name: 'Cardinals', ballpark: 'Busch Stadium'},
+          {town: 'Atlanta', name: 'Braves', ballpark: 'Truist Park'},
+          {town: 'Miami', name: 'Marlins', ballpark: 'LoanDepot Park'},
+          {town: 'New York', name: 'Mets', ballpark: 'Citi Field'},
+          {town: 'Philadelphia', name: 'Phillies', ballpark: 'Citizens Bank Park'},
+          {town: 'Washington', name: 'Nationals', ballpark: 'Nationals Park'},
+          {town: 'Arizona', name: 'Diamondbacks', ballpark: 'Chase Field'},
+          {town: 'Colorado', name: 'Rockies', ballpark: 'Coors Field'},
+          {town: 'Los Angeles', name: 'Dodgers', ballpark: 'Dodger Stadium'},
+          {town: 'San Diego', name: 'Padres', ballpark: 'Petco Park'},
+          {town: 'San Francisco', name: 'Giants', ballpark: 'Oracle Park'},
+        ].map {|team_kwargs| new(team_kwargs)}
+      end
+    end
+    
+    def complete_name
+      "#{town} #{name}"
+    end
+  end
+    
+  BaseballGame = Struct.new(:date, :home_team, :away_team, keyword_init: true) do
+    def home_team_name
+      home_team.complete_name
+    end
+    
+    def away_team_name
+      away_team.complete_name
+    end
+    
+    def ballpark
+      home_team.ballpark
+    end
+  end
+  
+  BaseballSeason = Struct.new(:year) do
+    def games
+      if @games.nil?
+        @games = []
+        baseball_team_combinations = BaseballTeam.all.combination(2).to_a
+        current_day = first_day
+        day_offset = 0
+        begin
+          if (day_offset % 7 != 6)
+            day_games = []
+            half_teams_count = BaseballTeam.all.count / 2
+            while day_games.uniq.count < half_teams_count
+              baseball_team_pair = baseball_team_combinations.sample
+              teams_played_so_far = day_games.map {|game| [game.home_team, game.away_team]}.flatten
+              unless teams_played_so_far.include?(baseball_team_pair.first) || teams_played_so_far.include?(baseball_team_pair.last)
+                baseball_game = BaseballGame.new(
+                  date: current_day,
+                  home_team: baseball_team_pair.first,
+                  away_team: baseball_team_pair.last,
+                )
+                day_games << baseball_game
+                @games << baseball_game
+              end
+            end
+          end
+          day_offset += 1
+          current_day += 1
+        end while current_day != first_day_of_playoffs
+      end
+      @games
+    end
+    
+    def first_day
+      @first_day ||= Date.new(year, 04, 01)
+    end
+    
+    def first_day_of_playoffs
+      @last_day ||= Date.new(year, 10, 01)
+    end
+  end
+  
+  include Glimmer::UI::Application
+  
+  before_body do
+    @baseball_season = BaseballSeason.new(Time.now.year)
+  end
+
+  body {
+    shell {
+      text 'Hello, Refined Table!'
+    
+      refined_table(per_page: 20) { # also `page: 1` by default
+        table_column {
+          width 100
+          text 'Date'
+        }
+        table_column {
+          width 200
+          text 'Ballpark'
+        }
+        table_column {
+          width 150
+          text 'Home Team'
+        }
+        table_column {
+          width 150
+          text 'Away Team'
+        }
+        
+        model_array <= [@baseball_season, :games, column_attributes: {'Home Team' => :home_team_name, 'Away Team' => :away_team_name}]
+      }
+    }
+  }
+
+end
+
+HelloRefinedTable.launch

data/samples/hello/hello_table.rb

@@ -302,15 +302,16 @@ class HelloTable
         }
         
         # Data-bind table items (rows) to a model collection (BaseballGame.schedule),
-        # mapping columns in declaration order to row model properties (attributes)
-        # By convention, every column property can be accompanied by extra properties
-        # with the following suffixes: `_background`, `_foreground`, `_font`, and `_image`
-        # For example, for `game_date`, model could also implement these related properties:
+        # automatically inferring model attributes from column names by convention
+        # (e.g. 'Home Team' column assumes a `home_team` attribute on models)
+        #
+        # By convention, every inferred model attribute can be accompanied by extra
+        # model attributes to set extra table properties with the following suffixes:
+        # `_background`, `_foreground`, `_font`, and `_image`
+        #
+        # For example, for :game_date, model could also implement these related properties:
         # `game_date_background`, `game_date_foreground`, `game_date_font`, `game_date_image`
-        # That is done in order to let the table widget set extra properties if needed.
-        items <=> [BaseballGame, :schedule,
-                    column_properties: [:game_date, :game_time, :ballpark, :home_team, :away_team, :promotion]
-                  ]
+        items <=> [BaseballGame, :schedule]
         
         # Data-bind table selection
         selection <=> [BaseballGame, :selected_game]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-swt
 version: !ruby/object:Gem::Version
-  version: 4.24.3.0
+  version: 4.24.4.0
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-27 00:00:00.000000000 Z
+date: 2022-09-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -472,6 +472,7 @@ files:
 - lib/glimmer/swt/custom/code_text.rb
 - lib/glimmer/swt/custom/drawable.rb
 - lib/glimmer/swt/custom/radio_group.rb
+- lib/glimmer/swt/custom/refined_table.rb
 - lib/glimmer/swt/custom/shape.rb
 - lib/glimmer/swt/custom/shape/arc.rb
 - lib/glimmer/swt/custom/shape/cubic.rb
@@ -670,6 +671,7 @@ files:
 - samples/hello/hello_progress_bar.rb
 - samples/hello/hello_radio.rb
 - samples/hello/hello_radio_group.rb
+- samples/hello/hello_refined_table.rb
 - samples/hello/hello_sash_form.rb
 - samples/hello/hello_scale.rb
 - samples/hello/hello_scrolled_composite.rb