lively 0.16.1 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d27407a416fa635821337fdd4e59b5e74f5116e9d30ff3026e9e4828ae7420ad
-  data.tar.gz: 9fc8989d73bb25d310d4094e0c4da39d7b4d05295714571f7335ae0c09c9ea28
+  metadata.gz: d41e94774f23353b426f53e23eb343783826c244d9bbad793759e5eea9fcd534
+  data.tar.gz: c2c5b21df4f25117d12e8c8af2e8c17113489346087cdd80a2d5b6b0dbd920d9
 SHA512:
-  metadata.gz: 1d7d6d282fb8788b8c8eb711c95e18f1a491138dbb91d6a8b26ec663c1b4e9f39b86c267580177838d5ea7e94464d2f6a847341b0beb71274f7aacc9a47be4b5
-  data.tar.gz: 7dd7b5fca6f49acd4fb53889793b53758613da379db8835e44120ce442eca18b55857e2829f72e98b79c57695fc1a03a2c58513f51db781a0301f73214629394
+  metadata.gz: 0445eecaf41965ab7aea620f3d2886da5b2e76a5850678fcb30b60e0410aafe6d5f7d4180348564f43833b07476f2bacac00dc447a38229528ff8884ad67374e
+  data.tar.gz: f75a5afa75d4d98ad71c4a014c00ffec9b62368d1995eafe67265c05ee72e0cfd43afcc9a43374dda74b2261753348c0b34adfe672bc9d09f3566899f661e69f

data/context/flappy-bird-tutorial.md

@@ -48,7 +48,7 @@ First, let's create the basic structure for our game. We'll start with a simple
 Create a new file called `flappy_basic.rb`:
 
 ```ruby
-require 'live'
+require "live"
 
 class FlappyBasicView < Live::View
 	WIDTH = 420
@@ -172,7 +172,7 @@ class Bird < BoundingBox
 	
 	def initialize(x = 30, y = HEIGHT / 2, width: 34, height: 24, skin: nil)
 		super(x, y, width, height)
-		@skin = skin || 'bird'
+		@skin = skin || "bird"
 		@velocity = 0.0
 		@jumping = false
 		@dying = false
@@ -253,7 +253,7 @@ class Bird < BoundingBox
 				
 				builder.inline_tag(:div, 
 					id: id, 
-					class: 'particle jump', 
+					class: "particle jump", 
 					style: "left: #{center[0]}px; bottom: #{center[1]}px; --rotation-angle: #{angle}deg;"
 				)
 			end
@@ -387,12 +387,12 @@ class Pipe
 		
 		# Render lower pipe
 		builder.inline_tag(:div, 
-			class: 'pipe', 
+			class: "pipe", 
 			style: "left: #{@x}px; bottom: #{self.bottom}px; width: #{@width}px; height: #{@height}px; #{display}"
 		)
 		# Render upper pipe
 		builder.inline_tag(:div, 
-			class: 'pipe', 
+			class: "pipe", 
 			style: "left: #{@x}px; bottom: #{self.top}px; width: #{@width}px; height: #{@height}px; #{display}"
 		)
 	end
@@ -461,7 +461,7 @@ class Gemstone < BoundingBox
 		end
 		
 		builder.inline_tag(:div, 
-			class: 'gemstone', 
+			class: "gemstone", 
 			style: "left: #{@x}px; bottom: #{@y}px; width: #{@width}px; height: #{@height}px; opacity: #{opacity};"
 		)
 		
@@ -475,7 +475,7 @@ class Gemstone < BoundingBox
 				
 				builder.inline_tag(:div, 
 					id: id, 
-					class: 'particle bonus', 
+					class: "particle bonus", 
 					style: "left: #{center[0]}px; bottom: #{center[1]}px; --rotation-angle: #{angle}deg;"
 				)
 			end
@@ -540,7 +540,7 @@ Let's add a way for players to choose different bird skins:
 
 ```ruby
 class SkinSelectionView < Live::View
-	SKINS = ['bird', 'gull', 'kiwi', 'owl']
+	SKINS = ["bird", "gull", "kiwi", "owl"]
 	
 	def handle(event)
 		skin = event.dig(:detail, :skin) or return
@@ -627,7 +627,7 @@ class FlappyView < Live::View
 		@pipes = nil
 		@bonus = nil
 		
-		@skin_selection = SkinSelectionView.mount(self, 'skin-selection')
+		@skin_selection = SkinSelectionView.mount(self, "skin-selection")
 		
 		# Game state
 		@score = 0
@@ -784,7 +784,7 @@ def step(dt)
 					play_music
 				end
 			end
-		
+			
 			# Check for collision
 			if pipe.intersect?(@bird)
 				Console.info(self, "Player has died.")
@@ -943,7 +943,7 @@ Here's how all the pieces fit together in a complete game file:
 #!/usr/bin/env lively
 # frozen_string_literal: true
 
-require 'live'
+require "live"
 
 # [All the classes we've built: BoundingBox, Bird, Pipe, Gemstone, SkinSelectionView, FlappyView]
 # Put them all together in a single file for easy execution

data/context/game-audio-tutorial.md

@@ -116,7 +116,7 @@ To play sounds from your Ruby application, you need to connect your custom eleme
 **Ruby Application (`application.rb`):**
 
 ```ruby
-require 'lively'
+require "lively"
 
 class GameView < Live::View
 	def tag_name
@@ -131,17 +131,17 @@ class GameView < Live::View
 	
 	def player_jump
 		@player.jump
-		play_sound('jump')   # Play jump sound
+		play_sound("jump")   # Play jump sound
 	end
 	
 	def collect_coin
 		@score += 10
-		play_sound('coin')   # Play coin sound
+		play_sound("coin")   # Play coin sound
 	end
 	
 	def player_dies
 		@lives -= 1
-		play_sound('death')  # Play death sound
+		play_sound("death")  # Play death sound
 	end
 end
 ```

data/context/worms-tutorial.md

@@ -72,7 +72,7 @@ class StaticBoard
 		@height = height
 		
 		# Use an Array of Arrays to store a grid:
-		@grid = Array.new(@height) {Array.new(@width)}
+		@grid = Array.new(@height){Array.new(@width)}
 		
 		# Place a fruit:
 		@grid[1][1] = "🍎"
@@ -94,7 +94,7 @@ class StaticView < Live::View
 	
 	# Render the HTML grid:
 	def render(builder)
-		builder.tag("h1") {builder.text("My First Lively Game!")}
+		builder.tag("h1"){builder.text("My First Lively Game!")}
 		builder.tag("table") do
 			@board.grid.each do |row|
 				builder.tag("tr") do
@@ -102,7 +102,7 @@ class StaticView < Live::View
 						if cell.is_a?(Hash)
 							builder.tag("td", style: "background-color: #{cell[:color]};")
 						elsif cell.is_a?(String)
-							builder.tag("td") {builder.text(cell)}
+							builder.tag("td"){builder.text(cell)}
 						else
 							builder.tag("td")
 						end
@@ -165,7 +165,7 @@ class InteractiveBoard
 	def initialize(width = 5, height = 5)
 		@width = width
 		@height = height
-		@grid = Array.new(@height) {Array.new(@width)}
+		@grid = Array.new(@height){Array.new(@width)}
 		# Put a fruit in the center:
 		@grid[2][2] = "🍎"
 	end
@@ -226,7 +226,7 @@ class InteractiveView < Live::View
 	
 	# Render the HTML grid, including event forwarding.
 	def render(builder)
-		builder.tag("h1") {builder.text("Interactive Board - Click the cells!")}
+		builder.tag("h1"){builder.text("Interactive Board - Click the cells!")}
 		builder.tag("table") do
 			@board.grid.each_with_index do |row, y|
 				builder.tag("tr") do
@@ -235,7 +235,7 @@ class InteractiveView < Live::View
 							# lively.forwardEvent sends the event from the browser to the server, invoking the handle method above. Note that we include the x and y coordinates as extra details.
 							builder.tag("td", onclick: "live.forwardEvent('#{@id}', event, {y: #{y}, x: #{x}});", style: "cursor: pointer; background-color: #{cell[:color]};")
 						elsif cell.is_a?(String)
-							builder.tag("td", onclick: "live.forwardEvent('#{@id}', event, {y: #{y}, x: #{x}});", style: "cursor: pointer;") {builder.text(cell)}
+							builder.tag("td", onclick: "live.forwardEvent('#{@id}', event, {y: #{y}, x: #{x}});", style: "cursor: pointer;"){builder.text(cell)}
 						else
 							builder.tag("td", onclick: "live.forwardEvent('#{@id}', event, {y: #{y}, x: #{x}});", style: "cursor: pointer;")
 						end
@@ -243,7 +243,7 @@ class InteractiveView < Live::View
 				end
 			end
 		end
-		builder.tag("p") {builder.text("Click any cell to cycle: empty → fruit → worm segment → empty.")}
+		builder.tag("p"){builder.text("Click any cell to cycle: empty → fruit → worm segment → empty.")}
 	end
 end
 
@@ -275,7 +275,7 @@ class Board
 	def initialize(width = 8, height = 8)
 		@width = width
 		@height = height
-		@grid = Array.new(@height) {Array.new(@width)}
+		@grid = Array.new(@height){Array.new(@width)}
 	end
 	
 	attr_reader :grid, :width, :height
@@ -348,7 +348,7 @@ class SimpleWorm
 			# Don't move this tick
 			return
 		end
-
+		
 		# Otherwise, update the worm's position:
 		@y, @x = new_y, new_x
 		@board.set_segment(@y, @x, @color, @length)
@@ -394,7 +394,7 @@ class MovingWormView < Live::View
 	
 	# Render the HTML grid, including event forwarding.
 	def render(builder)
-		builder.tag("h1") {builder.text("Automatic Moving Worm")}
+		builder.tag("h1"){builder.text("Automatic Moving Worm")}
 		builder.tag("table") do
 			@board.grid.each_with_index do |row, y|
 				builder.tag("tr") do
@@ -408,8 +408,8 @@ class MovingWormView < Live::View
 				end
 			end
 		end
-		builder.tag("p") {builder.text("Watch the colored worm bounce around and leave a trail!")}
-		builder.tag("p") {builder.text("Current position: (#{@worm.y}, #{@worm.x})")}
+		builder.tag("p"){builder.text("Watch the colored worm bounce around and leave a trail!")}
+		builder.tag("p"){builder.text("Current position: (#{@worm.y}, #{@worm.x})")}
 	end
 end
 
@@ -434,7 +434,7 @@ class Board
 	def initialize(width = 10, height = 10)
 		@width = width
 		@height = height
-		@grid = Array.new(@height) {Array.new(@width)}
+		@grid = Array.new(@height){Array.new(@width)}
 	end
 	
 	attr_reader :grid, :width, :height
@@ -508,7 +508,7 @@ class ControllableView < Live::View
 		@worm = ControllableWorm.new(@board, 5, 5)
 		@movement = nil
 	end
-
+	
 	def bind(page)
 		super
 		
@@ -521,7 +521,7 @@ class ControllableView < Live::View
 			end
 		end
 	end
-
+	
 	def close
 		if movement = @movement
 			@movement = nil
@@ -530,7 +530,7 @@ class ControllableView < Live::View
 		
 		super
 	end
-
+	
 	def handle(event)
 		Console.info(self, "Event:", event)
 		
@@ -548,9 +548,9 @@ class ControllableView < Live::View
 			end
 		end
 	end
-
+	
 	def render(builder)
-		builder.tag("h1") {builder.text("Controllable Worm - Use WASD!")}
+		builder.tag("h1"){builder.text("Controllable Worm - Use WASD!")}
 		builder.tag("table", tabindex: 0, autofocus: true, onkeypress: "live.forwardEvent('#{@id}', event, {key: event.key});") do
 			@board.grid.each_with_index do |row, y|
 				builder.tag("tr") do
@@ -567,10 +567,10 @@ class ControllableView < Live::View
 		
 		# Log extra information about the game:
 		builder.tag("div") do
-			builder.tag("p") {builder.text("Controls: W (up), A (left), S (down), D (right)")}
-			builder.tag("p") {builder.text("Current direction: #{@worm.direction}")}
-			builder.tag("p") {builder.text("Position: (#{@worm.y}, #{@worm.x})")}
-			builder.tag("p") {builder.text("Click on the game board first, then use WASD keys!")}
+			builder.tag("p"){builder.text("Controls: W (up), A (left), S (down), D (right)")}
+			builder.tag("p"){builder.text("Current direction: #{@worm.direction}")}
+			builder.tag("p"){builder.text("Position: (#{@worm.y}, #{@worm.x})")}
+			builder.tag("p"){builder.text("Click on the game board first, then use WASD keys!")}
 		end
 	end
 end
@@ -612,7 +612,7 @@ class Board
 	def initialize(width = 15, height = 15)
 		@width = width
 		@height = height
-		@grid = Array.new(@height) {Array.new(@width)}
+		@grid = Array.new(@height){Array.new(@width)}
 		@fruit_count = 0
 		reset!
 	end
@@ -640,7 +640,7 @@ class Board
 	end
 	
 	def reset!
-		@grid.each {|row| row.fill(nil)}
+		@grid.each{|row| row.fill(nil)}
 		@fruit_count = 0
 		add_fruit!
 	end
@@ -779,11 +779,11 @@ class WormsGameView < Live::View
 	end
 	
 	def render(builder)
-		builder.tag("h1") {builder.text("Worms Game (Reference-style)")}
+		builder.tag("h1"){builder.text("Worms Game (Reference-style)")}
 		builder.tag("div") do
-			builder.tag("p") {builder.text("Score: #{@player.score}")}
-			builder.tag("p") {builder.text("Length: #{@player.count}")}
-			builder.tag("p") {builder.text("Direction: #{@player.direction}")}
+			builder.tag("p"){builder.text("Score: #{@player.score}")}
+			builder.tag("p"){builder.text("Length: #{@player.count}")}
+			builder.tag("p"){builder.text("Direction: #{@player.direction}")}
 		end
 		builder.tag("table", tabindex: 0, autofocus: true, onkeypress: "live.forwardEvent('#{@id}', event, {key: event.key});") do
 			@board.grid.each do |row|
@@ -792,7 +792,7 @@ class WormsGameView < Live::View
 						if cell.is_a?(Hash)
 							builder.tag("td", style: "background-color: #{cell[:color]};")
 						elsif cell.is_a?(String)
-							builder.tag("td") {builder.text(cell)}
+							builder.tag("td"){builder.text(cell)}
 						else
 							builder.tag("td")
 						end

data/lib/lively/application.rb

@@ -1,12 +1,13 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require "live"
 require "protocol/http/middleware"
 require "async/websocket/adapters/http"
 
+require_relative "resolver"
 require_relative "pages/index"
 require_relative "hello_world"
 
@@ -18,49 +19,65 @@ module Lively
 	# standard HTTP requests for the initial page load and WebSocket connections
 	# for live updates. It integrates with the Live framework to provide real-time
 	# interactive web applications.
+	#
+	# Use {.[]} to create a simple application class for a single view, optionally
+	# with shared state. For more complex applications, subclass and override
+	# {#allowed_views}, {#state}, and {#body}.
 	class Application < Protocol::HTTP::Middleware
-		# Create a new application class configured for a specific Live view tag.
+		VIEWS = [HelloWorld].freeze
+		STATE = {}.freeze
+		
+		# 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 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.[](tag)
+		def self.[](*tags, **state)
 			klass = Class.new(self)
 			
-			klass.define_singleton_method(:resolver) do
-				Live::Resolver.allow(tag)
-			end
-			
-			klass.define_method(:body) do
-				tag.new
-			end
+			klass.const_set(:VIEWS, tags)
+			klass.const_set(:STATE, state)
 			
 			return klass
 		end
 		
-		# Get the default resolver for this application.
-		# @returns [Live::Resolver] A resolver configured to allow HelloWorld components.
-		def self.resolver
-			Live::Resolver.allow(HelloWorld)
-		end
-		
 		# Initialize a new Lively application.
 		# @parameter delegate [Protocol::HTTP::Middleware] The next middleware in the chain.
-		# @parameter resolver [Live::Resolver] The resolver for Live components.
-		def initialize(delegate, resolver: self.class.resolver)
+		def initialize(delegate)
 			super(delegate)
-			
-			@resolver = resolver
 		end
 		
-		# @attribute [Live::Resolver] The resolver for live components.
-		attr :resolver
-		
 		# @attribute [Protocol::HTTP::Middleware] The delegate middleware for request handling.
 		attr :delegate
 		
+		# The shared state for this application, passed to all views via the resolver.
+		# Override this in subclasses to provide custom state.
+		# @returns [Hash] Key-value pairs passed as keyword arguments to view constructors.
+		def state
+			self.class::STATE
+		end
+		
+		# The view classes that this application allows.
+		# Override this in subclasses to specify which views can be resolved.
+		# @returns [Array(Class)] The allowed view classes.
+		def allowed_views
+			self.class::VIEWS
+		end
+		
+		# The resolver for live components.
+		# Built from {#allowed_views} and {#state}.
+		# @returns [Lively::Resolver] The resolver instance.
+		def resolver
+			@resolver ||= Resolver.new(self.state).tap do |resolver|
+				resolver.allow(*self.allowed_views)
+			end
+		end
+		
 		# Handle a WebSocket connection for live updates.
 		# @parameter connection [Async::WebSocket::Connection] The WebSocket connection.
 		def live(connection)
-			Live::Page.new(@resolver).run(connection)
+			Live::Page.new(self.resolver).run(connection)
 		end
 		
 		# Get the title for this application.
@@ -70,25 +87,22 @@ module Lively
 		end
 		
 		# Create the body content for this application.
-		# @parameter **options [Hash] Additional options to pass to the body constructor.
-		# @returns [HelloWorld] A new HelloWorld instance.
-		def body(...)
-			HelloWorld.new(...)
+		# @returns [Live::View] A new view instance.
+		def body
+			self.allowed_views.first.new(**self.state)
 		end
 		
 		# Create the index page for this application.
-		# @parameter **options [Hash] Additional options to pass to the index constructor.
 		# @returns [Pages::Index] A new index page instance.
-		def index(...)
-			Pages::Index.new(title: self.title, body: self.body(...))
+		def index
+			Pages::Index.new(title: self.title, body: self.body)
 		end
 		
 		# Handle a standard HTTP request.
 		# @parameter request [Protocol::HTTP::Request] The incoming HTTP request.
-		# @parameter **options [Hash] Additional options.
 		# @returns [Protocol::HTTP::Response] The HTTP response with the rendered page.
-		def handle(request, ...)
-			return Protocol::HTTP::Response[200, [], [self.index(...).call]]
+		def handle(request)
+			return Protocol::HTTP::Response[200, [], [self.index.call]]
 		end
 		
 		# Process an incoming HTTP request.

data/lib/lively/pages/index.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require "xrb/template"
 

data/lib/lively/resolver.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+require "live/resolver"
+
+module Lively
+	# Extends {Live::Resolver} to pass shared application state to views on construction.
+	#
+	# When the browser reconnects via WebSocket, the resolver creates new view
+	# instances with the shared state (e.g. a controller) so all clients stay in sync.
+	class Resolver < Live::Resolver
+		# Initialize a new resolver with shared state.
+		# @parameter state [Hash] Key-value pairs to pass to view constructors as keyword arguments.
+		def initialize(state = nil)
+			super()
+			@state = state
+		end
+		
+		# @attribute [Hash] The shared state passed to view constructors.
+		attr :state
+		
+		# Resolve a client-side element to a server-side instance with shared state.
+		# @parameter id [String] The unique element identifier.
+		# @parameter data [Hash] The element data attributes.
+		# @returns [Live::Element | Nil] The resolved element, or `nil`.
+		def call(id, data)
+			if klass = @allowed[data[:class]]
+				return klass.new(id, data, **@state)
+			end
+		end
+	end
+end

data/lib/lively/version.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2025, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 # @namespace
 module Lively
-	VERSION = "0.16.1"
+	VERSION = "0.17.0"
 end

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2021-2025, by Samuel Williams.  
+Copyright, 2021-2026, by Samuel Williams.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/public/_components/@socketry/live/Live.js

@@ -87,8 +87,9 @@ export class Live {
 		
 		server.onopen = () => {
 			this.#failures = 0;
-			this.#flush();
+			// Attach elements before flushing any pending events:
 			this.#attach();
+			this.#flush();
 		};
 		
 		server.onmessage = (message) => {
@@ -165,16 +166,30 @@ export class Live {
 		}
 	}
 	
+	connected() {
+		return this.#server && this.#server.readyState === this.#window.WebSocket.OPEN;
+	}
+	
 	bind(element) {
-		this.#send(JSON.stringify(['bind', element.id, element.dataset]));
+		if (this.connected()) {
+			try {
+				return this.#server.send(JSON.stringify(['bind', element.id, element.dataset]));
+			} catch (error) {
+				// The server must be in a bad state, we will rebind in attach on connect, later.
+			}
+		}
 	}
 
 	unbind(element) {
-		if (this.#server) {
-			this.#send(JSON.stringify(['unbind', element.id]));
+		if (this.connected()) {
+			try {
+				return this.#server.send(JSON.stringify(['unbind', element.id]));
+			} catch (error) {
+				// The server must be in a bad state, unbind is irrelelvant.
+			}
 		}
 	}
-
+	
 	#attach() {
 		for (let element of ViewElement.connectedElements) {
 			this.bind(element);

data/public/_components/@socketry/live/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@socketry/live",
   "type": "module",
-  "version": "0.16.0",
+  "version": "0.16.2",
   "description": "Live HTML tags for Ruby.",
   "main": "Live.js",
+  "exports": {
+    ".": "./Live.js"
+  },
   "files": [
     "Live.js"
   ],

data/public/_components/@socketry/live-audio/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@socketry/live-audio",
   "type": "module",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Web Audio API-based game audio synthesis and background music library for Ruby Live applications.",
   "main": "Live/Audio.js",
+  "exports": {
+    ".": "./Live/Audio.js",
+    "./Library": "./Live/Audio/Library.js"
+  },
   "files": [
     "Live/"
   ],

data/readme.md

@@ -16,6 +16,59 @@ Please see the [project documentation](https://socketry.github.io/lively/) for m
 
   - [Game Audio Tutorial](https://socketry.github.io/lively/guides/game-audio-tutorial/index) - This guide shows you how to add audio to your Live.js games and applications using the `live-audio` library. You'll learn how to play sound effects, background music, and create dynamic audio experiences.
 
+## Releases
+
+Please see the [project releases](https://socketry.github.io/lively/releases/index) for all releases.
+
+### v0.17.0
+
+  - Expose shared application state via `Application[..., controller: Controller.new]`.
+
+### v0.16.2
+
+  - Modernize internals and update dependencies.
+
+### v0.16.1
+
+  - Updated game audio tutorial content.
+
+### v0.16.0
+
+  - Updated `live-audio` component dependencies.
+
+### v0.15.1
+
+  - Fixed handling of spaces in asset names.
+
+### v0.15.0
+
+  - Added platformer-style game example.
+  - Improved game audio tutorial.
+
+### v0.14.1
+
+  - Added `bake` tasks for release management.
+
+### v0.14.0
+
+  - Fixed guide rendering and test suite.
+
+### v0.13.1
+
+  - Tidied up gem dependencies.
+
+### v0.13.0
+
+  - Added `live-audio` support for background and positional audio in applications.
+  - Added game audio example demonstrating audio playback.
+  - Fixed serving non-existent asset paths gracefully.
+  - Achieved 100% test and documentation coverage.
+
+## See Also
+
+  - [live](https://github.com/socketry/live) — Provides client-server communication using websockets.
+  - [mayu](https://github.com/mayu-live/framework) — A live streaming server-side component-based VirtualDOM rendering framework.
+
 ## Contributing
 
 We welcome contributions to this project.
@@ -26,21 +79,26 @@ We welcome contributions to this project.
 4.  Push to the branch (`git push origin my-new-feature`).
 5.  Create new Pull Request.
 
-### Developer Certificate of Origin
+### Running Tests
 
-In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
+To run the test suite:
 
-### Community Guidelines
+``` shell
+bundle exec sus
+```
 
-This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.
+### Making Releases
 
-## Releases
+To make a new release:
 
-Please see the [project releases](https://socketry.github.io/lively/releases/index) for all releases.
+``` shell
+bundle exec bake gem:release:patch # or minor or major
+```
 
-### v0.14.1
+### Developer Certificate of Origin
 
-## See Also
+In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
 
-  - [live](https://github.com/socketry/live) — Provides client-server communication using websockets.
-  - [mayu](https://github.com/mayu-live/framework) — A live streaming server-side component-based VirtualDOM rendering framework.
+### Community Guidelines
+
+This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.

data/releases.md

@@ -1,3 +1,119 @@
 # Releases
 
+## v0.17.0
+
+  - Expose shared application state via `Application[..., controller: Controller.new]`.
+
+## v0.16.2
+
+  - Modernize internals and update dependencies.
+
+## v0.16.1
+
+  - Updated game audio tutorial content.
+
+## v0.16.0
+
+  - Updated `live-audio` component dependencies.
+
+## v0.15.1
+
+  - Fixed handling of spaces in asset names.
+
+## v0.15.0
+
+  - Added platformer-style game example.
+  - Improved game audio tutorial.
+
 ## v0.14.1
+
+  - Added `bake` tasks for release management.
+
+## v0.14.0
+
+  - Fixed guide rendering and test suite.
+
+## v0.13.1
+
+  - Tidied up gem dependencies.
+
+## v0.13.0
+
+  - Added `live-audio` support for background and positional audio in applications.
+  - Added game audio example demonstrating audio playback.
+  - Fixed serving non-existent asset paths gracefully.
+  - Achieved 100% test and documentation coverage.
+
+## v0.12.0
+
+  - Added bundled guides for getting started and tutorials.
+  - Added Pacman example application.
+  - Improved multiplayer support in flappy bird via `falcon.rb` binding.
+  - Fixed chatbot example.
+
+## v0.11.0
+
+  - Added `.wav` audio file support.
+  - Added worms multiplayer presentation example.
+  - Added tool-assisted AI integration example.
+  - Dropped support for Ruby v3.1.
+
+## v0.10.1
+
+  - Fixed missing `require` statements.
+
+## v0.10.0
+
+  - Added touch input support for mobile devices.
+  - Added multiplayer support to the flappy bird example.
+  - Default asset root is now the local `public/` directory.
+
+## v0.9.0
+
+  - Added `.mp3` audio file support.
+  - Added sound effects to the math quest example.
+
+## v0.8.0
+
+  - Server now binds to `localhost` by default for security.
+  - Disabled asset caching during development.
+  - Added worms example application.
+
+## v0.7.0
+
+  - Added hello-world example application.
+  - Updated `@socketry/live` to v0.14.0.
+  - Renamed `example/` directory to `examples/`.
+
+## v0.6.0
+
+  - Added `lively` command-line executable.
+  - Added several example applications (chatbot, flappy bird, game of life, waves).
+
+## v0.5.0
+
+  - Updated bundled `Live.js` client library.
+
+## v0.4.0
+
+  - Updated dependencies and `live.js`.
+
+## v0.3.0
+
+  - Modernized gem structure.
+  - Fixed service environment configuration issues.
+
+## v0.2.1
+
+  - Updated dependencies.
+  - Switched to `bake-gem` for release management.
+
+## v0.2.0
+
+  - Public assets are now included in the released gem.
+  - Moved example app to a separate repository.
+  - Improved event handling and UI styling.
+
+## v0.1.0
+
+  - Initial proof of concept implementation.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lively
 version: !ruby/object:Gem::Version
-  version: 0.16.1
+  version: 0.17.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -126,6 +126,7 @@ files:
 - lib/lively/hello_world.rb
 - lib/lively/pages/index.rb
 - lib/lively/pages/index.xrb
+- lib/lively/resolver.rb
 - lib/lively/version.rb
 - license.md
 - public/_components/@socketry/live-audio/Live/Audio.js
@@ -164,14 +165,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.6
 specification_version: 4
 summary: A simple client-server SPA framework.
 test_files: []