@rimbu/common 2.0.2 → 2.0.3

package/README.md

@@ -1,122 +1,348 @@
 <p align="center">
-    <img src="https://github.com/rimbu-org/rimbu/raw/main/assets/rimbu_logo.svg" />
+  <img src="https://github.com/rimbu-org/rimbu/raw/main/assets/rimbu_logo.svg" height="96" alt="Rimbu Logo" />
 </p>
 
-[![npm version](https://badge.fury.io/js/@rimbu%2Fcommon.svg)](https://www.npmjs.com/package/@rimbu/common) [![Deno](https://shield.deno.dev/x/rimbu)](http://deno.land/x/rimbu)
+<div align="center">
 
-![Licence](https://img.shields.io/github/license/rimbu-org/rimbu)
+[![npm version](https://badge.fury.io/js/@rimbu%2Fcommon.svg)](https://www.npmjs.com/package/@rimbu/common)
+![License](https://img.shields.io/github/license/rimbu-org/rimbu)
+![Types Included](https://img.shields.io/badge/TypeScript-ready-blue)
+![Node](https://img.shields.io/badge/Node-18+-6DA55F?logo=node.js&logoColor=white)
+![Deno](https://shield.deno.dev/x/rimbu)
+![Bun](https://img.shields.io/badge/Bun-%23000000.svg)
+![ESM + CJS](https://img.shields.io/badge/modules-ESM%20%2B%20CJS-informational)
 
-# @rimbu/common
+</div>
 
-Welcome to `@rimbu/common`! This package exports essential types and utilities that are widely used across various Rimbu packages. It provides a robust foundation for building efficient and reliable applications.
+# `@rimbu/common`
 
-### Overview of most important Exported Types:
+**Shared utility types and helpers for the Rimbu ecosystem.**
 
-| Name            | Description                                                                                           |
-| --------------- | ----------------------------------------------------------------------------------------------------- |
-| `CollectFun`    | Types and values used in various `collect` methods within collections.                                |
-| `Comp`          | Interface and default implementations of comparison functions for ordering/sorting values.            |
-| `Eq`            | Interface and default implementations of equality functions for checking value equality.              |
-| `Err`           | Functions to easily create error-throwing behavior as fallback values.                                |
-| `FastIterable`  | An `Iterable` implementation that offers better performance than standard iterables.                  |
-| `IndexRange`    | Utilities for selecting index ranges in indexed collections.                                          |
-| `OptLazy`       | A utility to provide values that can optionally be lazy.                                              |
-| `Range`         | Utility types to specify ranges for comparable types.                                                 |
-| `Reducer`       | An API to create reusable logic pieces that process data streams, which can be processed in parallel. |
-| `TraverseState` | A utility for loops to maintain traversal state.                                                      |
-| `Update`        | A standard way to update a value.                                                                     |
+`@rimbu/common` provides the low-level **building blocks** used throughout Rimbu:
 
-### Documentation
+- **Equality & comparison** helpers (`Eq`, `Comp`) for consistent value semantics.
+- **Range & index utilities** (`Range`, `IndexRange`) for working with slices and windows.
+- **Lazy values & updates** (`OptLazy`, `OptLazyOr`, `AsyncOptLazy`, `Update`) for ergonomic APIs.
+- **Traversal helpers** (`CollectFun`, `TraverseState`) for efficient collection operations.
+- **Type-level utilities** (`SuperOf`, `SubOf`, `RelatedTo`, `ArrayNonEmpty`, `StringNonEmpty`, `ToJSON`) for stronger TypeScript modelling.
 
-For complete documentation, please visit the [Rimbu Docs](https://rimbu.org), or directly explore the [Rimbu Common API Docs](https://rimbu.org/api/rimbu/common).
+Use this package directly in your own code, or consume it indirectly when using other Rimbu packages.
 
-### Try It Out
+---
 
-Experience `@rimbu/common` in action! [Try Out Rimbu](https://codesandbox.io/s/github/vitoke/rimbu-sandbox/tree/main?previewwindow=console&view=split&editorsize=65&moduleview=1&module=/src/index.ts) on CodeSandBox.
+## Table of Contents
 
-## Installation
+1. [Why `@rimbu/common`?](#why-rimbucommon)
+2. [Feature Highlights](#feature-highlights)
+3. [Quick Start](#quick-start)
+4. [Core Concepts & Types](#core-concepts--types)
+5. [Working with Equality & Comparison](#working-with-equality--comparison)
+6. [Lazy Values, Updates & Async](#lazy-values-updates--async)
+7. [Ranges & Indices](#ranges--indices)
+8. [Type Utilities](#type-utilities)
+9. [Installation](#installation)
+10. [Ecosystem & Links](#ecosystem--links)
+11. [Contributing](#contributing)
+12. [License](#license)
 
-### Compabitity
+---
 
-- [`Node` ![NodeJS](https://img.shields.io/badge/node.js-6DA55F?logo=node.js&logoColor=white)](https://nodejs.org)
-- [`Deno` ![Deno JS](https://img.shields.io/badge/deno%20js-000000?logo=deno&logoColor=white)](https://deno.com/runtime)
-- [`Bun` ![Bun](https://img.shields.io/badge/Bun-%23000000.svg?logoColor=white)](https://bun.sh/)
-- `Web` ![HTML5](https://img.shields.io/badge/html5-%23E34F26.svg?logoColor=white)
+## Why `@rimbu/common`?
 
-### Package Managers
+Many Rimbu collections (and your own APIs) need **consistent behaviour** for:
 
-**Yarn:**
+- Comparing values (e.g. custom sort orders, structural vs reference equality).
+- Handling optional or deferred values (lazy evaluation, async computations).
+- Working with index or value ranges in a uniform way.
+- Expressing richer type relationships in TypeScript.
 
-```sh
-yarn add @rimbu/common
+Instead of re‑implementing these patterns, `@rimbu/common` provides:
+
+- **Well-tested primitives** shared across all Rimbu packages.
+- **Reusable utilities** you can depend on directly in your own libraries and apps.
+- **Type-safe building blocks** that integrate smoothly with the rest of the Rimbu ecosystem.
+
+---
+
+## Feature Highlights
+
+- **Pluggable equality & comparison** – `Eq` and `Comp` instances for primitives, objects, iterables, JSON, case-insensitive strings, and more.
+- **Lazy & async helpers** – `OptLazy`, `OptLazyOr`, `AsyncOptLazy`, `MaybePromise` to keep APIs flexible without sacrificing clarity.
+- **Declarative ranges** – `Range<T>` and `IndexRange` to describe open/closed and offset-based ranges in a single, typed shape.
+- **Traversal utilities** – `CollectFun` and `TraverseState` for customizable, short‑circuitable traversals.
+- **Type-level helpers** – utilities like `ArrayNonEmpty`, `StringNonEmpty`, and `ToJSON` to express invariants and serializable shapes.
+
+---
+
+## Quick Start
+
+```ts
+import { Eq, Comp, OptLazy, Update } from '@rimbu/common';
+
+// Equality: deep structural comparison
+const eq = Eq.anyDeepEq<Record<string, unknown>>();
+console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }));
+// => true
+
+// Comparison: natural number ordering
+const numComp = Comp.numberComp();
+console.log(numComp.compare(3, 5) < 0);
+// => true
+
+// Lazy values: compute only when needed
+const lazyValue = OptLazy(() => 1 + 2);
+console.log(lazyValue); // 3
+
+// Updates: accept either a value or an updater function
+const next = Update(1, v => v + 1);
+console.log(next); // 2
 ```
 
-**npm:**
+Try Rimbu (including `@rimbu/common`) live in the browser using the
+[Rimbu Sandbox on CodeSandbox](https://codesandbox.io/s/github/vitoke/rimbu-sandbox/tree/main?previewwindow=console&view=split&editorsize=65&moduleview=1&module=/src/index.ts).
 
-```sh
-npm install @rimbu/common
+---
+
+## Core Concepts & Types
+
+### Exported Types & Utilities
+
+| Name               | Description                                                                                         |
+| ------------------ | --------------------------------------------------------------------------------------------------- |
+| `CollectFun`       | Types used by `collect`-style functions to map/filter in a single pass with skip & halt support.   |
+| `AsyncCollectFun`  | Asynchronous version of `CollectFun`, returning `MaybePromise` of a collected value or skip token. |
+| `Comp`             | Interface and implementations for comparing values (ordering / sorting).                           |
+| `Eq`               | Interface and implementations for checking value equality.                                         |
+| `Err`, `ErrBase`   | Helpers to throw consistent custom errors from fallback handlers.                                  |
+| `IndexRange`       | Range specification for numeric indices (e.g. slicing arrays or collections).                      |
+| `Range<T>`         | Range specification for ordered values of type `T`.                                                |
+| `OptLazy`          | A value or a function returning a value (lazy).                                                    |
+| `OptLazyOr`        | Like `OptLazy`, but can return a provided default value instead.                                   |
+| `AsyncOptLazy`     | Potentially lazy and/or async values built on `OptLazy` + `MaybePromise`.                          |
+| `MaybePromise<T>`  | A value of type `T` or a `Promise<T>`.                                                              |
+| `TraverseState`    | Object to track progress & early termination in traversals.                                        |
+| `Update`           | Value or updater function used to derive a new value from the old one.                             |
+| `SuperOf`, `SubOf` | Type utilities for expressing upper/lower bounds between types.                                    |
+| `RelatedTo`        | Type utility accepting related types where one extends the other.                                   |
+| `ArrayNonEmpty`    | Tuple type representing non-empty arrays.                                                          |
+| `StringNonEmpty`   | Type representing non-empty string types.                                                          |
+| `ToJSON`           | Helper interface for JSON-serializable wrapper objects.                                            |
+
+See the full [Common API reference](https://rimbu.org/api/rimbu/common) for all members and overloads.
+
+---
+
+## Working with Equality & Comparison
+
+### Equality with `Eq`
+
+```ts
+import { Eq } from '@rimbu/common';
+
+// Deep structural equality
+const deepEq = Eq.anyDeepEq<Record<string, unknown>>();
+console.log(deepEq({ a: 1, b: 2 }, { b: 2, a: 1 }));
+// => true
+
+// Shallow equality: one level into objects / iterables
+const shallowEq = Eq.anyShallowEq<Record<string, unknown>>();
+console.log(shallowEq({ a: 1, b: 2 }, { b: 2, a: 1 }));
+// => true
+
+// Flat equality: composed values compared using Object.is
+const flatEq = Eq.anyFlatEq<Record<string, unknown>>();
+console.log(flatEq({ a: 1, b: 2 }, { b: 2, a: 1 }));
+// => false
+
+// Case-insensitive string equality
+const ci = Eq.stringCaseInsentitiveEq();
+console.log(ci('AbC', 'aBc'));
+// => true
 ```
 
-**Bun:**
+### Comparison with `Comp`
 
-```sh
-bun add @rimbu/common
+```ts
+import { Comp } from '@rimbu/common';
+
+// Numbers: natural ordering with special handling for NaN and infinities
+const numberComp = Comp.numberComp();
+numberComp.compare(3, 5); // < 0
+
+// Strings: locale-aware comparison
+const stringComp = Comp.stringComp('en');
+stringComp.compare('a', 'b'); // < 0
+
+// Deep comparison of arbitrary values
+const anyDeepComp = Comp.anyDeepComp<unknown>();
+anyDeepComp.compare({ a: 1 }, { a: 1 }); // 0
+
+// Convert a comparison into an equality function
+const objectEq = Comp.toEq(Comp.objectComp());
+console.log(objectEq({ a: 1, b: 2 }, { b: 2, a: 1 }));
+// => true
 ```
 
-### Deno Setup
+---
 
-Create or edit `import_map.json` in your project root:
+## Lazy Values, Updates & Async
 
-```json
-{
-  "imports": {
-    "@rimbu/": "https://deno.land/x/rimbu@x.y.z/"
-  }
-}
+### `OptLazy` and `OptLazyOr`
+
+```ts
+import { OptLazy, OptLazyOr } from '@rimbu/common';
+
+// Eager or lazy values
+OptLazy(1); // => 1
+OptLazy(() => 1); // => 1
+
+// With a default "other" value
+OptLazyOr(1, 'a'); // => 1
+OptLazyOr(() => 1, 'a'); // => 1
+OptLazyOr(none => none, 'a'); // => 'a'
 ```
 
-_Replace `x.y.z` with the desired version._
+### `Update`
+
+```ts
+import { Update } from '@rimbu/common';
+
+Update(1, 2); // => 2
+Update(1, () => 10); // => 10
+Update(1, v => v + 1); // => 2
+```
 
-In this way you can use relative imports from Rimbu in your code, like so:
+### `AsyncOptLazy` and `MaybePromise`
 
 ```ts
-import { List } from '@rimbu/core/mod.ts';
-import { HashMap } from '@rimbu/hashed/mod.ts';
+import { AsyncOptLazy } from '@rimbu/common';
+
+// Get a value or promised value
+await AsyncOptLazy.toPromise(1); // Promise(1)
+await AsyncOptLazy.toPromise(() => 1); // Promise(1)
+await AsyncOptLazy.toPromise(async () => 1); // Promise(1)
+await AsyncOptLazy.toPromise(Promise.resolve(1)); // Promise(1)
 ```
 
-Note that for sub-packages, due to conversion limitations it is needed to import the `index.ts` instead of `mod.ts`, like so:
+---
+
+## Ranges & Indices
+
+### `Range<T>`
 
 ```ts
-import { HashMap } from '@rimbu/hashed/map/index.ts';
+import { Range } from '@rimbu/common';
+
+// Inclusive start, exclusive end
+const r1: Range<number> = { start: [0, true], end: [10, false] };
+
+// Only end (inclusive by default)
+const r2: Range<number> = { end: 5 };
+
+// Normalize for easier handling
+const normalized = Range.getNormalizedRange(r1);
+// => { start: [0, true], end: [10, false] }
 ```
 
-To run your script (let's assume the entry point is in `src/main.ts`):
+### `IndexRange`
 
-`deno run --import-map import_map.json src/main.ts`
+```ts
+import { IndexRange } from '@rimbu/common';
+
+const ir: IndexRange = { start: [0, true], amount: 3 };
+
+// Extract concrete indices for a given length
+IndexRange.getIndicesFor(ir, 10); // [0, 2]
+```
+
+---
 
-## Usage
+## Type Utilities
 
 ```ts
-import { Eq } from '@rimbu/common';
+import type {
+  SuperOf,
+  SubOf,
+  RelatedTo,
+  ArrayNonEmpty,
+  StringNonEmpty,
+  ToJSON,
+} from '@rimbu/common';
+
+type A = SuperOf<string, 'a' | 'b'>; // string
+type B = SubOf<'a' | 'b', string>; // 'a' | 'b'
+type R = RelatedTo<'a', string>; // 'a' | string
+
+type NonEmptyNumbers = ArrayNonEmpty<number>; // [number, ...number[]]
+type NonEmptyString = StringNonEmpty<'a' | ''>; // 'a'
+
+interface UserJSON extends ToJSON<{ id: number }, 'User'> {}
+```
 
-console.log(Eq.stringCaseInsentitive()('abc', 'AbC'));
-// => true
+---
+
+## Installation
+
+### Node / Bun / npm / Yarn
+
+```sh
+npm install @rimbu/common
+# or
+yarn add @rimbu/common
+# or
+bun add @rimbu/common
 ```
 
-## Author
+### Deno (import map)
+
+```jsonc
+{
+  "imports": {
+    "@rimbu/": "https://deno.land/x/rimbu@<version>/"
+  }
+}
+```
 
-Created and maintained by [Arvid Nicolaas](https://github.com/vitoke).
+Then:
 
-## Contributing
+```ts
+import { Eq } from '@rimbu/common/mod.ts';
+```
+
+### Browser / ESM
+
+`@rimbu/common` ships both **ESM** and **CJS** builds. Use it with any modern bundler
+(Vite, Webpack, esbuild, Bun, etc.) or directly in Node ESM projects.
+
+---
+
+## Ecosystem & Links
+
+- Part of the broader **Rimbu** collection ecosystem – interoperates with `@rimbu/collection-types`,
+  `@rimbu/hashed`, `@rimbu/ordered`, `@rimbu/stream`, and more.
+- Main documentation: [rimbu.org](https://rimbu.org)
+- Package docs: [Common docs](https://rimbu.org/docs/common/overview)  
+- API reference: [Common API](https://rimbu.org/api/rimbu/common)
 
-We welcome contributions! Please read our [Contributing guide](https://github.com/rimbu-org/rimbu/blob/main/CONTRIBUTING.md).
+---
 
-## Contributors
+## Contributing
+
+We welcome contributions! See the
+[Contributing guide](https://github.com/rimbu-org/rimbu/blob/main/CONTRIBUTING.md) for details.
 
-<img src = "https://contrib.rocks/image?repo=rimbu-org/rimbu"/>
+<img src="https://contrib.rocks/image?repo=rimbu-org/rimbu" alt="Contributors" />
 
 _Made with [contributors-img](https://contrib.rocks)._
 
+---
+
 ## License
 
-This project is licensed under the MIT License. See the [LICENSE](./LICENSE) for details.
+MIT © Rimbu contributors. See [LICENSE](./LICENSE) for details.
+
+---
+
+## Attributions
+
+Created and maintained by [Arvid Nicolaas](https://github.com/vitoke). Logo © Rimbu.

package/dist/bun/eq.mts

@@ -4,6 +4,15 @@
 export type Eq<T> = (v1: T, v2: T) => boolean;
 
 export namespace Eq {
+  /**
+   * Converts any given `value` to a string representation that is stable for equality
+   * and ordering comparisons.
+   *
+   * For primitive values and objects with a custom `toString` implementation, it uses
+   * `String(value)`. For plain objects with the default `Object.prototype.toString`
+   * implementation, it uses `JSON.stringify(value)` instead.
+   * @param value - the value to convert
+   */
   export function convertAnyToString(value: any): string {
     if (
       typeof value !== 'object' ||
@@ -146,7 +155,7 @@ export namespace Eq {
   /**
    * Returns an Eq instance that checks equality of objects containing property values of type V by iteratively
    * applying given `valueEq` to each of the object's property values.
-   * @typeparam - the object property value type
+   * @typeparam V - the object property value type
    * @param valueEq - (optional) the Eq instance to use to compare property values
    * @example
    * ```ts
@@ -228,7 +237,7 @@ export namespace Eq {
    * @typeparam T - the value type
    * @example
    * ```ts
-   * const eq = anyFlatEq()
+   * const eq = Eq.anyFlatEq()
    * console.log(eq(1, 'a'))
    * // => false
    * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -246,7 +255,7 @@ export namespace Eq {
    * @typeparam T - the value type
    * @example
    * ```ts
-   * const eq = anyFlatEq()
+   * const eq = Eq.anyShallowEq()
    * console.log(eq(1, 'a'))
    * // => false
    * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -267,7 +276,7 @@ export namespace Eq {
    * @typeparam T - the value type
    * @example
    * ```ts
-   * const eq = anyFlatEq()
+   * const eq = Eq.anyDeepEq()
    * console.log(eq(1, 'a'))
    * // => false
    * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -359,6 +368,18 @@ export namespace Eq {
   const _anyToStringEq: Eq<any> = (v1, v2) =>
     convertAnyToString(v1) === convertAnyToString(v2);
 
+  /**
+   * Returns an Eq instance that considers two values equal when their string
+   * representations, as returned by `Eq.convertAnyToString`, are equal.
+   * @example
+   * ```ts
+   * const eq = Eq.anyToStringEq()
+   * console.log(eq({ a: 1 }, { a: 1 }))
+   * // => true
+   * console.log(eq({ a: 1 }, { a: 2 }))
+   * // => false
+   * ```
+   */
   export function anyToStringEq(): Eq<any> {
     return _anyToStringEq;
   }

package/dist/bun/err.mts

@@ -1,10 +1,10 @@
 /**
- * Throws an `Err.ForcedError` error when called.
+ * Throws an `ErrBase.ForcedError` error when called.
  * @example
  * ```ts
  * const emptyMap = HashMap.empty<number, string>()
  * emptyMap.get(5, Err);
- * // throws: Err.CustomError(message: 'Err: forced to throw error')
+ * // throws: ErrBase.ForcedError(message: 'Err: Forced to throw error')
  * ```
  */
 export function Err(): never {
@@ -23,6 +23,9 @@ export namespace ErrBase {
     }
   }
 
+  /**
+   * Error type that is thrown by `Err` and the functions returned by `ErrBase.msg`.
+   */
   export class ForcedError extends CustomError {}
 
   /**
@@ -32,7 +35,7 @@ export namespace ErrBase {
    * ```ts
    * const emptyMap = HashMap.empty<number, string>()
    * emptyMap.get(5, ErrBase.msg('not found'));
-   * // throws: Err.CustomError(message: 'not found')
+   * // throws: ErrBase.ForcedError(message: 'not found')
    * ```
    */
   export function msg(message: string): () => never {

package/dist/bun/index.mts

@@ -1,7 +1,13 @@
 /**
  * @packageDocumentation
  *
- * The `@rimbu/common` package provides many commonly used types and utilities that can also be of use to Rimbu users.<br/>
+ * The `@rimbu/common` package provides shared equality and comparison helpers, range and index
+ * utilities, lazy and async value helpers, traversal utilities, and rich type‑level helpers used
+ * throughout the Rimbu ecosystem.<br/>
+ * Use it when you need well‑tested primitives like `Eq`, `Comp`, `Range`, `OptLazy`, `AsyncOptLazy`,
+ * or advanced type utilities in your own code, or when building on top of other Rimbu packages.<br/>
+ * See the [Common docs](https://rimbu.org/docs/common/overview) and
+ * [API reference](https://rimbu.org/api/rimbu/common) for more information.
  */
 
 export * from './internal.mts';

package/dist/cjs/eq.cjs

@@ -4,6 +4,15 @@ exports.Eq = void 0;
 var tslib_1 = require("tslib");
 var Eq;
 (function (Eq) {
+    /**
+     * Converts any given `value` to a string representation that is stable for equality
+     * and ordering comparisons.
+     *
+     * For primitive values and objects with a custom `toString` implementation, it uses
+     * `String(value)`. For plain objects with the default `Object.prototype.toString`
+     * implementation, it uses `JSON.stringify(value)` instead.
+     * @param value - the value to convert
+     */
     function convertAnyToString(value) {
         if (typeof value !== 'object' ||
             null === value ||
@@ -135,7 +144,7 @@ var Eq;
     /**
      * Returns an Eq instance that checks equality of objects containing property values of type V by iteratively
      * applying given `valueEq` to each of the object's property values.
-     * @typeparam - the object property value type
+     * @typeparam V - the object property value type
      * @param valueEq - (optional) the Eq instance to use to compare property values
      * @example
      * ```ts
@@ -206,7 +215,7 @@ var Eq;
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyFlatEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -224,7 +233,7 @@ var Eq;
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyShallowEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -245,7 +254,7 @@ var Eq;
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyDeepEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -333,6 +342,18 @@ var Eq;
     var _anyToStringEq = function (v1, v2) {
         return convertAnyToString(v1) === convertAnyToString(v2);
     };
+    /**
+     * Returns an Eq instance that considers two values equal when their string
+     * representations, as returned by `Eq.convertAnyToString`, are equal.
+     * @example
+     * ```ts
+     * const eq = Eq.anyToStringEq()
+     * console.log(eq({ a: 1 }, { a: 1 }))
+     * // => true
+     * console.log(eq({ a: 1 }, { a: 2 }))
+     * // => false
+     * ```
+     */
     function anyToStringEq() {
         return _anyToStringEq;
     }

package/dist/cjs/eq.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"eq.cjs","sourceRoot":"","sources":["../../_cjs_prepare/eq.cts"],"names":[],"mappings":"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"}
+{"version":3,"file":"eq.cjs","sourceRoot":"","sources":["../../_cjs_prepare/eq.cts"],"names":[],"mappings":"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"}

package/dist/cjs/eq.d.cts

@@ -3,6 +3,15 @@
  */
 export type Eq<T> = (v1: T, v2: T) => boolean;
 export declare namespace Eq {
+    /**
+     * Converts any given `value` to a string representation that is stable for equality
+     * and ordering comparisons.
+     *
+     * For primitive values and objects with a custom `toString` implementation, it uses
+     * `String(value)`. For plain objects with the default `Object.prototype.toString`
+     * implementation, it uses `JSON.stringify(value)` instead.
+     * @param value - the value to convert
+     */
     function convertAnyToString(value: any): string;
     /**
      * Returns the default Eq instance, which is the Eq.anyDeepEq() instance.
@@ -65,7 +74,7 @@ export declare namespace Eq {
     /**
      * Returns an Eq instance that checks equality of objects containing property values of type V by iteratively
      * applying given `valueEq` to each of the object's property values.
-     * @typeparam - the object property value type
+     * @typeparam V - the object property value type
      * @param valueEq - (optional) the Eq instance to use to compare property values
      * @example
      * ```ts
@@ -83,7 +92,7 @@ export declare namespace Eq {
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyFlatEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -98,7 +107,7 @@ export declare namespace Eq {
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyShallowEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -116,7 +125,7 @@ export declare namespace Eq {
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyDeepEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -164,6 +173,18 @@ export declare namespace Eq {
      * ```
      */
     function stringCharCodeEq(): Eq<string>;
+    /**
+     * Returns an Eq instance that considers two values equal when their string
+     * representations, as returned by `Eq.convertAnyToString`, are equal.
+     * @example
+     * ```ts
+     * const eq = Eq.anyToStringEq()
+     * console.log(eq({ a: 1 }, { a: 1 }))
+     * // => true
+     * console.log(eq({ a: 1 }, { a: 2 }))
+     * // => false
+     * ```
+     */
     function anyToStringEq(): Eq<any>;
     /**
      * Returns an Eq instance that considers values equal their JSON.stringify values are equal.

package/dist/cjs/err.cjs

@@ -4,12 +4,12 @@ exports.ErrBase = void 0;
 exports.Err = Err;
 var tslib_1 = require("tslib");
 /**
- * Throws an `Err.ForcedError` error when called.
+ * Throws an `ErrBase.ForcedError` error when called.
  * @example
  * ```ts
  * const emptyMap = HashMap.empty<number, string>()
  * emptyMap.get(5, Err);
- * // throws: Err.CustomError(message: 'Err: forced to throw error')
+ * // throws: ErrBase.ForcedError(message: 'Err: Forced to throw error')
  * ```
  */
 function Err() {
@@ -34,6 +34,9 @@ var ErrBase;
         return CustomError;
     }());
     ErrBase.CustomError = CustomError;
+    /**
+     * Error type that is thrown by `Err` and the functions returned by `ErrBase.msg`.
+     */
     var ForcedError = /** @class */ (function (_super) {
         tslib_1.__extends(ForcedError, _super);
         function ForcedError() {
@@ -49,7 +52,7 @@ var ErrBase;
      * ```ts
      * const emptyMap = HashMap.empty<number, string>()
      * emptyMap.get(5, ErrBase.msg('not found'));
-     * // throws: Err.CustomError(message: 'not found')
+     * // throws: ErrBase.ForcedError(message: 'not found')
      * ```
      */
     function msg(message) {

package/dist/cjs/err.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"err.cjs","sourceRoot":"","sources":["../../_cjs_prepare/err.cts"],"names":[],"mappings":";;;AASA,kBAEC;;AAXD;;;;;;;;GAQG;AACH,SAAgB,GAAG;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,IAAiB,OAAO,CA6BvB;AA7BD,WAAiB,OAAO;IACtB;;OAEG;IACH;QACE,qBAAqB,OAAe;YAAf,YAAO,GAAP,OAAO,CAAQ;QAAG,CAAC;QAExC,sBAAI,6BAAI;iBAAR;gBACE,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YAC/B,CAAC;;;WAAA;QACH,kBAAC;IAAD,CAAC,AAND,IAMC;IANqB,mBAAW,cAMhC,CAAA;IAED;QAAiC,uCAAW;QAA5C;;QAA8C,CAAC;QAAD,kBAAC;IAAD,CAAC,AAA/C,CAAiC,WAAW,GAAG;IAAlC,mBAAW,cAAuB,CAAA;IAE/C;;;;;;;;;OASG;IACH,SAAgB,GAAG,CAAC,OAAe;QACjC,OAAO;YACL,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC,CAAC;IACJ,CAAC;IAJe,WAAG,MAIlB,CAAA;AACH,CAAC,EA7BgB,OAAO,uBAAP,OAAO,QA6BvB"}
+{"version":3,"file":"err.cjs","sourceRoot":"","sources":["../../_cjs_prepare/err.cts"],"names":[],"mappings":";;;AASA,kBAEC;;AAXD;;;;;;;;GAQG;AACH,SAAgB,GAAG;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,IAAiB,OAAO,CAgCvB;AAhCD,WAAiB,OAAO;IACtB;;OAEG;IACH;QACE,qBAAqB,OAAe;YAAf,YAAO,GAAP,OAAO,CAAQ;QAAG,CAAC;QAExC,sBAAI,6BAAI;iBAAR;gBACE,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YAC/B,CAAC;;;WAAA;QACH,kBAAC;IAAD,CAAC,AAND,IAMC;IANqB,mBAAW,cAMhC,CAAA;IAED;;OAEG;IACH;QAAiC,uCAAW;QAA5C;;QAA8C,CAAC;QAAD,kBAAC;IAAD,CAAC,AAA/C,CAAiC,WAAW,GAAG;IAAlC,mBAAW,cAAuB,CAAA;IAE/C;;;;;;;;;OASG;IACH,SAAgB,GAAG,CAAC,OAAe;QACjC,OAAO;YACL,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC,CAAC;IACJ,CAAC;IAJe,WAAG,MAIlB,CAAA;AACH,CAAC,EAhCgB,OAAO,uBAAP,OAAO,QAgCvB"}

package/dist/cjs/err.d.cts

@@ -1,10 +1,10 @@
 /**
- * Throws an `Err.ForcedError` error when called.
+ * Throws an `ErrBase.ForcedError` error when called.
  * @example
  * ```ts
  * const emptyMap = HashMap.empty<number, string>()
  * emptyMap.get(5, Err);
- * // throws: Err.CustomError(message: 'Err: forced to throw error')
+ * // throws: ErrBase.ForcedError(message: 'Err: Forced to throw error')
  * ```
  */
 export declare function Err(): never;
@@ -17,6 +17,9 @@ export declare namespace ErrBase {
         constructor(message: string);
         get name(): string;
     }
+    /**
+     * Error type that is thrown by `Err` and the functions returned by `ErrBase.msg`.
+     */
     class ForcedError extends CustomError {
     }
     /**
@@ -26,7 +29,7 @@ export declare namespace ErrBase {
      * ```ts
      * const emptyMap = HashMap.empty<number, string>()
      * emptyMap.get(5, ErrBase.msg('not found'));
-     * // throws: Err.CustomError(message: 'not found')
+     * // throws: ErrBase.ForcedError(message: 'not found')
      * ```
      */
     function msg(message: string): () => never;

package/dist/cjs/index.cjs

@@ -2,7 +2,13 @@
 /**
  * @packageDocumentation
  *
- * The `@rimbu/common` package provides many commonly used types and utilities that can also be of use to Rimbu users.<br/>
+ * The `@rimbu/common` package provides shared equality and comparison helpers, range and index
+ * utilities, lazy and async value helpers, traversal utilities, and rich type‑level helpers used
+ * throughout the Rimbu ecosystem.<br/>
+ * Use it when you need well‑tested primitives like `Eq`, `Comp`, `Range`, `OptLazy`, `AsyncOptLazy`,
+ * or advanced type utilities in your own code, or when building on top of other Rimbu packages.<br/>
+ * See the [Common docs](https://rimbu.org/docs/common/overview) and
+ * [API reference](https://rimbu.org/api/rimbu/common) for more information.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 var tslib_1 = require("tslib");

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../_cjs_prepare/index.cts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,yDAA+B"}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../_cjs_prepare/index.cts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,yDAA+B"}

package/dist/cjs/index.d.cts

@@ -1,6 +1,12 @@
 /**
  * @packageDocumentation
  *
- * The `@rimbu/common` package provides many commonly used types and utilities that can also be of use to Rimbu users.<br/>
+ * The `@rimbu/common` package provides shared equality and comparison helpers, range and index
+ * utilities, lazy and async value helpers, traversal utilities, and rich type‑level helpers used
+ * throughout the Rimbu ecosystem.<br/>
+ * Use it when you need well‑tested primitives like `Eq`, `Comp`, `Range`, `OptLazy`, `AsyncOptLazy`,
+ * or advanced type utilities in your own code, or when building on top of other Rimbu packages.<br/>
+ * See the [Common docs](https://rimbu.org/docs/common/overview) and
+ * [API reference](https://rimbu.org/api/rimbu/common) for more information.
  */
 export * from './internal.cjs';

package/dist/esm/eq.d.mts

@@ -3,6 +3,15 @@
  */
 export type Eq<T> = (v1: T, v2: T) => boolean;
 export declare namespace Eq {
+    /**
+     * Converts any given `value` to a string representation that is stable for equality
+     * and ordering comparisons.
+     *
+     * For primitive values and objects with a custom `toString` implementation, it uses
+     * `String(value)`. For plain objects with the default `Object.prototype.toString`
+     * implementation, it uses `JSON.stringify(value)` instead.
+     * @param value - the value to convert
+     */
     function convertAnyToString(value: any): string;
     /**
      * Returns the default Eq instance, which is the Eq.anyDeepEq() instance.
@@ -65,7 +74,7 @@ export declare namespace Eq {
     /**
      * Returns an Eq instance that checks equality of objects containing property values of type V by iteratively
      * applying given `valueEq` to each of the object's property values.
-     * @typeparam - the object property value type
+     * @typeparam V - the object property value type
      * @param valueEq - (optional) the Eq instance to use to compare property values
      * @example
      * ```ts
@@ -83,7 +92,7 @@ export declare namespace Eq {
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyFlatEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -98,7 +107,7 @@ export declare namespace Eq {
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyShallowEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -116,7 +125,7 @@ export declare namespace Eq {
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyDeepEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -164,6 +173,18 @@ export declare namespace Eq {
      * ```
      */
     function stringCharCodeEq(): Eq<string>;
+    /**
+     * Returns an Eq instance that considers two values equal when their string
+     * representations, as returned by `Eq.convertAnyToString`, are equal.
+     * @example
+     * ```ts
+     * const eq = Eq.anyToStringEq()
+     * console.log(eq({ a: 1 }, { a: 1 }))
+     * // => true
+     * console.log(eq({ a: 1 }, { a: 2 }))
+     * // => false
+     * ```
+     */
     function anyToStringEq(): Eq<any>;
     /**
      * Returns an Eq instance that considers values equal their JSON.stringify values are equal.

package/dist/esm/eq.mjs

@@ -1,5 +1,14 @@
 export var Eq;
 (function (Eq) {
+    /**
+     * Converts any given `value` to a string representation that is stable for equality
+     * and ordering comparisons.
+     *
+     * For primitive values and objects with a custom `toString` implementation, it uses
+     * `String(value)`. For plain objects with the default `Object.prototype.toString`
+     * implementation, it uses `JSON.stringify(value)` instead.
+     * @param value - the value to convert
+     */
     function convertAnyToString(value) {
         if (typeof value !== 'object' ||
             null === value ||
@@ -129,7 +138,7 @@ export var Eq;
     /**
      * Returns an Eq instance that checks equality of objects containing property values of type V by iteratively
      * applying given `valueEq` to each of the object's property values.
-     * @typeparam - the object property value type
+     * @typeparam V - the object property value type
      * @param valueEq - (optional) the Eq instance to use to compare property values
      * @example
      * ```ts
@@ -200,7 +209,7 @@ export var Eq;
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyFlatEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -218,7 +227,7 @@ export var Eq;
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyShallowEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -239,7 +248,7 @@ export var Eq;
      * @typeparam T - the value type
      * @example
      * ```ts
-     * const eq = anyFlatEq()
+     * const eq = Eq.anyDeepEq()
      * console.log(eq(1, 'a'))
      * // => false
      * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -319,6 +328,18 @@ export var Eq;
     }
     Eq.stringCharCodeEq = stringCharCodeEq;
     const _anyToStringEq = (v1, v2) => convertAnyToString(v1) === convertAnyToString(v2);
+    /**
+     * Returns an Eq instance that considers two values equal when their string
+     * representations, as returned by `Eq.convertAnyToString`, are equal.
+     * @example
+     * ```ts
+     * const eq = Eq.anyToStringEq()
+     * console.log(eq({ a: 1 }, { a: 1 }))
+     * // => true
+     * console.log(eq({ a: 1 }, { a: 2 }))
+     * // => false
+     * ```
+     */
     function anyToStringEq() {
         return _anyToStringEq;
     }

package/dist/esm/eq.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"eq.mjs","sourceRoot":"","sources":["../../src/eq.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"eq.mjs","sourceRoot":"","sources":["../../src/eq.mts"],"names":[],"mappings":"AAKA,MAAM,KAAW,EAAE,CAqalB;AAraD,WAAiB,EAAE;IACjB;;;;;;;;OAQG;IACH,SAAgB,kBAAkB,CAAC,KAAU;QAC3C,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,IAAI,KAAK,KAAK;YACd,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC;YACtB,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU;YACpC,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,SAAS,CAAC,QAAQ,EAC5C,CAAC;YACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAZe,qBAAkB,qBAYjC,CAAA;IAED,MAAM,UAAU,GAAY,WAAW,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,aAAa,GAAY,WAAW,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,UAAU,GAAY,WAAW,CAAC,MAAM,CAAC,CAAC;IAEhD;;OAEG;IACH,SAAgB,SAAS;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC;IAFe,YAAS,YAExB,CAAA;IAED;;;;;;;;;;OAUG;IACU,WAAQ,GAAY,MAAM,CAAC,EAAE,CAAC;IAE3C,MAAM,UAAU,GAA2B,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CACpD,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAExC;;;;;;;;;;;;OAYG;IACH,SAAgB,SAAS;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC;IAFe,YAAS,YAExB,CAAA;IAED;;;;;;;;;;OAUG;IACH,SAAgB,MAAM;QACpB,OAAO,UAAU,CAAC;IACpB,CAAC;IAFe,SAAM,SAErB,CAAA;IAED,SAAS,gBAAgB,CAAI,MAAa;QACxC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;YAChB,IAAI,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;YAEnC,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAEpC,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;gBAE5B,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;oBAAE,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC;gBAEnE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;oBAAE,OAAO,KAAK,CAAC;YACxD,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAsB,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC;IAExE;;;;;;;;;;;;OAYG;IACH,SAAgB,UAAU,CAAI,MAAc;QAC1C,IAAI,SAAS,KAAK,MAAM;YAAE,OAAO,cAAc,CAAC;QAEhD,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAJe,aAAU,aAIzB,CAAA;IAED,SAAS,cAAc,CAAC,OAAgB;QACtC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;YAChB,IAAI,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;YAEnC,IAAI,EAAE,CAAC,WAAW,KAAK,EAAE,CAAC,WAAW;gBAAE,OAAO,KAAK,CAAC;YAEpD,KAAK,MAAM,GAAG,IAAI,EAAE,EAAE,CAAC;gBACrB,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;oBAAE,OAAO,KAAK,CAAC;YACjC,CAAC;YAED,KAAK,MAAM,GAAG,IAAI,EAAE,EAAE,CAAC;gBACrB,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;oBAAE,OAAO,KAAK,CAAC;YACjC,CAAC;YAED,KAAK,MAAM,GAAG,IAAI,EAAE,EAAE,CAAC;gBACrB,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;gBACvB,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;gBAEvB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;oBAAE,OAAO,KAAK,CAAC;YAC7C,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAyB,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC;IAEpE;;;;;;;;;;;;;OAaG;IACH,SAAgB,QAAQ,CAAU,OAAe;QAC/C,IAAI,SAAS,KAAK,OAAO;YAAE,OAAO,SAAS,CAAC;QAE5C,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAJe,WAAQ,WAIvB,CAAA;IAED,SAAS,WAAW,CAAC,IAAiC;QACpD,MAAM,MAAM,GAAY,CAAC,EAAE,EAAE,EAAE,EAAW,EAAE;YAC1C,IAAI,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;YAEnC,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;YAExB,IAAI,KAAK,KAAK,KAAK;gBAAE,OAAO,KAAK,CAAC;YAElC,QAAQ,KAAK,EAAE,CAAC;gBACd,KAAK,WAAW,CAAC;gBACjB,KAAK,QAAQ,CAAC;gBACd,KAAK,SAAS,CAAC;gBACf,KAAK,QAAQ,CAAC;gBACd,KAAK,QAAQ,CAAC;gBACd,KAAK,QAAQ,CAAC;gBACd,KAAK,UAAU;oBACb,OAAO,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC3B,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI;wBAAE,OAAO,KAAK,CAAC;oBAE7C,IAAI,EAAE,CAAC,WAAW,KAAK,EAAE,CAAC,WAAW,EAAE,CAAC;wBACtC,OAAO,KAAK,CAAC;oBACf,CAAC;oBAED,IACE,EAAE,YAAY,OAAO;wBACrB,EAAE,YAAY,IAAI;wBAClB,EAAE,YAAY,MAAM;wBACpB,EAAE,YAAY,MAAM,EACpB,CAAC;wBACD,OAAO,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC5B,CAAC;oBAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;wBACpB,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;4BACnD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gCACvB,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;4BAC9C,CAAC;4BAED,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;wBAC1C,CAAC;wBAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;4BACvB,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;wBAC5C,CAAC;wBAED,OAAO,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC3B,CAAC;oBAED,oDAAoD;oBACpD,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,SAAgB,SAAS;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC;IAFe,YAAS,YAExB,CAAA;IAED;;;;;;;;;;;;;;;OAeG;IACH,SAAgB,YAAY;QAC1B,OAAO,aAAa,CAAC;IACvB,CAAC;IAFe,eAAY,eAE3B,CAAA;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,SAAgB,SAAS;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC;IAFe,YAAS,YAExB,CAAA;IAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE9C,MAAM,wBAAwB,GAAY,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CACnD,gBAAgB,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAEzC;;;;;;;;;;;;OAYG;IACH,SAAgB,sBAAsB,CACpC,GAAG,IAAiD;QAEpD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,wBAAwB,CAAC;QAEvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QAExC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IARe,yBAAsB,yBAQrC,CAAA;IAED,MAAM,wBAAwB,GAAe,sBAAsB,CAAC,KAAK,EAAE;QACzE,WAAW,EAAE,QAAQ;KACtB,CAAC,CAAC;IAEH;;;;;;;;;;OAUG;IACH,SAAgB,uBAAuB;QACrC,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAFe,0BAAuB,0BAEtC,CAAA;IAED,MAAM,iBAAiB,GAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;QAC/C,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;QAEtB,IAAI,GAAG,KAAK,EAAE,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAEpC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAEX,OAAO,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC;YACjB,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC1D,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF;;;;;;;;;;OAUG;IACH,SAAgB,gBAAgB;QAC9B,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAFe,mBAAgB,mBAE/B,CAAA;IAED,MAAM,cAAc,GAAY,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CACzC,kBAAkB,CAAC,EAAE,CAAC,KAAK,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAEpD;;;;;;;;;;;OAWG;IACH,SAAgB,aAAa;QAC3B,OAAO,cAAc,CAAC;IACxB,CAAC;IAFe,gBAAa,gBAE5B,CAAA;IAED,MAAM,UAAU,GAAY,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CACrC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAE5C;;;;;;;;;;OAUG;IACH,SAAgB,SAAS;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC;IAFe,YAAS,YAExB,CAAA;IAED;;;;;;;;;;;;;;OAcG;IACH,SAAgB,cAAc,CAC5B,KAAY,SAAS,EAAE;QAEvB,OAAO,CAAC,IAAqB,EAAE,IAAqB,EAAW,EAAE,CAC/D,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IANe,iBAAc,iBAM7B,CAAA;AACH,CAAC,EAragB,EAAE,KAAF,EAAE,QAqalB"}

package/dist/esm/err.d.mts

@@ -1,10 +1,10 @@
 /**
- * Throws an `Err.ForcedError` error when called.
+ * Throws an `ErrBase.ForcedError` error when called.
  * @example
  * ```ts
  * const emptyMap = HashMap.empty<number, string>()
  * emptyMap.get(5, Err);
- * // throws: Err.CustomError(message: 'Err: forced to throw error')
+ * // throws: ErrBase.ForcedError(message: 'Err: Forced to throw error')
  * ```
  */
 export declare function Err(): never;
@@ -17,6 +17,9 @@ export declare namespace ErrBase {
         constructor(message: string);
         get name(): string;
     }
+    /**
+     * Error type that is thrown by `Err` and the functions returned by `ErrBase.msg`.
+     */
     class ForcedError extends CustomError {
     }
     /**
@@ -26,7 +29,7 @@ export declare namespace ErrBase {
      * ```ts
      * const emptyMap = HashMap.empty<number, string>()
      * emptyMap.get(5, ErrBase.msg('not found'));
-     * // throws: Err.CustomError(message: 'not found')
+     * // throws: ErrBase.ForcedError(message: 'not found')
      * ```
      */
     function msg(message: string): () => never;

package/dist/esm/err.mjs

@@ -1,10 +1,10 @@
 /**
- * Throws an `Err.ForcedError` error when called.
+ * Throws an `ErrBase.ForcedError` error when called.
  * @example
  * ```ts
  * const emptyMap = HashMap.empty<number, string>()
  * emptyMap.get(5, Err);
- * // throws: Err.CustomError(message: 'Err: forced to throw error')
+ * // throws: ErrBase.ForcedError(message: 'Err: Forced to throw error')
  * ```
  */
 export function Err() {
@@ -24,6 +24,9 @@ export var ErrBase;
         }
     }
     ErrBase.CustomError = CustomError;
+    /**
+     * Error type that is thrown by `Err` and the functions returned by `ErrBase.msg`.
+     */
     class ForcedError extends CustomError {
     }
     ErrBase.ForcedError = ForcedError;
@@ -34,7 +37,7 @@ export var ErrBase;
      * ```ts
      * const emptyMap = HashMap.empty<number, string>()
      * emptyMap.get(5, ErrBase.msg('not found'));
-     * // throws: Err.CustomError(message: 'not found')
+     * // throws: ErrBase.ForcedError(message: 'not found')
      * ```
      */
     function msg(message) {

package/dist/esm/err.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"err.mjs","sourceRoot":"","sources":["../../src/err.mts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,KAAW,OAAO,CA6BvB;AA7BD,WAAiB,OAAO;IACtB;;OAEG;IACH,MAAsB,WAAW;QAC/B,YAAqB,OAAe;YAAf,YAAO,GAAP,OAAO,CAAQ;QAAG,CAAC;QAExC,IAAI,IAAI;YACN,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAC/B,CAAC;KACF;IANqB,mBAAW,cAMhC,CAAA;IAED,MAAa,WAAY,SAAQ,WAAW;KAAG;IAAlC,mBAAW,cAAuB,CAAA;IAE/C;;;;;;;;;OASG;IACH,SAAgB,GAAG,CAAC,OAAe;QACjC,OAAO;YACL,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC,CAAC;IACJ,CAAC;IAJe,WAAG,MAIlB,CAAA;AACH,CAAC,EA7BgB,OAAO,KAAP,OAAO,QA6BvB"}
+{"version":3,"file":"err.mjs","sourceRoot":"","sources":["../../src/err.mts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,KAAW,OAAO,CAgCvB;AAhCD,WAAiB,OAAO;IACtB;;OAEG;IACH,MAAsB,WAAW;QAC/B,YAAqB,OAAe;YAAf,YAAO,GAAP,OAAO,CAAQ;QAAG,CAAC;QAExC,IAAI,IAAI;YACN,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAC/B,CAAC;KACF;IANqB,mBAAW,cAMhC,CAAA;IAED;;OAEG;IACH,MAAa,WAAY,SAAQ,WAAW;KAAG;IAAlC,mBAAW,cAAuB,CAAA;IAE/C;;;;;;;;;OASG;IACH,SAAgB,GAAG,CAAC,OAAe;QACjC,OAAO;YACL,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC,CAAC;IACJ,CAAC;IAJe,WAAG,MAIlB,CAAA;AACH,CAAC,EAhCgB,OAAO,KAAP,OAAO,QAgCvB"}

package/dist/esm/index.d.mts

@@ -1,6 +1,12 @@
 /**
  * @packageDocumentation
  *
- * The `@rimbu/common` package provides many commonly used types and utilities that can also be of use to Rimbu users.<br/>
+ * The `@rimbu/common` package provides shared equality and comparison helpers, range and index
+ * utilities, lazy and async value helpers, traversal utilities, and rich type‑level helpers used
+ * throughout the Rimbu ecosystem.<br/>
+ * Use it when you need well‑tested primitives like `Eq`, `Comp`, `Range`, `OptLazy`, `AsyncOptLazy`,
+ * or advanced type utilities in your own code, or when building on top of other Rimbu packages.<br/>
+ * See the [Common docs](https://rimbu.org/docs/common/overview) and
+ * [API reference](https://rimbu.org/api/rimbu/common) for more information.
  */
 export * from './internal.mjs';

package/dist/esm/index.mjs

@@ -1,7 +1,13 @@
 /**
  * @packageDocumentation
  *
- * The `@rimbu/common` package provides many commonly used types and utilities that can also be of use to Rimbu users.<br/>
+ * The `@rimbu/common` package provides shared equality and comparison helpers, range and index
+ * utilities, lazy and async value helpers, traversal utilities, and rich type‑level helpers used
+ * throughout the Rimbu ecosystem.<br/>
+ * Use it when you need well‑tested primitives like `Eq`, `Comp`, `Range`, `OptLazy`, `AsyncOptLazy`,
+ * or advanced type utilities in your own code, or when building on top of other Rimbu packages.<br/>
+ * See the [Common docs](https://rimbu.org/docs/common/overview) and
+ * [API reference](https://rimbu.org/api/rimbu/common) for more information.
  */
 export * from './internal.mjs';
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/index.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/index.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimbu/common",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "Common types and objects used in many other Rimbu packages",
   "keywords": [
     "common",
@@ -82,5 +82,5 @@
   "dependencies": {
     "tslib": "^2.6.2"
   },
-  "gitHead": "f18ddf964507dbd10790da3cd4deef8f455a178e"
+  "gitHead": "1c35dbdd9ce13aeba818b41eb20bab1e826b3e16"
 }

package/src/eq.mts

@@ -4,6 +4,15 @@
 export type Eq<T> = (v1: T, v2: T) => boolean;
 
 export namespace Eq {
+  /**
+   * Converts any given `value` to a string representation that is stable for equality
+   * and ordering comparisons.
+   *
+   * For primitive values and objects with a custom `toString` implementation, it uses
+   * `String(value)`. For plain objects with the default `Object.prototype.toString`
+   * implementation, it uses `JSON.stringify(value)` instead.
+   * @param value - the value to convert
+   */
   export function convertAnyToString(value: any): string {
     if (
       typeof value !== 'object' ||
@@ -146,7 +155,7 @@ export namespace Eq {
   /**
    * Returns an Eq instance that checks equality of objects containing property values of type V by iteratively
    * applying given `valueEq` to each of the object's property values.
-   * @typeparam - the object property value type
+   * @typeparam V - the object property value type
    * @param valueEq - (optional) the Eq instance to use to compare property values
    * @example
    * ```ts
@@ -228,7 +237,7 @@ export namespace Eq {
    * @typeparam T - the value type
    * @example
    * ```ts
-   * const eq = anyFlatEq()
+   * const eq = Eq.anyFlatEq()
    * console.log(eq(1, 'a'))
    * // => false
    * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -246,7 +255,7 @@ export namespace Eq {
    * @typeparam T - the value type
    * @example
    * ```ts
-   * const eq = anyFlatEq()
+   * const eq = Eq.anyShallowEq()
    * console.log(eq(1, 'a'))
    * // => false
    * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -267,7 +276,7 @@ export namespace Eq {
    * @typeparam T - the value type
    * @example
    * ```ts
-   * const eq = anyFlatEq()
+   * const eq = Eq.anyDeepEq()
    * console.log(eq(1, 'a'))
    * // => false
    * console.log(eq({ a: 1, b: 2 }, { b: 2, a: 1 }))
@@ -359,6 +368,18 @@ export namespace Eq {
   const _anyToStringEq: Eq<any> = (v1, v2) =>
     convertAnyToString(v1) === convertAnyToString(v2);
 
+  /**
+   * Returns an Eq instance that considers two values equal when their string
+   * representations, as returned by `Eq.convertAnyToString`, are equal.
+   * @example
+   * ```ts
+   * const eq = Eq.anyToStringEq()
+   * console.log(eq({ a: 1 }, { a: 1 }))
+   * // => true
+   * console.log(eq({ a: 1 }, { a: 2 }))
+   * // => false
+   * ```
+   */
   export function anyToStringEq(): Eq<any> {
     return _anyToStringEq;
   }

package/src/err.mts

@@ -1,10 +1,10 @@
 /**
- * Throws an `Err.ForcedError` error when called.
+ * Throws an `ErrBase.ForcedError` error when called.
  * @example
  * ```ts
  * const emptyMap = HashMap.empty<number, string>()
  * emptyMap.get(5, Err);
- * // throws: Err.CustomError(message: 'Err: forced to throw error')
+ * // throws: ErrBase.ForcedError(message: 'Err: Forced to throw error')
  * ```
  */
 export function Err(): never {
@@ -23,6 +23,9 @@ export namespace ErrBase {
     }
   }
 
+  /**
+   * Error type that is thrown by `Err` and the functions returned by `ErrBase.msg`.
+   */
   export class ForcedError extends CustomError {}
 
   /**
@@ -32,7 +35,7 @@ export namespace ErrBase {
    * ```ts
    * const emptyMap = HashMap.empty<number, string>()
    * emptyMap.get(5, ErrBase.msg('not found'));
-   * // throws: Err.CustomError(message: 'not found')
+   * // throws: ErrBase.ForcedError(message: 'not found')
    * ```
    */
   export function msg(message: string): () => never {

package/src/index.mts

@@ -1,7 +1,13 @@
 /**
  * @packageDocumentation
  *
- * The `@rimbu/common` package provides many commonly used types and utilities that can also be of use to Rimbu users.<br/>
+ * The `@rimbu/common` package provides shared equality and comparison helpers, range and index
+ * utilities, lazy and async value helpers, traversal utilities, and rich type‑level helpers used
+ * throughout the Rimbu ecosystem.<br/>
+ * Use it when you need well‑tested primitives like `Eq`, `Comp`, `Range`, `OptLazy`, `AsyncOptLazy`,
+ * or advanced type utilities in your own code, or when building on top of other Rimbu packages.<br/>
+ * See the [Common docs](https://rimbu.org/docs/common/overview) and
+ * [API reference](https://rimbu.org/api/rimbu/common) for more information.
  */
 
 export * from './internal.mjs';