presently 0.9.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e8ef82aede27b4db4d147618230f5138e0ed0e1d09b3db25e1f42a82e4b6d5f
-  data.tar.gz: 672e37fb2a6d0c8e098feaf2e9e2cf4c46818688f56593b3bf6bec4b1b60121a
+  metadata.gz: 4d9c48a214f82231e41cf7466a9cacae0b613d966df0ba2e2ed3ec0a5e770fd6
+  data.tar.gz: 5adf796d7508e530e7bcd29158db6090f48020987e17cf708f788fa2cfeafbcb
 SHA512:
-  metadata.gz: d68b6edccc103dab053927144fc2c5e9ebed7e9ca94c3fb45a827e87861cb5d7b2521e676e63e03df0943925fbedbba45c0f235339bef0905090dfd43e740e5f
-  data.tar.gz: 36c1daa240c0d6f8c1260525952922652b34538077b7deb64929eb08dd7ac1debd75abcb98eb00d62f59af3b6637bddfa2c5bb4b4666e511c3c859657b7d71df
+  metadata.gz: 33dc185804e859fee50a41d7169f12c8c7a0921789c9a561db4d03fb0ac172c51680a41f07e59df01232b9d1221a3cc50587c7731ce987e87ba6c858bb79e552
+  data.tar.gz: a36e22c1b6919eb78795364eb251107913e334b90dc60cdb874b6ca10aef71b6639a51d17c4453893da21cc687882d01649acdc7517ff69692d7c93e32272f1b

data/lib/presently/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module Presently
-	VERSION = "0.9.0"
+	VERSION = "0.11.0"
 end

data/public/slide.js

@@ -154,32 +154,76 @@ export class SlideElements {
 	}
 }
 
-// Returned by Slide#after to enable relative delay chaining.
-// Each .after(delay, callback) fires that many milliseconds after the previous step.
-class SlideChain {
+// Scoped scripting context used both for chaining after() calls and as the
+// argument passed to slide.loop() callbacks. Accumulates elapsed time across
+// after() calls so each delay is relative to the previous step. Delegates
+// find() and setTimeout() to the parent Slide so element queries are scoped
+// correctly and all timeouts are cancelled automatically on slide change.
+export class SlideContext {
 	#slide;
 	#elapsed;
 
-	constructor(slide, elapsed) {
+	constructor(slide, elapsed = 0) {
 		this.#slide = slide;
 		this.#elapsed = elapsed;
 	}
 
+	// The slide body element.
+	// Delegates to the parent Slide.
+	// @returns [HTMLElement]
+	get element() {
+		return this.#slide.element;
+	}
+
+	// Find elements within the slide matching the given CSS selector.
+	// Delegates to the parent Slide.
+	// @parameter selector [String] A CSS selector scoped to the slide body.
+	// @returns [SlideElements]
+	find(selector) {
+		return this.#slide.find(selector);
+	}
+
+	// Tracked setTimeout — delegates to the parent Slide so timeouts are
+	// cancelled automatically when the slide changes.
+	// @parameter callback [Function] The function to call after the delay.
+	// @parameter delay [Number] Delay in milliseconds.
+	// @returns [Number] The timeout ID.
+	setTimeout(callback, delay) {
+		return this.#slide.setTimeout(callback, delay);
+	}
+
+	// Schedule a callback relative to the previous step, accumulating elapsed time.
+	// @parameter delay [Number] Delay in milliseconds after the previous step.
+	// @parameter callback [Function] The function to call.
+	// @returns [SlideContext]
 	after(delay, callback) {
 		this.#elapsed += delay;
 		this.#slide.setTimeout(callback, this.#elapsed);
 		return this;
 	}
+
+	// Total time accumulated across all after() calls.
+	// Used by slide.loop() to know when to schedule the next iteration.
+	// @returns [Number] Elapsed time in milliseconds.
+	get elapsed() {
+		return this.#elapsed;
+	}
 }
 
 // The scripting context passed to each slide's javascript block.
 // Scopes element queries to the slide body.
 export class Slide {
-	#container;
+	#element;
 	#timeouts = [];
 
-	constructor(container) {
-		this.#container = container;
+	constructor(element) {
+		this.#element = element;
+	}
+
+	// The slide body element.
+	// @returns [HTMLElement]
+	get element() {
+		return this.#element;
 	}
 
 	// Find elements within this slide matching the given CSS selector.
@@ -187,7 +231,7 @@ export class Slide {
 	// @parameter selector [String] A CSS selector scoped to the slide body.
 	// @returns [SlideElements]
 	find(selector) {
-		const elements = Array.from(this.#container.querySelectorAll(selector));
+		const elements = Array.from(this.#element.querySelectorAll(selector));
 		return new SlideElements(this, elements);
 	}
 
@@ -202,15 +246,30 @@ export class Slide {
 		return timeoutId;
 	}
 
-	// Schedule a callback after a delay, returning a chainable object so
+	// Schedule a callback after a delay, returning a SlideContext so
 	// subsequent .after(delay) calls are relative to the previous step.
 	// All timeouts are tracked and cancelled automatically on slide change.
-	// @parameter delay [Number] Delay in milliseconds from now (or previous step).
+	// @parameter delay [Number] Delay in milliseconds from now.
 	// @parameter callback [Function] The function to call after the delay.
-	// @returns [SlideChain]
+	// @returns [SlideContext]
 	after(delay, callback) {
 		this.setTimeout(callback, delay);
-		return new SlideChain(this, delay);
+		return new SlideContext(this, delay);
+	}
+
+	// Run a callback in a loop, repeating indefinitely until the slide changes.
+	// The callback receives a SlideContext so it can use after() to schedule
+	// steps within each iteration. The loop waits for all steps to complete
+	// (ctx.elapsed) plus an optional extra delay before starting the next iteration.
+	// @parameter callback [Function] Receives a fresh SlideContext as `context` each iteration.
+	// @parameter delay [Number] Extra pause in milliseconds after the last step before restarting.
+	loop(callback, { delay = 0 } = {}) {
+		const iterate = () => {
+			const context = new SlideContext(this);
+			callback(context);
+			this.setTimeout(iterate, context.elapsed + delay);
+		};
+		iterate();
 	}
 
 	// Cancel all pending timeouts registered by this slide's script.

data/readme.md

@@ -29,6 +29,15 @@ Please see the [project documentation](https://socketry.github.io/presently/) fo
 
 Please see the [project releases](https://socketry.github.io/presently/releases/index) for all releases.
 
+### v0.11.0
+
+  - Add `Slide#element` and `SlideContext#element` getters — expose the slide body DOM element directly for cases where `find()` is not sufficient, such as measuring dimensions, attaching event listeners, or integrating third-party libraries.
+
+### v0.10.0
+
+  - Replace internal `SlideChain` with an exported `SlideContext` class. `SlideContext` accumulates elapsed time across `after()` calls exactly as `SlideChain` did, but also exposes `find()`, `setTimeout()`, and a `get elapsed()` getter. `Slide#after()` now returns a `SlideContext` — existing slide scripts are unaffected.
+  - Add `Slide#loop(callback, {delay})` — runs a callback in a repeating loop until the slide changes. The callback receives a fresh `SlideContext` each iteration so it can schedule steps with `after()`. The loop waits for all steps to complete (`context.elapsed`) plus an optional extra `delay` before starting the next iteration. All timeouts flow through the slide's existing tracked `setTimeout`, so they are cancelled automatically on slide change.
+
 ### v0.9.0
 
   - `SlideBuilder#show` and `SlideBuilder#next` no longer overwrite `view-transition-name` on elements that already have one set. This allows elements with explicit names (for morph transitions to other slides) to coexist with the build system — they still get `visibility` and `viewTransitionClass` managed, but keep their own name.
@@ -81,17 +90,6 @@ Please see the [project releases](https://socketry.github.io/presently/releases/
   - Use the last `---` hrule in the AST as the presenter notes separator, so earlier `---` dividers in slide content are preserved correctly.
   - Add support for Mermaid diagrams in slides.
 
-### v0.1.0
-
-  - Initial release.
-  - Slide files are Markdown with YAML front matter for metadata (`template`, `duration`, `title`, `skip`, `marker`, `transition`, `focus`).
-  - Slide content is split into named sections by top-level headings, rendered to HTML via Markly.
-  - Presenter notes are separated from slide content by a `---` divider.
-  - Magic move transitions between slides.
-  - Navigation control in the presenter view.
-  - Code highlighting with line-range focus support.
-  - Live state synchronisation between display and presenter views over WebSockets.
-
 ## See Also
 
   - [lively](https://github.com/socketry/lively) — The real-time application framework that powers Presently.

data/releases.md

@@ -1,5 +1,14 @@
 # Releases
 
+## v0.11.0
+
+  - Add `Slide#element` and `SlideContext#element` getters — expose the slide body DOM element directly for cases where `find()` is not sufficient, such as measuring dimensions, attaching event listeners, or integrating third-party libraries.
+
+## v0.10.0
+
+  - Replace internal `SlideChain` with an exported `SlideContext` class. `SlideContext` accumulates elapsed time across `after()` calls exactly as `SlideChain` did, but also exposes `find()`, `setTimeout()`, and a `get elapsed()` getter. `Slide#after()` now returns a `SlideContext` — existing slide scripts are unaffected.
+  - Add `Slide#loop(callback, {delay})` — runs a callback in a repeating loop until the slide changes. The callback receives a fresh `SlideContext` each iteration so it can schedule steps with `after()`. The loop waits for all steps to complete (`context.elapsed`) plus an optional extra `delay` before starting the next iteration. All timeouts flow through the slide's existing tracked `setTimeout`, so they are cancelled automatically on slide change.
+
 ## v0.9.0
 
   - `SlideBuilder#show` and `SlideBuilder#next` no longer overwrite `view-transition-name` on elements that already have one set. This allows elements with explicit names (for morph transitions to other slides) to coexist with the build system — they still get `visibility` and `viewTransitionClass` managed, but keep their own name.

metadata

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