glimmer-dsl-swt 4.18.3.1 → 4.18.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d88ee3cdf02d4610332fd450379b43ab5231e0a2e5e9941c746ea7b65bcad00
-  data.tar.gz: db869412b61dd6c45002cd11ebf7cdb046d02b4de9b74769ec8cd90122eafbd9
+  metadata.gz: e3d59d0d54c7528a521c07263fa47768f172e49ea2d5bee86c376d0425b8a5f8
+  data.tar.gz: 0da445293890975f23fbf5cce1af49ea4e8b54e2d86a99b6d0f4cfa7fe6559bd
 SHA512:
-  metadata.gz: 520388927363b967965f3afbbafdd753daf3c399547b87e5c60535620b12ffc694b05e14b5176b600fd1dcf7eecb4ee9c00ca41f4cbdda79ad138d2e593c836a
-  data.tar.gz: 5d52780657cac19b47ccec883b163b56fd1823f1701abef6e01e8b9b3109479648999506eb3dea2cb831826ab88eb562faf1c1a961f8d9c85620cfc956da7432
+  metadata.gz: a51c136d719ebe688209fa1a3bf8509dee32f1c90d535b06c08b6f5d835a0872c9487f437f06c7985007c210bf7aef3ecb29c6a11819e9ee48ffed77ea5ee40f
+  data.tar.gz: 8c285b55812b44969dbe3ab527b1ad1d5cc2325d2455cdf676412bfdc41f1094ce7402c3f0f5181546be9d539299f5c669de553c0b04339c3ffa3ef5c81c3fbb

data/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Change Log
 
+### 4.18.4.0
+
+- Extract line numbers part of text_editor widget from Gladiator into Glimmer code_text and make it an option (e.g. lines: true or lines: {width: 4})
+- code_text support select all via CMD+A
+- code_text support end of line via CTRL+E and beginning of line via CTRL+A
+- Support automatic inferrence of Canvas Shape DSL gradient option (just like fill option)
+- Support automatic inferrence of Canvas Shape DSL round option (just like fill option)
+- Add a background image to Hello, Table! Sample + font/color changes
+- Make Canvas patterns auto-reused and auto-disposed when canvas is disposed
+- Make Canvas images auto-dispose themselves when canvas is disposed
+- Update Hello, Code Text!
+- Change Glimmer Tetris Sample up arrow default to rotate left
+- Fix issue with "undefined method lex for nil:NilClass" in `code_text`
+
+### 4.18.3.5
+
+- Add `write_on_cancel: true` option for TableProxy#edit_table_item to make cancel behave just like save for special cases where you cannot cancel except the edit mode itself
+- Make code_text custom widget support multiple code languages via `language: 'java'` option
+- Make code_text custom widget support multiple themes via `theme: 'github'` option
+- Hello, Code Text! Sample
+- Fix issue with High Score Dialog in Tetris Sample not sorting by scores correctly (string compare instead of numeric compare) until first game is completed
+- Fix issue with setting date geting rejected in `date_time` for month or day being incompatible with the year/month/day combo
+
+### 4.18.3.4
+
+- Support building Image objects with the Glimmer Canvas Shape DSL
+- Tetris build icon image in-game by nesting Glimmer Shape DSL syntax
+- Canvas Make shapes auto-fill if you specify a background only (no need to say fill: true) or not fill if you specify a foreground only
+- Tetris option to switch Up Arrow between Instant Down, Rotate Right, and Rotate Left
+
+### 4.18.3.3
+
+- Support Table data binding read_only_sort: true option to allow visual sorting without affecting model data
+-  on_quit to
+- Tetris Add lines and level to High Score Dialog
+- Tetris Immediate Drop on Arrow Up
+- Tetris Pause on showing High Score Dialog
+- Tetris Make High Scores -> Show a check menu item
+- Tetris Disable pause button upon showing High Score Dialog
+- Fix Quit Tetris CMD+Q shortcut by adding on_quit event to display
+- Tetris Fix escape button upon entering high score name
+- If WidgetBinding encounters a disposed widget, it deregisters all observables that it is observing
+
+### 4.18.3.2
+
+- Tetris High Scores
+- Tetris Modify High Score Player Name
+- Tetris Show High Scores (Menu Item + Accelerator)
+- Tetris add a menu item with beep enablement option
+- Tetris Clear High Scores
+- Tetris Add left and right alt (option) buttons as alternative to shift for rotation. Use left ctrl as rotate left. Use a, s, d as left, down, right.
+- Fix issues relating to setting parenthood with custom widgets before building their body (instead of after)
+- Fix issues relating to not respecting arity of passed in table editing callbacks: before_write, after_write, and after_cancel
+
 ### 4.18.3.1
 
 - Provide an auto_sync_exec all data-binding config option to automatically sync_exec GUI calls from other threads instead of requiring users to use sync_exec on model attribute-change logic. Default value to false.
@@ -10,9 +64,9 @@
 - Supporting deregistering Display listeners just like standard listeners via deregister
 - Enhance performance of excluded keyword check
 - Remove CustomWidget support for multiple before_body/after_body blocks instead of one each since it is not needed.
+- Add new :fill_screen style for `shell` to start app filling the screen size (not full screen mode though)
 - Tetris Menu Bar with Game Menu -> Start, Pause, Restart, and Exit
 - Tetris refactor mutation methods to end with bangs
-- Add new :fill_screen style for `shell` to start app filling the screen size (not full screen mode though)
 - Tetris Stop game if user does not play again in the end (instead of closing it)
 - End Tetris Thread loop gracefully if game over is encountered
 - Tetris use more observers instead of callbacks to Game

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.18.3.1
+# [<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.18.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)
@@ -8,7 +8,7 @@
 
 **[Contributors Wanted! (Submit a Glimmer App Sample to Get Started)](#contributing)**
 
-[Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer) is a native-GUI cross-platform desktop development library written in [JRuby](https://www.jruby.org/), an OS-threaded faster JVM version of [Ruby](https://www.ruby-lang.org/en/). [Glimmer](https://github.com/AndyObtiva/glimmer)'s main innovation is a declarative [Ruby DSL](#glimmer-dsl-syntax) 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](#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 (test-first) afterwards. Not only does Glimmer provide a large set of GUI [widgets](#widgets), but it also supports drawing Canvas Graphics like [Shapes](#canvas-shape-dsl) and [Animations](#canvas-animation-dsl). To get started quickly, [Glimmer](https://rubygems.org/gems/glimmer) s [scaffolding](#scaffolding) options for [Apps](#in-production), [Gems](#custom-shell-gem), and [Custom Widgets](#custom-widgets). [Glimmer](https://rubygems.org/gems/glimmer) also includes native-executable [packaging](#packaging--distribution) 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) + [App Store](https://developer.apple.com/macos/distribution/), MSI/EXE files on [Windows](https://www.microsoft.com/en-ca/windows), and [Gem Packaged Shell Scripts](#custom-shell-gem) on [Linux](https://www.linux.org/).
+[Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer) is a native-GUI cross-platform desktop development library written in [JRuby](https://www.jruby.org/), an OS-threaded faster JVM version of [Ruby](https://www.ruby-lang.org/en/). [Glimmer](https://github.com/AndyObtiva/glimmer)'s main innovation is a declarative [Ruby DSL](#glimmer-dsl-syntax) 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](#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 (test-first) afterwards. Not only does Glimmer provide a large set of GUI [widgets](#widgets), but it also supports drawing Canvas Graphics like [Shapes](#canvas-shape-dsl) and [Animations](#canvas-animation-dsl). To get started quickly, [Glimmer](https://rubygems.org/gems/glimmer) offers [scaffolding](#scaffolding) options for [Apps](#in-production), [Gems](#custom-shell-gem), and [Custom Widgets](#custom-widgets). [Glimmer](https://rubygems.org/gems/glimmer) also includes native-executable [packaging](#packaging--distribution) 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) + [App Store](https://developer.apple.com/macos/distribution/), MSI/EXE files on [Windows](https://www.microsoft.com/en-ca/windows), and [Gem Packaged Shell Scripts](#custom-shell-gem) on [Linux](https://www.linux.org/).
 
 [Glimmer receives two updates per month](https://rubygems.org/gems/glimmer-dsl-swt/versions). You can trust [Glimmer](https://rubygems.org/gems/glimmer) with your Ruby desktop GUI development needs. Please make [Glimmer](https://rubygems.org/gems/glimmer) even better by providing feedback and [contributing](#contributing) when possible.
 
@@ -28,9 +28,10 @@ Glimmer DSL gems:
 
 ## Examples
 
-### Hello, World!
+### Hello, World! Sample
+
+Glimmer GUI DSL code (from [samples/hello/hello_world.rb](samples/hello/hello_world.rb)):
 
-Glimmer code (from [samples/hello/hello_world.rb](samples/hello/hello_world.rb)):
 ```ruby
 include Glimmer
 
@@ -52,169 +53,163 @@ Glimmer app:
 
 ![Hello World](images/glimmer-hello-world.png)
 
-### Tic Tac Toe
+Learn more about [Hello, World!](#hello-world).
+
+### Hello, Table! Sample
 
-Glimmer code (from [samples/elaborate/tic_tac_toe.rb](samples/elaborate/tic_tac_toe.rb)):
+Glimmer GUI DSL code (from [samples/hello/hello_table.rb](samples/hello/hello_table.rb)):
 
 ```ruby
-# ...
-    @shell = shell {
-      text "Tic-Tac-Toe"
-      minimum_size 150, 178
-      composite {
-        grid_layout 3, true
-        (1..3).each { |row|
-          (1..3).each { |column|
-            button {
-              layout_data :fill, :fill, true, true
-              text        bind(@tic_tac_toe_board[row, column], :sign)
-              enabled     bind(@tic_tac_toe_board[row, column], :empty)
-              font        style: :bold, height: 20
-              on_widget_selected {
-                @tic_tac_toe_board.mark(row, column)
-              }
-            }
-          }
+# ... model code precedes
+shell {
+  grid_layout
+  
+  text 'Hello, Table!'
+  background_image File.expand_path('hello_table/baseball_park.png', __dir__)
+  
+  label {
+    layout_data :center, :center, true, false
+    
+    text 'BASEBALL PLAYOFF SCHEDULE'
+    foreground rgb(94, 107, 103)
+    font name: 'Optima', height: 38, style: :bold
+  }
+  
+  combo(:read_only) {
+    layout_data :center, :center, true, false
+    selection bind(BaseballGame, :playoff_type)
+    font height: 14
+  }
+  
+  table(:editable) { |table_proxy|
+    layout_data :fill, :fill, true, true
+  
+    table_column {
+      text 'Game Date'
+      width 150
+      sort_property :date # ensure sorting by real date value (not `game_date` string specified in items below)
+      editor :date_drop_down, property: :date_time
+    }
+    table_column {
+      text 'Game Time'
+      width 150
+      sort_property :time # ensure sorting by real time value (not `game_time` string specified in items below)
+      editor :time, property: :date_time
+    }
+    table_column {
+      text 'Ballpark'
+      width 180
+      editor :none
+    }
+    table_column {
+      text 'Home Team'
+      width 150
+      editor :combo, :read_only # read_only is simply an SWT style passed to combo widget
+    }
+    table_column {
+      text 'Away Team'
+      width 150
+      editor :combo, :read_only # read_only is simply an SWT style passed to combo widget
+    }
+    table_column {
+      text 'Promotion'
+      width 150
+      # default text editor is used here
+    }
+    
+    # Data-bind table items (rows) to a model collection property, specifying column properties ordering per nested model
+    items bind(BaseballGame, :schedule), column_properties(:game_date, :game_time, :ballpark, :home_team, :away_team, :promotion)
+    
+    # Data-bind table selection
+    selection bind(BaseballGame, :selected_game)
+    
+    # Default initial sort property
+    sort_property :date
+    
+    # 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 {
+          book_selected_game
         }
       }
     }
+  }
+  
+  button {
+    text 'Book Selected Game'
+    layout_data :center, :center, true, false
+    font height: 14
+    enabled bind(BaseballGame, :selected_game)
+    
+    on_widget_selected {
+      book_selected_game
+    }
+  }
+}.open
 # ...
 ```
 
 Run via `glimmer samples` or directly:
 
 ```
-glimmer samples/elaborate/tic_tac_toe.rb
+glimmer samples/hello/hello_table.rb
 ```
 
-Glimmer app:
+Glimmer App:
+
+![Hello Table](images/glimmer-hello-table.png)
 
-![Tic Tac Toe](images/glimmer-tic-tac-toe-in-progress.png)
+Learn more about [Hello, Table!](#hello-table).
 
-### Contact Manager
+### Tetris
 
-Glimmer code (from [samples/elaborate/contact_manager.rb](samples/elaborate/contact_manager.rb)):
+Glimmer GUI DSL code (from [samples/elaborate/tetris.rb](samples/elaborate/tetris.rb)):
 
 ```ruby
-# ...
-    shell {
-      text "Contact Manager"
-      composite {
-        group {
-          grid_layout(2, false) {
-            margin_width 0
-            margin_height 0
-          }
-          layout_data :fill, :center, true, false
-          text 'Lookup Contacts'
-          font height: 24
-          
-          label {
-            layout_data :right, :center, false, false
-            text "First &Name: "
-            font height: 16
-          }
-          text {
-            layout_data :fill, :center, true, false
-            text bind(@contact_manager_presenter, :first_name)
-            on_key_pressed {|key_event|
-              @contact_manager_presenter.find if key_event.keyCode == swt(:cr)
-            }
-          }
-          
-          label {
-            layout_data :right, :center, false, false
-            text "&Last Name: "
-            font height: 16
-          }
-          text {
-            layout_data :fill, :center, true, false
-            text bind(@contact_manager_presenter, :last_name)
-            on_key_pressed {|key_event|
-              @contact_manager_presenter.find if key_event.keyCode == swt(:cr)
-            }
-          }
-          
-          label {
-            layout_data :right, :center, false, false
-            text "&Email: "
-            font height: 16
-          }
-          text {
-            layout_data :fill, :center, true, false
-            text bind(@contact_manager_presenter, :email)
-            on_key_pressed {|key_event|
-              @contact_manager_presenter.find if key_event.keyCode == swt(:cr)
-            }
-          }
-          
-          composite {
-            row_layout {
-              margin_width 0
-              margin_height 0
-            }
-            layout_data(:right, :center, false, false) {
-              horizontal_span 2
-            }
-            
-            button {
-              text "&Find"
-              on_widget_selected { @contact_manager_presenter.find }
-              on_key_pressed {|key_event|
-                @contact_manager_presenter.find if key_event.keyCode == swt(:cr)
-              }
-            }
-            
-            button {
-              text "&List All"
-              on_widget_selected { @contact_manager_presenter.list }
-              on_key_pressed {|key_event|
-                @contact_manager_presenter.list if key_event.keyCode == swt(:cr)
-              }
-            }
-          }
-        }
+# ... more code resides in other files (navigate sample files to learn more)
+shell(:no_resize) {
+  grid_layout {
+    num_columns 2
+    make_columns_equal_width false
+    margin_width 0
+    margin_height 0
+    horizontal_spacing 0
+  }
+  
+  text 'Glimmer Tetris'
+  minimum_size 475, 500
+  image tetris_icon
 
-        table(:multi) { |table_proxy|
-          layout_data {
-            horizontal_alignment :fill
-            vertical_alignment :fill
-            grab_excess_horizontal_space true
-            grab_excess_vertical_space true
-            height_hint 200
-          }
-          table_column {
-            text "First Name"
-            width 80
-          }
-          table_column {
-            text "Last Name"
-            width 80
-          }
-          table_column {
-            text "Email"
-            width 200
-          }
-          items bind(@contact_manager_presenter, :results),
-          column_properties(:first_name, :last_name, :email)
-          on_mouse_up { |event|
-            table_proxy.edit_table_item(event.table_item, event.column_index)
-          }
-        }
-      }
-    }.open
+  tetris_menu_bar(game: game)
+
+  playfield(game_playfield: game.playfield, playfield_width: playfield_width, playfield_height: playfield_height, block_size: BLOCK_SIZE)
+
+  score_lane(game: game, block_size: BLOCK_SIZE) {
+    layout_data(:fill, :fill, true, true)
+  }
+
+  on_widget_disposed {
+    deregister_observers
+  }
+}
 # ...
 ```
 
 Run via `glimmer samples` or directly:
 
 ```
-glimmer samples/elaborate/contact_manager.rb
+glimmer samples/elaborate/tetris.rb
 ```
 
-Glimmer App:
+Glimmer app:
+
+![Tetris](images/glimmer-tetris.png)
 
-![Contact Manager](images/glimmer-contact-manager.png)
 
 ### Desktop Apps Built with Glimmer DSL for SWT
 
@@ -235,12 +230,13 @@ If you see anything that needs to be improved, please do not hesitate to contact
 
 - [Glimmer (JRuby Desktop Development GUI Framework)](#jruby-desktop-development-gui-framework)
   - [Examples](#examples)
-    - [Hello, World!](#hello-world)
-    - [Tic Tac Toe](#tic-tac-toe)
-    - [Contact Manager](#contact-manager)
+    - [Hello, World! Sample](#hello-world-sample)
+    - [Hello, Table! Sample](#hello-table-sample)
+    - [Tetris](#tetris)
     - [Desktop Apps Built with Glimmer DSL for SWT](#desktop-apps-built-with-glimmer-dsl-for-swt)
   - [Table of contents](#table-of-contents)
   - [Background](#background)
+  - [Software Architecture](#software-architecture)
   - [Platform Support](#platform-support)
   - [Pre-requisites](#pre-requisites)
   - [Setup](#setup)
@@ -275,6 +271,8 @@ If you see anything that needs to be improved, please do not hesitate to contact
       - [Multi-Threading](#multi-threading)
       - [Menus](#menus)
       - [ScrolledComposite](#scrolledcomposite)
+      - [Sash Form Widget](#sash-form-widget)
+      - [Browser Widget](#browser-widget)
     - [Widget Styles](#widget-styles)
       - [Explicit SWT Style Bit](#explicit-swt-style-bit)
       - [Negative SWT Style Bits](#negative-swt-style-bits)
@@ -306,7 +304,12 @@ If you see anything that needs to be improved, please do not hesitate to contact
       - [Lifecycle Hooks Example](#lifecycle-hooks-example)
       - [Custom Widget API](#custom-widget-api)
       - [Content/Options Example](#contentoptions-example)
-      - [Gotcha](#gotcha)
+      - [Custom Widget Gotchas](#custom-widget-gotchas)
+      - [Built-In Custom Widgets](#built-in-custom-widgets)
+        - [Checkbox Group Custom Widget](#checkbox-group-custom-widget)
+        - [Radio Group Custom Widget](#radio-group-custom-widget)
+        - [Code Text Custom Widget](#code-text-custom-widget)
+        - [Video Custom Widget](#video-custom-widget)
       - [Custom Widget Final Notes](#custom-widget-final-notes)
     - [Custom Shells](#custom-shells)
     - [Drag and Drop](#drag-and-drop)
@@ -314,12 +317,6 @@ If you see anything that needs to be improved, please do not hesitate to contact
       - [Multi-DSL Support](#multi-dsl-support)
       - [Application Menu Items (About/Preferences)](#application-menu-items-aboutpreferences)
       - [App Name and Version](#app-name-and-version)
-      - [Checkbox Group Widget](#checkbox-group-widget)
-      - [Radio Group Widget](#radio-group-widget)
-      - [Code Text Widget](#code-text-widget)
-      - [Video Widget](#video-widget)
-      - [Sash Form Widget](#sash-form-widget)
-      - [Browser Widget](#browser-widget)
   - [Glimmer Configuration](#glimmer-configuration)
     - [logger](#logger)
       - [logging_devices](#loggingdevices)
@@ -369,9 +366,9 @@ If you see anything that needs to be improved, please do not hesitate to contact
     - [Elaborate Samples](#elaborate-samples)
       - [User Profile](#user-profile)
       - [Login](#login)
-      - [Tic Tac Toe Sample](#tic-tac-toe-sample)
-      - [Contact Manager Sample](#contact-manager-sample)
-      - [Tetris](#tetris)
+      - [Tic Tac Toe Sample](#tic-tac-toe)
+      - [Contact Manager Sample](#contact-manager)
+      - [Glimmer Tetris](#glimmer-tetris)
     - [External Samples](#external-samples)
       - [Glimmer Calculator](#glimmer-calculator)
       - [Gladiator](#gladiator)
@@ -407,6 +404,38 @@ If you see anything that needs to be improved, please do not hesitate to contact
 
 [Ruby](https://www.ruby-lang.org) is a dynamically-typed object-oriented language, which provides great productivity gains due to its powerful expressive syntax and dynamic nature. While it is proven by the [Ruby](https://www.ruby-lang.org) on Rails framework for web development, it currently lacks a robust platform-independent framework for building desktop applications. Given that Java libraries can now be utilized in Ruby code through JRuby, Eclipse technologies, such as [SWT](https://www.eclipse.org/swt/), JFace, and RCP can help fill the gap of desktop application development with Ruby.
 
+## Software Architecture
+
+There are several requirements for building enterprise-level/consumer-level desktop GUI applications:
+- Cross-Platform Support (Mac, Windows, Linux) without compilation/recompilation
+- OS Native Look & Feel
+- High Performance
+- Productivity
+- Maintainability
+- Extensibility
+- Native Executable Packaging
+- Multi-Threading / Parallel Programming
+- Arbitrary Graphics Painting
+- Audio Support
+
+Glimmer provides cross-platform support that does not require Ruby compilation (like Tk does), thanks to JRuby, a JVM (Java Virtual Machine) faster OS-threaded version of Ruby.
+
+Glimmer leverages SWT (Standard Widget Toolkit), which provides cross-platform widgets that automatically use the native GUI libraries under each operating system, such as Win32 on Windows, Cocoa on Mac, and GTK on Linux.
+
+Furthermore, what is special about SWT regarding "High Performance" is that it does all the GUI painting natively outside of Java, thus producing GUI that runs at maximum performance even in Ruby. As such, you do not need to worry about Ruby dynamic typing getting in the way of GUI performance. It has ZERO effect on it and since SWT supports making asynchronous calls for GUI rendering, you could avoid blocking the GUI completely with any computations happening in Ruby no matter how complex, thus never affecting the responsiveness of GUI of applications while taking full advantage of the productivity benefits of Ruby dynamic typing.
+
+Glimmer takes this further by providing a very programmer friendly DSL (Domain Specific Language) that visually maps lightweight Ruby syntax to the containment hierarchy of GUI widgets (meaning Ruby blocks nested within each other map to GUI widgets nested within each other). This provides maximum productivity and maintainability.
+
+Extensibility has never been simpler in desktop GUI application development than with Glimmer, which provides the ability to support any new custom keywords through custom widgets and custom shells (windows). Basically, you map a keyword by declaring a view class matching its name by convention with a GUI body that simply consists of reusable Glimmer GUI syntax. They can be passive views or smart views with additional logic. This provides the ultimate realization of Object Oriented Programming and micro-level MVC pattern.
+
+Thanks to Java and JRuby, Glimmer apps can be packaged as cross-platform JAR files (with JRuby Warbler) and native executables (with Java Packager) as Mac APP/DMG/PACKAGE or Windows EXE/MSI.
+
+The Java Virtual Machine already supports OS-native threads, so Glimmer apps can have multiple things running in parallel with no problem.
+
+SWT supports Canvas graphics drawing, and Glimmer takes that further by provding a Canvas Shape/Transform/Animation DSL, making it very simple to decorate any existing widgets or add new widgets with a completely custom look and feel if needed for branding or entertainment (gaming) purposes.
+
+Audio is supported via the Java Sound library in a cross-platform approach and video is supported via a Glimmer custom widget, so any Glimmer app can be enhanced with audio and video where needed.
+
 ## Platform Support
 
 Glimmer runs on the following platforms:
@@ -460,7 +489,7 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.18.3.1
+jgem install glimmer-dsl-swt -v 4.18.4.0
 
 
 ```
@@ -480,7 +509,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.18.3.1
+gem 'glimmer-dsl-swt', '~> 4.18.4.0
 '
 ```
 
@@ -539,7 +568,7 @@ bin/glimmer samples
 Below are the full usage instructions that come up when running `glimmer` without args.
 
 ```
-Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.18.3.1
+Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.18.4.0
 
 
       
@@ -815,7 +844,7 @@ glimmer run
 
 #### Custom Shell
 
-To scaffold a Glimmer custom shell (full window view) for an existing Glimmer app, run the following command:
+To scaffold a Glimmer [custom shell](#custom-shells) (full window view) for an existing Glimmer app, run the following command:
 
 ```
 glimmer scaffold:customshell[name]
@@ -829,7 +858,7 @@ glimmer scaffold:cs[name]
 
 #### Custom Widget
 
-To scaffold a Glimmer custom widget (part of a view) for an existing Glimmer app, run the following command:
+To scaffold a Glimmer [custom widget](#custom-widgets) (part of a view) for an existing Glimmer app, run the following command:
 
 ```
 glimmer scaffold:customwidget[name]
@@ -843,7 +872,7 @@ glimmer scaffold:cw[name]
 
 #### Custom Shell Gem
 
-Custom shell gems are self-contained Glimmer apps as well as reusable custom shells.
+Custom shell gems are self-contained Glimmer apps as well as reusable [custom shells](#custom-shells).
 They have everything scaffolded Glimmer apps come with in addition to gem content like a [Juwelier](https://rubygems.org/gems/juwelier) Rakefile that can build gemspec and release gems.
 Unlike scaffolded Glimmer apps, custom shell gem content lives under the `lib` directory (not `app`).
 They can be packaged as both a native executable (e.g. Mac DMG/PKG/APP) and a Ruby gem.
@@ -878,7 +907,7 @@ Examples:
 
 #### Custom Widget Gem
 
-To scaffold a Glimmer custom widget gem (part of a view distributed as a Ruby gem), run the following command:
+To scaffold a Glimmer [custom widget](#custom-widgets) gem (part of a view distributed as a Ruby gem), run the following command:
 
 ```
 glimmer scaffold:gem:customwidget[name,namespace]
@@ -904,7 +933,7 @@ Examples:
 
 ### Gem Listing
 
-The `glimmer` command comes with tasks for listing Glimmer related gems to make it easy to find Glimmer Custom Shells, Custom Widgets, and DSLs published by others in the Glimmer community on [rubygems.org](http://www.rubygems.org).
+The `glimmer` command comes with tasks for listing Glimmer related gems to make it easy to find Glimmer [Custom Shells](#custom-shells), [Custom Widgets](#custom-widgets), and DSLs published by others in the Glimmer community on [rubygems.org](http://www.rubygems.org).
 
 #### Listing Custom Shell Gems
 
@@ -1020,7 +1049,7 @@ Output:
                                                                          
   Css    glimmer-dsl-css    1.1.0     AndyMaleh    Glimmer DSL for CSS
   Opal   glimmer-dsl-opal   0.10.2     AndyMaleh    Glimmer DSL for Opal
-  Swt    glimmer-dsl-swt    4.18.3.1
+  Swt    glimmer-dsl-swt    4.18.4.0
 
   AndyMaleh    Glimmer DSL for SWT
   Tk     glimmer-dsl-tk     0.0.6     AndyMaleh    Glimmer DSL for Tk
@@ -1098,9 +1127,12 @@ bin/girb
 
 Watch out for hands-on examples in this README indicated by "you may copy/paste in [`girb`](#girb-glimmer-irb-command)"
 
-Keep in mind that all samples live under [https://github.com/AndyObtiva/glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt)
+Keep in mind that all samples live under [https://github.com/AndyObtiva/glimmer-dsl-swt/samples](https://github.com/AndyObtiva/glimmer-dsl-swt/samples)
 
-If you need a more GUI interactive option to experiement with Glimmer GUI DSL Syntax, you may try the ["Ugliest Editor Ever"](https://github.com/AndyObtiva/glimmer-cs-gladiator) or just build your own using the [Glimmer DSL for SWT Ruby Gem](https://rubygems.org/gems/glimmer-dsl-swt).
+If you need a more GUI interactive option to experiement with Glimmer GUI DSL Syntax, you may try:
+- [Glimmer Meta-Sample (The Sample of Samples)](#samples): allows launching Glimmer samples and viewing/editing code to learn/experiment too.
+- ["Ugliest Editor Ever"](https://github.com/AndyObtiva/glimmer-cs-gladiator)
+- Just build your own GUI editor using the [Glimmer DSL for SWT Ruby Gem](https://rubygems.org/gems/glimmer-dsl-swt).
 
 ## Glimmer GUI DSL Syntax
 
@@ -1859,6 +1891,79 @@ Glimmer provides smart defaults for the `scrolled_composite` widget by:
 - Automatically setting the :h_scroll and :v_scroll SWT styles (can be set manually if only one of either :h_scroll or :v_scroll is desired )
 - Automatically setting the expand horizontal and expand vertical SWT properties to `true`
 
+#### Sash Form Widget
+
+`sash_form` is an SWT built-in custom widget that provides a resizable sash that splits a window area into two or more panes.
+
+It can be customized with the `weights` attribute by setting initial weights to size the panes at first display.
+
+One noteworthy thing about the Glimmer implementation is that, unlike behavior in SWT, it allows declaring `weights` before the content of the `sash_form`, thus providing more natural and convenient syntax (Glimmer automatically takes care of sending that declaration to SWT at the end of declaring `sash_form` content as per the SWT requirements)
+
+Example (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
+
+```ruby
+shell {
+  text 'Sash Form Example'
+  sash_form {
+    label {
+      text '(resize >>)'
+      background :dark_green
+      foreground :white
+      font height: 20
+    }
+    label {
+      text '(<< resize)'
+      background :red
+      foreground :white
+      font height: 20
+    }
+    weights 1, 2
+  }
+}.open
+```
+
+You may check out a more full-fledged example in [Hello, Sash Form!](#hello-sash-form)
+
+![Hello Sash Form](images/glimmer-hello-sash-form.png)
+
+#### Browser Widget
+
+![Hello Browser](images/glimmer-hello-browser.png)
+
+Glimmer supports the SWT Browser widget, which can load URLs or render HTML. It can even be instrumented with JavaScript when needed (though highly discouraged since it defeats the purpose of using Ruby except in very rare cases like leveraging a pre-existing web codebase in a desktop app).
+
+Example loading a URL (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
+
+```ruby
+shell {
+  minimum_size 1024, 860
+  browser {
+    url 'http://brightonresort.com/about'
+  }
+}.open
+```
+
+Example rendering HTML with JavaScript on document ready (you may copy/paste in [`girb`](#girb-glimmer-irb-command) provided you install and require [glimmer-dsl-xml gem](https://github.com/AndyObtiva/glimmer-dsl-xml)):
+
+```ruby
+shell {
+  minimum_size 130, 130
+  @browser = browser {
+    text html {
+      head {
+        meta(name: "viewport", content: "width=device-width, initial-scale=2.0")
+      }
+      body {
+        h1 { "Hello, World!" }
+      }
+    }
+    on_completed { # on load of the page execute this JavaScript
+      @browser.swt_widget.execute("alert('Hello, World!');")
+    }
+  }
+}.open
+```
+
 ### Widget Styles
 
 SWT widgets receive `SWT` styles in their constructor as per this guide:
@@ -2321,7 +2426,8 @@ Shape keywords and their args (including defaults) are listed below (they basica
 - `rectangle​(x, y, width, height, vertical = true, fill: true, gradient: true)` gradient rectangle, which is always filled, and takes an optional extra argument to specify true for vertical gradient (default) and false for horizontal gradient
 - `text(string, x, y, flags = nil)` text with optional flags (flag format is `swt(comma_separated_flags)` where flags can be :draw_delimiter (i.e. new lines), :draw_tab, :draw_mnemonic, and :draw_transparent as explained in [GC API](https://help.eclipse.org/2020-12/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/graphics/GC.html))
 
-Shape keywords that can be filled with color can take an keyword argument `fill: true` (defaults to false when not specified)
+Shape keywords that can be filled with color can take an keyword argument `fill: true`. Defaults to false when not specified unless background is set with no foreground (or foreground is set with no background), in which case a smart default is applied.
+Smart defaults can be applied to automatically infer `gradient: true` (rectangle with both foreground and background) and `round: true` (rectangle with more than 4 args, the extra args are numeric) as well.
 
 Optionally, a shape keyword takes a block that can set any attributes from [org.eclipse.swt.graphics.GC](https://help.eclipse.org/2020-12/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/graphics/GC.html) (methods starting with `set`), which enable setting the `background` for filling and `foreground` for drawing.
 
@@ -2345,6 +2451,8 @@ Here is a list of supported attributes nestable within a block under shapes:
 - `text_anti_alias` enables text antialiasing (SWT style value of `:default`, `:off`, `:on` whereby `:default` applies OS default, which varies per OS)
 - `transform` sets transform object using [Canvas Transform DSL](#canvas-transform-dsl) syntax
 
+Keep in mind that ordering of shapes matters as it is followed in painting. For example, it is recommended you paint filled shapes first and then drawn ones.
+
 Example (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
 
 ```ruby
@@ -2359,10 +2467,10 @@ shell {
 
   canvas {
     background :dark_yellow
-    rectangle(0, 0, 220, 400, fill: true) {
+    rectangle(0, 0, 220, 400) {
       background :dark_red
     }
-    rectangle(50, 20, 300, 150, 30, 50, round: true, fill: true) {
+    rectangle(50, 20, 300, 150, 30, 50, round: true) {
       background :yellow
     }
     rectangle(150, 200, 100, 70, true, gradient: true) {
@@ -2432,6 +2540,103 @@ In any case, if there is anything missing you would like added to the Glimmer Sh
 
 Keep in mind that the Shape DSL can be used inside any widget, not just `canvas`. Unlike shapes on a `canvas`, which are standalone graphics, when included in a widget, which already has its own look and feel, shapes are used as a decorative add-on that complements its look by getting painted on top of it. For example, shapes were used to decorate `composite` blocks in the [Tetris](#tetris) sample to have a more bevel look. In summary, Shapes can be used in a hybrid approach (shapes inside a widget), not just standalone in a `canvas`.
 
+#### Shapes inside an Image
+
+You can build an image using the Canvas Shape DSL (including setting the icon of the application).
+
+Example (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
+
+```
+include Glimmer
+
+shell {
+  text 'Image Shape DSL Example'
+  label {
+    bevel_constant = 20
+    icon_block_size = 64
+    icon_bevel_size = icon_block_size.to_f / 25.to_f
+    icon_bevel_pixel_size = 0.16*icon_block_size.to_f
+    icon_size = 8
+    icon_pixel_size = icon_block_size * icon_size
+    image(icon_pixel_size, icon_pixel_size) {
+      icon_size.times { |row|
+        icon_size.times { |column|
+          colored = row >= 1 && column.between?(1, 6)
+          color = colored ? color([:white, :red, :blue, :green, :yellow, :magenta, :cyan, :dark_blue].sample) : color(:white)
+          x = column * icon_block_size
+          y = row * icon_block_size
+          rectangle(x, y, icon_block_size, icon_block_size) {
+            background color
+          }
+          polygon(x, y, x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
+            background rgb(color.red + 4*bevel_constant, color.green + 4*bevel_constant, color.blue + 4*bevel_constant)
+          }
+          polygon(x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size, y + icon_block_size) {
+            background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
+          }
+          polygon(x + icon_block_size, y + icon_block_size, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size) {
+            background rgb(color.red - 2*bevel_constant, color.green - 2*bevel_constant, color.blue - 2*bevel_constant)
+          }
+          polygon(x, y, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
+            background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
+          }
+        }
+      }
+    }
+  }
+}.open
+```
+
+![Image Shape DSL](images/glimmer-example-image-shape-dsl.png)
+
+Example setting the icon of the application (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
+
+```
+include Glimmer
+
+shell {
+  text 'Image Shape DSL Example'
+  label {
+    text 'Image Shape DSL Example'
+    font height: 30
+  }
+  bevel_constant = 20
+  icon_block_size = 64
+  icon_bevel_size = icon_block_size.to_f / 25.to_f
+  icon_bevel_pixel_size = 0.16*icon_block_size.to_f
+  icon_size = 8
+  icon_pixel_size = icon_block_size * icon_size
+  image(icon_pixel_size, icon_pixel_size) {
+    icon_size.times { |row|
+      icon_size.times { |column|
+        colored = row >= 1 && column.between?(1, 6)
+        color = colored ? color([:white, :red, :blue, :green, :yellow, :magenta, :cyan, :dark_blue].sample) : color(:white)
+        x = column * icon_block_size
+        y = row * icon_block_size
+        rectangle(x, y, icon_block_size, icon_block_size) {
+          background color
+        }
+        polygon(x, y, x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
+          background rgb(color.red + 4*bevel_constant, color.green + 4*bevel_constant, color.blue + 4*bevel_constant)
+        }
+        polygon(x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size, y + icon_block_size) {
+          background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
+        }
+        polygon(x + icon_block_size, y + icon_block_size, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size) {
+          background rgb(color.red - 2*bevel_constant, color.green - 2*bevel_constant, color.blue - 2*bevel_constant)
+        }
+        polygon(x, y, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
+          background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
+        }
+      }
+    }
+  }
+}.open
+```
+
+![Image Shape DSL](images/glimmer-example-image-shape-dsl-app-switcher-icon.png)
+
+
 ### Canvas Transform DSL
 
 The transform DSL builds [org.eclipse.swt.graphics.Transform](https://help.eclipse.org/2020-12/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/graphics/Transform.html) objects with a nice declarative syntax.
@@ -2537,7 +2742,7 @@ shell {
       
       frame { |index|
         background rgb(index%100, index%100 + 100, index%55 + 200)
-        rectangle(index, index, 20, 20, fill: true) {
+        rectangle(index, index, 20, 20) {
           background :red
         }
       }
@@ -2576,6 +2781,12 @@ Learn more at the [Hello, Canvas Animation! Sample](#hello-canvas-animation).
 
 If there is anything missing you would like added to the Glimmer Animation DSL that you saw available in the SWT APIs, you may [report an issue](https://github.com/AndyObtiva/glimmer-dsl-swt/issues) or implement yourself and [contribute](#contributing) via a Pull Request.
 
+#### Animation via Data-Binding
+
+Animation could be alternatively implemented without the `animation` keyword through a loop that invokes model methods inside `sync_exec {}` (or `async_exec {}`), which indirectly cause updates to the GUI via data-binding.
+
+The [Glimmer Tetris](#glimmer-tetris) sample provides a good example of that.
+
 ### Data-Binding
 
 Data-binding is done with `bind` command following widget property to bind and taking model and bindable attribute as arguments.
@@ -2989,6 +3200,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.
 
 #### Tree
 
@@ -3392,7 +3604,7 @@ shell {
 
 Notice how `:no_focus` was the `swt_style` value, followed by the `options` hash `{orientation: :horizontal, bg_color: :white}`, and finally the `content` block containing the label with `'SANDWICH CONTENT'`
 
-#### Gotcha
+#### Custom Widget Gotchas
 
 Beware of defining a custom attribute that is a common SWT widget property name.
 For example, if you define `text=` and `text` methods to accept a custom text and then later you write this body:
@@ -3422,6 +3634,314 @@ body {
 
 The `text` method invoked in the custom widget body will call the one you defined above it. To avoid this gotcha, simply name the text property above something else, like `custom_text`.
 
+#### Built-In Custom Widgets
+
+##### Checkbox Group Custom Widget
+
+`checkbox_group` (or alias `check_group`) is a Glimmer built-in custom widget that displays a list of `checkbox` buttons (`button(:check)`) based on its `items` property.
+
+`checkbox_group` consists of a root `composite` (with `grid_layout 1, false` by default) that holds nested `checkbox` (`button(:check)`) widgets.
+
+The `selection` property determines which `checkbox` buttons are checked. It expects an `Array` of `String` objects
+The `selection_indices` property determines which `checkbox` button indices are checked. It expects an `Array` of index `Integer` objects that are zero-based.
+The `checkboxes` property returns the list of nested `checkbox` widgets.
+
+When data-binding `selection`, the model property should have a matching property with `_options` suffix (e.g. `activities_options` for `activities`) to provide an `Array` of `String` objects for `checkbox` buttons.
+
+You may see an example at the [Hello, Checkbox Group!](#hello-checkbox-group) sample.
+
+![Hello Checkbox Group](images/glimmer-hello-checkbox-group.png)
+
+##### Radio Group Custom Widget
+
+`radio_group` is a Glimmer built-in custom widget that displays a list of `radio` buttons (`button(:radio)`) based on its `items` property, which expects an `Array` of `String` objects.
+
+`radio_group` consists of a root `composite` (with `grid_layout 1, false` by default) that holds nested `radio` widgets.
+
+The `selection` property determines which `radio` button is selected. It expects a `String`
+The `selection_index` property determines which `radio` button index is selected. It expects an index integer that is zero-based.
+The `radios` property returns the list of nested `radio` widgets.
+
+When data-binding `selection`, the model property should have a matching property with `_options` suffix (e.g. `country_options` for `country`) to provide text for `radio` buttons.
+
+This custom widget is used in the [Glimmer Meta-Sample (The Sample of Samples)](#samples):
+
+![Glimmer Meta-Sample](images/glimmer-meta-sample.png)
+
+Glimmer Meta-Sample Code Example:
+
+```ruby
+# ...
+radio_group { |radio_group_proxy|
+  row_layout(:vertical) {
+    fill true
+  }
+  selection bind(sample_directory, :selected_sample_name)
+  font height: 24
+}
+
+# ...
+```
+
+You may see another example at the [Hello, Radio Group!](#hello-radio-group) sample.
+
+##### Code Text Custom Widget
+
+`code_text` is a Glimmer built-in custom widget that displays syntax highlighted Ruby code in a customized SWT [StyledText](https://help.eclipse.org/2020-09/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/custom/StyledText.html) widget.
+
+It is used in the [Glimmer Meta-Sample (The Sample of Samples)](#samples):
+
+![Glimmer Meta-Sample](images/glimmer-meta-sample.png)
+
+Glimmer Meta-Sample Code Example:
+
+```ruby
+# ...
+@code_text = code_text {
+  text bind(SampleDirectory, 'selected_sample.code', read_only: true)
+  editable bind(SampleDirectory, 'selected_sample.editable')
+}
+# ...
+```
+
+To use, simply use `code_text` in place of the `text` or `styled_text` widget. If you set its `text` value to Ruby code, it automatically styles it with syntax highlighting.
+
+###### Options
+
+**lines**
+(default: false)
+
+Shows line numbers when set to true.
+
+If set to a hash like `{width: 4}`, it sets the width of the line numbers lane in character count (default: 4)
+
+**theme**
+(default: 'glimmer')
+
+Changes syntax color highlighting theme. Can be one of the following:
+- glimmer
+- github
+- pastie
+
+**language**
+(default: `'ruby'`)
+
+Sets the code language, which can be one of the following [rouge gem](#https://rubygems.org/gems/rouge) supported languages:
+- abap
+- actionscript
+- ada
+- apache
+- apex
+- apiblueprint
+- apple_script
+- armasm
+- augeas
+- awk
+- batchfile
+- bbcbasic
+- bibtex
+- biml
+- bpf
+- brainfuck
+- brightscript
+- bsl
+- c
+- ceylon
+- cfscript
+- clean
+- clojure
+- cmake
+- cmhg
+- coffeescript
+- common_lisp
+- conf
+- console
+- coq
+- cpp
+- crystal
+- csharp
+- css
+- csvs
+- cuda
+- cypher
+- cython
+- d
+- dart
+- datastudio
+- diff
+- digdag
+- docker
+- dot
+- ecl
+- eex
+- eiffel
+- elixir
+- elm
+- email
+- epp
+- erb
+- erlang
+- escape
+- factor
+- fortran
+- freefem
+- fsharp
+- gdscript
+- ghc_cmm
+- ghc_core
+- gherkin
+- glsl
+- go
+- gradle
+- graphql
+- groovy
+- hack
+- haml
+- handlebars
+- haskell
+- haxe
+- hcl
+- hlsl
+- hocon
+- hql
+- html
+- http
+- hylang
+- idlang
+- igorpro
+- ini
+- io
+- irb
+- isbl
+- j
+- janet
+- java
+- javascript
+- jinja
+- jsl
+- json
+- json_doc
+- jsonnet
+- jsp
+- jsx
+- julia
+- kotlin
+- lasso
+- liquid
+- literate_coffeescript
+- literate_haskell
+- livescript
+- llvm
+- lua
+- lustre
+- lutin
+- m68k
+- magik
+- make
+- markdown
+- mason
+- mathematica
+- matlab
+- minizinc
+- moonscript
+- mosel
+- msgtrans
+- mxml
+- nasm
+- nesasm
+- nginx
+- nim
+- nix
+- objective_c
+- objective_cpp
+- ocaml
+- ocl
+- openedge
+- opentype_feature_file
+- pascal
+- perl
+- php
+- plain_text
+- plist
+- pony
+- postscript
+- powershell
+- praat
+- prolog
+- prometheus
+- properties
+- protobuf
+- puppet
+- python
+- q
+- qml
+- r
+- racket
+- reasonml
+- rego
+- rescript
+- robot_framework
+- ruby
+- rust
+- sas
+- sass
+- scala
+- scheme
+- scss
+- sed
+- shell
+- sieve
+- slice
+- slim
+- smalltalk
+- smarty
+- sml
+- solidity
+- sparql
+- sqf
+- sql
+- ssh
+- supercollider
+- swift
+- systemd
+- tap
+- tcl
+- terraform
+- tex
+- toml
+- tsx
+- ttcn3
+- tulip
+- turtle
+- twig
+- typescript
+- vala
+- varnish
+- vb
+- velocity
+- verilog
+- vhdl
+- viml
+- vue
+- wollok
+- xml
+- xojo
+- xpath
+- xquery
+- yaml
+- yang
+- zig
+
+Learn more at [Hello, Code Text!](#hello-code-text)
+
+##### Video Custom Custom Widget
+
+[![Video Widget](images/glimmer-video-widget.png)](https://github.com/AndyObtiva/glimmer-cw-video)
+
+Glimmer supports a [video custom widget](https://github.com/AndyObtiva/glimmer-cw-video) not in SWT, which was originally a Glimmer built-in custom widget, but has been later extracted into its own [Ruby gem](https://rubygems.org/gems/glimmer-cw-video).
+
+Simply install the [glimmer-cw-video](https://rubygems.org/gems/glimmer-cw-video) gem.
+
 #### Custom Widget Final Notes
 
 This [Eclipse guide](https://www.eclipse.org/articles/Article-Writing%20Your%20Own%20Widget/Writing%20Your%20Own%20Widget.htm) for how to write custom SWT widgets is also applicable to Glimmer Custom Widgets written in Ruby. I recommend reading it:
@@ -3496,6 +4016,8 @@ shell { |app_shell|
 }.open
 ```
 
+If you use a Custom Shell as the top-level app shell, you may invoke the class method `::launch` instead to avoid building an app class yourself or including Glimmer into the top-level namespace (e.g. `Tetris.launch` instead of `include Glimmer; tetris.open`)
+
 You may check out [Hello, Custom Shell!](#hello-custom-shell) for another example.
 
 ### Drag and Drop
@@ -3811,157 +4333,6 @@ You may run `glimmer` with the `--profile.graph` instead for a more detailed out
 
 Learn more at the [JRuby Performance Profile WIKI page](https://github.com/jruby/jruby/wiki/Profiling-JRuby).
 
-#### Checkbox Group Widget
-
-`checkbox_group` (or alias `check_group`) is a Glimmer built-in custom widget that displays a list of `checkbox` buttons (`button(:check)`) based on its `items` property.
-
-`checkbox_group` consists of a root `composite` (with `grid_layout 1, false` by default) that holds nested `checkbox` (`button(:check)`) widgets.
-
-The `selection` property determines which `checkbox` buttons are checked. It expects an `Array` of `String` objects
-The `selection_indices` property determines which `checkbox` button indices are checked. It expects an `Array` of index `Integer` objects that are zero-based.
-The `checkboxes` property returns the list of nested `checkbox` widgets.
-
-When data-binding `selection`, the model property should have a matching property with `_options` suffix (e.g. `activities_options` for `activities`) to provide an `Array` of `String` objects for `checkbox` buttons.
-
-You may see an example at the [Hello, Checkbox Group!](#hello-checkbox-group) sample.
-
-![Hello Checkbox Group](images/glimmer-hello-checkbox-group.png)
-
-#### Radio Group Widget
-
-`radio_group` is a Glimmer built-in custom widget that displays a list of `radio` buttons (`button(:radio)`) based on its `items` property, which expects an `Array` of `String` objects.
-
-`radio_group` consists of a root `composite` (with `grid_layout 1, false` by default) that holds nested `radio` widgets.
-
-The `selection` property determines which `radio` button is selected. It expects a `String`
-The `selection_index` property determines which `radio` button index is selected. It expects an index integer that is zero-based.
-The `radios` property returns the list of nested `radio` widgets.
-
-When data-binding `selection`, the model property should have a matching property with `_options` suffix (e.g. `country_options` for `country`) to provide text for `radio` buttons.
-
-This custom widget is used in the [Glimmer Meta-Sample (The Sample of Samples)](#samples):
-
-![Glimmer Meta-Sample](images/glimmer-meta-sample.png)
-
-Glimmer Meta-Sample Code Example:
-
-```ruby
-# ...
-radio_group { |radio_group_proxy|
-  row_layout(:vertical) {
-    fill true
-  }
-  selection bind(sample_directory, :selected_sample_name)
-  font height: 24
-}
-
-# ...
-```
-
-You may see another example at the [Hello, Radio Group!](#hello-radio-group) sample.
-
-#### Code Text Widget
-
-`code_text` is a Glimmer built-in custom widget that displays syntax highlighted Ruby code in a customized SWT [StyledText](https://help.eclipse.org/2020-09/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/custom/StyledText.html) widget.
-
-It is used in the [Glimmer Meta-Sample (The Sample of Samples)](#samples):
-
-![Glimmer Meta-Sample](images/glimmer-meta-sample.png)
-
-Glimmer Meta-Sample Code Example:
-
-```ruby
-# ...
-@code_text = code_text {
-  text bind(SampleDirectory, 'selected_sample.code', read_only: true)
-  editable bind(SampleDirectory, 'selected_sample.editable')
-}
-# ...
-```
-
-To use, simply use `code_text` in place of the `text` or `styled_text` widget. If you set its `text` value to Ruby code, it automatically styles it with syntax highlighting.
-
-#### Video Widget
-
-[![Video Widget](images/glimmer-video-widget.png)](https://github.com/AndyObtiva/glimmer-cw-video)
-
-Glimmer supports a [video custom widget](https://github.com/AndyObtiva/glimmer-cw-video) not in SWT.
-
-You may obtain via `glimmer-cw-video` gem.
-
-#### Sash Form Widget
-
-`sash_form` is an SWT built-in custom widget that provides a resizable sash that splits a window area into two or more panes.
-
-It can be customized with the `weights` attribute by setting initial weights to size the panes at first display.
-
-One noteworthy thing about the Glimmer implementation is that, unlike behavior in SWT, it allows declaring `weights` before the content of the `sash_form`, thus providing more natural and convenient syntax (Glimmer automatically takes care of sending that declaration to SWT at the end of declaring `sash_form` content as per the SWT requirements)
-
-Example (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
-
-```ruby
-shell {
-  text 'Sash Form Example'
-  sash_form {
-    label {
-      text '(resize >>)'
-      background :dark_green
-      foreground :white
-      font height: 20
-    }
-    label {
-      text '(<< resize)'
-      background :red
-      foreground :white
-      font height: 20
-    }
-    weights 1, 2
-  }
-}.open
-```
-
-You may check out a more full-fledged example in [Hello, Sash Form!](#hello-sash-form)
-
-![Hello Sash Form](images/glimmer-hello-sash-form.png)
-
-#### Browser Widget
-
-![Hello Browser](images/glimmer-hello-browser.png)
-
-Glimmer supports the SWT Browser widget, which can load URLs or render HTML. It can even be instrumented with JavaScript when needed (though highly discouraged since it defeats the purpose of using Ruby except in very rare cases like leveraging a pre-existing web codebase in a desktop app).
-
-Example loading a URL (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
-
-```ruby
-shell {
-  minimum_size 1024, 860
-  browser {
-    url 'http://brightonresort.com/about'
-  }
-}.open
-```
-
-Example rendering HTML with JavaScript on document ready (you may copy/paste in [`girb`](#girb-glimmer-irb-command) provided you install and require [glimmer-dsl-xml gem](https://github.com/AndyObtiva/glimmer-dsl-xml)):
-
-```ruby
-shell {
-  minimum_size 130, 130
-  @browser = browser {
-    text html {
-      head {
-        meta(name: "viewport", content: "width=device-width, initial-scale=2.0")
-      }
-      body {
-        h1 { "Hello, World!" }
-      }
-    }
-    on_completed { # on load of the page execute this JavaScript
-      @browser.swt_widget.execute("alert('Hello, World!');")
-    }
-  }
-}.open
-```
-
 ##### SWT Browser Style Options
 
 The `browser` widget can use a particular desktop browser by setting the SWT Style to:
@@ -4147,8 +4518,18 @@ end
 
 ### log_excluded_keywords
 
+(default = false)
+
 This just tells Glimmer whether to log excluded keywords or not (at the debug level). It is off by default.
 
+### auto_sync_exec
+
+(default = false)
+
+This automatically uses sync_exec on GUI calls from threads other than the main GUI thread instead of requiring users to manually use sync_exec. Default value to false.
+
+Keep in mind the caveat that it would force redraws on every minor changein the models instead of applying large scope changes all together, thus causing too much drawing/stutter in the GUI. As such, this is a good fit for simpler GUIs, not ones used with highly sophisticated 2D graphics. It may be mitigated in the future by introducing the idea of large-scale observation events that wrap around smaller events. Until then, keep the caveat in mind or just use sync_exec manually as usually done with Java SWT apps.
+
 ## Glimmer Style Guide
 
 - Widgets are declared with underscored lowercase versions of their SWT names minus the SWT package name.
@@ -4227,14 +4608,14 @@ You may edit the code of any sample before launching it by clicking on the "Laun
 Note that if you fail to run any sample through the Glimmer Meta-Sample for whatever reason, you could always run directly by cloning the project, running `bundle`, and then this command (drop the "bin" if you install the glimmer-dsl-swt gem instead):
 
 ```ruby
-bin/glimmer samples/hello/hello_canvas_transform.rb   
+bin/glimmer samples/hello/hello_canvas_transform.rb
 ```
 
 ### Hello Samples
 
 For hello-type simple samples, check the following.
 
-#### Hello, World! Sample
+#### Hello, World!
 
 Code:
 
@@ -4689,6 +5070,26 @@ Hello, Dialog! Open Dialog
 
 ![Hello Dialog Open Dialog](images/glimmer-hello-dialog-open-dialog.png)
 
+#### Hello, Code Text!
+
+This sample demonstrates the Glimmer Built-In [Code Text Custom Widget](#code-text-custom-widget).
+
+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 Ruby](images/glimmer-hello-code-text-ruby.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 HTML](images/glimmer-hello-code-text-html.png)
+
 #### Hello, Canvas!
 
 This sample demonstrates the use of the `canvas` widget and [Shape DSL](#canvas-shape-dsl) in Glimmer.
@@ -4758,7 +5159,7 @@ Code:
 ![Login Filled In](images/glimmer-login-filled-in.png)
 ![Login Logged In](images/glimmer-login-logged-in.png)
 
-#### Tic Tac Toe Sample
+#### Tic Tac Toe
 
 This sample demonstrates a full MVC application, including GUI layout, text and enablement data-binding, and test-driven development (has [specs](https://github.com/AndyObtiva/glimmer-dsl-swt/blob/master/spec/samples/elaborate/tic_tac_toe/board_spec.rb)).
 
@@ -4772,7 +5173,7 @@ Code:
 ![Tic Tac Toe In Progress](images/glimmer-tic-tac-toe-in-progress.png)
 ![Tic Tac Toe Game Over](images/glimmer-tic-tac-toe-game-over.png)
 
-#### Contact Manager Sample
+#### Contact Manager
 
 This sample demonstrates table data-binding, sorting, filtering, GUI layout, MVP pattern, and test-driven development (has [specs](https://github.com/AndyObtiva/glimmer-dsl-swt/blob/master/spec/samples/elaborate/contact_manager/contact_manager_presenter_spec.rb)).
 
@@ -4800,18 +5201,32 @@ Contact Manager - Edit Done
 
 ![Contact Manager](images/glimmer-contact-manager-edit-done.png)
 
-#### Tetris
+#### Glimmer Tetris
 
-This sample demonstrates how to build an interactive animated game with MVC architecture, custom-shell/custom-widgets, multi-threading, asynchronous programming, data-binding, canvas shape graphic decorations, and keyboard events.
+This sample demonstrates how to build an interactive animated game with MVC architecture, custom-shell/custom-widgets, multi-threading, asynchronous programming, data-binding, canvas shape graphic decorations, canvas shape icon image generation, and keyboard events/shortcuts.
 
 Code:
 
 [samples/elaborate/tetris.rb](samples/elaborate/tetris.rb)
 
+![Tetris Icon](images/glimmer-tetris-icon.png)
+
 ![Tetris](images/glimmer-tetris.png)
 
 ![Tetris Game Over](images/glimmer-tetris-game-over.png)
 
+![Tetris Game Over](images/glimmer-tetris-game-over-sorted-by-score.png)
+
+![Tetris High Scores](images/glimmer-tetris-high-score-dialog.png)
+
+![Tetris Game Menu](images/glimmer-tetris-game-menu.png)
+
+![Tetris View Menu](images/glimmer-tetris-view-menu.png)
+
+![Tetris Options Menu](images/glimmer-tetris-options-menu.png)
+
+![Tetris Help Menu](images/glimmer-tetris-help-menu.png)
+
 ### External Samples
 
 #### Glimmer Calculator