lively 0.19.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d4f90097ca71e02dffa056e9251b96a63f0d45262ad5eddd0f073d2d02d42b6e
-  data.tar.gz: 214a19575d3f3fa624a3d71494b888feccebc18774fa1e38255ec4ceb90c84a6
+  metadata.gz: 8430df315a92af764a65128e479adf71cd0971e27edfc259ba9ec5c7bbc21cbc
+  data.tar.gz: c48c124558fd175a016cd60a38e5f9773821d0c9fe260ed5a60218ee21e4f08d
 SHA512:
-  metadata.gz: 23cc87763d59471eaabdfee09f234f389c3576f7bb6d59df85f65e0205d7f6244710c20cfed77c3e0543513f4db581664e776062383c9a05491673ca8bfc88b8
-  data.tar.gz: 5b905206f71fcea3f15da3f6db3f0e8fcd9f1bd85f06278654d621affb4d72cf42828b828a1f6821602a98f8af5b8441fe701a4785a7626b4327f972dad8b03d
+  metadata.gz: 529d3090d929d951da18f7f58df1cb6df958f1489b54bdcbf370003b24a103dcee9ec72071be2b50c0ca327c66486cb44ed3954064cd38180774166c50e319b8
+  data.tar.gz: 23a4576c7fd367afbe32c761f6e039c74b5bef211d35f1be48690a30c68c2546d4c2530101fbe7798a526b497b864ec98e52d6b6cea29bb30fa3c6bcbb433b43

data/context/getting-started.md

@@ -117,33 +117,23 @@ class Application < Lively::Application
 	end
 	
 	def configure_routes(router)
-		super
-		
-		router.get("/") do
-			render(DisplayView.new(**state))
+		router.get("/") do |request|
+			render_view(request, DisplayView)
 		end
 		
-		router.get("/control") do |_request, parameters|
-			render(ControlView.new(**state, mode: parameters["mode"]))
+		router.get("/control") do |request, parameters|
+			render_view(request, ControlView, mode: parameters["mode"])
 		end
 	end
-	
-	# Unmatched routes are passed here:
-	def handle(request)
-		delegate.call(request)
-	end
-	
-	private
-	
-	def render(body)
-		page = Lively::Pages::Index.new(title: "My App", body: body)
-		Protocol::HTTP::Response[200, [], [page.call]]
-	end
 end
 ```
 
+`allowed_views` defines the view classes the live resolver may construct. Routes select which view to display at each path, including `/`. `make_view` constructs a view with shared state, `make_page` wraps it in the default page, and `render_view` composes both operations. A custom route can construct any {ruby Lively::Page} around `make_view` and call it with the request. Lively installs its `/live` WebSocket route independently, so overriding `configure_routes` does not remove it.
+
 Routes match exact paths and may accept one or more HTTP methods. Query parameters are decoded using `protocol-url` and passed to the handler as its second argument. Routes without an explicit method accept every method.
 
+Requests which do not match a route are passed to the application's delegate. An application using client-side history routing can instead override `#handle` to render an application page for unmatched paths.
+
 ## Live Reloading
 
 To enable live reloading, add the `io-watch` gem to your `gems.rb` file:

data/lib/lively/application.rb

@@ -31,7 +31,7 @@ module Lively
 		# Create a new application class configured for a specific Live view tag,
 		# optionally with shared state that is passed to all views.
 		#
-		# @parameter tag [Class] The Live view class to use as the application body.
+		# @parameter tag [Class] The Live view class to render at the root route.
 		# @parameter state [Hash] Shared state to pass to all views as keyword arguments.
 		# @returns [Class] A new application class configured for the specified tag.
 		def self.[](*tags, **state)
@@ -87,31 +87,44 @@ module Lively
 			self.class.name
 		end
 		
-		# Create the body content for this application.
+		# Construct a view with shared application state.
+		# @parameter view_class [Class] The view class to construct.
+		# @parameter arguments [Hash] Additional keyword arguments for the view.
 		# @returns [Live::View] A new view instance.
-		def body
-			self.allowed_views.first.new(**self.state)
+		def make_view(view_class, **arguments)
+			view_class.new(**self.state, **arguments)
 		end
 		
-		# Create the index page for this application.
-		# @returns [Pages::Index] A new index page instance.
-		def index
-			Pages::Index.new(title: self.title, body: self.body)
+		# Construct the default page for a view.
+		# Override this to customize the document surrounding live views.
+		# @parameter view [Live::View] The root view for the page.
+		# @returns [Page] A new page instance.
+		def make_page(view)
+			Pages::Index.new(title: self.title, body: view)
+		end
+		
+		# Construct a view and its default page, then render an HTTP response.
+		# @parameter request [Protocol::HTTP::Request] The incoming request.
+		# @parameter view_class [Class] The view class to render.
+		# @parameter arguments [Hash] Additional keyword arguments for the view.
+		# @returns [Protocol::HTTP::Response] A successful HTML response.
+		def render_view(request, view_class, **arguments)
+			make_page(make_view(view_class, **arguments)).call(request)
 		end
 		
 		# Handle a standard HTTP request which did not match a configured route.
 		# @parameter request [Protocol::HTTP::Request] The incoming HTTP request.
-		# @returns [Protocol::HTTP::Response] The HTTP response with the rendered page.
+		# @returns [Protocol::HTTP::Response] The delegate response.
 		def handle(request)
-			return Protocol::HTTP::Response[200, [], [self.index.call]]
+			return delegate.call(request)
 		end
 		
-		# Add the standard application routes to the given router.
-		# Override this method and call `super` to add application-specific routes.
+		# Add application routes to the given router.
+		# Override this method to map paths to views or other handlers.
 		# @parameter router [Router] The router to configure.
 		def configure_routes(router)
-			router.route("/live") do |request|
-				Async::WebSocket::Adapters::HTTP.open(request, &self.method(:live)) || Protocol::HTTP::Response[400]
+			router.get("/") do |request|
+				self.render_view(request, self.allowed_views.first)
 			end
 		end
 		
@@ -120,6 +133,7 @@ module Lively
 		# @returns [Router] The configured router.
 		def router
 			@router ||= Router.new.tap do |router|
+				configure_system_routes(router)
 				configure_routes(router)
 			end
 		end
@@ -130,5 +144,15 @@ module Lively
 		def call(request)
 			return router.call(request) || handle(request)
 		end
+		
+		private
+		
+		# Add framework-owned routes to the given router.
+		# @parameter router [Router] The router to configure.
+		def configure_system_routes(router)
+			router.route("/live") do |request|
+				Async::WebSocket::Adapters::HTTP.open(request, &self.method(:live)) || Protocol::HTTP::Response[400]
+			end
+		end
 	end
 end

data/lib/lively/page.rb

@@ -4,6 +4,7 @@
 # Copyright, 2026, by Samuel Williams.
 
 require "json"
+require "protocol/http/response"
 require "xrb/markup"
 require "xrb/tag"
 require "xrb/template"
@@ -94,10 +95,17 @@ module Lively
 			XRB::MarkupString.raw(json)
 		end
 		
-		# Render this page to a string.
+		# Render this page to an HTML string.
 		# @returns [String]
-		def call
+		def to_html
 			@template.to_string(self)
 		end
+		
+		# Render this page as an HTTP response.
+		# @parameter request [Protocol::HTTP::Request] The incoming request.
+		# @returns [Protocol::HTTP::Response] A successful HTML response.
+		def call(request)
+			Protocol::HTTP::Response[200, {"content-type" => "text/html; charset=utf-8"}, [to_html]]
+		end
 	end
 end

data/lib/lively/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module Lively
-	VERSION = "0.19.0"
+	VERSION = "0.21.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lively
 version: !ruby/object:Gem::Version
-  version: 0.19.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Samuel Williams