@oscarpalmer/atoms 0.47.1 → 0.49.0

package/dist/js/index.js

@@ -859,9 +859,9 @@ function isWhen(value) {
   return is3(value, /^when$/) && typeof value.then === "function";
 }
 function repeat(callback, options) {
-  return timer("repeat", callback, options ?? {}).start();
+  return timer("repeat", callback, options ?? {}, true);
 }
-var timer = function(type, callback, partial) {
+var timer = function(type, callback, partial, start) {
   const isRepeated2 = type === "repeat";
   const options = {
     afterCallback: partial.afterCallback,
@@ -872,7 +872,9 @@ var timer = function(type, callback, partial) {
   };
   const state = {
     callback,
-    active: false
+    active: false,
+    minimum: options.interval - options.interval % milliseconds / 2,
+    paused: false
   };
   const instance = Object.create({
     continue() {
@@ -901,31 +903,48 @@ var timer = function(type, callback, partial) {
       get() {
         return state.active;
       }
+    },
+    paused: {
+      get() {
+        return state.paused;
+      }
     }
   });
+  if (start) {
+    instance.start();
+  }
   return instance;
 };
 function wait(callback, options) {
   return timer("wait", callback, options == null || typeof options === "number" ? {
     interval: options
-  } : options).start();
+  } : options, true);
 }
 function when(condition, options) {
   let rejecter;
   let resolver;
-  const repeated = repeat(() => {
+  const repeated = timer("repeat", () => {
     if (condition()) {
       repeated.stop();
       resolver?.();
     }
   }, {
+    afterCallback() {
+      if (!repeated.paused) {
+        if (condition()) {
+          resolver?.();
+        } else {
+          rejecter?.();
+        }
+      }
+    },
     errorCallback() {
       rejecter?.();
     },
     count: options?.count,
     interval: options?.interval,
     timeout: options?.timeout
-  });
+  }, false);
   const promise = new Promise((resolve, reject) => {
     resolver = resolve;
     rejecter = reject;
@@ -967,25 +986,31 @@ var work2 = function(type, timer2, state, options, isRepeated2) {
     return timer2;
   }
   const { count, interval, timeout } = options;
+  const { minimum } = state;
   if (["pause", "stop"].includes(type)) {
+    const isStop = type === "stop";
     activeTimers.delete(timer2);
     cancelAnimationFrame(state.frame);
-    options.afterCallback?.(false);
+    if (isStop) {
+      options.afterCallback?.(false);
+    }
     state.active = false;
     state.frame = undefined;
-    if (type === "stop") {
+    state.paused = !isStop;
+    if (isStop) {
       state.elapsed = undefined;
       state.index = undefined;
     }
     return timer2;
   }
   state.active = true;
+  state.paused = false;
   const canTimeout = timeout > 0 && timeout < Number.POSITIVE_INFINITY;
   const elapsed = type === "continue" ? +(state.elapsed ?? 0) : 0;
   let index = type === "continue" ? +(state.index ?? 0) : 0;
   state.elapsed = elapsed;
   state.index = index;
-  const total = (count === Number.POSITIVE_INFINITY ? Number.POSITIVE_INFINITY : (count - index) * (interval > 0 ? interval : 62.5)) - elapsed;
+  const total = (count === Number.POSITIVE_INFINITY ? Number.POSITIVE_INFINITY : (count - index) * (interval > 0 ? interval : milliseconds)) - elapsed;
   let current;
   let start;
   function finish(finished, error) {
@@ -1008,7 +1033,7 @@ var work2 = function(type, timer2, state, options, isRepeated2) {
     const time2 = timestamp - current;
     state.elapsed = elapsed + (current - start);
     const finished = time2 - elapsed >= total;
-    if (finished || time2 - 2 < interval && interval < time2 + 2) {
+    if (finished || time2 >= minimum) {
       if (state.active) {
         state.callback(isRepeated2 ? index : undefined);
       }
@@ -1034,6 +1059,7 @@ var work2 = function(type, timer2, state, options, isRepeated2) {
 };
 var activeTimers = new Set;
 var hiddenTimers = new Set;
+var milliseconds = 16.666666666666668;
 document.addEventListener("visibilitychange", () => {
   if (document.hidden) {
     for (const timer2 of activeTimers) {

package/dist/js/timer.js

@@ -18,9 +18,9 @@ function isWhen(value) {
   return is(value, /^when$/) && typeof value.then === "function";
 }
 function repeat(callback, options) {
-  return timer("repeat", callback, options ?? {}).start();
+  return timer("repeat", callback, options ?? {}, true);
 }
-var timer = function(type, callback, partial) {
+var timer = function(type, callback, partial, start) {
   const isRepeated2 = type === "repeat";
   const options = {
     afterCallback: partial.afterCallback,
@@ -31,7 +31,9 @@ var timer = function(type, callback, partial) {
   };
   const state = {
     callback,
-    active: false
+    active: false,
+    minimum: options.interval - options.interval % milliseconds / 2,
+    paused: false
   };
   const instance = Object.create({
     continue() {
@@ -60,31 +62,48 @@ var timer = function(type, callback, partial) {
       get() {
         return state.active;
       }
+    },
+    paused: {
+      get() {
+        return state.paused;
+      }
     }
   });
+  if (start) {
+    instance.start();
+  }
   return instance;
 };
 function wait(callback, options) {
   return timer("wait", callback, options == null || typeof options === "number" ? {
     interval: options
-  } : options).start();
+  } : options, true);
 }
 function when(condition, options) {
   let rejecter;
   let resolver;
-  const repeated = repeat(() => {
+  const repeated = timer("repeat", () => {
     if (condition()) {
       repeated.stop();
       resolver?.();
     }
   }, {
+    afterCallback() {
+      if (!repeated.paused) {
+        if (condition()) {
+          resolver?.();
+        } else {
+          rejecter?.();
+        }
+      }
+    },
     errorCallback() {
       rejecter?.();
     },
     count: options?.count,
     interval: options?.interval,
     timeout: options?.timeout
-  });
+  }, false);
   const promise = new Promise((resolve, reject) => {
     resolver = resolve;
     rejecter = reject;
@@ -126,25 +145,31 @@ var work = function(type, timer2, state, options, isRepeated2) {
     return timer2;
   }
   const { count, interval, timeout } = options;
+  const { minimum } = state;
   if (["pause", "stop"].includes(type)) {
+    const isStop = type === "stop";
     activeTimers.delete(timer2);
     cancelAnimationFrame(state.frame);
-    options.afterCallback?.(false);
+    if (isStop) {
+      options.afterCallback?.(false);
+    }
     state.active = false;
     state.frame = undefined;
-    if (type === "stop") {
+    state.paused = !isStop;
+    if (isStop) {
       state.elapsed = undefined;
       state.index = undefined;
     }
     return timer2;
   }
   state.active = true;
+  state.paused = false;
   const canTimeout = timeout > 0 && timeout < Number.POSITIVE_INFINITY;
   const elapsed = type === "continue" ? +(state.elapsed ?? 0) : 0;
   let index = type === "continue" ? +(state.index ?? 0) : 0;
   state.elapsed = elapsed;
   state.index = index;
-  const total = (count === Number.POSITIVE_INFINITY ? Number.POSITIVE_INFINITY : (count - index) * (interval > 0 ? interval : 62.5)) - elapsed;
+  const total = (count === Number.POSITIVE_INFINITY ? Number.POSITIVE_INFINITY : (count - index) * (interval > 0 ? interval : milliseconds)) - elapsed;
   let current;
   let start;
   function finish(finished, error) {
@@ -167,7 +192,7 @@ var work = function(type, timer2, state, options, isRepeated2) {
     const time = timestamp - current;
     state.elapsed = elapsed + (current - start);
     const finished = time - elapsed >= total;
-    if (finished || time - 2 < interval && interval < time + 2) {
+    if (finished || time >= minimum) {
       if (state.active) {
         state.callback(isRepeated2 ? index : undefined);
       }
@@ -193,6 +218,7 @@ var work = function(type, timer2, state, options, isRepeated2) {
 };
 var activeTimers = new Set;
 var hiddenTimers = new Set;
+var milliseconds = 16.666666666666668;
 document.addEventListener("visibilitychange", () => {
   if (document.hidden) {
     for (const timer2 of activeTimers) {

package/dist/js/timer.mjs

@@ -18,9 +18,9 @@ function isWhen(value) {
   return is(value, /^when$/) && typeof value.then === "function";
 }
 function repeat(callback, options) {
-  return timer("repeat", callback, options ?? {}).start();
+  return timer("repeat", callback, options ?? {}, true);
 }
-var timer = function(type, callback, partial) {
+var timer = function(type, callback, partial, start) {
   const isRepeated2 = type === "repeat";
   const options = {
     afterCallback: partial.afterCallback,
@@ -31,7 +31,9 @@ var timer = function(type, callback, partial) {
   };
   const state = {
     callback,
-    active: false
+    active: false,
+    minimum: options.interval - options.interval % milliseconds / 2,
+    paused: false
   };
   const instance = Object.create({
     continue() {
@@ -60,31 +62,48 @@ var timer = function(type, callback, partial) {
       get() {
         return state.active;
       }
+    },
+    paused: {
+      get() {
+        return state.paused;
+      }
     }
   });
+  if (start) {
+    instance.start();
+  }
   return instance;
 };
 function wait(callback, options) {
   return timer("wait", callback, options == null || typeof options === "number" ? {
     interval: options
-  } : options).start();
+  } : options, true);
 }
 function when(condition, options) {
   let rejecter;
   let resolver;
-  const repeated = repeat(() => {
+  const repeated = timer("repeat", () => {
     if (condition()) {
       repeated.stop();
       resolver?.();
     }
   }, {
+    afterCallback() {
+      if (!repeated.paused) {
+        if (condition()) {
+          resolver?.();
+        } else {
+          rejecter?.();
+        }
+      }
+    },
     errorCallback() {
       rejecter?.();
     },
     count: options?.count,
     interval: options?.interval,
     timeout: options?.timeout
-  });
+  }, false);
   const promise = new Promise((resolve, reject) => {
     resolver = resolve;
     rejecter = reject;
@@ -126,25 +145,31 @@ var work = function(type, timer2, state, options, isRepeated2) {
     return timer2;
   }
   const { count, interval, timeout } = options;
+  const { minimum } = state;
   if (["pause", "stop"].includes(type)) {
+    const isStop = type === "stop";
     activeTimers.delete(timer2);
     cancelAnimationFrame(state.frame);
-    options.afterCallback?.(false);
+    if (isStop) {
+      options.afterCallback?.(false);
+    }
     state.active = false;
     state.frame = undefined;
-    if (type === "stop") {
+    state.paused = !isStop;
+    if (isStop) {
       state.elapsed = undefined;
       state.index = undefined;
     }
     return timer2;
   }
   state.active = true;
+  state.paused = false;
   const canTimeout = timeout > 0 && timeout < Number.POSITIVE_INFINITY;
   const elapsed = type === "continue" ? +(state.elapsed ?? 0) : 0;
   let index = type === "continue" ? +(state.index ?? 0) : 0;
   state.elapsed = elapsed;
   state.index = index;
-  const total = (count === Number.POSITIVE_INFINITY ? Number.POSITIVE_INFINITY : (count - index) * (interval > 0 ? interval : 62.5)) - elapsed;
+  const total = (count === Number.POSITIVE_INFINITY ? Number.POSITIVE_INFINITY : (count - index) * (interval > 0 ? interval : milliseconds)) - elapsed;
   let current;
   let start;
   function finish(finished, error) {
@@ -167,7 +192,7 @@ var work = function(type, timer2, state, options, isRepeated2) {
     const time = timestamp - current;
     state.elapsed = elapsed + (current - start);
     const finished = time - elapsed >= total;
-    if (finished || time - 2 < interval && interval < time + 2) {
+    if (finished || time >= minimum) {
       if (state.active) {
         state.callback(isRepeated2 ? index : undefined);
       }
@@ -193,6 +218,7 @@ var work = function(type, timer2, state, options, isRepeated2) {
 };
 var activeTimers = new Set;
 var hiddenTimers = new Set;
+var milliseconds = 16.666666666666668;
 document.addEventListener("visibilitychange", () => {
   if (document.hidden) {
     for (const timer2 of activeTimers) {

package/package.json

@@ -8,7 +8,7 @@
 	},
 	"description": "Sweet little atomic goodies…",
 	"devDependencies": {
-		"@biomejs/biome": "^1.7",
+		"@biomejs/biome": "^1.8",
 		"@happy-dom/global-registrator": "^14.12",
 		"bun": "^1.1",
 		"sass": "^1.77",
@@ -127,5 +127,5 @@
 	},
 	"type": "module",
 	"types": "./types/index.d.ts",
-	"version": "0.47.1"
+	"version": "0.49.0"
 }

package/src/js/timer.ts

@@ -29,6 +29,10 @@ type BaseTimer = {
 	 * Is the timer running?
 	 */
 	get active(): boolean;
+	/**
+	 * Is the timer paused?
+	 */
+	get paused(): boolean;
 };
 
 type OptionsWithCount = {
@@ -61,6 +65,8 @@ type State = {
 	elapsed?: number;
 	frame?: number;
 	index?: number;
+	minimum: number;
+	paused: boolean;
 };
 
 /**
@@ -119,9 +125,21 @@ type WhenOptions = {} & OptionsWithCount;
 
 type WorkType = 'continue' | 'pause' | 'restart' | 'start' | 'stop';
 
+/**
+ * A set of all active timers
+ */
 const activeTimers = new Set<Timer>();
+
+/**
+ * A set of timers that were paused due to the document being hidden
+ */
 const hiddenTimers = new Set<Timer>();
 
+/**
+ * Milliseconds in a frame, probably ;-)
+ */
+const milliseconds = 1_000 / 60;
+
 function getValueOrDefault(value: unknown, defaultValue: number): number {
 	return typeof value === 'number' && value > 0 ? value : defaultValue;
 }
@@ -171,13 +189,14 @@ export function repeat(
 	callback: IndexedCallback,
 	options?: Partial<RepeatOptions>,
 ): Timer {
-	return timer('repeat', callback, options ?? {}).start();
+	return timer('repeat', callback, options ?? {}, true);
 }
 
 function timer(
 	type: 'repeat' | 'wait',
 	callback: AnyCallback,
 	partial: Partial<TimerOptions>,
+	start: boolean,
 ): Timer {
 	const isRepeated = type === 'repeat';
 
@@ -198,6 +217,8 @@ function timer(
 	const state: State = {
 		callback,
 		active: false,
+		minimum: options.interval - (options.interval % milliseconds) / 2,
+		paused: false,
 	};
 
 	const instance = Object.create({
@@ -229,8 +250,17 @@ function timer(
 				return state.active;
 			},
 		},
+		paused: {
+			get() {
+				return state.paused;
+			},
+		},
 	});
 
+	if (start) {
+		instance.start();
+	}
+
 	return instance;
 }
 
@@ -266,7 +296,8 @@ export function wait(
 					interval: options,
 				}
 			: options,
-	).start();
+		true,
+	);
 }
 
 /**
@@ -280,7 +311,8 @@ export function when(
 	let rejecter: () => void;
 	let resolver: () => void;
 
-	const repeated = repeat(
+	const repeated = timer(
+		'repeat',
 		() => {
 			if (condition()) {
 				repeated.stop();
@@ -289,6 +321,15 @@ export function when(
 			}
 		},
 		{
+			afterCallback() {
+				if (!repeated.paused) {
+					if (condition()) {
+						resolver?.();
+					} else {
+						rejecter?.();
+					}
+				}
+			},
 			errorCallback() {
 				rejecter?.();
 			},
@@ -296,6 +337,7 @@ export function when(
 			interval: options?.interval,
 			timeout: options?.timeout,
 		},
+		false,
 	);
 
 	const promise = new Promise<void>((resolve, reject) => {
@@ -356,18 +398,24 @@ function work(
 	}
 
 	const {count, interval, timeout} = options;
+	const {minimum} = state;
 
 	if (['pause', 'stop'].includes(type)) {
+		const isStop = type === 'stop';
+
 		activeTimers.delete(timer);
 
 		cancelAnimationFrame(state.frame as never);
 
-		options.afterCallback?.(false);
+		if (isStop) {
+			options.afterCallback?.(false);
+		}
 
 		state.active = false;
 		state.frame = undefined;
+		state.paused = !isStop;
 
-		if (type === 'stop') {
+		if (isStop) {
 			state.elapsed = undefined;
 			state.index = undefined;
 		}
@@ -376,6 +424,7 @@ function work(
 	}
 
 	state.active = true;
+	state.paused = false;
 
 	const canTimeout = timeout > 0 && timeout < Number.POSITIVE_INFINITY;
 	const elapsed = type === 'continue' ? +(state.elapsed ?? 0) : 0;
@@ -388,7 +437,7 @@ function work(
 	const total =
 		(count === Number.POSITIVE_INFINITY
 			? Number.POSITIVE_INFINITY
-			: (count - index) * (interval > 0 ? interval : 1000 / 16)) - elapsed;
+			: (count - index) * (interval > 0 ? interval : milliseconds)) - elapsed;
 
 	let current: DOMHighResTimeStamp | null;
 	let start: DOMHighResTimeStamp | null;
@@ -422,7 +471,7 @@ function work(
 
 		const finished = time - elapsed >= total;
 
-		if (finished || (time - 2 < interval && interval < time + 2)) {
+		if (finished || time >= minimum) {
 			if (state.active) {
 				state.callback((isRepeated ? index : undefined) as never);
 			}

package/types/timer.d.ts

@@ -22,6 +22,10 @@ type BaseTimer = {
      * Is the timer running?
      */
     get active(): boolean;
+    /**
+     * Is the timer paused?
+     */
+    get paused(): boolean;
 };
 type OptionsWithCount = {
     /**