presently 0.25.0 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 665a4ba800abf1cbeea2acd8073600273160613f32221277f8bc84e616023024
-  data.tar.gz: ff0135c2c722ab5f447cc595fc7822320ead87b0ba303e8f08cf40e1ecda5c4c
+  metadata.gz: 57754e7cc66ec20e3ef797b20afbe147fda8979e96aafc14cdb9c35eaedb5495
+  data.tar.gz: 242278bc2177efc35609ece981bb3f6cb5fed099e628894d6c8ed9dcf77ce020
 SHA512:
-  metadata.gz: 7a07dd02fe9c344ee29678e5d2b5037e91ae355d0f28c5a6eb57fa3121cc5ce90c170d4281de0b728c3526b61f21600182865487a0ddc7b3eac1952dd647020d
-  data.tar.gz: 67322e24a739782b01f77396ee54e5940272b739fc31e11acb9ad77f4db2cc3bd1eb1d9b6542384cde3d8581737712a97b22ddb5a49fec4770c5dcc08c05a528
+  metadata.gz: 206d33b334f6d1ed9f4b7df2b328022bb5b332a43a53932840be6bd5c00a5b1a41d8df262b441309d04a17d0fc74bdf6120449f4ff1ec0f84228385856d3df9e
+  data.tar.gz: 42f72ece55c0c02160fd12b90006651f0cd3cb1d2b4a95fa12516dbc1d88172652d76afd5639a3ff7c7b8edd6e57eb7d7ba6fb6a6303a90109bcff005aefdb2a

data/lib/presently/presentation_controller.rb

@@ -89,6 +89,7 @@ module Presently
 		end
 		
 		# The progress through the current slide's allocated time.
+		# Slides with durations of zero or less are complete once their expected start time is reached.
 		# @returns [Float] A value between 0.0 and 1.0.
 		def slide_progress
 			return 0.0 unless @clock.started?
@@ -97,7 +98,11 @@ module Presently
 			return 0.0 unless slide
 			
 			time_into_slide = @clock.elapsed - @presentation.expected_time_at(@current_index)
-			(time_into_slide / slide.duration).clamp(0.0, 1.0)
+			if slide.duration <= 0
+				time_into_slide.negative? ? 0.0 : 1.0
+			else
+				(time_into_slide / slide.duration).clamp(0.0, 1.0)
+			end
 		end
 		
 		# Reset the timer so that elapsed time matches the expected time for the current slide.
@@ -107,8 +112,9 @@ module Presently
 		end
 		
 		# The current pacing status relative to the slide timing.
-		# @returns [Symbol] One of `:on_time`, `:ahead`, or `:behind`.
+		# @returns [Symbol | Nil] One of `:on_time`, `:ahead`, or `:behind`, or `nil` when no presentation time is allocated.
 		def pacing
+			return unless total_duration.positive?
 			return :on_time unless @clock.started?
 			
 			elapsed = @clock.elapsed
@@ -137,19 +143,27 @@ module Presently
 		# Navigate to a specific slide by index.
 		# Ignores out-of-bounds indices. Notifies listeners on change.
 		# @parameter index [Integer] The slide index to navigate to.
-		def go_to(index)
-			return if index < 0 || index >= slide_count
+		# @parameter timer [Boolean] Whether to apply the outgoing slide's timer action before notifying listeners.
+		# @returns [Boolean] Whether the destination index was valid.
+		def go_to(index, timer: false)
+			return false if index < 0 || index >= slide_count
 			
+			advance_timer! if timer
 			@current_index = index
 			notify_listeners!
+			return true
 		end
 		
-		# Advance to the next slide.
-		def advance!
-			go_to(@current_index + 1)
+		# Advance to the next slide, applying the current slide's timer action.
+		# Timer actions only run when there is a next slide.
+		# @parameter timer [Boolean] Whether to apply the outgoing slide's timer action.
+		# @returns [Boolean] Whether the presentation advanced to the next slide.
+		def advance!(timer: true)
+			go_to(@current_index + 1, timer: timer)
 		end
 		
 		# Go back to the previous slide.
+		# @returns [Boolean] Whether the presentation moved to the previous slide.
 		def retreat!
 			go_to(@current_index - 1)
 		end
@@ -180,6 +194,18 @@ module Presently
 		
 		private
 		
+		# Apply the outgoing slide's timer action without resetting elapsed time.
+		def advance_timer!
+			case current_slide.timer
+			when "start"
+				@clock.start! unless @clock.started?
+			when "pause"
+				@clock.pause!
+			when "resume"
+				@clock.resume! if @clock.started?
+			end
+		end
+		
 		# Notify all registered listeners that the slide has changed, and persist state.
 		def notify_listeners!
 			@state&.save(self)

data/lib/presently/presenter_view.rb

@@ -100,14 +100,14 @@ module Presently
 		# @parameter builder [XRB::Builder] The HTML builder.
 		# @parameter slide [Slide | Nil] The current slide.
 		def render_timing(builder, slide)
-			progress = (@controller.slide_progress * 100).round(1)
+			pacing = @controller.pacing
+			progress = pacing ? (@controller.slide_progress * 100).round(1) : 0.0
 			next_slide = @controller.next_slide
 			builder.tag(:div, class: "timing", style: "--slide-progress: #{progress}%") do
-				pacing = @controller.pacing
 				pacing_class = case pacing
 				when :behind then "behind"
 				when :ahead then "ahead"
-				else "on-time"
+				when :on_time then "on-time"
 				end
 				
 				builder.tag(:div, class: "toolbar timing-info #{pacing_class}") do
@@ -136,17 +136,19 @@ module Presently
 						builder.text("Elapsed: #{format_duration(@controller.clock.elapsed)}")
 					end
 					
-					builder.tag(:span, class: "remaining") do
-						builder.text("Remaining: #{format_duration(@controller.time_remaining)}")
-					end
-					
-					builder.tag(:span, class: "pacing-indicator") do
-						indicator = case pacing
-						when :behind then "⏩ Speed up"
-						when :ahead then "⏪ Slow down"
-						else "✓ On time"
+					if pacing
+						builder.tag(:span, class: "remaining") do
+							builder.text("Remaining: #{format_duration(@controller.time_remaining)}")
+						end
+						
+						builder.tag(:span, class: "pacing-indicator") do
+							indicator = case pacing
+							when :behind then "⏩ Speed up"
+							when :ahead then "⏪ Slow down"
+							else "✓ On time"
+							end
+							builder.text(indicator)
 						end
-						builder.text(indicator)
 					end
 					
 					if slide

data/lib/presently/recorder_view.rb

@@ -49,7 +49,7 @@ module Presently
 		def handle(event)
 			case event.dig(:detail, :action)
 			when "next"
-				@controller.advance!
+				@controller.advance!(timer: false)
 			when "previous"
 				@controller.retreat!
 			when "reload"

data/lib/presently/slide.rb

@@ -349,9 +349,23 @@ module Presently
 		end
 		
 		# The expected duration of this slide in seconds.
-		# @returns [Integer] The duration from front_matter, or `60`.
+		# Negative, invalid, or non-finite values are treated as zero.
+		# @returns [Float] A finite duration of at least `0.0`, defaulting to `0.0` when unspecified or null.
 		def duration
-			@front_matter&.fetch("duration", 60) || 60
+			if value = @front_matter&.fetch("duration", nil)
+				duration = Float(value, exception: false)
+				if duration&.finite?
+					return duration.clamp(0.0, nil)
+				end
+			end
+			
+			return 0.0
+		end
+		
+		# The timer action to apply when advancing from this slide.
+		# @returns [String | Nil] `"start"`, `"pause"`, `"resume"`, or `nil` when unspecified.
+		def timer
+			@front_matter&.fetch("timer", nil)
 		end
 		
 		# Update the expected duration in the slide's YAML front matter.

data/lib/presently/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module Presently
-	VERSION = "0.25.0"
+	VERSION = "0.26.0"
 end

data/public/_static/index.css

@@ -24,6 +24,10 @@ html, body {
 	overflow: hidden;
 }
 
+a {
+	color: var(--accent-light);
+}
+
 /* ========================
    SHARED INTERFACE COMPONENTS
    ======================== */

data/readme.md

@@ -67,6 +67,13 @@ The task records the presentation at 1920×1080 and 30 frames per second by defa
 
 Please see the [project releases](https://socketry.github.io/presently/releases/index) for all releases.
 
+### v0.26.0
+
+  - Add `timer: start`, `timer: pause`, and `timer: resume` slide metadata, applied when advancing away from a slide in the presenter or display.
+  - Normalize slide durations to finite, non-negative floating-point seconds. Missing or invalid durations now default to `0.0`, and negative durations are clamped to zero. Presentations relying on the previous 60-second default should set explicit durations.
+  - Handle zero-duration slide progress and hide pacing indicators, progress, and remaining-time estimates when a presentation has no allocated duration.
+  - Keep recorder navigation from changing the presentation timer.
+
 ### v0.24.1
 
   - Use legible, customizable link colors on the default dark slide background.
@@ -117,11 +124,6 @@ Please see the [project releases](https://socketry.github.io/presently/releases/
 
   - Fix slide rendering events for generated view identifiers that begin with a digit.
 
-### v0.17.1
-
-  - Add slide-scoped resource cleanup with `Slide#defer`, `Slide#signal`, and idempotent `Slide#dispose`. Existing tracked timeouts now use the same disposal lifecycle.
-  - [Web Packages](https://socketry.github.io/presently/releases/index#web-packages)
-
 ## See Also
 
   - [lively](https://github.com/socketry/lively) — The real-time application framework that powers Presently.

data/releases.md

@@ -1,5 +1,12 @@
 # Releases
 
+## v0.26.0
+
+  - Add `timer: start`, `timer: pause`, and `timer: resume` slide metadata, applied when advancing away from a slide in the presenter or display.
+  - Normalize slide durations to finite, non-negative floating-point seconds. Missing or invalid durations now default to `0.0`, and negative durations are clamped to zero. Presentations relying on the previous 60-second default should set explicit durations.
+  - Handle zero-duration slide progress and hide pacing indicators, progress, and remaining-time estimates when a presentation has no allocated duration.
+  - Keep recorder navigation from changing the presentation timer.
+
 ## v0.24.1
 
   - Use legible, customizable link colors on the default dark slide background.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: presently
 version: !ruby/object:Gem::Version
-  version: 0.25.0
+  version: 0.26.0
 platform: ruby
 authors:
 - Samuel Williams