glimmer-dsl-libui 0.0.9 → 0.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4aa989bad8bba6c9e59285e38a699b7842eb7f089a976782ac75363debfd829e
-  data.tar.gz: '081812a749e0ab795dfafcac60b58ab639f50933580f5ed3e404354691dd3d94'
+  metadata.gz: 19ebb3b2df3f14388664e392c4fbac8b121c6adf5638e78ddf308c7455c76c02
+  data.tar.gz: a631ed4518643c2d05ff39568f3fad815aa8729b01e1ee45ace9162bc9cf93be
 SHA512:
-  metadata.gz: 2e189f2db6399f9f718a06ca68b82665c7d9b54031dc62a76af1a4bb056f1299f40fe9993940163594157bdfcd649635cc27967aaadb7b709286d0b630d9b584
-  data.tar.gz: 5289461f384cf3237add39dba3fba83448c117d63ca53ac8e5dcc0af33cb4683179e077a712e927615825fc226bf94b234b4088e45b3f8de6c7b97a0d480c3a4
+  metadata.gz: 9e0fccb89ce28c472c65cabc9ff1a6044cb19c3277e960e726ea7f642ccc2861f12b6c4ec1d31a562f7d05ce64a92dcb5696a544b9dd4a2ebad25e2cd82dd61b
+  data.tar.gz: 4429a478c94b4105c079ddcda93b247271bae083a5b6c3b91e9c76c895a3273b27fced8d37262555b5139a0a19c98e63224eee3eb9ac44d89d379db151fa72ae

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Change Log
 
+## 0.0.13
+
+- Support examples/date_time_picker.rb
+- Support `date_time_picker`, `date_picker`, and `time_picker` controls having `time`/`time=`/`set_time` property
+
+## 0.0.12
+
+- Have examples/meta_example.rb allow code editing to enable experimentation and learning
+- Fix issue with examples/meta_example using puts_debuggerer (a development gem)
+
+## 0.0.11
+
+- New examples/basic_color.rb
+- Support `color_button` `color` property
+- Proper destroy of controls (deleting from parent `box`, `window`, or `group` first)
+- On the Mac only, if no menu is specified, add a Quit menu item automatically to allow quitting with CMD+Q
+
+## 0.0.10
+
+- Support examples/font_button.rb
+- Support `font_button` control
+- Add File -> Quit menu item to examples/meta_example.rb
+- Glimmer Style Guide added to README.md
+
 ## 0.0.9
 
 - Build a meta-example (example of examples)

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 LibUI 0.0.9
+# [<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 LibUI 0.0.13
 ## Prerequisite-Free Ruby Desktop Development GUI Library
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-libui.svg)](http://badge.fury.io/rb/glimmer-dsl-libui)
 [![Maintainability](https://api.codeclimate.com/v1/badges/ce2853efdbecf6ebdc73/maintainability)](https://codeclimate.com/github/AndyObtiva/glimmer-dsl-libui/maintainability)
@@ -6,17 +6,17 @@
 
 [Glimmer](https://github.com/AndyObtiva/glimmer) DSL for [LibUI](https://github.com/kojix2/LibUI) is a prerequisite-free Ruby desktop development GUI library. No need to pre-install any prerequisites. Just install the gem and have platform-independent native GUI that just works!
 
-[LibUI](https://github.com/kojix2/LibUI) is a thin [Ruby](https://www.ruby-lang.org/en/) wrapper around [libui](https://github.com/andlabs/libui), a relatively new C GUI library that renders native widgets on every platform (similar to [SWT](https://www.eclipse.org/swt/), but without the heavy weight of the [Java Virtual Machine](https://www.java.com/en/)).
+[LibUI](https://github.com/kojix2/LibUI) is a thin [Ruby](https://www.ruby-lang.org/en/) wrapper around [libui](https://github.com/andlabs/libui), a relatively new C GUI library that renders native controls on every platform (similar to [SWT](https://www.eclipse.org/swt/), but without the heavy weight of the [Java Virtual Machine](https://www.java.com/en/)).
 
 The main trade-off in using [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) as opposed to [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt) or [Glimmer DSL for Tk](https://github.com/AndyObtiva/glimmer-dsl-tk) is the fact that [SWT](https://www.eclipse.org/swt/) and [Tk](https://www.tcl.tk/) are more mature than mid-alpha [libui](https://github.com/andlabs/libui) as GUI toolkits. Still, if there is only a need to build a small simple application, [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) could be a good convenient choice due to having zero prerequisites beyond the dependencies included in the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui). Also, just like [Glimmer DSL for Tk](https://github.com/AndyObtiva/glimmer-dsl-tk), its apps start instantly and have a small memory footprint. [LibUI](https://github.com/kojix2/LibUI) is a promising new GUI toolkit that might prove quite worthy in the future.
 
 [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) aims to provide a DSL similar to the [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt) to enable more productive desktop development in Ruby with:
-- Declarative DSL syntax that visually maps to the GUI widget hierarchy
+- Declarative DSL syntax that visually maps to the GUI control hierarchy
 - Convention over configuration via smart defaults and automation of low-level details
 - Requiring the least amount of syntax possible to build GUI
 - Bidirectional Data-Binding to declaratively wire and automatically synchronize GUI with Business Models
-- Custom Widget support
-- Scaffolding for new custom widgets, apps, and gems
+- Custom Control support
+- Scaffolding for new custom controls, apps, and gems
 - Native-Executable packaging on Mac, Windows, and Linux.
 
 Example:
@@ -43,7 +43,7 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
 
 ## Table of Contents
 
-- [Glimmer DSL for LibUI 0.0.9](#-glimmer-dsl-for-libui-009)
+- [Glimmer DSL for LibUI 0.0.13](#-glimmer-dsl-for-libui-0013)
   - [Glimmer GUI DSL Concepts](#glimmer-gui-dsl-concepts)
   - [Usage](#usage)
   - [API](#api)
@@ -54,6 +54,7 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
     - [Extra Operations](#extra-operations)
     - [Smart Defaults and Conventions](#smart-defaults-and-conventions)
     - [Original API](#original-api)
+  - [Glimmer Style Guide](#glimmer-style-guide)
   - [Girb (Glimmer IRB)](#girb-glimmer-irb)
   - [Examples](#examples)
     - [Basic Window](#basic-window)
@@ -62,6 +63,9 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
     - [Simple Notepad](#simple-notepad)
     - [Midi Player](#midi-player)
     - [Control Gallery](#control-gallery)
+    - [Font Button](#font-button)
+    - [Color Button](#color-button)
+    - [Date Time Picker](#date-time-picker)
   - [Contributing to glimmer-dsl-libui](#contributing-to-glimmer-dsl-libui)
   - [Help](#help)
     - [Issues](#issues)
@@ -76,9 +80,9 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
 
 The Glimmer GUI DSL provides object-oriented declarative hierarchical syntax for [LibUI](https://github.com/kojix2/LibUI) that:
 - Supports smart defaults (e.g. automatic `on_closing` listener that quits `window`)
-- Automates wiring of widgets (e.g. `button` is automatically set as child of `window`)
+- Automates wiring of controls (e.g. `button` is automatically set as child of `window`)
 - Hides lower-level details (e.g. `LibUI.main` loop is started automatically when triggering `show` on `window`)
-- Nests widgets according to their visual hierarchy
+- Nests controls according to their visual hierarchy
 - Requires the minimum amount of syntax needed to describe an app's GUI
 
 The Glimmer GUI DSL follows these simple concepts in mapping from [LibUI](https://github.com/kojix2/LibUI) syntax:
@@ -149,7 +153,7 @@ gem install glimmer-dsl-libui
 Or install via Bundler `Gemfile`:
 
 ```ruby
-gem 'glimmer-dsl-libui', '~> 0.0.9'
+gem 'glimmer-dsl-libui', '~> 0.0.13'
 ```
 
 Add `require 'glimmer-dsl-libui'` at the top, and then `include Glimmer` into the top-level main object for testing or into an actual class for serious usage.
@@ -183,7 +187,7 @@ Any control returned by a [Glimmer GUI DSL](#glimmer-gui-dsl-concepts) keyword d
 Example (you may copy/paste in [`girb`](#girb-glimmer-irb)):
 
 ```ruby
-w = window('hello world', 300, 200, 1)
+w = window('hello world')
 puts w.title # => hello world
 w.title = 'howdy'
 puts w.title # => howdy
@@ -196,7 +200,7 @@ Controls are wrapped as Ruby proxy objects, having a `#libui` method to obtain t
 Example (you may copy/paste in [`girb`](#girb-glimmer-irb)):
 
 ```ruby
-w = window('hello world', 300, 200, 1) # => #<Glimmer::LibUI::WindowProxy:0x00007fde4ea39fb0
+w = window('hello world') # => #<Glimmer::LibUI::WindowProxy:0x00007fde4ea39fb0
 w.libui # => #<Fiddle::Pointer:0x00007fde53997980 ptr=0x00007fde51352a60 size=0 free=0x0000000000000000>
 ```
 
@@ -208,12 +212,12 @@ Control(Args) | Properties | Listeners
 `button(text as String)` | `text` (`String`) | `on_clicked`
 `checkbox(text as String)` | `checked` (Boolean), `text` (`String`) | `on_toggled`
 `combobox` | `items` (`Array` of `String`), `selected` (`Integer`) | `on_selected`
-`color_button` | `color` (r `Numeric`, g `Numeric`, b `Numeric`, a `Numeric`) | `on_changed`
-`date_picker` | `time` (`LibUI::FFI::TM`) | `on_changed`
-`date_time_picker` | `time` (`LibUI::FFI::TM`) | `on_changed`
+`color_button` | `color` (Array of `red` as `Float`, `green` as `Float`, `blue` as `Float`, `alpha` as `Float`), `red` as `Float`, `green` as `Float`, `blue` as `Float`, `alpha` as `Float` | `on_changed`
+`date_picker` | `time` (`Hash` of keys: `sec` as `Integer`, `min` as `Integer`, `hour` as `Integer`, `mday` as `Integer`, `mon` as `Integer`, `year` as `Integer`, `wday` as `Integer`, `yday` as `Integer`, `dst` as Boolean) | `on_changed`
+`date_time_picker` | `time` (`Hash` of keys: `sec` as `Integer`, `min` as `Integer`, `hour` as `Integer`, `mday` as `Integer`, `mon` as `Integer`, `year` as `Integer`, `wday` as `Integer`, `yday` as `Integer`, `dst` as Boolean) | `on_changed`
 `editable_combobox` | `items` (`Array` of `String`), `text` (`String`) | `on_changed`
 `entry` | `read_only` (Boolean), `text` (`String`) | `on_changed`
-`font_button` | `font` (`LibUI::FFI::FontDescriptor`) | `on_changed`
+`font_button` | `font` [read-only] (`Hash` of keys: `:family`, `:size`, `:weight`, `:italic`, `:stretch`), `family` as `String`, `size` as `Float`, `weight` as `Integer`, `italic` as `Integer`, `stretch` as `Integer` | `on_changed`
 `group(text as String)` | `margined` (Boolean), `title` (`String`) | None
 `horizontal_box` | `padded` (Boolean) | None
 `horizontal_separator` | None | None
@@ -232,7 +236,7 @@ Control(Args) | Properties | Listeners
 `spinbox(min as Numeric, max as Numeric)` | `value` (`Numeric`) | `on_changed`
 `tab` | `margined` (Boolean), `num_pages` (`Integer`) | None
 `tab_item(name as String)` | `index` [read-only] (`Integer`), `margined` (Boolean), `name` [read-only] (`String`) | None
-`time_picker` | `time` (`LibUI::FFI::TM`) | `on_changed`
+`time_picker` | `time` (`Hash` of keys: `sec` as `Integer`, `min` as `Integer`, `hour` as `Integer`, `mday` as `Integer`, `mon` as `Integer`, `year` as `Integer`, `wday` as `Integer`, `yday` as `Integer`, `dst` as Boolean) | `on_changed`
 `vertical_box` | `padded` (Boolean) | None
 `window(title as String, width as Integer, height as Integer, has_menubar as Boolean)` | `borderless` (Boolean), `content_size` (width `Numeric`, height `Numeric`), `fullscreen` (Boolean), `margined` (Boolean), `title` (`String`) | `on_closing`, `on_content_size_changed`
 
@@ -276,12 +280,27 @@ Control(Args) | Properties | Listeners
 - All boolean property readers return `true` or `false` in Ruby instead of the [libui](https://github.com/andlabs/libui) original `0` or `1` in C.
 - All boolean property writers accept `true`/`false` in addition to `1`/`0` in Ruby
 - All string property readers return a `String` object in Ruby instead of the [libui](https://github.com/andlabs/libui) Fiddle pointer object.
+- Automatically allocate font descriptors upon instantiating `font_button` controls and free them when destorying `font_button` controls
+- Automatically allocate color value pointers upon instantiating `color_button` controls and free them when destorying `color_button` controls
+- On the Mac, if no `menu` items were added, an automatic `quit_menu_item` is added to enable quitting with CTRL+Q
+- When destroying a control nested under a `horizontal_box` or `vertical_box`, it is automatically deleted from the box's children
+- When destroying a control nested under a `window` or `group`, it is automatically unset as their child to allow successful destruction
+- For `date_time_picker`, `date_picker`, and `time_picker`, make sure `time` hash values for `mon`, `wday`, and `yday` are 1-based instead of [libui](https://github.com/andlabs/libui) original 0-based values, and return `dst` as Boolean instead of `isdst` as `1`/`0`
 
 ### Original API
 
 To learn more about the [LibUI](https://github.com/kojix2/LibUI) API exposed through [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui),
 check out the [libui C headers](https://github.com/andlabs/libui/blob/master/ui.h)
 
+## Glimmer Style Guide
+
+- Control arguments are always wrapped by parentheses
+- Control blocks are always declared with curly braces to clearly visualize hierarchical view code and separate from logic code
+- Control property declarations always have arguments and never take a block
+- Control property arguments are never wrapped inside parentheses
+- Control listeners are always declared starting with on_ prefix and affixing listener event method name afterwards in underscored lowercase form. Their multi-line blocks have a `do; end` style.
+- Pure logic multi-line blocks that do not constitute GUI DSL view elements have `do; end` style to clearly separate logic code from view code.
+
 ## Girb (Glimmer IRB)
 
 You can run the `girb` command (`bin/girb` if you cloned the project locally):
@@ -296,9 +315,9 @@ Gotcha: On the Mac, when you close a window opened in `girb`, it remains open un
 
 ## Examples
 
-These examples include reimplementions of the examples in the [LibUI](https://github.com/kojix2/LibUI) project utilizing the [Glimmer GUI DSL](#glimmer-gui-dsl-concepts).
+These examples include reimplementions of the examples in the [LibUI](https://github.com/kojix2/LibUI) project utilizing the [Glimmer GUI DSL](#glimmer-gui-dsl-concepts) as well as brand new examples.
 
-To browse all examples, simply launch the [Meta-Example](examples/meta_example.rb), which lists all examples and displays each example's code when selected.
+To browse all examples, simply launch the [Meta-Example](examples/meta_example.rb), which lists all examples and displays each example's code when selected. It also enables code editing to facilitate experimentation and learning.
 
 [examples/meta_example.rb](examples/meta_example.rb)
 
@@ -322,7 +341,7 @@ Linux
 
 ![glimmer-dsl-libui-linux-meta-example.png](images/glimmer-dsl-libui-linux-meta-example.png)
 
-[Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
 
 ```ruby
 require 'glimmer-dsl-libui'
@@ -345,6 +364,10 @@ class MetaExample
     File.join(File.expand_path('.', __dir__), "#{example.underscore}.rb")
   end
   
+  def glimmer_dsl_libui_file
+    File.expand_path('../lib/glimmer-dsl-libui', __dir__)
+  end
+  
   def launch
     window('Meta-Example', 700, 500) { |w|
       margined true
@@ -364,13 +387,20 @@ class MetaExample
             stretchy false
             
             on_clicked do
-              system "ruby -r puts_debuggerer -r #{File.expand_path('../lib/glimmer-dsl-libui', __dir__)} #{file_path_for(@examples[@rbs.selected])}"
+              begin
+                meta_example_file = File.join(Dir.home, '.meta_example.rb')
+                File.write(meta_example_file, @nwme.text)
+                result = `ruby -r #{glimmer_dsl_libui_file} #{meta_example_file} 2>&1`
+                msg_box(w, 'Error Running Example', result) if result.include?('error')
+              rescue => e
+                puts 'Unable to write code changes! Running original example...'
+                system "ruby -r #{glimmer_dsl_libui_file} #{file_path_for(@examples[@rbs.selected])}"
+              end
             end
           }
         }
         vertical_box {
           @nwme = non_wrapping_multiline_entry {
-            read_only true
             text File.read(file_path_for(@examples[@rbs.selected]))
           }
         }
@@ -464,7 +494,7 @@ ruby -r glimmer-dsl-libui -e "require 'examples/basic_button'"
 Mac
 
 ![glimmer-dsl-libui-mac-basic-button.png](images/glimmer-dsl-libui-mac-basic-button.png)
-![glimmer-dsl-libui-mac-basic-button-msg-box.png](images/glimmer-dsl-libui-basic-button-msg-box.png)
+![glimmer-dsl-libui-mac-basic-button-msg-box.png](images/glimmer-dsl-libui-mac-basic-button-msg-box.png)
 
 Linux
 
@@ -1324,6 +1354,223 @@ MAIN_WINDOW = window('Control Gallery', 600, 500) {
 MAIN_WINDOW.show
 ```
 
+### Font Button
+
+[examples/font_button.rb](examples/font_button.rb)
+
+Run with this command from the root of the project if you cloned the project:
+
+```
+ruby -r './lib/glimmer-dsl-libui' examples/font_button.rb
+```
+
+Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui):
+
+```
+ruby -r glimmer-dsl-libui -e "require 'examples/font_button'"
+```
+
+Mac
+
+![glimmer-dsl-libui-mac-font-button.png](images/glimmer-dsl-libui-mac-font-button.png)
+![glimmer-dsl-libui-mac-font-button-selection.png](images/glimmer-dsl-libui-mac-font-button-selection.png)
+
+Linux
+
+![glimmer-dsl-libui-linux-font-button.png](images/glimmer-dsl-libui-linux-font-button.png)
+![glimmer-dsl-libui-linux-font-button-selection.png](images/glimmer-dsl-libui-linux-font-button-selection.png)
+
+[LibUI](https://github.com/kojix2/LibUI) Original Version:
+
+```ruby
+require 'libui'
+
+UI = LibUI
+
+UI.init
+
+main_window = UI.new_window('hello world', 300, 200, 1)
+
+font_button = UI.new_font_button
+font_descriptor = UI::FFI::FontDescriptor.malloc
+UI.font_button_on_changed(font_button) do
+  UI.font_button_font(font_button, font_descriptor)
+  p family: font_descriptor.Family.to_s,
+    size: font_descriptor.Size,
+    weight: font_descriptor.Weight,
+    italic: font_descriptor.Italic,
+    stretch: font_descriptor.Stretch
+end
+
+UI.window_on_closing(main_window) do
+  puts 'Bye Bye'
+  UI.control_destroy(main_window)
+  UI.quit
+  0
+end
+
+UI.window_set_child(main_window, font_button)
+UI.control_show(main_window)
+
+UI.main
+UI.quit
+
+```
+
+[Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+
+```ruby
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('hello world', 300, 200) {
+  font_button { |fb|
+    on_changed do
+      font_descriptor = fb.font
+      p font_descriptor
+    end
+  }
+  
+  on_closing do
+    puts 'Bye Bye'
+  end
+}.show
+```
+
+### Color Button
+
+[examples/color_button.rb](examples/color_button.rb)
+
+Run with this command from the root of the project if you cloned the project:
+
+```
+ruby -r './lib/glimmer-dsl-libui' examples/color_button.rb
+```
+
+Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui):
+
+```
+ruby -r glimmer-dsl-libui -e "require 'examples/color_button'"
+```
+
+Mac
+
+![glimmer-dsl-libui-mac-color-button.png](images/glimmer-dsl-libui-mac-color-button.png)
+![glimmer-dsl-libui-mac-color-button-selection.png](images/glimmer-dsl-libui-mac-color-button-selection.png)
+
+Linux
+
+![glimmer-dsl-libui-linux-color-button.png](images/glimmer-dsl-libui-linux-color-button.png)
+![glimmer-dsl-libui-linux-color-button-selection.png](images/glimmer-dsl-libui-linux-color-button-selection.png)
+
+New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+
+```ruby
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('color button', 230) {
+  color_button { |cb|
+    on_changed do
+      rgba = cb.color
+      p rgba
+    end
+  }
+}.show
+```
+
+### Date Time Picker
+
+[examples/date_time_picker.rb](examples/date_time_picker.rb)
+
+Run with this command from the root of the project if you cloned the project:
+
+```
+ruby -r './lib/glimmer-dsl-libui' examples/date_time_picker.rb
+```
+
+Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui):
+
+```
+ruby -r glimmer-dsl-libui -e "require 'examples/date_time_picker'"
+```
+
+Mac
+
+![glimmer-dsl-libui-mac-date-time-picker.png](images/glimmer-dsl-libui-mac-date-time-picker.png)
+
+Linux
+
+![glimmer-dsl-libui-linux-date-time-picker.png](images/glimmer-dsl-libui-linux-date-time-picker.png)
+
+[LibUI](https://github.com/kojix2/LibUI) Original Version:
+
+```ruby
+require 'libui'
+
+UI = LibUI
+
+UI.init
+
+vbox = UI.new_vertical_box
+
+date_time_picker = UI.new_date_time_picker
+
+time = UI::FFI::TM.malloc
+
+UI.date_time_picker_on_changed(date_time_picker) do
+  UI.date_time_picker_time(date_time_picker, time)
+  p sec: time.tm_sec,
+    min: time.tm_min,
+    hour: time.tm_hour,
+    mday: time.tm_mday,
+    mon: time.tm_mon,
+    year: time.tm_year,
+    wday: time.tm_wday,
+    yday: time.tm_yday,
+    isdst: time.tm_isdst
+end
+UI.box_append(vbox, date_time_picker, 1)
+
+main_window = UI.new_window('Date Time Pickers', 300, 200, 1)
+UI.window_on_closing(main_window) do
+  puts 'Bye Bye'
+  UI.control_destroy(main_window)
+  UI.quit
+  0
+end
+UI.window_set_child(main_window, vbox)
+UI.control_show(main_window)
+
+UI.main
+UI.quit
+```
+
+New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+
+```ruby
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('Date Time Pickers', 300, 200) {
+  vertical_box {
+    date_time_picker { |dtp|
+      on_changed do
+        time = dtp.time
+        p time
+      end
+    }
+  }
+  
+  on_closing do
+    puts 'Bye Bye'
+  end
+}.show
+```
+
 ## Contributing to glimmer-dsl-libui
 
 -   Check out the latest master to make sure the feature hasn't been

data/VERSION

@@ -1 +1 @@
-0.0.9
+0.0.13

data/examples/color_button.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('color button', 230) {
+  color_button { |cb|
+    on_changed do
+      rgba = cb.color
+      p rgba
+    end
+  }
+}.show

data/examples/date_time_picker.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('Date Time Pickers', 300, 200) {
+  vertical_box {
+    date_time_picker { |dtp|
+      on_changed do
+        time = dtp.time
+        p time
+      end
+    }
+  }
+  
+  on_closing do
+    puts 'Bye Bye'
+  end
+}.show

data/examples/font_button.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('hello world', 300, 200) {
+  font_button { |fb|
+    on_changed do
+      font_descriptor = fb.font
+      p font_descriptor
+    end
+  }
+  
+  on_closing do
+    puts 'Bye Bye'
+  end
+}.show

data/examples/meta_example.rb

@@ -20,6 +20,10 @@ class MetaExample
     File.join(File.expand_path('.', __dir__), "#{example.underscore}.rb")
   end
   
+  def glimmer_dsl_libui_file
+    File.expand_path('../lib/glimmer-dsl-libui', __dir__)
+  end
+  
   def launch
     window('Meta-Example', 700, 500) { |w|
       margined true
@@ -39,13 +43,20 @@ class MetaExample
             stretchy false
             
             on_clicked do
-              system "ruby -r puts_debuggerer -r #{File.expand_path('../lib/glimmer-dsl-libui', __dir__)} #{file_path_for(@examples[@rbs.selected])}"
+              begin
+                meta_example_file = File.join(Dir.home, '.meta_example.rb')
+                File.write(meta_example_file, @nwme.text)
+                result = `ruby -r #{glimmer_dsl_libui_file} #{meta_example_file} 2>&1`
+                msg_box(w, 'Error Running Example', result) if result.include?('error')
+              rescue => e
+                puts 'Unable to write code changes! Running original example...'
+                system "ruby -r #{glimmer_dsl_libui_file} #{file_path_for(@examples[@rbs.selected])}"
+              end
             end
           }
         }
         vertical_box {
           @nwme = non_wrapping_multiline_entry {
-            read_only true
             text File.read(file_path_for(@examples[@rbs.selected]))
           }
         }

data/lib/glimmer/libui/box.rb

@@ -29,12 +29,22 @@ module Glimmer
       def post_initialize_child(child)
         child.stretchy = true if child.stretchy.nil?
         ::LibUI.box_append(@libui, child.libui, ControlProxy.boolean_to_integer(child.stretchy))
+        children << child
       end
       
       def libui_api_keyword
         'box'
       end
       
+      def children
+        @children ||= []
+      end
+      
+      def destroy_child(child)
+        ::LibUI.send("box_delete", @libui, children.index(child))
+        ControlProxy.all_control_proxies.delete(child)
+      end
+      
       private
       
       def build_control

data/lib/glimmer/libui/color_button_proxy.rb

@@ -0,0 +1,64 @@
+# Copyright (c) 2021 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer/libui/control_proxy'
+
+module Glimmer
+  module LibUI
+    # Proxy for LibUI color button objects
+    #
+    # Follows the Proxy Design Pattern
+    class ColorButtonProxy < ControlProxy
+      def color
+        @red ||= Fiddle::Pointer.malloc(8) # double
+        @green ||= Fiddle::Pointer.malloc(8) # double
+        @blue ||= Fiddle::Pointer.malloc(8) # double
+        @alpha ||= Fiddle::Pointer.malloc(8) # double
+        ::LibUI.color_button_color(@libui, @red, @green, @blue, @alpha)
+        [@red[0, 8].unpack1('d') * 255.0, @green[0, 8].unpack1('d') * 255.0, @blue[0, 8].unpack1('d') * 255.0, @alpha[0, 8].unpack1('d')]
+      end
+      
+      def red
+        color[0]
+      end
+      
+      def green
+        color[1]
+      end
+      
+      def blue
+        color[2]
+      end
+      
+      def alpha
+        color[3]
+      end
+      
+      def destroy
+        Fiddle.free @red unless @red.nil?
+        Fiddle.free @green unless @green.nil?
+        Fiddle.free @blue unless @blue.nil?
+        Fiddle.free @alpha unless @alpha.nil?
+        super
+      end
+    end
+  end
+end

data/lib/glimmer/libui/control_proxy.rb

@@ -52,7 +52,7 @@ module Glimmer
         end
         
         def main_window_proxy
-          all_control_proxies.find {|c| c.is_a?(WindowProxy)}
+          all_control_proxies.find {|c| c.is_a?(Glimmer::LibUI::WindowProxy)}
         end
         
         def integer_to_boolean(int)
@@ -62,6 +62,10 @@ module Glimmer
         def boolean_to_integer(bool)
           bool.nil? ? nil : (bool ? 1 : 0)
         end
+        
+        def menu_proxies
+          all_control_proxies.select {|c| c.keyword == 'menu' }
+        end
       end
       
       BOOLEAN_PROPERTIES = %w[
@@ -167,7 +171,7 @@ module Glimmer
           ::LibUI.send("#{libui_api_keyword}_#{method_name}", @libui, *args)
         elsif ::LibUI.respond_to?("control_#{method_name.to_s.sub(/\?$/, '')}") && args.empty?
           property = method_name.to_s.sub(/\?$/, '')
-          value = ::LibUI.send("control_#{method_name.to_s.sub(/\?$/, '')}", @libui, *args)
+          value = ::LibUI.send("control_#{property}", @libui, *args)
           handle_string_property(property, handle_boolean_property(property, value))
         elsif ::LibUI.respond_to?("control_set_#{method_name.to_s.sub(/=$/, '')}")
           property = method_name.to_s.sub(/=$/, '')
@@ -198,6 +202,23 @@ module Glimmer
         @keyword
       end
       
+      def destroy
+        if parent_proxy.nil?
+          default_destroy
+        else
+          parent_proxy.destroy_child(self)
+        end
+      end
+      
+      def destroy_child(child)
+        child.default_destroy
+      end
+      
+      def default_destroy
+        send_to_libui('destroy')
+        ControlProxy.all_control_proxies.delete(self)
+      end
+            
       def enabled(value = nil)
         if value.nil?
           @enabled
@@ -229,11 +250,6 @@ module Glimmer
       alias set_visible visible
       alias visible= visible
       
-      def destroy
-        send_to_libui('destroy')
-        self.class.all_control_proxies.delete(self)
-      end
-            
       private
       
       def build_control

data/lib/glimmer/libui/date_picker_proxy.rb

@@ -27,6 +27,13 @@ module Glimmer
     #
     # Follows the Proxy Design Pattern
     class DatePickerProxy < DateTimePickerProxy
+      def time(value = nil)
+        if value.nil?
+          super.slice(:mday, :mon, :year, :wday, :yday)
+        else
+          super
+        end
+      end
     end
   end
 end

data/lib/glimmer/libui/date_time_picker_proxy.rb

@@ -30,6 +30,39 @@ module Glimmer
       def libui_api_keyword
         'date_time_picker'
       end
+      
+      def time(value = nil)
+        @time ||= ::LibUI::FFI::TM.malloc
+        ::LibUI.date_time_picker_time(@libui, @time)
+        if value.nil?
+          {
+            sec: @time.tm_sec,
+            min: @time.tm_min,
+            hour: @time.tm_hour,
+            mday: @time.tm_mday,
+            mon: @time.tm_mon + 1,
+            year: @time.tm_year + 1900,
+            wday: @time.tm_wday + 1,
+            yday: @time.tm_yday + 1,
+            dst: @time.tm_isdst == 1
+          }
+        else
+          @time.tm_sec = value[:sec] unless value[:sec].nil?
+          @time.tm_min = value[:min] unless value[:min].nil?
+          @time.tm_hour = value[:hour] unless value[:hour].nil?
+          @time.tm_mday = value[:mday] unless value[:mday].nil?
+          @time.tm_mon = value[:mon] - 1 unless value[:mon].nil?
+          @time.tm_year = value[:year] - 1900 unless value[:year].nil?
+          ::LibUI.date_time_picker_set_time(@libui, @time)
+        end
+      end
+      alias set_time time
+      alias time= time
+      
+      def destroy
+        Fiddle.free @time unless @time.nil?
+        super
+      end
     end
   end
 end

data/lib/glimmer/libui/font_button_proxy.rb

@@ -0,0 +1,68 @@
+# Copyright (c) 2021 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer/libui/control_proxy'
+
+module Glimmer
+  module LibUI
+    # Proxy for LibUI font button objects
+    #
+    # Follows the Proxy Design Pattern
+    class FontButtonProxy < ControlProxy
+      def font
+        @font_descriptor ||= ::LibUI::FFI::FontDescriptor.malloc
+        ::LibUI.font_button_font(@libui, @font_descriptor)
+        {
+          family: @font_descriptor.Family.to_s,
+          size: @font_descriptor.Size,
+          weight: @font_descriptor.Weight,
+          italic: @font_descriptor.Italic,
+          stretch: @font_descriptor.Stretch
+        }
+      end
+      
+      def family
+        font[:family]
+      end
+      
+      def size
+        font[:size]
+      end
+      
+      def weight
+        font[:weight]
+      end
+      
+      def italic
+        font[:italic]
+      end
+      
+      def stretch
+        font[:stretch]
+      end
+      
+      def destroy
+        ::LibUI.free_font_button_font(@font_descriptor) unless @font_descriptor.nil?
+        super
+      end
+    end
+  end
+end

data/lib/glimmer/libui/group_proxy.rb

@@ -31,6 +31,11 @@ module Glimmer
         ::LibUI.group_set_child(@libui, child.libui)
       end
       
+      def destroy_child(child)
+        ::LibUI.send("group_set_child", @libui, nil)
+        super
+      end
+    
       private
       
       def build_control

data/lib/glimmer/libui/time_picker_proxy.rb

@@ -27,6 +27,13 @@ module Glimmer
     #
     # Follows the Proxy Design Pattern
     class TimePickerProxy < DateTimePickerProxy
+      def time(value = nil)
+        if value.nil?
+          super.slice(:sec, :min, :hour)
+        else
+          super
+        end
+      end
     end
   end
 end

data/lib/glimmer/libui/window_proxy.rb

@@ -35,9 +35,14 @@ module Glimmer
       def post_initialize_child(child)
         ::LibUI.window_set_child(@libui, child.libui)
       end
+      
+      def destroy_child(child)
+        ::LibUI.send("window_set_child", @libui, nil)
+        super
+      end
     
       def show
-        send_to_libui('show')
+        super
         unless @shown_at_least_once
           @shown_at_least_once = true
           ::LibUI.main
@@ -64,6 +69,10 @@ module Glimmer
       private
       
       def build_control
+        if OS.mac? && ControlProxy.menu_proxies.empty?
+          menu_proxy = ControlProxy.create('menu', nil, [''])
+          quit_menu_item_proxy = ControlProxy.create('quit_menu_item', menu_proxy, [])
+        end
         construction_args = @args.dup
         construction_args[0] = DEFAULT_TITLE if construction_args.size == 0
         construction_args[1] = DEFAULT_WIDTH if construction_args.size == 1

data/lib/glimmer-dsl-libui.rb

@@ -26,6 +26,7 @@ require 'glimmer'
 # require 'logging'
 # require 'puts_debuggerer' if ENV['pd'].to_s.downcase == 'true'
 # require 'super_module'
+require 'os'
 require 'libui'
 
 # Internal requires

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-libui
 version: !ruby/object:Gem::Version
-  version: 0.0.9
+  version: 0.0.13
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-20 00:00:00.000000000 Z
+date: 2021-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: glimmer
@@ -24,6 +24,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.1.2
+- !ruby/object:Gem::Dependency
+  name: os
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
 - !ruby/object:Gem::Dependency
   name: libui
   requirement: !ruby/object:Gem::Requirement
@@ -164,7 +184,10 @@ files:
 - examples/basic_entry.rb
 - examples/basic_window.rb
 - examples/basic_window2.rb
+- examples/color_button.rb
 - examples/control_gallery.rb
+- examples/date_time_picker.rb
+- examples/font_button.rb
 - examples/meta_example.rb
 - examples/midi_player.rb
 - examples/simple_notepad.rb
@@ -181,11 +204,13 @@ files:
 - lib/glimmer/libui/about_menu_item_proxy.rb
 - lib/glimmer/libui/box.rb
 - lib/glimmer/libui/check_menu_item_proxy.rb
+- lib/glimmer/libui/color_button_proxy.rb
 - lib/glimmer/libui/combobox_proxy.rb
 - lib/glimmer/libui/control_proxy.rb
 - lib/glimmer/libui/date_picker_proxy.rb
 - lib/glimmer/libui/date_time_picker_proxy.rb
 - lib/glimmer/libui/editable_combobox_proxy.rb
+- lib/glimmer/libui/font_button_proxy.rb
 - lib/glimmer/libui/group_proxy.rb
 - lib/glimmer/libui/horizontal_box_proxy.rb
 - lib/glimmer/libui/menu_item_proxy.rb