live 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7df6409f470eb90e1f1f68cd70dabcf23cf56c2cbcbcc5707222bcac7d721338
-  data.tar.gz: faac890736a9dc375e683405d29c534a55b7628e37abbcd64cfae0922ebdeda8
+  metadata.gz: eb8e5793466102d92b796d1e86a24c1ff6406eb888b772c65a22c1857c49ad5e
+  data.tar.gz: b19804c4d65fa9798615bb681c5062602e2a0406b8a663ac1e8c4ef8a7f2b3c4
 SHA512:
-  metadata.gz: d1f0603af15f67f6db3677126f45f1c766bccecf99d93aaae0fc9018c0da5deaaa5f0156fe187ea9d90cac5bf813540de62e084c840bbe28eedfdc18a69fe4af
-  data.tar.gz: 5db6880399468684e09034225faa3a63929563177d28b32ae67bbe9022158d15b98fc2ba0a967c6bd88177cb1b9518b85a45caeb3ef07309f446fe2b2b639862
+  metadata.gz: 5a9c0e7beec4ba0f3102067b1df4da1329fcd35a90e2eb0de38db4ffa565dea7e56d52c6f4c922efd31aac0ee18d8427c40491f552ff3b5fafdec8d887d38898
+  data.tar.gz: 75f1b08b01c5b1f280ff93290082bc1da873ff1e259e0a76f0b7a996516fcde81cbe1ceb0824e6f817318d100ec86af05714fbcdc5550526e8572ac6eed71e59

data/lib/live/element.rb

@@ -4,13 +4,18 @@
 # Copyright, 2021-2024, by Samuel Williams.
 
 require 'json'
+require 'securerandom'
 
 module Live
 	# Represents a single dynamic content area on the page.
 	class Element
+		def self.unique_id
+			SecureRandom.uuid
+		end
+		
 		# @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, **data)
+		def initialize(id = Element.unique_id, **data)
 			@id = id
 			@data = data
 			@data[:class] ||= self.class.name
@@ -21,13 +26,24 @@ module Live
 		# The unique id within the bound page.
 		attr :id
 		
+		# The data associated with the element.
+		attr :data
+		
 		# Generate a JavaScript string which forwards the specified event to the server.
 		# @parameter details [Hash] The details associated with the forwarded event.
-		def forward(details = nil)
+		def forward_event(details = nil)
+			if details
+				"live.forwardEvent(#{JSON.dump(@id)}, event, #{JSON.dump(details)})"
+			else
+				"live.forwardEvent(#{JSON.dump(@id)}, event)"
+			end
+		end
+		
+		def forward_form_event(details = nil)
 			if details
-				"live.forward(#{JSON.dump(@id)}, event, #{JSON.dump(details)})"
+				"live.forwardFormEvent(#{JSON.dump(@id)}, event, #{JSON.dump(details)})"
 			else
-				"live.forward(#{JSON.dump(@id)}, event)"
+				"live.forwardFormEvent(#{JSON.dump(@id)}, event)"
 			end
 		end
 		
@@ -49,9 +65,9 @@ module Live
 		# Enqueue a remote procedure call to the currently bound page.
 		# @parameter method [Symbol] The name of the remote functio to invoke.
 		# @parameter arguments [Array]
-		def rpc(method, arguments)
+		def rpc(*arguments)
 			# This update might not be sent right away. Therefore, mutable arguments may be serialized to JSON at a later time (or never). This could be a race condition:
-			@page.updates.enqueue([method, arguments])
+			@page.updates.enqueue(arguments)
 		end
 	end
 end

data/lib/live/page.rb

@@ -50,7 +50,7 @@ module Live
 			if element = @elements[id]
 				return element.handle(event)
 			else
-				Console.logger.warn(self, "Could not handle event:", event, details)
+				Console.warn(self, "Could not handle event:", event, details)
 			end
 			
 			return nil
@@ -68,12 +68,12 @@ module Live
 				if element = self.resolve(id, data)
 					self.bind(element)
 				else
-					Console.logger.warn(self, "Could not resolve element:", message)
+					Console.warn(self, "Could not resolve element:", message)
 				end
 			elsif id = message[:id]
 				self.handle(id, message[:event])
 			else
-				Console.logger.warn(self, "Unhandled message:", message)
+				Console.warn(self, "Unhandled message:", message)
 			end
 		end
 		
@@ -82,7 +82,7 @@ module Live
 		def run(connection)
 			queue_task = Async do
 				while update = @updates.dequeue
-					Console.logger.debug(self, "Sending update:", update)
+					Console.debug(self, "Sending update:", update)
 					
 					connection.write(::Protocol::WebSocket::JSONMessage.generate(update))
 					connection.flush if @updates.empty?
@@ -90,12 +90,12 @@ module Live
 			end
 			
 			while message = connection.read
-				Console.logger.debug(self, "Reading message:", message)
+				Console.debug(self, "Reading message:", message)
 				
 				if json_message = ::Protocol::WebSocket::JSONMessage.wrap(message)
 					process_message(json_message.parse)
 				else
-					Console.logger.warn(self, "Unhandled message:", message)
+					Console.warn(self, "Unhandled message:", message)
 				end
 			end
 		ensure

data/lib/live/version.rb

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

data/lib/live/view.rb

@@ -9,21 +9,40 @@ require 'xrb/builder'
 module Live
 	# Represents a single division of content on the page an provides helpers for rendering the content.
 	class View < Element
+		# Update the content of the client-side element by rendering this view.
+		def update!(**options)
+			rpc(:update, @id, self.to_html, options)
+		end
+		
 		# Replace the content of the client-side element by rendering this view.
-		def replace!
-			rpc(:replace, [@id, self.to_html])
+		# @parameter selector [String] The CSS selector to replace.
+		# @parameter node [String] The HTML to replace.
+		def replace(selector, node, **options)
+			rpc(:replace, selector, node.to_s, options)
+		end
+		
+		# Prepend to the content of the client-side element by appending the specified element.
+		# @parameter selector [String] The CSS selector to prepend to.
+		# @parameter node [String] The HTML to prepend.
+		def prepend(selector, node, **options)
+			rpc(:prepend, selector, node.to_s, options)
 		end
 		
 		# Append to the content of the client-side element by appending the specified element.
-		# @parameter node [Live::Element] The element to append.
-		def append!(element)
-			rpc(:append, [@id, element.to_html])
+		# @parameter selector [String] The CSS selector to append to.
+		# @parameter node [String] The HTML to prepend.
+		def append(selector, node, **options)
+			rpc(:append, selector, node.to_s, options)
 		end
 		
-		# Prepend to the content of the client-side element by appending the specified element.
-		# @parameter node [Live::Element] The element to prepend.
-		def prepend!(element)
-			rpc(:prepend, [@id, element.to_html])
+		# Remove the specified element from the client-side element.
+		# @parameter selector [String] The CSS selector to remove.
+		def remove(selector, **options)
+			rpc(:remove, selector, options)
+		end
+		
+		def dispatch_event(selector, type, **options)
+			rpc(:dispatch_event, selector, event, options)
 		end
 		
 		# Render the element.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: live
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -38,7 +38,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-04-28 00:00:00.000000000 Z
+date: 2024-05-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async-websocket

metadata.gz.sig

@@ -1 +1,3 @@
-F6���I��Q�,[z �����&���!zý[q�aI���ُة�Ö�숔�9�h��uXj�)�R�D�
+[O%��쐕^Q����)���'e�������5����hZz,z�����9М�7��ޫ�<u*[�x�G�k��I!u�2��MW��!t�^
+A����z�������5[B�1�k���2�z���|����E�g��K���(�H�0�:N�]$�(�G�i�~A�U�՗��N$6Qšw�S�}�O�J{���n�`D��ƁaB�bTߚ|��+)~�Ｅ�T9��6�5V��Q����S�ԏ��A��Xz��|�\St(��ɛ��G�z�gG�Pٟq4n� ���k�p��도)�����`A���xƬ0�Tb����A桺�K��b�1aƓ+�\!�r����h>V=�
+���a�
Kt؛��.�nf�M�
ڊ��nB3b��