@oscarpalmer/atoms 0.198.0 → 0.199.0

package/dist/beacon.mjs

@@ -1,6 +1,6 @@
 import { noop } from "./internal/function/misc.mjs";
 import { isPlainObject } from "./internal/is.mjs";
-import { createSubscriptions, isSubscription } from "./internal/subscription.mjs";
+import { SUBSCRIPTION_NAME, isSubscription, subscriptions } from "./internal/subscription.mjs";
 //#region src/beacon.ts
 /**
 * Create a new beacon
@@ -14,8 +14,8 @@ function beacon(value, options) {
 		value,
 		active: true,
 		observable: void 0,
-		options: getBeaconOptions(options),
-		subscriptions: createSubscriptions({ property: beaconSubscription })
+		options: createBeaconOptions(options),
+		subscriptions: subscriptions({ property: beaconSubscription })
 	};
 	const instance = {
 		deactivate: () => finishBeacon(state, false),
@@ -40,28 +40,32 @@ function beacon(value, options) {
 	});
 	return Object.freeze(instance);
 }
-function finishBeacon(state, emit) {
-	if (!state.active) return;
-	state.active = false;
-	for (const [, observer] of state.subscriptions.state.values.to.any) if (emit) observer.complete?.();
-	state.subscriptions.clear();
-	state.observable?.deactivate();
-	state.observable = void 0;
-}
-function getBeaconOptions(input) {
+function createBeaconOptions(input) {
 	const options = isPlainObject(input) ? input : {};
 	options.equal = typeof options.equal === "function" ? options.equal : Object.is;
 	return options;
 }
-function getObservable(state) {
-	if (!state.active) throw new Error(BEACON_MESSAGE_RETRIEVE);
-	state.observable ??= observeBeacon(state);
-	return state.observable;
-}
-function getObservableCallback(value) {
-	return typeof value === "function" ? value : noop;
+function createObservable(beacon) {
+	const state = {
+		beacon,
+		active: beacon.active
+	};
+	const instance = {
+		deactivate: () => {
+			state.active = false;
+		},
+		subscribe: (first, second, third) => subscribeToObservable(state, first, second, third)
+	};
+	Object.defineProperties(instance, {
+		[BEACON_PROPERTY]: { value: BEACON_OBSERVABLE },
+		active: {
+			enumerable: true,
+			get: () => beacon.active && state.active
+		}
+	});
+	return Object.freeze(instance);
 }
-function getObserver(first, second, third) {
+function createObserver(first, second, third) {
 	let observer = { next: noop };
 	if (typeof first === "function") observer = {
 		error: getObservableCallback(second),
@@ -75,6 +79,22 @@ function getObserver(first, second, third) {
 	}
 	return observer;
 }
+function finishBeacon(state, emit) {
+	if (!state.active) return;
+	state.active = false;
+	for (const [, observer] of state.subscriptions.values.to.any) if (emit) observer.complete?.();
+	state.subscriptions.clear();
+	state.observable?.deactivate();
+	state.observable = void 0;
+}
+function getObservable(state) {
+	if (!state.active) throw new Error(BEACON_MESSAGE_RETRIEVE);
+	state.observable ??= createObservable(state);
+	return state.observable;
+}
+function getObservableCallback(value) {
+	return typeof value === "function" ? value : noop;
+}
 /**
 * Is the value a beacon?
 *
@@ -105,29 +125,9 @@ function isBeaconSubscription(value) {
 function isObservable(value) {
 	return isBeaconInstance(BEACON_OBSERVABLE, value);
 }
-function observeBeacon(beacon) {
-	const state = {
-		beacon,
-		active: beacon.active
-	};
-	const instance = {
-		deactivate: () => {
-			state.active = false;
-		},
-		subscribe: (first, second, third) => subscribeToObservable(state, first, second, third)
-	};
-	Object.defineProperties(instance, {
-		[BEACON_PROPERTY]: { value: BEACON_OBSERVABLE },
-		active: {
-			enumerable: true,
-			get: () => beacon.active && state.active
-		}
-	});
-	return Object.freeze(instance);
-}
 function subscribeToObservable(state, first, second, third) {
 	if (!state.beacon.active || !state.active) throw new Error(BEACON_MESSAGE_SUBSCRIBE);
-	const observer = getObserver(first, second, third);
+	const observer = createObserver(first, second, third);
 	const [subscription] = state.beacon.subscriptions.create({
 		isActive: () => state.beacon.active && state.active,
 		value: observer
@@ -141,7 +141,7 @@ function updateBeacon(type, state, value, finish) {
 		if (state.options.equal(state.value, value)) return;
 		state.value = value;
 	}
-	for (const [, observer] of state.subscriptions.state.values.to.any) observer[type]?.(value);
+	for (const [, observer] of state.subscriptions.values.to.any) observer[type]?.(value);
 	if (finish === true) finishBeacon(state, true);
 }
 const BEACON_MESSAGE_RETRIEVE = "Cannot retrieve observable from a closed beacon";
@@ -151,6 +151,9 @@ const BEACON_NAME = "beacon";
 const BEACON_OBSERVABLE = "observable";
 const BEACON_TYPE_ERROR = "error";
 const BEACON_TYPE_NEXT = "next";
-const beaconSubscription = { key: BEACON_PROPERTY };
+const beaconSubscription = {
+	key: BEACON_PROPERTY,
+	value: SUBSCRIPTION_NAME
+};
 //#endregion
 export { beacon, isBeacon, isBeaconSubscription, isObservable };

package/dist/color/instance.mjs

@@ -1,3 +1,4 @@
+import { SUBSCRIPTION_NAME } from "../internal/subscription.mjs";
 import { herald } from "../internal/herald.mjs";
 import { COLOR_PROPERTY, COLOR_TYPE } from "./constants.mjs";
 import { getAlpha } from "./misc/alpha.mjs";
@@ -31,22 +32,22 @@ function color(value) {
 			enumerable: true,
 			value: changes.events
 		},
-		hex: getColorProperty(COLOR_TYPE.hex, instance, state, changes, false),
-		hexa: getColorProperty(COLOR_TYPE.hex, instance, state, changes, true),
-		hsl: getColorProperty(COLOR_TYPE.hsl, instance, state, changes, false),
-		hsla: getColorProperty(COLOR_TYPE.hsl, instance, state, changes, true),
-		hwb: getColorProperty(COLOR_TYPE.hwb, instance, state, changes, false),
-		hwba: getColorProperty(COLOR_TYPE.hwb, instance, state, changes, true),
+		hex: createColorProperty(COLOR_TYPE.hex, instance, state, changes, false),
+		hexa: createColorProperty(COLOR_TYPE.hex, instance, state, changes, true),
+		hsl: createColorProperty(COLOR_TYPE.hsl, instance, state, changes, false),
+		hsla: createColorProperty(COLOR_TYPE.hsl, instance, state, changes, true),
+		hwb: createColorProperty(COLOR_TYPE.hwb, instance, state, changes, false),
+		hwba: createColorProperty(COLOR_TYPE.hwb, instance, state, changes, true),
 		origin: {
 			enumerable: true,
 			get: () => state.origin
 		},
-		rgb: getColorProperty(COLOR_TYPE.rgb, instance, state, changes, false),
-		rgba: getColorProperty(COLOR_TYPE.rgb, instance, state, changes, true)
+		rgb: createColorProperty(COLOR_TYPE.rgb, instance, state, changes, false),
+		rgba: createColorProperty(COLOR_TYPE.rgb, instance, state, changes, true)
 	});
 	return Object.freeze(instance);
 }
-function getColorProperty(space, color, state, changes, alpha) {
+function createColorProperty(space, color, state, changes, alpha) {
 	const setValue = setters[space];
 	return {
 		enumerable: true,
@@ -71,7 +72,10 @@ function onCreateSubscription(instance, event, callback) {
 function setAlphaValue(state, value) {
 	if (typeof value === "number" && !Number.isNaN(value)) state.alpha = getAlpha(value, false);
 }
-const colorSubscription = { key: COLOR_PROPERTY.name };
+const colorSubscription = {
+	key: COLOR_PROPERTY.name,
+	value: SUBSCRIPTION_NAME
+};
 const setters = {
 	hex: setHexColor,
 	hsl: setHSLColor,

package/dist/function/retry.mjs

@@ -1,4 +1,5 @@
 import { isPlainObject } from "../internal/is.mjs";
+import { getNumberOrDefault } from "../internal/defaults.mjs";
 import { TIMER_WAIT, getTimer } from "../internal/function/timer.mjs";
 //#region src/function/retry.ts
 /**
@@ -35,7 +36,7 @@ async function asyncRetry(callback, options) {
 			}
 		}
 	}
-	const { delay, times, when } = getRetryOptions(options);
+	const { delay, times, when } = createRetryOptions(options);
 	const timer = getTimer(TIMER_WAIT, handle, delay);
 	let attempts = 0;
 	let rejector;
@@ -46,14 +47,11 @@ async function asyncRetry(callback, options) {
 		handle();
 	});
 }
-function getRetryNumber(value) {
-	return typeof value === "number" && value > 0 ? value : 0;
-}
-function getRetryOptions(input) {
+function createRetryOptions(input) {
 	const options = isPlainObject(input) ? input : {};
 	return {
-		delay: getRetryNumber(options.delay),
-		times: getRetryNumber(options.times),
+		delay: getNumberOrDefault(options.delay, 0),
+		times: getNumberOrDefault(options.times, 0),
 		when: typeof options.when === "function" ? options.when : shouldRetry
 	};
 }
@@ -66,7 +64,7 @@ function getRetryOptions(input) {
 */
 function retry(callback, options) {
 	if (typeof callback !== "function") throw new TypeError(RETRY_MESSAGE_EXPECTATION);
-	const { times, when } = getRetryOptions(options);
+	const { times, when } = createRetryOptions(options);
 	let last;
 	for (let index = 0; index <= times; index += 1) try {
 		return callback();

package/dist/index.d.mts

@@ -6723,6 +6723,27 @@ type Subscription = {
    */
   unsubscribe(): void;
 };
+/**
+ * Parameters for creating a subscription
+ */
+type SubscriptionParameters = {
+  /**
+   * Is the owner of the subscription alive? _(defaults to `true`)_
+   */
+  isActive?: () => boolean;
+  /**
+   * Key used to identify a subscription _(defaults to `undefined`)_
+   */
+  key?: unknown;
+  /**
+   * Signal used to abort the subscription _(defaults to `undefined`)_
+   */
+  signal?: AbortSignal;
+  /**
+   * Value used to identify a subscription
+   */
+  value: unknown;
+};
 /**
  * Property information for subscription identification
  */
@@ -6732,9 +6753,63 @@ type SubscriptionProperty = {
    */
   key: string;
   /**
-   * Value of the property used to identify a subscription _(defaults to `subscription`)_
+   * Value of the property used to identify a subscription
    */
-  value?: unknown;
+  value: unknown;
+};
+type Subscriptions = {
+  /**
+   * Items of the subscriptions store
+   *
+   * - `any` - Set of subscriptions _(for unkeyed subscriptions)_
+   * - `keyed` - Map of keys to sets of subscriptions _(for keyed subscriptions)_
+   */
+  readonly items: Readonly<SubscriptionsItems>;
+  /**
+   * Values of the subscriptions store
+   *
+   * - `from.any` - Map of values to subscriptions _(for unkeyed subscriptions)_
+   * - `from.keyed` - Map of keys to maps of values to subscriptions _(for keyed subscriptions)_
+   * - `to.any` - Map of subscriptions to values _(for unkeyed subscriptions)_
+   * - `to.keyed` - Map of keys to maps of subscriptions to values _(for keyed subscriptions)_
+   */
+  readonly values: Readonly<SubscriptionsValues>;
+  /**
+   * Clear all subscriptions
+   */
+  clear: () => void;
+  /**
+   * Create _(or retrieve)_ a subscription
+   *
+   * @param parameters Subscription parameters
+   * @returns Tuple holding subsccription and existing boolean
+   */
+  create: (parameters: SubscriptionParameters) => [Subscription, boolean];
+};
+/**
+ * Parameters for creating a subscription store
+ */
+type SubscriptionsParameters = {
+  /**
+   * Allow any or specific keys for subscriptions? _(defaults to `false`, which prevents keyed subscriptions)_
+   */
+  keys?: boolean | Set<Key$1>;
+  /**
+   * Property information for subscription identification
+   */
+  property?: SubscriptionProperty;
+};
+type SubscriptionsItems = {
+  any: Set<Subscription>;
+  keyed?: Map<Key$1, Set<Subscription>>;
+};
+type SubscriptionsValues = {
+  from: SubscriptionsValuesItem<unknown, Subscription>;
+  to: SubscriptionsValuesItem<Subscription, unknown>;
+};
+type SubscriptionsValuesItem<MapKey, MapValue> = {
+  any: Map<MapKey, MapValue>;
+  keyed?: Map<Key$1, Map<MapKey, MapValue>>;
 };
 /**
  * Is the value a subscription?
@@ -6743,6 +6818,20 @@ type SubscriptionProperty = {
  * @returns `true` if the value is a subscription, otherwise `false`
  */
 export declare function isSubscription(value: unknown): value is Subscription;
+/**
+ * Is the value a subscriptions store?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is a subscriptions store, otherwise `false`
+ */
+export declare function isSubscriptions(value: unknown): value is Subscriptions;
+/**
+ * Create a subscription store
+ *
+ * @param parameters Store parameters
+ * @returns Subscription store
+ */
+export declare function subscriptions(parameters?: SubscriptionsParameters): Subscriptions;
 //#endregion
 //#region src/beacon.d.ts
 /**
@@ -8559,4 +8648,4 @@ export declare class SizedSet<Value = unknown> extends Set<Value> {
   get(value: Value, update?: boolean): Value | undefined;
 }
 //#endregion
-export { type Color, type ColorType, type ColorTypeExtended, type ColorValue, type ColorValueExtended, type HSLAColor, type HSLColor, type HWBAColor, type HWBColor, Key$1 as Key, Logger, type RGBAColor, type RGBColor, type Shaken, type Smushed, type Subscription, type TimedLogger, type Unsmushed, toPromise as fromResult, getRandomFloatingNumber as getRandomFloat, isLogger, isTimedLogger };
+export { type Color, type ColorType, type ColorTypeExtended, type ColorValue, type ColorValueExtended, type HSLAColor, type HSLColor, type HWBAColor, type HWBColor, Key$1 as Key, Logger, type RGBAColor, type RGBColor, type Shaken, type Smushed, type Subscription, type SubscriptionParameters, type SubscriptionProperty, type Subscriptions, type SubscriptionsParameters, type TimedLogger, type Unsmushed, toPromise as fromResult, getRandomFloatingNumber as getRandomFloat, isLogger, isTimedLogger };