live 0.18.2 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6fd073e4bcfdb47b09acbfa2fb6cb1f53b4bc06ecae09ba4854104aa36e9d5f2
-  data.tar.gz: 68fb08690390f594445794913adbc33e90b5c014f8c4b4efe1fb9614e0461dc9
+  metadata.gz: 826ca30c017f31b254c40ed89d01bf3989aef0ed660935beef1e3e4cb90c53c1
+  data.tar.gz: 0eccc9cbf069665e895323d50e78321106a065d7d62a3e15c0a67c17a34385c7
 SHA512:
-  metadata.gz: e8290817ecf9c469d2611a866775dd99386aa79bf00ca8610aae00c754376d2ef950e433dca17c7b5a0aab35530493ed6a18183c402d08901c386a6f098063c2
-  data.tar.gz: 9699bfdd912686e4d91f189ef0fd103c455dca91e570028d7652614112c6bf4207cbf01c5dd8c8fb0aff4ea2e718f7216a3f7e8702d75a511524c5db86c461ed
+  metadata.gz: 61317101fe18021fea96f836ef083ee437fcf718fc78055609fad3bf369421da3821ac8fcfde1fd80eb5fabcc05d844d64bd5de967372a7a5898bfb6e0017404
+  data.tar.gz: e35a93dbb23f40ba34a5adbbfb6c1c61de1e199fbdc028fd9013fab288ed9099afc06e2594e3167242f678a80f7f9a4f1b9f0db4762ea5ffe8587369a8455a4a

data/lib/live/element.rb

@@ -20,26 +20,36 @@ module Live
 		#
 		# @parameter id [String] The unique identifier within the page.
 		# @parameter data [Hash] The data associated with the element, typically stored as `data-` attributes.
-		def self.root(id = self.unique_id, **data)
-			self.new(id, data)
+		# @parameter options [Hash] Additional options passed to the element constructor.
+		def self.root(id = self.unique_id, data: {}, **options)
+			self.new(id, data, **options)
 		end
 		
 		# Mount an element within a parent element.
-		def self.child(parent, id = self.unique_id, **data)
+		# @parameter parent [Element] The parent element.
+		# @parameter id [String] The unique identifier within the parent element.
+		# @parameter data [Hash] The data associated with the element, typically stored as `data-` attributes.
+		# @parameter options [Hash] Additional options passed to the element constructor.
+		def self.child(parent, id = self.unique_id, data: {}, **options)
 			full_id = parent.id + ":" + id
 			
-			self.new(full_id, data)
+			self.new(full_id, data, **options)
 		end
 		
-		def self.mount(parent, id, data = {})
-			self.child(parent, id, **data)
+		# Mount an element within a parent element.
+		# @parameter parent [Element] The parent element.
+		# @parameter id [String] The unique identifier within the parent element.
+		# @parameter data [Hash] The data associated with the element, typically stored as `data-` attributes.
+		# @parameter options [Hash] Additional options passed to the element constructor.
+		def self.mount(parent, id, data: {}, **options)
+			self.child(parent, id, data:, **options)
 		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 = {})
+		def initialize(id, data)
 			data[:class] ||= self.class.name
 			
 			@id = id

data/lib/live/resolver.rb

@@ -37,14 +37,35 @@ module Live
 			return self
 		end
 		
+		# Construct an allowed root element from its class.
+		# @parameter view_class [Class] The view class to construct.
+		# @parameter id [String] The unique identifier for the view.
+		# @parameter data [Hash] The data associated with the view.
+		# @parameter options [Hash] Additional options passed to the view constructor.
+		# @returns [Element] A new view instance.
+		# @raises [ArgumentError] If the view class is not allowed.
+		def root(view_class, id = view_class.unique_id, data: {}, **options)
+			unless @allowed[view_class.name].equal?(view_class)
+				raise ArgumentError, "View class is not allowed: #{view_class.to_s.dump}!"
+			end
+			
+			return make(view_class, id, data, **options)
+		end
+		
 		# Resolve a tag.
 		# @parameter id [String] The unique identifier for the tag.
 		# @parameter data [Hash] The data associated with the tag. Should include the `:class` key.
 		# @returns [Element] The element instance if it was allowed.
 		def call(id, data)
-			if klass = @allowed[data[:class]]
-				return klass.new(id, data)
+			if view_class = @allowed[data[:class]]
+				return make(view_class, id, data)
 			end
 		end
+		
+		private
+		
+		def make(view_class, id, data, **options)
+			view_class.new(id, data, **options)
+		end
 	end
 end

data/lib/live/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2021-2026, by Samuel Williams.
 
 module Live
-	VERSION = "0.18.2"
+	VERSION = "0.19.0"
 end

data/readme.md

@@ -40,19 +40,9 @@ bundle exec sus
 
 Please see the [project releases](https://socketry.github.io/live/releases/index) for all releases.
 
-### v0.18.0
-
-  - **Breaking Change**: Live now uses Web Components for managing life-cycle events instead of observers. You will need to use `live-js` v0.16.0 or later with this version of `live`, which emits `<live-view>` elements (instead of `<div>` elements).
-      - Using older versions of `live-js` with this version of `live` may result in unexpected behavior or errors.
-      - Using older versions of `live` with `live-js` v0.16.0 or later may also result in unexpected behavior or errors.
-  - Updating both `live` and `live-js` to their latest versions is recommended to ensure compatibility, and requires no changes to application code.
+### v0.19.0
 
-### v0.18.0
-
-  - **Breaking Change**: Live now uses Web Components for managing life-cycle events instead of observers. You will need to use `live-js` v0.16.0 or later with this version of `live`, which emits `<live-view>` elements (instead of `<div>` elements).
-      - Using older versions of `live-js` with this version of `live` may result in unexpected behavior or errors.
-      - Using older versions of `live` with `live-js` v0.16.0 or later may also result in unexpected behavior or errors.
-  - Updating both `live` and `live-js` to their latest versions is recommended to ensure compatibility, and requires no changes to application code.
+  - [Explicit Element Construction](https://socketry.github.io/live/releases/index#explicit-element-construction)
 
 ### v0.18.0
 

data/releases.md

@@ -1,5 +1,16 @@
 # Releases
 
+## v0.19.0
+
+### Explicit Element Construction
+
+Element construction now separates serialized element data from Ruby constructor options and makes the intended construction path explicit.
+
+  - `Live::Element#initialize` now requires both `id` and `data`. Replace `MyView.new` with `MyView.root`, and replace `MyView.new("custom-id")` with `MyView.root("custom-id")`. Internal callers using `new` directly must pass the data hash explicitly, even when empty.
+  - `Live::Element.root`, `.child`, and `.mount` now accept serialized attributes through `data:`. Other keyword arguments are forwarded to `initialize`. For example, change `MyView.root(mode: "presenter")` to `MyView.root(data: {mode: "presenter"})`; constructor dependencies such as `controller:` can remain ordinary keyword arguments.
+  - Calls passing a positional data hash to `.mount` must use the `data:` keyword. Change `ChildView.mount(parent, "child", {mode: "compact"})` to `ChildView.mount(parent, "child", data: {mode: "compact"})`.
+  - `Live::Resolver#root(view_class, id = view_class.unique_id, data: {}, **options)` constructs an allowed root using the same internal path as browser-resolved elements. Custom resolvers that inject dependencies can override the private `make(view_class, id, data, **options)` method instead of overriding `call`.
+
 ## v0.18.0
 
   - **Breaking Change**: Live now uses Web Components for managing life-cycle events instead of observers. You will need to use `live-js` v0.16.0 or later with this version of `live`, which emits `<live-view>` elements (instead of `<div>` elements).

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: live
 version: !ruby/object:Gem::Version
-  version: 0.18.2
+  version: 0.19.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -115,7 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Live HTML tags updated via a WebSocket.
 test_files: []