@oscarpalmer/atoms 0.146.0 → 0.148.0

package/dist/array/from.js

@@ -0,0 +1,18 @@
+function range(first, second, third) {
+	const start = typeof second === "number" ? first : 0;
+	const end = typeof second === "number" ? second : first;
+	const step = typeof third === "number" ? third : 1;
+	const values = [];
+	if (step === 0) return values;
+	if (step > 0) for (let i = start; i < end; i += step) values.push(i);
+	else for (let i = start; i > end; i += step) values.push(i);
+	return values;
+}
+function times(length, value) {
+	if (typeof length !== "number" || length <= 0) return [];
+	const isFunction = typeof value === "function";
+	const values = [];
+	for (let index = 0; index < length; index += 1) values.push(isFunction ? value(index) : value ?? index);
+	return values;
+}
+export { range, times };

package/dist/array/misc.js

@@ -2,6 +2,7 @@ import { exists } from "./exists.js";
 import { filter } from "./filter.js";
 import { find } from "./find.js";
 import { flatten } from "./flatten.js";
+import { range, times } from "./from.js";
 import { getArray } from "./get.js";
 import { indexOf } from "./index-of.js";
 import { chunk } from "../internal/array/chunk.js";
@@ -10,11 +11,10 @@ import { compact } from "../internal/array/compact.js";
 import { shuffle } from "../internal/array/shuffle.js";
 import { partition } from "./partition.js";
 import { push } from "./push.js";
-import { range } from "./range.js";
 import { select } from "./select.js";
 import { sort } from "./sort.js";
 import { splice } from "./splice.js";
 import { toSet } from "./to-set.js";
 import { toggle } from "./toggle.js";
 import { update } from "./update.js";
-export { chunk, compact, exists, filter, find, flatten, getArray, indexOf, insert, partition, push, range, select, shuffle, sort, splice, toSet, toggle, update };
+export { chunk, compact, exists, filter, find, flatten, getArray, indexOf, insert, partition, push, range, select, shuffle, sort, splice, times, toSet, toggle, update };

package/dist/atoms.full.js

@@ -284,6 +284,23 @@ function find(array, ...parameters) {
 function flatten(array) {
 	return Array.isArray(array) ? array.flat(Number.POSITIVE_INFINITY) : [];
 }
+function range(first, second, third) {
+	const start = typeof second === "number" ? first : 0;
+	const end = typeof second === "number" ? second : first;
+	const step = typeof third === "number" ? third : 1;
+	const values = [];
+	if (step === 0) return values;
+	if (step > 0) for (let i = start; i < end; i += step) values.push(i);
+	else for (let i = start; i > end; i += step) values.push(i);
+	return values;
+}
+function times(length, value) {
+	if (typeof length !== "number" || length <= 0) return [];
+	const isFunction = typeof value === "function";
+	const values = [];
+	for (let index = 0; index < length; index += 1) values.push(isFunction ? value(index) : value ?? index);
+	return values;
+}
 function getArray(value, indiced) {
 	if (Array.isArray(value)) return value;
 	if (value instanceof Map || value instanceof Set) return [...value.values()];
@@ -338,11 +355,6 @@ function partition(array, ...parameters) {
 function push(array, pushed) {
 	return insertValues("push", array, pushed, array.length, 0);
 }
-function range(length, value) {
-	if (typeof length !== "number" || length <= 0) return [];
-	const isFunction = typeof value === "function";
-	return Array.from({ length }, (_, index) => isFunction ? value(index) : value ?? index);
-}
 function select(array, ...parameters) {
 	return findValues("all", array, parameters, parameters.pop()).matched;
 }
@@ -942,6 +954,29 @@ const DEFAULT_CACHE_SIZE = 1024;
 function throttle(callback, time) {
 	return getLimiter(callback, true, time);
 }
+function _isResult(value, okValue) {
+	if (!isPlainObject(value)) return false;
+	return value.ok === okValue && (okValue ? "value" : "error") in value;
+}
+function isError(value, extended) {
+	return _isResult(value, false) && (extended === true ? value.original instanceof Error : true);
+}
+/**
+* Is the result ok?
+* @param result Result to check
+* @returns `true` if the result is ok, `false` otherwise
+*/
+function isOk(value) {
+	return _isResult(value, true);
+}
+/**
+* Is the value a result?
+* @param value Value to check
+* @returns `true` if the value is a result, `false` otherwise
+*/
+function isResult(value) {
+	return _isResult(value, true) || _isResult(value, false);
+}
 function assert(condition, message, error) {
 	if (!condition()) throw new (error ?? Error)(message);
 }
@@ -962,11 +997,17 @@ assert.is = (condition, message, error) => {
 };
 function asyncFlow(...fns) {
 	assertFlowFunctions(fns);
-	return (...args) => asyncWork(args, fns, true);
+	return (...args) => asyncWork(args.map((value) => {
+		if (isError(value)) throw value.error;
+		return isOk(value) ? value.value : value;
+	}), fns, true);
 }
 function flow(...fns) {
 	assertFlowFunctions(fns);
-	return (...args) => work(args, fns, true);
+	return (...args) => work(args.map((value) => {
+		if (isError(value)) throw value.error;
+		return isOk(value) ? value.value : value;
+	}), fns, true);
 }
 flow.async = asyncFlow;
 async function asyncPipe(value, ...pipes) {
@@ -980,26 +1021,38 @@ function pipe(value, ...pipes) {
 pipe.async = asyncPipe;
 async function asyncWork(initial, functions, flow) {
 	const { length } = functions;
-	let transformed = initial;
+	let transformed = unwrapValue(initial);
 	for (let index = 0; index < length; index += 1) {
 		const fn = functions[index];
-		transformed = flow && index === 0 && Array.isArray(initial) ? await fn(...initial) : await fn(transformed);
+		transformed = unwrapValue(flow && index === 0 && Array.isArray(initial) ? await fn(...initial) : await fn(transformed));
 	}
 	return transformed;
 }
+function unwrapValue(value, flow, nested) {
+	if (typeof value === "function") {
+		if (nested != null) throw new TypeError(MESSAGE_NESTING);
+		return unwrapValue(value(), flow, true);
+	}
+	if (flow != null && value instanceof Promise) throw new TypeError(flow ? MESSAGE_FLOW_PROMISE : MESSAGE_PIPE_PROMISE);
+	if (isError(value)) throw value.error;
+	return isOk(value) ? value.value : value;
+}
 function work(initial, functions, flow) {
 	const { length } = functions;
-	let transformed = initial;
+	let transformed = unwrapValue(initial, flow);
 	for (let index = 0; index < length; index += 1) {
 		const fn = functions[index];
-		transformed = flow && index === 0 && Array.isArray(initial) ? fn(...initial) : fn(transformed);
+		transformed = unwrapValue(flow && index === 0 && Array.isArray(initial) ? fn(...initial) : fn(transformed), flow);
 	}
 	return transformed;
 }
-const MESSAGE_FLOW = "Flow expected to receive an array of functions";
-const MESSAGE_PIPE = "Pipe expected to receive an array of functions";
-const assertFlowFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_FLOW, TypeError);
-const assertPipeFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_PIPE, TypeError);
+const MESSAGE_FLOW_ARRAY = "Flow expected to receive an array of functions";
+const MESSAGE_FLOW_PROMISE = "Synchronous Flow received a promise. Use `flow.async` instead.";
+const MESSAGE_NESTING = "Return values are too deeply nested.";
+const MESSAGE_PIPE_ARRAY = "Pipe expected to receive an array of functions";
+const MESSAGE_PIPE_PROMISE = "Synchronous Pipe received a promise. Use `pipe.async` instead.";
+const assertFlowFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_FLOW_ARRAY, TypeError);
+const assertPipeFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_PIPE_ARRAY, TypeError);
 /**
 * A function that does nothing, which can be useful, I guess…
 */
@@ -3431,7 +3484,7 @@ const MESSAGE_MAXIMUM = "Queue has reached its maximum size";
 const MESSAGE_REMOVE = "Item removed from queue";
 /**
 * Get a random boolean
-* @return Random boolean
+* @returns Random boolean
 */
 function getRandomBoolean() {
 	return Math.random() > BOOLEAN_MODIFIER;
@@ -3483,10 +3536,44 @@ const ALPHABET = "abcdefghijklmnopqrstuvwxyz";
 const BOOLEAN_MODIFIER = .5;
 const HEX_CHARACTERS = "0123456789ABCDEF";
 const HEX_MAXIMUM = 15;
-function _isResult(value, okValue) {
-	if (!isPlainObject(value)) return false;
-	return value.ok === okValue && (okValue ? "value" : "error") in value;
+function attemptAsyncFlow(...fns) {
+	let Flow;
+	return (...args) => attempt.async(() => {
+		Flow ??= flow.async(...fns);
+		return Flow(...args.map((value) => {
+			if (isError(value)) throw value.error;
+			return isOk(value) ? value.value : value;
+		}));
+	});
+}
+function attemptFlow(...fns) {
+	let Flow;
+	return (...args) => attempt(() => {
+		Flow ??= flow(...fns);
+		return Flow(...args.map((value) => {
+			if (isError(value)) throw value.error;
+			return isOk(value) ? value.value : value;
+		}));
+	});
+}
+attemptFlow.async = attemptAsyncFlow;
+async function attemptAsyncPipe(initial, first, ...seconds) {
+	return attempt.async(() => {
+		if (isError(initial)) throw initial.error;
+		const value = typeof initial === "function" ? initial() : isOk(initial) ? initial.value : initial;
+		if (first == null) return value;
+		return pipe.async(value, ...[first, ...seconds]);
+	});
+}
+function attemptPipe(initial, first, ...seconds) {
+	return attempt(() => {
+		if (isError(initial)) throw initial.error;
+		const value = typeof initial === "function" ? initial() : isOk(initial) ? initial.value : initial;
+		if (first == null) return value;
+		return pipe(value, ...[first, ...seconds]);
+	});
 }
+attemptPipe.async = attemptAsyncPipe;
 async function asyncAttempt(value, err) {
 	try {
 		let result = typeof value === "function" ? value() : await value;
@@ -3504,6 +3591,8 @@ function attempt(callback, err) {
 	}
 }
 attempt.async = asyncAttempt;
+attempt.flow = attemptFlow;
+attempt.pipe = attemptPipe;
 attempt.promise = attemptPromise;
 function error(value, original) {
 	return getError(value, original);
@@ -3516,25 +3605,6 @@ function getError(value, original) {
 	if (original instanceof Error) errorResult.original = original;
 	return errorResult;
 }
-function isError(value, extended) {
-	return _isResult(value, false) && (extended === true ? value.original instanceof Error : true);
-}
-/**
-* Is the result ok?
-* @param result Result to check
-* @returns `true` if the result is ok, `false` otherwise
-*/
-function isOk(value) {
-	return _isResult(value, true);
-}
-/**
-* Is the value a result?
-* @param value Value to check
-* @returns `true` if the value is a result, `false` otherwise
-*/
-function isResult(value) {
-	return _isResult(value, true) || _isResult(value, false);
-}
 /**
 * Creates an ok result
 * @param value Value
@@ -3601,4 +3671,4 @@ var SizedSet = class extends Set {
 		}
 	}
 };
-export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };

package/dist/function/work.js

@@ -1,11 +1,18 @@
 import { assert } from "./assert.js";
+import { isError, isOk } from "../internal/result.js";
 function asyncFlow(...fns) {
 	assertFlowFunctions(fns);
-	return (...args) => asyncWork(args, fns, true);
+	return (...args) => asyncWork(args.map((value) => {
+		if (isError(value)) throw value.error;
+		return isOk(value) ? value.value : value;
+	}), fns, true);
 }
 function flow(...fns) {
 	assertFlowFunctions(fns);
-	return (...args) => work(args, fns, true);
+	return (...args) => work(args.map((value) => {
+		if (isError(value)) throw value.error;
+		return isOk(value) ? value.value : value;
+	}), fns, true);
 }
 flow.async = asyncFlow;
 async function asyncPipe(value, ...pipes) {
@@ -19,24 +26,36 @@ function pipe(value, ...pipes) {
 pipe.async = asyncPipe;
 async function asyncWork(initial, functions, flow) {
 	const { length } = functions;
-	let transformed = initial;
+	let transformed = unwrapValue(initial);
 	for (let index = 0; index < length; index += 1) {
 		const fn = functions[index];
-		transformed = flow && index === 0 && Array.isArray(initial) ? await fn(...initial) : await fn(transformed);
+		transformed = unwrapValue(flow && index === 0 && Array.isArray(initial) ? await fn(...initial) : await fn(transformed));
 	}
 	return transformed;
 }
+function unwrapValue(value, flow, nested) {
+	if (typeof value === "function") {
+		if (nested != null) throw new TypeError(MESSAGE_NESTING);
+		return unwrapValue(value(), flow, true);
+	}
+	if (flow != null && value instanceof Promise) throw new TypeError(flow ? MESSAGE_FLOW_PROMISE : MESSAGE_PIPE_PROMISE);
+	if (isError(value)) throw value.error;
+	return isOk(value) ? value.value : value;
+}
 function work(initial, functions, flow) {
 	const { length } = functions;
-	let transformed = initial;
+	let transformed = unwrapValue(initial, flow);
 	for (let index = 0; index < length; index += 1) {
 		const fn = functions[index];
-		transformed = flow && index === 0 && Array.isArray(initial) ? fn(...initial) : fn(transformed);
+		transformed = unwrapValue(flow && index === 0 && Array.isArray(initial) ? fn(...initial) : fn(transformed), flow);
 	}
 	return transformed;
 }
-var MESSAGE_FLOW = "Flow expected to receive an array of functions";
-var MESSAGE_PIPE = "Pipe expected to receive an array of functions";
-var assertFlowFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_FLOW, TypeError);
-var assertPipeFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_PIPE, TypeError);
+var MESSAGE_FLOW_ARRAY = "Flow expected to receive an array of functions";
+var MESSAGE_FLOW_PROMISE = "Synchronous Flow received a promise. Use `flow.async` instead.";
+var MESSAGE_NESTING = "Return values are too deeply nested.";
+var MESSAGE_PIPE_ARRAY = "Pipe expected to receive an array of functions";
+var MESSAGE_PIPE_PROMISE = "Synchronous Pipe received a promise. Use `pipe.async` instead.";
+var assertFlowFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_FLOW_ARRAY, TypeError);
+var assertPipeFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_PIPE_ARRAY, TypeError);
 export { flow, pipe };

package/dist/index.js

@@ -2,6 +2,7 @@ import { exists } from "./array/exists.js";
 import { filter } from "./array/filter.js";
 import { find } from "./array/find.js";
 import { flatten } from "./array/flatten.js";
+import { range, times } from "./array/from.js";
 import { isArrayOrPlainObject, isConstructor, isKey, isNumber, isPlainObject, isTypedArray } from "./internal/is.js";
 import { getArray } from "./array/get.js";
 import { groupBy } from "./array/group-by.js";
@@ -13,7 +14,6 @@ import { getRandomFloat, getRandomInteger } from "./internal/random.js";
 import { shuffle } from "./internal/array/shuffle.js";
 import { partition } from "./array/partition.js";
 import { push } from "./array/push.js";
-import { range } from "./array/range.js";
 import { select } from "./array/select.js";
 import { max } from "./internal/math/aggregate.js";
 import { getString, ignoreKey, join, tryDecode, tryEncode, words } from "./internal/string.js";
@@ -41,6 +41,7 @@ import { debounce } from "./function/debounce.js";
 import { SizedMap } from "./sized/map.js";
 import { memoize } from "./function/memoize.js";
 import { throttle } from "./function/throttle.js";
+import { isError, isOk, isResult } from "./internal/result.js";
 import { flow, pipe } from "./function/work.js";
 import { equal } from "./internal/value/equal.js";
 import { getValue } from "./internal/value/get.js";
@@ -63,6 +64,6 @@ import { CancelablePromise, PromiseTimeoutError, attemptPromise, cancelable, del
 import { fromQuery, toQuery } from "./query.js";
 import { QueueError, queue } from "./queue.js";
 import { getRandomBoolean, getRandomCharacters, getRandomColor, getRandomHex, getRandomItem, getRandomItems } from "./random.js";
-import { attempt, error, isError, isOk, isResult, ok, unwrap } from "./result.js";
+import { attempt, error, ok, unwrap } from "./result/index.js";
 import { SizedSet } from "./sized/set.js";
-export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };

package/dist/internal/result.js

@@ -0,0 +1,25 @@
+import { isPlainObject } from "./is.js";
+function _isResult(value, okValue) {
+	if (!isPlainObject(value)) return false;
+	return value.ok === okValue && (okValue ? "value" : "error") in value;
+}
+function isError(value, extended) {
+	return _isResult(value, false) && (extended === true ? value.original instanceof Error : true);
+}
+/**
+* Is the result ok?
+* @param result Result to check
+* @returns `true` if the result is ok, `false` otherwise
+*/
+function isOk(value) {
+	return _isResult(value, true);
+}
+/**
+* Is the value a result?
+* @param value Value to check
+* @returns `true` if the value is a result, `false` otherwise
+*/
+function isResult(value) {
+	return _isResult(value, true) || _isResult(value, false);
+}
+export { isError, isOk, isResult };

package/dist/random.js

@@ -3,7 +3,7 @@ import { shuffle } from "./internal/array/shuffle.js";
 import { join } from "./internal/string.js";
 /**
 * Get a random boolean
-* @return Random boolean
+* @returns Random boolean
 */
 function getRandomBoolean() {
 	return Math.random() > BOOLEAN_MODIFIER;

package/dist/{result.js → result/index.js}

@@ -1,9 +1,7 @@
-import { isPlainObject } from "./internal/is.js";
-import { attemptPromise } from "./promise.js";
-function _isResult(value, okValue) {
-	if (!isPlainObject(value)) return false;
-	return value.ok === okValue && (okValue ? "value" : "error") in value;
-}
+import { isError, isOk, isResult } from "../internal/result.js";
+import { attemptPromise } from "../promise.js";
+import { attemptFlow } from "./work/flow.js";
+import { attemptPipe } from "./work/pipe.js";
 async function asyncAttempt(value, err) {
 	try {
 		let result = typeof value === "function" ? value() : await value;
@@ -21,6 +19,8 @@ function attempt(callback, err) {
 	}
 }
 attempt.async = asyncAttempt;
+attempt.flow = attemptFlow;
+attempt.pipe = attemptPipe;
 attempt.promise = attemptPromise;
 function error(value, original) {
 	return getError(value, original);
@@ -33,25 +33,6 @@ function getError(value, original) {
 	if (original instanceof Error) errorResult.original = original;
 	return errorResult;
 }
-function isError(value, extended) {
-	return _isResult(value, false) && (extended === true ? value.original instanceof Error : true);
-}
-/**
-* Is the result ok?
-* @param result Result to check
-* @returns `true` if the result is ok, `false` otherwise
-*/
-function isOk(value) {
-	return _isResult(value, true);
-}
-/**
-* Is the value a result?
-* @param value Value to check
-* @returns `true` if the value is a result, `false` otherwise
-*/
-function isResult(value) {
-	return _isResult(value, true) || _isResult(value, false);
-}
 /**
 * Creates an ok result
 * @param value Value

package/dist/result/work/flow.js

@@ -0,0 +1,25 @@
+import { isError, isOk } from "../../internal/result.js";
+import { flow } from "../../function/work.js";
+import { attempt } from "../index.js";
+function attemptAsyncFlow(...fns) {
+	let Flow;
+	return (...args) => attempt.async(() => {
+		Flow ??= flow.async(...fns);
+		return Flow(...args.map((value) => {
+			if (isError(value)) throw value.error;
+			return isOk(value) ? value.value : value;
+		}));
+	});
+}
+function attemptFlow(...fns) {
+	let Flow;
+	return (...args) => attempt(() => {
+		Flow ??= flow(...fns);
+		return Flow(...args.map((value) => {
+			if (isError(value)) throw value.error;
+			return isOk(value) ? value.value : value;
+		}));
+	});
+}
+attemptFlow.async = attemptAsyncFlow;
+export { attemptFlow };

package/dist/result/work/pipe.js

@@ -0,0 +1,21 @@
+import { isError, isOk } from "../../internal/result.js";
+import { pipe } from "../../function/work.js";
+import { attempt } from "../index.js";
+async function attemptAsyncPipe(initial, first, ...seconds) {
+	return attempt.async(() => {
+		if (isError(initial)) throw initial.error;
+		const value = typeof initial === "function" ? initial() : isOk(initial) ? initial.value : initial;
+		if (first == null) return value;
+		return pipe.async(value, ...[first, ...seconds]);
+	});
+}
+function attemptPipe(initial, first, ...seconds) {
+	return attempt(() => {
+		if (isError(initial)) throw initial.error;
+		const value = typeof initial === "function" ? initial() : isOk(initial) ? initial.value : initial;
+		if (first == null) return value;
+		return pipe(value, ...[first, ...seconds]);
+	});
+}
+attemptPipe.async = attemptAsyncPipe;
+export { attemptPipe };

package/package.json

@@ -110,8 +110,8 @@
 			"default": "./dist/random.js"
 		},
 		"./result": {
-			"types": "./types/result.d.ts",
-			"default": "./dist/result.js"
+			"types": "./types/result/index.d.ts",
+			"default": "./dist/result/index.js"
 		},
 		"./sized/map": {
 			"types": "./types/sized/map.d.ts",
@@ -192,5 +192,5 @@
 	},
 	"type": "module",
 	"types": "./types/index.d.ts",
-	"version": "0.146.0"
+	"version": "0.148.0"
 }

package/src/array/from.ts

@@ -0,0 +1,89 @@
+/**
+ * Get an array with a specified length, filled with indices
+ * @param length Length of the array
+ * @returns Array of indices
+ */
+export function range(length: number): number[];
+
+/**
+ * Get an array of numbers in a specified range
+ * @param start Starting number _(inclusive)_
+ * @param end Ending number _(exclusive)_
+ * @returns Array of numbers in range
+ */
+export function range(start: number, end: number): number[];
+
+/**
+ * Get an array of numbers in a specified range with a specified step
+ * @param start Starting number _(inclusive)_
+ * @param end Ending number _(exclusive)_
+ * @param step Step between numbers
+ * @returns Array of numbers in range
+ */
+export function range(start: number, end: number, step: number): number[];
+
+export function range(first: number, second?: number, third?: number): number[] {
+	const start = typeof second === 'number' ? first : 0;
+	const end = typeof second === 'number' ? second : first;
+	const step = typeof third === 'number' ? third : 1;
+
+	const values: number[] = [];
+
+	if (step === 0) {
+		return values;
+	}
+
+	if (step > 0) {
+		for (let i = start; i < end; i += step) {
+			values.push(i);
+		}
+	} else {
+		for (let i = start; i > end; i += step) {
+			values.push(i);
+		}
+	}
+
+	return values;
+}
+
+/**
+ * Get an array with a specified length, filled with indices
+ * @param length Length of the array
+ * @returns Array of indices
+ */
+export function times(length: number): number[];
+
+/**
+ * Get an array with a specified length, filled by values from a callback
+ * @param length Length of the array
+ * @param callback Callback function to generate values
+ * @returns Array of values generated by the callback
+ */
+export function times<Callback extends (index: number) => unknown>(
+	length: number,
+	callback: Callback,
+): ReturnType<Callback>[];
+
+/**
+ * Get an array with a specified length, filled with a specified value
+ * @param length Length of the array
+ * @param value Value to fill the array with
+ * @returns Array filled with the specified value
+ */
+export function times<Value>(length: number, value: Value): Value[];
+
+export function times(length: number, value?: unknown): unknown[] {
+	if (typeof length !== 'number' || length <= 0) {
+		return [];
+	}
+
+	const isFunction = typeof value === 'function';
+
+	const values: unknown[] = [];
+
+	for (let index = 0; index < length; index += 1) {
+		values.push(isFunction ? (value as (index: number) => unknown)(index) : (value ?? index));
+	}
+
+	return values;
+}

package/src/array/misc.ts

@@ -6,12 +6,12 @@ export * from './exists';
 export * from './filter';
 export * from './find';
 export * from './flatten';
+export * from './from';
 export * from './get';
 export * from './index-of';
 export * from './insert';
 export * from './partition';
 export * from './push';
-export * from './range';
 export * from './select';
 export * from './sort';
 export * from './splice';

package/src/array/toggle.ts

@@ -6,7 +6,7 @@ import type {PlainObject} from '../models';
  * @param destination Array to toggle within
  * @param toggled Toggled items
  * @param callback Callback to find existing item
- * @return Original array
+ * @returns Original array
  */
 export function toggle<Item>(
 	destination: Item[],
@@ -19,7 +19,7 @@ export function toggle<Item>(
  * @param destination Array to toggle within
  * @param toggled Toggled items
  * @param key Key to find existing item
- * @return Original array
+ * @returns Original array
  */
 export function toggle<Item extends PlainObject, Key extends keyof Item>(
 	destination: Item[],