glimmer-dsl-swt 4.24.2.3 → 4.24.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 774fc1f559ec5f11db66bdb42369c85e7df2a50f9f7f361e293a16c173ca394b
-  data.tar.gz: 5f45c3421a272bd377d3d8cb2457008e5ff2c5533ff3dcd0d25ae540cb549520
+  metadata.gz: 89250fa7cc394da176eb7cd91a17c7ad388607c69927a7e22b6b1be62333a0b8
+  data.tar.gz: e7e09c62b782c682c0abdb8722001c8925268cfe4bab49b536eb58f3f32fb697
 SHA512:
-  metadata.gz: 31ad8918c664072c497d08183dfc9662dda92548cd2afe876d962219e364dbb9bde7efa75ea509e03df84fd2f91561d2d753d15d54e1f405502097b3c1036b0b
-  data.tar.gz: 9c14b3e9a70f70c63e95858eec0ee229ed46ff89b1217f715ac93b9388108f70ea9b428da127ad63eee0d356762e1fa7fe07c3481a819e698629703a37f3b735
+  metadata.gz: 136c2625e94629b690a325bdc3c8669a36c612f9f651b04faa5be3dcbcc86b57ae5345c23fcce1b10656b9dca5e8a4e96a318147907785a5bff18eac3dd4b130
+  data.tar.gz: 6d1c069b332ccd3139cf0c6377dd64b5341ccd84cc4dda3c72f5255c0eaeff0639bbfcdea35cb6b66baa84fb9ed1093143cafb4897f6ba2b2198dd494e0033c3

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Change Log
 
+## 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)
+- Update Hello, Table! sample to demonstrate data-binding `table` `items` `background`, `foreground`, `font`, `image` to model attributes by convention, and to add `booked` attribute on `BaseballGame` to disable Book button when already booked
+- Update Hello, Table! sample to add `booked` attribute to `BaseballGame` to disable Book button when already booked
+- Update Hello, Table! sample to enable booking by hitting the ENTER keyboard button
+- Optimize `table` data-binding performance by not recreating table-items when the table grows or stays at the same size, and by not updating a table item (row) when no changes have occurred (detect through diffing)
+- Update `font` keyword and `FontProxy` to support lightweight creation/caching/sharing following Flyweight Design Pattern
+
 ## 4.24.2.3
 
 - Default `code_text` font name in Mac is changed back to `'Courier'`

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.2.3
+# [<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.2
 ## 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)
@@ -12,7 +12,7 @@
 
 ![Glimmer DSL for SWT Demo of Hello, World!](/images/glimmer-dsl-swt-demo-hello-world.gif)
 
-[Glimmer](https://github.com/AndyObtiva/glimmer) DSL for [SWT](https://www.eclipse.org/swt/) is a native GUI (Graphical User Interface) cross-platform desktop development library written in [JRuby](https://www.jruby.org/), an OS-threaded faster [JVM](https://www.java.com/en/download/help/whatis_java.html) version of [Ruby](https://www.ruby-lang.org/en/). [Glimmer](https://github.com/AndyObtiva/glimmer)'s main innovation is a declarative [Ruby DSL](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#glimmer-dsl-syntax) (Domain Specific Language) that enables productive and efficient authoring of desktop application user-interfaces by relying on the robust [Eclipse SWT library](https://www.eclipse.org/swt/). [Glimmer](https://rubygems.org/gems/glimmer) additionally innovates by having built-in [data-binding](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#data-binding) support, which greatly facilitates synchronizing the GUI with domain models, thus achieving true decoupling of object oriented components and enabling developers to solve business problems (test-first) without worrying about GUI concerns, or alternatively drive development GUI-first, and then write clean business models afterwards. Not only does Glimmer provide a large set of GUI [widgets](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#widgets), but it also supports drawing Canvas Graphics like [Shapes](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#canvas-shape-dsl) and [Animations](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#canvas-animation-dsl). To get started quickly, [Glimmer](https://rubygems.org/gems/glimmer) offers [scaffolding](docs/reference/GLIMMER_COMMAND.md#scaffolding) options for [Apps](#in-production), [Gems](docs/reference/GLIMMER_COMMAND.md#custom-shell-gem), and [Custom Widgets](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#custom-widgets). [Glimmer](https://rubygems.org/gems/glimmer) also includes native-executable [packaging](docs/reference/GLIMMER_PACKAGING_AND_DISTRIBUTION.md) support, sorely lacking in other libraries, thus enabling the delivery of desktop apps written in [Ruby](https://www.ruby-lang.org/en/) as truly native DMG/PKG/APP files on the [Mac](https://www.apple.com/ca/macos), MSI/EXE files on [Windows](https://www.microsoft.com/en-ca/windows), and DEB/RPM files on [Linux](https://www.linux.org/). [Glimmer](https://github.com/AndyObtiva/glimmer) was the [first Ruby gem](https://rubygems.org/gems/glimmer) to bring [SWT](https://www.eclipse.org/swt/) (Standard Widget Toolkit) to [Ruby](https://www.ruby-lang.org/en/), thanks to creator [Andy Maleh](https://andymaleh.blogspot.com/), EclipseCon/EclipseWorld/RubyConf speaker.
+[Glimmer](https://github.com/AndyObtiva/glimmer) DSL for [SWT](https://www.eclipse.org/swt/) (formerly [Glimmer](https://github.com/AndyObtiva/glimmer)) is a native GUI (Graphical User Interface) cross-platform desktop development library written in [JRuby](https://www.jruby.org/), an OS-threaded faster [JVM](https://www.java.com/en/download/help/whatis_java.html) version of [Ruby](https://www.ruby-lang.org/en/). [Glimmer](https://github.com/AndyObtiva/glimmer)'s main innovation is a declarative [Ruby DSL](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#glimmer-dsl-syntax) (Domain Specific Language) that enables productive and efficient authoring of desktop application user-interfaces by relying on the robust [Eclipse SWT library](https://www.eclipse.org/swt/). [Glimmer](https://rubygems.org/gems/glimmer) additionally innovates by having built-in [data-binding](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#data-binding) support, which greatly facilitates synchronizing the GUI with domain models, thus achieving true decoupling of object oriented components and enabling developers to solve business problems (test-first) without worrying about GUI concerns, or alternatively drive development GUI-first, and then write clean business models afterwards. Not only does Glimmer provide a large set of GUI [widgets](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#widgets), but it also supports drawing Canvas Graphics like [Shapes](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#canvas-shape-dsl) and [Animations](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#canvas-animation-dsl). To get started quickly, [Glimmer](https://rubygems.org/gems/glimmer) offers [scaffolding](docs/reference/GLIMMER_COMMAND.md#scaffolding) options for [Apps](#in-production), [Gems](docs/reference/GLIMMER_COMMAND.md#custom-shell-gem), and [Custom Widgets](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#custom-widgets). [Glimmer](https://rubygems.org/gems/glimmer) also includes native-executable [packaging](docs/reference/GLIMMER_PACKAGING_AND_DISTRIBUTION.md) support, sorely lacking in other libraries, thus enabling the delivery of desktop apps written in [Ruby](https://www.ruby-lang.org/en/) as truly native DMG/PKG/APP files on the [Mac](https://www.apple.com/ca/macos), MSI/EXE files on [Windows](https://www.microsoft.com/en-ca/windows), and DEB/RPM files on [Linux](https://www.linux.org/). [Glimmer](https://github.com/AndyObtiva/glimmer) was the [first Ruby gem](https://rubygems.org/gems/glimmer) to bring [SWT](https://www.eclipse.org/swt/) (Standard Widget Toolkit) to [Ruby](https://www.ruby-lang.org/en/), thanks to creator [Andy Maleh](https://andymaleh.blogspot.com/), EclipseCon/EclipseWorld/RubyConf speaker.
 
 [<img src="https://covers.oreillystatic.com/images/9780596519650/lrg.jpg" width=105 /><br />
 Featured in JRuby Cookbook](http://shop.oreilly.com/product/9780596519650.do) and [Chalmers/Gothenburg University Software Engineering Master's Lecture Material](http://www.cse.chalmers.se/~bergert/slides/guest_lecture_DSLs.pdf)
@@ -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.2.3 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.3.2 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.2.3
+jgem install glimmer-dsl-swt -v 4.24.3.2
 ```
 
 `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.2.3'
+gem 'glimmer-dsl-swt', '~> 4.24.3.2'
 ```
 
 And, then run:
@@ -389,7 +389,7 @@ glimmer
 ```
 
 ```
-Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.24.2.3
+Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.24.3.2
       
 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.2.3
+4.24.3.2

data/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md

@@ -3996,13 +3996,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 +4019,10 @@ shell {
       text "Adult"
       width 120
     }
-    items bind(group, :people), column_properties(:name, :age, :adult)
-    selection bind(group, :selected_person)
+    
+    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 +4030,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
+  }
+}
+```
 
-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.
+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 `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,13 +4102,31 @@ 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.
 
+##### 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_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
+- `image` to `:name_image, :age_image, :adult_image` model attributes
+
+Here are the expected values for each [`TableItem` property](https://help.eclipse.org/latest/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/widgets/TableItem.html):
+- `background`: Standard color symbol/string (e.g. `:red`), rgb array (e.g. `[24, 21, 239]`), or rgba array (e.g. `[128, 0, 128, 50]`)
+- `foreground`: Standard color symbol/string (e.g. `:red`), rgb array (e.g. `[24, 21, 239]`), or rgba array (e.g. `[128, 0, 128, 50]`)
+- `font`: font data hash having `:name`, `:height`, and/or `:style` keys (e.g. `{name: 'Courier New', height: 25, style: [:bold, :italic]}`)
+- `image`: image URL with or without image options (e.g. `'/usr/image1.png'` or `['/usr/image1.png', width: 20, height: 20]`)
+
+![Hello Table game booked rows](/images/glimmer-hello-table-game-booked-rows.png)
+
 ##### Table Selection
 
 Table Selection data-binding is simply done via the `selection` property.
@@ -4086,7 +4162,7 @@ shell {
       text "Adult"
       width 120
     }
-    items bind(group, :people), column_properties(:name, :age, :adult)
+    items <=> [group, :people]
     selection bind(group, :selected_person)
   }
 }
@@ -4113,7 +4189,7 @@ shell {
       width 120
       editor :checkbox
     }
-    items bind(group, :people), column_properties(:name, :age, :adult)
+    items <=> [group, :people]
     selection bind(group, :selected_person)
   }
 }
@@ -4152,7 +4228,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)
   }
 }
@@ -4211,7 +4287,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]]
     # ...
   }
 # ...
@@ -4224,7 +4300,7 @@ 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.
 
 #### Tree
 
@@ -4807,7 +4883,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.
 
@@ -5133,6 +5209,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

@@ -730,7 +730,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:
 
@@ -768,13 +768,17 @@ Hello, Table! Playoff Type Changed
 
 ![Hello Table](/images/glimmer-hello-table-playoff-type-changed.png)
 
+Hello, Table! Context Menu
+
+![Hello Table](/images/glimmer-hello-table-context-menu.png)
+
 Hello, Table! Game Booked
 
 ![Hello Table](/images/glimmer-hello-table-game-booked.png)
 
-Hello, Table! Context Menu
+Hello, Table! Game Booked Rows
 
-![Hello Table](/images/glimmer-hello-table-context-menu.png)
+![Hello Table game booked rows](/images/glimmer-hello-table-game-booked-rows.png)
 
 #### Hello, Link!
 
@@ -816,17 +820,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

@@ -19,6 +19,8 @@
 # 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 'set'
+
 require 'glimmer/data_binding/observable_array'
 require 'glimmer/data_binding/observable_model'
 require 'glimmer/data_binding/observable'
@@ -33,17 +35,21 @@ module Glimmer
       include DataBinding::Observer
       include_package 'org.eclipse.swt'
       include_package 'org.eclipse.swt.widgets'
+      
+      TABLE_ITEM_PROPERTIES = %w[background foreground font image]
 
       def initialize(parent, model_binding, column_properties = nil)
         @table = parent
         @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
+        column_properties = @model_binding.binding_options[:column_properties] || @model_binding.binding_options[:column_attributes] || column_properties
+        if @table.is_a?(Glimmer::SWT::TableProxy)
+          @table.column_properties = column_properties
+          @column_properties = @table.column_properties # normalized column properties
         else # assume custom widget
           @table.body_root.column_properties = @column_properties
+          @column_properties = @table.body_root.column_properties # normalized column properties
         end
         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
@@ -56,40 +62,161 @@ module Glimmer
         end
       end
 
-      def call(new_model_collection=nil, internal_sort: false)
+      def call(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        internal_sort = options[:internal_sort] || false
+        new_model_collection = args.first
         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)
-          table_cells = @table.swt_widget.items.map {|item| @table.column_properties.size.times.map {|i| item.get_text(i)} }
-          model_cells = new_model_collection.to_a.map {|m| @table.cells_for(m)}
-          return if table_cells == model_cells
-          if new_model_collection and new_model_collection.is_a?(Array)
-            @table_items_observer_registration&.unobserve
-            @table_items_observer_registration = observe(new_model_collection, @column_properties)
-            add_dependent(@table_observer_registration => @table_items_observer_registration)
-            @model_collection = new_model_collection
+          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|
+              next if new_model_collection_attribute_values[row_index] == @last_model_collection_attribute_values[row_index]
+              model = table_item.get_data
+              (0..(@column_properties.size-1)).each do |column_index|
+                new_model_attribute_values_for_index = model_attribute_values_for_index(new_model_collection_attribute_values[row_index], column_index)
+                last_model_attribute_values_for_index = model_attribute_values_for_index(@last_model_collection_attribute_values[row_index], column_index)
+                next if new_model_attribute_values_for_index == last_model_attribute_values_for_index
+                model_attribute = @column_properties[column_index]
+                update_table_item_properties_from_model(table_item, row_index, column_index, model, model_attribute)
+              end
+            end
+            @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 ||= {}
+              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])
+                end
+              end
+              @model_collection = new_model_collection
+            end
+            populate_table(@model_collection, @table, @column_properties, internal_sort: internal_sort)
           end
-          populate_table(@model_collection, @table, @column_properties, internal_sort: internal_sort)
         end
       end
       
       def populate_table(model_collection, parent, column_properties, internal_sort: false)
         selected_table_item_models = parent.swt_widget.getSelection.map(&:get_data)
         parent.finish_edit!
-        parent.swt_widget.items.each(&:dispose)
-        parent.swt_widget.removeAll
-        model_collection.each do |model|
-          table_item = TableItem.new(parent.swt_widget, SWT::SWTProxy[:none])
-          for index in 0..(column_properties.size-1)
-            table_item.setText(index, model.send(column_properties[index]).to_s)
+        dispose_start_index = @last_model_collection_attribute_values &&
+                              (model_collection.count < @last_model_collection_attribute_values.count) &&
+                              (@last_model_collection_attribute_values.count - (@last_model_collection_attribute_values.count - model_collection.count))
+        if dispose_start_index
+          table_items_to_dispose = parent.swt_widget.items[dispose_start_index..-1]
+          parent.swt_widget.remove(dispose_start_index, (@last_model_collection_attribute_values.count-1))
+          table_items_to_dispose.each(&:dispose)
+        end
+        model_collection.each_with_index do |model, row_index|
+          table_item_exists = @last_model_collection_attribute_values &&
+                              @last_model_collection_attribute_values.count > 0 &&
+                              row_index < @last_model_collection_attribute_values.count
+          table_item = table_item_exists ? parent.swt_widget.items[row_index] : TableItem.new(parent.swt_widget, SWT::SWTProxy[:none])
+          (0..(column_properties.size-1)).each do |column_index|
+            model_attribute = column_properties[column_index]
+            update_table_item_properties_from_model(table_item, row_index, column_index, model, model_attribute)
           end
           table_item.set_data(model)
         end
+        @last_model_collection_attribute_values = model_collection_attribute_values(model_collection)
         selected_table_items = parent.search {|item| selected_table_item_models.include?(item.get_data) }
         parent.swt_widget.setSelection(selected_table_items)
         sorted_model_collection = parent.sort!(internal_sort: internal_sort)
         call(sorted_model_collection, internal_sort: true) if @read_only_sort && !internal_sort && !sorted_model_collection.nil?
         parent.swt_widget.redraw if parent&.swt_widget&.respond_to?(:redraw)
       end
+      
+      def update_table_item_properties_from_model(table_item, row_index, column_index, model, model_attribute)
+        Glimmer::SWT::DisplayProxy.instance.sync_exec do
+          old_table_item_values = @last_model_collection_attribute_values &&
+            @last_model_collection_attribute_values[row_index] &&
+            model_attribute_values_for_index(@last_model_collection_attribute_values[row_index], column_index)
+          text_value = model.send(model_attribute).to_s
+          old_table_item_value = old_table_item_values && old_table_item_values[0]
+          table_item.set_text(column_index, text_value) if old_table_item_value.nil? || text_value != old_table_item_value
+          TABLE_ITEM_PROPERTIES.each do |table_item_property|
+            if model.respond_to?("#{model_attribute}_#{table_item_property}")
+              table_item_value = model.send("#{model_attribute}_#{table_item_property}")
+              old_table_item_value = old_table_item_values && old_table_item_values[1 + TABLE_ITEM_PROPERTIES.index(table_item_property)]
+              if old_table_item_value.nil? || (table_item_value != old_table_item_value)
+                table_item_value = Glimmer::SWT::ColorProxy.create(*table_item_value).swt_color if table_item_value && %w[background foreground].include?(table_item_property.to_s)
+                table_item_value = Glimmer::SWT::FontProxy.create(table_item_value).swt_font if table_item_value && table_item_property.to_s == 'font'
+                table_item_value = Glimmer::SWT::ImageProxy.create(*table_item_value).swt_image if table_item_value && table_item_property.to_s == 'image'
+                table_item.send("set_#{table_item_property}", column_index, table_item_value)
+              end
+            end
+          end
+        end
+      end
+      
+      def same_table_data?(new_model_collection)
+        (["text"] + TABLE_ITEM_PROPERTIES).all? do |table_item_property|
+          table_cells = @table.swt_widget.items.map do |item|
+            model = item.get_data
+            @table.column_properties.each_with_index.map do |column_property, i|
+              model_attribute = "#{column_property}"
+              model_attribute = "#{model_attribute}_#{table_item_property}" if TABLE_ITEM_PROPERTIES.include?(table_item_property)
+              item.send("get_#{table_item_property}", i) if model.respond_to?(model_attribute)
+            end
+          end
+          model_cells = new_model_collection.to_a.map do |m|
+            @table.cells_for(m, table_item_property: table_item_property)
+          end
+          model_cells = model_cells.map do |row|
+            row.map do |model_cell|
+              if model_cell
+                if %w[background foreground].include?(table_item_property.to_s)
+                  Glimmer::SWT::ColorProxy.create(*model_cell).swt_color
+                elsif table_item_property.to_s == 'font'
+                  Glimmer::SWT::FontProxy.create(model_cell).swt_font
+                elsif table_item_property.to_s == 'image'
+                  Glimmer::SWT::ImageProxy.create(*model_cell).swt_image
+                else
+                  model_cell
+                end
+              end
+            end
+          end
+          table_cells == model_cells
+        end
+      end
+      
+      def same_model_collection?(new_model_collection)
+        new_model_collection == table_item_model_collection
+      end
+      
+      def same_model_collection_with_different_sort?(new_model_collection)
+        Set.new(new_model_collection) == Set.new(table_item_model_collection)
+      end
+      
+      def table_item_model_collection
+        @table.swt_widget.items.map(&:get_data)
+      end
+      
+      def model_collection_attribute_values(model_collection)
+        model_collection.map do |model|
+          (["text"] + TABLE_ITEM_PROPERTIES).map do |table_item_property|
+            @table.cells_for(model, table_item_property: table_item_property)
+          end
+        end
+      end
+      
+      def model_attribute_values_for_index(model_attribute_values, index)
+        model_attribute_values.map {|attribute_values| attribute_values[index]}
+      end
+      
     end
   end
 end

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

@@ -41,7 +41,7 @@ module Glimmer
         end
   
         def interpret(parent, keyword, *args, &block)
-          Glimmer::SWT::FontProxy.new(*args)
+          Glimmer::SWT::FontProxy.create(*args)
         end
       end
     end

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/font_proxy.rb

@@ -36,14 +36,24 @@ module Glimmer
     #
     # Follows the Proxy Design Pattern
     class FontProxy
-      ERROR_INVALID_FONT_STYLE = " is an invalid font style! Valid values are :normal, :bold, and :italic"
-      FONT_STYLES = [:normal, :bold, :italic]
+      class << self
+        def create(*args)
+          flyweight_font_proxies[args] ||= new(*args)
+        end
+        
+        # Flyweight Design Pattern memoization cache. Can be cleared if memory is needed.
+        def flyweight_font_proxies
+          @flyweight_font_proxies ||= {}
+        end
+      end
 
       include_package 'org.eclipse.swt.graphics'
+      
+      ERROR_INVALID_FONT_STYLE = " is an invalid font style! Valid values are :normal, :bold, and :italic"
+      FONT_STYLES = [:normal, :bold, :italic]
 
       attr_reader :widget_proxy, :swt_font, :font_properties
 
-
       # Builds a new font proxy from passed in widget_proxy and font_properties hash,
       #
       # It begins with existing SWT widget font and amends it with font properties.

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
@@ -419,8 +433,14 @@ module Glimmer
         @editor = args
       end
       
-      def cells_for(model)
-        column_properties.map {|property| model.send(property)}
+      def cells_for(model, table_item_property: :text)
+        if table_item_property.to_s == 'text'
+          column_properties.map {|column_property| model.send(column_property)}
+        else
+          column_properties.map do |column_property|
+            model.send("#{column_property}_#{table_item_property}") if model.respond_to?("#{column_property}_#{table_item_property}")
+          end
+        end
       end
       
       def cells

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

@@ -28,3 +28,5 @@ Hello, Canvas Transform!: ePIAF5EMsE0
 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_shape.rb

@@ -25,17 +25,17 @@ require 'glimmer-dsl-swt'
 class StickFigure
   include Glimmer::UI::CustomShape
   
-  options :x, :y, :width, :height
+  options :figure_x, :figure_y, :figure_width, :figure_height
   
   before_body do
-    @head_width = width*0.2
-    @head_height = height*0.2
-    @trunk_height = height*0.4
-    @extremity_length = height*0.4
+    @head_width = figure_width*0.2
+    @head_height = figure_height*0.2
+    @trunk_height = figure_height*0.4
+    @extremity_length = figure_height*0.4
   end
   
   body {
-    shape(x + @head_width/2.0 + @extremity_length, y) {
+    shape(figure_x + @head_width/2.0 + @extremity_length, figure_y) {
       oval(0, 0, @head_width, @head_height)
       line(@head_width/2.0, @head_height, @head_width/2.0, @head_height + @trunk_height)
       line(@head_width/2.0, @head_height + @trunk_height, @head_width/2.0 + @extremity_length, @head_height + @trunk_height + @extremity_length)
@@ -47,7 +47,7 @@ class StickFigure
 end
 
 class HelloCustomShape
-  include Glimmer::UI::CustomShell
+  include Glimmer::UI::Application
   
   WIDTH = 220
   HEIGHT = 235
@@ -60,12 +60,12 @@ class HelloCustomShape
       @canvas = canvas {
         background :white
         
-        15.times { |n|
+        15.times do |n|
           x_location = (rand*WIDTH/2).to_i%WIDTH + (rand*15).to_i
           y_location = (rand*HEIGHT/2).to_i%HEIGHT + (rand*15).to_i
           foreground_color = rgb(rand*255, rand*255, rand*255)
           
-          a_stick_figure = stick_figure(x: x_location, y: y_location, width: 35+n*2, height: 35+n*2) {
+          a_stick_figure = stick_figure(figure_x: x_location, figure_y: y_location, figure_width: 35+n*2, figure_height: 35+n*2) {
             foreground foreground_color
             drag_and_move true
             
@@ -74,7 +74,7 @@ class HelloCustomShape
               a_stick_figure.foreground = rgb(rand*255, rand*255, rand*255)
             end
           }
-        }
+        end
       }
     }
   }

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_table.rb

@@ -89,6 +89,7 @@ class HelloTable
       def playoff_type=(new_playoff_type)
         @playoff_type = new_playoff_type
         self.schedule=(all_playoff_games[@playoff_type])
+        self.selected_game = schedule.first unless selected_game.nil?
       end
       
       def playoff_type_options
@@ -118,15 +119,24 @@ class HelloTable
       'St Louis Cardinals' => 'Busch Stadium',
     }
     
-    attr_accessor :date_time, :home_team, :away_team, :ballpark, :promotion
+    ATTRIBUTES = [:game_date, :game_time, :home_team, :away_team, :ballpark, :promotion]
+    ATTRIBUTES_BACKGROUND = ATTRIBUTES.map {|attribute| "#{attribute}_background"}
+    ATTRIBUTES_FOREGROUND = ATTRIBUTES.map {|attribute| "#{attribute}_foreground"}
+    ATTRIBUTES_FONT = ATTRIBUTES.map {|attribute| "#{attribute}_font"}
+    ATTRIBUTES_IMAGE = ATTRIBUTES.map {|attribute| "#{attribute}_image"}
     
+    attr_accessor *([:booked, :date_time] + ATTRIBUTES + ATTRIBUTES_BACKGROUND + ATTRIBUTES_FOREGROUND + ATTRIBUTES_FONT + ATTRIBUTES_IMAGE)
+    alias booked? booked
+                  
     def initialize(date_time, home_team, away_team, promotion = 'N/A')
       self.date_time = date_time
       self.home_team = home_team
       self.away_team = away_team
       self.promotion = promotion
+      self.ballpark_image = [File.expand_path('hello_table/baseball_park.png', __dir__), width: 20, height: 20]
+      self.booked = false
+      
       observe(self, :date_time) do |new_value|
-        notify_observers(:game_date)
         notify_observers(:game_time)
       end
     end
@@ -177,8 +187,42 @@ class HelloTable
     end
     
     def book!
+      self.booked = true
+      self.background = :dark_green
+      self.foreground = :white
+      self.font = {style: :italic}
       "Thank you for booking #{to_s}"
     end
+    
+    # Sets background for all attributes
+    def background=(color)
+      self.game_date_background = color
+      self.game_time_background = color
+      self.home_team_background = color
+      self.away_team_background = color
+      self.ballpark_background = color
+      self.promotion_background = color
+    end
+    
+    # Sets foreground for all attributes
+    def foreground=(color)
+      self.game_date_foreground = color
+      self.game_time_foreground = color
+      self.home_team_foreground = color
+      self.away_team_foreground = color
+      self.ballpark_foreground = color
+      self.promotion_foreground = color
+    end
+    
+    # Sets font for all attributes
+    def font=(font_properties)
+      self.game_date_font = font_properties
+      self.game_time_font = font_properties
+      self.home_team_font = font_properties
+      self.away_team_font = font_properties
+      self.ballpark_font = font_properties
+      self.promotion_font = font_properties
+    end
   end
 
   include Glimmer::UI::CustomShell
@@ -246,8 +290,28 @@ class HelloTable
           # default text editor is used here
         }
         
-        # Data-bind table items (rows) to a model collection property, specifying column properties ordering per nested model
-        items <=> [BaseballGame, :schedule, column_properties: [:game_date, :game_time, :ballpark, :home_team, :away_team, :promotion]]
+        # This is a contextual pop up menu that shows up when right-clicking table rows
+        menu {
+          menu_item {
+            text 'Book'
+            
+            on_widget_selected do
+              book_selected_game
+            end
+          }
+        }
+        
+        # Data-bind table items (rows) to a model collection (BaseballGame.schedule),
+        # 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`
+        items <=> [BaseballGame, :schedule]
         
         # Data-bind table selection
         selection <=> [BaseballGame, :selected_game]
@@ -258,22 +322,16 @@ class HelloTable
         # Sort by these additional properties after handling sort by the column the user clicked
         additional_sort_properties :date, :time, :home_team, :away_team, :ballpark, :promotion
         
-        menu {
-          menu_item {
-            text 'Book'
-            
-            on_widget_selected do
-              book_selected_game
-            end
-          }
-        }
+        on_key_pressed do |key_event|
+          book_selected_game if key_event.keyCode == swt(:cr)
+        end
       }
       
       button {
         text 'Book Selected Game'
         layout_data :center, :center, true, false
         font height: 14
-        enabled <= [BaseballGame, :selected_game]
+        enabled <= [BaseballGame, 'selected_game.booked', on_read: ->(value) { value == false }]
         
         on_widget_selected do
           book_selected_game
@@ -283,6 +341,8 @@ class HelloTable
   }
   
   def book_selected_game
+    return if BaseballGame.selected_game.booked?
+    
     message_box {
       text 'Baseball Game Booked!'
       message BaseballGame.selected_game.book!

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-swt
 version: !ruby/object:Gem::Version
-  version: 4.24.2.3
+  version: 4.24.3.2
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-26 00:00:00.000000000 Z
+date: 2022-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement