glimmer-dsl-swt 4.22.2.3 → 4.22.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20cdf050b145adb888f8e82caa9c8d90e5b076cab423bc795ed963a75c279fd4
-  data.tar.gz: 57e52e57c1fcc8dcc373dec79505fb1ee9547d4a50d4aa4e126395e689f91033
+  metadata.gz: ac45c3222d87e368de1345985c6300a82774a9380f5bf6f0741ad652e60adc1e
+  data.tar.gz: a4cad66af57489c224ecce5d4609d8b09e422d56b0aed463d6215383d69fcd3b
 SHA512:
-  metadata.gz: 7b6102a2d26c71dd635a5f8eadd9704ff263ee7124ac0428fe8dd53f661b893e7c08832e3fbcf17bbbc57b2e60754314d7943a2cce2a3be6bc2104205e1caef0
-  data.tar.gz: e9090d6f91a0b337e173f478c3371c47e9040d46af340e851f5d8e318ca66297fd0dc043814738b202e1ce0648987a46f4e5d27edf6fba3e81ff504779cd584d
+  metadata.gz: 9c5b1663e2f9cfaa118fdc4ec02064d2472bc92daf4a6d6012f1a7a1f98401cacd6b7a1009e5daa91d75b4626e431968be6fb2071c6c7dc25ff0359a481e5f41
+  data.tar.gz: d81508da3bbfd45f329f8c63187cf6babd11b719e5dfb668fd1a0ace62258143e168ab7b2b97d1e61a0aadaba657edfc7fcba4c1b71201332de8ff54e5686db6

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Change Log
 
+## 4.22.2.6
+
+- Fix issue whereby updating `string` property on the `text`/`string` shape does not trigger a redraw on the shape because the text dimensions remained the same despite the change of content (e.g. switching from `string` content of letter `A` to `S` results in the same dimensions)
+- Canvas Shape DSL graduated from Beta to Final
+
+## 4.22.2.5
+
+- Update all samples to match the [GLIMMER_STYLE_GUIDE.md](/docs/reference/GLIMMER_STYLE_GUIDE.md)
+- Update scaffolding code to match the [GLIMMER_STYLE_GUIDE.md](/docs/reference/GLIMMER_STYLE_GUIDE.md)
+
+## 4.22.2.4
+
+- Address the warning regarding using Ruby singletons on Java objects (shows up when running `glimmer samples`)
+- Fix order of calling `require 'app_name/view/app_view'` in scaffolded app (must be last)
+
 ## 4.22.2.3
 
 - Support `#content { }` on `layout_data`

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.22.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.22.2.6
 ## 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)
@@ -17,22 +17,25 @@ 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.22.2.3 includes [SWT 4.22](https://download.eclipse.org/eclipse/downloads/drops4/R-4.22-202111241800/), which was released on November 24, 2021. 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.22.2.6 includes [SWT 4.22](https://download.eclipse.org/eclipse/downloads/drops4/R-4.22-202111241800/), which was released on November 24, 2021. 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.
 
 Please help make [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) better by providing feedback and [contributing](#contributing) whenever possible. Any feature suggestions that are accepted could be implemented within weeks if not days.
 
-Other [Glimmer](https://github.com/AndyObtiva/glimmer) DSL gems you might be interested in:
-- [glimmer-dsl-opal](https://github.com/AndyObtiva/glimmer-dsl-opal): Glimmer DSL for Opal (Pure Ruby Web GUI and Auto-Webifier of Desktop Apps)
-- [glimmer-dsl-libui](https://github.com/AndyObtiva/glimmer-dsl-libui): Glimmer DSL for LibUI (Prerequisite-Free Ruby Desktop Development GUI Library)
-- [glimmer-dsl-tk](https://github.com/AndyObtiva/glimmer-dsl-tk): Glimmer DSL for Tk (MRI Ruby Desktop Development GUI Library)
-- [glimmer-dsl-gtk](https://github.com/AndyObtiva/glimmer-dsl-gtk): Glimmer DSL for GTK (Ruby-GNOME Desktop Development GUI Library)
-- [glimmer-dsl-fx](https://github.com/AndyObtiva/glimmer-dsl-fx): Glimmer DSL for FX (FOX Toolkit Ruby Desktop Development GUI Library)
-- [glimmer-dsl-jfx](https://github.com/AndyObtiva/glimmer-dsl-jfx): Glimmer DSL for JFX (JRuby JavaFX Desktop Development GUI Library)
-- [glimmer-dsl-swing](https://github.com/AndyObtiva/glimmer-dsl-swing): Glimmer DSL for Swing (JRuby Swing Desktop Development GUI Library)
-- [glimmer-dsl-xml](https://github.com/AndyObtiva/glimmer-dsl-xml): Glimmer DSL for XML (& HTML)
-- [glimmer-dsl-css](https://github.com/AndyObtiva/glimmer-dsl-css): Glimmer DSL for CSS
+**[Glimmer](https://github.com/AndyObtiva/glimmer) DSL Comparison Table:**
+DSL | Platforms | Native? | Vector Graphics? | Pros | Cons | Prereqs
+----|-----------|---------|------------------|------|------|--------
+[Glimmer DSL for SWT (JRuby Desktop Development GUI Framework)](https://github.com/AndyObtiva/glimmer-dsl-swt) | Mac / Windows / Linux | Yes | Yes (Canvas Shape DSL) | Very Mature / Scaffolding / Native Executable Packaging / Custom Widgets | Slow JRuby Startup Time / Heavy Memory Footprint | Java / JRuby
+[Glimmer DSL for Opal (Pure Ruby Web GUI and Auto-Webifier of Desktop Apps)](https://github.com/AndyObtiva/glimmer-dsl-opal) | All Web Browsers | No | Yes (Canvas Shape DSL) | Simpler than All JavaScript Technologies / Auto-Webify Desktop Apps | Setup Process / Incomplete Alpha | Rails
+[Glimmer DSL for LibUI (Prerequisite-Free Ruby Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-libui) | Mac / Windows / Linux | Yes | Yes (Area API) | Fast Startup Time / Light Memory Footprint | LibUI is an Incomplete Mid-Alpha Only | None Other Than MRI Ruby
+[Glimmer DSL for Tk (Ruby Tk Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-tk) | Mac / Windows / Linux | Some Native-Themed Widgets (Not Truly Native) | Yes (Canvas) | Fast Startup Time / Light Memory Footprint | Widgets Do Not Look Truly Native, Espcially on Linux | ActiveTcl / MRI Ruby
+[Glimmer DSL for GTK (Ruby-GNOME Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-gtk) | Mac / Windows / Linux | Only on Linux | Yes (Cairo) | Complete Access to GNOME Features on Linux (Forte) | Not Native on Mac and Windows | None Other Than MRI Ruby on Linux / Brew Packages on Mac / MSYS & MING Toolchains on Windows / MRI Ruby
+[Glimmer DSL for FX (FOX Toolkit Ruby Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-fx) | Mac (requires XQuartz) / Windows / Linux | No | Yes (Canvas) | No Prerequisites on Windows (Forte Since Binaries Are Included Out of The Box) | Widgets Do Not Look Native / Mac Usage Obtrusively Starts XQuartz | None Other Than MRI Ruby on Windows / XQuarts on Mac / MRI Ruby
+[Glimmer DSL for JFX (JRuby JavaFX Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-jfx) | Mac / Windows / Linux | No | Yes (javafx.scene.shape and javafx.scene.canvas) | Rich in Custom Widgets | Slow JRuby Startup Time / Heavy Memory Footprint / Widgets Do Not Look Native | Java / JRuby / JavaFX SDK
+[Glimmer DSL for Swing (JRuby Swing Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-swing) | Mac / Windows / Linux | No | Yes (Java2D) | Very Mature | Slow JRuby Startup Time / Heavy Memory Footprint / Widgets Do Not Look Native | Java / JRuby
+[Glimmer DSL for XML (& HTML)](https://github.com/AndyObtiva/glimmer-dsl-xml) | All Web Browsers | No | Yes (SVG) | Programmable / Lighter-weight Than Actual XML | XML Elements Are Sometimes Not Well-Named (Many Types of Input) | None
+[Glimmer DSL for CSS](https://github.com/AndyObtiva/glimmer-dsl-css) | All Web Browsers | No | Yes | Programmable | CSS Is Over-Engineered / Too Many Features To Learn | None
 
 ## Examples
 
@@ -328,7 +331,7 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.22.2.3
+jgem install glimmer-dsl-swt -v 4.22.2.6
 ```
 
 `jgem` is JRuby's version of `gem` command.
@@ -356,7 +359,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.22.2.3'
+gem 'glimmer-dsl-swt', '~> 4.22.2.6'
 ```
 
 And, then run:
@@ -379,7 +382,7 @@ glimmer
 ```
 
 ```
-Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.22.2.3
+Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.22.2.6
       
 Usage: glimmer [--bundler] [--pd] [--quiet] [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
 
@@ -456,13 +459,15 @@ In a nutshell, the Glimmer GUI DSL syntax consists mainly of:
 
 1. Keywords
 
+Widgets are declared with keywords denoting their name in underscored format.
+
 Example of a keyword representing a table widget:
 
 ```ruby
 table
 ```
 
-2. Style/Args
+Widgets may optionally receive symbol-style/args within parentheses (otherwise, when there are no style/args, the parentheses are left out).
 
 Example of a multi-line selection table widget:
 
@@ -470,7 +475,9 @@ Example of a multi-line selection table widget:
 table(:multi)
 ```
 
-3. Content/Properties
+2. Content/Properties
+
+Widget content is always housed within a curly-brace (`{}`) style block.
 
 Example of a multi-line selection table widget with a table column as content that has a header `text` property as 'Name'.
 
@@ -482,6 +489,37 @@ table(:multi) {
 }
 ```
 
+3. Listeners 
+
+Listeners embody the [Observer Design Pattern](https://en.wikipedia.org/wiki/Observer_pattern) and always start with `on_` followed by an event name (e.g. `on_widget_selected`). Also, they are an exception to Glimmer's syntax that requires a `do; end` style block to clearly demarcate as logic as opposed to View syntax.
+
+Example of a button widget with a `text` property and an `on_widget_selected` listener.
+
+```ruby
+button {
+  text 'Click'
+  
+  on_widget_selected do
+    message_box {
+      text 'Clicked'
+      message 'Thank you for clicking!'
+    }.open
+  end
+}
+```
+
+4. Methods
+
+Widgets have methods that invoke operations on them. Sometimes, they are required to be called in order to display the widgets (like the `open` method on `shell` and `message_box`)
+
+Example of a shell with a `text` property and an invoked `open` method operation.
+
+```ruby
+shell {
+  text 'Hello, World!'
+}.open
+```
+
 If you need more widgets, you can check out the [Nebula Project](https://github.com/AndyObtiva/glimmer-cw-nebula) (50+ enterprise-grade custom widgets)
 
 Learn more at:
@@ -527,10 +565,14 @@ If you have a Glimmer app you would like referenced here, please mention in a Pu
 
 ### Are We There Yet?
 
+This [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) application connects to a database using [ActiveRecord](https://rubygems.org/gems/activerecord).
+
 [<img alt="Are We There Yet Logo" src="https://raw.githubusercontent.com/AndyObtiva/are-we-there-yet/master/are-we-there-yet-logo.svg" width="40" />Are We There Yet?](https://github.com/AndyObtiva/are-we-there-yet): A tool that helps you learn when your small projects will finish
 
 ### Garderie Rainbow Daily Agenda
 
+This [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) application connects to a [Rails](https://rubyonrails.org/) server to submit an application.
+
 [<img alt="Garderie Rainbow Daily Agenda Logo" src="https://github.com/AndyObtiva/garderie_rainbow_daily_agenda/raw/master/images/garderie_rainbow_daily_agenda_logo.png" width="40" />Garderie Rainbow Daily Agenda](https://github.com/AndyObtiva/garderie_rainbow_daily_agenda): A child nursery daily agenda reporting desktop app
 
 ### Glimmer Gab
@@ -549,6 +591,14 @@ If you have a Glimmer app you would like referenced here, please mention in a Pu
 
 [Befunge 98 GUI](https://github.com/AndyObtiva/befunge98/tree/gui)
 
+### Glimmer Metronome
+
+[<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer_metronome/master/icons/linux/Glimmer%20Metronome.png" height=40 /> Glimmer Metronome](https://github.com/AndyObtiva/glimmer_metronome)
+
+### Glimmer Wordle
+
+[<img src='https://raw.githubusercontent.com/AndyObtiva/glimmer_wordle/master/icons/linux/Glimmer Wordle.png' height=40 /> Glimmer Wordle - Word Game](https://github.com/AndyObtiva/glimmer_wordle)
+
 ## Packaging & Distribution
 
 Glimmer simplifies the process of native-executable packaging and distribution on Mac and Windows via a single command:
@@ -586,6 +636,7 @@ Learn more by reading the [GPG](https://github.com/AndyObtiva/glimmer/blob/maste
 
 ## Resources
 
+* [Glimmer DSL for SWT Video Tutorials](https://andymaleh.blogspot.com/search/label/Tutorial+SWT)
 * [Code Master Blog](http://andymaleh.blogspot.com/search/label/Glimmer)
 * [JRuby Cookbook by Justin Edelson & Henry Liu](http://shop.oreilly.com/product/9780596519650.do)
 * [InfoQ Article](http://www.infoq.com/news/2008/02/glimmer-jruby-swt)

data/VERSION

@@ -1 +1 @@
-4.22.2.3
+4.22.2.6

data/docs/reference/GLIMMER_COMMAND.md

@@ -10,6 +10,8 @@ glimmer
 
 On Mac and Linux, it additionally brings up a TUI (Text-based User Interface) for interactive navigation and execution of Glimmer tasks (courtesy of [rake-tui](https://github.com/AndyObtiva/rake-tui)).
 
+(note that in ARM64 machines, the TUI does not seem to work at the moment, so simply use glimmer commands directly without the TUI until this is fixed)
+
 On Windows, it simply lists the available Glimmer tasks at the end (courtsey of [rake](https://github.com/ruby/rake)).
 
 If you are new to Glimmer, you may read the Basic Usage section and skip the rest until you have gone through [Girb (Glimmer irb) Command](#girb-glimmer-irb-command), [Glimmer GUI DSL Syntax](#glimmer-gui-dsl-syntax), and [Samples](#samples).
@@ -107,7 +109,7 @@ glimmer samples/hello/hello_world.rb samples/hello/hello_tab.rb
 
 Launches samples/hello/hello_world.rb and samples/hello_tab.rb at the same time, each in a separate JRuby thread.
 
-Note: under Zsh (Z Shell), glimmer can only be used in its advanced TUI mode (e.g. `glimmer` and then selecting a task) not the primitive rake task mode (e.g. `glimmer scaffold[app]`)
+Note: under Zsh (Z Shell), glimmer can only be used in its advanced \ mode (e.g. `glimmer` and then selecting a task) not the primitive rake task mode (e.g. `glimmer scaffold[app]`)
 
 ### Glimmer Samples
 

data/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md

@@ -1736,8 +1736,6 @@ https://help.eclipse.org/2019-12/nftopic/org.eclipse.platform.doc.isv/reference/
 
 ### Canvas Shape DSL
 
-**(BETA FEATURE)**
-
 While other GUI toolkits only offer a way to draw graphics imperatively (e.g. draw_arc, draw_rectangle, move_to, line_to, etc...), Glimmer DSL for SWT breaks away from the mold by enabling software engineers to draw graphics declaratively. Simply declare all the shapes you want to see with their attributes, like background/foreground colors, and Glimmer DSL for SWT takes care of the rest, painting graphics on a blank `canvas` widget or amending/decorating an existing widget. This is accomplished through the Canvas Shape DSL, a sub-DSL of the Glimmer GUI DSL, which makes it possible to draw graphics declaratively with very understandable and maintainable syntax. Still, for the rare cases where imperative logic is needed, Glimmer DSL for SWT supports imperative painting of graphics through direct usage of SWT.
 
 ![Canvas Shape DSL Line](/images/glimmer-canvas-shape-dsl-line.png)
@@ -2723,8 +2721,6 @@ Check [Hello, Canvas!](/docs/reference/GLIMMER_SAMPLES.md#hello-canvas) for an e
 
 #### Pixel Graphics
 
-**(BETA FEATURE)**
-
 If you need to paint pixel graphics, use the optimized `pixel` keyword alternative to `point`, which takes foreground as a hash argument and bypasses the [Glimmer DSL Engine chain of responsibility](https://github.com/AndyObtiva/glimmer#dsl-engine), thus rendering faster when having very large pixel counts.
 
 Example (you may copy/paste in [`girb`](GLIMMER_GIRB.md)):
@@ -2905,8 +2901,6 @@ As they say, there are many ways to skin a cat! This is in line with the Ruby wa
 
 ### Canvas Path DSL
 
-**(BETA FEATURE)**
-
 Unlike common imperative GUI graphing toolkits, Glimmer enables declarative rendering of paths with the new Canvas Path DSL (Early Alpha) via the new `path { }` keyword and by nesting one of the following path segment keywords underneath:
 - `point(x1, y1)`: renders a Point (Dot) as part of a path.
 - `line(x1, y1, x2=nil, y2=nil)`: renders a Line as part of a path. If you drop x2, y2, it joins to the previous point automatically. You may repeat for a series of lines forming a curve.
@@ -2951,8 +2945,6 @@ Every path segment object (mixing in [`Glimmer::SWT::Custom::PathSegment`](/lib/
 
 ### Canvas Transform DSL
 
-**(BETA FEATURE)**
-
 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.
 
 `transform` keyword builds a `Transform` object. It optionally takes the transformation matrix elements: (m11, m12, m21, m22, dx, dy)
@@ -3811,7 +3803,7 @@ Custom widgets are brand new Glimmer DSL keywords that represent aggregates of e
 
 You can find out about [published Glimmer Custom Widgets](https://github.com/AndyObtiva/glimmer-dsl-swt#gem-listing) by running the `glimmer list:gems:customwidget` command
 
-Glimmer supports three ways of creating custom widgets with minimal code:
+Glimmer supports two ways of creating custom widgets with minimal code:
 1. Method-based Custom Widgets (for single-view-internal reuse): Extract a method containing Glimmer DSL widget syntax. Useful for quickly eliminating redundant code within a single view.
 2. Class-based Custom Widgets (for multiple-view-external reuse): Create a class that includes the `Glimmer::UI::CustomWidget` module and Glimmer DSL widget syntax in a `body {}` block. This will automatically extend Glimmer's DSL syntax with an underscored lowercase keyword matching the class name by convention. Useful in making a custom widget available in many views.
 
@@ -4429,9 +4421,11 @@ Also, you may check out [Hello, Custom Widget!](/docs/reference/GLIMMER_SAMPLES.
 
 ### Custom Shells
 
-Custom shells are a kind of custom widgets that have shells only as the body root. They can be self-contained applications that may be opened and hidden/closed independently of the main app.
+Custom shell is a kind of a [custom widget](#custom-widgets) that has `shell` (window) as the body root widget. It can be used to represent an application or a reusable window that may be opened/hidden/closed independently of the main application.
+
+Except in the case of small demos, it is always recommended to build [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) applications as custom shells.
 
-They may also be chained in a wizard fashion.
+Custom shells may also be chained in a wizard fashion in some cases.
 
 You can find out about [published Glimmer Custom Shells](https://github.com/AndyObtiva/glimmer-dsl-swt#gem-listing) by running the `glimmer list:gems:customshell` command
 
@@ -4468,33 +4462,41 @@ class WizardStep
   }
 end
 
-shell { |app_shell|
-  text "Wizard"
-  minimum_size 200, 100
-  @current_step_number = 1
-  @wizard_steps = 5.times.map { |n|
-    wizard_step(number: n+1, step_count: 5) {
-      on_swt_hide do
-        if @current_step_number < 5
-          @current_step_number += 1
+class Wizard
+  include Glimmer::UI::CustomShell
+
+  body {
+    shell { |app_shell|
+      text "Wizard"
+      minimum_size 200, 100
+      @current_step_number = 1
+      @wizard_steps = 5.times.map { |n|
+        wizard_step(number: n+1, step_count: 5) {
+          on_swt_hide do
+            if @current_step_number < 5
+              @current_step_number += 1
+              app_shell.hide
+              @wizard_steps[@current_step_number - 1].open
+            end
+          end
+        }
+      }
+      button {
+        text "Start"
+        font height: 40
+        on_widget_selected do
           app_shell.hide
           @wizard_steps[@current_step_number - 1].open
         end
-      end
+      }
     }
   }
-  button {
-    text "Start"
-    font height: 40
-    on_widget_selected do
-      app_shell.hide
-      @wizard_steps[@current_step_number - 1].open
-    end
-  }
-}.open
+end
+
+Wizard.launch
 ```
 
-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`)
+If you use a Custom Shell as the top-level app shell, you may invoke the class method `.launch` instead of `open` 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!](/docs/reference/GLIMMER_SAMPLES.md#hello-custom-shell) for another example.
 

data/docs/reference/GLIMMER_SAMPLES.md

@@ -85,7 +85,6 @@
     - [Gladiator](#gladiator)
     - [Timer](#timer)
     - [Glimmer Klondike Solitaire](#glimmer-klondike-solitaire)
-    - [Glimmer Metronome](#glimmer-metronome)
 - [License](#license)
 
 ## Samples
@@ -1336,6 +1335,8 @@ This sample demonstrates a Metronome that accepts a beat count and bpm rate, tic
 
 It takes advantage of the Canvas Shape DSL, data-binding, and the Java Sound library. It employs a hybrid approach of relying on standard widget layouts (grid layout) and canvas shape x,y placement.
 
+An external more full-fledged version exists too as [Glimmer Metronome](https://github.com/AndyObtiva/glimmer_metronome).
+
 Code:
 
 [samples/elaborate/metronome.rb](/samples/elaborate/metronome.rb)
@@ -1429,14 +1430,6 @@ This is a souped up version of the Klondike Solitaire elaborate sample, which is
 
 ![Glimmer Klondike Solitaire](https://raw.githubusercontent.com/AndyObtiva/glimmer_klondike_solitaire/master/images/glimmer-klondike-solitaire.png)
 
-#### Glimmer Metronome
-
-This is an external enhanced version of [Metronome](#metronome) that can be packaged as an independent native executable.
-
-[<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer_metronome/master/icons/linux/Glimmer%20Metronome.png" height=40 /> Glimmer Metronome](https://github.com/AndyObtiva/glimmer_metronome)
-
-![Metronome](https://raw.githubusercontent.com/AndyObtiva/glimmer_metronome/master/screenshots/glimmer-metronome.png)
-
 ## License
 
 [MIT](LICENSE.txt)

data/lib/glimmer/launcher.rb

@@ -72,10 +72,13 @@ module Glimmer
         OPERATING_SYSTEMS_SUPPORTED.detect {|os| OS.send("#{os}?")}
       end
       
-      def special_cpu_architecture_suffix
+      def is_arm64?
         host_cpu = OS.host_cpu.downcase
-        special = host_cpu.include?('aarch64') || host_cpu.include?('arm')
-        special ? "_aarch64" : ''
+        host_cpu.include?('aarch64') || host_cpu.include?('arm')
+      end
+      
+      def special_cpu_architecture_suffix
+        is_arm64? ? "_aarch64" : ''
       end
 
       def swt_jar_file
@@ -187,7 +190,7 @@ module Glimmer
     end
     
     def display_tasks
-      if OS.windows?
+      if OS.windows? || Launcher.is_arm64?
         require 'rake'
         Rake::TaskManager.record_task_metadata = true
         require_relative 'rake_task'

data/lib/glimmer/rake_task/scaffold.rb

@@ -443,13 +443,14 @@ module Glimmer
               require 'glimmer-dsl-swt'
               # add more gems if needed
             end
-            require '#{file_name(app_name)}/view/app_view'
-    
+            
             class #{class_name(app_name)}
               APP_ROOT = File.expand_path('../..', __FILE__)
               VERSION = File.read(File.join(APP_ROOT, 'VERSION'))
               LICENSE = File.read(File.join(APP_ROOT, 'LICENSE.txt'))
             end
+    
+            require '#{file_name(app_name)}/view/app_view'
           MULTI_LINE_STRING
         end
     
@@ -596,12 +597,13 @@ module Glimmer
         Display.app_name = '#{shell_type == :gem ? human_name(custom_shell_name) : human_name(namespace)}'
         Display.app_version = VERSION
         @display = display {
-          on_about {
+          on_about do
             display_about_dialog
-          }
-          on_preferences {
+          end
+          
+          on_preferences do
             #{shell_type == :desktopify ? 'display_about_dialog' : 'display_preferences_dialog'}
-          }
+          end
         }
       end
             MULTI_LINE_STRING
@@ -657,17 +659,21 @@ module Glimmer
           menu_bar {
             menu {
               text '&File'
+              
               menu_item {
                 text '&About...'
-                on_widget_selected {
+                
+                on_widget_selected do
                   display_about_dialog
-                }
+                end
               }
+              
               menu_item {
                 text '&Preferences...'
-                on_widget_selected {
+                
+                on_widget_selected do
                   #{shell_type == :desktopify ? 'display_about_dialog' : 'display_preferences_dialog'}
-                }
+                end
               }
             }
           }
@@ -696,31 +702,37 @@ module Glimmer
             custom_shell_file_content += <<-MULTI_LINE_STRING
       def display_preferences_dialog
         dialog(swt_widget) {
-          text 'Preferences'
           grid_layout {
             margin_height 5
             margin_width 5
           }
+          
+          text 'Preferences'
+          
           group {
             row_layout {
               type :vertical
               spacing 10
             }
+            
             text 'Greeting'
             font style: :bold
+            
             [
               'Hello, World!',
               'Howdy, Partner!'
             ].each do |greeting_text|
               button(:radio) {
-                text greeting_text
-                selection <= [self, :greeting, on_read: ->(g) { g == greeting_text }]
                 layout_data {
                   width 160
                 }
-                on_widget_selected { |event|
+                
+                text greeting_text
+                selection <= [self, :greeting, on_read: ->(g) { g == greeting_text }]
+                
+                on_widget_selected do |event|
                   self.greeting = event.widget.getText
-                }
+                end
               }
             end
           }
@@ -822,6 +834,7 @@ end
             background background_color
             cubic size_width - size_width*0.66, size_height/2 - size_height*0.33, size_width*0.65 - size_width*0.66, 0 - size_height*0.33, size_width/2 - size_width*0.66, size_height*0.75 - size_height*0.33, size_width - size_width*0.66, size_height - size_height*0.33
           }
+          
           path {
             background background_color
             cubic size_width - size_width*0.66, size_height/2 - size_height*0.33, size_width*1.35 - size_width*0.66, 0 - size_height*0.33, size_width*1.5 - size_width*0.66, size_height*0.75 - size_height*0.33, size_width - size_width*0.66, size_height - size_height*0.33

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

@@ -1026,14 +1026,17 @@ module Glimmer
         
         def ensure_extent(paint_event)
           old_extent = @extent
+          old_extent_args = @extent_args
           if ['text', 'string'].include?(@name)
             extent_args = [string]
             extent_flags = SWTProxy[:draw_transparent, :draw_delimiter] if current_parameter_name?(:is_transparent) && is_transparent
             extent_flags = flags if current_parameter_name?(:flags)
             extent_args << extent_flags unless extent_flags.nil?
             self.extent = paint_event.gc.send("#{@name}Extent", *extent_args)
+            @extent_args = extent_args
           end
-          if !@extent.nil? && (old_extent&.x != @extent&.x || old_extent&.y != @extent&.y) # TODO add a check to text content changing too
+          # comparing extent_args with old ones ensures that if content changes, calculated_args_changed! is called
+          if !@extent.nil? && (old_extent&.x != @extent&.x || old_extent&.y != @extent&.y || @extent_args != old_extent_args)
             calculated_args_changed!
             parent.calculated_args_changed_for_defaults! if parent.is_a?(Shape)
           end
@@ -1101,10 +1104,11 @@ module Glimmer
             default_x? && x_delta,
             default_y? && default_y,
             default_y? && y_delta,
+            (['text', 'string'].include?(@name) && string),
           ]
           if calculated_args_dependencies != @calculated_args_dependencies
             # avoid recalculating values again
-            x, y, parent_absolute_x, parent_absolute_y, default_width, default_width_delta, default_height, default_height_delta, max_width, max_width_delta, max_height, max_height_delta, default_x, default_x_delta, default_y, default_y_delta = @calculated_args_dependencies = calculated_args_dependencies
+            x, y, parent_absolute_x, parent_absolute_y, default_width, default_width_delta, default_height, default_height_delta, max_width, max_width_delta, max_height, max_height_delta, default_x, default_x_delta, default_y, default_y_delta, string = @calculated_args_dependencies = calculated_args_dependencies
             # Note: Must set x and move_by because not all shapes have a real x and some must translate all their points with move_by
             # TODO change that by setting a bounding box for all shapes with a calculated top-left x, y and
             # a setter that does the moving inside them instead so that I could rely on absolute_x and absolute_y

data/lib/glimmer/swt/image_proxy.rb

@@ -97,6 +97,7 @@ module Glimmer
         end
         proxy = self
         # TODO consider adding a get_data/set_data method to conform with other SWT widgets
+        @swt_image.class.__persistent__ = true
         @swt_image.singleton_class.define_method(:dispose) do
           proxy.clear_shapes
           super()

data/samples/elaborate/calculator.rb

@@ -21,14 +21,14 @@ class Calculator
     Display.setAppName('Glimmer Calculator')
     
     display {
-      on_swt_keydown { |key_event|
+      on_swt_keydown do |key_event|
         char = key_event.character.chr rescue nil
         @presenter.press(char)
-      }
+      end
       
-      on_about {
+      on_about do
         display_about_dialog
-      }
+      end
     }
   end
 
@@ -59,16 +59,16 @@ class Calculator
       operation_button('÷')
       operation_button('×')
       operation_button('−')
-      (7..9).each { |number|
+      (7..9).each do |number|
         number_button(number)
-      }
+      end
       operation_button('+', font: BUTTON_FONT_BIG, vertical_span: 2)
-      (4..6).each { |number|
+      (4..6).each do |number|
         number_button(number)
-      }
-      (1..3).each { |number|
+      end
+      (1..3).each do |number|
         number_button(number)
-      }
+      end
       command_button('=', font: BUTTON_FONT_BIG, vertical_span: 2)
       number_button(0, horizontal_span: 2)
       operation_button('.')
@@ -98,9 +98,9 @@ class Calculator
         vertical_span options[:vertical_span]
       }
       
-      on_widget_selected {
+      on_widget_selected do
         @presenter.press(command)
-      }
+      end
     }
   end