presently 0.14.1 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de6eb2668cd67cd34eb8f02c51dce3bc3f823f71b8e553835d27c2476d3f793e
-  data.tar.gz: 37601886d71cc24f89510ed65d918dbb87bcd1de1d0c48718f96b15820790e23
+  metadata.gz: 3c2eaa843e93a1ef3f3c97b0e89c80a3ee4484ddbee4c105ca39bc7c324671ea
+  data.tar.gz: bc27aa664ca531b38da8b807e3fcb438a41c4338a180c1ddd39fc1daa0c549ed
 SHA512:
-  metadata.gz: 5d272168a8f3de208c69e56fb44083c2417987d5178afc6e021f9ae4c9c2ddd5985f3251637581e21aea109e9698778c147865baece48bd8a6cb7dd652c7c888
-  data.tar.gz: 1d30ea352a266fcf97def9fdba931adb9cec25933f74bebbac85ecb53e35ceaee46c2faebdcbde473bb853c2959e135a6a2b0b5309eaff91646a632f50ddc043
+  metadata.gz: 98959ac207c29fa8a4bf444e0d1e476e584183615d04abed09c8f74cda3a338ed61f9517f67d5e7e5bb40aa624c352100bf1c2f36c61663a81f61ec509fe52d8
+  data.tar.gz: 30ca2a30e72d1f0c0dbc71b31786349ecd8d8c70eae5d69f29e701e77cd2f39487909a71a4699b2be9b70169cc170065313da35e46394ab92d0b378f3849e38a

data/bake/presently/export.rb

@@ -50,12 +50,15 @@ def pdf(output: "presentation.pdf", slides_root: "slides", notes: true, speaker:
 		begin
 			environment = Async::Service::Environment.build(
 				Presently::Environment::Application,
-				root: context.root,
-				slides_root: File.expand_path(slides_root, context.root),
+				root: Dir.pwd,
+				slides_root: slides_root,
 				endpoint: Async::HTTP::Endpoint.parse("http://localhost", bound_endpoint)
 			)
 			
-			evaluator = environment.evaluator
+			# PDF export always requires an HTTP server, regardless of the configured
+			# Lively transport:
+			transport = environment.with(environment.evaluator.http_environment)
+			evaluator = transport.evaluator
 			server = evaluator.make_server(evaluator.endpoint)
 			server_task = task.async{server.run}
 			

data/bake/presently/rehearse.rb

@@ -21,8 +21,8 @@ end
 #
 # @parameter slides_root [String] The slides directory. Default: `slides`.
 # @parameter speaker [String | Nil] Only rehearse slides for this speaker.
-# @parameter from [String | Nil] Substring match — start at the first slide whose filename contains this.
-# @parameter to [String | Nil] Substring match — stop after the first slide whose filename contains this.
+# @parameter from [String | Nil] Substring match — start at the first slide whose relative path contains this.
+# @parameter to [String | Nil] Substring match — stop after the first slide whose relative path contains this.
 # @parameter resume [Boolean] Resume from the slide after the last one recorded in the log. Keeps prior records and appends new ones.
 # @parameter log [String] Path to write the JSON log. Default: `tmp/rehearsal.json`.
 def rehearse(slides_root: "slides", speaker: nil, from: nil, to: nil, resume: false, log: "tmp/rehearsal.json")
@@ -31,12 +31,12 @@ def rehearse(slides_root: "slides", speaker: nil, from: nil, to: nil, resume: fa
 	slides = slides.select{|slide| slide.speaker == speaker} if speaker
 	
 	if from
-		start_index = slides.index{|slide| File.basename(slide.path).include?(from)}
+		start_index = slides.index{|slide| slide.path.include?(from)}
 		slides = slides[start_index..] if start_index
 	end
 	
 	if to
-		end_index = slides.index{|slide| File.basename(slide.path).include?(to)}
+		end_index = slides.index{|slide| slide.path.include?(to)}
 		slides = slides[..end_index] if end_index
 	end
 	
@@ -49,7 +49,7 @@ def rehearse(slides_root: "slides", speaker: nil, from: nil, to: nil, resume: fa
 		
 		prior_records = JSON.parse(File.read(log), symbolize_names: true)
 		last_path = prior_records.last&.dig(:path)
-		resume_index = slides.index{|slide| File.basename(slide.path) == last_path}
+		resume_index = slides.index{|slide| slide.path == last_path}
 		
 		if resume_index.nil?
 			puts "Last rehearsed slide (#{last_path}) not found in current slide set. Nothing to resume."
@@ -81,14 +81,14 @@ def rehearse(slides_root: "slides", speaker: nil, from: nil, to: nil, resume: fa
 	records = []
 	offset = prior_records.length
 	slides.each_with_index do |slide, index|
-		basename = File.basename(slide.path)
+		relative_path = slide.path
 		headline = extract_headline(slide)
 		absolute = offset + index + 1
 		total = offset + slides.length
 		
 		puts
 		puts "─" * 72
-		puts "[#{absolute}/#{total}] #{basename}  planned: #{format_duration(slide.duration)}  speaker: #{slide.speaker || "—"}"
+		puts "[#{absolute}/#{total}] #{relative_path}  planned: #{format_duration(slide.duration)}  speaker: #{slide.speaker || "—"}"
 		puts "  #{headline}" unless headline.empty?
 		if slide.notes
 			notes = slide.notes.to_commonmark.strip
@@ -105,7 +105,7 @@ def rehearse(slides_root: "slides", speaker: nil, from: nil, to: nil, resume: fa
 		
 		records << {
 			index: absolute,
-			path: basename,
+			path: relative_path,
 			speaker: slide.speaker,
 			planned: slide.duration,
 			actual: elapsed.round(1),

data/bake/presently/slides.rb

@@ -58,7 +58,7 @@ def speakers(slides_root: "slides")
 		puts "#{speaker} — #{format_duration(total_seconds)}"
 		
 		slides.each do |slide|
-			puts "  #{format_duration(slide.duration)}  #{slide.title}  (#{File.basename(slide.path)})"
+			puts "  #{format_duration(slide.duration)}  #{slide.title}  (#{slide.path})"
 		end
 		
 		puts
@@ -69,9 +69,10 @@ end
 
 # Renumber slide files sequentially with a consistent step size.
 #
-# Renames all `.md` files in the slides directory to have sequential
+# Renames all `.md` files directly in the given directory to have sequential
 # numeric prefixes (010, 020, 030, ...), preserving their current order.
-# The descriptive part of the filename (after the number prefix) is kept.
+# The descriptive part of the filename (after the number prefix) is kept. It
+# does not recurse; pass a nested directory as `slides_root` to renumber it.
 #
 # @parameter slides_root [String] The slides directory. Default: `slides`.
 # @parameter step [Integer] The step between slide numbers. Default: `10`.

data/context/animating-slides.md

@@ -1,14 +1,6 @@
 # Animating Slides
 
-This guide explains how to animate content within slides using the `morph` transition and the slide scripting system.
-
-## How Morph Works
-
-The `morph` transition uses the browser's View Transitions API. When navigating between two slides, any element that has a `view-transition-name` style on both the old and new slide is matched — the browser captures its position and appearance in both states and animates between them.
-
-Elements without a matching name crossfade. The slide background stays completely still (no container animation).
-
-This is the mechanism that makes build sequences possible: the same element appears on consecutive slides with the same name, so it stays pinned in place while hidden elements appear around it.
+This guide explains how to animate content within slides using the slide scripting system.
 
 ## Slide Scripts
 
@@ -18,7 +10,6 @@ Any slide can include a JavaScript block at the end of its presenter notes secti
 ---
 template: default
 duration: 30
-transition: morph
 ---
 
 - First point
@@ -30,7 +21,7 @@ transition: morph
 Your presenter notes here.
 
 ```javascript
-slide.find("li").show(1, {group: "bullet"})
+slide.find("li").show(1)
 ```
 ~~~
 
@@ -52,7 +43,7 @@ slide.find(".callout")     // elements with a specific class
 
 ### `elements.show(n, options)`
 
-Shows the first `n` elements in the collection and hides the rest. Assigns `view-transition-name` to each element so the morph transition can match them across consecutive slides. Returns a `Promise` that resolves when any reveal animation completes.
+Shows the first `n` elements in the collection and hides the rest. Returns a `Promise` that resolves when any reveal animation completes.
 
 ``` javascript
 slide.find("li").show(0)  // all hidden
@@ -64,7 +55,6 @@ Options:
 
 | Option | Description |
 |---|---|
-| `group` | Name prefix for `view-transition-name` — must be consistent across slides for morph to match elements. Defaults to `"build"`. |
 | `effect` | Entry animation for the newly revealed element. See effects below. |
 
 ### `elements.builder(options)`
@@ -72,7 +62,7 @@ Options:
 Creates a `SlideBuilder` with default options and a cached position. Use this instead of calling `show()` manually when you want to reveal elements one at a time from a script.
 
 ``` javascript
-const bullets = slide.find("li").builder({group: "bullet", effect: "fly-up"})
+const bullets = slide.find("li").builder({effect: "fly-up"})
 bullets.show(0)       // hide all initially
 bullets.next()        // reveal first, plays fly-up
 bullets.next()        // reveal second, plays fly-up
@@ -115,7 +105,7 @@ A build sequence is a series of consecutive slides with the same content, each r
 ---
 template: default
 duration: 20
-transition: morph
+transition: fade
 ---
 
 - Real-time synchronization
@@ -127,7 +117,7 @@ transition: morph
 Let's walk through the key features.
 
 ```javascript
-slide.find("li").show(0, {group: "bullet"})
+slide.find("li").show(0)
 ```
 ~~~
 
@@ -136,7 +126,7 @@ slide.find("li").show(0, {group: "bullet"})
 ---
 template: default
 duration: 20
-transition: morph
+transition: fade
 ---
 
 - Real-time synchronization
@@ -148,12 +138,10 @@ transition: morph
 The display and presenter stay in sync over a WebSocket connection.
 
 ```javascript
-slide.find("li").show(1, {group: "bullet"})
+slide.find("li").show(1)
 ```
 ~~~
 
-The `group` option must be identical across all slides in the sequence so the browser matches the same elements. Without it, each slide uses the default `"build"` prefix — which is fine as long as only one build sequence is active per slide.
-
 Because all elements are in the DOM from the start (just hidden), the vertical layout stays consistent throughout the sequence — there is no shift as elements appear.
 
 ## Build Effects
@@ -161,7 +149,7 @@ Because all elements are in the DOM from the start (just hidden), the vertical l
 Pass an `effect` option to animate the newly revealed element as it appears. The effect plays as a CSS animation on the element and is removed automatically once it completes.
 
 ``` javascript
-slide.find("li").show(2, {group: "bullet", effect: "fly-up"})
+slide.find("li").show(2, {effect: "fly-up"})
 ```
 
 Available effects:
@@ -181,8 +169,8 @@ A slide can have multiple independent build groups. Each `find().show()` call is
 
 ``` javascript
 // Reveal list items as one group, callout div as another
-slide.find("li").show(3, {group: "bullet"})
-slide.find(".callout").show(1, {group: "callout", effect: "fly-up"})
+slide.find("li").show(3)
+slide.find(".callout").show(1, {effect: "fly-up"})
 ```
 
 ## In-Slide Animation with `slide.after()`
@@ -190,8 +178,8 @@ slide.find(".callout").show(1, {group: "callout", effect: "fly-up"})
 For sequential reveals within a single slide (without navigating to the next slide), use `slide.after()`. Each step fires a delay in milliseconds relative to the previous step. Returns a `SlideContext` so subsequent `.after()` calls chain naturally.
 
 ``` javascript
-const panes = slide.find(".pane").builder({group: "pane", effect: "fade"})
-const items = slide.find(".item").builder({group: "item", effect: "fly-up"})
+const panes = slide.find(".pane").builder({effect: "fade"})
+const items = slide.find(".item").builder({effect: "fly-up"})
 panes.show(0)
 items.show(0)
 

data/context/getting-started.md

@@ -32,7 +32,27 @@ $ mkdir slides
 
 ### Writing Slides
 
-Each slide is a Markdown file in the `slides/` directory. Files are ordered alphabetically, so prefix them with numbers:
+Each slide is a Markdown file in the `slides/` directory. Files are ordered by path, and every directory and slide filename must begin with a numeric prefix:
+
+``` text
+slides/
+├── 010-welcome.md
+├── 020-performance/
+│   ├── 010-introduction.md
+│   └── 020-results.md
+└── 030-conclusion.md
+```
+
+This allows related slides to be grouped in nested directories while retaining an unambiguous presentation order. Markdown files with any unnumbered path component, such as `slides/shared/example.md`, are not treated as slides and can be used for included content.
+
+The `presently:slides:renumber` task only renumbers files directly inside the selected directory. Run it without arguments for the top-level slides, or pass a nested directory explicitly:
+
+``` shell
+$ bake presently:slides:renumber
+$ bake presently:slides:renumber slides_root=slides/020-performance
+```
+
+A slide file contains Markdown with optional frontmatter and presenter notes:
 
 ``` markdown
 ---
@@ -263,9 +283,6 @@ Available transitions:
 | `fade` | Crossfade between slides |
 | `slide-left` | Current slide exits left, next enters from right |
 | `slide-right` | Current slide exits right, next enters from left |
-| `morph` | Matched elements animate between positions; everything else crossfades |
-
-The `morph` transition uses the browser's View Transitions API to smoothly animate individual elements between slides. Elements with the same `view-transition-name` across two consecutive slides are matched and interpolated.
 
 ## Presenter Notes
 

data/context/index.yaml

@@ -13,4 +13,4 @@ files:
 - path: animating-slides.md
   title: Animating Slides
   description: This guide explains how to animate content within slides using the
-    `morph` transition and the slide scripting system.
+    slide scripting system.

data/lib/presently/application.rb

@@ -49,7 +49,7 @@ module Presently
 		def controller
 			@controller ||= begin
 				templates = Templates.for(@templates_roots)
-				presentation = Presentation.load(@slides_root, templates: templates)
+				presentation = Presentation.load(@slides_root, templates)
 				
 				PresentationController.new(presentation, state: State.new)
 			end
@@ -81,7 +81,7 @@ module Presently
 			
 			if path == "/export"
 				options = Export.options_from_query(query)
-				presentation = Presentation.load(@slides_root, templates: controller.templates)
+				presentation = Presentation.load(@slides_root, controller.templates)
 				export = Export.new(presentation: presentation, **options)
 				return Protocol::HTTP::Response[200, [["content-type", "text/html"]], [export.call]]
 			end

data/lib/presently/export.rb

@@ -20,8 +20,16 @@ module Presently
 		PageSize = Struct.new(:slide_width_px, :slide_height_px, :notes_height_px, keyword_init: true) do
 			PX_PER_CM = 96.0 / 2.54
 			
+			# Convert the slide width from CSS pixels to centimetres.
+			# @returns [Float] The slide width in centimetres.
 			def slide_width_cm  = (slide_width_px  / PX_PER_CM).round(4)
+			
+			# Convert the slide height from CSS pixels to centimetres.
+			# @returns [Float] The slide height in centimetres.
 			def slide_height_cm = (slide_height_px / PX_PER_CM).round(4)
+			
+			# Convert the notes panel height from CSS pixels to centimetres.
+			# @returns [Float] The notes panel height in centimetres.
 			def notes_height_cm = (notes_height_px / PX_PER_CM).round(4)
 		end
 		
@@ -98,7 +106,7 @@ module Presently
 				end
 				
 				builder.tag(:span, class: "export-filename") do
-					builder.tag(:code){builder.text(File.basename(slide.path))}
+					builder.tag(:code){builder.text(slide.path)}
 				end
 				
 				if @timing

data/lib/presently/presentation.rb

@@ -9,40 +9,33 @@ require_relative "templates"
 module Presently
 	# An immutable collection of slides with configuration.
 	#
-	# Use {.load} to create a presentation from a directory of Markdown files,
-	# or initialize directly with an array of {Slide} instances.
+	# Use {.load} to create a presentation from a directory of Markdown files.
+	# Each loaded {Slide} is attached to its presentation and identified by a
+	# path relative to the presentation root.
 	class Presentation
-		# Load and sort slide files from a directory.
-		# @parameter slides_root [String] The directory containing `.md` slide files.
-		# @returns [Array(Slide)] The loaded, sorted, non-skipped slides.
-		def self.slides_from(slides_root)
-			Dir.glob(File.join(slides_root, "*.md")).sort.map{|path| Slide.load(path)}.reject(&:skip?)
-		end
-		
 		# Load a presentation from a directory of Markdown slide files.
-		# @parameter slides_root [String] The directory containing `.md` slide files.
-		# @parameter options [Hash] Additional options passed to {#initialize}.
+		# @parameter root [String] The directory containing `.md` slide files.
+		# @parameter templates [Templates] The template resolver for loading slide templates.
 		# @returns [Presentation] A new presentation with slides loaded from the directory.
-		def self.load(slides_root = "slides", **options)
-			new(slides_from(slides_root), slides_root: slides_root, **options)
+		def self.load(root = "slides", templates = Templates.for)
+			new(root, templates)
 		end
 		
 		# Initialize a new presentation.
-		# @parameter slides [Array(Slide)] The ordered list of slides.
-		# @parameter slides_root [String | Nil] The directory slides were loaded from, used by {#reload}.
+		# @parameter root [String] The root directory containing slide files.
 		# @parameter templates [Templates] The template resolver for loading slide templates.
-		def initialize(slides = [], slides_root: nil, templates: Templates.for)
-			@slides = slides
-			@slides_root = slides_root
+		def initialize(root = "slides", templates = Templates.for)
+			@root = File.expand_path(root)
 			@templates = templates
+			@slides = load_slides
 		end
 		
+		# @attribute [String] The absolute root directory containing slide files.
+		attr :root
+		
 		# @attribute [Array(Slide)] The ordered list of slides.
 		attr :slides
 		
-		# @attribute [String | Nil] The directory slides were loaded from.
-		attr :slides_root
-		
 		# @attribute [Templates] The template resolver.
 		attr :templates
 		
@@ -66,12 +59,23 @@ module Presently
 		end
 		
 		# Return a new {Presentation} with freshly loaded slides and a cleared template cache.
-		# Only works if the presentation was created with {.load}.
-		# @returns [Presentation] A new presentation instance, or `self` if no slides root is set.
+		# @returns [Presentation] A new presentation instance.
 		def reload
-			return self unless @slides_root
-			
-			self.class.new(self.class.slides_from(@slides_root), slides_root: @slides_root, templates: @templates.reload)
+			self.class.new(@root, @templates.reload)
+		end
+		
+		private
+		
+		# Load slides recursively in relative path order.
+		# @returns [Array(Slide)] The loaded, sorted, non-skipped slides.
+		def load_slides
+			Dir.glob("**/*.md", base: @root).sort.filter_map do |path|
+				components = path.split(File::SEPARATOR)
+				next unless components.all?{|component| component.match?(/\A\d/)}
+				
+				slide = Slide.load(self, path)
+				slide unless slide.skip?
+			end
 		end
 	end
 end

data/lib/presently/presenter_view.rb

@@ -204,10 +204,10 @@ module Presently
 						if slide
 							builder.text(" · ")
 							builder.tag(:code, class: "slide-path") do
-								builder.text(File.basename(slide.path))
+								builder.text(slide.path)
 							end
 							
-							if editor_url = editor_url_for(slide.path)
+							if editor_url = editor_url_for(slide.source_path)
 								builder.tag(:a, href: editor_url, class: "edit-link") do
 									builder.text("✎")
 								end

data/lib/presently/slide.rb

@@ -61,15 +61,17 @@ module Presently
 			module_function
 			
 			# Parse the file and return a {Slide}.
-			# @parameter path [String] The file path to parse.
+			# @parameter presentation [Presentation] The presentation which owns the slide.
+			# @parameter path [String] The slide path relative to the presentation root.
 			# @returns [Slide]
-			def load(path)
-				raw = File.read(path)
+			def load(presentation, path)
+				source_path = File.join(presentation.root, path)
+				raw = File.read(source_path)
 				
 				# Parse once, with native front matter support.
 				document = Markly.parse(raw, flags: Markly::UNSAFE | Markly::FRONT_MATTER, extensions: Fragment::EXTENSIONS)
 				
-				expand_includes!(document, File.dirname(path))
+				expand_includes!(document, File.dirname(source_path))
 				
 				# Extract front matter from the first AST node if present.
 				front_matter = nil
@@ -111,7 +113,7 @@ module Presently
 					script = nil
 				end
 				
-				Slide.new(path, front_matter: front_matter, content: content, notes: notes, script: script)
+				Slide.new(presentation, path, front_matter: front_matter, content: content, notes: notes, script: script)
 			end
 			
 			# Expand `![[path/to/file.md]]` include directives in a parsed document.
@@ -183,19 +185,22 @@ module Presently
 		end
 		
 		# Load and parse a slide from a Markdown file.
-		# @parameter path [String] The file path to the Markdown slide.
+		# @parameter presentation [Presentation] The presentation which owns the slide.
+		# @parameter path [String] The slide path relative to the presentation root.
 		# @returns [Slide]
-		def self.load(path)
-			Parser.load(path)
+		def self.load(presentation, path)
+			Parser.load(presentation, path)
 		end
 		
 		# Initialize a slide with pre-parsed data.
-		# @parameter path [String] The file path of the slide.
+		# @parameter presentation [Presentation] The presentation which owns the slide.
+		# @parameter path [String] The slide path relative to the presentation root.
 		# @parameter front_matter [Hash | Nil] The parsed YAML front_matter.
 		# @parameter content [Hash(String, Fragment)] Content sections keyed by heading name.
 		# @parameter notes [Fragment | Nil] The presenter notes as a Markly AST fragment.
 		# @parameter script [String | Nil] JavaScript to execute after the slide renders.
-		def initialize(path, front_matter: nil, content: {}, notes: nil, script: nil)
+		def initialize(presentation, path, front_matter: nil, content: {}, notes: nil, script: nil)
+			@presentation = presentation
 			@path = path
 			@front_matter = front_matter
 			@content = content
@@ -203,9 +208,18 @@ module Presently
 			@script = script
 		end
 		
-		# @attribute [String] The file path of the slide.
+		# @attribute [Presentation] The presentation which owns the slide.
+		attr :presentation
+		
+		# @attribute [String] The slide path relative to the presentation root.
 		attr :path
 		
+		# The absolute path of the slide source file.
+		# @returns [String]
+		def source_path
+			File.join(@presentation.root, @path)
+		end
+		
 		# @attribute [Hash | Nil] The parsed YAML front_matter.
 		attr :front_matter
 		
@@ -249,7 +263,7 @@ module Presently
 		end
 		
 		# The transition type for animating into this slide.
-		# @returns [String | Nil] The transition name (e.g. `"fade"`, `"slide-left"`, `"morph"`), or `nil` for instant swap.
+		# @returns [String | Nil] The transition name (e.g. `"fade"`, `"slide-left"`, `"slide-right"`), or `nil` for instant swap.
 		def transition
 			@front_matter&.fetch("transition", nil)
 		end

data/lib/presently/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module Presently
-	VERSION = "0.14.1"
+	VERSION = "0.16.0"
 end

data/public/_static/index.css

@@ -364,18 +364,6 @@ html[data-transition="slide-right"]::view-transition-new(slide-container) {
 	animation: vt-slide-in-left 0.4s ease-in-out;
 }
 
-/* Magic move — the browser interpolates position/size for matched
-   view-transition-name elements. No cross-fade on the container
-   to avoid background dimming. */
-html[data-transition="morph"]::view-transition-old(slide-container) {
-	animation: none;
-	opacity: 0;
-}
-
-html[data-transition="morph"]::view-transition-new(slide-container) {
-	animation: none;
-}
-
 @keyframes vt-fade-out {
 	from { opacity: 1; }
 	to { opacity: 0; }
@@ -410,13 +398,6 @@ html[data-transition="morph"]::view-transition-new(slide-container) {
    BUILD EFFECTS
    ======================== */
 
-/* Suppress both pseudo-elements for hidden build elements so they
-   neither crossfade in nor crossfade out during the transition. */
-::view-transition-old(.build-hidden),
-::view-transition-new(.build-hidden) {
-	display: none;
-}
-
 /* Fade */
 .build-fade {
 	animation: vt-fade-in 0.4s ease;

data/public/slide.js

@@ -3,7 +3,6 @@
 // instead of tracking count manually. Created via SlideElements#builder(options).
 export class SlideBuilder {
 	#elements;
-	#prefix;
 	#defaultEffect;
 	#slide;
 	#step = 0;
@@ -11,7 +10,6 @@ export class SlideBuilder {
 	constructor(slide, elements, options = {}) {
 		this.#slide = slide;
 		this.#elements = elements;
-		this.#prefix = options.group || 'build';
 		this.#defaultEffect = options.effect || null;
 	}
 
@@ -26,16 +24,8 @@ export class SlideBuilder {
 		let revealedElement = null;
 
 		this.#elements.forEach((element, index) => {
-			// Only assign a group name if the element doesn't already have an explicit one.
-			// Preserving explicit names allows elements to participate in morph transitions
-			// to other slides while still being managed by the build system.
-			if (!element.style.viewTransitionName || element.style.viewTransitionName === 'none') {
-				element.style.viewTransitionName = `${this.#prefix}-${index + 1}`;
-			}
-
 			if (index < count) {
 				element.style.visibility = 'visible';
-				element.style.viewTransitionClass = '';
 
 				if (index === count - 1 && effect) {
 					element.classList.add(`build-${effect}`);
@@ -43,9 +33,6 @@ export class SlideBuilder {
 				}
 			} else {
 				element.style.visibility = 'hidden';
-				// Keep viewTransitionClass set so morph transitions can suppress
-				// crossfading on hidden elements when called inside startViewTransition.
-				element.style.viewTransitionClass = 'build-hidden';
 			}
 		});
 
@@ -75,11 +62,7 @@ export class SlideBuilder {
 		const effect = this.#slide.animated ? (overrides.effect !== undefined ? overrides.effect : this.#defaultEffect) : null;
 		const element = this.#elements[this.#step];
 
-		if (!element.style.viewTransitionName || element.style.viewTransitionName === 'none') {
-			element.style.viewTransitionName = `${this.#prefix}-${this.#step + 1}`;
-		}
 		element.style.visibility = 'visible';
-		element.style.viewTransitionClass = '';
 
 		this.#step += 1;
 
@@ -141,7 +124,6 @@ export class SlideElements {
 
 	// Create a stateful SlideBuilder for this element collection with default options.
 	// @parameter options [Object] Default options applied to every show() / next() call.
-	//   group: prefix for view-transition-name (default: "build")
 	//   effect: "fade", "fly-up", "fly-down", "fly-left", "fly-right", "scale"
 	// @returns [SlideBuilder]
 	builder(options = {}) {
@@ -152,7 +134,6 @@ export class SlideElements {
 	// Delegates to SlideBuilder for the actual implementation.
 	// @parameter count [Integer] Number of elements to show.
 	// @parameter options [Object]
-	//   group: prefix for view-transition-name (default: "build")
 	//   effect: "fade", "fly-up", "fly-down", "fly-left", "fly-right", "scale"
 	// @returns [Promise] Resolves when the animation completes (or immediately if no effect).
 	show(count, options = {}) {

data/readme.md

@@ -23,12 +23,23 @@ Please see the [project documentation](https://socketry.github.io/presently/) fo
 
   - [Getting Started](https://socketry.github.io/presently/guides/getting-started/index) - This guide explains how to use `presently` to create and deliver web-based presentations using Markdown slides.
 
-  - [Animating Slides](https://socketry.github.io/presently/guides/animating-slides/index) - This guide explains how to animate content within slides using the `morph` transition and the slide scripting system.
+  - [Animating Slides](https://socketry.github.io/presently/guides/animating-slides/index) - This guide explains how to animate content within slides using the slide scripting system.
 
 ## Releases
 
 Please see the [project releases](https://socketry.github.io/presently/releases/index) for all releases.
 
+### v0.16.0
+
+  - Add support for organizing slides in nested directories. Every directory and slide filename must begin with a numeric prefix, and slides are ordered by relative path.
+
+### v0.15.0
+
+q
+
+  - Export works from current working directory.
+      - Remove explicit support for `morph` transition.
+
 ### v0.14.0
 
   - Increase code font size by 50%.
@@ -73,14 +84,6 @@ Please see the [project releases](https://socketry.github.io/presently/releases/
   - Add `Slide#setTimeout(callback, delay)` — a tracked replacement for the global `setTimeout`. All timeouts registered this way are automatically cancelled when the slide changes, preventing stale callbacks from firing after navigation. The global `setTimeout` in slide scripts is shadowed by this method automatically.
   - Add `Slide#cancelTimeouts()` — cancels all pending timeouts registered by the slide's script. Called automatically by the presentation engine on every slide change.
 
-### v0.6.0
-
-  - Add `bake presently:slides:speakers` task to print a timing breakdown grouped by speaker. Each speaker's slides are listed in presentation order with individual and total durations, making it easy to balance talk time in multi-speaker presentations. Slides without a `speaker` key are grouped under `(no speaker)`.
-
-### v0.5.0
-
-  - Add optional `speaker` front matter key to slides. When present, the current speaker's name is shown in the timing bar. If the next slide has a different speaker, a handoff indicator (e.g. `→ Next Speaker`) is shown alongside, giving presenters an at-a-glance cue for tag-team talks.
-
 ## See Also
 
   - [lively](https://github.com/socketry/lively) — The real-time application framework that powers Presently.

data/releases.md

@@ -1,5 +1,16 @@
 # Releases
 
+## v0.16.0
+
+  - Add support for organizing slides in nested directories. Every directory and slide filename must begin with a numeric prefix, and slides are ordered by relative path.
+
+## v0.15.0
+
+q
+
+  - Export works from current working directory.
+      - Remove explicit support for `morph` transition.
+
 ## v0.14.0
 
   - Increase code font size by 50%.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: presently
 version: !ruby/object:Gem::Version
-  version: 0.14.1
+  version: 0.16.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.16'
+        version: '0.18'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.16'
+        version: '0.18'
 - !ruby/object:Gem::Dependency
   name: markly
   requirement: !ruby/object:Gem::Requirement
@@ -243,7 +243,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: A web-based presentation tool built with Lively.
 test_files: []