glimmer-dsl-tk 0.0.18 → 0.0.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa03163d6b0577d65e67d245b810079da4ddd6aca50cde649963e9448defe1ee
-  data.tar.gz: 3d2cadbe0dff5e003ada1938a461785b11d5899d671d12f998b0c783983fa4dc
+  metadata.gz: 9d722c9396a9adb7252e4fc65c283fbf923dbe0cb93e17a9d34649ea887f5e56
+  data.tar.gz: 20682a6aa497800f683b87fc180754a58a96362a5a286fab3754bc38edd5d084
 SHA512:
-  metadata.gz: 6160cea03e0e6ed6e1511271cd780db176ba569b2774e9a304749e612ec242ad65d611dce0c475f29dfe3f9dce869bee8c660825a90fff0b3a0f5315cf7fbb47
-  data.tar.gz: abc75b8c436416257770b9af8e38470bbf4ab53f448a281c6626fa56ef7617ffee4d551038fa9618b00d33cd63f9c8cf19f51b311406497e1ce99a54ba22d2f0
+  metadata.gz: 77c488d614a997861369fd032fc1ebc578bee01aa8367c0fd267b99442ec462769f0218c11e236533b3443558294c2ca0940c773777698f4216df85cd1179243
+  data.tar.gz: 521a5c5e3db695b7938fc225619779114e32c06fa2bce870de16f233597d212b3662218a101e95921733c58f4ea02764598167eaa507835bbb25855187566b6a

data/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Change Log
 
+## 0.0.23
+
+- Hello, Radiobutton!
+- Support `radiobutton` ensuring that sibling radio buttons share the same variable to achieve mutually exclusive selection
+- Improved Hello, Checkbutton! sample to demonstrate alternate checkbutton value (half-checked state)
+- Support `checkbutton` with specified `onvalue` and `offvalue` (when they do not have values 1 and 0)
+- Alias `root` `title` attribute as `text` & add children attribute to widgets
+- Alias `notebook` `frame` `:title` as `:text`
+- Alias message_box `:title` as `:text`
+- Fix reference to `Glimmer::Tk::CheckbuttonProxy` (was `Glimmer::Tk::ChecktbuttonProxy`)
+
+## 0.0.22
+
+- Hello, Checkbutton!
+- Support checkbutton data-binding
+
+## 0.0.21
+
+- Support event bindings via `on(event) {}` syntax nestable under any widget
+- Support `root` event binding: `'WM_DELETE_WINDOW'` and alias `'DELETE_WINDOW'`
+- Support `root` event binding: `'OPEN_WINDOW'`
+- Support `root` attribute: `background` (any color including `systemTransparent`)
+- Support `root` boolean attribute: `alpha`
+- Support `root` boolean attributes: `fullscreen`, `topmost`, `transparent`
+- Support `root` attributes: `stackorder`, `winfo_screendepth`, `winfo_screenvisual`, `winfo_screenwidth`, `winfo_screenheight`, `winfo_pixels('li')`, `winfo_screen`, `wm_maxsize`
+- Support `root` attribute: `state` (`'normal', 'iconic', 'withdrawn', 'icon', 'zoomed'`)
+
+## 0.0.20
+
+- Hello, Root! sample
+- Support `root` `width`, `height`, `x`, `y` attributes
+- Support `root` attribute: `resizable`
+- Support `root` attribute: `minsize`
+- Support `root` attribute: `maxsize`
+- Set minimum width/height on `root` (190 pixels)
+
 ## 0.0.18
 
 - Hello, Frame! sample

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 Tk 0.0.18
+# [<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 Tk 0.0.23
 ## MRI Ruby Desktop Development GUI Library
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-tk.svg)](http://badge.fury.io/rb/glimmer-dsl-tk)
 [![Ruby](https://github.com/AndyObtiva/glimmer-dsl-tk/actions/workflows/ruby.yml/badge.svg)](https://github.com/AndyObtiva/glimmer-dsl-tk/actions/workflows/ruby.yml)
@@ -83,17 +83,22 @@ Other [Glimmer](https://github.com/AndyObtiva/glimmer) DSL gems:
       - [Icon Photo](#icon-photo)
   - [The Grid Geometry Manager](#the-grid-geometry-manager)
   - [Bidirectional Data-Binding](#bidirectional-data-binding)
-    - [General Property Data-Binding](#general-property-data-binding)
+    - [Label Data-Binding](#label-data-binding)
     - [Combobox Data-Binding](#combobox-data-binding)
     - [List Single Selection Data-Binding](#list-single-selection-data-binding)
     - [List Multi Selection Data-Binding](#list-multi-selection-data-binding)
     - [Entry Data-Binding](#entry-data-binding)
-  - [Command Observer](#command-observer)
+    - [Checkbutton Data-Binding](#checkbutton-data-binding)
+    - [Radiobutton Data-Binding](#radiobutton-data-binding)
+  - [Command Callback](#command-callback)
   - [Gotchas](#gotchas)
   - [Samples](#samples)
     - [Hello, World!](#hello-world)
     - [Hello, Button!](#hello-button)
+    - [Hello, Checkbutton!](#hello-checkbutton)
+    - [Hello, Radiobutton!](#hello-radiobutton)
     - [Hello, Frame!](#hello-frame)
+    - [Hello, Root!](#hello-root)
     - [Hello, Notebook!](#hello-notebook)
     - [Hello, Label!](#hello-label)
     - [Hello, Message Box!](#hello-message-box)
@@ -119,7 +124,7 @@ Other [Glimmer](https://github.com/AndyObtiva/glimmer) DSL gems:
 For example, on the Mac, you can:
 - Install the ActiveTcl Mac package from [ActiveState.com](https://activestate.com)
 - Install [RVM](https://rvm.io/) by running `\curl -sSL https://get.rvm.io | bash -s stable` (and run `curl -sSL https://rvm.io/pkuczynski.asc | gpg --import -` if needed for mentioned security reasons)
-- Run: `rvm install 2.7.1 --enable-shared --enable-pthread --with-tk --with-tcl`
+- Run: `rvm install 3.0.2 --enable-shared --enable-pthread --with-tk --with-tcl`
 - Run: `gem install tk -v0.4.0`
 
 Afterwards, if you open `irb`, you should be able to run `require 'tk'` successfully.
@@ -137,7 +142,7 @@ gem install glimmer-dsl-tk
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer-dsl-tk', '~> 0.0.18'
+gem 'glimmer-dsl-tk', '~> 0.0.23'
 ```
 
 And, then run:
@@ -179,6 +184,7 @@ The Glimmer GUI DSL follows these simple concepts in mapping from Tk syntax:
 - **Widget Keyword**: Any Tk widget (e.g. `Tk::Tile::Label`) or toplevel window (e.g. `TkRoot`) may be declared by its lower-case underscored name without the namespace (e.g. `label` or `root`). This is called a keyword and is represented in the Glimmer GUI DSL by a Ruby method behind the scenes.
 - **Args**: Any keyword method may optionally take arguments surrounded by parentheses (e.g. a `frame` nested under a `notebook` may receive tab options like `frame(text: 'Users')`, which gets used behind the scenes by Tk code such as `notebook.add tab, text: 'Users'`)
 - **Content/Options Block**: Any keyword may optionally be followed by a Ruby curly-brace block containing nested widgets (content) and attributes (options). Attributes are simply Tk option keywords followed by arguments and no block (e.g. `title 'Hello, World!'` under a `root`)
+- **Event Binding Block**: `on(event) {}` keyword receiving a Tk binding event name (e.g. `KeyPress` or `ComboboxSelected`). No need to surround event by `<>` as [Glimmer DSL for Tk](https://rubygems.org/gems/glimmer-dsl-tk) takes care of that automatically.
 
 Example of an app written in [Tk](https://www.tcl.tk/) imperative syntax:
 
@@ -198,6 +204,15 @@ notebook.add tab2, text: 'French'
 label2 = ::Tk::Tile::Label.new(tab2).grid
 label2.text = 'Bonjour, Univers!'
 
+root.bind('KeyPress') do |event|
+  case event.keysym
+  when 'e', 'E'
+    notebook.select(0)
+  when 'f', 'F'
+    notebook.select(1)
+  end
+end
+
 root.mainloop
 ```
 
@@ -207,7 +222,7 @@ Example of the same app written in [Glimmer](https://github.com/AndyObtiva/glimm
 root {
   title 'Hello, Notebook!'
    
-  notebook {
+  @notebook = notebook {
     frame(text: 'English') {
       label {
         text 'Hello, World!'
@@ -220,6 +235,15 @@ root {
       }
     }
   }
+  
+  on('KeyPress') do |event|
+    case event.keysym
+    when 'e', 'E'
+      @notebook.select(0)
+    when 'f', 'F'
+      @notebook.select(1)
+    end
+  end
 }.open
 ```
 
@@ -227,19 +251,53 @@ root {
 
 keyword(args) | attributes | event bindings & callbacks
 ------------- | ---------- | ---------
-`button` | `text`, `image` (optional keyword args: `subsample`, `zoom`, `from`, `to`, `shrink`, `compositingrule`), `compound` (`'center', 'top', 'bottom', 'left', 'right'`), `default` (`'active', 'normal'`) | `command`
+`button` | `text`, `image` (optional keyword args: `subsample`, `zoom`, `from`, `to`, `shrink`, `compositingrule`), `compound` (`'center', 'top', 'bottom', 'left', 'right'`), `default` (`'active', 'normal'`) | `command {}`
+`checkbutton` | `text`, `variable` (Boolean), `image` (optional keyword args: `subsample`, `zoom`, `from`, `to`, `shrink`, `compositingrule`), `compound` (`'center', 'top', 'bottom', 'left', 'right'`), `onvalue` (default: `1`), `offvalue` (default: `0`) | `command {}`
+`combobox` | `state`, `text` | `'ComboboxSelected'`
 `entry` | `width`, `text` | None
 `frame(text: nil)` | `width`, `height`, `borderwidth`, `relief` (`'flat' (default), 'raised', 'sunken', 'solid', 'ridge', 'groove'`) | None
 `label` | `text`, `image` (optional keyword args: `subsample`, `zoom`, `from`, `to`, `shrink`, `compositingrule`), `compound` (`'center', 'top', 'bottom', 'left', 'right'`), `font` (`'default', 'text', 'fixed', 'menu', 'heading', 'caption', 'small_caption', 'icon', 'tooltip'`), `relief` (`'flat' (default), 'raised', 'sunken', 'solid', 'ridge', 'groove'`), `justify` (`'left', 'center', 'right'`), `foreground`, `background` | None
 `list` | `selectmode`, `selection` | None
 `message_box(type: , message: , detail: , title: , icon: , default: , parent: )` | None | None
 `notebook` | None | None
-`root` | `title`, `iconphoto` | None
+`radiobutton` | `text`, `variable` (Boolean), `image` (optional keyword args: `subsample`, `zoom`, `from`, `to`, `shrink`, `compositingrule`), `compound` (`'center', 'top', 'bottom', 'left', 'right'`), `value` (default: `text`) | `command {}`
+`root` | `title`, `iconphoto`, `background`, `alpha`, `fullscreen?`, `topmost?`, `transparent?`, `stackorder`, `winfo_screendepth`, `winfo_screenvisual`, `winfo_screenwidth`, `winfo_screenheight`, `winfo_pixels('li')`, `winfo_screen`, `wm_maxsize`, `state` (`'normal', 'iconic', 'withdrawn', 'icon', 'zoomed'`) | `'DELETE_WINDOW'`, `'OPEN_WINDOW'`
 
 #### Common Attributes
 
 - `grid`: `Hash` of `:row`, `:column`, `:padx`, `:pady`, `:sticky` (`'e', 'w', 'n', 's'` or any combination of direction letters)
 
+#### Common Event Bindings
+
+- `Activate`
+- `Deactivate`
+- `MouseWheel`
+- `KeyPress`
+- `KeyRelease`
+- `ButtonPress`
+- `ButtonRelease`
+- `Motion`
+- `Configure`
+- `Map`
+- `Unmap`
+- `Visibility`
+- `Expose`
+- `Destroy`
+- `FocusIn`
+- `FocusOut`
+- `Enter`
+- `Leave`
+- `Property`
+- `Colormap`
+- `MapRequest`
+- `CirculateRequest`
+- `ResizeRequest`
+- `ConfigureRequest`
+- `Create`
+- `Gravity`
+- `Reparent`
+- `Circulate`
+
 #### Common Themed Widget States
 
 - `active?`
@@ -255,6 +313,10 @@ keyword(args) | attributes | event bindings & callbacks
 
 ### Smart Defaults and Convensions
 
+#### Event Bindings
+
+Any events that normally can be accepted by the Tk `bind` or `protocol` methods can be accepted by the `on(event) {}` listener syntax. There is no need to surround event name by `<>` as [Glimmer DSL for Tk](https://rubygems.org/gems/glimmer-dsl-tk) automatically takes care of that when needed and leaves out when not needed.
+
 #### Grid Layout
 
 `grid` layout is the default on most widgets (which support it).
@@ -315,7 +377,7 @@ More details can be found in the [Hello, Computed!](#hello-computed) sample belo
 
 Glimmer supports Shine syntax bidirectional data-binding via the `<=>` operator (read-write) and unidirectional data-binding via the `<=` operator (read-only), which takes a model and an attribute (the `bind` keyword may also be used as the old-style of data-binding).
 
-### General Property Data-Binding
+### Label Data-Binding
 
 Example:
 
@@ -323,11 +385,11 @@ This assumes a `Person` model with a `country` attribute.
 
 ```ruby
   label {
-    text <=> [person, :country]
+    text <= [person, :country]
   }
 ```
 
-That code binds the `textvariable` value of the `label` to the `country` property on the `person` model.
+That code binds the `textvariable` value of the `label` unidirectionally (read-only) to the `country` property on the `person` model.
 
 It automatically handles all the Tk plumbing behind the scenes.
 
@@ -368,8 +430,8 @@ This assumes a `Person` model with a `country` attribute representing their curr
   }
 ```
 
-That code binds the `items` text of the `list` to the `country_options` property on the `person` model (data-binding attribute + "_options" by convention).
-It also binds the `selection` text of the `list` to the `country` property on the `person` model.
+That code binds the `items` text of the `list` to the `country_options` attribute on the `person` model (data-binding attribute + "_options" by convention).
+It also binds the `selection` text of the `list` to the `country` attribute on the `person` model.
 
 It automatically handles all the Tk plumbing behind the scenes.
 
@@ -389,8 +451,8 @@ This assumes a `Person` model with a `provinces` attribute representing their cu
   }
 ```
 
-That code binds the `items` text of the `list` to the `provinces_options` property on the `person` model (data-binding attribute + "_options" by convention).
-It also binds the `selection` text of the `list` to the `provinces` property on the `person` model.
+That code binds the `items` text of the `list` to the `provinces_options` attribute on the `person` model (data-binding attribute + "_options" by convention).
+It also binds the `selection` text of the `list` to the `provinces` attribute on the `person` model.
 
 It automatically handles all the Tk plumbing behind the scenes.
 
@@ -408,30 +470,75 @@ This assumes a `Person` model with a `country` attribute.
   }
 ```
 
-That code binds the `textvariable` value of the `entry` to the `country` property on the `person` model.
+That code binds the `textvariable` value of the `entry` to the `country` attribute on the `person` model.
 
 It automatically handles all the Tk plumbing behind the scenes.
 
 More details can be found in the [Hello, Computed!](#hello-computed) sample below.
 
-## Command Observer
+### Checkbutton Data-Binding
+
+Example:
+
+This assumes a `Person` model with a boolean `adult` attribute.
+
+```ruby
+  checkbutton {
+    variable <=> [person, :adult]
+  }
+```
+
+That code binds the `variable` value of the `checkbutton` to the boolean `adult` attribute on the `person` model.
+
+It automatically handles all the Tk plumbing behind the scenes.
+
+If you need to display a half-checked `checkbutton`, bind to `alternate` attribute.
+
+More details can be found in the [Hello, Checkbutton!](#hello-checkbutton) sample below.
+
+### Radiobutton Data-Binding
+
+Example:
+
+This assumes a `Person` model with boolean `male` and `female` attributes.
+
+```ruby
+  radiobutton {
+    text 'Male'
+    variable <=> [@person, :male]
+  }
+  
+  radiobutton {
+    text 'Female'
+    variable <=> [@person, :female]
+  }
+```
+
+That code binds the `variable` value of the `radiobutton` to the boolean `male` and `female` attributes on the `person` model.
+
+It automatically handles all the Tk plumbing behind the scenes, including setting the `radiobutton` `value` (uses `text` attribute as `value`), enabling an API that works with simple booleans for each `radiobutton`.
+
+For very rare cases, if you need to display a half-selected `radiobutton`, set `alternate` attribute as `true` when the `variable` value is `false`.
+
+More details can be found in the [Hello, Radiobutton!](#hello-radiobutton) sample below.
+
+## Command Callback
 
-Buttons can set a `command` option to trigger when the user clicks the button. This may be done with the `command` keyword, passing in a block directly (no need for `proc` as per Tk)
+`button` and `checkbutton` can set a `command` block to trigger when the user clicks the button/checkbutton. This may be done with the `command` keyword, passing in a block directly.
 
 Example:
 
 ```ruby
   button {
     text "Reset Selection"
+    
     command {
       person.reset_country
     }
   }
 ```
 
-This resets the person country.
-
-More details can be found in the [Hello, Combobox!](#hello-combobox) sample below.
+More details can be found in the [Hello, Button!](#hello-button) sample below.
 
 ## Gotchas
 
@@ -572,6 +679,253 @@ Glimmer app:
 
 ![glimmer dsl tk screenshot sample hello button](images/glimmer-dsl-tk-screenshot-sample-hello-button.png)
 
+### Hello, Checkbutton!
+
+Glimmer code (from [samples/hello/hello_checkbutton.rb](samples/hello/hello_checkbutton.rb)):
+
+```ruby
+require 'glimmer-dsl-tk'
+
+class HelloCheckbutton
+  class Person
+    attr_accessor :skiing, :snowboarding, :snowmobiling, :snowshoeing, :snow_activities, :snow_activities_alternate
+    
+    def initialize
+      reset_activities!
+      individual_observer = Glimmer::DataBinding::Observer.proc do
+        unless @updating_group
+          @updating_individual = true
+          if skiing && snowboarding && snowmobiling && snowshoeing
+            self.snow_activities = true
+            self.snow_activities_alternate = false
+          elsif skiing || snowboarding || snowmobiling || snowshoeing
+            self.snow_activities = true
+            self.snow_activities_alternate = true
+          else
+            self.snow_activities = false
+            self.snow_activities_alternate = false
+          end
+          @updating_individual = false
+        end
+      end
+      individual_observer.observe(self, :skiing)
+      individual_observer.observe(self, :snowboarding)
+      individual_observer.observe(self, :snowmobiling)
+      individual_observer.observe(self, :snowshoeing)
+      
+      group_observer = Glimmer::DataBinding::Observer.proc do
+        unless @updating_individual
+          @updating_group = true
+          self.skiing = self.snow_activities
+          self.snowboarding = self.snow_activities
+          self.snowmobiling = self.snow_activities
+          self.snowshoeing = self.snow_activities
+          @updating_group = false
+        end
+      end
+      group_observer.observe(self, :snow_activities)
+    end
+    
+    def reset_activities!
+      self.snow_activities = true
+      self.snow_activities_alternate = true
+      self.skiing = false
+      self.snowboarding = true
+      self.snowmobiling = false
+      self.snowshoeing = false
+    end
+  end
+  
+  include Glimmer
+  
+  def initialize
+    @person = Person.new
+  end
+  
+  def launch
+    root {
+      title 'Hello, Checkbutton!'
+      background '#ececec' if OS.mac?
+      
+      label {
+        text 'Check all snow activities you are interested in:'
+        font 'caption'
+      }
+      
+      frame {
+        checkbutton {
+          text 'Snow Activities'
+          variable <=> [@person, :snow_activities]
+          alternate <=> [@person, :snow_activities_alternate] # binds half-checked state
+        }
+        
+        frame {
+          checkbutton {
+            text 'Skiing'
+            variable <=> [@person, :skiing]
+          }
+          
+          checkbutton {
+            text 'Snowboarding'
+            variable <=> [@person, :snowboarding]
+          }
+          
+          checkbutton {
+            text 'Snowmobiling'
+            variable <=> [@person, :snowmobiling]
+          }
+          
+          checkbutton {
+            text 'Snowshoeing'
+            variable <=> [@person, :snowshoeing]
+          }
+        }
+      }
+      
+      button {
+        text 'Reset Activities'
+        
+        command do
+          @person.reset_activities!
+        end
+      }
+    }.open
+  end
+end
+
+HelloCheckbutton.new.launch
+```
+
+Run with [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_checkbutton'"
+```
+
+Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_checkbutton.rb
+```
+
+Glimmer app:
+
+![glimmer dsl tk screenshot sample hello checkbutton](images/glimmer-dsl-tk-screenshot-sample-hello-checkbutton.png)
+
+![glimmer dsl tk screenshot sample hello checkbutton](images/glimmer-dsl-tk-screenshot-sample-hello-checkbutton-all-checked.png)
+
+![glimmer dsl tk screenshot sample hello checkbutton](images/glimmer-dsl-tk-screenshot-sample-hello-checkbutton-none-checked.png)
+
+### Hello, Radiobutton!
+
+Glimmer code (from [samples/hello/hello_radiobutton.rb](samples/hello/hello_radiobutton.rb)):
+
+```ruby
+require 'glimmer-dsl-tk'
+
+class HelloRadiobutton
+  class Person
+    attr_accessor :male, :female, :child, :teen, :adult, :senior
+    
+    def initialize
+      reset!
+    end
+    
+    def reset!
+      self.male = true
+      self.female = nil
+      self.child = nil
+      self.teen = nil
+      self.adult = true
+      self.senior = nil
+    end
+  end
+  
+  include Glimmer
+  
+  def initialize
+    @person = Person.new
+  end
+  
+  def launch
+    root {
+      title 'Hello, Radio!'
+      background '#ececec' if OS.mac?
+      
+      label {
+        text 'Gender:'
+        font 'caption'
+      }
+      
+      frame {
+        radiobutton {
+          text 'Male'
+          variable <=> [@person, :male]
+        }
+        
+        radiobutton {
+          text 'Female'
+          variable <=> [@person, :female]
+        }
+      }
+      
+      label {
+        text 'Age Group:'
+        font 'caption'
+      }
+      
+      frame {
+        radiobutton {
+          text 'Child'
+          variable <=> [@person, :child]
+        }
+
+        radiobutton {
+          text 'Teen'
+          variable <=> [@person, :teen]
+        }
+
+        radiobutton {
+          text 'Adult'
+          variable <=> [@person, :adult]
+        }
+
+        radiobutton {
+          text 'Senior'
+          variable <=> [@person, :senior]
+        }
+      }
+      
+      button {
+        text 'Reset'
+        
+        command do
+          @person.reset!
+        end
+      }
+    }.open
+  end
+end
+
+HelloRadiobutton.new.launch
+```
+
+Run with [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_radiobutton'"
+```
+
+Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_radiobutton.rb
+```
+
+Glimmer app:
+
+![glimmer dsl tk screenshot sample hello radiobutton](images/glimmer-dsl-tk-screenshot-sample-hello-radiobutton.png)
+
 ### Hello, Frame!
 
 Glimmer code (from [samples/hello/hello_frame.rb](samples/hello/hello_frame.rb)):
@@ -645,6 +999,60 @@ Glimmer app:
 
 ![glimmer dsl tk screenshot sample hello frame](images/glimmer-dsl-tk-screenshot-sample-hello-frame.png)
 
+### Hello, Root!
+
+Glimmer code (from [samples/hello/hello_frame.rb](samples/hello/hello_frame.rb)):
+
+```ruby
+require 'glimmer-dsl-tk'
+
+include Glimmer
+
+root { |r|
+  title 'Hello, Root!'
+  iconphoto File.expand_path('../../icons/glimmer.png', __dir__)
+  width 400
+  height 200
+  x -150
+  y 300
+  resizable true # same as `resizable true, true`, meaning cannot resize horizontally and vertically
+  minsize 200, 100
+  maxsize 600, 400
+  background 'lightgrey'
+  alpha 0.85 # on the mac, you can set `transparent true` as well
+  topmost true
+  
+  on('OPEN_WINDOW') do # custom event that runs right after Tk.mainloop
+    message_box(parent: r, title: 'Hi', message: 'Hi')
+  end
+  
+  on('DELETE_WINDOW') do |event| # alias for WM_DELETE_WINDOW protocol event
+    message_box(parent: r, title: 'Bye', message: 'Bye')
+    exit(0)
+  end
+}.open
+```
+
+Run with [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_root'"
+```
+
+Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_root.rb
+```
+
+Glimmer app:
+
+![glimmer dsl tk screenshot sample hello root hi](images/glimmer-dsl-tk-screenshot-sample-hello-root-hi.png)
+
+![glimmer dsl tk screenshot sample hello root](images/glimmer-dsl-tk-screenshot-sample-hello-root.png)
+
+![glimmer dsl tk screenshot sample hello root bye](images/glimmer-dsl-tk-screenshot-sample-hello-root-bye.png)
+
 ### Hello, Notebook!
 
 Glimmer code (from [samples/hello/hello_notebook.rb](samples/hello/hello_notebook.rb)):

data/VERSION

@@ -1 +1 @@
-0.0.18
+0.0.23

data/lib/glimmer/dsl/tk/message_box_expression.rb

@@ -27,7 +27,10 @@ module Glimmer
     module Tk
       class MessageBoxExpression < StaticExpression
         def interpret(parent, keyword, *args, &block)
-          args.first[:parent] = args.first[:parent].tk if args.first.is_a?(Hash) && args.first[:parent].is_a?(Glimmer::Tk::RootProxy)
+          if args.first.is_a?(Hash)
+            args.first[:parent] = args.first[:parent].tk if args.first[:parent].is_a?(Glimmer::Tk::RootProxy)
+            args.first[:title] = args.first.delete(:text) if args.first.keys.include?(:text)
+          end
           ::Tk::messageBox(*args)
         end
       end