presently 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e8ef82aede27b4db4d147618230f5138e0ed0e1d09b3db25e1f42a82e4b6d5f
-  data.tar.gz: 672e37fb2a6d0c8e098feaf2e9e2cf4c46818688f56593b3bf6bec4b1b60121a
+  metadata.gz: '058a674f7402cbe385bfb6db06e28f84b3bbbc0cb352512b00b1ca56f2a046ad'
+  data.tar.gz: 41568d05c2ade4e9a3611a750dba065c1c6217830d3d99b9703adaf621cdc9d0
 SHA512:
-  metadata.gz: d68b6edccc103dab053927144fc2c5e9ebed7e9ca94c3fb45a827e87861cb5d7b2521e676e63e03df0943925fbedbba45c0f235339bef0905090dfd43e740e5f
-  data.tar.gz: 36c1daa240c0d6f8c1260525952922652b34538077b7deb64929eb08dd7ac1debd75abcb98eb00d62f59af3b6637bddfa2c5bb4b4666e511c3c859657b7d71df
+  metadata.gz: 2b0b6ab7a6a2db77db8ddddcb72c3afa1dcf7b94a8cbc8ff70caa2bcb4c4fca354f3549ef1065eae6a80ec2a427348125eb79e65bddc7f53d15fd9f842bd1054
+  data.tar.gz: 01d217946531862c5e735587a4f9463bd0fcb157c3c4b6adc2fca3054fcf6181a9a38b23736abed0022da1b4bcfc80424c9791e7a4938e7de957a349310b70e4

data/lib/presently/version.rb

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

data/public/slide.js

@@ -154,22 +154,53 @@ 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;
 	}
 
+	// 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.
@@ -202,15 +233,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,11 @@ 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.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.

data/releases.md

@@ -1,5 +1,10 @@
 # Releases
 
+## 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.10.0
 platform: ruby
 authors:
 - Samuel Williams

metadata.gz.sig

@@ -1,2 +1,2 @@
-��{��)�����D���z���Om԰v?0�B8�6����+t+,M�Q}91�?ׄ8j�}5*2X�&R?��9i�/7�kiϔ�	�j͞{'v%��;�{b����&t��}ޔ�ݾ��n2���E�N/�)�r�}d4���v6?�
yI��,,�y�;��l�PB ��m�
-���}	��[�!>��w��
�W�=�=����!�ʨ�1L��&)���ؖ\Q8lEbm��|�����6��r�ī��KQܦ��]��}�
+6Iq�r=+�q�	����:\��v��~�Z2W{�G�
+��>Y��W����i��n��|�ᣕmV��%��¡���4�ޖY���i���M�K�oμ�_@~��S�lo�l���)�V>�uv�Rt�	��\ˉ3�o�P%0Ѐ�`�߁�g�O޿齎O�Pi��P	��δE��H����-�#�(���pqnlK�YSK��B��Mϵ}sVa�Ŝ��Xh�b	��RΘ�n_Y�a)뮃���/kȫ���5h)d��? Qmx�R���f@���@d�gL�j!����lM��6	aX��>�L���@�q�4�')��{m���f�7<f�[ �bX}���[���n��b���S�^�^ed�