@oscarpalmer/atoms 0.51.0 → 0.52.0

package/dist/js/emitter.js

@@ -58,19 +58,25 @@ function emitter(value) {
     destroy() {
       finish(false);
     },
-    emit(value2) {
+    emit(value2, complete) {
       if (active) {
         stored = value2;
         for (const [, observer] of observers) {
           observer.next?.(value2);
         }
+        if (complete === true) {
+          finish(true);
+        }
       }
     },
-    error(error) {
+    error(error, complete) {
       if (active) {
         for (const [, observer] of observers) {
           observer.error?.(error);
         }
+        if (complete === true) {
+          finish(true);
+        }
       }
     },
     finish() {

package/dist/js/emitter.mjs

@@ -58,19 +58,25 @@ function emitter(value) {
     destroy() {
       finish(false);
     },
-    emit(value2) {
+    emit(value2, complete) {
       if (active) {
         stored = value2;
         for (const [, observer] of observers) {
           observer.next?.(value2);
         }
+        if (complete === true) {
+          finish(true);
+        }
       }
     },
-    error(error) {
+    error(error, complete) {
       if (active) {
         for (const [, observer] of observers) {
           observer.error?.(error);
         }
+        if (complete === true) {
+          finish(true);
+        }
       }
     },
     finish() {

package/dist/js/function.js

@@ -0,0 +1,6 @@
+// src/js/function.ts
+function noop() {
+}
+export {
+  noop
+};

package/dist/js/function.mjs

@@ -0,0 +1,6 @@
+// src/js/function.ts
+function noop() {
+}
+export {
+  noop
+};

package/dist/js/index.js

@@ -955,23 +955,29 @@ function emitter(value) {
     destroy() {
       finish(false);
     },
-    error(error) {
+    emit(value2, complete) {
       if (active) {
+        stored = value2;
         for (const [, observer] of observers) {
-          observer.error?.(error);
+          observer.next?.(value2);
+        }
+        if (complete === true) {
+          finish(true);
         }
       }
     },
-    finish() {
-      finish(true);
-    },
-    next(value2) {
+    error(error, complete) {
       if (active) {
-        stored = value2;
         for (const [, observer] of observers) {
-          observer.next?.(value2);
+          observer.error?.(error);
+        }
+        if (complete === true) {
+          finish(true);
         }
       }
+    },
+    finish() {
+      finish(true);
     }
   });
   const observable = createObserable(instance, observers);
@@ -1007,16 +1013,16 @@ function getPosition(event) {
   }
   return typeof x === "number" && typeof y === "number" ? { x, y } : undefined;
 }
-// src/js/log.ts
+// src/js/logger.ts
 var time = function(label) {
-  const started = log.enabled;
+  const started = logger.enabled;
   let stopped = false;
   if (started) {
     console.time(label);
   }
   return Object.create({
     log() {
-      if (started && !stopped && log.enabled) {
+      if (started && !stopped && logger.enabled) {
         console.timeLog(label);
       }
     },
@@ -1029,7 +1035,7 @@ var time = function(label) {
   });
 };
 var work = function(type, data) {
-  if (log.enabled) {
+  if (logger.enabled) {
     console[type](...data);
   }
 };
@@ -1041,11 +1047,12 @@ var types = new Set([
   "debug",
   "error",
   "info",
+  "log",
   "table",
   "trace",
   "warn"
 ]);
-var log = (() => {
+var logger = (() => {
   const instance = Object.create(null);
   Object.defineProperties(instance, {
     enabled: {
@@ -1056,9 +1063,6 @@ var log = (() => {
         _atomic_logging = value;
       }
     },
-    it: {
-      value: (...data) => work("log", data)
-    },
     time: {
       value: time
     }
@@ -1133,15 +1137,11 @@ function getRandomInteger(min2, max2) {
 function getRandomHex() {
   return "0123456789ABCDEF"[getRandomInteger(0, 16)];
 }
-// src/js/timer.ts
-async function delay(time2) {
-  return new Promise((resolve) => {
-    wait(resolve, {
-      errorCallback: resolve,
-      interval: time2
-    });
-  });
+// src/js/function.ts
+function noop() {
 }
+
+// src/js/timer.ts
 var getValueOrDefault = function(value, defaultValue) {
   return typeof value === "number" && value > 0 ? value : defaultValue;
 };
@@ -1361,8 +1361,6 @@ var work2 = function(type, timer2, state, options, isRepeated2) {
 var activeTimers = new Set;
 var hiddenTimers = new Set;
 var milliseconds = 16.666666666666668;
-var noop = () => {
-};
 document.addEventListener("visibilitychange", () => {
   if (document.hidden) {
     for (const timer2 of activeTimers) {
@@ -1559,7 +1557,7 @@ export {
   min,
   merge,
   max,
-  log,
+  logger,
   kebabCase,
   join,
   isWhen,
@@ -1609,7 +1607,6 @@ export {
   equal,
   emitter,
   diff,
-  delay,
   createUuid,
   clone,
   clamp,

package/dist/js/index.mjs

@@ -8,7 +8,7 @@ export * from "./equal";
 export * from "./emitter";
 export * from "./event";
 export * from "./is";
-export * from "./log";
+export * from "./logger";
 export * from "./math";
 export * from "./models";
 export * from "./number";

package/dist/js/{log.js → logger.js}

@@ -1,13 +1,13 @@
-// src/js/log.ts
+// src/js/logger.ts
 var time = function(label) {
-  const started = log.enabled;
+  const started = logger.enabled;
   let stopped = false;
   if (started) {
     console.time(label);
   }
   return Object.create({
     log() {
-      if (started && !stopped && log.enabled) {
+      if (started && !stopped && logger.enabled) {
         console.timeLog(label);
       }
     },
@@ -20,7 +20,7 @@ var time = function(label) {
   });
 };
 var work = function(type, data) {
-  if (log.enabled) {
+  if (logger.enabled) {
     console[type](...data);
   }
 };
@@ -32,11 +32,12 @@ var types = new Set([
   "debug",
   "error",
   "info",
+  "log",
   "table",
   "trace",
   "warn"
 ]);
-var log = (() => {
+var logger = (() => {
   const instance = Object.create(null);
   Object.defineProperties(instance, {
     enabled: {
@@ -47,9 +48,6 @@ var log = (() => {
         _atomic_logging = value;
       }
     },
-    it: {
-      value: (...data) => work("log", data)
-    },
     time: {
       value: time
     }
@@ -62,5 +60,5 @@ var log = (() => {
   return instance;
 })();
 export {
-  log
+  logger
 };

package/dist/js/{log.mjs → logger.mjs}

@@ -1,13 +1,13 @@
-// src/js/log.ts
+// src/js/logger.ts
 var time = function(label) {
-  const started = log.enabled;
+  const started = logger.enabled;
   let stopped = false;
   if (started) {
     console.time(label);
   }
   return Object.create({
     log() {
-      if (started && !stopped && log.enabled) {
+      if (started && !stopped && logger.enabled) {
         console.timeLog(label);
       }
     },
@@ -20,7 +20,7 @@ var time = function(label) {
   });
 };
 var work = function(type, data) {
-  if (log.enabled) {
+  if (logger.enabled) {
     console[type](...data);
   }
 };
@@ -32,11 +32,12 @@ var types = new Set([
   "debug",
   "error",
   "info",
+  "log",
   "table",
   "trace",
   "warn"
 ]);
-var log = (() => {
+var logger = (() => {
   const instance = Object.create(null);
   Object.defineProperties(instance, {
     enabled: {
@@ -47,9 +48,6 @@ var log = (() => {
         _atomic_logging = value;
       }
     },
-    it: {
-      value: (...data) => work("log", data)
-    },
     time: {
       value: time
     }
@@ -62,5 +60,5 @@ var log = (() => {
   return instance;
 })();
 export {
-  log
+  logger
 };

package/dist/js/timer.js

@@ -1,3 +1,7 @@
+// src/js/function.ts
+function noop() {
+}
+
 // src/js/timer.ts
 var getValueOrDefault = function(value, defaultValue) {
   return typeof value === "number" && value > 0 ? value : defaultValue;
@@ -192,22 +196,21 @@ var work = function(type, timer2, state, options, isRepeated2) {
     const time = timestamp - current;
     state.elapsed = elapsed + (current - start);
     const finished = time - elapsed >= total;
+    if (timestamp - start >= timeout - elapsed) {
+      finish(finished, !finished);
+      return;
+    }
     if (finished || time >= minimum) {
       if (state.active) {
         state.callback(isRepeated2 ? index : undefined);
       }
       index += 1;
       state.index = index;
-      switch (true) {
-        case (canTimeout && !finished && timestamp - start >= timeout - elapsed):
-          finish(false, true);
-          return;
-        case (!finished && index < count):
-          current = null;
-          break;
-        default:
-          finish(true, false);
-          return;
+      if (!finished && index < count) {
+        current = null;
+      } else {
+        finish(true, false);
+        return;
       }
     }
     state.frame = requestAnimationFrame(step);
@@ -219,8 +222,6 @@ var work = function(type, timer2, state, options, isRepeated2) {
 var activeTimers = new Set;
 var hiddenTimers = new Set;
 var milliseconds = 16.666666666666668;
-var noop = () => {
-};
 document.addEventListener("visibilitychange", () => {
   if (document.hidden) {
     for (const timer2 of activeTimers) {

package/dist/js/timer.mjs

@@ -1,4 +1,5 @@
 // src/js/timer.ts
+import {noop} from "./function";
 var getValueOrDefault = function(value, defaultValue) {
   return typeof value === "number" && value > 0 ? value : defaultValue;
 };
@@ -192,22 +193,21 @@ var work = function(type, timer2, state, options, isRepeated2) {
     const time = timestamp - current;
     state.elapsed = elapsed + (current - start);
     const finished = time - elapsed >= total;
+    if (timestamp - start >= timeout - elapsed) {
+      finish(finished, !finished);
+      return;
+    }
     if (finished || time >= minimum) {
       if (state.active) {
         state.callback(isRepeated2 ? index : undefined);
       }
       index += 1;
       state.index = index;
-      switch (true) {
-        case (canTimeout && !finished && timestamp - start >= timeout - elapsed):
-          finish(false, true);
-          return;
-        case (!finished && index < count):
-          current = null;
-          break;
-        default:
-          finish(true, false);
-          return;
+      if (!finished && index < count) {
+        current = null;
+      } else {
+        finish(true, false);
+        return;
       }
     }
     state.frame = requestAnimationFrame(step);
@@ -219,8 +219,6 @@ var work = function(type, timer2, state, options, isRepeated2) {
 var activeTimers = new Set;
 var hiddenTimers = new Set;
 var milliseconds = 16.666666666666668;
-var noop = () => {
-};
 document.addEventListener("visibilitychange", () => {
   if (document.hidden) {
     for (const timer2 of activeTimers) {

package/package.json

@@ -132,5 +132,5 @@
 	},
 	"type": "module",
 	"types": "./types/index.d.ts",
-	"version": "0.51.0"
+	"version": "0.52.0"
 }

package/src/js/emitter.ts

@@ -1,15 +1,42 @@
 export type Emitter<Value> = {
+	/**
+	 * Is the emitter active?
+	 */
 	readonly active: boolean;
+	/**
+	 * The observable that can be subscribed to
+	 */
 	readonly observable: Observable<Value>;
+	/**
+	 * The current value
+	 */
 	readonly value: Value;
+	/**
+	 * Destroys the emitter
+	 */
 	destroy(): void;
-	error(error: Error): void;
+	/**
+	 * Emits a new value _(and optionally finishes the emitter)_
+	 */
+	emit(value: Value, finish?: boolean): void;
+	/**
+	 * Emits an error _(and optionally finishes the emitter)_
+	 */
+	error(error: Error, finish?: boolean): void;
+	/**
+	 * Finishes the emitter
+	 */
 	finish(): void;
-	next(value: Value): void;
 };
 
 export type Observable<Value> = {
+	/**
+	 * Subscribes to value changes
+	 */
 	subscribe(observer: Observer<Value>): Subscription;
+	/**
+	 * Subscribes to value changes
+	 */
 	subscribe(
 		onNext: (value: Value) => void,
 		onError?: (error: Error) => void,
@@ -18,13 +45,28 @@ export type Observable<Value> = {
 };
 
 export type Observer<Value> = {
+	/**
+	 * Callback for when the observable is complete
+	 */
 	complete?: () => void;
+	/**
+	 * Callback for when the observable has an error
+	 */
 	error?: (error: Error) => void;
+	/**
+	 * Callback for when the observable has a new value
+	 */
 	next?: (value: Value) => void;
 };
 
 export type Subscription = {
-	closed: boolean;
+	/**
+	 * Is the subscription closed?
+	 */
+	readonly closed: boolean;
+	/**
+	 * Unsubscribes from the observable
+	 */
 	unsubscribe(): void;
 };
 
@@ -95,6 +137,9 @@ function getObserver<Value>(
 	return observer;
 }
 
+/**
+ * Creates a new emitter
+ */
 export function emitter<Value>(value: Value): Emitter<Value> {
 	let active = true;
 	let stored = value;
@@ -119,25 +164,33 @@ export function emitter<Value>(value: Value): Emitter<Value> {
 		destroy() {
 			finish(false);
 		},
-		error(error: Error) {
+		emit(value: Value, complete?: boolean) {
 			if (active) {
+				stored = value;
+
 				for (const [, observer] of observers) {
-					observer.error?.(error);
+					observer.next?.(value);
+				}
+
+				if (complete === true) {
+					finish(true);
 				}
 			}
 		},
-		finish() {
-			finish(true);
-		},
-		next(value: Value) {
+		error(error: Error, complete?: boolean) {
 			if (active) {
-				stored = value;
-
 				for (const [, observer] of observers) {
-					observer.next?.(value);
+					observer.error?.(error);
+				}
+
+				if (complete === true) {
+					finish(true);
 				}
 			}
 		},
+		finish() {
+			finish(true);
+		},
 	} as Emitter<Value>);
 
 	const observable = createObserable<Value>(instance, observers);

package/src/js/function.ts

@@ -0,0 +1,4 @@
+/**
+ * A function that does nothing, which can be useful, I guess…
+ */
+export function noop(): void {}

package/src/js/index.ts

@@ -7,7 +7,7 @@ export * from './equal';
 export * from './emitter';
 export * from './event';
 export * from './is';
-export * from './log';
+export * from './logger';
 export * from './math';
 export * from './models';
 export * from './number';

package/src/js/{log.ts → logger.ts}

@@ -6,7 +6,7 @@ if (globalThis._atomic_logging == null) {
 	globalThis._atomic_logging = true;
 }
 
-type Log = {
+type Logger = {
 	/**
 	 * Is logging to the console enabled? _(defaults to `true`)_
 	 */
@@ -30,7 +30,7 @@ type Log = {
 	/**
 	 * Logs any number of values at the "log" log level
 	 */
-	it(data: unknown): void;
+	log(data: unknown): void;
 	/**
 	 * Logs data as a table, with optional properties to use as columns
 	 */
@@ -78,12 +78,13 @@ const types = new Set<Type>([
 	'debug',
 	'error',
 	'info',
+	'log',
 	'table',
 	'trace',
 	'warn',
 ]);
 
-const log = (() => {
+const logger = (() => {
 	const instance = Object.create(null);
 
 	Object.defineProperties(instance, {
@@ -95,9 +96,6 @@ const log = (() => {
 				_atomic_logging = value;
 			},
 		},
-		it: {
-			value: (...data: unknown[]) => work('log', data),
-		},
 		time: {
 			value: time,
 		},
@@ -110,10 +108,10 @@ const log = (() => {
 	}
 
 	return instance;
-})() as Log;
+})() as Logger;
 
 function time(label: string): Time {
-	const started = log.enabled;
+	const started = logger.enabled;
 
 	let stopped = false;
 
@@ -123,7 +121,7 @@ function time(label: string): Time {
 
 	return Object.create({
 		log() {
-			if (started && !stopped && log.enabled) {
+			if (started && !stopped && logger.enabled) {
 				console.timeLog(label);
 			}
 		},
@@ -138,9 +136,9 @@ function time(label: string): Time {
 }
 
 function work(type: Type, data: unknown[]): void {
-	if (log.enabled) {
+	if (logger.enabled) {
 		console[type](...data);
 	}
 }
 
-export {log};
+export {logger};

package/src/js/timer.ts

@@ -1,3 +1,4 @@
+import {noop} from './function';
 import type {PlainObject} from './models';
 
 /**
@@ -140,8 +141,6 @@ const hiddenTimers = new Set<Timer>();
  */
 const milliseconds = 1_000 / 60;
 
-const noop = () => {};
-
 function getValueOrDefault(value: unknown, defaultValue: number): number {
 	return typeof value === 'number' && value > 0 ? value : defaultValue;
 }

package/types/emitter.d.ts

@@ -1,23 +1,68 @@
 export type Emitter<Value> = {
+    /**
+     * Is the emitter active?
+     */
     readonly active: boolean;
-    readonly obserable: Observable<Value>;
+    /**
+     * The observable that can be subscribed to
+     */
+    readonly observable: Observable<Value>;
+    /**
+     * The current value
+     */
     readonly value: Value;
+    /**
+     * Destroys the emitter
+     */
     destroy(): void;
-    emit(value: Value): void;
-    error(error: Error): void;
+    /**
+     * Emits a new value _(and optionally finishes the emitter)_
+     */
+    emit(value: Value, finish?: boolean): void;
+    /**
+     * Emits an error _(and optionally finishes the emitter)_
+     */
+    error(error: Error, finish?: boolean): void;
+    /**
+     * Finishes the emitter
+     */
     finish(): void;
 };
 export type Observable<Value> = {
+    /**
+     * Subscribes to value changes
+     */
     subscribe(observer: Observer<Value>): Subscription;
+    /**
+     * Subscribes to value changes
+     */
     subscribe(onNext: (value: Value) => void, onError?: (error: Error) => void, onComplete?: () => void): Subscription;
 };
 export type Observer<Value> = {
+    /**
+     * Callback for when the observable is complete
+     */
     complete?: () => void;
+    /**
+     * Callback for when the observable has an error
+     */
     error?: (error: Error) => void;
+    /**
+     * Callback for when the observable has a new value
+     */
     next?: (value: Value) => void;
 };
 export type Subscription = {
-    closed: boolean;
+    /**
+     * Is the subscription closed?
+     */
+    readonly closed: boolean;
+    /**
+     * Unsubscribes from the observable
+     */
     unsubscribe(): void;
 };
+/**
+ * Creates a new emitter
+ */
 export declare function emitter<Value>(value: Value): Emitter<Value>;

package/types/function.d.ts

@@ -0,0 +1,4 @@
+/**
+ * A function that does nothing, which can be useful, I guess…
+ */
+export declare function noop(): void;

package/types/index.d.ts

@@ -7,7 +7,7 @@ export * from './equal';
 export * from './emitter';
 export * from './event';
 export * from './is';
-export * from './log';
+export * from './logger';
 export * from './math';
 export * from './models';
 export * from './number';

package/types/{log.d.ts → logger.d.ts}

@@ -1,7 +1,7 @@
 declare global {
     var _atomic_logging: boolean;
 }
-type Log = {
+type Logger = {
     /**
      * Is logging to the console enabled? _(defaults to `true`)_
      */
@@ -25,7 +25,7 @@ type Log = {
     /**
      * Logs any number of values at the "log" log level
      */
-    it(data: unknown): void;
+    log(data: unknown): void;
     /**
      * Logs data as a table, with optional properties to use as columns
      */
@@ -56,5 +56,5 @@ type Time = {
      */
     stop(): void;
 };
-declare const log: Log;
-export { log };
+declare const logger: Logger;
+export { logger };