voom-presenters 0.1.5 → 0.1.6

data/app/demo/events/nav/drawer.pom

@@ -0,0 +1,21 @@
+Voom::Presenters.define(:events_drawer) do
+  helpers Voom::Presenters::Helpers::Inflector
+  drawer 'Events' do
+    menu do
+      %i(field_level_events form_level_events).sort.each do |comp|
+        item titleize(comp) do
+          event :click do
+            loads comp
+          end
+        end
+      end
+      %i(dialog autocomplete replaces toggle_visibility snackbar updates deletes posts).sort.each do |comp|
+        item titleize(comp) do
+          event :click do
+            loads "#{comp}_action"
+          end
+        end
+      end
+    end
+  end
+end

data/app/demo/events.pom

@@ -1,60 +1,20 @@
-require_relative 'helpers/indented_grid'
-
 Voom::Presenters.define(:events) do
   helpers Demo::Helpers::IndentedGrid
   attach :top_nav
   attach :events_drawer
 
-
   indented_grid do
     heading 'Events'
     body 'Events are able to be attached to most components. ',
          'Common examples include `click` and `change` events. ',
+         'Events have actions.',
          "To see how an individual component handles events, visit the [component page](#{presenters_path(:components)})"
 
-    subheading 'Dialog'
-    button 'dialog' do
-      event :click do
-        dialog :my_dialog
-      end
-    end
-    attach :show_dialog
-
-    subheading 'Replaces'
-    button 'replaces' do
-      event :click do
-        replaces :replace_me, :replace_text, text: "I was replaced"
-      end
-    end
-    attach :replace_text
-
-    subheading 'Toggle Visibility'
-    button 'toggle visiblity' do
-      event :click do
-        toggle_visiblity :toggle_me
-      end
-    end
-    heading 'Sometimes I appear', id: :toggle_me
-
-    subheading 'Snackbar'
-    button 'snackbar' do
-      event :click do
-        snackbar 'I want a snack!'
-      end
-    end
-
-    subheading context['reloaded'] ? "Reloaded" : 'Loads'
-    button 'loads' do
-      event :click do
-        loads :events, reloaded: true
-      end
-    end
-    heading context['reloaded'] ? "Reloaded" : 'Loaded'
-
-    title "A Note on errors:"
-    body 'The following event actions will display an error.',
-         nil,
-         'Errors are automatically displayed in the following locations.',
+    icon 'fa-hand-point-left', position: :left
+    subheading 'Select an event action'
+    body ' '
+    title "Event Action Error Handling"
+    body 'Errors are automatically displayed in the following locations.',
          '1. Field/input level errors will display on the field/input.',
          '1. At the top of all forms.',
          '1. At the top of all dialogs.',
@@ -63,36 +23,7 @@ Voom::Presenters.define(:events) do
          '1. At the top of the page', level: 2
 
     body 'The closest error element will be used.'\
-          'If you want to control where errors appear. Use the attribute `show_errors=(true|false)`'
-
-
-    subheading 'Update'
-    body 'issues a PUT to the passed path'
-    content shows_errors: true do
-      button 'updates' do
-        event :click do
-          updates 'updatepath', {optional: :params}
-        end
-      end
-
-      subheading 'Delete'
-      body 'issues a DELETE to the passed path'
-      content shows_errors: true do
-        button 'deletes' do
-          event :click do
-            deletes 'deletepath', {optional: :params}
-          end
-        end
-        subheading 'Posts'
-        body "issues a POST to the passed path\nAlias: creates"
-        content do
-          button 'posts' do
-            event :click do
-              posts 'postpath', {optional: :params}
-            end
-          end
-        end
-      end
-    end
+               'If you want to control where errors appear. Use the attribute `show_errors=(true|false)`'
   end
+  attach :code, file: __FILE__
 end

data/app/demo/formatting_tokens.pom

@@ -0,0 +1,125 @@
+Voom::Presenters.define(:formatting_tokens) do
+  helpers Demo::Helpers::IndentedGrid
+  indented_grid do
+    display 'Date Formatting Tokens', id: :date
+    table do
+      header do
+        column 'Character'
+        column 'Description'
+        column 'Example'
+      end
+      row do
+        column 'd'
+        column 'Day of the month, 2 digits with leading zeros'
+        column '01 to 31'
+      end
+      row do
+        column 'D'
+        column 'A textual representation of a day'
+        column 'Mon through Sun'
+      end
+      row do
+        column "l (lowercase 'L')"
+        column 'A full textual representation of the day of the week'
+        column 'Sunday through Saturday'
+      end
+
+      row do
+        column 'j'
+        column 'Day of the month without leading zeros'
+        column '1 to 31'
+      end
+      row do
+        column 'J'
+        column 'Day of the month without leading zeros and ordinal suffix'
+        column '1st, 2nd, to 31st'
+      end
+      row do
+        column 'w'
+        column 'Numeric representation of the day of the week'
+        column '0 (for Sunday) through 6 (for Saturday)'
+      end
+      row do
+        column 'F'
+        column 'A full textual representation of a month'
+        column 'January through December'
+      end
+      row do
+        column 'm'
+        column 'Numeric representation of a month, with leading zero'
+        column '01 through 12'
+      end
+      row do
+        column 'n'
+        column 'Numeric representation of a month, without leading zeros'
+        column '1 through 12'
+      end
+      row do
+        column 'M'
+        column 'A short textual representation of a month'
+        column 'Jan through Dec'
+      end
+      row do
+        column 'U'
+        column 'The number of seconds since the Unix Epoch'
+        column '1413704993', numeric: false
+      end
+
+      row do
+        column 'y'
+        column 'A two digit representation of a year'
+        column '99 or 03'
+      end
+
+      row do
+        column 'Y'
+        column 'A full numeric representation of a year, 4 digits'
+        column '1999 or 2003'
+      end
+      row do
+        column 'Z'
+        column 'ISO Date format'
+        column '2017-03-04T01:23:43.000Z'
+      end
+    end
+
+    display 'Time Formatting Tokens', id: :time
+    table do
+      header do
+        column 'Character '
+        column 'Description'
+        column 'Example'
+      end
+      row do
+        column 'H'
+        column 'Hours (24 hours)'
+        column '00 to 23'
+      end
+      row do
+        column 'h'
+        column 'Hours'
+        column '1 to 12'
+      end
+      row do
+        column 'i'
+        column 'Minutes'
+        column '00 to 59'
+      end
+      row do
+        column 'S'
+        column 'Seconds, 2 digits'
+        column '00 to 59'
+      end
+      row do
+        column 's'
+        column 'Seconds'
+        column '0, 1 to 59'
+      end
+      row do
+        column 'K'
+        column 'AM/PM'
+        column 'AM or PM'
+      end
+    end
+  end
+end

data/app/demo/index.pom

@@ -7,13 +7,20 @@ Voom::Presenters.define(:index) do
   indented_grid do
     headline 'Presenters', id: :headline
     subheading 'Presenters are to HTML what C is to assembly'
-    body ['A presenter describes a user interface. It is evaluated and a presenter object model (POM) is returned.',
-          'A client that renders POM can display the given user interface.']
 
-    subheading 'For example this is the presentation for this page:', level: 2
+    body ['A presenter describes a user interface using a ruby DSL.',
+          'The presenter is evaluated and a presenter object model (POM) is generated.',
+          'A client that renders POM can display the given user interface.']
 
-    attach 'code', file: __FILE__
-  end
+    body 'To get started checkout the components and events.'
 
+    subheading 'For example this is the presenter dsl for this page:', level: 2
 
+    source = File.read(__FILE__)
+    body <<~HEREDOC
+      ```
+        #{source}  
+      ```
+    HEREDOC
+  end
 end

data/app/demo/markdown.pom

@@ -28,46 +28,39 @@ Voom::Presenters.define(:markdown) do
     body '1. Item 1', '2. Item 2'
 
     title 'Full Sample'
-    body <<-HEREDOC
-# Markdown Sample
-
-----
-## what is Markdown?
-see [Wikipedia](http://en.wikipedia.org/wiki/Markdown)
-
-> Markdown is a lightweight markup language, originally created by John Gruber and Aaron Swartz allowing people "to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML)".
-
-----
-## markdown quick reference
-# headers
-
-*emphasis*
-
-**strong** 
-
-* list
-
->block quote
-
-`code inline`
-
-```ruby
-  require 'redcarpet'
-  markdown = Redcarpet.new("Hello World!")
-  puts markdown.to_html
-```
-[links](http://wikipedia.org)
-
-----
-## changelog
-* 17-Feb-2013 re-design
-
-----
-## thanks
-* [markdown-js](https://github.com/evilstreak/markdown-js)
-
+    body <<~HEREDOC
+      # Markdown Sample
+      
+      ----
+      ## what is Markdown?
+      see [Wikipedia](http://en.wikipedia.org/wiki/Markdown)
+      
+      > Markdown is a lightweight markup language, originally created by John Gruber and Aaron Swartz allowing people "to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML)".
+      
+      ----
+      ## markdown quick reference
+      # headers
+      
+      *emphasis*
+      
+      **strong** 
+      
+      * list
+      
+      >block quote
+      
+      `code inline`
+      
+      ```ruby
+        require 'redcarpet'
+        markdown = Redcarpet.new("Hello World!")
+        puts markdown.to_html
+      ```
+      [links](http://wikipedia.org)
+      
+      ----
+      ## changelog
+      * 17-Feb-2013 re-design
     HEREDOC
-
-
   end
 end

data/app/demo/shared/context_list.pom

@@ -5,11 +5,11 @@ Voom::Presenters.define(:context_list) do
     end
 
     def time
-      Time.now unless context.fetch('testing') {false}
+      Time.now unless context.fetch(:hide_time) {false}
     end
 
     def scrubbed_context
-      scrubbed_keys = context.fetch(:exclude) {%w{title file testing}}
+      scrubbed_keys = context.fetch(:exclude) {%w{title file hide_time}}
       context.select {|k, _| !scrubbed_keys.include?(k.to_s)}
     end
   end

data/app/demo/styles.pom

@@ -22,5 +22,6 @@ Voom::Presenters.define(:styles) do
           'aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat',
           'nulla pariatur.'], level: 1
     body 'Body 2 text, calling something out.', level: 2
+    body 'You can use [markdown](/markdown) in your typography'
   end
 end

data/config.ru

@@ -1,4 +1,13 @@
 #!/usr/bin/env ruby
+if ENV['VOOM_ENV']=='integration_testing'
+  require 'simplecov'
+  if ENV['CIRCLE_ARTIFACTS']
+    dir = File.join(ENV['CIRCLE_ARTIFACTS'], "coverage")
+    SimpleCov.coverage_dir(dir)
+  end
+  SimpleCov.start
+end
+
 ENV['VOOM_ROOT'] = File.expand_path(__dir__)
 libdir = File.join(ENV['VOOM_ROOT'], 'lib')
 $:.unshift(libdir) unless $:.include?(libdir)

data/lib/voom/presenters/dsl/components/base.rb

@@ -72,6 +72,11 @@ module Voom
             @parent.send(:_helpers_) if @parent
           end
 
+
+          def default(key)
+            Settings.config.presenters.components.defaults&.public_send(type)&.public_send(key)
+          end
+
         end
       end
     end

data/lib/voom/presenters/dsl/components/card.rb

@@ -7,6 +7,7 @@ require_relative 'mixins/avatar'
 require_relative 'mixins/text_fields'
 require_relative 'mixins/icons'
 require_relative 'mixins/snackbars'
+require_relative 'mixins/date_time_fields'
 
 module Voom
   module Presenters
@@ -16,6 +17,7 @@ module Voom
           include Mixins::Common
           include Mixins::Attaches
           include Mixins::TextFields
+          include Mixins::DateTimeFields
           include Mixins::Icons
           include Mixins::Snackbars
 

data/lib/voom/presenters/dsl/components/content.rb

@@ -5,6 +5,7 @@ require_relative 'mixins/attaches'
 require_relative 'mixins/text_fields'
 require_relative 'mixins/selects'
 require_relative 'mixins/snackbars'
+require_relative 'mixins/date_time_fields'
 
 module Voom
   module Presenters
@@ -14,6 +15,7 @@ module Voom
           include Mixins::Common
           include Mixins::Attaches
           include Mixins::TextFields
+          include Mixins::DateTimeFields
           include Mixins::Selects
           include Mixins::Snackbars
 

data/lib/voom/presenters/dsl/components/date_field.rb

@@ -0,0 +1,21 @@
+require_relative 'datetime_base'
+
+module Voom
+  module Presenters
+    module DSL
+      module Components
+        class DateField < DatetimeBase
+          attr_reader :config
+
+          def initialize(**attribs_, &block)
+            super(type: :date, **attribs_, &block)
+            merge_config(:min_date)
+            merge_config(:max_date)
+            expand!
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/voom/presenters/dsl/components/datetime_base.rb

@@ -0,0 +1,48 @@
+require_relative 'text_field'
+
+module Voom
+  module Presenters
+    module DSL
+      module Components
+        class DatetimeBase < TextField
+          attr_reader :config
+
+          def initialize(**attribs_, &block)
+            super(**attribs_, &block)
+            @config = {}
+            map_config(:format, :alt_format, true)
+            merge_config(:disable)
+            merge_config(:enable)
+            merge_config(:mode)
+            merge_config(:time_24hr, true)
+
+            clear_icon(:clear) do
+              event :click do
+                snackbar 'Clicked'
+              end
+            end
+          end
+
+          def clear_icon(icon=nil, **attribs, &block)
+            return @clear_icon if locked?
+            @clear_icon = icon ? Components::Icon.new(parent: self, icon: icon,
+                                                      context: context,
+                                                      **attribs, &block) : nil
+          end
+
+          private
+          def merge_config(attrib, default=false)
+            attrib_value = attribs.delete(attrib) {default ? default(attrib) : nil}
+            @config.merge!({attrib => attrib_value}) if attrib_value
+          end
+
+          def map_config(attrib, new_attrib, default=false)
+            attrib_value = attribs.delete(attrib) {default ? default(attrib) : nil}
+            @config.merge!({new_attrib => attrib_value}) if attrib_value
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/voom/presenters/dsl/components/datetime_field.rb

@@ -0,0 +1,23 @@
+require_relative 'datetime_base'
+
+module Voom
+  module Presenters
+    module DSL
+      module Components
+        class DatetimeField < DatetimeBase
+          attr_reader :config
+
+          def initialize(**attribs_, &block)
+            super(type: :datetime, **attribs_, &block)
+            merge_config(:min_date)
+            merge_config(:max_date)
+            merge_config(:min_time)
+            merge_config(:max_time)
+            expand!
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/voom/presenters/dsl/components/expansion_panel.rb

@@ -1,4 +1,5 @@
 require_relative 'mixins/common'
+require_relative 'mixins/attaches'
 
 module Voom
   module Presenters

data/lib/voom/presenters/dsl/components/form.rb

@@ -12,6 +12,7 @@ require_relative 'mixins/attaches'
 require_relative 'mixins/expansion_panels'
 require_relative 'mixins/content'
 require_relative 'mixins/typography'
+require_relative 'mixins/date_time_fields'
 
 module Voom
   module Presenters
@@ -21,6 +22,7 @@ module Voom
           include Mixins::Append
           include Mixins::Grids
           include Mixins::TextFields
+          include Mixins::DateTimeFields
           include Mixins::Selects
           include Mixins::Toggles
           include Mixins::Buttons

data/lib/voom/presenters/dsl/components/grid.rb

@@ -8,6 +8,7 @@ require_relative 'mixins/chips'
 require_relative 'mixins/snackbars'
 require_relative 'mixins/selects'
 require_relative 'mixins/text_fields'
+require_relative 'mixins/date_time_fields'
 
 module Voom
   module Presenters
@@ -42,6 +43,7 @@ module Voom
             include Mixins::Dialogs
             include Mixins::Chips
             include Mixins::TextFields
+            include Mixins::DateTimeFields
             include Mixins::Selects
             include Mixins::Toggles
             include Mixins::Snackbars

data/lib/voom/presenters/dsl/components/mixins/date_time_fields.rb

@@ -0,0 +1,29 @@
+module Voom
+  module Presenters
+    module DSL
+      module Components
+        module Mixins
+          module DateTimeFields
+            def datetime_field(**attribs, &block)
+              self << Components::DatetimeField.new(parent: self,
+                                                    context: context,
+                                                    **attribs, &block)
+            end
+
+            def date_field(**attribs, &block)
+              self << Components::DateField.new(parent: self,
+                                                context: context,
+                                                **attribs, &block)
+            end
+
+            def time_field(**attribs, &block)
+              self << Components::TimeField.new(parent: self,
+                                                context: context,
+                                                **attribs, &block)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/voom/presenters/dsl/components/mixins/text_fields.rb

@@ -21,12 +21,6 @@ module Voom
                                                   context: context,
                                                   **attribs, &block)
             end
-
-            def datetime_field(**attribs, &block)
-              self << Components::DateTime.new(parent: self,
-                                                  context: context,
-                                                  **attribs, &block)
-            end
           end
         end
       end

data/lib/voom/presenters/dsl/components/table.rb

@@ -66,7 +66,7 @@ module Voom
               def initialize(**attribs_, &block)
                 super(type: :column, **attribs_, &block)
                 value = attribs.delete(:value)
-                @numeric = attribs.delete(:numeric) || numeric?(value)
+                @numeric = attribs.delete(:numeric){numeric?(value)}
                 self.value(value) if value
                 @color = attribs.delete(:color)
                 @components = []

data/lib/voom/presenters/dsl/components/time_field.rb

@@ -0,0 +1,21 @@
+require_relative 'datetime_base'
+
+module Voom
+  module Presenters
+    module DSL
+      module Components
+        class TimeField < DatetimeBase
+          attr_reader :config
+
+          def initialize(**attribs_, &block)
+            super(type: :time, **attribs_, &block)
+            map_config(:min_time, :min_date)
+            map_config(:max_time, :max_date)
+            expand!
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/voom/presenters/dsl/user_interface.rb

@@ -5,6 +5,7 @@ require_relative 'components/mixins/helpers'
 require_relative 'components/mixins/dialogs'
 require_relative 'components/mixins/snackbars'
 require_relative 'components/mixins/text_fields'
+require_relative 'components/mixins/date_time_fields'
 require_relative 'invalid_presenter'
 
 require 'voom/serializer'
@@ -23,6 +24,8 @@ module Voom
         include Components::Mixins::Snackbars
         include Components::Mixins::Icons
         include Components::Mixins::TextFields
+        include Components::Mixins::DateTimeFields
+
 
         include Voom::Serializer
         include Voom::Trace