live 0.14.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63034baadcba271590245009b106e82bc142734cbc4978d7a47c264a8368d92c
-  data.tar.gz: ddb382c9499a3560ece8341a61e6d78076b2b2544fbb7ff3de1371e315e321bd
+  metadata.gz: 960ab85523261e6aed7869a0bdaf9d0287b78a1582f7a45ed5d7de9d664fb1bb
+  data.tar.gz: '0848d0c2cc6c14702eb886a7eb719bf81e15e51f52b8500e736602743860213c'
 SHA512:
-  metadata.gz: c8c7edabe0b494d83b0260e803cf39899eb4a2bd91a8eba9e714ccf255f23cd7bb76ee19df9811bc255f316cc113c67fa9814b0152fcd0d05382e3c5e8f93877
-  data.tar.gz: d4e8a3bfebf1bd77374cba4bac80d428b218834c2f0acb773268093aeb14ea14f3131194533c7a8aa0094431d20ee224f584d4babe6c27d9e7852119223cb578
+  metadata.gz: aa1822962cb839eac75ae7cef53abd80d3ede0bfb12d0844520aa1862328c0be64ea77df95388f12acb4d29b19005a872df7d008d50582ea28c6e22ba291063e
+  data.tar.gz: d4450a385662da48c87b2ed7f586ade4b44f2019889bf62a883edfedcf61a6397b44e7430e3a1a089e689558950d27027b4244932f4d252d99d793987f2ed54a

data/lib/live/element.rb

@@ -16,18 +16,30 @@ module Live
 			SecureRandom.uuid
 		end
 		
+		# Mount an element within a parent element.
 		def self.mount(parent, id, data = {})
 			full_id = parent.id + ":" + id
 			
 			self.new(full_id, data)
 		end
 		
+		# Create a new element with a convenient syntax for specifying the id and data.
+		#
 		# @parameter id [String] The unique identifier within the page.
 		# @parameter data [Hash] The data associated with the element, typically stored as `data-` attributes.
-		def initialize(id = Element.unique_id, data = {})
+		def self.[](id = self.unique_id, **data)
+			self.new(id, data)
+		end
+		
+		# Initialize the element with the specified id and data.
+		#
+		# @parameter id [String] The unique identifier within the page.
+		# @parameter data [Hash] The data associated with the element, typically stored as `data-` attributes.
+		def initialize(id = self.class.unique_id, data = {})
+			data[:class] ||= self.class.name
+			
 			@id = id
 			@data = data
-			@data[:class] ||= self.class.name
 			@page = nil
 		end
 		
@@ -138,11 +150,17 @@ module Live
 			builder.text(self.class.name)
 		end
 		
+		def append_markup(output)
+			build_markup(::XRB::Builder.new(output))
+		end
+		
+		def build_markup(builder)
+			render(builder)
+		end
+		
 		# @returns [Object] The generated HTML.
 		def to_html
-			XRB::Builder.fragment do |builder|
-				render(builder)
-			end
+			XRB::Builder.fragment(&self.method(:build_markup))
 		end
 		
 		# Convenience method for rendering the view as a string.

data/lib/live/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2021-2024, by Samuel Williams.
 
 module Live
-	VERSION = "0.14.0"
+	VERSION = "0.16.0"
 end

data/lib/live/view.rb

@@ -10,11 +10,9 @@ module Live
 	# Represents a single division of content on the page an provides helpers for rendering the content.
 	class View < Element
 		# @returns [Object] The generated HTML.
-		def to_html
-			XRB::Builder.fragment do |builder|
-				builder.inline_tag :div, id: @id, class: "live", data: @data do
-					render(builder)
-				end
+		def build_markup(builder)
+			builder.inline_tag :div, id: @id, class: "live", data: @data do
+				render(builder)
 			end
 		end
 	end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: live
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -39,7 +39,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-09-25 00:00:00.000000000 Z
+date: 2024-11-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async-websocket
@@ -73,16 +73,16 @@ dependencies:
   name: xrb
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.10'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.10'
 description:
 email:
 executables: []
@@ -118,7 +118,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Live HTML tags updated via a WebSocket.