coprl 3.0.0.beta.1 → 3.0.0.beta.6

data/views/mdc/components/_datetime.erb

@@ -3,7 +3,7 @@
   type_class = comp.picker ? 'v-datetime' : 'v-date-text'
 %>
 <div id="<%= comp.id %>"
-     <% if comp.tag %>data-input-tag="<%= comp.tag %>"<% end %>
+     <% if comp.input_tag %>data-input-tag="<%= comp.input_tag %>"<% end %>
      <% if comp.dirtyable %>data-dirtyable<% end %>
      class="v-input <%= type_class %> mdc-text-field mdc-text-field--outlined
             <%= 'mdc-text-field--with-trailing-icon' if comp.clear_icon %>

data/views/mdc/components/_dialog.erb

@@ -2,8 +2,8 @@
   dialog_action_buttons = Array(comp&.actions&.buttons)
 %>
 <div id="<%= comp.id %>"
-     <% if comp.tag %>
-     data-input-tag="<%= comp.tag %>"
+     <% if comp.input_tag %>
+     data-input-tag="<%= comp.input_tag %>"
      <% end %>
      class="v-dialog mdc-dialog"
      role="alertdialog"

data/views/mdc/components/_form.erb

@@ -1,6 +1,6 @@
 <form role="form"
-      <% if comp.tag %>
-      data-input-tag="<%= comp.tag %>"
+      <% if comp.input_tag %>
+      data-input-tag="<%= comp.input_tag %>"
       <% end %>
       id="<%= comp.id %>"
       class="v-form"

data/views/mdc/components/_grid.erb

@@ -6,8 +6,8 @@
    @gutters.push comp.gutter.nil? ? @gutters.last : comp.gutter
 %>
 <div id="<%= comp.id %>"
-     <% if comp.tag %>
-     data-input-tag="<%= comp.tag %>"
+     <% if comp.input_tag %>
+     data-input-tag="<%= comp.input_tag %>"
      <% end %>
      class="v-grid mdc-layout-grid
             <%= _padding_classes_(comp.padding, @grid_nesting) %>

data/views/mdc/components/_hidden_field.erb

@@ -1,5 +1,5 @@
 <input class="v-input v-hidden-field"
        type="hidden"
-       <% if comp.tag %>data-input-tag="<%= comp.tag %>"<% end %>
+       <% if comp.input_tag %>data-input-tag="<%= comp.input_tag %>"<% end %>
        <% if comp.dirtyable %>data-dirtyable<% end %>
        id="<%= comp.id %>" name="<%= comp.name %>" value="<%= comp.value %>"/>

data/views/mdc/components/_multi_select.erb

@@ -2,7 +2,7 @@
      float_label = comp.options.select{|o| o.selected }.any?
 %>
   <div class="v-multi-select-container"
-       <% if comp.tag %>data-input-tag="<%= comp.tag %>"<% end %>
+       <% if comp.input_tag %>data-input-tag="<%= comp.input_tag %>"<% end %>
        <% if comp.dirtyable %>data-dirtyable<% end %>>
     <div class="v-multi-select--options-list v-hidden">
       <% comp.options.each do |option| %>

data/views/mdc/components/_number_field.erb

@@ -4,7 +4,7 @@
      auto_complete = comp.auto_complete&.to_sym == :off ? 'extra-off' : comp.auto_complete
 %>
   <div id="<%= comp.id %>"
-       <%= "data-input-tag='#{comp.tag}'" if comp.tag %>
+       <%= "data-input-tag='#{comp.input_tag}'" if comp.input_tag %>
        <%= 'data-dirtyable' if comp.dirtyable %>
        class="v-input v-text-field v-focusable mdc-text-field mdc-text-field--outlined
             <%= 'mdc-text-field--with-leading-icon' if leading_icon %>

data/views/mdc/components/_radio_button.erb

@@ -1,6 +1,6 @@
 <div class="v-form-field mdc-form-field">
   <div id="<%= comp.id %>"
-       <% if comp.tag %>data-input-tag="<%= comp.tag %>"<% end %>
+       <% if comp.input_tag %>data-input-tag="<%= comp.input_tag %>"<% end %>
        <% if comp.dirtyable %>data-dirtyable<% end %>
        class="v-radio mdc-radio v-input">
     <input class="mdc-radio__native-control"

data/views/mdc/components/_rich_text_area.erb

@@ -1,6 +1,6 @@
 <div class="v-rich-text-area-container v-input"
      id="<%= comp.id %>"
-     <% if comp.tag %>data-input-tag="<%= comp.tag %>"<% end %>
+     <% if comp.input_tag %>data-input-tag="<%= comp.input_tag %>"<% end %>
      <% if comp.dirtyable %>data-dirtyable<% end %>
      <% if comp.height %>data-initial-height="<%= comp.height %>"<% end %>
      <% if comp.resizable %>data-resizable<% end %>

data/views/mdc/components/_select.erb

@@ -4,7 +4,7 @@
   <div class="mdc-select v-select v-input
               <%= 'mdc-select--outlined' if comp.outlined %>
               <% if comp.disabled %>mdc-select--disabled<% end %>"
-       <% if comp.tag %>data-input-tag="<%= comp.tag %>"<% end %>
+       <% if comp.input_tag %>data-input-tag="<%= comp.input_tag %>"<% end %>
        <% if comp.dirtyable %>data-dirtyable<% end %>
        <%= 'style="width: 100%;"' if comp.full_width %>>
     <%= partial "components/icon", :locals => {comp: comp.icon, class_name: 'mdc-select__icon', parent_id: "#{comp.id}-input", size_class: '', position: []} if comp.icon %>

data/views/mdc/components/_slider.erb

@@ -1,6 +1,6 @@
 <div id="<%= comp.id %>"
-     <% if comp.tag %>
-     data-input-tag="<%= comp.tag %>"
+     <% if comp.input_tag %>
+     data-input-tag="<%= comp.input_tag %>"
      <% end %>
     class="v-slider v-input mdc-slider
       <%= 'mdc-slider--discrete' if comp.discrete %>

data/views/mdc/components/_stepper.erb

@@ -3,8 +3,8 @@
 %>
 <div class="v-errors">
   <ul id="<%= comp.id %>"
-      <% if comp.tag %>
-      data-input-tag="<%= comp.tag %>"
+      <% if comp.input_tag %>
+      data-input-tag="<%= comp.input_tag %>"
       <% end %>
       class="mdl-stepper v-stepper
             <%= ' mdl-stepper--horizontal' if horizontal %>
@@ -18,8 +18,8 @@
   <div id="<%= comp.id %>-content">
     <% for step in comp.steps %>
       <div id="<%= step.id %>-content"
-           <% if step.tag %>
-           data-input-tag="<%= step.tag %>"
+           <% if step.input_tag %>
+           data-input-tag="<%= step.input_tag %>"
            <% end %>
            class="v-content v-step__content v-step__content-<%= step.id %>
             <%= ' is-active' if step.selected %>

data/views/mdc/components/_switch.erb

@@ -3,7 +3,7 @@
 
 <div class="v-form-field mdc-form-field">
   <div id="<%= comp.id %>"
-       <% if comp.tag %>data-input-tag="<%= comp.tag %>"<% end %>
+       <% if comp.input_tag %>data-input-tag="<%= comp.input_tag %>"<% end %>
        <% if comp.dirtyable %>data-dirtyable<% end %>
        class="v-switch v-input mdc-switch
       <%= 'mdc-switch--disabled' if comp.disabled %>

data/views/mdc/components/_text_area.erb

@@ -1,6 +1,6 @@
 <div id="<%= comp.id %>" class="v-input v-text-field mdc-text-field mdc-text-field--textarea
             <% if comp.disabled %>mdc-text-field--disabled<% end %>"
-     <% if comp.tag %>data-input-tag="<%= comp.tag %>"<% end %>
+     <% if comp.input_tag %>data-input-tag="<%= comp.input_tag %>"<% end %>
      <% if comp.dirtyable %>data-dirtyable<% end %>
      style="<%= 'width:100%' if comp.full_width %>">
   <textarea id="<%= comp.id %>-input"

data/views/mdc/components/_text_field.erb

@@ -5,7 +5,7 @@
      behavior = comp.behavior || 'text'
 %>
   <div id="<%= comp.id %>"
-       <% if comp.tag %>data-input-tag="<%= comp.tag %>"<% end %>
+       <% if comp.input_tag %>data-input-tag="<%= comp.input_tag %>"<% end %>
        <% if comp.dirtyable %>data-dirtyable<% end %>
        class="v-input v-text-field v-focusable mdc-text-field mdc-text-field--outlined
             <%= 'mdc-text-field--with-leading-icon' if leading_icon %>

data/views/mdc/components/buttons/_image.erb

@@ -22,4 +22,4 @@
   <%= partial "components/icon", :locals => {comp: comp.icon, class_name: 'mdc-button__icon', position: [:right, :center]} if comp.icon %>
 </button>
 <%= partial "components/tooltip", :locals => {comp: comp.tooltip, parent_id: comp.id} if comp.tooltip %>
-<%= partial "components/menu", :locals => {comp: comp.menu, parent_id: comp.id} if comp.menus %>
+<%= partial "components/menu", :locals => {comp: comp.menu, parent_id: comp.id} if comp.menu %>

data/views/mdc/components/unordered_list/_list_item.erb

@@ -1,7 +1,7 @@
 <li class="<%= 'icon-li' if list_item.icon %>">
-  <%= erb :"components/unordered_list/icon", :locals => {:list_item => list_item} %>
+  <%= partial "components/unordered_list/icon", :locals => {:list_item => list_item} %>
   <%= expand_text(list_item.text&.text) %>
   <% if list_item.unordered_list %>
-    <%= erb :"components/unordered_list", :locals => {:comp => list_item.unordered_list} %>
+    <%= partial "components/unordered_list", :locals => {:comp => list_item.unordered_list} %>
   <% end %>
-</li>
+</li>

data/views/mdc/layout.erb

@@ -7,12 +7,12 @@
   <title><%= @pom.page.title if @pom.page %></title>
   <meta name="description" content="">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <%= coprl_headers(@base_url, request, @pom) %>
+  <%= coprl_headers %>
 </head>
 <body class="mdc-typography">
-    <%= partial "body/preamble", :locals => {pom:@pom} %>
-    <%= yield %>
-    <%= partial "body/postamble", :locals => {pom:@pom} %>
+    <% with_presenters_wrapper do %>
+      <%= yield %>
+    <% end %>
 <noscript><p>JavaScript must be enabled to continue.</p></noscript>
 </body>
 </html>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: coprl
 version: !ruby/object:Gem::Version
-  version: 3.0.0.beta.1
+  version: 3.0.0.beta.6
 platform: ruby
 authors:
 - Russell Edens
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-06-02 00:00:00.000000000 Z
+date: 2021-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ice_nine
@@ -267,33 +267,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: gem-release
+  name: shotgun
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
-  name: shotgun
+  name: timecop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: 0.9.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: 0.9.4
 description: 
 email:
 - 'rx@russelledens.net
@@ -340,7 +340,6 @@ files:
 - app/demo/components/fabs.pom
 - app/demo/components/file_inputs.pom
 - app/demo/components/footers.pom
-- app/demo/components/google_maps.pom
 - app/demo/components/headers.pom
 - app/demo/components/hidden_fields.pom
 - app/demo/components/icons.pom
@@ -360,7 +359,6 @@ files:
 - app/demo/components/selects.pom
 - app/demo/components/sliders.pom
 - app/demo/components/snackbar.pom
-- app/demo/components/snackbar_attached.pom
 - app/demo/components/steppers.pom
 - app/demo/components/tab_bars.pom
 - app/demo/components/tables.pom
@@ -391,6 +389,7 @@ files:
 - app/demo/events/content_as_form.pom
 - app/demo/events/field_level.pom
 - app/demo/events/form_level.pom
+- app/demo/events/halted.pom
 - app/demo/events/nav/drawer.pom
 - app/demo/events/parallel.pom
 - app/demo/events/tagged_input.pom
@@ -405,10 +404,20 @@ files:
 - app/demo/patterns/drag_drop.pom
 - app/demo/patterns/floating_card.pom
 - app/demo/patterns/search_select.pom
+- app/demo/plugins/animate.pom
+- app/demo/plugins/cacheable.pom
 - app/demo/plugins/chart.pom
+- app/demo/plugins/clipboard.pom
+- app/demo/plugins/color_picker.pom
+- app/demo/plugins/google_maps.pom
+- app/demo/plugins/iframe.pom
 - app/demo/plugins/image_crop.pom
 - app/demo/plugins/index.pom
+- app/demo/plugins/markup.pom
 - app/demo/plugins/nav/drawer.pom
+- app/demo/plugins/script.pom
+- app/demo/plugins/scroll_to.pom
+- app/demo/plugins/timer.pom
 - app/demo/shared/code.pom
 - app/demo/shared/context_list.pom
 - app/demo/shared/debug.pom
@@ -558,16 +567,21 @@ files:
 - lib/coprl/presenters/errors/unprocessable.rb
 - lib/coprl/presenters/generators/inflectors.rb
 - lib/coprl/presenters/generators/plugin.rb
+- lib/coprl/presenters/generators/templates/plugin/.github/workflows/semantic-release.yml
 - lib/coprl/presenters/generators/templates/plugin/.gitignore
+- lib/coprl/presenters/generators/templates/plugin/.releaserc
+- lib/coprl/presenters/generators/templates/plugin/.ruby-version
 - lib/coprl/presenters/generators/templates/plugin/Gemfile.tt
 - lib/coprl/presenters/generators/templates/plugin/LICENSE.txt.tt
-- lib/coprl/presenters/generators/templates/plugin/README.md
+- lib/coprl/presenters/generators/templates/plugin/README.md.tt
+- lib/coprl/presenters/generators/templates/plugin/demo/plugin.pom.tt
 - lib/coprl/presenters/generators/templates/plugin/lib/coprl/presenters/plugins/components/actions/action.rb.tt
 - lib/coprl/presenters/generators/templates/plugin/lib/coprl/presenters/plugins/components/actions/dsl.rb.tt
 - lib/coprl/presenters/generators/templates/plugin/lib/coprl/presenters/plugins/components/component.rb.tt
 - lib/coprl/presenters/generators/templates/plugin/lib/coprl/presenters/plugins/components/dsl.rb.tt
 - lib/coprl/presenters/generators/templates/plugin/lib/coprl/presenters/plugins/helpers/helper.rb.tt
 - lib/coprl/presenters/generators/templates/plugin/lib/coprl/presenters/plugins/plugin.rb.tt
+- lib/coprl/presenters/generators/templates/plugin/lib/coprl/presenters/plugins/version.rb.tt
 - lib/coprl/presenters/generators/templates/plugin/lib/coprl/presenters/plugins/web_client/components/actions/data.rb.tt
 - lib/coprl/presenters/generators/templates/plugin/lib/coprl/presenters/plugins/web_client/components/render.rb.tt
 - lib/coprl/presenters/generators/templates/plugin/presenter_plugin.gemspec.tt
@@ -589,9 +603,6 @@ files:
 - lib/coprl/presenters/namespace.rb
 - lib/coprl/presenters/pluggable.rb
 - lib/coprl/presenters/plugins.rb
-- lib/coprl/presenters/plugins/google_maps.rb
-- lib/coprl/presenters/plugins/google_maps/google_map.erb
-- lib/coprl/presenters/plugins/google_maps/google_map.rb
 - lib/coprl/presenters/rails/engine.rb
 - lib/coprl/presenters/rails/railtie.rb
 - lib/coprl/presenters/registry.rb
@@ -623,6 +634,7 @@ files:
 - lib/coprl/presenters/web_client/helpers/rails/partials.rb
 - lib/coprl/presenters/web_client/helpers/rails/raw.rb
 - lib/coprl/presenters/web_client/helpers/rails/safe_markdown.rb
+- lib/coprl/presenters/web_client/helpers/rails/template_helper.rb
 - lib/coprl/presenters/web_client/helpers/render_component.rb
 - lib/coprl/presenters/web_client/helpers/shared.rb
 - lib/coprl/presenters/web_client/helpers/sinatra.rb
@@ -631,6 +643,7 @@ files:
 - lib/coprl/presenters/web_client/helpers/sinatra/partials.rb
 - lib/coprl/presenters/web_client/helpers/sinatra/raw.rb
 - lib/coprl/presenters/web_client/helpers/sinatra/safe_markdown.rb
+- lib/coprl/presenters/web_client/helpers/sinatra/template_helper.rb
 - lib/coprl/presenters/web_client/helpers/snake_to_camel.rb
 - lib/coprl/presenters/web_client/helpers/transform_hash.rb
 - lib/coprl/presenters/web_client/helpers/unique_id.rb
@@ -672,6 +685,7 @@ files:
 - rails-engine/app/views/layouts/coprl.html.erb
 - rails-engine/config.ru
 - rails-engine/config/initializers/presenters.rb
+- rails-engine/config/initializers/session.rb
 - rails-engine/config/routes.rb
 - scripts/build.sh
 - views/mdc/.babelrc
@@ -802,9 +816,8 @@ files:
 - views/mdc/body/_footer.erb
 - views/mdc/body/_header.erb
 - views/mdc/body/_modal-drawer.erb
-- views/mdc/body/_postamble.erb
-- views/mdc/body/_preamble.erb
 - views/mdc/body/_snackbar.erb
+- views/mdc/body/_wrapper.erb
 - views/mdc/body/drawer/_divider.erb
 - views/mdc/body/drawer/_item.erb
 - views/mdc/body/drawer/_label.erb
@@ -939,5 +952,6 @@ requirements: []
 rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
-summary: COPRL Presenters Gem
+summary: COmmon PResenter Language - A Ruby gem for joyfully writing modern user interfaces
+  in Rack and Rails.
 test_files: []

data/app/demo/components/google_maps.pom

@@ -1,22 +0,0 @@
-require_relative '../helpers/indented_grid'
-
-Coprl::Presenters.define(:maps) do
-  helpers Demo::Helpers::IndentedGrid
-  attach :top_nav
-  attach :component_drawer
-  page_title 'Maps'
-
-  indented_grid do
-    subheading 'Static Maps'
-
-    address = '125 Park Street, Traverse City, MI'
-    google_map address: address, height: 300, width: 400  do
-      event :click do
-        loads "https://www.google.com/maps/place/#{address}"
-      end
-    end
-
-    attach :code, file: __FILE__
-  end
-
-end

data/app/demo/components/snackbar_attached.pom

@@ -1,6 +0,0 @@
-
-Coprl::Presenters.define(:snackbar_attached) do
-  title 'In Attached'
-  body  'This can be done in an attached presenter as well'
-  snackbar 'Attached Snackbar Displayed!'
-end

data/lib/coprl/presenters/generators/templates/plugin/README.md

@@ -1,253 +0,0 @@
-# Presenter Plugins
-
-Presenter plugins allows extension and modification of the DSL and WebClient.
-It is powerfully designed for adding additional components to the system, or to change the behavior/look feel/capabilities of existing components.
-
-## Global Plugins
-
-Presenters have global plugins that are configured in the system. They are declared as a setting like so:
-  
-    Coprl::Presenters::Settings.configure do |config|
-      config.presenters.plugins.push(:foo)
-    end 
-
-A global plugin is available to all presenters.
-
-## Local Plugins
-
-A presenters can define that it uses a plugin like so: 
-
-    Coprl::Presenters.define(:index, namespace: :plugins) do
-      plugin :foo
-    end
-
-A local plugin is available only to the presenter that it is defined in.
-
-
-## Creating Plugins
-
-The skeleton for a plugin starts with an empty module in a file stored in `coprl/presenters/plugins` somewhere in ruby's load path 
-(typically in a gemfile or in the lib directory of an framework app, like Rails):
-
-    module Coprl
-      module Presenters
-        module Plugins
-          module Foo
-          end
-        end
-      end
-    end
-
-## Extending the presenter DSL and POM
-
-### Components
-If you want to add additional components to the presenters DSL, provide a `DSLComponents` module under the plugin module:
-
-     module DSLComponents
-       def foo(random_fact, **attributes, &block)
-         self << Foo::Component.new(random_fact, parent: self, **attributes, &block)
-       end
-     end
-
-The above example will extend the dsl by adding the foo method that will add the Foo component to the 
-presenter object model tree.
-
-A presenter component derives from `DSL::Components::Base` or if it needs to handle events  `DSL::Components::EventBase`
-
-      require 'coprl/presenters/dsl/components/base'
-      
-      module Coprl
-        module Presenters
-          module Plugins
-            module Foo
-              class Component < DSL::Components::Base
-                def initialize(**attribs_, &block)
-                  super(type: :foo, **attribs_, &block)
-                end      
-              end
-            end
-          end
-        end
-      end
-      
-### Helpers
-
-To add helpers to the POM define the module `DSLHelpers`
-    
-    module DSLHelpers
-      def random_fact
-        "http://en.wikipedia.org/wiki/Special:Randompage"
-      end
-    end
-
-### Event Actions
-A plugin can extend the set of event actions that are available. 
-When an event fires in the client, like mouse click, a set of actions are executed. A plugin can provide custom
-actions. This examnple adds a actionJs actionJs that can be bound to an event.
-
-    module DSLEventActions
-      def actionJs(text, **attributes, &block)
-        self << Foo::Action.new(text: text, parent: self, **attributes, &block)
-      end
-    end
-    
-Example actionJs class:
-
-    require 'coprl/presenters/dsl/components/actions/base'
-    
-    module Coprl
-      module Presenters
-        module Plugins
-          module Foo
-              class Action < DSL::Components::Actions::Base
-                def initialize(**attribs_, &block)
-                  super(type: :actionJs, **attribs_, &block)
-                end
-            end
-          end
-        end
-      end
-    end
-
-    
-## Adding a WebClient implementation
-
-A plugin that extends the DSL will give you a new custom POM (Presenter Object Model), but that alone won't get you very far.
-The POM describes the user interface, a client must implement each of the components.
-For the WebClient this means adding a template with HTML, CSS and Javascript. 
-
-### Component Templates
-
-To render your component you need to add the following to your plugin:
-  
-    module WebClientComponents
-      def render_foo(comp,
-                     render:,
-                     components:,
-                     index:)
-        view_dir = File.join(__dir__, 'foo')
-        render.call :erb, :foo, views: view_dir,
-                    locals: {comp: comp,
-                             components: components, index: index}
-      end
-    end
-    
-From you ERB you can call any of the other built in WebClient erb's. You can even replace built in component templates.
-The render object supports all the template types supported by Tilt/Sinatra (http://sinatrarb.com/intro.html)
-
-Example template:
-
-    <iframe id="random_fact" src="<%= comp.random_fact %>" height=512 <%= erb :"components/event", :locals => {comp: comp, events: comp.events, parent_id: comp.id} %>></iframe>
-
-
-### Event Action Data
-
-An actionJs from the Presenter Object Model (POM) is sent to a ruby method during template expansion. 
-You are able to then setup any data that you want passed to your actionJs javascript method.
-It expects you will return an array with a type that matches your event actionJs presenter type. The rest is up to you.
-
-
-    module WebClientActions
-      def action_data_bar(actionJs, _parent_id, *)
-        # Type, URL, Options, Params (passed into javascript event/actionJs classes)
-        [actionJs.type, actionJs.url, actionJs.options.to_h, actionJs.attributes.to_h]
-      end
-    end
-    
-Example Javascript method (typically rendered by a template triggered by the render_foo method above):
-
-    <script>
-      function actionJs(_options, params, _event) {
-        // Reload iFrame: https://stackoverflow.com/questions/86428/what-s-the-best-way-to-reload-refresh-an-iframe
-        document.getElementById('random_fact').src += '';
-        return {actionJs: 'actionJs', content: {data: params.text}, statusCode: 200};
-      }
-    </script>
-
-Event actionJs WebClient methods must return a Javascript Object with the properties `actionJs`, `content` and `statusCode`.
-
-
-## WebClient Javascript Interface
-
-When developing a plugin for the WebClient you may want to have your data submitted as part of another component container.
-The most familiar example is a Form.  This requires that you bind your component to the DOM with a few methods.
-Not all plugins need to do this.
-It is only needed in the case of those components that add their data to an http post.
-
-The following components are Containers that will collect data from nested DOM elements using this lifecycle protocol.
-cards.js
-content.js
-dialogs.js
-file-inputs.js
-forms.js
-grid.js
-steppers.js
-
-Lifecycle Protocol:
-
-We call it it a protocol, because it defines a small number of DOM relationships to participate as an integrated component.
-Many frameworks require a common base class, this approach is very light by design.
-
-Container data in the WebClient is collected and submitted using the following sequence:
-
-In your element markup include the `v-input` class on an DOM element.
-
-You can see the container calling code here:
-https://github.com/rx/presenters/blob/master/views/mdc/assets/js/components/base-container.js
-
-If you add the v-plugin class to the DOM element along with a data-plugin-callback dataset that contains a string
-with the class name to proxy the plugin events to.
-
-
-Sample callback class:
-
-    // Optional Javascript callback class. You typically need to define this when you have data to submit, or special
-    // event handling to bind to.
-    // To hook this up you need to provide the `v-plugin` class and
-    // data-plugin-callback='RandomFacts' on the element.
-    class RandomFacts {
-      // passed the DOM element that has the .v-plugin class on it.
-      constructor(element) {
-      }
-  
-      // optional.
-      // Called before the component is submitted via post/put. Allows the component to add its key/value pairs to the
-      // submitted data.
-      // If you provide this you need to add the v-input class to your DOM element to get called.
-      // Containers iterate their elements that have the v-input class defined on them and invoke the prepareSubmit
-      // function for each.
-      prepareSubmit(params) {
-        // params is a key,value pair. Add name/value like so:
-        // params.push(['some_name', 'some_value']);
-      }
-  
-      // optional.
-      // Called whenever a container is about to be submitted, before prepareSubmit.
-      // returns true on success
-      // returns on failure return an error object that can be processed by VErrors:
-      //    { email: ["email must be filled", "email must be from your domain"] }
-      //    { page:  ["must be filled"] }
-      // Returning an error stops the submission.
-      validate(formData) {
-        return true;
-      }
-  
-      // optional.
-      // Clear's the control
-      clear() {
-      }
-  
-      // called to add an event listener to the component
-      // this only needs to be defined if you need the event handler to be bound to the component
-      // in a different manner.  Here is the default implementation you get if you don't define this method:
-      initEventListener(eventName, eventHandler) {
-        if (typeof this.eventsHandler === 'undefined') {
-          this.eventsHandler = {};
-        }
-        if (!this.eventsHandler[eventName]) {
-          // Delegate to the component if possible
-          this.eventsHandler[eventName] = eventHandler;
-          this.element.addEventListener(eventName, eventHandler);
-        }
-      }
-    }