@oscarpalmer/atoms 0.205.0 → 0.207.0

package/dist/promise/index.mjs

@@ -1,6 +1,7 @@
 import { isArrayOrPlainObject } from "../internal/is.mjs";
 import { createAborter } from "../internal/aborter.mjs";
-import { PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_ITEMS_EMPTY, PROMISE_MESSAGE_EXPECTATION_ITEMS_TYPE, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED } from "./constants.mjs";
+import { asyncAttempt } from "../internal/result/attempt.mjs";
+import { PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_ITEMS_TYPE, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED } from "./constants.mjs";
 import { createPromiseOptions, createPromisesOptions, getResultsFromPromises } from "./helpers.mjs";
 import { handleResult, settlePromise } from "./misc.mjs";
 import { getTimedPromise } from "./timed.mjs";
@@ -14,13 +15,13 @@ async function attemptPromise(value, options) {
 		rejector(signal?.reason);
 	});
 	async function handler(resolve, reject) {
-		try {
+		const result = await asyncAttempt(async () => {
 			let result = isFunction ? value() : await value;
 			if (result instanceof Promise) result = await result;
-			settlePromise(resolve, result, aborter);
-		} catch (error) {
-			settlePromise(reject, error, aborter);
-		}
+			return result;
+		});
+		if (result.ok) settlePromise(resolve, result.value, aborter);
+		else settlePromise(reject, result.error, aborter);
 	}
 	let rejector;
 	const promise = new Promise((resolve, reject) => {
@@ -35,12 +36,11 @@ async function promises(items, options) {
 	if (!isArrayOrPlainObject(items)) return Promise.reject(PROMISE_MESSAGE_EXPECTATION_ITEMS_TYPE);
 	const isArray = Array.isArray(items);
 	const actual = (isArray ? items.map((item, index) => [index, item]) : Object.entries(items)).map(([key, value]) => [key, typeof value === "function" ? value() : value]).filter(([, value]) => value instanceof Promise);
-	const { length } = actual;
-	if (length === 0) return Promise.reject(PROMISE_MESSAGE_EXPECTATION_ITEMS_EMPTY);
-	const complete = strategy === PROMISE_STRATEGY_DEFAULT;
 	const aborter = createAborter(signal, () => {
 		handlers.reject(signal?.reason);
 	});
+	const complete = strategy === PROMISE_STRATEGY_DEFAULT;
+	const { length } = actual;
 	const data = {
 		last: length - 1,
 		result: isArray ? [] : {}

package/dist/promise/misc.d.mts

@@ -1,4 +1,4 @@
-import { Result } from "../internal/result/models.mjs";
+import { Result } from "../internal/models/result.model.mjs";
 import { Aborter } from "../internal/aborter.mjs";
 import { CancelablePromise, PromiseParameters } from "./models.mjs";
 import { toPromise } from "../result/misc.mjs";

package/dist/promise/misc.mjs

@@ -1,8 +1,8 @@
 import { error, ok } from "../internal/result/misc.mjs";
+import { toPromise } from "../result/misc.mjs";
 import { PROMISE_MESSAGE_EXPECTATION_RESULT } from "./constants.mjs";
 import { CancelablePromise } from "./models.mjs";
 import { isFulfilled, isRejected } from "./helpers.mjs";
-import { toPromise } from "../result/misc.mjs";
 //#region src/promise/misc.ts
 /**
 * Create a cancelable _Promise_

package/dist/promise/models.d.mts

@@ -1,5 +1,5 @@
 import { ArrayOrPlainObject, GenericCallback, Key } from "../models.mjs";
-import { Result } from "../internal/result/models.mjs";
+import { Result } from "../internal/models/result.model.mjs";
 import { Aborter } from "../internal/aborter.mjs";
 import { PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED } from "./constants.mjs";
 //#region src/promise/models.d.ts

package/dist/queue.mjs

@@ -1,4 +1,6 @@
 import { createAborter } from "./internal/aborter.mjs";
+import { min } from "./internal/math/aggregate.mjs";
+import { asyncAttempt } from "./internal/result/attempt.mjs";
 import { getBooleanOrDefault, getNumberOrDefault } from "./internal/defaults.mjs";
 //#region src/queue.ts
 const QUEUE_NAME_KEYED = "keyedQueue";
@@ -333,7 +335,7 @@ function resumeQueue() {
 		for (let index = 0; index < length; index += 1) handled[index]();
 	}
 	state.paused = false;
-	const length = Math.min(state.options.concurrency, state.items.length);
+	const length = min([state.options.concurrency, state.items.length]);
 	for (let index = 0; index < length; index += 1) run(state);
 }
 function resumeQueues(key) {
@@ -346,14 +348,17 @@ async function run(state) {
 	while (item != null) {
 		let error = false;
 		let result;
-		try {
-			if (!(item.aborter?.signal?.aborted ?? false)) {
+		const attempted = await asyncAttempt(async () => {
+			if (item != null && !(item.aborter?.signal?.aborted ?? false)) {
 				const parameters = item.key == null ? item.parameters : [item.key, ...item.parameters];
-				result = await state.callback(...parameters);
+				return await state.callback(...parameters);
 			}
-		} catch (thrown) {
+			throw new Error();
+		});
+		if (attempted.ok) result = attempted.value;
+		else {
 			error = true;
-			result = thrown;
+			result = attempted.error;
 		}
 		if (state.paused) {
 			const paused = item;

package/dist/result/index.d.mts

@@ -1,59 +1,2 @@
-import { ExtendedResult, Result } from "../internal/result/models.mjs";
-//#region src/result/index.d.ts
-/**
- * Executes a _Promise_, catching any errors, and returns a result
- *
- * _Available as `asyncAttempt` and `attempt.async`_
- *
- * @param promise _Promise_ to execute
- * @param error Error value
- * @returns Callback result
- */
-export declare function asyncAttempt<Value, E>(promise: Promise<Value>, error: E): Promise<ExtendedResult<Awaited<Value>, E>>;
-/**
- * Executes a callback asynchronously, catching any errors, and returns a result
- *
- * _Available as `asyncAttempt` and `attempt.async`_
- *
- * @param callback Callback to execute
- * @param error Error value
- * @returns Callback result
- */
-export declare function asyncAttempt<Value, E>(callback: () => Promise<Value>, error: E): Promise<ExtendedResult<Awaited<Value>, E>>;
-/**
- * Executes a _Promise_, catching any errors, and returns a result
- *
- * _Available as `asyncAttempt` and `attempt.async`_
- *
- * @param promise _Promise_ to execute
- * @returns Callback result
- */
-export declare function asyncAttempt<Value>(promise: Promise<Value>): Promise<Result<Awaited<Value>>>;
-/**
- * Executes a callback asynchronously, catching any errors, and returns a result
- *
- * _Available as `asyncAttempt` and `attempt.async`_
- *
- * @param callback Callback to execute
- * @returns Callback result
- */
-export declare function asyncAttempt<Value>(callback: () => Promise<Value>): Promise<Result<Awaited<Value>>>;
-/**
- * Executes a callback, catching any errors, and returns a result
- *
- * @param callback Callback to execute
- * @param error Error value
- * @returns Callback result
- */
-export declare function attempt<Value, E>(callback: () => Value, error: E): ExtendedResult<Value, E>;
-/**
- * Executes a callback, catching any errors, and returns a result
- *
- * @param callback Callback to execute
- * @returns Callback result
- */
-export declare function attempt<Value>(callback: () => Value): Result<Value, Error>;
-export declare namespace attempt {
-  export var async: typeof asyncAttempt;
-}
-//#endregion
+import { asyncAttempt, attempt } from "../internal/result/attempt.mjs";
+export { asyncAttempt, attempt };

package/dist/result/index.mjs

@@ -1,24 +1,2 @@
-import { getError, ok } from "../internal/result/misc.mjs";
-//#region src/result/index.ts
-async function asyncAttempt(value, err) {
-	try {
-		let result;
-		if (typeof value === "function") result = value();
-		else result = value;
-		if (result instanceof Promise) result = await result;
-		return ok(result);
-	} catch (thrown) {
-		return getError(err ?? thrown, err == null ? void 0 : thrown);
-	}
-}
-function attempt(callback, err) {
-	try {
-		const value = callback();
-		return ok(value);
-	} catch (thrown) {
-		return getError(err ?? thrown, err == null ? void 0 : thrown);
-	}
-}
-attempt.async = asyncAttempt;
-//#endregion
+import { asyncAttempt, attempt } from "../internal/result/attempt.mjs";
 export { asyncAttempt, attempt };

package/dist/result/match.d.mts

@@ -1,4 +1,4 @@
-import { AnyResult, ResultMatch } from "../internal/result/models.mjs";
+import { AnyResult, ResultMatch } from "../internal/models/result.model.mjs";
 //#region src/result/match.d.ts
 /**
  * Handles a _Result_ with match callbacks

package/dist/result/misc.d.mts

@@ -1,4 +1,4 @@
-import { AnyResult } from "../internal/result/models.mjs";
+import { AnyResult } from "../internal/models/result.model.mjs";
 import { error, isError, isOk, isResult, ok, unwrap } from "../internal/result/misc.mjs";
 //#region src/result/misc.d.ts
 /**

package/dist/result/work/flow.d.mts

@@ -1,5 +1,5 @@
 import { GenericCallback } from "../../models.mjs";
-import { Result, UnwrapValue } from "../../internal/result/models.mjs";
+import { Result, UnwrapValue } from "../../internal/models/result.model.mjs";
 //#region src/result/work/flow.d.ts
 /**
  * A synchronous _Flow_, a function that attempts to pipe values through a series of functions

package/dist/result/work/flow.mjs

@@ -1,6 +1,7 @@
 import { isError, isOk } from "../../internal/result/misc.mjs";
+import { asyncAttempt, attempt } from "../../internal/result/attempt.mjs";
 import { asyncFlow, flow } from "../../internal/function/work.mjs";
-import { asyncAttempt, attempt } from "../index.mjs";
+import "../index.mjs";
 //#region src/result/work/flow.ts
 function attemptAsyncFlow(...fns) {
 	let Flow;

package/dist/result/work/pipe.d.mts

@@ -1,5 +1,5 @@
 import { GenericCallback } from "../../models.mjs";
-import { Result, UnwrapValue } from "../../internal/result/models.mjs";
+import { Result, UnwrapValue } from "../../internal/models/result.model.mjs";
 //#region src/result/work/pipe.d.ts
 type WrapValue<Value> = Result<UnwrapValue<Value>>;
 /**

package/dist/result/work/pipe.mjs

@@ -1,6 +1,7 @@
 import { isError, isOk } from "../../internal/result/misc.mjs";
+import { asyncAttempt, attempt } from "../../internal/result/attempt.mjs";
 import { asyncPipe, pipe } from "../../internal/function/work.mjs";
-import { asyncAttempt, attempt } from "../index.mjs";
+import "../index.mjs";
 //#region src/result/work/pipe.ts
 async function attemptAsyncPipe(initial, first, ...seconds) {
 	return asyncAttempt(() => {

package/dist/string/fuzzy.mjs

@@ -1,4 +1,6 @@
 import { isPlainObject } from "../internal/is.mjs";
+import { floor } from "../internal/math/misc.mjs";
+import { max } from "../internal/math/aggregate.mjs";
 import { getString } from "../internal/string/misc.mjs";
 import { lowerCase } from "../internal/string/case.mjs";
 import { includes } from "./match.mjs";
@@ -27,7 +29,7 @@ function createFuzzyItems(items) {
 function createFuzzyOptions(input, state) {
 	const options = isPlainObject(input) ? input : {};
 	const limit = typeof input === "number" ? input : options.limit;
-	if (typeof limit === "number" && !Number.isNaN(limit) && limit >= 1) options.limit = Math.floor(limit);
+	if (typeof limit === "number" && !Number.isNaN(limit) && limit >= 1) options.limit = floor(limit);
 	else options.limit = state?.limit;
 	options.tolerance = getTolerance(options.tolerance, state);
 	return options;
@@ -92,18 +94,18 @@ function getScore(haystack, needle) {
 			if (haystackIndex === 0) score += 1;
 			if (previousMatchIndex !== -1) {
 				const gap = haystackIndex - previousMatchIndex - 1;
-				score += Math.max(0, FUZZY_PROXIMITY_THRESHOLD - gap);
+				score += max([0, FUZZY_PROXIMITY_THRESHOLD - gap]);
 			}
 			previousMatchIndex = haystackIndex;
 			needleIndex += 1;
 		}
 		if (needleIndex === needleLength) break;
 	}
-	score -= Math.floor(lowerCaseHaystack.length / FUZZY_LENGTH_DIVISOR);
-	return Math.max(0, score);
+	score -= floor(lowerCaseHaystack.length / FUZZY_LENGTH_DIVISOR);
+	return max([0, score]);
 }
 function getTolerance(input, state) {
-	if (typeof input === "number" && !Number.isNaN(input)) return input < 0 ? 0 : Math.floor(input);
+	if (typeof input === "number" && !Number.isNaN(input)) return input < 0 ? 0 : floor(input);
 	return state?.tolerance ?? FUZZY_PROXIMITY_THRESHOLD;
 }
 /**

package/dist/string/index.mjs

@@ -1,4 +1,5 @@
 import { isTemplateStringsArray } from "../internal/is.mjs";
+import { min } from "../internal/math/aggregate.mjs";
 import { getString, interpolate, join, words } from "../internal/string/misc.mjs";
 //#region src/string/index.ts
 function dedent(value, ...values) {
@@ -16,7 +17,7 @@ function dedent(value, ...values) {
 		if (indentation != null) lengths.push(indentation.length);
 	}
 	if (lengths.length === 0) return actual.trim();
-	const minimum = Math.min(...lengths);
+	const minimum = min(lengths);
 	const pattern = new RegExp(`^\\s{0,${minimum}}`);
 	let result = "";
 	for (let index = 0; index < length; index += 1) {

package/dist/value/clone.mjs

@@ -1,4 +1,6 @@
 import { isArrayOrPlainObject, isTypedArray } from "../internal/is.mjs";
+import { unwrap } from "../internal/result/misc.mjs";
+import { attempt } from "../internal/result/attempt.mjs";
 import { createValueHandler } from "../internal/value/handlers.mjs";
 //#region src/value/clone.ts
 const CLONE_NAME = "clone";
@@ -154,14 +156,9 @@ function registerCloner(constructor, handler) {
 }
 function tryStructuredClone(value, parameters, depth) {
 	if (depth >= CLONE_MAX_DEPTH) return value;
-	try {
-		const cloned = structuredClone(value);
-		parameters.references.set(value, cloned);
-		return cloned;
-	} catch {
-		parameters.references.set(value, value);
-		return value;
-	}
+	const cloned = unwrap(attempt(() => structuredClone(value)), value);
+	parameters.references.set(value, cloned);
+	return cloned;
 }
 const CLONE_COPY_OPTIONS = {
 	copyFunctions: true,

package/dist/value/diff.mjs

@@ -1,4 +1,5 @@
 import { isArrayOrPlainObject } from "../internal/is.mjs";
+import { max, min } from "../internal/math/aggregate.mjs";
 import { join } from "../internal/string/misc.mjs";
 import { equal } from "../internal/value/equal.mjs";
 //#region src/value/diff.ts
@@ -70,8 +71,8 @@ function getChanges(changes, first, second, options, prefix) {
 function getDiffs(first, second, options, prefix) {
 	const changes = [];
 	if (Array.isArray(first) && Array.isArray(second)) {
-		const maximumLength = Math.max(first.length, second.length);
-		const minimumLength = Math.min(first.length, second.length);
+		const maximumLength = max([first.length, second.length]);
+		const minimumLength = min([first.length, second.length]);
 		for (let index = minimumLength; index < maximumLength; index += 1) {
 			const key = join([prefix, index], ".");
 			changes.push({

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oscarpalmer/atoms",
-	"version": "0.205.0",
+	"version": "0.207.0",
 	"description": "Atomic utilities for making your JavaScript better.",
 	"keywords": [
 		"array",
@@ -149,6 +149,13 @@
 			"types": "./dist/number.d.mts",
 			"default": "./dist/number.mjs"
 		},
+		"./plan": {
+			"types": "./dist/plan/index.d.mts",
+			"default": "./dist/plan/index.mjs"
+		},
+		"./plan/models": {
+			"default": "./dist/plan/models.mjs"
+		},
 		"./promise": {
 			"types": "./dist/promise/index.d.mts",
 			"default": "./dist/promise/index.mjs"
@@ -162,7 +169,6 @@
 			"default": "./dist/promise/misc.mjs"
 		},
 		"./promise/models": {
-			"types": "./dist/promise/models.d.mts",
 			"default": "./dist/promise/models.mjs"
 		},
 		"./promise/timed": {
@@ -198,8 +204,7 @@
 			"default": "./dist/result/misc.mjs"
 		},
 		"./result/models": {
-			"types": "./dist/internal/result/models.d.mts",
-			"default": "./dist/internal/result/models.mjs"
+			"default": "./dist/internal/models/result.model.mjs"
 		},
 		"./result/pipe": {
 			"types": "./dist/result/work/pipe.d.mts",