glimmer-dsl-web 0.0.1

data/glimmer-dsl-web.gemspec

@@ -0,0 +1,67 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: glimmer-dsl-web 0.0.1 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "glimmer-dsl-web".freeze
+  s.version = "0.0.1".freeze
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib".freeze]
+  s.authors = ["Andy Maleh".freeze]
+  s.date = "2023-12-27"
+  s.description = "Glimmer DSL for Web (Ruby in the Browser Web GUI Library) - Enables frontend GUI development with Ruby by adopting a DSL that follows web-like HTML syntax, enabling the transfer of HTML/CSS/JS skills to Ruby frontend development. This library relies on Opal Ruby.".freeze
+  s.email = "andy.am@gmail.com".freeze
+  s.extra_rdoc_files = [
+    "CHANGELOG.md",
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    "CHANGELOG.md",
+    "LICENSE.txt",
+    "README.md",
+    "VERSION",
+    "app/assets/stylesheets/glimmer/glimmer.css",
+    "glimmer-dsl-web.gemspec",
+    "lib/glimmer-dsl-web.rb",
+    "lib/glimmer-dsl-web/ext/class.rb",
+    "lib/glimmer-dsl-web/ext/date.rb",
+    "lib/glimmer-dsl-web/ext/exception.rb",
+    "lib/glimmer-dsl-web/samples/hello/hello_world.rb",
+    "lib/glimmer-dsl-web/vendor/jquery.js",
+    "lib/glimmer/config/opal_logger.rb",
+    "lib/glimmer/data_binding/element_binding.rb",
+    "lib/glimmer/data_binding/observable_element.rb",
+    "lib/glimmer/dsl/web/dsl.rb",
+    "lib/glimmer/dsl/web/element_expression.rb",
+    "lib/glimmer/util/proc_tracker.rb",
+    "lib/glimmer/web.rb",
+    "lib/glimmer/web/element_proxy.rb",
+    "lib/glimmer/web/property_owner.rb"
+  ]
+  s.homepage = "http://github.com/AndyObtiva/glimmer-dsl-web".freeze
+  s.licenses = ["MIT".freeze]
+  s.rubygems_version = "3.5.3".freeze
+  s.summary = "Glimmer DSL for Web".freeze
+
+  s.specification_version = 4
+
+  s.add_runtime_dependency(%q<glimmer>.freeze, ["~> 2.4.1".freeze])
+  s.add_runtime_dependency(%q<glimmer-dsl-xml>.freeze, ["~> 1.3.2".freeze])
+  s.add_runtime_dependency(%q<glimmer-dsl-css>.freeze, ["~> 1.2.2".freeze])
+  s.add_runtime_dependency(%q<opal-async>.freeze, ["~> 1.4.0".freeze])
+  s.add_runtime_dependency(%q<to_collection>.freeze, [">= 2.0.1".freeze, "< 3.0.0".freeze])
+  s.add_runtime_dependency(%q<pure-struct>.freeze, [">= 1.0.2".freeze, "< 2.0.0".freeze])
+  s.add_development_dependency(%q<puts_debuggerer>.freeze, [">= 0".freeze])
+  s.add_development_dependency(%q<rake>.freeze, [">= 10.1.0".freeze, "< 14.0.0".freeze])
+  s.add_development_dependency(%q<rake-tui>.freeze, [">= 0".freeze])
+  s.add_development_dependency(%q<jeweler>.freeze, [">= 2.3.9".freeze, "< 3.0.0".freeze])
+  s.add_development_dependency(%q<rdoc>.freeze, [">= 6.2.1".freeze, "< 7.0.0".freeze])
+  s.add_development_dependency(%q<opal-rspec>.freeze, ["~> 0.8.0.alpha2".freeze])
+  s.add_development_dependency(%q<opal-rails>.freeze, ["~> 1.1.2".freeze])
+  s.add_development_dependency(%q<opal-jquery>.freeze, ["~> 0.4.4".freeze])
+end
+

data/lib/glimmer/config/opal_logger.rb

@@ -0,0 +1,16 @@
+module Glimmer
+  module Config
+    class OpalLogger < Logger
+      alias add_without_opal_logger add
+      def add(severity, message = nil, progname = nil, &block)
+        original_logdev = @pipe
+        if severity == ERROR
+          @pipe = $stderr
+        else
+          @pipe = original_logdev
+        end
+        add_without_opal_logger(severity, message, progname, &block)
+      end
+    end
+  end
+end

data/lib/glimmer/data_binding/element_binding.rb

@@ -0,0 +1,36 @@
+require 'glimmer/data_binding/observable'
+require 'glimmer/data_binding/observer'
+
+module Glimmer
+  module DataBinding
+    class ElementBinding
+      # TODO consider renaming to WidgetBinding since it's no longer dealing with elements directly yet widgets instead
+      include Glimmer
+      include Observable
+      include Observer
+
+      attr_reader :element, :property
+      def initialize(element, property, translator = nil)
+        @element = element
+        @property = property
+        @translator = translator || proc {|value| value}
+
+        # TODO see if this is needed in Opal
+#         if @element.respond_to?(:dispose)
+#           @element.on_widget_disposed do |dispose_event|
+#             unregister_all_observables
+#           end
+#         end
+      end
+      
+      def call(value)
+        converted_value = translated_value = @translator.call(value)
+        @element.set_attribute(@property, converted_value) unless evaluate_property == converted_value
+      end
+      
+      def evaluate_property
+        @element.send(@property)
+      end
+    end
+  end
+end

data/lib/glimmer/data_binding/observable_element.rb

@@ -0,0 +1,14 @@
+module Glimmer
+  module DataBinding
+    module ObservableElement
+      def method_missing(method, *args, &block)
+        method_name = method.to_s
+        if method_name.start_with?('on_')
+          handle_observation_request(method_name, block)
+        else
+          super
+        end
+      end
+    end
+  end
+end

data/lib/glimmer/dsl/web/dsl.rb

@@ -0,0 +1,24 @@
+require 'glimmer/dsl/engine'
+# Dir[File.expand_path('../*_expression.rb', __FILE__)].each {|f| require f}
+require 'glimmer/dsl/web/element_expression'
+
+module Glimmer
+  module DSL
+    module Web
+      # TODO implement all those expressions
+#        %w[
+#          event_listener
+#          data_binding
+#          attribute
+#          shine_data_binding
+#          element
+#        ]
+      Engine.add_dynamic_expressions(
+       Web,
+       %w[
+         element
+       ]
+      )
+    end
+  end
+end

data/lib/glimmer/dsl/web/element_expression.rb

@@ -0,0 +1,37 @@
+require 'glimmer/dsl/expression'
+require 'glimmer/dsl/parent_expression'
+require 'glimmer/web/element_proxy'
+
+module Glimmer
+  module DSL
+    module Web
+      class ElementExpression < Expression
+        include ParentExpression
+        
+        def can_interpret?(parent, keyword, *args, &block)
+          # TODO automatically pass root as element if not passed instead of rejecting elements without a paraent nor root
+          # TODO raise a proper error if root is an element that is not found (maybe do this in model)
+          options = args.last.is_a?(Hash) ? args.last : {}
+          (parent or options[:root])
+        end
+
+        def interpret(parent, keyword, *args, &block)
+          Glimmer::Web::ElementProxy.for(keyword, parent, args, block)
+        end
+        
+        def add_content(parent, keyword, *args, &block)
+          if parent.rendered? || parent.skip_content_on_render_blocks?
+            return_value = super(parent, keyword, *args, &block)
+            if return_value.is_a?(String)
+              parent.add_text_content(return_value)
+            end
+            parent.post_add_content
+            return_value
+          else
+            parent.add_content_on_render(&block)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/glimmer/util/proc_tracker.rb

@@ -0,0 +1,50 @@
+# Copyright (c) 2020-2022 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'delegate'
+
+module Glimmer
+  module Util
+    # Decorator that provides tracking facilities for Ruby procs, tracking owner (string), invoked_form method name (symbol/string), and called? (boolean)
+    class ProcTracker < DelegateClass(Proc)
+      attr_reader :owner, :invoked_from
+      
+      def initialize(proc = nil, owner: nil, invoked_from: nil, &block)
+        super(proc || block)
+        @owner = owner
+        @invoked_from = invoked_from
+      end
+      
+      def call(*args)
+        __getobj__.call(*args)
+        @called = true
+      end
+      
+      def called?
+        !!@called
+      end
+      
+      def respond_to?(method_name, include_private = false)
+        %w[owner invoked_from called?].include?(method_name.to_s) || super(method_name, include_private)
+      end
+    end
+  end
+end