@oscarpalmer/atoms 0.204.1 → 0.206.0

package/dist/color/constants.d.mts

@@ -1,17 +1,17 @@
 import { SubscriptionProperty } from "../internal/subscription.mjs";
-import { ColorTypeExtended, HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "./models.mjs";
+import { ColorDefaults, ColorExpressions, ColorTypeExtended, HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "./models.mjs";
 //#region src/color/constants.d.ts
 type ColorTypes = {
-  all: Set<'alpha' | ColorTypeExtended>;
-  hex: 'hex';
-  hexa: 'hexa';
-  hsl: 'hsl';
-  hsla: 'hsla';
-  hwb: 'hwb';
-  hwba: 'hwba';
-  rgb: 'rgb';
-  rgba: 'rgba';
-  wildcard: '*';
+  all: Set<"alpha" | ColorTypeExtended>;
+  hex: "hex";
+  hexa: "hexa";
+  hsl: "hsl";
+  hsla: "hsla";
+  hwb: "hwb";
+  hwba: "hwba";
+  rgb: "rgb";
+  rgba: "rgba";
+  wildcard: "*";
 };
 export declare const COLOR_ALPHA: {
   fullHexShort: string;
@@ -20,35 +20,8 @@ export declare const COLOR_ALPHA: {
   noneHex: string;
   noneValue: number;
 };
-export declare const COLOR_DEFAULTS: {
-  alpha: {
-    hex: string;
-    value: number;
-  };
-  hexBlack: string;
-  hexWhite: string;
-  hsl: {
-    hue: number;
-    saturation: number;
-    lightness: number;
-  };
-  hwb: {
-    hue: number;
-    whiteness: number;
-    blackness: number;
-  };
-  rgb: {
-    blue: number;
-    green: number;
-    red: number;
-  };
-};
-export declare const COLOR_EXPRESSION: {
-  alphaHex: RegExp;
-  hexLong: RegExp;
-  hexShort: RegExp;
-  prefix: RegExp;
-};
+export declare const COLOR_DEFAULTS: ColorDefaults;
+export declare const COLOR_EXPRESSION: ColorExpressions;
 export declare const COLOR_LENGTHS: {
   hexLong: number;
   hexShort: number;
@@ -68,7 +41,7 @@ export declare const COLOR_MAX: {
 };
 export declare const COLOR_NAME = "color";
 export declare const COLOR_PROPERTY = "$color";
-export declare const COLOR_SYMBOL: unique symbol;
+export declare const COLOR_SYMBOL: symbol;
 export declare const COLOR_TYPE: ColorTypes;
 export declare const COLOR_SRGB: {
   luminanceBlue: number;

package/dist/color/instance.d.mts

@@ -1,5 +1,4 @@
 import { Color } from "./models.mjs";
 //#region src/color/instance.d.ts
-declare function Color(this: any, value: unknown): void;
 export declare function color(value: unknown): Color;
 //#endregion

package/dist/color/misc/alpha.mjs

@@ -1,6 +1,6 @@
+import { round } from "../../internal/math/misc.mjs";
 import { clamp } from "../../internal/number.mjs";
 import { COLOR_ALPHA, COLOR_DEFAULTS, COLOR_EXPRESSION, COLOR_MAX, COLOR_SYMBOL } from "../constants.mjs";
-import { round } from "../../internal/math/misc.mjs";
 //#region src/color/misc/alpha.ts
 function getAlpha(value, hex) {
 	if (typeof value === "number") return getAlphaFromValue(value);

package/dist/color/misc/get.mjs

@@ -1,6 +1,6 @@
+import { round } from "../../internal/math/misc.mjs";
 import { clamp } from "../../internal/number.mjs";
 import { COLOR_DEFAULTS, COLOR_MAX, COLOR_SRGB, COLOR_TYPE } from "../constants.mjs";
-import { round } from "../../internal/math/misc.mjs";
 import { getColorFromState, getColorState } from "./state.mjs";
 import { color } from "../instance.mjs";
 //#region src/color/misc/get.ts

package/dist/color/misc/state.d.mts

@@ -1,34 +1,7 @@
-import { ColorState, ColorType, InternalColor } from "../models.mjs";
+import { ColorState, ColorType, HSLAColor, HSLColor, HWBAColor, HWBColor, InternalColor, RGBAColor, RGBColor } from "../models.mjs";
 //#region src/color/misc/state.d.ts
 export declare function getColorFromState<Type extends ColorType>(state: ColorState, type: Type): NonNullable<ColorState[Type]>;
 export declare function getColorState(value: unknown): ColorState;
-export declare function getStateValue(instance: InternalColor, type: ColorType, alpha: boolean): string | {
-  alpha: number;
-  hue: number;
-  lightness: number;
-  saturation: number;
-} | {
-  alpha: number;
-  blackness: number;
-  hue: number;
-  whiteness: number;
-} | {
-  alpha: number;
-  blue: number;
-  green: number;
-  red: number;
-} | {
-  hue: number;
-  lightness: number;
-  saturation: number;
-} | {
-  blackness: number;
-  hue: number;
-  whiteness: number;
-} | {
-  blue: number;
-  green: number;
-  red: number;
-};
+export declare function getStateValue(instance: InternalColor, type: ColorType, alpha: boolean): string | HSLAColor | HSLColor | HWBAColor | HWBColor | RGBAColor | RGBColor;
 export declare function setStateValue<Type extends ColorType>(instance: InternalColor, type: Type, value: ColorState[Type], alpha?: number | string): void;
 //#endregion

package/dist/color/models.d.mts

@@ -187,7 +187,7 @@ export type Color = {
   unsubscribe(): void;
 };
 export type ColorChanges = {
-  '*': (value: Color) => void;
+  "*": (value: Color) => void;
   alpha: (value: number) => void;
   hex: (value: string) => void;
   hexa: (value: string) => void;
@@ -198,6 +198,20 @@ export type ColorChanges = {
   rgb: (value: RGBColor) => void;
   rgba: (value: RGBAColor) => void;
 };
+export type ColorDefaults = {
+  alpha: Alpha;
+  hexBlack: string;
+  hexWhite: string;
+  hsl: HSLColor;
+  hwb: HWBColor;
+  rgb: RGBColor;
+};
+export type ColorExpressions = {
+  alphaHex: RegExp;
+  hexLong: RegExp;
+  hexShort: RegExp;
+  prefix: RegExp;
+};
 type ColorWithAlpha = {
   /**
    * Alpha channel _(opacity)_ of the color _(in percentage; 0-100)_
@@ -268,7 +282,7 @@ export type RGBColor = {
    */
   red: number;
 };
-export type ColorProperty = 'alpha' | keyof HSLColor | keyof HWBColor | keyof RGBColor;
+export type ColorProperty = "alpha" | keyof HSLColor | keyof HWBColor | keyof RGBColor;
 export type ColorState = {
   alpha: Alpha;
   hex?: string;
@@ -280,11 +294,11 @@ export type ColorState = {
 /**
  * Base color types
  */
-export type ColorType = 'hex' | 'hsl' | 'hwb' | 'rgb';
+export type ColorType = "hex" | "hsl" | "hwb" | "rgb";
 /**
  * Extended color types
  */
-export type ColorTypeExtended = ColorType | 'hsla' | 'hwba' | 'rgba';
+export type ColorTypeExtended = ColorType | "hsla" | "hwba" | "rgba";
 /**
  * Base color values
  */

package/dist/color/space/hsl.mjs

@@ -1,3 +1,4 @@
+import { max, min } from "../../internal/math/aggregate.mjs";
 import { COLOR_DEFAULTS, COLOR_MAX, COLOR_TYPE } from "../constants.mjs";
 import { getAlphaValue } from "../misc/alpha.mjs";
 import { getDegrees, getHexValue, getPercentage } from "../misc/get.mjs";
@@ -9,7 +10,7 @@ function convertHslToHwba(input) {
 	let { hue, lightness, saturation } = isHslLike(input) ? getHslValues(input) : { ...COLOR_DEFAULTS.hsl };
 	lightness /= COLOR_MAX.percent;
 	saturation /= COLOR_MAX.percent;
-	const value = lightness + saturation * Math.min(lightness, 1 - lightness);
+	const value = lightness + saturation * min([lightness, 1 - lightness]);
 	if (value === 0) saturation = 0;
 	else saturation = 2 * (1 - lightness / value);
 	const blackness = 1 - value;
@@ -46,7 +47,11 @@ function getColorFromHsl(state, type) {
 }
 function getHexyValue(hue, lightness, saturation, value) {
 	const part = (value + hue / 30) % 12;
-	return (lightness - saturation * Math.min(lightness, 1 - lightness) * Math.max(-1, Math.min(part - 3, 9 - part, 1))) * COLOR_MAX.hex;
+	return (lightness - saturation * min([lightness, 1 - lightness]) * max([-1, min([
+		part - 3,
+		9 - part,
+		1
+	])])) * COLOR_MAX.hex;
 }
 function getHslValue() {
 	return getStateValue(this, COLOR_TYPE.hsl, false);

package/dist/color/space/hwb.mjs

@@ -1,3 +1,4 @@
+import { min } from "../../internal/math/aggregate.mjs";
 import { COLOR_DEFAULTS, COLOR_MAX, COLOR_TYPE } from "../constants.mjs";
 import { getAlphaValue } from "../misc/alpha.mjs";
 import { getDegrees, getPercentage } from "../misc/get.mjs";
@@ -38,7 +39,7 @@ function getColorFromHwb(state, type) {
 function getHwbSaturation(blackness, whiteness, lightness) {
 	const hue = 1 - blackness - whiteness;
 	if (hue <= 0) return 0;
-	return hue / Math.min(2 * lightness, 2 - 2 * lightness);
+	return hue / min([2 * lightness, 2 - 2 * lightness]);
 }
 function getHwbValue() {
 	return getStateValue(this, COLOR_TYPE.hwb, false);

package/dist/color/space/rgb.mjs

@@ -1,3 +1,4 @@
+import { max, min } from "../../internal/math/aggregate.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";
@@ -20,12 +21,12 @@ function convertRgbToHex(rgb, alpha) {
 }
 function convertRgbToHsla(value) {
 	const values = getRgbCalculationValues(isRgbLike(value) ? getRgbValues(value) : { ...COLOR_DEFAULTS.rgb });
-	const { delta, max, min } = values;
-	const lightness = (min + max) / 2;
+	const { delta, maximum, minimum } = values;
+	const lightness = (minimum + maximum) / 2;
 	let hue = 0;
 	let saturation = 0;
 	if (delta !== 0) {
-		saturation = (max - lightness) / Math.min(lightness, 1 - lightness);
+		saturation = (maximum - lightness) / min([lightness, 1 - lightness]);
 		hue = getRgbHue(values);
 		hue *= 60;
 	}
@@ -38,7 +39,7 @@ function convertRgbToHsla(value) {
 }
 function convertRgbToHwba(value) {
 	const values = getRgbCalculationValues(isRgbLike(value) ? getRgbValues(value) : { ...COLOR_DEFAULTS.rgb });
-	const { delta, max, min } = values;
+	const { delta, maximum, minimum } = values;
 	let hue = 0;
 	if (delta !== 0) {
 		hue = getRgbHue(values);
@@ -46,8 +47,8 @@ function convertRgbToHwba(value) {
 	}
 	return {
 		hue,
-		whiteness: min * COLOR_MAX.percent,
-		blackness: (1 - max) * COLOR_MAX.percent,
+		whiteness: minimum * COLOR_MAX.percent,
+		blackness: (1 - maximum) * COLOR_MAX.percent,
 		alpha: getAlphaValue(value?.alpha ?? COLOR_MAX.percent)
 	};
 }
@@ -67,14 +68,22 @@ function getRgbCalculationValues(rgb) {
 	const blue = rgb.blue / COLOR_MAX.hex;
 	const green = rgb.green / COLOR_MAX.hex;
 	const red = rgb.red / COLOR_MAX.hex;
-	const max = Math.max(blue, green, red);
-	const min = Math.min(blue, green, red);
+	const maximum = max([
+		blue,
+		green,
+		red
+	]);
+	const minimum = min([
+		blue,
+		green,
+		red
+	]);
 	return {
 		blue,
-		delta: max - min,
+		delta: maximum - minimum,
 		green,
-		max,
-		min,
+		maximum,
+		minimum,
 		red
 	};
 }
@@ -85,8 +94,8 @@ function getRgbaColor() {
 	return getStateValue(this, COLOR_TYPE.rgb, true);
 }
 function getRgbHue(values) {
-	const { blue, delta, green, max, red } = values;
-	switch (max) {
+	const { blue, delta, green, maximum, red } = values;
+	switch (maximum) {
 		case blue: return (red - green) / delta + 4;
 		case green: return (blue - red) / delta + 2;
 		default: return (green - blue) / delta + (green < blue ? 6 : 0);

package/dist/function/limit.d.mts

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

package/dist/function/once.d.mts

@@ -1,7 +1,5 @@
 import { GenericAsyncCallback, GenericCallback, Once, OnceAsync } from "../models.mjs";
 //#region src/function/once.d.ts
-declare function OnceAsync(this: any, callback: GenericAsyncCallback): void;
-declare function Once(this: any, callback: GenericCallback): void;
 /**
  * Create an asynchronous function that can only be called once, rejecting or resolving the same result on subsequent calls
  *
@@ -11,9 +9,6 @@ declare function Once(this: any, callback: GenericCallback): void;
  * @returns _Once_ callback
  */
 export declare function asyncOnce<Callback extends GenericAsyncCallback>(callback: Callback): OnceAsync<Callback>;
-export declare namespace asyncOnce {
-  var is: typeof isAsyncOnce;
-}
 /**
  * Is the value an asynchronous once callback?
  *
@@ -35,9 +30,12 @@ export declare function isOnce(value: unknown): boolean;
  * @returns _Once_ callback
  */
 export declare function once<Callback extends GenericCallback>(callback: Callback): Once<Callback>;
+export declare namespace asyncOnce {
+  export var is: typeof isAsyncOnce;
+}
 export declare namespace once {
-  var async: typeof asyncOnce;
-  var is: typeof isOnce;
-  var isAsync: typeof isAsyncOnce;
+  export var async: typeof asyncOnce;
+  export var is: typeof isOnce;
+  export var isAsync: typeof isAsyncOnce;
 }
 //#endregion

package/dist/function/retry.d.mts

@@ -39,8 +39,8 @@ declare function asyncRetry<Callback extends GenericCallback>(callback: Callback
  * @param options Retry options
  * @returns Callback result
  */
-export declare function retry<Callback extends GenericCallback>(callback: Callback, options?: Omit<RetryOptions, 'delay'>): ReturnType<Callback>;
+export declare function retry<Callback extends GenericCallback>(callback: Callback, options?: Omit<RetryOptions, "delay">): ReturnType<Callback>;
 export declare namespace retry {
-  var async: typeof asyncRetry;
+  export var async: typeof asyncRetry;
 }
 //#endregion

package/dist/function/retry.mjs

@@ -1,4 +1,5 @@
 import { isPlainObject } from "../internal/is.mjs";
+import { asyncAttempt, attempt } from "../internal/result/attempt.mjs";
 import { getNumberOrDefault } from "../internal/defaults.mjs";
 import { LIMITER_WAIT, getLimiter } from "../internal/function/limit.mjs";
 //#region src/function/retry.ts
@@ -25,15 +26,12 @@ var RetryError = class extends Error {
 async function asyncRetry(callback, options) {
 	if (typeof callback !== "function") throw new TypeError(RETRY_MESSAGE_EXPECTATION);
 	async function handle() {
-		try {
-			const result = await callback();
-			resolver(result);
-		} catch (error) {
-			if (attempts >= times || !when(error)) rejector(new RetryError(RETRY_MESSAGE_FAILED, error));
-			else {
-				attempts += 1;
-				limiter.run();
-			}
+		const result = await asyncAttempt(async () => callback());
+		if (result.ok) resolver(result.value);
+		else if (attempts >= times || !when(result.error)) rejector(new RetryError(RETRY_MESSAGE_FAILED, result.error));
+		else {
+			attempts += 1;
+			limiter.run();
 		}
 	}
 	const { delay, times, when } = createRetryOptions(options);
@@ -66,11 +64,11 @@ function retry(callback, options) {
 	if (typeof callback !== "function") throw new TypeError(RETRY_MESSAGE_EXPECTATION);
 	const { times, when } = createRetryOptions(options);
 	let last;
-	for (let index = 0; index <= times; index += 1) try {
-		return callback();
-	} catch (error) {
-		if (index >= times || !when(error)) {
-			last = error;
+	for (let index = 0; index <= times; index += 1) {
+		const result = attempt(callback);
+		if (result.ok) return result.value;
+		if (index >= times || !when(result.error)) {
+			last = result.error;
 			break;
 		}
 	}