coprl 0.1.0 → 3.0.0.beta.1

data/app/demo/events/field_level.pom

@@ -0,0 +1,20 @@
+Coprl::Presenters.define(:field_level_events) do
+  helpers Demo::Helpers::IndentedGrid
+  attach :top_nav
+  attach :events_drawer
+
+  indented_grid do
+    display 'Field Level Events'
+    heading 'Text Fields'
+    body 'This demonstrates that a change event will submit the  field value to the event action. '\
+             'This works with posts and replace actions'
+    text_field name: :myfield do
+      label 'Data to post'
+      event :change do
+        replaces :context_list, :context_list
+      end
+    end
+    attach :context_list
+  end
+  attach :code, file: __FILE__
+end

data/app/demo/events/form_level.pom

@@ -0,0 +1,24 @@
+Coprl::Presenters.define(:form_level_events) do
+  helpers Demo::Helpers::IndentedGrid
+
+  attach :top_nav
+  attach :events_drawer
+
+  indented_grid do
+    display 'Posts in Form'
+    body 'This demonstrates that a change event on **ANY** form input will send all the form inputs to the event action. '\
+             'This works with posts and replace actions'
+    form do
+      text_field name: :myfield do
+        label 'Data to post'
+      end
+      text_field name: :myfield2 do
+        label 'More Data to post'
+      end
+      event :change do
+        replaces :context_list, :context_list
+      end
+    end
+    attach :context_list
+  end
+end

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

@@ -0,0 +1,25 @@
+Coprl::Presenters.define(:events_drawer) do
+  helpers Coprl::Presenters::Helpers::Inflector
+
+  events = %i[field_level_events form_level_events tagged_input parallel_events].sort
+  actions = %i[dialog replaces loads toggle_visibility snackbar updates deletes posts clear last_response prompt_if_dirty].sort
+
+  drawer 'Events' do
+    menu do
+      events.each do |comp|
+        item titleize(comp) do
+          event :click do
+            loads comp
+          end
+        end
+      end
+      actions.each do |comp|
+        item titleize(comp) do
+          event :click do
+            loads "#{comp}_action"
+          end
+        end
+      end
+    end
+  end
+end

data/app/demo/events/parallel.pom

@@ -0,0 +1,44 @@
+Coprl::Presenters.define(:parallel_content) do
+  content id: context['id'] do
+    heading6 Time.now
+  end
+end
+
+Coprl::Presenters.define(:parallel_events) do
+  helpers Demo::Helpers::IndentedGrid
+  attach :top_nav
+   attach :events_drawer
+
+  indented_grid do
+    display 'Parallel Events'
+    body 'This demonstrates multiple event handlers for the same event, running in parallel.
+          It also shows the onload event running in parallel.'
+
+    event :onload do
+      replaces :first, :parallel_content, id: :first
+    end
+    event :onload do
+      replaces :second, :parallel_content, id: :second
+    end
+
+    button :load_in_parallel do
+      event :click do
+        replaces :third, :parallel_content, id: :third
+      end
+      event :click do
+        replaces :forth, :parallel_content, id: :forth
+      end
+
+      event :click do
+        replaces :fifth, :parallel_content, id: :fifth
+      end
+    end
+
+    content id: :first
+    content id: :second
+    content id: :third
+    content id: :forth
+    content id: :fifth
+  end
+  attach :code, file: __FILE__
+end

data/app/demo/events/tagged_input.pom

@@ -0,0 +1,37 @@
+Coprl::Presenters.define(:tagged_input) do
+  helpers Demo::Helpers::IndentedGrid
+
+  attach :top_nav
+  attach :events_drawer
+
+  indented_grid do
+    display 'Tagged Input'
+    body %(This demonstrates the ability to tag containers or components and then to post those values in an event action.
+         Sometimes you need to pull values from different nesting levels on a page to post.
+         Tags let you collect all tagged inputs from anywhere on the page and post them to some server side action.
+         An example of this can be found in the [search select](/search_select) pattern demo.)
+
+    blank
+    body 'Tags can be applied to containers and/or components.
+         Containers include content blocks, grids, forms, steppers, dialogs and cards.
+         All input components accept tags.'
+
+    title 'Example'
+
+    content tag: :somefields do
+      radio_button text: :on, name: :check_me, value: :on, checked: true
+      radio_button text: :off, name: :check_me, value: :off
+    end
+    text_field name: :myfield2, tag: :somefields do
+      label 'More Data to post'
+    end
+
+    button 'Press me' do
+      event :click do
+        replaces :context_list, :context_list, input_tag: :somefields
+      end
+    end
+    attach :context_list
+    attach :code, file: __FILE__
+  end
+end

data/app/demo/formatting_tokens.pom

@@ -0,0 +1,125 @@
+Coprl::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/hello_world.pom

@@ -0,0 +1,3 @@
+Coprl::Presenters.define(:hello_world) do
+    headline 'Hello World'
+end

data/app/demo/helpers/indented_grid.rb

@@ -0,0 +1,14 @@
+module Demo
+  module Helpers
+    module IndentedGrid
+      def indented_grid(&block)
+        grid do
+          column 1
+          column 10 do
+            yield_to(&block)
+          end
+        end
+      end
+    end
+  end
+end

data/app/demo/index.pom

@@ -0,0 +1,26 @@
+require_relative 'helpers/indented_grid'
+
+Coprl::Presenters.define(:index) do
+  helpers Demo::Helpers::IndentedGrid
+  attach :top_nav
+
+  indented_grid do
+    headline 'COmmon PResenter Language (COPRL) Ruby Demo - AKA Presenters', id: :headline
+    subheading 'COPRL is to HTML what C is to assembly'
+
+    body ['A presenter describes a user interface using DSL.',
+          'The presenter is evaluated and a presenter object model (POM) is generated. The POM can be serialized as JSON.',
+          'A client that renders POM can display the given user interface.']
+
+    body 'To get started checkout the components and events.'
+
+    subheading 'For example this is the complete presenter DSL for this page:', level: 2
+
+    source = File.read(__FILE__)
+    body <<~HEREDOC
+      ```
+        #{source}  
+      ```
+    HEREDOC
+  end
+end

data/app/demo/markdown.pom

@@ -0,0 +1,67 @@
+require_relative 'helpers/indented_grid'
+
+Coprl::Presenters.define(:markdown) do
+  helpers Demo::Helpers::IndentedGrid
+  attach :top_nav
+
+  indented_grid do
+    heading 'Markdown'
+
+    body 'Markdown on all text elements is supported.',
+         'It uses [redcarpet](https://github.com/vmg/redcarpet) with the Safe render.'
+    title 'Line breaks'
+    body 'Passing multiple text strings', 'creates line breaks'
+    body ['Arrays of  text strings is the same', 'it creates line breaks']
+    body "You can also do line breaks with two line feeds\n\nThis is on another line"
+    body "You can also do line breaks with two carriage returns\r\rThis is on another line"
+    body 'Line two carriage returns in a single string does the same thing
+
+         This is on another line'
+    body "Line two carriage returns in a double quoted string does the same thing\n\n\tThis is also another line"
+    body "A single line feed does not add a line\nThis is on the same line."
+    body "A single carriage return does not add a line\rThis is on the same line."
+    body "A carriage return followed by a line feed.\r\nDoes not break up the line."
+    title 'Escaping HTML'
+    body '<h1>HTML is escaped</h1>'
+    body '<script>console.log("so are script tags")</script>'
+    title 'Lists'
+    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
+    HEREDOC
+    attach :code, file: __FILE__
+  end
+end

data/app/demo/namespaces.pom

@@ -0,0 +1,89 @@
+require_relative 'helpers/indented_grid'
+
+Coprl::Presenters.define(:namespaces) do
+  helpers Demo::Helpers::IndentedGrid
+  attach :top_nav
+  page_title 'Namespaces' do
+    icon 'far fa-object-group'
+  end
+
+  indented_grid do
+    body 'Presenters support namespaces. The namespace is an optional parameter to the define method:'
+    blank
+    body "`Coprl::Presenters.define(:mypresenter, namespace: :namespace1)` or"
+    attach 'namespace2:alternate_namespacing'
+
+    body %(When defined in a namespace all other presenters in the same namespace are accessable without scoping the namespace.
+           When accessing a presenter outside your current namespace, simple provide the namespace(s) with `:` as the separator.
+           attach, loads and replaces all accept namespaced presenters:)
+    blank
+    attach 'namespace1:attach_with_namespace'
+    blank
+    body   'Both loads and replaces are namespace aware. To call a presenter in the ame namespace, no scoping is needed.
+            To call a presenter in another namespace, you need to fully qualify it.'
+    button 'Load' do
+      event :click do
+        loads 'namespace1:attach_with_namespace', replaced: 'I was loaded'
+      end
+    end
+    button 'Replace' do
+      event :click do
+        replaces :attach_with_namespace_id, 'namespace1:attach_with_namespace', replaced: 'I was replaced'
+      end
+    end
+    blank
+    attach 'namespace1:namespace2:nested_namespaces'
+    button 'Load' do
+      event :click do
+        loads 'namespace1:namespace2:nested_namespaces', replaced: 'I was loaded'
+      end
+    end
+    button 'Replace' do
+      event :click do
+        replaces :nested_namespaces_id, 'namespace1:namespace2:nested_namespaces', replaced: 'I was replaced'
+      end
+    end
+    blank
+    body %(Routes add the namespace(s) as a prefix: /namespace1/mypresenter)
+    blank
+    overline 'Notes:'
+    attach 'namespace1:namespace2:notes'
+  end
+  attach :code, file: __FILE__
+end
+
+Coprl::Presenters.define(:attach_with_namespace, namespace: :namespace1) do
+  content id: :attach_with_namespace_id do
+    body "For example: `attach 'namespace1:mypresenter'` to insert/attach a presenter in a different namespace."
+    attach :replaced # Demonstrates calling top level presenters from a namespaced presenter
+  end
+end
+
+Coprl::Presenters.define(:nested_namespaces, namespace: [:namespace1, :namespace2]) do
+  content id: :nested_namespaces_id do
+    body %(Namespaces can be nested two levels deep by passing an array of namespaces:
+              `Coprl::Presenters.define(:mypresenter, namespace: [:foo,:bar])`)
+    attach :replaced # Demonstrates calling top level presenters from a namespaced presenter
+  end
+end
+
+Coprl::Presenters.define(:replaced) do
+  body "#{context[:replaced]}"
+end
+
+Coprl::Presenters.define('namespace2:alternate_namespacing') do
+    body "`Coprl::Presenters.define('namespace1:mypresenter')`"
+    attach :blank_line # demonstrates attaching a presenter in the same namespace mixing alternate naming
+end
+
+Coprl::Presenters.define(:blank_line, namespace: :namespace2) do
+  blank
+end
+
+Coprl::Presenters.define('namespace2:notes', namespace: :namespace1) do
+  body <<~HEREDOC
+    * You can mix the two syntax's. `Coprl::Presenters.define('namespace2:mypresenter', namespace: 'namespace1')`
+      * With this syntax attach/loads and replaces will operate in namespace1, unless fully qualified    
+    * Unlike ruby modules you are either inside a namespace and can call presenters without qualification, or you are not and you must fully qualify them.
+  HEREDOC
+end