voom-presenters 0.1.10 → 2.0.0

data/Gemfile.lock

@@ -1,118 +1,160 @@
+GIT
+  remote: https://github.com/rx/chart_presenter_plugin.git
+  revision: e2afb1cf0292ea92371cfc83be16b2ad95dee26d
+  specs:
+    chart_presenter_plugin (0.1.0)
+
+GIT
+  remote: https://github.com/rx/foo_presenter_plugin.git
+  revision: 313dddfef05f740990c509b89831b69730b4ce12
+  specs:
+    foo_presenter_plugin (0.0.1)
+
+GIT
+  remote: https://github.com/rx/image_crop_presenter_plugin.git
+  revision: c0814ffa5a0f40fd15d697e72a5bd4c9e4117d1e
+  specs:
+    image_crop_presenter_plugin (0.1.0)
+
 PATH
   remote: .
   specs:
-    voom-presenters (0.1.9)
+    voom-presenters (1.0.0)
       dry-configurable (> 0.1, <= 7.0)
       dry-container (~> 0.6)
       dry-inflector (~> 0.1)
+      filewatcher (~> 1.1.1)
       ice_nine (~> 0.11)
       redcarpet (~> 3.4)
       sinatra (>= 1.4, < 3.0)
-      tzinfo (~> 1.2)
+      tzinfo (>= 1.1, < 3.0)
       tzinfo-data (~> 1.2018)
+      zeitwerk (~> 2.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    childprocess (0.9.0)
-      ffi (~> 1.0, >= 1.0.11)
-    coderay (1.1.1)
-    concurrent-ruby (1.0.5)
-    diff-lcs (1.2.5)
-    docile (1.1.5)
-    dry-configurable (0.7.0)
+    childprocess (3.0.0)
+    coderay (1.1.2)
+    concurrent-ruby (1.1.7)
+    diff-lcs (1.3)
+    docile (1.3.1)
+    dry-configurable (0.11.6)
       concurrent-ruby (~> 1.0)
-    dry-container (0.6.0)
+      dry-core (~> 0.4, >= 0.4.7)
+      dry-equalizer (~> 0.2)
+    dry-container (0.7.2)
       concurrent-ruby (~> 1.0)
       dry-configurable (~> 0.1, >= 0.1.3)
-    dry-inflector (0.1.2)
-    ffi (1.9.23)
+    dry-core (0.5.0)
+      concurrent-ruby (~> 1.0)
+    dry-equalizer (0.3.0)
+    dry-inflector (0.2.0)
+    filewatcher (1.1.1)
+      optimist (~> 3.0)
+    gem-release (2.0.1)
     ice_nine (0.11.2)
-    json (2.1.0)
-    method_source (0.8.2)
-    mini_portile2 (2.3.0)
-    mustermann (1.0.2)
-    nokogiri (1.8.2)
-      mini_portile2 (~> 2.3.0)
-    pry (0.10.4)
+    json (2.3.1)
+    method_source (0.9.0)
+    mini_portile2 (2.4.0)
+    mustermann (1.1.1)
+      ruby2_keywords (~> 0.0.1)
+    nokogiri (1.10.9)
+      mini_portile2 (~> 2.4.0)
+    optimist (3.0.1)
+    pry (0.11.3)
       coderay (~> 1.1.0)
-      method_source (~> 0.8.1)
-      slop (~> 3.4)
-    rack (2.0.5)
-    rack-protection (2.0.3)
+      method_source (~> 0.9.0)
+    rack (2.2.3)
+    rack-cors (1.1.0)
+      rack (>= 2.0.0)
+    rack-protection (2.1.0)
       rack
-    rack-test (0.8.2)
+    rack-test (0.8.3)
       rack (>= 1.0, < 3)
-    rake (11.3.0)
-    redcarpet (3.4.0)
-    rspec (3.5.0)
-      rspec-core (~> 3.5.0)
-      rspec-expectations (~> 3.5.0)
-      rspec-mocks (~> 3.5.0)
-    rspec-core (3.5.4)
-      rspec-support (~> 3.5.0)
-    rspec-expectations (3.5.0)
+    rake (13.0.1)
+    redcarpet (3.5.1)
+    regexp_parser (1.6.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.2)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.4)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.5.0)
+      rspec-support (~> 3.8.0)
     rspec-html-matchers (0.9.1)
       nokogiri (~> 1)
       rspec (>= 3.0.0.a, < 4)
-    rspec-mocks (3.5.0)
+    rspec-mocks (3.8.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.5.0)
-    rspec-support (3.5.0)
-    rspec_junit_formatter (0.3.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.2)
+    rspec_junit_formatter (0.4.1)
       rspec-core (>= 2, < 4, != 2.12.0)
-    rubyzip (1.2.1)
-    selenium-webdriver (3.11.0)
-      childprocess (~> 0.5)
-      rubyzip (~> 1.2)
-    simplecov (0.15.1)
-      docile (~> 1.1.0)
+    ruby2_keywords (0.0.2)
+    rubyzip (1.3.0)
+    selenium-webdriver (3.142.7)
+      childprocess (>= 0.5, < 4.0)
+      rubyzip (>= 1.2.2)
+    shotgun (0.9.2)
+      rack (>= 1.0)
+    simplecov (0.16.1)
+      docile (~> 1.1)
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
     simplecov-html (0.10.2)
-    sinatra (2.0.3)
+    sinatra (2.1.0)
       mustermann (~> 1.0)
-      rack (~> 2.0)
-      rack-protection (= 2.0.3)
+      rack (~> 2.2)
+      rack-protection (= 2.1.0)
       tilt (~> 2.0)
-    slop (3.6.0)
-    thread_safe (0.3.6)
-    tilt (2.0.8)
-    tzinfo (1.2.5)
-      thread_safe (~> 0.1)
-    tzinfo-data (1.2018.5)
+    thor (1.0.1)
+    tilt (2.0.10)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    tzinfo-data (1.2020.4)
       tzinfo (>= 1.0.0)
-    watir (6.10.3)
-      selenium-webdriver (~> 3.4, >= 3.4.1)
+    watir (6.16.5)
+      regexp_parser (~> 1.2)
+      selenium-webdriver (~> 3.6)
     watir-rspec (3.0.0)
       rspec (~> 3.0)
       watir (>= 6.0.0.beta4)
-    webdrivers (3.2.4)
+    webdrivers (4.1.0)
       nokogiri (~> 1.6)
       rubyzip (~> 1.0)
-      selenium-webdriver (~> 3.0)
+      selenium-webdriver (>= 3.0, < 4.0)
+    zeitwerk (2.4.2)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   bundler (~> 1.13)
-  pry (~> 0.10)
+  chart_presenter_plugin!
+  foo_presenter_plugin!
+  gem-release (~> 2.0)
+  image_crop_presenter_plugin!
+  pry
+  rack (>= 2.0.6)
+  rack-cors
   rack-test (~> 0.8)
-  rake (~> 11.3)
+  rake (~> 13.0)
   rspec
   rspec-html-matchers
   rspec_junit_formatter
+  shotgun (~> 0.9)
   simplecov
+  thor (~> 1.0.1)
   voom-presenters!
-  watir (~> 6.10.3)
-  watir-rspec
-  webdrivers (~> 3.0)
+  watir (~> 6.16)
+  watir-rspec (~> 3.0)
+  webdrivers (~> 4.1)
 
 RUBY VERSION
-   ruby 2.5.0p0
+   ruby 2.5.5p157
 
 BUNDLED WITH
-   1.16.1
+   1.17.3

data/HISTORY.md

@@ -0,0 +1,61 @@
+# HISTORY
+This is the manual changelog, managed before switching to github_changelog_generator.
+
+## [0.2.00] - 2018-09-18
+### Added
+- This change log
+- [Namespaces]
+- [Slider component]
+- [Rich text component]
+- [Map component]
+- [Chip as input]
+- [Tagged Input]
+- [Grid Padding]
+- [Grid Wide/Table scrolling]
+- [Overline Text Style]
+- [Blank lines]
+- [Page separator]
+- [Clear action]
+- Floating content blocks
+- Request logging
+
+### Removed
+- Autocomplete event
+
+### Changed
+- Text field - draw with outlined style by default
+- Text field - support for leading or trailing icons
+- Text field - disabled support
+- Text area - can specify cols to control width
+- Select options - can pass the option text as the first parameter, or in the block.
+- List - component action blocks are now actions
+- List - color and border
+- Content blocks - icons support
+- Events - aliases focus and blur (maps to focusin and focusout)
+- Typography - available in menu items, including markdown
+- Typography - removed trailing line breaks
+- Rails helper table_for helper - accepts timezone for auto time formatting
+- Date time - default format changed
+- Webclient FAB button - shifted up and out to make room for list actions 
+
+### Fixed
+- Text field - Removed excessive trailing spacing
+- Context is no longer copied and it is not included in the pom json
+- List - selected lists can render selected with the checked option
+
+[Unreleased]: https://github.com/rx/presenters/compare/v0.1.14...HEAD 
+[0.1.14]: https://github.com/rx/presenters/compare/v0.1.14...v0.1.13
+[Namespaces]: https://powerful-bastion-96181.herokuapp.com/namespaces
+[Stepper]: https://powerful-bastion-96181.herokuapp.com/steppers
+[Rich text component]: https://powerful-bastion-96181.herokuapp.com/text_areas
+[Slider component]: https://powerful-bastion-96181.herokuapp.com/sliders
+[Tagged Input]: https://powerful-bastion-96181.herokuapp.com/tagged_input
+[Overline Text Style]: https://powerful-bastion-96181.herokuapp.com/styles
+[Page separator]: https://powerful-bastion-96181.herokuapp.com/separator
+[Blank lines]: https://powerful-bastion-96181.herokuapp.com/styles
+[Grid Padding]: https://powerful-bastion-96181.herokuapp.com/layouts
+[Map component]: https://powerful-bastion-96181.herokuapp.com/maps
+[Clear action]: https://powerful-bastion-96181.herokuapp.com/clear_action 
+[Chip as input]: https://powerful-bastion-96181.herokuapp.com/chips#input_chips 
+[Floating content blocks]:https://powerful-bastion-96181.herokuapp.com/content#floating  
+[Grid Wide/Table scrolling]:https://powerful-bastion-96181.herokuapp.com/tables

data/Procfile

@@ -0,0 +1 @@
+web: rackup -p $PORT

data/README.md

@@ -1,51 +1,98 @@
 # Voom::Presenters
 
-A Ruby DSL for describing user interfaces. 
+## TLDR;
+Do you wish you could write a modern user interface in pure Ruby?
+
+Now you can. Presenters are a Ruby DSL for rendering user interfaces. 
 The semantics are adopted from [Material Design](https://material.io/).
 
-A presenter generates a Presenter Object Model (POM). 
-A POM fully describes a user interface.
-A POM client can fully render user interface from POM.
+* Presenters are to HTML/User Interfaces what C is to assembly
+* A presenter generates a Presenter Object Model (POM) 
+* A POM fully describes a user interface
+* A POM client can fully render user interface from POM
+
+## What are voom-presenters?
+
+* A Ruby user interface abstraction
+* A Ruby DSL to build a user interface
+* A power washer for building user interfaces
+
+## Why?
+
+Building a user interface should like Ruby itself: 
+> ... a focus on simplicity and productivity. It has an elegant syntax that is natural to read and easy to write.
+
+Instead building a user interface has turned into:
+> How many languages/technologies/frameworks do I need to learn to build a rich user interface/experience?"
+
+A typical web client requires at a minimum the following: HTML, CSS, Javascript, in addition we need Ruby on the server, plus some SQL.  
+That is 5 technologies/languages.
+Now lets talk about a new client like an iOS or Android client. If we go native, we can now add Java and Swift to that list. We are up to 7 technologies/languages!
+We didn't even add any popular extras like coffeescript, haml, sass, and we left out frameworks.
+
+What if you could write all my user interface in Ruby and have it rendered natively in ANY client? The voom-presenters _enable_ that. It is a Ruby DSL that describes a user interface.
+It generates an intermediate Presenter Object Model (POM). 
+The POM is a declarative user interface that can be rendered by a POM client. 
+The core presenters gem provides a Web client as a fully functional reference implementation.
+
+This concept was initially inspired by the Presenters concepts of Ivar Jacobson as presented by Robert Martin.
 
 ## Demo
 
-[Demo](https://powerful-bastion-96181.herokuapp.com)
+[Demo]
 
 Or to run locally:
 
     git clone git@github.com:rx/presenters.git
     cd presenters/
     bundle install
-    rackup
+    bundle exec rackup
 
-    open htt://localhost:9292
+    open http://localhost:9292
     
 To see the POM:
 
-    open htt://localhost:9292/pom
-  
+    open http://localhost:9292/index.pom
+      
+## Usage
+
+To use it, add this line to your Gemfile:
+
+    gem 'voom-presenters', github('rx/presenters'), require: false
 
-## User Interface Engine
+Create the file app/presenters/index.pom with the contents:
+    
+    Voom::Presenters.define(:hello_world) do
+      heading 'hello world'
+    end   
 
-The POM + A POM Client is an interface engine. 
+### Rails
+For rails: Mount the web-client in your rails config/routes.rb
 
-This example downloads the POM of the index page. 
-Then posts it to the reference web client. 
-That result is then saved to a file and opened up with a browser.
+    mount ::Voom::Presenters::WebClient::App, at: '/'
+    # the api is optional
+    # mount ::Voom::Presenters::Api::App,       at: '/'
+    
+Create an initializer `config/initializers/presenters.rb` with the following:
     
-    curl localhost:9292/pom/index > $TMPDIR/index.json  && curl -d "@$TMPDIR/index.json" -X POST localhost:9292/index > $TMPDIR/index.html && open $TMPDIR/index.html
+    require 'voom'
+
+### Rack
+Presenters are rack based. If your framework uses a rack config file add the following:
+
+    use Voom::Presenters::WebClient::App
+    # the api is optional        
+    # use Voom::Presenters::Api::App
+
+Start your app and goto [/hello_world](http://127.0.0.1:3000/hello_world)
+
+Use the [Demo] to get example code to drop into your presetners.
 
 ## Status
-This project is in a pre-beta status. It is changing frequently as the first user interfaces are being built with it.
-Any use should be for internal use only until the status becomes beta.
+This project is in a released status. 
 
 [![CircleCI](https://circleci.com/gh/rx/presenters.svg?style=svg)](https://circleci.com/gh/rx/presenters)
-[![Maintainability](https://api.codeclimate.com/v1/badges/8fcea717485230e60f27/maintainability)](https://codeclimate.com/github/rx/presenters/maintainability)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg?style=plastic)](https://raw.githubusercontent.com/rx/presenters/master/LICENSE)
-    
-## Usage
-
-TODO: Write usage instructions here
 
 ## Contributing
 
@@ -55,3 +102,9 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/rx/pre
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
 
+## Code of Conduct
+
+Everyone interacting in the Voom::Presenters project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/rx/presenters/blob/master/CODE-OF-CONDUCT.md).
+
+
+[Demo]:https://powerful-bastion-96181.herokuapp.com

data/app/demo/component_status.pom

@@ -42,7 +42,7 @@ Voom::Presenters.define(:component_status) do
 
               ]
       table do
-        row do
+        header do
           items.each do |item|
             column color: item_color(item)
             column item[:text]

data/app/demo/components/avatars.pom

@@ -0,0 +1,40 @@
+Voom::Presenters.define(:avatars) do
+  attach :top_nav
+  attach :component_drawer
+  page_title 'Avatars'
+
+  grid do
+    column 1
+    column 10 do
+      body 'An avatar can contain an image or icon. Avatars can be used within a list line, the media section of a card, a content block or column.'
+
+      grid do
+        column 6 do
+          headline 'Types'
+          body '**With an Icon**'
+          avatar :thumb_up
+          body '**With an Image**'
+          avatar 'img/demo/avatar.jpg'
+        end
+      end
+
+      grid do
+        column 6 do
+          headline 'Sizes'
+          body '**small**'
+          avatar :person, size: :small
+          body '**medium** (default)'
+          avatar 'img/demo/image_card.jpg', size: :medium
+          body '**large**'
+          avatar :cake, size: :large
+          body '**x-large**'
+          avatar :golf_course, size: 'x-large'
+          body '**xx-large**'
+          avatar 'img/demo/avatar.jpg', size: 'xx-large'
+        end
+      end
+
+    end
+  end
+
+end