@nlozgachev/pipelined 0.39.0 → 0.41.0

package/dist/types.d.mts

@@ -1,128 +1,4 @@
-declare const _brand: unique symbol;
-/**
- * Brand<K, T> creates a nominal type by tagging T with a phantom brand K.
- * Prevents accidentally mixing up values that share the same underlying type.
- *
- * @example
- * ```ts
- * type UserId = Brand<"UserId", string>;
- * type ProductId = Brand<"ProductId", string>;
- *
- * const toUserId = Brand.wrap<"UserId", string>();
- * const toProductId = Brand.wrap<"ProductId", string>();
- *
- * const userId: UserId = toUserId("user-123");
- * const productId: ProductId = toProductId("prod-456");
- *
- * // Type error: ProductId is not assignable to UserId
- * // const wrong: UserId = productId;
- * ```
- */
-type Brand<K extends string, T> = T & {
-    readonly [_brand]: K;
-};
-declare namespace Brand {
-    /**
-     * Returns a constructor that wraps a value of type T in brand K.
-     * The resulting function performs an unchecked cast — only use when the raw
-     * value is known to satisfy the brand's invariants.
-     *
-     * @example
-     * ```ts
-     * type PositiveNumber = Brand<"PositiveNumber", number>;
-     * const toPositiveNumber = Brand.wrap<"PositiveNumber", number>();
-     *
-     * const n: PositiveNumber = toPositiveNumber(42);
-     * ```
-     */
-    const wrap: <K extends string, T>() => (value: T) => Brand<K, T>;
-    /**
-     * Strips the brand and returns the underlying value.
-     * Since Brand<K, T> extends T this is rarely needed, but can improve readability.
-     *
-     * @example
-     * ```ts
-     * const userId: UserId = toUserId("user-123");
-     * const raw: string = Brand.unwrap(userId); // "user-123"
-     * ```
-     */
-    const unwrap: <K extends string, T>(branded: Brand<K, T>) => T;
-}
-
-/**
- * A branded nominal type representing a duration of time in milliseconds.
- * Use Duration to ensure safe time-based operators and clear unit conversions.
- *
- * @example
- * ```ts
- * const halfSecond = Duration.milliseconds(500);
- * const twoSeconds = Duration.seconds(2);
- * const total = pipe(halfSecond, Duration.add(twoSeconds));
- *
- * Duration.toSeconds(total); // 2.5
- * ```
- */
-type Duration = Brand<"Duration", number>;
-declare namespace Duration {
-    /**
-     * Creates a Duration from milliseconds.
-     */
-    const milliseconds: (ms: number) => Duration;
-    /**
-     * Creates a Duration from seconds.
-     */
-    const seconds: (s: number) => Duration;
-    /**
-     * Creates a Duration from minutes.
-     */
-    const minutes: (m: number) => Duration;
-    /**
-     * Creates a Duration from hours.
-     */
-    const hours: (h: number) => Duration;
-    /**
-     * Creates a Duration from days.
-     */
-    const days: (d: number) => Duration;
-    /**
-     * Converts a Duration back to raw milliseconds.
-     */
-    const toMilliseconds: (d: Duration) => number;
-    /**
-     * Converts a Duration to seconds.
-     */
-    const toSeconds: (d: Duration) => number;
-    /**
-     * Converts a Duration to minutes.
-     */
-    const toMinutes: (d: Duration) => number;
-    /**
-     * Converts a Duration to hours.
-     */
-    const toHours: (d: Duration) => number;
-    /**
-     * Converts a Duration to days.
-     */
-    const toDays: (d: Duration) => number;
-    /**
-     * Adds two Durations together.
-     *
-     * @example
-     * ```ts
-     * pipe(Duration.seconds(1), Duration.add(Duration.milliseconds(500))); // 1500ms
-     * ```
-     */
-    const add: (other: Duration) => (self: Duration) => Duration;
-    /**
-     * Subtracts the other Duration from this one.
-     *
-     * @example
-     * ```ts
-     * pipe(Duration.seconds(1), Duration.subtract(Duration.milliseconds(500))); // 500ms
-     * ```
-     */
-    const subtract: (other: Duration) => (self: Duration) => Duration;
-}
+export { B as Brand, D as Duration } from './Duration-BTeT9D-q.mjs';
 
 /**
  * A list that is guaranteed to have at least one element.
@@ -153,4 +29,4 @@ type NonEmptyList<A> = readonly [A, ...A[]];
  */
 declare const isNonEmptyList: <A>(list: readonly A[]) => list is NonEmptyList<A>;
 
-export { Brand, Duration, type NonEmptyList, isNonEmptyList };
+export { type NonEmptyList, isNonEmptyList };

package/dist/types.d.ts

@@ -1,128 +1,4 @@
-declare const _brand: unique symbol;
-/**
- * Brand<K, T> creates a nominal type by tagging T with a phantom brand K.
- * Prevents accidentally mixing up values that share the same underlying type.
- *
- * @example
- * ```ts
- * type UserId = Brand<"UserId", string>;
- * type ProductId = Brand<"ProductId", string>;
- *
- * const toUserId = Brand.wrap<"UserId", string>();
- * const toProductId = Brand.wrap<"ProductId", string>();
- *
- * const userId: UserId = toUserId("user-123");
- * const productId: ProductId = toProductId("prod-456");
- *
- * // Type error: ProductId is not assignable to UserId
- * // const wrong: UserId = productId;
- * ```
- */
-type Brand<K extends string, T> = T & {
-    readonly [_brand]: K;
-};
-declare namespace Brand {
-    /**
-     * Returns a constructor that wraps a value of type T in brand K.
-     * The resulting function performs an unchecked cast — only use when the raw
-     * value is known to satisfy the brand's invariants.
-     *
-     * @example
-     * ```ts
-     * type PositiveNumber = Brand<"PositiveNumber", number>;
-     * const toPositiveNumber = Brand.wrap<"PositiveNumber", number>();
-     *
-     * const n: PositiveNumber = toPositiveNumber(42);
-     * ```
-     */
-    const wrap: <K extends string, T>() => (value: T) => Brand<K, T>;
-    /**
-     * Strips the brand and returns the underlying value.
-     * Since Brand<K, T> extends T this is rarely needed, but can improve readability.
-     *
-     * @example
-     * ```ts
-     * const userId: UserId = toUserId("user-123");
-     * const raw: string = Brand.unwrap(userId); // "user-123"
-     * ```
-     */
-    const unwrap: <K extends string, T>(branded: Brand<K, T>) => T;
-}
-
-/**
- * A branded nominal type representing a duration of time in milliseconds.
- * Use Duration to ensure safe time-based operators and clear unit conversions.
- *
- * @example
- * ```ts
- * const halfSecond = Duration.milliseconds(500);
- * const twoSeconds = Duration.seconds(2);
- * const total = pipe(halfSecond, Duration.add(twoSeconds));
- *
- * Duration.toSeconds(total); // 2.5
- * ```
- */
-type Duration = Brand<"Duration", number>;
-declare namespace Duration {
-    /**
-     * Creates a Duration from milliseconds.
-     */
-    const milliseconds: (ms: number) => Duration;
-    /**
-     * Creates a Duration from seconds.
-     */
-    const seconds: (s: number) => Duration;
-    /**
-     * Creates a Duration from minutes.
-     */
-    const minutes: (m: number) => Duration;
-    /**
-     * Creates a Duration from hours.
-     */
-    const hours: (h: number) => Duration;
-    /**
-     * Creates a Duration from days.
-     */
-    const days: (d: number) => Duration;
-    /**
-     * Converts a Duration back to raw milliseconds.
-     */
-    const toMilliseconds: (d: Duration) => number;
-    /**
-     * Converts a Duration to seconds.
-     */
-    const toSeconds: (d: Duration) => number;
-    /**
-     * Converts a Duration to minutes.
-     */
-    const toMinutes: (d: Duration) => number;
-    /**
-     * Converts a Duration to hours.
-     */
-    const toHours: (d: Duration) => number;
-    /**
-     * Converts a Duration to days.
-     */
-    const toDays: (d: Duration) => number;
-    /**
-     * Adds two Durations together.
-     *
-     * @example
-     * ```ts
-     * pipe(Duration.seconds(1), Duration.add(Duration.milliseconds(500))); // 1500ms
-     * ```
-     */
-    const add: (other: Duration) => (self: Duration) => Duration;
-    /**
-     * Subtracts the other Duration from this one.
-     *
-     * @example
-     * ```ts
-     * pipe(Duration.seconds(1), Duration.subtract(Duration.milliseconds(500))); // 500ms
-     * ```
-     */
-    const subtract: (other: Duration) => (self: Duration) => Duration;
-}
+export { B as Brand, D as Duration } from './Duration-BTeT9D-q.js';
 
 /**
  * A list that is guaranteed to have at least one element.
@@ -153,4 +29,4 @@ type NonEmptyList<A> = readonly [A, ...A[]];
  */
 declare const isNonEmptyList: <A>(list: readonly A[]) => list is NonEmptyList<A>;
 
-export { Brand, Duration, type NonEmptyList, isNonEmptyList };
+export { type NonEmptyList, isNonEmptyList };

package/dist/types.mjs

@@ -2,7 +2,7 @@ import {
   Brand,
   Duration,
   isNonEmptyList
-} from "./chunk-5AFEEFE4.mjs";
+} from "./chunk-GBB6LVLI.mjs";
 export {
   Brand,
   Duration,

package/dist/utils.d.mts

@@ -1,5 +1,6 @@
-import { M as Maybe, R as Result, E as Equality, b as Ordering, T as Task } from './Task-DcXhCZYg.mjs';
+import { M as Maybe, R as Result, E as Equality, b as Ordering, T as Task } from './Task-BprUabHP.mjs';
 import { NonEmptyList } from './types.mjs';
+import './Duration-BTeT9D-q.mjs';
 
 /**
  * Functional array utilities that compose well with pipe.
@@ -523,7 +524,7 @@ declare namespace Arr {
  *
  * @example
  * ```ts
- * import { Dict } from "@nlozgachev/pipelined/utils";
+ * import { Dict } from "@nlozgachev/pipelined/data";
  * import { pipe } from "@nlozgachev/pipelined/composition";
  *
  * const scores = pipe(
@@ -844,7 +845,7 @@ declare namespace Dict {
  *
  * @example
  * ```ts
- * import { Num } from "@nlozgachev/pipelined/utils";
+ * import { Num } from "@nlozgachev/pipelined/data";
  * import { pipe } from "@nlozgachev/pipelined/composition";
  *
  * pipe(
@@ -893,6 +894,17 @@ declare namespace Num {
      * ```
      */
     const between: (min: number, max: number) => (n: number) => boolean;
+    /**
+     * Returns `true` when the number is in the range `[start, end)` (inclusive of `start`, exclusive of `end`).
+     *
+     * @example
+     * ```ts
+     * pipe(5, Num.inRange(1, 10));  // true
+     * pipe(1, Num.inRange(1, 10));  // true
+     * pipe(10, Num.inRange(1, 10)); // false
+     * ```
+     */
+    const inRange: (start: number, end: number) => (n: number) => boolean;
     /**
      * Parses a string as a number. Returns `None` when the result is `NaN`.
      *
@@ -1215,7 +1227,7 @@ declare namespace Rec {
  *
  * @example
  * ```ts
- * import { Str } from "@nlozgachev/pipelined/utils";
+ * import { Str } from "@nlozgachev/pipelined/data";
  * import { pipe } from "@nlozgachev/pipelined/composition";
  *
  * pipe("  Hello, World!  ", Str.trim, Str.toLowerCase); // "hello, world!"
@@ -1443,7 +1455,7 @@ declare namespace Str {
  *
  * @example
  * ```ts
- * import { Uniq } from "@nlozgachev/pipelined/utils";
+ * import { Uniq } from "@nlozgachev/pipelined/data";
  * import { pipe } from "@nlozgachev/pipelined/composition";
  *
  * const active = pipe(

package/dist/utils.d.ts

@@ -1,5 +1,6 @@
-import { M as Maybe, R as Result, E as Equality, b as Ordering, T as Task } from './Task-uupX7xd9.js';
+import { M as Maybe, R as Result, E as Equality, b as Ordering, T as Task } from './Task-Dt3ZMen6.js';
 import { NonEmptyList } from './types.js';
+import './Duration-BTeT9D-q.js';
 
 /**
  * Functional array utilities that compose well with pipe.
@@ -523,7 +524,7 @@ declare namespace Arr {
  *
  * @example
  * ```ts
- * import { Dict } from "@nlozgachev/pipelined/utils";
+ * import { Dict } from "@nlozgachev/pipelined/data";
  * import { pipe } from "@nlozgachev/pipelined/composition";
  *
  * const scores = pipe(
@@ -844,7 +845,7 @@ declare namespace Dict {
  *
  * @example
  * ```ts
- * import { Num } from "@nlozgachev/pipelined/utils";
+ * import { Num } from "@nlozgachev/pipelined/data";
  * import { pipe } from "@nlozgachev/pipelined/composition";
  *
  * pipe(
@@ -893,6 +894,17 @@ declare namespace Num {
      * ```
      */
     const between: (min: number, max: number) => (n: number) => boolean;
+    /**
+     * Returns `true` when the number is in the range `[start, end)` (inclusive of `start`, exclusive of `end`).
+     *
+     * @example
+     * ```ts
+     * pipe(5, Num.inRange(1, 10));  // true
+     * pipe(1, Num.inRange(1, 10));  // true
+     * pipe(10, Num.inRange(1, 10)); // false
+     * ```
+     */
+    const inRange: (start: number, end: number) => (n: number) => boolean;
     /**
      * Parses a string as a number. Returns `None` when the result is `NaN`.
      *
@@ -1215,7 +1227,7 @@ declare namespace Rec {
  *
  * @example
  * ```ts
- * import { Str } from "@nlozgachev/pipelined/utils";
+ * import { Str } from "@nlozgachev/pipelined/data";
  * import { pipe } from "@nlozgachev/pipelined/composition";
  *
  * pipe("  Hello, World!  ", Str.trim, Str.toLowerCase); // "hello, world!"
@@ -1443,7 +1455,7 @@ declare namespace Str {
  *
  * @example
  * ```ts
- * import { Uniq } from "@nlozgachev/pipelined/utils";
+ * import { Uniq } from "@nlozgachev/pipelined/data";
  * import { pipe } from "@nlozgachev/pipelined/composition";
  *
  * const active = pipe(

package/dist/utils.js

@@ -17,9 +17,9 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/Utils/index.ts
-var Utils_exports = {};
-__export(Utils_exports, {
+// src/Data/index.ts
+var Data_exports = {};
+__export(Data_exports, {
   Arr: () => Arr,
   Dict: () => Dict,
   Num: () => Num,
@@ -27,7 +27,7 @@ __export(Utils_exports, {
   Str: () => Str,
   Uniq: () => Uniq
 });
-module.exports = __toCommonJS(Utils_exports);
+module.exports = __toCommonJS(Data_exports);
 
 // src/Core/Deferred.ts
 var Deferred;
@@ -400,14 +400,14 @@ var Task;
     };
     return { task, abort };
   };
-  Task2.run = (signal) => (task) => Deferred.toPromise(task(signal));
+  Task2.run = (signal) => (task) => task(signal);
   Task2.bindTo = (key) => (data) => (0, Task2.map)((a) => ({ [key]: a }))(data);
   Task2.bind = (key, f) => (data) => (0, Task2.chain)(
     (a) => (0, Task2.map)((b) => ({ ...a, [key]: b }))(f(a))
   )(data);
 })(Task || (Task = {}));
 
-// src/Utils/Arr.ts
+// src/Data/Arr.ts
 var Arr;
 ((Arr2) => {
   Arr2.head = (data) => data.length > 0 ? Maybe.some(data[0]) : Maybe.none();
@@ -739,7 +739,7 @@ var Arr;
   };
 })(Arr || (Arr = {}));
 
-// src/Utils/Dict.ts
+// src/Data/Dict.ts
 var Dict;
 ((Dict2) => {
   Dict2.empty = () => new globalThis.Map();
@@ -877,7 +877,7 @@ var Dict;
   Dict2.toRecord = (m) => Object.fromEntries(m);
 })(Dict || (Dict = {}));
 
-// src/Utils/Num.ts
+// src/Data/Num.ts
 var Num;
 ((Num2) => {
   Num2.range = (from, to, step = 1) => {
@@ -893,6 +893,7 @@ var Num;
   };
   Num2.clamp = (min2, max2) => (n) => Math.min(Math.max(n, min2), max2);
   Num2.between = (min2, max2) => (n) => n >= min2 && n <= max2;
+  Num2.inRange = (start, end) => (n) => n >= start && n < end;
   Num2.parse = (s) => {
     if (s.trim() === "") {
       return Maybe.none();
@@ -944,7 +945,7 @@ var Num;
   };
 })(Num || (Num = {}));
 
-// src/Utils/Rec.ts
+// src/Data/Rec.ts
 var Rec;
 ((Rec2) => {
   Rec2.map = (f) => (data) => {
@@ -1072,7 +1073,7 @@ var Rec;
   };
 })(Rec || (Rec = {}));
 
-// src/Utils/Str.ts
+// src/Data/Str.ts
 var Str;
 ((Str2) => {
   Str2.split = (separator) => (s) => s.split(separator);
@@ -1132,7 +1133,7 @@ var Str;
   };
 })(Str || (Str = {}));
 
-// src/Utils/Uniq.ts
+// src/Data/Uniq.ts
 var Uniq;
 ((Uniq2) => {
   Uniq2.empty = () => new globalThis.Set();

package/dist/utils.mjs

@@ -5,9 +5,9 @@ import {
   Rec,
   Str,
   Uniq
-} from "./chunk-GTJ2YCYY.mjs";
-import "./chunk-4R4XUP4M.mjs";
-import "./chunk-5AFEEFE4.mjs";
+} from "./chunk-V37OUM35.mjs";
+import "./chunk-COGQKPIP.mjs";
+import "./chunk-GBB6LVLI.mjs";
 export {
   Arr,
   Dict,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nlozgachev/pipelined",
-	"version": "0.39.0",
+	"version": "0.41.0",
 	"description": "Opinionated functional abstractions for TypeScript",
 	"license": "BSD-3-Clause",
 	"homepage": "https://pipelined.lozgachev.dev",
@@ -25,7 +25,7 @@
 	],
 	"imports": {
 		"#core": "./src/Core/index.ts",
-		"#utils": "./src/Utils/index.ts",
+		"#data": "./src/Data/index.ts",
 		"#types": "./src/Types/index.ts",
 		"#composition": "./src/Composition/index.ts",
 		"#internal": "./src/internal/index.ts"