glimmer-dsl-web 0.6.10 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19e269462e5ace48d73d5c76624b4d79f2a37f7679a410526f64aaceef4a0552
-  data.tar.gz: 24ccdc20a32122070edd290fc8b41375aac19d730bc974dcf96f89a8104aef63
+  metadata.gz: 1ff3ef1efa40dc4dcc6e202544e7d0fa7be60c80d1f3dc9c465ed27cf62610df
+  data.tar.gz: da8851cd3e896f236c5cf45b23ff234ceb5854a6814a213e7311bc5f553910f8
 SHA512:
-  metadata.gz: fb309b58ee1543098c7be8fd45dd66c067a21da9898f63dafbb4383ddc4827d42e9301b46cbe7c3e1deaf0fb10cc464538e71ee7b800c4eac78bffaf363b6448
-  data.tar.gz: ea766a952146e62707ebf3cba8d8da6e646489b277c0ee5d58790c5e284099e71cbb4a8fc39d334c96a096a5c25c760c12e17e92a411910876260c8a82ac2f6f
+  metadata.gz: 145f156c520f3e25b0f4251fba654fcac9668edf5e03473aa4891fcf970ea92189d8a64be0f93f7fcbd81a9fc28ae541ccf6c99088ce64bbeb9eb9bb97c65450
+  data.tar.gz: 53ab737627d2cc6fac28e94f6e372a46f9a21af784afb5c4618509a874a684ff574eb85aa6a5a6c469b264c36257c5f66e8469f9d9825442e119341d9e1210ce

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Change Log
 
+## 0.7.0
+
+- Rename `element-ID` element CSS classes to `glimmer-element-ID` for a more unique class name that nobody else would be using
+- Rename `element` element CSS class to `glimmer-root` while only setting on the root element in a Glimmer element hierarchy.
+
+## 0.6.12
+
+- Fix issue with Glimmer Web Component Attribute Data-Binding crashing the Contact Manager sample
+
+## 0.6.11
+
+- Set component attribute as a property in the Glimmer DSL by nesting 'propname value' inside component in consuming code
+- Glimmer Web Component Attribute Data-Binding (by nesting data-binding declarations within consumed components)
+
 ## 0.6.10
 
 - Support Component Attribute Listeners including non-option attributes (like method-based attributes not generated by `option :someoption` like `attr_accessor :someattr`)

data/README.md

@@ -1,4 +1,4 @@
-# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for Web 0.6.10 (Beta)
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for Web 0.7.0 (Beta)
 ## Ruby-in-the-Browser Web Frontend Framework
 ### The "Rails" of Frontend Frameworks!!! ([Fukuoka Award Winning](https://andymaleh.blogspot.com/2025/01/glimmer-dsl-for-web-wins-in-fukuoka.html))
 #### Finally, Ruby Developer Productivity, Happiness, and Fun in the Frontend!!!
@@ -1408,7 +1408,7 @@ rails new glimmer_app_server
 Add the following to `Gemfile`:
 
 ```
-gem 'glimmer-dsl-web', '~> 0.6.10'
+gem 'glimmer-dsl-web', '~> 0.7.0'
 ```
 
 Run:
@@ -2977,6 +2977,8 @@ Component listeners enable consumers of components to listen to any custom event
 
 For example, an `AccordionSection` component might generate events `:expanded` and `:collapsed` when a user clicks on the section title to expand it or collapse it. Consumers can then use `on_expanded` and `on_collapsed` to listen to those events.
 
+Also, it is possible to listen to any component attribute by nesting `on_some_attribute_update`. And, it is possible to set component attributes by nesting `some_attribute value` or data-binding to them by nesting `some_attribute <=> [model, :attribute]`.
+
 [lib/glimmer-dsl-web/samples/hello/hello_component_listeners.rb](/lib/glimmer-dsl-web/samples/hello/hello_component_listeners.rb)
 
 Glimmer HTML DSL Ruby code in the frontend:

data/VERSION

@@ -1 +1 @@
-0.6.10
+0.7.0

data/glimmer-dsl-web.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: glimmer-dsl-web 0.6.10 ruby lib
+# stub: glimmer-dsl-web 0.7.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "glimmer-dsl-web".freeze
-  s.version = "0.6.10"
+  s.version = "0.7.0"
 
   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 = "2025-02-23"
+  s.date = "2025-03-01"
   s.description = "Glimmer DSL for Web (Ruby in the Browser Web Frontend Framework) enables building Web Frontends using Ruby in the Browser, as per Matz's recommendation in his RubyConf 2022 keynote speech to replace JavaScript with Ruby. It aims at providing the simplest, most intuitive, most straight-forward, and most productive frontend framework in existence. The framework follows the Ruby way (with DSLs and TIMTOWTDI) and the Rails way (Convention over Configuration) in building Isomorphic Ruby on Rails Applications. It provides a Ruby HTML DSL, which uniquely enables writing both structure code and logic code in one language. It supports both Unidirectional (One-Way) Data-Binding (using <=) and Bidirectional (Two-Way) Data-Binding (using <=>). Dynamic rendering (and re-rendering) of HTML content is also supported via Content Data-Binding. Modular design is supported with Glimmer Web Components, Component Slots, and Component Custom Event Listeners. And, a Ruby CSS DSL is supported with the included Glimmer DSL for CSS. Many samples are demonstrated in the Rails sample app (there is a very minimal Standalone [No Rails] sample app too). You can finally live in pure Rubyland on the Web in both the frontend and backend with Glimmer DSL for Web! This gem relies on Opal Ruby.".freeze
   s.email = "andy.am@gmail.com".freeze
   s.extra_rdoc_files = [

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

@@ -7,7 +7,14 @@ module Glimmer
     module Web
       class PropertyExpression < Expression
         def can_interpret?(parent, keyword, *args, &block)
-          parent.is_a?(Glimmer::Web::ElementProxy) and
+          # TODO add this condition once formatting elements become normal elements
+          # or delete this line if no longer needed:
+          # parent.is_a?(Glimmer::Web::FormattingElementProxy) ||
+          # Also, consider removing type check altogether (to generalize if good idea)
+          (
+            parent.is_a?(Glimmer::Web::ElementProxy) ||
+            parent.is_a?(Glimmer::Web::Component)
+          ) and
             (!args.empty?) and
             parent.respond_to?("#{keyword}=") and
             block.nil?

data/lib/glimmer/web/component.rb

@@ -406,6 +406,7 @@ module Glimmer
       end
       
       def remove_observer(observer, attribute_or_event, options = {})
+        # TODO should we removing attribute observers? when removing component?
         if can_add_attribute_observer?(attribute_or_event)
           super(observer, attribute_or_event)
         elsif can_add_custom_event_listener?(attribute_or_event)
@@ -476,11 +477,24 @@ module Glimmer
       end
       
       def remove
+        remove_all_listeners
         @markup_root&.remove
       end
 
       def data_bind(property, model_binding)
-        @markup_root&.data_bind(property, model_binding)
+        if has_option?(property) || (has_read_write_attribute?(property) && !@markup_root.respond_to?(property) && !@markup_root.respond_to?("#{property}="))
+          option_binding = Glimmer::DataBinding::ModelBinding.new(self, property)
+          #TODO make this options observer dependent and all similar observers in element specific data binding handlers
+          option_binding.observe(model_binding)
+          option_binding.call(model_binding.evaluate_property)
+          data_bindings[option_binding] = model_binding
+          if !model_binding.binding_options[:read_only]
+            model_binding.observe(option_binding)
+            model_binding.call(option_binding.evaluate_property)
+          end
+        else
+          @markup_root&.data_bind(property, model_binding)
+        end
       end
       
       def bind_content(*binding_args, &content_block)
@@ -508,6 +522,12 @@ module Glimmer
           end
         end
       end
+      
+      def remove_all_listeners
+        data_bindings.each do |option_binding, model_binding|
+          option_binding.unregister_all_observables
+        end
+      end
 
       def method_missing(method_name, *args, &block)
         if can_handle_observation_request?(method_name)
@@ -556,6 +576,10 @@ module Glimmer
       def remove_style_block
         Glimmer::Web::Component.remove_component_style(self)
       end
+      
+      def data_bindings
+        @data_bindings ||= {}
+      end
     end
   end
 end

data/lib/glimmer/web/element_proxy.rb

@@ -140,6 +140,7 @@ module Glimmer
         'inner_html' => 'innerHTML',
         'outer_html' => 'outerHTML',
       }
+      CSS_CLASS_GLIMMER = 'glimmer'
       FORMAT_DATETIME = '%Y-%m-%dT%H:%M' # TODO ensure using when setting value on date/time fields without data-binding
       FORMAT_DATE = '%Y-%m-%d' # TODO ensure using when setting value on date/time fields without data-binding
       FORMAT_TIME = '%H:%M' # TODO ensure using when setting value on date/time fields without data-binding
@@ -515,7 +516,7 @@ module Glimmer
       # It is intentionally not set as the actual HTML element ID to let software engineers
       # specify their own IDs if they wanted
       def element_id
-        @element_id ||= "element-#{ElementProxy.next_id_number_for(name)}"
+        @element_id ||= "#{CSS_CLASS_GLIMMER}-#{name}-#{ElementProxy.next_id_number_for(self.class.to_s)}"
       end
       
       def class_name=(*values)
@@ -1002,7 +1003,8 @@ module Glimmer
       private
       
       def base_css_classes
-        framework_css_classes = [name, element_id]
+        framework_css_classes = @parent.nil? ? ["#{CSS_CLASS_GLIMMER}-root"] : []
+        framework_css_classes += [element_id]
         if component
           framework_css_classes.prepend(component.class.component_element_class)
           framework_css_classes.prepend(component.class.component_shortcut_element_class) if component.class.component_shortcut_element_class != component.class.component_element_class

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-web
 version: !ruby/object:Gem::Version
-  version: 0.6.10
+  version: 0.7.0
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-23 00:00:00.000000000 Z
+date: 2025-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: glimmer