glimmer-dsl-web 0.8.10 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c899b0a787682edbeef45beea8eb4742b296026e9302927c7ee2dbd57486451e
-  data.tar.gz: 4ec88fbe899b1beab079d7fcf7bed0ca0554db5448acc39e4bd42e07f830ab0b
+  metadata.gz: 481114ba7f1ac010cb7c751e3bad3fc70ee0e8353f8702ad8a86fd56a110b64d
+  data.tar.gz: be9b2ba00df78c89061b984f5437f32e5e0b7a87cdbcd34b8245837f722e01a5
 SHA512:
-  metadata.gz: ea45917a51ea567c9a6acf3c77a0642dbe2edac020826923a3fd4433724384384e00ed87758dff1e9e4bb08b3ba5681f6dfc34ccb1577d06179d1895fedf4ac0
-  data.tar.gz: 8abec79d203b6220589cbe4cbd04104332b1bcb99e6eef81af3c583295fa4ba1ae80aa01b05722e7bf21db183f600294d121f69b2e735cc3a43beb351b8006e1
+  metadata.gz: 8415b5c4fe8801512ee1e5e7d6c8d1a487dabd3420f920992ca547095aa75b59c35e0349a3a229568d91a22bdee0278cf9558de61d242f050e3e11492190d920
+  data.tar.gz: 3c14a0224d41730249213c2140c293a3fbb7f4f71f76d0573c84deb5218226cac2f073ba65e8bc19e0f970a38decc4e8166f46733e13d16d82c2fa2059864478

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Change Log
 
+## 0.9.0
+
+- page_component_link(text:, component_class:, component_attributes:, page_url:, css_id:, css_class:, css_style:) Glimmer Web Component to instantly render a new page component in the Frontend while changing the browser URL to a shareable bookmarkable URL
+- page_component_button(text:, component_class:, component_attributes:, page_url:, css_id:, css_class:, css_style:) Glimmer Web Component to instantly render a new page component in the Frontend while changing the browser URL to a shareable bookmarkable URL
+- back_link Glimmer Web Component that renders an anchor tag that can trigger the browser history back button
+- `Glimmer::Util::Debounce.new(&work).call(delay: 300, debounce: true)` to support debouncing repetitive requests, such as those made by a text input filter.
+- Normalize glimmer_component ActiveRecord::Base option values by calling as_json on them automatically
+- Normalize glimmer_component ActiveRecord::Relation option values by calling to_a on them automatically
+- Support `structure {}` as an alias for `markup {}` inside `Glimmer::Web::Component` implementors
+- Hello, Page Component Link! sample
+
 ## 0.8.10
 
 - Remove unnecessary `puts` statements from `Rails::ResourceService`

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.8.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.9.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!!!
@@ -1411,7 +1411,7 @@ Please follow these steps to setup.
 Install a Rails 7 gem:
 
 ```
-gem install rails -v7.0.8.10
+gem install rails -v7.0.9.0
 ```
 
 Start a new Rails 7 app:
@@ -1423,7 +1423,8 @@ rails new glimmer_app_server
 Add the following to `Gemfile`:
 
 ```
-gem 'glimmer-dsl-web', '~> 0.8.10'
+gem 'glimmer-dsl-web', '~> 0.9.0'
+gem 'opal-rails', '2.0.4' # for Rails 7 use of Sprockets
 ```
 
 Run:

data/VERSION

@@ -1 +1 @@
-0.8.10
+0.9.0

data/glimmer-dsl-web.gemspec

@@ -2,11 +2,11 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: glimmer-dsl-web 0.8.10 ruby lib
+# stub: glimmer-dsl-web 0.9.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "glimmer-dsl-web".freeze
-  s.version = "0.8.10".freeze
+  s.version = "0.9.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -50,6 +50,9 @@ Gem::Specification.new do |s|
     "lib/glimmer-dsl-web/samples/hello/hello_input_date_time.rb",
     "lib/glimmer-dsl-web/samples/hello/hello_observer.rb",
     "lib/glimmer-dsl-web/samples/hello/hello_observer_data_binding.rb",
+    "lib/glimmer-dsl-web/samples/hello/hello_page_component_link/conference_talk_page.rb",
+    "lib/glimmer-dsl-web/samples/hello/hello_page_component_link/conference_talks_page.rb",
+    "lib/glimmer-dsl-web/samples/hello/hello_page_component_link/models/conference_talk.rb",
     "lib/glimmer-dsl-web/samples/hello/hello_paragraph.rb",
     "lib/glimmer-dsl-web/samples/hello/hello_style.rb",
     "lib/glimmer-dsl-web/samples/hello/hello_svg.rb",
@@ -88,12 +91,17 @@ Gem::Specification.new do |s|
     "lib/glimmer/dsl/web/span_expression.rb",
     "lib/glimmer/dsl/web/style_element_expression.rb",
     "lib/glimmer/helpers/glimmer_helper.rb",
+    "lib/glimmer/util/debounce.rb",
     "lib/glimmer/util/proc_tracker.rb",
     "lib/glimmer/util/url_builder.rb",
     "lib/glimmer/util/url_query_string_builder.rb",
     "lib/glimmer/web.rb",
     "lib/glimmer/web/component.rb",
+    "lib/glimmer/web/component/back_link.rb",
     "lib/glimmer/web/component/component_style_container.rb",
+    "lib/glimmer/web/component/page_component.rb",
+    "lib/glimmer/web/component/page_component_button.rb",
+    "lib/glimmer/web/component/page_component_link.rb",
     "lib/glimmer/web/element_proxy.rb",
     "lib/glimmer/web/event_proxy.rb",
     "lib/glimmer/web/formatting_element_proxy.rb",

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

@@ -1,24 +1,3 @@
-# Copyright (c) 2023-2024 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 'glimmer/dsl/static_expression'
 require 'glimmer/dsl/bind_expression'
 require 'glimmer/data_binding/model_binding'

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

@@ -1,24 +1,3 @@
-# Copyright (c) 2023-2024 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 'glimmer'
 require 'glimmer/dsl/expression'
 require 'glimmer/web/component'

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

@@ -1,24 +1,3 @@
-# Copyright (c) 2023-2024 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 'glimmer/dsl/expression'
 
 module Glimmer

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

@@ -1,24 +1,3 @@
-# Copyright (c) 2023-2024 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 'glimmer/dsl/engine'
 require 'glimmer/dsl/web/element_expression'
 require 'glimmer/dsl/web/formatting_element_expression'

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

@@ -1,24 +1,3 @@
-# Copyright (c) 2023-2024 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 'glimmer/dsl/static_expression'
 require 'glimmer/dsl/top_level_expression'
 require 'glimmer/dsl/observe_expression'

data/lib/glimmer/helpers/glimmer_helper.rb

@@ -7,6 +7,7 @@ module GlimmerHelper
   end
   
   def glimmer_component(component_asset_path, *component_args)
+    normalize_active_record_relation_option_values!(component_args.last)
     component_file = component_asset_path.split('/').last # TODO support namespaced components
     component_class_name = component_file.classify # TODO support namespaced components
     next_id_number = GlimmerHelper.next_id_number
@@ -31,4 +32,24 @@ module GlimmerHelper
       content_tag(:script, raw(js_script), id: component_script_tag_id, type: 'application/javascript', "data-turbo-eval": "false", "data-component-args": component_args_json)
     end
   end
+    
+  private
+  
+  def normalize_active_record_relation_option_values!(option_values)
+    option_values&.each do |key, value|
+      if value.is_a?(ActiveRecord::Relation)
+        models = value.to_a
+        models = models.map do |model|
+          if model.is_a?(ActiveRecord::Base)
+            model.as_json
+          else
+            model
+          end
+        end
+        option_values[key] = models
+      elsif value.is_a?(ActiveRecord::Base)
+        option_values[key] = value.as_json
+      end
+    end
+  end
 end

data/lib/glimmer/util/debounce.rb

@@ -0,0 +1,34 @@
+module Glimmer
+  module Util
+    class Debounce
+      INTERVAL_CHECK_IN_MILLISECONDS = 50
+    
+      attr_reader :work
+    
+      def initialize(&work)
+        @work = work
+      end
+    
+      def call(delay: 300, debounce: true)
+        if delay.nil? || delay == 0 || !debounce
+          @call_in_progress = @call_request_time = nil
+          work.call
+          return
+        end
+        @call_request_time = Time.now
+        return if @call_in_progress
+    
+        @call_in_progress  = true
+        debouncer          = lambda do
+          if (Time.now - @call_request_time) < (delay / 1000.0)
+            Async::Timeout.new(INTERVAL_CHECK_IN_MILLISECONDS, &debouncer)
+          else
+            @call_in_progress = @call_request_time = nil
+            work.call
+          end
+        end
+        Async::Timeout.new(delay, &debouncer)
+      end
+    end
+  end
+end

data/lib/glimmer/util/proc_tracker.rb

@@ -1,24 +1,3 @@
-# Copyright (c) 2023-2024 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

data/lib/glimmer/util/url_builder.rb

@@ -1,24 +1,3 @@
-# Copyright (c) 2023-2026 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.
-
 # TODO consider extracting this class into its own Ruby gem
 require 'delegate'
 

data/lib/glimmer/util/url_query_string_builder.rb

@@ -1,24 +1,3 @@
-# Copyright (c) 2023-2026 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.
-
 # TODO consider extracting this class into its own Ruby gem
 require 'delegate'
 

data/lib/glimmer/web/component/back_link.rb

@@ -0,0 +1,16 @@
+require 'glimmer-dsl-web'
+
+class BackLink
+  include Glimmer::Web::Component
+  
+  attribute :text, default: 'Back'
+  
+  markup {
+    a(text, href: '') {
+      onclick do |event|
+        event.prevent_default
+        $$.history.back
+      end
+    }
+  }
+end

data/lib/glimmer/web/component/page_component.rb

@@ -0,0 +1,32 @@
+module PageComponent
+  class << self
+    def page_url_to_component_mapping
+      unless defined?(@@page_url_to_component_mapping)
+        @@page_url_to_component_mapping = {}
+      end
+      @@page_url_to_component_mapping
+    end
+    
+    def last_visible_page_components
+      unless defined?(@@last_visible_page_components)
+        @@last_visible_page_components = []
+      end
+      @@last_visible_page_components
+    end
+    
+    def register_page_component_history_listener
+      unless defined?(@@registered_page_component_history_listener)
+        @@registered_page_component_history_listener = true
+        $$.addEventListener('popstate') do |event|
+          page_component = PageComponent.page_url_to_component_mapping[$$.document.location.href]
+          if page_component
+            visible_page_component = PageComponent.last_visible_page_components.pop
+            visible_page_component.markup_root.hide
+            page_component.markup_root.show
+            PageComponent.last_visible_page_components.push(page_component)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/glimmer/web/component/page_component_button.rb

@@ -0,0 +1,49 @@
+require 'glimmer/web/component/page_component'
+
+class PageComponentButton
+  include Glimmer::Web::Component
+  
+  attributes :text, :component_class, :component_attributes, :page_url, :css_id, :css_class, :css_style
+  attr_reader :original_page_component
+  
+  before_render do
+    if self.page_url.start_with?('/')
+      self.page_url = "#{$$.document.location.origin}#{self.page_url}"
+    end
+    @button_tag_attributes = {href: page_url}
+    @button_tag_attributes[:id] = css_id if css_id
+    @button_tag_attributes[:class] = css_class if css_class
+    @button_tag_attributes[:style] = css_style if css_style
+  end
+  
+  after_render do
+    @original_page_component = root_component
+  end
+  
+  markup {
+    button(text, **@button_tag_attributes) {
+      onclick do |event|
+        event.prevent_default
+        page_component = nil
+        if component_attributes.nil?
+          page_component = PageComponent.page_url_to_component_mapping[page_url]
+          if page_component
+            page_component.markup_root.show
+          else
+            $$.document.location = page_url
+          end
+        else
+          page_component = component_class.render(component_attributes)
+        end
+        if page_component
+          PageComponent.last_visible_page_components.push(page_component)
+          PageComponent.page_url_to_component_mapping[$$.document.location.href] = original_page_component
+          PageComponent.page_url_to_component_mapping[page_url] = page_component
+          $$.history.pushState({page_component_selector: page_component.markup_root.selector, original_page_component_selector: original_page_component.markup_root.selector}, "title 1", page_url)
+          original_page_component.markup_root.hide
+          PageComponent.register_page_component_history_listener
+        end
+      end
+    }
+  }
+end

data/lib/glimmer/web/component/page_component_link.rb

@@ -0,0 +1,49 @@
+require 'glimmer/web/component/page_component'
+
+class PageComponentLink
+  include Glimmer::Web::Component
+  
+  attributes :text, :component_class, :component_attributes, :page_url, :css_id, :css_class, :css_style
+  attr_reader :original_page_component
+  
+  before_render do
+    if self.page_url.start_with?('/')
+      self.page_url = "#{$$.document.location.origin}#{self.page_url}"
+    end
+    @anchor_tag_attributes = {href: page_url}
+    @anchor_tag_attributes[:id] = css_id if css_id
+    @anchor_tag_attributes[:class] = css_class if css_class
+    @anchor_tag_attributes[:style] = css_style if css_style
+  end
+  
+  after_render do
+    @original_page_component = root_component
+  end
+  
+  markup {
+    a(text, **@anchor_tag_attributes) {
+      onclick do |event|
+        event.prevent_default
+        page_component = nil
+        if component_attributes.nil?
+          page_component = PageComponent.page_url_to_component_mapping[page_url]
+          if page_component
+            page_component.markup_root.show
+          else
+            $$.document.location = page_url
+          end
+        else
+          page_component = component_class.render(component_attributes)
+        end
+        if page_component
+          PageComponent.last_visible_page_components.push(page_component)
+          PageComponent.page_url_to_component_mapping[$$.document.location.href] = original_page_component
+          PageComponent.page_url_to_component_mapping[page_url] = page_component
+          $$.history.pushState({page_component_selector: page_component.markup_root.selector, original_page_component_selector: original_page_component.markup_root.selector}, "title 1", page_url)
+          original_page_component.markup_root.hide
+          PageComponent.register_page_component_history_listener
+        end
+      end
+    }
+  }
+end

data/lib/glimmer/web/component.rb

@@ -1,24 +1,3 @@
-# Copyright (c) 2023-2024 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 'glimmer'
 require 'glimmer/error'
 require 'glimmer/util/proc_tracker'
@@ -79,6 +58,7 @@ module Glimmer
         def markup(&block)
           @markup_block = block
         end
+        alias structure markup
 
         # TODO in the future support a string value too
         def style(&block)
@@ -129,6 +109,7 @@ module Glimmer
           ".#{component_element_class}"
         end
         alias component_markup_root_selector component_element_selector
+        alias component_structure_root_selector component_element_selector
         
         def component_shortcut_element_class
           self.shortcut_keyword.gsub('_', '-')
@@ -153,6 +134,7 @@ module Glimmer
       # This module was only created to prevent Glimmer from checking method_missing first
       module GlimmerSupersedable
         def method_missing(method_name, *args, &block)
+          # TODO think of a way to hide the unnecessary exception noise that is printed to the user in the browser console whenever this is triggered
           Glimmer::DSL::Engine.interpret(method_name, *args, &block)
         rescue
           super(method_name, *args, &block)
@@ -287,6 +269,7 @@ module Glimmer
       
       attr_reader :markup_root, :parent, :args, :options, :style_block, :component_style, :slot_elements, :events, :default_slot
       alias parent_proxy parent
+      alias structure_root markup_root
 
       def initialize(parent, args, options, &content)
         Glimmer::Web::Component.add_component(self)
@@ -561,6 +544,10 @@ module Glimmer
         end
         "#<#{self.class}:0x#{object_id.to_s(16)} #{markup_root&.keyword}##{markup_root&.element_id} #{attributes}>"
       end
+      
+      def root_component
+        (markup_root&.root_parent || markup_root)&.component
+      end
 
       private
 

data/lib/glimmer/web/element_proxy.rb

@@ -1,26 +1,5 @@
 # backtick_javascript: true
 
-# Copyright (c) 2023-2024 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 'glimmer/web/listener_proxy'
 
 module Glimmer
@@ -337,6 +316,11 @@ module Glimmer
         parents_array
       end
       alias ancestors parents
+      
+      def root_parent
+        parents.last
+      end
+      alias root_ancesor root_parent
 
       def find_ancestor(include_self: false, &condition)
         current_element_proxy = self

data/lib/glimmer/web/event_proxy.rb

@@ -1,26 +1,5 @@
 # backtick_javascript: true
 
-# Copyright (c) 2023-2024 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.
-
 module Glimmer
   module Web
     class EventProxy