voom-presenters 0.1.0

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

@@ -0,0 +1,26 @@
+require_relative 'mixins/event'
+require_relative 'input'
+require_relative 'mixins/tooltips'
+
+module Voom
+  module Presenters
+    module DSL
+      module Components
+        # Base class used by toggle classes
+        class ToggleBase < Input
+          include Mixins::Tooltips
+
+          attr_accessor :text, :checked, :value, :disabled
+         
+          def initialize(**attribs_, &block)
+            super(**attribs_, &block)
+            @text = attribs.delete(:text)
+            @checked = attribs.delete(:checked) || false
+            @value = attribs.delete(:value)
+            @disabled = attribs.delete(:disabled) || false
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+module Voom
+  module Presenters
+    module DSL
+      module Components
+        class Tooltip < Base
+          attr_reader :position
+
+          def initialize(**attribs_, &block)
+            super(type: :tooltip,
+                  context: context,
+                  **attribs_, &block)
+            @position = attribs.delete(:position){ :left }
+            self.text(attribs.delete(:text)) if attribs.key?(:text)
+            expand!
+          end
+
+          def text(*text, **attribs, &block)
+            return @text if locked?
+            @text = Components::Typography.new(parent: self, type: :text, text: text, context: context, **attribs, &block)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+require_relative 'mixins/event'
+require_relative 'mixins/tooltips'
+
+module Voom
+  module Presenters
+    module DSL
+      module Components
+        class Typography < EventBase
+          include Mixins::Tooltips
+
+          attr_accessor :text, :level, :color, :position
+
+          def initialize(parent:, **attribs_, &block)
+            super(type: :text, parent: parent, **attribs_, &block)
+            @text = Array(attribs.delete(:text)||'').flatten.join("\n\n").split("\n\n")
+            @level = attribs.delete(:level){1}
+            @color = attribs.delete(:color)
+            @position = Array(attribs.delete(:position)).compact
+            expand!
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,13 @@
+require_relative 'components/base'
+require_relative 'components/event_base'
+Dir[__dir__ + "/components/*.rb"].each {|file| require file }
+
+module Voom
+  module Presenters
+    module DSL
+      # The default dsl for ui
+      module Definer
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+require_relative 'user_interface'
+
+module Voom
+  module Presenters
+    module DSL
+      # The default dsl for ui
+      # This class is held in the container. When a request to render a UI comes in
+      # It creates a new UserInterface instance, binding it to the router and context of the request
+      class Definition
+        def initialize(&block)
+          @block = block
+        end
+
+        def build
+          self
+        end
+
+        def expand(router: , context:{}, &block)
+          presenter = UserInterface.new(router: router, context: context,  &@block)
+          yield(presenter) if block
+          presenter.expand_instance
+        end
+
+        def expand_child(parent:, context: {})
+          presenter = UserInterface.new(parent: parent, context: context, &@block)
+          presenter.expand_instance(freeze: false)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,8 @@
+module Voom
+  module Presenters
+    module DSL
+      class InvalidPresenter < StandardError
+      end
+    end
+  end
+end

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

@@ -0,0 +1,15 @@
+module Voom
+  module Presenters
+    module DSL
+      module Lockable
+        def lock!
+          @locked = true
+        end
+
+        def locked?
+          @locked || frozen?
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,135 @@
+require 'ice_nine'
+require_relative 'definer'
+require_relative 'components/mixins/common'
+require_relative 'components/mixins/helpers'
+require_relative 'components/mixins/dialogs'
+require_relative 'components/mixins/snackbars'
+require_relative 'invalid_presenter'
+
+require 'voom/serializer'
+require 'voom/trace'
+
+
+module Voom
+  module Presenters
+    module DSL
+      class UserInterface
+        include DSL::Definer
+        include Lockable
+        include Components::Mixins::Common
+        include Components::Mixins::Helpers
+        include Components::Mixins::Dialogs
+        include Components::Mixins::Snackbars
+        include Components::Mixins::Icons
+
+        include Voom::Serializer
+        include Voom::Trace
+
+        attr_reader :router, :context, :components
+        private :context, :router
+        alias params context
+
+        def initialize(parent: nil, router: nil, context:, &block)
+          @parent = parent
+          @router = router || @parent&.send(:router)
+          @context = context
+          @block = block
+          @header = nil
+          @drawer = nil
+          @components = []
+          @footer = nil
+          add_global_helpers
+        end
+
+        def page(title=nil, **attribs, &block)
+          return @page if locked?
+          @page = Components::Page.new(parent: self, context: context,
+                                       **attribs, &block)
+        end
+
+        def header(title=nil, **attribs, &block)
+          return @header if locked?
+          @header = Components::Header.new(parent: self, title: title,
+                                           context: context,
+                                           **attribs, &block)
+        end
+
+        def drawer(name=nil, **attribs, &block)
+          return @drawer if locked?
+          @drawer = Components::Drawer.new(parent: self, title: name,
+                                           context: context,
+                                           **attribs, &block)
+        end
+
+
+
+        def footer(**attribs, &block)
+          return @footer if locked?
+          @footer = Components::Footer.new(parent: self,
+                                           context: context,
+                                           **attribs, &block)
+        end
+
+        def attach(presenter, **context_, &yield_block)
+          @_yield_block_ = yield_block
+          pom = Voom::Presenters::App[presenter].call.expand_child(parent: self, context: context.merge(context_))
+          @header ||= pom.header
+          @drawer ||= pom.drawer
+          @footer ||= pom.footer
+          @components += pom.components
+        end
+
+        # Called by the definition.expand method to evaluate a user interface with a different context
+        # This should be made unavailable to the dsl
+        def expand_instance(freeze: true)
+          instance_eval(&@block)
+          lock!
+          deep_freeze if freeze
+          self
+        end
+
+        def url(**context_)
+          return '#' unless @router
+          context = context_.dup
+          link_to = context.delete(:link)
+          post_to = context.delete(:command)
+          @router.url(render: link_to, command: post_to, context: context)
+        end
+
+        def type
+          :presenter
+        end
+
+        private
+
+        def deep_freeze
+          IceNine.deep_freeze(self) if Presenters::Settings.config.presenters.deep_freeze
+          self
+        end
+
+        private
+
+        def parent(for_type)
+          nil
+        end
+
+        def _helpers_
+          return @helpers if @helpers
+        end
+
+        def yield_block
+          return @_yield_block_ if @_yield_block_
+          @parent.send(:yield_block) if @parent
+        end
+
+        def add_global_helpers
+          Presenters::Settings.config.presenters.helpers.each do |helper|
+            self.helpers(helper)
+          end
+        end
+
+      end
+    end
+  end
+end
+

data/lib/voom/presenters/errors/parameter_validation.rb

@@ -0,0 +1,10 @@
+require_relative 'unprocessable'
+
+module Voom
+  module Presenters
+    module Errors
+      class ParameterValidation < Unprocessable
+      end
+    end
+  end
+end

data/lib/voom/presenters/errors/unprocessable.rb

@@ -0,0 +1,8 @@
+module Voom
+  module Presenters
+    module Errors
+      class Unprocessable < StandardError
+      end
+    end
+  end
+end

data/lib/voom/presenters/helpers.rb

@@ -0,0 +1,18 @@
+require_relative 'helpers/date'
+require_relative 'helpers/time'
+require_relative 'helpers/inflector'
+require_relative 'helpers/errors'
+
+module Voom
+  module Presenters
+    module Helpers
+      include Helpers::Time
+      include Helpers::Date
+      include Helpers::Errors
+      if defined?(Rails)
+        require_relative 'helpers/rails'
+        include Voom::Presenters::Helpers::Rails
+      end
+    end
+  end
+end

data/lib/voom/presenters/helpers/currency.rb

@@ -0,0 +1,14 @@
+module Voom
+  module Presenters
+    module Helpers
+      module Currency
+        include ActionView::Helpers::NumberHelper
+
+        def cents_to_currency(amount)
+          number_to_currency(amount.to_f / 100)
+        end
+
+      end
+    end
+  end
+end

data/lib/voom/presenters/helpers/date.rb

@@ -0,0 +1,22 @@
+module Voom
+  module Presenters
+    module Helpers
+      module Date
+        LONG_FORMAT='%m/%d/%Y'
+        SHORT_FORMAT='%d %b %Y'
+
+        def format_date(date, format: '%m/%d/%Y')
+          date ? date.strftime(format) : ''
+        end
+
+        def format_date_long(time, format: nil)
+          format_date(time, format: format||LONG_FORMAT)
+        end
+
+        def format_date_short(time, format: nil)
+          format_date(time, format: format||SHORT_FORMAT)
+        end
+      end
+    end
+  end
+end

data/lib/voom/presenters/helpers/errors.rb

@@ -0,0 +1,11 @@
+module Voom
+  module Presenters
+    module Helpers
+      module Errors
+        def raise_parameter_validation(msg)
+          raise Voom::Presenters::Errors::ParameterValidation, msg
+        end
+      end
+    end
+  end
+end

data/lib/voom/presenters/helpers/inflector.rb

@@ -0,0 +1,16 @@
+module Voom
+  module Presenters
+    module Helpers
+      module Inflector
+        def inflector
+          @inflector ||= Dry::Inflector.new
+        end
+
+        def humanize(text)
+          inflector.humanize(text)
+        end
+        alias titleize humanize
+      end
+    end
+  end
+end

data/lib/voom/presenters/helpers/rails.rb

@@ -0,0 +1,60 @@
+if defined?(Rails)
+  require_relative 'currency'
+
+  module Voom
+    module Presenters
+      module Helpers
+        module Rails
+          include ActionView::Helpers::AssetUrlHelper
+          include Voom::Presenters::Helpers::Currency
+
+          def default_url_options
+            {}
+          end
+
+          def presenters_path(presenter, **params)
+            path = voom_presenters_web_client_app_path(params)
+            if path.include?('?')
+              path = path.sub('?', "#{presenter}?")
+            else
+              path = "#{path}/" unless path.end_with?('/')
+              # replace last / with the presenter
+              path.reverse.sub('/', "/#{presenter}".reverse).reverse
+            end
+          end
+
+          def table_for(query_,
+                        empty_icon: nil,
+                        except: [:id, :created_at, :updated_at],
+                        selectable: false, &block)
+            row1 = query_.first
+            if row1
+              __columns__ = row1.class.columns
+              table selectable: selectable do
+                header do
+                  __columns__.each do |col|
+                    column col.name.titleize unless except.include?(col.name.to_sym)
+                  end
+                end
+
+                query_.each do |item_|
+                  row do
+                    __columns__.each do |col|
+                      next if except.include?(col.name.to_sym)
+                      column item_.send(col.name.to_sym) do
+                        self.instance_exec(item_, col.name.to_sym, &block) if block
+                      end
+                    end
+                  end
+                end
+              end
+            else
+              body "You have no #{query_.arel_table.name.pluralize}", level: 2
+              icon empty_icon, size: '10rem' if empty_icon
+            end
+          end
+        end
+      end
+    end
+  end
+end