presently 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c40fe4b85c67a70eb725de902e792adfcf6adaf5d4136e1dea118078e7072dea
-  data.tar.gz: bdb11f2d20d961f228cde6803b15ff409ab3addf9bdc84225db8bdbf57e7f215
+  metadata.gz: '058a674f7402cbe385bfb6db06e28f84b3bbbc0cb352512b00b1ca56f2a046ad'
+  data.tar.gz: 41568d05c2ade4e9a3611a750dba065c1c6217830d3d99b9703adaf621cdc9d0
 SHA512:
-  metadata.gz: 5c046835b04d5889b429b68752face2a54c3fa6c1e6269b4e15d8a6a2fe7a311f97f61763069de50b2706b9b5d4e45d531555be094d0ba6e1c0b015df8ef7f1a
-  data.tar.gz: 421f940ab54cf1cacda680779cc0065b9530ead96d12bdb2930c1ebf82da8289de551b31f9bd94e0aac929bfddeb306a86d08b17a99e682f6b7e7403018b9313
+  metadata.gz: 2b0b6ab7a6a2db77db8ddddcb72c3afa1dcf7b94a8cbc8ff70caa2bcb4c4fca354f3549ef1065eae6a80ec2a427348125eb79e65bddc7f53d15fd9f842bd1054
+  data.tar.gz: 01d217946531862c5e735587a4f9463bd0fcb157c3c4b6adc2fca3054fcf6181a9a38b23736abed0022da1b4bcfc80424c9791e7a4938e7de957a349310b70e4

data/lib/presently/version.rb

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

data/public/slide.js

@@ -25,7 +25,12 @@ export class SlideBuilder {
 		let revealedElement = null;
 
 		this.#elements.forEach((element, index) => {
-			element.style.viewTransitionName = `${this.#prefix}-${index + 1}`;
+			// 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';
@@ -68,7 +73,9 @@ export class SlideBuilder {
 		const effect = overrides.effect !== undefined ? overrides.effect : this.#defaultEffect;
 		const element = this.#elements[this.#step];
 
-		element.style.viewTransitionName = `${this.#prefix}-${this.#step + 1}`;
+		if (!element.style.viewTransitionName || element.style.viewTransitionName === 'none') {
+			element.style.viewTransitionName = `${this.#prefix}-${this.#step + 1}`;
+		}
 		element.style.visibility = 'visible';
 		element.style.viewTransitionClass = '';
 
@@ -147,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.
@@ -195,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,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.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.
+
 ### v0.8.0
 
   - Add optional `translation` section to the `default` template.

data/releases.md

@@ -1,5 +1,14 @@
 # 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.
+
 ## v0.8.0
 
   - Add optional `translation` section to the `default` template.

metadata

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

metadata.gz.sig

@@ -1 +1,2 @@
-��V�y�ӆ1$�Kw��@I\��J�����\�o�/? ���ȸ�4��h-�v��֟]�
+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�