@nlozgachev/pipelined 0.26.0 → 0.27.0

package/dist/{Task-7brqoQrb.d.ts → Task-C8Pgm7EX.d.ts}

@@ -263,6 +263,18 @@ declare namespace Result {
      * ```
      */
     const tapError: <E, A>(f: (e: E) => void) => (data: Result<E, A>) => Result<E, A>;
+    /**
+     * Creates a Result from a predicate applied to a value.
+     * Returns Ok if the predicate passes, Err from onFalse otherwise.
+     *
+     * @example
+     * ```ts
+     * pipe(5, Result.fromPredicate(n => n > 0, n => `${n} is not positive`));  // Ok(5)
+     * pipe(-1, Result.fromPredicate(n => n > 0, n => `${n} is not positive`)); // Err("-1 is not positive")
+     * pipe("", Result.fromPredicate(s => s.length > 0, () => "empty string")); // Err("empty string")
+     * ```
+     */
+    const fromPredicate: <E, A>(pred: (a: A) => boolean, onFalse: (a: A) => E) => (a: A) => Result<E, A>;
     /**
      * Recovers from an error by providing a fallback Result.
      * The fallback can produce a different success type, widening the result to `Result<E, A | B>`.
@@ -585,6 +597,17 @@ declare namespace Task {
      * ```
      */
     const from: <A>(f: (signal?: AbortSignal) => Promise<A>) => Task<A>;
+    /**
+     * Creates a Task from a lazy synchronous thunk.
+     * Unlike `Task.resolve(f())`, `fromSync` does not evaluate `f` until the Task is called.
+     *
+     * @example
+     * ```ts
+     * const t = Task.fromSync(() => Date.now()); // Date.now() not called yet
+     * const ts = await t(); // called here, every time
+     * ```
+     */
+    const fromSync: <A>(f: () => A) => Task<A>;
     /**
      * Transforms the value inside a Task.
      *

package/dist/{Task-BoqaFsUR.d.mts → Task-vQb3-puQ.d.mts}

@@ -263,6 +263,18 @@ declare namespace Result {
      * ```
      */
     const tapError: <E, A>(f: (e: E) => void) => (data: Result<E, A>) => Result<E, A>;
+    /**
+     * Creates a Result from a predicate applied to a value.
+     * Returns Ok if the predicate passes, Err from onFalse otherwise.
+     *
+     * @example
+     * ```ts
+     * pipe(5, Result.fromPredicate(n => n > 0, n => `${n} is not positive`));  // Ok(5)
+     * pipe(-1, Result.fromPredicate(n => n > 0, n => `${n} is not positive`)); // Err("-1 is not positive")
+     * pipe("", Result.fromPredicate(s => s.length > 0, () => "empty string")); // Err("empty string")
+     * ```
+     */
+    const fromPredicate: <E, A>(pred: (a: A) => boolean, onFalse: (a: A) => E) => (a: A) => Result<E, A>;
     /**
      * Recovers from an error by providing a fallback Result.
      * The fallback can produce a different success type, widening the result to `Result<E, A | B>`.
@@ -585,6 +597,17 @@ declare namespace Task {
      * ```
      */
     const from: <A>(f: (signal?: AbortSignal) => Promise<A>) => Task<A>;
+    /**
+     * Creates a Task from a lazy synchronous thunk.
+     * Unlike `Task.resolve(f())`, `fromSync` does not evaluate `f` until the Task is called.
+     *
+     * @example
+     * ```ts
+     * const t = Task.fromSync(() => Date.now()); // Date.now() not called yet
+     * const ts = await t(); // called here, every time
+     * ```
+     */
+    const fromSync: <A>(f: () => A) => Task<A>;
     /**
      * Transforms the value inside a Task.
      *

package/dist/{chunk-Z3DYYR43.mjs → chunk-HHCRWQYN.mjs}

@@ -65,6 +65,7 @@ var Result;
     if ((0, Result2.isErr)(data)) f(data.error);
     return data;
   };
+  Result2.fromPredicate = (pred, onFalse) => (a) => pred(a) ? (0, Result2.ok)(a) : (0, Result2.err)(onFalse(a));
   Result2.recover = (fallback) => (data) => (0, Result2.isOk)(data) ? data : fallback(data.error);
   Result2.recoverUnless = (blockedErr, fallback) => (data) => (0, Result2.isErr)(data) && data.error !== blockedErr ? fallback() : data;
   Result2.toMaybe = (data) => (0, Result2.isOk)(data) ? Maybe.some(data.value) : Maybe.none();
@@ -77,6 +78,7 @@ var Task;
 ((Task2) => {
   Task2.resolve = (value) => () => Deferred.fromPromise(Promise.resolve(value));
   Task2.from = (f) => (signal) => Deferred.fromPromise(f(signal));
+  Task2.fromSync = (f) => () => Deferred.fromPromise(Promise.resolve(f()));
   Task2.map = (f) => (data) => (0, Task2.from)((signal) => toPromise(data, signal).then(f));
   Task2.chain = (f) => (data) => (0, Task2.from)((signal) => toPromise(data, signal).then((a) => toPromise(f(a), signal)));
   Task2.ap = (arg) => (data) => (0, Task2.from)(

package/dist/{chunk-6H373E63.mjs → chunk-SBTMTAZF.mjs}

@@ -3,7 +3,7 @@ import {
   Maybe,
   Result,
   Task
-} from "./chunk-Z3DYYR43.mjs";
+} from "./chunk-HHCRWQYN.mjs";
 import {
   isNonEmptyList
 } from "./chunk-DBIC62UV.mjs";
@@ -35,6 +35,12 @@ var Arr;
     for (let i = 0; i < n; i++) result[i] = f(data[i]);
     return result;
   };
+  Arr2.mapWithIndex = (f) => (data) => {
+    const n = data.length;
+    const result = new Array(n);
+    for (let i = 0; i < n; i++) result[i] = f(i, data[i]);
+    return result;
+  };
   Arr2.filter = (predicate) => (data) => {
     const n = data.length;
     const result = [];
@@ -362,6 +368,12 @@ var Num;
   Num2.subtract = (b) => (a) => a - b;
   Num2.multiply = (b) => (a) => a * b;
   Num2.divide = (b) => (a) => a / b;
+  Num2.abs = (n) => Math.abs(n);
+  Num2.negate = (n) => -n;
+  Num2.round = (n) => Math.round(n);
+  Num2.floor = (n) => Math.floor(n);
+  Num2.ceil = (n) => Math.ceil(n);
+  Num2.remainder = (divisor) => (n) => n % divisor;
 })(Num || (Num = {}));
 
 // src/Utils/Rec.ts
@@ -487,6 +499,12 @@ var Str;
   Str2.toLowerCase = (s) => s.toLowerCase();
   Str2.lines = (s) => s.split(/\r?\n|\r/);
   Str2.words = (s) => s.trim().split(/\s+/).filter(Boolean);
+  Str2.isEmpty = (s) => s.length === 0;
+  Str2.isBlank = (s) => s.trim().length === 0;
+  Str2.length = (s) => s.length;
+  Str2.slice = (start, end) => (s) => s.slice(start, end);
+  Str2.padStart = (maxLength, fillString) => (s) => s.padStart(maxLength, fillString);
+  Str2.padEnd = (maxLength, fillString) => (s) => s.padEnd(maxLength, fillString);
   Str2.parse = {
     /**
      * Parses a string as an integer (base 10). Returns `None` if the result is `NaN`.

package/dist/{chunk-NTISCH7Z.mjs → chunk-YYVONF5X.mjs}

@@ -3,7 +3,7 @@ import {
   Maybe,
   Result,
   Task
-} from "./chunk-Z3DYYR43.mjs";
+} from "./chunk-HHCRWQYN.mjs";
 
 // src/Core/Lens.ts
 var Lens;
@@ -1093,6 +1093,7 @@ var RemoteData;
   RemoteData2.toMaybe = (data) => (0, RemoteData2.isSuccess)(data) ? Maybe.some(data.value) : Maybe.none();
   RemoteData2.toResult = (onNotReady) => (data) => (0, RemoteData2.isSuccess)(data) ? Result.ok(data.value) : Result.err((0, RemoteData2.isFailure)(data) ? data.error : onNotReady());
   RemoteData2.fromResult = (data) => Result.isOk(data) ? (0, RemoteData2.success)(data.value) : (0, RemoteData2.failure)(data.error);
+  RemoteData2.fromMaybe = (onNone) => (data) => Maybe.isSome(data) ? (0, RemoteData2.success)(data.value) : (0, RemoteData2.failure)(onNone());
 })(RemoteData || (RemoteData = {}));
 
 // src/Core/Resource.ts

package/dist/core.d.mts

@@ -1,5 +1,5 @@
-import { M as Maybe, W as WithValue, a as WithLog, D as Deferred, R as Result, b as WithKind, c as WithError, d as RetryOptions, e as TimeoutOptions, f as WithTimeout, g as WithMinInterval, h as WithCooldown, i as WithConcurrency, j as WithSize, k as WithMs, l as WithN, T as Task, m as WithErrors, n as WithFirst, o as WithSecond } from './Task-BoqaFsUR.mjs';
-export { E as Err, N as None, O as Ok, S as Some } from './Task-BoqaFsUR.mjs';
+import { M as Maybe, W as WithValue, a as WithLog, D as Deferred, R as Result, b as WithKind, c as WithError, d as RetryOptions, e as TimeoutOptions, f as WithTimeout, g as WithMinInterval, h as WithCooldown, i as WithConcurrency, j as WithSize, k as WithMs, l as WithN, T as Task, m as WithErrors, n as WithFirst, o as WithSecond } from './Task-vQb3-puQ.mjs';
+export { E as Err, N as None, O as Ok, S as Some } from './Task-vQb3-puQ.mjs';
 import { N as NonEmptyList } from './NonEmptyList-BlGFjor5.mjs';
 
 /** Keys of T for which undefined is assignable (i.e. optional fields). */
@@ -1655,6 +1655,17 @@ declare namespace RemoteData {
      * ```
      */
     const fromResult: <E, A>(data: Result<E, A>) => RemoteData<E, A>;
+    /**
+     * Converts a Maybe to a RemoteData.
+     * Some becomes Success, None becomes Failure using the onNone error producer.
+     *
+     * @example
+     * ```ts
+     * pipe(Maybe.some(user), RemoteData.fromMaybe(() => "not found")); // Success(user)
+     * pipe(Maybe.none(), RemoteData.fromMaybe(() => "not found"));     // Failure("not found")
+     * ```
+     */
+    const fromMaybe: <E>(onNone: () => E) => <A>(data: Maybe<A>) => RemoteData<E, A>;
 }
 
 /**

package/dist/core.d.ts

@@ -1,5 +1,5 @@
-import { M as Maybe, W as WithValue, a as WithLog, D as Deferred, R as Result, b as WithKind, c as WithError, d as RetryOptions, e as TimeoutOptions, f as WithTimeout, g as WithMinInterval, h as WithCooldown, i as WithConcurrency, j as WithSize, k as WithMs, l as WithN, T as Task, m as WithErrors, n as WithFirst, o as WithSecond } from './Task-7brqoQrb.js';
-export { E as Err, N as None, O as Ok, S as Some } from './Task-7brqoQrb.js';
+import { M as Maybe, W as WithValue, a as WithLog, D as Deferred, R as Result, b as WithKind, c as WithError, d as RetryOptions, e as TimeoutOptions, f as WithTimeout, g as WithMinInterval, h as WithCooldown, i as WithConcurrency, j as WithSize, k as WithMs, l as WithN, T as Task, m as WithErrors, n as WithFirst, o as WithSecond } from './Task-C8Pgm7EX.js';
+export { E as Err, N as None, O as Ok, S as Some } from './Task-C8Pgm7EX.js';
 import { N as NonEmptyList } from './NonEmptyList-BlGFjor5.js';
 
 /** Keys of T for which undefined is assignable (i.e. optional fields). */
@@ -1655,6 +1655,17 @@ declare namespace RemoteData {
      * ```
      */
     const fromResult: <E, A>(data: Result<E, A>) => RemoteData<E, A>;
+    /**
+     * Converts a Maybe to a RemoteData.
+     * Some becomes Success, None becomes Failure using the onNone error producer.
+     *
+     * @example
+     * ```ts
+     * pipe(Maybe.some(user), RemoteData.fromMaybe(() => "not found")); // Success(user)
+     * pipe(Maybe.none(), RemoteData.fromMaybe(() => "not found"));     // Failure("not found")
+     * ```
+     */
+    const fromMaybe: <E>(onNone: () => E) => <A>(data: Maybe<A>) => RemoteData<E, A>;
 }
 
 /**

package/dist/core.js

@@ -130,6 +130,7 @@ var Result;
     if ((0, Result2.isErr)(data)) f(data.error);
     return data;
   };
+  Result2.fromPredicate = (pred, onFalse) => (a) => pred(a) ? (0, Result2.ok)(a) : (0, Result2.err)(onFalse(a));
   Result2.recover = (fallback) => (data) => (0, Result2.isOk)(data) ? data : fallback(data.error);
   Result2.recoverUnless = (blockedErr, fallback) => (data) => (0, Result2.isErr)(data) && data.error !== blockedErr ? fallback() : data;
   Result2.toMaybe = (data) => (0, Result2.isOk)(data) ? Maybe.some(data.value) : Maybe.none();
@@ -1204,6 +1205,7 @@ var RemoteData;
   RemoteData2.toMaybe = (data) => (0, RemoteData2.isSuccess)(data) ? Maybe.some(data.value) : Maybe.none();
   RemoteData2.toResult = (onNotReady) => (data) => (0, RemoteData2.isSuccess)(data) ? Result.ok(data.value) : Result.err((0, RemoteData2.isFailure)(data) ? data.error : onNotReady());
   RemoteData2.fromResult = (data) => Result.isOk(data) ? (0, RemoteData2.success)(data.value) : (0, RemoteData2.failure)(data.error);
+  RemoteData2.fromMaybe = (onNone) => (data) => Maybe.isSome(data) ? (0, RemoteData2.success)(data.value) : (0, RemoteData2.failure)(onNone());
 })(RemoteData || (RemoteData = {}));
 
 // src/Core/Task.ts
@@ -1212,6 +1214,7 @@ var Task;
 ((Task2) => {
   Task2.resolve = (value) => () => Deferred.fromPromise(Promise.resolve(value));
   Task2.from = (f) => (signal) => Deferred.fromPromise(f(signal));
+  Task2.fromSync = (f) => () => Deferred.fromPromise(Promise.resolve(f()));
   Task2.map = (f) => (data) => (0, Task2.from)((signal) => toPromise(data, signal).then(f));
   Task2.chain = (f) => (data) => (0, Task2.from)((signal) => toPromise(data, signal).then((a) => toPromise(f(a), signal)));
   Task2.ap = (arg) => (data) => (0, Task2.from)(

package/dist/core.mjs

@@ -15,13 +15,13 @@ import {
   These,
   Tuple,
   Validation
-} from "./chunk-NTISCH7Z.mjs";
+} from "./chunk-YYVONF5X.mjs";
 import {
   Deferred,
   Maybe,
   Result,
   Task
-} from "./chunk-Z3DYYR43.mjs";
+} from "./chunk-HHCRWQYN.mjs";
 export {
   Deferred,
   Lens,

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 export { and, compose, constFalse, constNull, constTrue, constUndefined, constVoid, constant, converge, curry, curry3, curry4, flip, flow, identity, juxt, memoize, memoizeWeak, not, on, once, or, pipe, tap, uncurry, uncurry3, uncurry4 } from './composition.mjs';
-export { D as Deferred, E as Err, M as Maybe, N as None, O as Ok, R as Result, S as Some, T as Task } from './Task-BoqaFsUR.mjs';
+export { D as Deferred, E as Err, M as Maybe, N as None, O as Ok, R as Result, S as Some, T as Task } from './Task-vQb3-puQ.mjs';
 export { Failure, Invalid, Lens, Loading, Logged, NotAsked, Op, Optional, Predicate, Reader, Refinement, RemoteData, Resource, State, Success, TaskMaybe, TaskResult, TaskValidation, These, TheseBoth, TheseFirst, TheseSecond, Tuple, Valid, Validation } from './core.mjs';
 export { Brand } from './types.mjs';
 export { N as NonEmptyList, i as isNonEmptyList } from './NonEmptyList-BlGFjor5.mjs';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { and, compose, constFalse, constNull, constTrue, constUndefined, constVoid, constant, converge, curry, curry3, curry4, flip, flow, identity, juxt, memoize, memoizeWeak, not, on, once, or, pipe, tap, uncurry, uncurry3, uncurry4 } from './composition.js';
-export { D as Deferred, E as Err, M as Maybe, N as None, O as Ok, R as Result, S as Some, T as Task } from './Task-7brqoQrb.js';
+export { D as Deferred, E as Err, M as Maybe, N as None, O as Ok, R as Result, S as Some, T as Task } from './Task-C8Pgm7EX.js';
 export { Failure, Invalid, Lens, Loading, Logged, NotAsked, Op, Optional, Predicate, Reader, Refinement, RemoteData, Resource, State, Success, TaskMaybe, TaskResult, TaskValidation, These, TheseBoth, TheseFirst, TheseSecond, Tuple, Valid, Validation } from './core.js';
 export { Brand } from './types.js';
 export { N as NonEmptyList, i as isNonEmptyList } from './NonEmptyList-BlGFjor5.js';

package/dist/index.js

@@ -375,6 +375,7 @@ var Result;
     if ((0, Result2.isErr)(data)) f(data.error);
     return data;
   };
+  Result2.fromPredicate = (pred, onFalse) => (a) => pred(a) ? (0, Result2.ok)(a) : (0, Result2.err)(onFalse(a));
   Result2.recover = (fallback) => (data) => (0, Result2.isOk)(data) ? data : fallback(data.error);
   Result2.recoverUnless = (blockedErr, fallback) => (data) => (0, Result2.isErr)(data) && data.error !== blockedErr ? fallback() : data;
   Result2.toMaybe = (data) => (0, Result2.isOk)(data) ? Maybe.some(data.value) : Maybe.none();
@@ -1449,6 +1450,7 @@ var RemoteData;
   RemoteData2.toMaybe = (data) => (0, RemoteData2.isSuccess)(data) ? Maybe.some(data.value) : Maybe.none();
   RemoteData2.toResult = (onNotReady) => (data) => (0, RemoteData2.isSuccess)(data) ? Result.ok(data.value) : Result.err((0, RemoteData2.isFailure)(data) ? data.error : onNotReady());
   RemoteData2.fromResult = (data) => Result.isOk(data) ? (0, RemoteData2.success)(data.value) : (0, RemoteData2.failure)(data.error);
+  RemoteData2.fromMaybe = (onNone) => (data) => Maybe.isSome(data) ? (0, RemoteData2.success)(data.value) : (0, RemoteData2.failure)(onNone());
 })(RemoteData || (RemoteData = {}));
 
 // src/Core/Task.ts
@@ -1457,6 +1459,7 @@ var Task;
 ((Task2) => {
   Task2.resolve = (value) => () => Deferred.fromPromise(Promise.resolve(value));
   Task2.from = (f) => (signal) => Deferred.fromPromise(f(signal));
+  Task2.fromSync = (f) => () => Deferred.fromPromise(Promise.resolve(f()));
   Task2.map = (f) => (data) => (0, Task2.from)((signal) => toPromise(data, signal).then(f));
   Task2.chain = (f) => (data) => (0, Task2.from)((signal) => toPromise(data, signal).then((a) => toPromise(f(a), signal)));
   Task2.ap = (arg) => (data) => (0, Task2.from)(
@@ -1869,6 +1872,12 @@ var Arr;
     for (let i = 0; i < n; i++) result[i] = f(data[i]);
     return result;
   };
+  Arr2.mapWithIndex = (f) => (data) => {
+    const n = data.length;
+    const result = new Array(n);
+    for (let i = 0; i < n; i++) result[i] = f(i, data[i]);
+    return result;
+  };
   Arr2.filter = (predicate) => (data) => {
     const n = data.length;
     const result = [];
@@ -2196,6 +2205,12 @@ var Num;
   Num2.subtract = (b) => (a) => a - b;
   Num2.multiply = (b) => (a) => a * b;
   Num2.divide = (b) => (a) => a / b;
+  Num2.abs = (n) => Math.abs(n);
+  Num2.negate = (n) => -n;
+  Num2.round = (n) => Math.round(n);
+  Num2.floor = (n) => Math.floor(n);
+  Num2.ceil = (n) => Math.ceil(n);
+  Num2.remainder = (divisor) => (n) => n % divisor;
 })(Num || (Num = {}));
 
 // src/Utils/Rec.ts
@@ -2321,6 +2336,12 @@ var Str;
   Str2.toLowerCase = (s) => s.toLowerCase();
   Str2.lines = (s) => s.split(/\r?\n|\r/);
   Str2.words = (s) => s.trim().split(/\s+/).filter(Boolean);
+  Str2.isEmpty = (s) => s.length === 0;
+  Str2.isBlank = (s) => s.trim().length === 0;
+  Str2.length = (s) => s.length;
+  Str2.slice = (start, end) => (s) => s.slice(start, end);
+  Str2.padStart = (maxLength, fillString) => (s) => s.padStart(maxLength, fillString);
+  Str2.padEnd = (maxLength, fillString) => (s) => s.padEnd(maxLength, fillString);
   Str2.parse = {
     /**
      * Parses a string as an integer (base 10). Returns `None` if the result is `NaN`.

package/dist/index.mjs

@@ -44,7 +44,7 @@ import {
   These,
   Tuple,
   Validation
-} from "./chunk-NTISCH7Z.mjs";
+} from "./chunk-YYVONF5X.mjs";
 import {
   Arr,
   Dict,
@@ -52,13 +52,13 @@ import {
   Rec,
   Str,
   Uniq
-} from "./chunk-6H373E63.mjs";
+} from "./chunk-SBTMTAZF.mjs";
 import {
   Deferred,
   Maybe,
   Result,
   Task
-} from "./chunk-Z3DYYR43.mjs";
+} from "./chunk-HHCRWQYN.mjs";
 import {
   Brand
 } from "./chunk-BYWKZLHM.mjs";

package/dist/utils.d.mts

@@ -1,4 +1,4 @@
-import { M as Maybe, R as Result, T as Task } from './Task-BoqaFsUR.mjs';
+import { M as Maybe, R as Result, T as Task } from './Task-vQb3-puQ.mjs';
 import { N as NonEmptyList } from './NonEmptyList-BlGFjor5.mjs';
 
 /**
@@ -93,6 +93,18 @@ declare namespace Arr {
      * ```
      */
     const map: <A, B>(f: (a: A) => B) => (data: readonly A[]) => readonly B[];
+    /**
+     * Transforms each element using both its value and its zero-based index.
+     *
+     * @example
+     * ```ts
+     * pipe(
+     *   ["a", "b", "c"],
+     *   Arr.mapWithIndex((i, s) => ({ position: i + 1, value: s }))
+     * ); // [{ position: 1, value: "a" }, { position: 2, value: "b" }, { position: 3, value: "c" }]
+     * ```
+     */
+    const mapWithIndex: <A, B>(f: (i: number, a: A) => B) => (data: readonly A[]) => readonly B[];
     /**
      * Filters elements that satisfy the predicate.
      *
@@ -855,6 +867,66 @@ declare namespace Num {
      * ```
      */
     const divide: (b: number) => (a: number) => number;
+    /**
+     * Returns the absolute value of a number.
+     *
+     * @example
+     * ```ts
+     * pipe(-5, Num.abs); // 5
+     * pipe(5, Num.abs);  // 5
+     * ```
+     */
+    const abs: (n: number) => number;
+    /**
+     * Negates a number (arithmetic negation).
+     *
+     * @example
+     * ```ts
+     * pipe(5, Num.negate);  // -5
+     * pipe(-5, Num.negate); // 5
+     * ```
+     */
+    const negate: (n: number) => number;
+    /**
+     * Rounds a number to the nearest integer.
+     *
+     * @example
+     * ```ts
+     * pipe(3.5, Num.round); // 4
+     * pipe(3.4, Num.round); // 3
+     * ```
+     */
+    const round: (n: number) => number;
+    /**
+     * Rounds a number down to the nearest integer.
+     *
+     * @example
+     * ```ts
+     * pipe(3.9, Num.floor); // 3
+     * pipe(-3.2, Num.floor); // -4
+     * ```
+     */
+    const floor: (n: number) => number;
+    /**
+     * Rounds a number up to the nearest integer.
+     *
+     * @example
+     * ```ts
+     * pipe(3.1, Num.ceil); // 4
+     * pipe(-3.9, Num.ceil); // -3
+     * ```
+     */
+    const ceil: (n: number) => number;
+    /**
+     * Returns the remainder of dividing a number by `divisor`. Data-last: `remainder(divisor)(a)` = `a % divisor`.
+     *
+     * @example
+     * ```ts
+     * pipe(10, Num.remainder(3));                    // 1
+     * pipe([10, 11, 12], Arr.map(Num.remainder(3))); // [1, 2, 0]
+     * ```
+     */
+    const remainder: (divisor: number) => (n: number) => number;
 }
 
 /**
@@ -1133,6 +1205,66 @@ declare namespace Str {
      * ```
      */
     const words: (s: string) => readonly string[];
+    /**
+     * Returns `true` when the string is empty.
+     *
+     * @example
+     * ```ts
+     * pipe("", Str.isEmpty);   // true
+     * pipe("hi", Str.isEmpty); // false
+     * ```
+     */
+    const isEmpty: (s: string) => boolean;
+    /**
+     * Returns `true` when the string is empty or contains only whitespace.
+     *
+     * @example
+     * ```ts
+     * pipe("   ", Str.isBlank); // true
+     * pipe("hi", Str.isBlank);  // false
+     * ```
+     */
+    const isBlank: (s: string) => boolean;
+    /**
+     * Returns the length of the string.
+     *
+     * @example
+     * ```ts
+     * pipe("hello", Str.length); // 5
+     * pipe("", Str.length);      // 0
+     * ```
+     */
+    const length: (s: string) => number;
+    /**
+     * Extracts a substring between two indices. Data-last: use in `pipe`.
+     *
+     * @example
+     * ```ts
+     * pipe("hello", Str.slice(1, 3)); // "el"
+     * pipe("hello", Str.slice(2));    // "llo"
+     * ```
+     */
+    const slice: (start: number, end?: number) => (s: string) => string;
+    /**
+     * Pads the start of a string to a specified length. Data-last: use in `pipe`.
+     *
+     * @example
+     * ```ts
+     * pipe("5", Str.padStart(3, "0")); // "005"
+     * pipe("hi", Str.padStart(5));     // "   hi"
+     * ```
+     */
+    const padStart: (maxLength: number, fillString?: string) => (s: string) => string;
+    /**
+     * Pads the end of a string to a specified length. Data-last: use in `pipe`.
+     *
+     * @example
+     * ```ts
+     * pipe("hi", Str.padEnd(5, "."));  // "hi..."
+     * pipe("hi", Str.padEnd(5));       // "hi   "
+     * ```
+     */
+    const padEnd: (maxLength: number, fillString?: string) => (s: string) => string;
     /**
      * Safe number parsers that return `Maybe` instead of `NaN`.
      */

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-import { M as Maybe, R as Result, T as Task } from './Task-7brqoQrb.js';
+import { M as Maybe, R as Result, T as Task } from './Task-C8Pgm7EX.js';
 import { N as NonEmptyList } from './NonEmptyList-BlGFjor5.js';
 
 /**
@@ -93,6 +93,18 @@ declare namespace Arr {
      * ```
      */
     const map: <A, B>(f: (a: A) => B) => (data: readonly A[]) => readonly B[];
+    /**
+     * Transforms each element using both its value and its zero-based index.
+     *
+     * @example
+     * ```ts
+     * pipe(
+     *   ["a", "b", "c"],
+     *   Arr.mapWithIndex((i, s) => ({ position: i + 1, value: s }))
+     * ); // [{ position: 1, value: "a" }, { position: 2, value: "b" }, { position: 3, value: "c" }]
+     * ```
+     */
+    const mapWithIndex: <A, B>(f: (i: number, a: A) => B) => (data: readonly A[]) => readonly B[];
     /**
      * Filters elements that satisfy the predicate.
      *
@@ -855,6 +867,66 @@ declare namespace Num {
      * ```
      */
     const divide: (b: number) => (a: number) => number;
+    /**
+     * Returns the absolute value of a number.
+     *
+     * @example
+     * ```ts
+     * pipe(-5, Num.abs); // 5
+     * pipe(5, Num.abs);  // 5
+     * ```
+     */
+    const abs: (n: number) => number;
+    /**
+     * Negates a number (arithmetic negation).
+     *
+     * @example
+     * ```ts
+     * pipe(5, Num.negate);  // -5
+     * pipe(-5, Num.negate); // 5
+     * ```
+     */
+    const negate: (n: number) => number;
+    /**
+     * Rounds a number to the nearest integer.
+     *
+     * @example
+     * ```ts
+     * pipe(3.5, Num.round); // 4
+     * pipe(3.4, Num.round); // 3
+     * ```
+     */
+    const round: (n: number) => number;
+    /**
+     * Rounds a number down to the nearest integer.
+     *
+     * @example
+     * ```ts
+     * pipe(3.9, Num.floor); // 3
+     * pipe(-3.2, Num.floor); // -4
+     * ```
+     */
+    const floor: (n: number) => number;
+    /**
+     * Rounds a number up to the nearest integer.
+     *
+     * @example
+     * ```ts
+     * pipe(3.1, Num.ceil); // 4
+     * pipe(-3.9, Num.ceil); // -3
+     * ```
+     */
+    const ceil: (n: number) => number;
+    /**
+     * Returns the remainder of dividing a number by `divisor`. Data-last: `remainder(divisor)(a)` = `a % divisor`.
+     *
+     * @example
+     * ```ts
+     * pipe(10, Num.remainder(3));                    // 1
+     * pipe([10, 11, 12], Arr.map(Num.remainder(3))); // [1, 2, 0]
+     * ```
+     */
+    const remainder: (divisor: number) => (n: number) => number;
 }
 
 /**
@@ -1133,6 +1205,66 @@ declare namespace Str {
      * ```
      */
     const words: (s: string) => readonly string[];
+    /**
+     * Returns `true` when the string is empty.
+     *
+     * @example
+     * ```ts
+     * pipe("", Str.isEmpty);   // true
+     * pipe("hi", Str.isEmpty); // false
+     * ```
+     */
+    const isEmpty: (s: string) => boolean;
+    /**
+     * Returns `true` when the string is empty or contains only whitespace.
+     *
+     * @example
+     * ```ts
+     * pipe("   ", Str.isBlank); // true
+     * pipe("hi", Str.isBlank);  // false
+     * ```
+     */
+    const isBlank: (s: string) => boolean;
+    /**
+     * Returns the length of the string.
+     *
+     * @example
+     * ```ts
+     * pipe("hello", Str.length); // 5
+     * pipe("", Str.length);      // 0
+     * ```
+     */
+    const length: (s: string) => number;
+    /**
+     * Extracts a substring between two indices. Data-last: use in `pipe`.
+     *
+     * @example
+     * ```ts
+     * pipe("hello", Str.slice(1, 3)); // "el"
+     * pipe("hello", Str.slice(2));    // "llo"
+     * ```
+     */
+    const slice: (start: number, end?: number) => (s: string) => string;
+    /**
+     * Pads the start of a string to a specified length. Data-last: use in `pipe`.
+     *
+     * @example
+     * ```ts
+     * pipe("5", Str.padStart(3, "0")); // "005"
+     * pipe("hi", Str.padStart(5));     // "   hi"
+     * ```
+     */
+    const padStart: (maxLength: number, fillString?: string) => (s: string) => string;
+    /**
+     * Pads the end of a string to a specified length. Data-last: use in `pipe`.
+     *
+     * @example
+     * ```ts
+     * pipe("hi", Str.padEnd(5, "."));  // "hi..."
+     * pipe("hi", Str.padEnd(5));       // "hi   "
+     * ```
+     */
+    const padEnd: (maxLength: number, fillString?: string) => (s: string) => string;
     /**
      * Safe number parsers that return `Maybe` instead of `NaN`.
      */

package/dist/utils.js

@@ -67,6 +67,7 @@ var Result;
     if ((0, Result2.isErr)(data)) f(data.error);
     return data;
   };
+  Result2.fromPredicate = (pred, onFalse) => (a) => pred(a) ? (0, Result2.ok)(a) : (0, Result2.err)(onFalse(a));
   Result2.recover = (fallback) => (data) => (0, Result2.isOk)(data) ? data : fallback(data.error);
   Result2.recoverUnless = (blockedErr, fallback) => (data) => (0, Result2.isErr)(data) && data.error !== blockedErr ? fallback() : data;
   Result2.toMaybe = (data) => (0, Result2.isOk)(data) ? Maybe.some(data.value) : Maybe.none();
@@ -108,6 +109,7 @@ var Task;
 ((Task2) => {
   Task2.resolve = (value) => () => Deferred.fromPromise(Promise.resolve(value));
   Task2.from = (f) => (signal) => Deferred.fromPromise(f(signal));
+  Task2.fromSync = (f) => () => Deferred.fromPromise(Promise.resolve(f()));
   Task2.map = (f) => (data) => (0, Task2.from)((signal) => toPromise(data, signal).then(f));
   Task2.chain = (f) => (data) => (0, Task2.from)((signal) => toPromise(data, signal).then((a) => toPromise(f(a), signal)));
   Task2.ap = (arg) => (data) => (0, Task2.from)(
@@ -228,6 +230,12 @@ var Arr;
     for (let i = 0; i < n; i++) result[i] = f(data[i]);
     return result;
   };
+  Arr2.mapWithIndex = (f) => (data) => {
+    const n = data.length;
+    const result = new Array(n);
+    for (let i = 0; i < n; i++) result[i] = f(i, data[i]);
+    return result;
+  };
   Arr2.filter = (predicate) => (data) => {
     const n = data.length;
     const result = [];
@@ -555,6 +563,12 @@ var Num;
   Num2.subtract = (b) => (a) => a - b;
   Num2.multiply = (b) => (a) => a * b;
   Num2.divide = (b) => (a) => a / b;
+  Num2.abs = (n) => Math.abs(n);
+  Num2.negate = (n) => -n;
+  Num2.round = (n) => Math.round(n);
+  Num2.floor = (n) => Math.floor(n);
+  Num2.ceil = (n) => Math.ceil(n);
+  Num2.remainder = (divisor) => (n) => n % divisor;
 })(Num || (Num = {}));
 
 // src/Utils/Rec.ts
@@ -680,6 +694,12 @@ var Str;
   Str2.toLowerCase = (s) => s.toLowerCase();
   Str2.lines = (s) => s.split(/\r?\n|\r/);
   Str2.words = (s) => s.trim().split(/\s+/).filter(Boolean);
+  Str2.isEmpty = (s) => s.length === 0;
+  Str2.isBlank = (s) => s.trim().length === 0;
+  Str2.length = (s) => s.length;
+  Str2.slice = (start, end) => (s) => s.slice(start, end);
+  Str2.padStart = (maxLength, fillString) => (s) => s.padStart(maxLength, fillString);
+  Str2.padEnd = (maxLength, fillString) => (s) => s.padEnd(maxLength, fillString);
   Str2.parse = {
     /**
      * Parses a string as an integer (base 10). Returns `None` if the result is `NaN`.

package/dist/utils.mjs

@@ -5,8 +5,8 @@ import {
   Rec,
   Str,
   Uniq
-} from "./chunk-6H373E63.mjs";
-import "./chunk-Z3DYYR43.mjs";
+} from "./chunk-SBTMTAZF.mjs";
+import "./chunk-HHCRWQYN.mjs";
 import "./chunk-DBIC62UV.mjs";
 export {
   Arr,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nlozgachev/pipelined",
-	"version": "0.26.0",
+	"version": "0.27.0",
 	"description": "Opinionated functional abstractions for TypeScript",
 	"license": "BSD-3-Clause",
 	"homepage": "https://pipelined.lozgachev.dev",