@oscarpalmer/atoms 0.193.1 → 0.195.0

package/dist/color/misc/state.mjs

@@ -59,7 +59,7 @@ function getDefaultColorState() {
 		origin: COLOR_TYPE.hex
 	};
 }
-function setColorValue(color, state, subscriptions, type, value, alpha) {
+function setColorValue(color, state, changes, type, value, alpha) {
 	state.hex = void 0;
 	state.hsl = void 0;
 	state.hwb = void 0;
@@ -67,36 +67,33 @@ function setColorValue(color, state, subscriptions, type, value, alpha) {
 	state.origin = type;
 	state[type] = value;
 	if (alpha != null) state.alpha = getAlpha(alpha, type === COLOR_TYPE.hex);
-	for (const type of COLOR_TYPE.all) {
-		const callbacks = subscriptions.values.to.keyed?.get(type);
-		if (callbacks != null) for (const callback of callbacks.values()) callback(color[type]);
-	}
-	for (const callback of subscriptions.values.to.any.values()) callback(color);
+	for (const type of COLOR_TYPE.all) if (changes.observed(type)) changes.emit(type, color[type]);
+	changes.emit(COLOR_TYPE.wildcard, color);
 }
-function setHexColor(color, state, subscriptions, value, alpha) {
+function setHexColor(color, state, changes, value, alpha) {
 	if (!isHexColor(value) || !alpha && value === state.hex) return;
 	const normalized = getNormalizedHex(value, true);
-	setColorValue(color, state, subscriptions, COLOR_TYPE.hex, normalized.slice(0, COLOR_LENGTHS.hexLong), alpha ? normalized.slice(COLOR_LENGTHS.hexLong) : void 0);
+	setColorValue(color, state, changes, COLOR_TYPE.hex, normalized.slice(0, COLOR_LENGTHS.hexLong), alpha ? normalized.slice(COLOR_LENGTHS.hexLong) : void 0);
 }
-function setHSLColor(color, state, subscriptions, value, alpha) {
+function setHSLColor(color, state, changes, value, alpha) {
 	if (!isHslLike(value)) return;
-	setColorValue(color, state, subscriptions, COLOR_TYPE.hsl, {
+	setColorValue(color, state, changes, COLOR_TYPE.hsl, {
 		hue: getDegrees(value.hue),
 		saturation: getPercentage(value.saturation),
 		lightness: getPercentage(value.lightness)
 	}, alpha ? value.alpha : void 0);
 }
-function setHWBColor(color, state, subscriptions, value, alpha) {
+function setHWBColor(color, state, changes, value, alpha) {
 	if (!isHwbLike(value)) return;
-	setColorValue(color, state, subscriptions, COLOR_TYPE.hwb, {
+	setColorValue(color, state, changes, COLOR_TYPE.hwb, {
 		hue: getDegrees(value.hue),
 		whiteness: getPercentage(value.whiteness),
 		blackness: getPercentage(value.blackness)
 	}, alpha ? value.alpha : void 0);
 }
-function setRGBColor(color, state, subscriptions, value, alpha) {
+function setRGBColor(color, state, changes, value, alpha) {
 	if (!isRgbLike(value)) return;
-	setColorValue(color, state, subscriptions, COLOR_TYPE.rgb, {
+	setColorValue(color, state, changes, COLOR_TYPE.rgb, {
 		red: getHexValue(value.red),
 		green: getHexValue(value.green),
 		blue: getHexValue(value.blue)

package/dist/color/models.d.mts

@@ -1,5 +1,6 @@
 import { Subscription } from "../internal/subscription.mjs";
-import { COLOR_ALPHA, COLOR_TYPE } from "./constants.mjs";
+import { HeraldEvents } from "../internal/herald.mjs";
+import { COLOR_ALPHA } from "./constants.mjs";
 //#region src/color/models.d.ts
 type Alpha = {
   hex: string;
@@ -9,6 +10,10 @@ type Alpha = {
  * A color that is represented in multiple color formats
  */
 type Color = {
+  /**
+   *
+   */
+  readonly changes: HeraldEvents<ColorChanges>;
   /**
    * Get the alpha channel _(opacity)_ of the color as a percentage between `0` and `100`
    *
@@ -134,74 +139,12 @@ type Color = {
    */
   set rgba(value: RGBAColor);
   /**
-   * Subscribe to alpha channel _(opacity)_ changes of the color
-   *
-   * @param key Color property to subscribe to
-   * @param callback Callback function for changes
-   */
-  subscribe(key: 'alpha', callback: (value: number) => void): Subscription;
-  /**
-   * Subscribe to hex color changes of the color
-   *
-   * @param key Color type to subscribe to
-   * @param callback Callback function for changes
-   */
-  subscribe(key: typeof COLOR_TYPE.hex, callback: (value: string) => void): Subscription;
-  /**
-   * Subscribe to hex color changes of the color with alpha channel _(opacity)_
-   *
-   * @param key Color type to subscribe to
-   * @param callback Callback function for changes
-   */
-  subscribe(key: typeof COLOR_TYPE.hexa, callback: (value: string) => void): Subscription;
-  /**
-   * Subscribe to _HSL_ color changes of the color
+   * Subscribe to value changes for the color
    *
-   * @param key Color type to subscribe to
-   * @param callback Callback function for changes
+   * @param callback Callback function
+   * @param signal Optional abort signal to cancel the subscription
    */
-  subscribe(key: typeof COLOR_TYPE.hsl, callback: (value: HSLColor) => void): Subscription;
-  /**
-   * Subscribe to _HSL(A)_ color changes of the color
-   *
-   * @param key Color type to subscribe to
-   * @param callback Callback function for changes
-   */
-  subscribe(key: typeof COLOR_TYPE.hsla, callback: (value: HSLAColor) => void): Subscription;
-  /**
-   * Subscribe to _HWB_ color changes of the color
-   *
-   * @param key Color type to subscribe to
-   * @param callback Callback function for changes
-   */
-  subscribe(key: typeof COLOR_TYPE.hwb, callback: (value: HWBColor) => void): Subscription;
-  /**
-   * Subscribe to _HWB(A)_ color changes of the color
-   *
-   * @param key Color type to subscribe to
-   * @param callback Callback function for changes
-   */
-  subscribe(key: typeof COLOR_TYPE.hwba, callback: (value: HWBAColor) => void): Subscription;
-  /**
-   * Subscribe to _RGB_ color changes of the color
-   *
-   * @param key Color type to subscribe to
-   * @param callback Callback function for changes
-   */
-  subscribe(key: typeof COLOR_TYPE.rgb, callback: (value: RGBColor) => void): Subscription;
-  /**
-   * Subscribe to _RGBA_ color changes of the color
-   *
-   * @param key Color type to subscribe to
-   * @param callback Callback function for changes
-   */
-  subscribe(key: typeof COLOR_TYPE.rgba, callback: (value: RGBAColor) => void): Subscription;
-  /**
-   * Subscribe to any color changes of the color
-   *
-   * @param callback Callback function for changes
-   */
-  subscribe(callback: (value: Color) => void): Subscription;
+  subscribe(callback: (value: Color) => void, signal?: AbortSignal): Subscription;
   /**
    * Get the color as a hex string
    *
@@ -243,6 +186,18 @@ type Color = {
    */
   unsubscribe(): void;
 };
+type ColorChanges = {
+  '*': (value: Color) => void;
+  alpha: (value: number) => void;
+  hex: (value: string) => void;
+  hexa: (value: string) => void;
+  hsl: (value: HSLColor) => void;
+  hsla: (value: HSLAColor) => void;
+  hwb: (value: HWBColor) => void;
+  hwba: (value: HWBAColor) => void;
+  rgb: (value: RGBColor) => void;
+  rgba: (value: RGBAColor) => void;
+};
 type ColorWithAlpha = {
   /**
    * Alpha channel _(opacity)_ of the color _(in percentage; 0-100)_
@@ -332,4 +287,4 @@ type ColorValue = string | HSLColor | HWBColor | RGBColor;
  */
 type ColorValueExtended = ColorValue | HSLAColor | HWBAColor | RGBAColor;
 //#endregion
-export { Alpha, Color, ColorProperty, ColorState, ColorType, ColorTypeExtended, ColorValue, ColorValueExtended, HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor };
+export { Alpha, Color, ColorChanges, ColorProperty, ColorState, ColorType, ColorTypeExtended, ColorValue, ColorValueExtended, HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor };

package/dist/color/space/hex.mjs

@@ -1,4 +1,4 @@
-import { join } from "../../internal/string.mjs";
+import { join } from "../../internal/string/misc.mjs";
 import { COLOR_ALPHA, COLOR_DEFAULTS, COLOR_EXPRESSION, COLOR_LENGTHS, COLOR_MAX, COLOR_TYPE } from "../constants.mjs";
 import { getHexValue, getPercentage } from "../misc/get.mjs";
 import { isHexColor } from "../misc/is.mjs";

package/dist/color/space/rgb.mjs

@@ -1,4 +1,4 @@
-import { join } from "../../internal/string.mjs";
+import { join } from "../../internal/string/misc.mjs";
 import { COLOR_DEFAULTS, COLOR_MAX, COLOR_TYPE } from "../constants.mjs";
 import { getAlpha, getAlphaValue } from "../misc/alpha.mjs";
 import { getHexValue } from "../misc/get.mjs";

package/dist/function/index.d.mts

@@ -1,3 +1,2 @@
 import { noop } from "../internal/function/misc.mjs";
-import { Memoized, MemoizedOptions, memoize } from "./memoize.mjs";
-export { type Memoized, type MemoizedOptions, memoize, noop };
+export { noop };

package/dist/function/index.mjs

@@ -1,3 +1,2 @@
 import { noop } from "../internal/function/misc.mjs";
-import { memoize } from "./memoize.mjs";
-export { memoize, noop };
+export { noop };

package/dist/function/limit.d.mts

@@ -36,9 +36,6 @@ declare function asyncThrottle<Callback extends GenericAsyncCallback | GenericCa
  * @returns Debounced callback handler with a `cancel` method
  */
 declare function debounce<Callback extends GenericCallback>(callback: Callback, time?: number): CancelableCallback<Callback>;
-declare namespace debounce {
-  var async: typeof asyncDebounce;
-}
 /**
  * Throttle a function, ensuring it is only called once every `time` milliseconds
  *
@@ -47,8 +44,5 @@ declare namespace debounce {
  * @returns Throttled callback handler with a `cancel` method
  */
 declare function throttle<Callback extends GenericCallback>(callback: Callback, time?: number): CancelableCallback<Callback>;
-declare namespace throttle {
-  var async: typeof asyncThrottle;
-}
 //#endregion
 export { asyncDebounce, asyncThrottle, debounce, throttle };

package/dist/function/limit.mjs

@@ -42,7 +42,6 @@ function asyncThrottle(callback, time) {
 function debounce(callback, time) {
 	return getTimer(TIMER_DEBOUNCE, callback, time);
 }
-debounce.async = asyncDebounce;
 /**
 * Throttle a function, ensuring it is only called once every `time` milliseconds
 *
@@ -53,6 +52,7 @@ debounce.async = asyncDebounce;
 function throttle(callback, time) {
 	return getTimer(TIMER_THROTTLE, callback, time);
 }
-throttle.async = asyncThrottle;
+Object.defineProperty(debounce, "async", { value: asyncDebounce });
+Object.defineProperty(throttle, "async", { value: asyncThrottle });
 //#endregion
 export { asyncDebounce, asyncThrottle, debounce, throttle };

package/dist/function/once.d.mts

@@ -16,8 +16,5 @@ declare function asyncOnce<Callback extends GenericAsyncCallback>(callback: Call
  * @returns _Once_ callback
  */
 declare function once<Callback extends GenericCallback>(callback: Callback): OnceCallback<Callback>;
-declare namespace once {
-  var async: typeof asyncOnce;
-}
 //#endregion
 export { asyncOnce, once };

package/dist/function/once.mjs

@@ -1,4 +1,4 @@
-import { assert } from "./assert.mjs";
+import { assert } from "../internal/function/assert.mjs";
 //#region src/function/once.ts
 /**
 * Create an asynchronous function that can only be called once, rejecting or resolving the same result on subsequent calls
@@ -45,6 +45,7 @@ function asyncOnce(callback) {
 			enumerable: true,
 			get: () => state.called
 		},
+		clear: { value: () => clearState(state) },
 		cleared: {
 			enumerable: true,
 			get: () => state.cleared
@@ -58,13 +59,13 @@ function asyncOnce(callback) {
 			get: () => state.finished
 		}
 	});
-	fn.clear = () => {
-		if (!state.called || !state.finished || state.cleared) return;
-		state.cleared = true;
-		state.value = void 0;
-	};
 	return fn;
 }
+function clearState(state) {
+	if (!state.called || state.cleared) return;
+	state.cleared = true;
+	state.value = void 0;
+}
 function handleOnceResult(state, value, error) {
 	state.error = error;
 	state.finished = true;
@@ -98,18 +99,20 @@ function once(callback) {
 		return state.value;
 	};
 	Object.defineProperties(fn, {
-		called: { get: () => state.called },
-		cleared: { get: () => state.cleared }
+		called: {
+			enumerable: true,
+			get: () => state.called
+		},
+		clear: { value: () => clearState(state) },
+		cleared: {
+			enumerable: true,
+			get: () => state.cleared
+		}
 	});
-	fn.clear = () => {
-		if (!state.called || state.cleared) return;
-		state.cleared = true;
-		state.value = void 0;
-	};
 	return fn;
 }
-once.async = asyncOnce;
 const ONCE_MESSAGE_CLEARED = "Once has been cleared";
 const ONCE_MESSAGE_EXPECTATION = "Once expected a function";
+Object.defineProperty(once, "async", { value: asyncOnce });
 //#endregion
 export { asyncOnce, once };

package/dist/function/retry.d.mts

@@ -1,4 +1,4 @@
-import { GenericAsyncCallback, GenericCallback } from "../models.mjs";
+import { GenericCallback } from "../models.mjs";
 //#region src/function/retry.d.ts
 /**
  * An error thrown when a retry fails
@@ -12,26 +12,6 @@ type RetryOptions = {
   times?: number;
   when?: (error: unknown) => boolean;
 };
-/**
- * Retry a callback a specified number of times, with a delay between attempts
- *
- * _Available as `asyncRetry` and `retry.async`_
- *
- * @param callback Callback to retry
- * @param options Retry options
- * @returns Callback result
- */
-declare function asyncRetry<Callback extends GenericAsyncCallback>(callback: Callback, options?: RetryOptions): Promise<Awaited<ReturnType<Callback>>>;
-/**
- * Retry a callback a specified number of times, with a delay between attempts
- *
- * _Available as `asyncRetry` and `retry.async`_
- *
- * @param callback Callback to retry
- * @param options Retry options
- * @returns Callback result
- */
-declare function asyncRetry<Callback extends GenericCallback>(callback: Callback, options?: RetryOptions): Promise<ReturnType<Callback>>;
 /**
  * Retry a callback a specified number of times
  *
@@ -40,8 +20,5 @@ declare function asyncRetry<Callback extends GenericCallback>(callback: Callback
  * @returns Callback result
  */
 declare function retry<Callback extends GenericCallback>(callback: Callback, options?: Omit<RetryOptions, 'delay'>): ReturnType<Callback>;
-declare namespace retry {
-  var async: typeof asyncRetry;
-}
 //#endregion
 export { RetryError, RetryOptions, retry };

package/dist/function/retry.mjs

@@ -78,12 +78,12 @@ function retry(callback, options) {
 	}
 	throw new RetryError(RETRY_MESSAGE_FAILED, last);
 }
-retry.async = asyncRetry;
 function shouldRetry() {
 	return true;
 }
 const RETRY_ERROR_NAME = "RetryError";
 const RETRY_MESSAGE_EXPECTATION = "Retry expected a function";
 const RETRY_MESSAGE_FAILED = "Retry failed";
+Object.defineProperty(retry, "async", { value: asyncRetry });
 //#endregion
 export { RetryError, retry };

package/dist/herald.d.mts

@@ -1,72 +1,2 @@
-import { GenericCallback, Unsubscriber } from "./models.mjs";
-//#region src/herald.d.ts
-type Events<Map extends Record<string, GenericCallback>> = {
-  /**
-   * Subscribe to an event with a callback
-   *
-   * @param event Event name
-   * @param callback Callback function
-   * @returns Unsubscriber function
-   */
-  subscribe<Event extends keyof Map>(event: Event, callback: Map[Event]): Unsubscriber;
-  /**
-   * Unsubscribe from an event with a callback _(or all callbacks, if no callback is provided)_
-   *
-   * @param event Event name
-   * @param callback Callback function
-   * @returns Unsubscriber function
-   */
-  unsubscribe<Event extends keyof Map>(event: Event, callback?: Map[Event]): void;
-};
-type Herald<Map extends Record<string, GenericCallback>> = {
-  readonly events: Events<Map>;
-  /**
-   * Remove all event subscribers
-   */
-  clear(): void;
-  /**
-   * Emit an event with parameters
-   *
-   * @param event Event name
-   * @param parameters Event parameters
-   */
-  emit<Event extends keyof Map>(event: Event, ...parameters: Parameters<Map[Event]>): void;
-  /**
-   * Subscribe to an event with a callback
-   *
-   * @param event Event name
-   * @param callback Callback function
-   * @returns Unsubscriber function
-   */
-  subscribe<Event extends keyof Map>(event: Event, callback: Map[Event]): Unsubscriber;
-  /**
-   * Unsubscribe from an event with a callback _(or all callbacks, if no callback is provided)_
-   *
-   * @param event Event name
-   * @param callback Callback function
-   */
-  unsubscribe<Event extends keyof Map>(event: Event, callback?: Map[Event]): void;
-};
-/**
- * Create a _Herald_ for announcing named events
- *
- * @param names Event names
- * @returns _Herald_ instance
- */
-declare function herald<Events extends Record<string, GenericCallback>>(names: (keyof Events)[]): Herald<Events>;
-/**
- * Is the value events for a herald?
- *
- * @param value Value to check
- * @returns `true` if the value is events for a herald, otherwise `false`
- */
-declare function isEvents<Map extends Record<string, GenericCallback> = Record<string, GenericCallback>>(value: unknown): value is Events<Map>;
-/**
- * Is the value a herald?
- *
- * @param value Value to check
- * @returns `true` if the value is a herald, otherwise `false`
- */
-declare function isHerald<Events extends Record<string, GenericCallback> = Record<string, GenericCallback>>(value: unknown): value is Herald<Events>;
-//#endregion
-export { Events, Herald, herald, isEvents, isHerald };
+import { herald, isHerald, isHeraldEvents, isHeraldSubscription } from "./internal/herald.mjs";
+export { herald, isHerald, isHeraldEvents, isHeraldSubscription };

package/dist/herald.mjs

@@ -1,92 +1,2 @@
-import { noop } from "./internal/function/misc.mjs";
-//#region src/herald.ts
-function getEvents(herald) {
-	const events = {
-		subscribe: (event, callback) => herald.subscribe(event, callback),
-		unsubscribe: (event, callback) => herald.unsubscribe(event, callback)
-	};
-	Object.defineProperty(events, KEY_HERALD, {
-		enumerable: false,
-		value: NAME_EVENTS
-	});
-	return Object.freeze(events);
-}
-/**
-* Create a _Herald_ for announcing named events
-*
-* @param names Event names
-* @returns _Herald_ instance
-*/
-function herald(names) {
-	if (!Array.isArray(names) || names.length === 0 || !names.every((name) => typeof name === "string")) throw new Error(MESSAGE);
-	const set = new Set(names);
-	const subscribers = /* @__PURE__ */ new Map();
-	const instance = {
-		clear() {
-			subscribers.clear();
-		},
-		emit(event, ...parameters) {
-			const callbacks = subscribers.get(event);
-			if (callbacks == null) return;
-			for (const callback of callbacks) callback(...parameters);
-		},
-		subscribe(event, callback) {
-			if (!set.has(event) || typeof callback !== "function") return noop;
-			let eventSubscribers = subscribers.get(event);
-			if (eventSubscribers == null) {
-				eventSubscribers = /* @__PURE__ */ new Set();
-				subscribers.set(event, eventSubscribers);
-			}
-			eventSubscribers.add(callback);
-			return () => {
-				eventSubscribers?.delete(callback);
-			};
-		},
-		unsubscribe(event, callback) {
-			if (!set.has(event) || (callback != null ? typeof callback !== "function" : false)) return;
-			const eventSubscribers = subscribers.get(event);
-			if (eventSubscribers == null) return;
-			if (callback == null) eventSubscribers.clear();
-			else eventSubscribers.delete(callback);
-			if (callback == null || eventSubscribers.size === 0) subscribers.delete(event);
-		}
-	};
-	Object.defineProperties(instance, {
-		[KEY_HERALD]: {
-			enumerable: false,
-			value: NAME_HERALD
-		},
-		events: {
-			enumerable: true,
-			value: getEvents(instance)
-		}
-	});
-	return Object.freeze(instance);
-}
-/**
-* Is the value events for a herald?
-*
-* @param value Value to check
-* @returns `true` if the value is events for a herald, otherwise `false`
-*/
-function isEvents(value) {
-	return isHeraldInstance(NAME_EVENTS, value);
-}
-/**
-* Is the value a herald?
-*
-* @param value Value to check
-* @returns `true` if the value is a herald, otherwise `false`
-*/
-function isHerald(value) {
-	return isHeraldInstance(NAME_HERALD, value);
-}
-function isHeraldInstance(name, value) {
-	return typeof value === "object" && value != null && KEY_HERALD in value && value[KEY_HERALD] === name;
-}
-const KEY_HERALD = "$herald";
-const MESSAGE = "Herald requires an array of event names.";
-const NAME_EVENTS = "events";
-const NAME_HERALD = "herald";
-//#endregion
-export { herald, isEvents, isHerald };
+import { herald, isHerald, isHeraldEvents, isHeraldSubscription } from "./internal/herald.mjs";
+export { herald, isHerald, isHeraldEvents, isHeraldSubscription };