@tspro/ts-utils-lib 1.18.0 → 1.19.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.19.0] - 2025-10-27
+### Added
+- SignedIndexArray.toArray(), IndexArray.toArray(), IndexArray.length;
+- Set1 and DeepSet.
+- DefaultArray.
+- Stack functions.
+
 ## [1.18.0] - 2025-10-24
 ### Changed
 - Deprecated `DivRect` properties `centerX` and `centerY`, replaced with `anchorX` and `anchorY`.

package/dist/index.d.mts

@@ -143,15 +143,60 @@ declare namespace index$7 {
   export { type index$7_ErrorConstructor as ErrorConstructor, index$7_array_elem as array_elem, index$7_array_id as array_id, index$7_assert as assert, index$7_assertEnum as assertEnum, index$7_eq as eq, index$7_even as even, index$7_fail as fail, index$7_finite as finite, index$7_in_group as in_group, index$7_int as int, index$7_int_between as int_between, index$7_int_between_exclusive as int_between_exclusive, index$7_int_eq as int_eq, index$7_int_gt as int_gt, index$7_int_gte as int_gte, index$7_int_lt as int_lt, index$7_int_lte as int_lte, index$7_interrupt as interrupt, isArray$1 as isArray, isArrayIndex$1 as isArrayIndex, isArrayOrUndefined$1 as isArrayOrUndefined, isBoolean$1 as isBoolean, isBooleanOrUndefined$1 as isBooleanOrUndefined, isDeepEqual$1 as isDeepEqual, isEmptyArray$1 as isEmptyArray, isEmptyArrayOrUndefined$1 as isEmptyArrayOrUndefined, isEmptyString$1 as isEmptyString, isEmptyStringOrUndefined$1 as isEmptyStringOrUndefined, isEnumValue$1 as isEnumValue, isEnumValueOrUndefined$1 as isEnumValueOrUndefined, isEqual$1 as isEqual, isEvenNumber$1 as isEvenNumber, isFalse$1 as isFalse, isFalseOrUndefined$1 as isFalseOrUndefined, isFinite$1 as isFinite, isFunction$1 as isFunction, isFunctionOrUndefined$1 as isFunctionOrUndefined, isIncluded$1 as isIncluded, isInfinity$1 as isInfinity, isInteger$1 as isInteger, isIntegerBetween$1 as isIntegerBetween, isIntegerBetweenExclusive$1 as isIntegerBetweenExclusive, isIntegerEq$1 as isIntegerEq, isIntegerGt$1 as isIntegerGt, isIntegerGte$1 as isIntegerGte, isIntegerLt$1 as isIntegerLt, isIntegerLte$1 as isIntegerLte, isIntegerOrUndefined$1 as isIntegerOrUndefined, isNaNValue$1 as isNaNValue, isNegInfinity$1 as isNegInfinity, isNonEmptyArray$1 as isNonEmptyArray, isNonEmptyArrayOrUndefined$1 as isNonEmptyArrayOrUndefined, isNonEmptyString$1 as isNonEmptyString, isNonEmptyStringOrUndefined$1 as isNonEmptyStringOrUndefined, isNull$1 as isNull, isNullish$1 as isNullish, isNumber$1 as isNumber, isNumberBetween$1 as isNumberBetween, isNumberBetweenExclusive$1 as isNumberBetweenExclusive, isNumberOrUndefined$1 as isNumberOrUndefined, isObject$1 as isObject, isObjectOrUndefined$1 as isObjectOrUndefined, isOddNumber$1 as isOddNumber, isPosInfinity$1 as isPosInfinity, isString$1 as isString, isStringOrUndefined$1 as isStringOrUndefined, isThrowing$1 as isThrowing, isTrue$1 as isTrue, isTrueOrUndefined$1 as isTrueOrUndefined, isTypedObject$1 as isTypedObject, isUndefined$1 as isUndefined, index$7_odd as odd, index$7_require as require, index$7_requireDefined as requireDefined, index$7_setErrorClass as setErrorClass };
 }
 
+/**
+ * Set expiration time for cookies.
+ * @param days - Number of days until cookies expire.
+ */
 declare function setExpireDays(days: number): void;
+/**
+ * Is consent pending (cookies not yet accepted)?
+ * @returns
+ */
 declare function isConsentPending(): boolean;
+/**
+ * Consent cookies.
+ */
 declare function accept(): void;
+/**
+ * Decline cookies. This will reject all cookies than a single flags that cookies have been declined.
+ */
 declare function decline(): void;
+/**
+ * Save a cookie.
+ * @param name - Cookie name.
+ * @param value - Cookie value, can be string, number or boolean.
+ * @returns - Returns given value.
+ */
 declare function save<T extends string | number | boolean>(name: string, value: T): T;
+/**
+ * Read a string cookie.
+ * @param name - Cookie name.
+ * @param defaultValue - Default value returned when cookie with given name was not found.
+ * @returns - String cookie value.
+ */
 declare function read(name: string, defaultValue: string): string;
+/**
+ * Read an integer cookie.
+ * @param name - Cookie name.
+ * @param defaultValue - Default value returned when cookie with given name was not found.
+ * @returns - Integer cookie valus.
+ */
 declare function readInt(name: string, defaultValue: number): number;
+/**
+ * Read a boolean cookie.
+ * @param name - Cookie name.
+ * @param defaultValue - Default value returned when cookie with given name was not found.
+ * @returns - Boolean cookie value.
+ */
 declare function readBool(name: string, defaultValue: boolean): boolean;
+/**
+ * Erase cookie.
+ * @param name - Name of cookie to be erased.
+ */
 declare function erase(name: string): void;
+/**
+ * Erase all cookies.
+ */
 declare function eraseAll(): void;
 
 declare const cookies_accept: typeof accept;
@@ -168,15 +213,39 @@ declare namespace cookies {
   export { cookies_accept as accept, cookies_decline as decline, cookies_erase as erase, cookies_eraseAll as eraseAll, cookies_isConsentPending as isConsentPending, cookies_read as read, cookies_readBool as readBool, cookies_readInt as readInt, cookies_save as save, cookies_setExpireDays as setExpireDays };
 }
 
+/** Devices dots per inch. */
 declare const DPI: number;
+/** Devices pixels per millimeter. */
 declare const PxPerMm: number;
+/** Browsers scroll bar width. */
 declare const ScrollbarWidth: number;
+/** Browsers system font size. */
 declare const FontSize: number;
+/** Is touch device? */
 declare const IsTouchDevice: boolean;
+/** Is mobile device? */
 declare const IsMobileDevice: boolean;
+/** Host address. */
 declare const HostAddress: string;
+/**
+ * Convert pixels to millimeters on a device.
+ * @param px - Pixels.
+ * @returns - Millimeters.
+ */
 declare function pxToMm(px: number): number;
+/**
+ * Convert millimeters to pixels on a device.
+ * @param mm - Millimeters.
+ * @returns - Pixels.
+ */
 declare function mmToPx(mm: number): number;
+/**
+ * Convert input to pixels on a device. Input value is in html style form containing number
+ * followed by unit (e.g. "10px"). Supported units are "mm", "cm", "in", "inch", "em" and "px".
+ *
+ * @param input - Input value.
+ * @returns - Pixels.
+ */
 declare function toPx(input: string | number): number;
 
 declare const device_DPI: typeof DPI;
@@ -310,8 +379,9 @@ declare namespace Guard {
 
 declare function toArray<T>(a: T | T[]): Array<T>;
 declare function duplicate<T>(a: T[] | undefined): T[] | undefined;
-declare function removeDuplicates<T>(a: T[]): T[];
-declare function removeDuplicatesCmp<T>(arr: ReadonlyArray<T>, cmp: (t1: T, t2: T) => boolean): T[];
+declare function removeDuplicates<T>(arr: T[], compareFn?: (a: T, b: T) => boolean): T[];
+/** @deprecated - Use {@link removeDuplicates} with compareFn instead. */
+declare function removeDuplicatesCmp<T>(arr: ReadonlyArray<T>, compareFn: (t1: T, t2: T) => boolean): T[];
 declare function fillArray<T>(fillValue: T, fillCount: number): T[];
 declare function mapSequenceArray<T>(len: number, fn: (i: number) => T): T[];
 declare function getSequenceArray(len: number): number[];
@@ -545,18 +615,33 @@ declare namespace index {
   export { index$6 as Arr, index$5 as Dom, index$8 as Enum, index_Is as Is, index$4 as Map, index$3 as Math, index$2 as Obj, index$1 as Str };
 }
 
+/**
+ * This is a stack data structure.
+ */
 declare class Stack<T> {
-    private readonly list;
-    push(e: T): T;
+    private readonly data;
+    private assertId;
+    get length(): number;
+    push(el: T): T;
     pop(): T;
+    popOrUndef(): T | undefined;
+    popOr(defaultValueOrCreator: T | (() => T)): T;
     top(): T;
+    topOrUndef(): T | undefined;
+    topOr(defaultValueOrCreator: T | (() => T)): T;
+    peek(depth?: number): T;
+    peekOrUndef(depth?: number): T | undefined;
+    peekOr(depth: number | undefined, defaultValueOrCreator: T | (() => T)): T;
+    values(): IterableIterator<T>;
+    [Symbol.iterator](): IterableIterator<T>;
     toArray(): T[];
-    get length(): number;
+    isEmpty(): boolean;
     clear(): void;
+    toString(): string;
 }
 
 /**
- * Vector class.
+ * `Vec` is a generic vector class with two or more coordinates.
  *
  * ```ts
  * // Example usage:
@@ -606,7 +691,7 @@ declare class Vec {
 }
 
 /**
- * DivRect class, left, top, right, bottom rectangle divided into four sections by anchorX, anchorY.
+ * DivRect class is a rectangle (left, top, right, bottom) with an anchor point (anchorX, anchorY).
  */
 declare class DivRect {
     left: number;
@@ -830,7 +915,7 @@ declare class DivRect {
 }
 
 /**
- * LRUCache class: Least Recently Used cache with a fixed capacity
+ * LRUCache is an implementation of least recently used cache with a fixed capacity.
  */
 declare class LRUCache<K extends string, V> {
     private cache;
@@ -867,7 +952,8 @@ interface KVComponent<K extends any[], VALUE> {
 }
 
 /**
- * An array-like structure for non-negative indexes.
+ * `IndexArray` is a sparse array with non-negative indexes. It stores values
+ * to indexes, and each index also has flag telling it has a value.
  */
 declare class IndexArray<VALUE> implements KVComponent<[number], VALUE> {
     private static validateIndex;
@@ -879,6 +965,8 @@ declare class IndexArray<VALUE> implements KVComponent<[number], VALUE> {
     constructor(entries: Iterable<[number, VALUE]>);
     private get posLen();
     get size(): number;
+    get length(): number;
+    private trimRight;
     isEmpty(): boolean;
     has(id: number): boolean;
     set(id: number, value: VALUE): void;
@@ -898,7 +986,7 @@ declare class IndexArray<VALUE> implements KVComponent<[number], VALUE> {
     kvKeys(): IterableIterator<[number]>;
     kvValues(): IterableIterator<VALUE>;
     kvEntries(): IterableIterator<[[number], VALUE]>;
-    [Symbol.iterator](): Generator<[number, VALUE], void, any>;
+    [Symbol.iterator](): IterableIterator<[number, VALUE]>;
     clone(): IndexArray<VALUE>;
     merge(other: IndexArray<VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, id: number) => VALUE): this;
     some(fn: (value: VALUE, id: number) => boolean): boolean;
@@ -911,11 +999,13 @@ declare class IndexArray<VALUE> implements KVComponent<[number], VALUE> {
     map<R = VALUE>(fn: (value: VALUE, key1: number) => R): IndexArray<R>;
     equals(other: IndexArray<VALUE>): boolean;
     equals(other: IndexArray<VALUE>, eq: (a: VALUE, b: VALUE) => boolean): boolean;
+    toArray(): VALUE[];
     toString(): string;
 }
 
 /**
- * An array-like structure for signed indexes, including negatives.
+ * `IndexArray` is a sparse array with positive and negative indexes. It stores
+ * values to indexes, and each index also has flag telling it has a value.
  */
 declare class SignedIndexArray<VALUE> implements KVComponent<[number], VALUE> {
     private static toNegIndex;
@@ -950,7 +1040,7 @@ declare class SignedIndexArray<VALUE> implements KVComponent<[number], VALUE> {
     kvKeys(): IterableIterator<[number]>;
     kvValues(): IterableIterator<VALUE>;
     kvEntries(): IterableIterator<[[number], VALUE]>;
-    [Symbol.iterator](): Generator<[number, VALUE], void, any>;
+    [Symbol.iterator](): IterableIterator<[number, VALUE]>;
     clone(): SignedIndexArray<VALUE>;
     merge(other: SignedIndexArray<VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, id: number) => VALUE): this;
     some(fn: (value: VALUE, id: number) => boolean): boolean;
@@ -963,9 +1053,13 @@ declare class SignedIndexArray<VALUE> implements KVComponent<[number], VALUE> {
     map<R = VALUE>(fn: (value: VALUE, key1: number) => R): SignedIndexArray<R>;
     equals(other: SignedIndexArray<VALUE>): boolean;
     equals(other: SignedIndexArray<VALUE>, eq: (a: VALUE, b: VALUE) => boolean): boolean;
+    toArray(): VALUE[];
     toString(): string;
 }
 
+/**
+ * A Map implementation mapping a single key to a value.
+ */
 declare class Map1<KEY1, VALUE> implements KVComponent<[KEY1], VALUE> {
     private map1;
     constructor();
@@ -991,7 +1085,7 @@ declare class Map1<KEY1, VALUE> implements KVComponent<[KEY1], VALUE> {
     kvKeys(): IterableIterator<[KEY1]>;
     kvValues(): IterableIterator<VALUE>;
     kvEntries(): IterableIterator<[[KEY1], VALUE]>;
-    [Symbol.iterator](): Generator<[KEY1, VALUE], void, any>;
+    [Symbol.iterator](): IterableIterator<[KEY1, VALUE]>;
     clone(): Map1<KEY1, VALUE>;
     merge(other: Map1<KEY1, VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, key1: KEY1) => VALUE): this;
     some(fn: (value: VALUE, key1: KEY1) => boolean): boolean;
@@ -1006,6 +1100,9 @@ declare class Map1<KEY1, VALUE> implements KVComponent<[KEY1], VALUE> {
     toString(): string;
 }
 
+/**
+ * A Map implementation mapping a double key to a value.
+ */
 declare class Map2<KEY1, KEY2, VALUE> implements KVComponent<[KEY1, KEY2], VALUE> {
     private map1;
     constructor();
@@ -1032,7 +1129,7 @@ declare class Map2<KEY1, KEY2, VALUE> implements KVComponent<[KEY1, KEY2], VALUE
     kvKeys(): IterableIterator<[KEY1, KEY2]>;
     kvValues(): IterableIterator<VALUE>;
     kvEntries(): IterableIterator<[[KEY1, KEY2], VALUE]>;
-    [Symbol.iterator](): Generator<[KEY1, KEY2, VALUE], void, any>;
+    [Symbol.iterator](): IterableIterator<[KEY1, KEY2, VALUE]>;
     clone(): Map2<KEY1, KEY2, VALUE>;
     merge(other: Map2<KEY1, KEY2, VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, key1: KEY1, key2: KEY2) => VALUE): this;
     some(fn: (value: VALUE, key1: KEY1, key2: KEY2) => boolean): boolean;
@@ -1047,6 +1144,9 @@ declare class Map2<KEY1, KEY2, VALUE> implements KVComponent<[KEY1, KEY2], VALUE
     toString(): string;
 }
 
+/**
+ * A Map implementation mapping a triple key to a value.
+ */
 declare class Map3<KEY1, KEY2, KEY3, VALUE> implements KVComponent<[KEY1, KEY2, KEY3], VALUE> {
     private map1;
     constructor();
@@ -1074,7 +1174,7 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> implements KVComponent<[KEY1, KEY2,
     kvKeys(): IterableIterator<[KEY1, KEY2, KEY3]>;
     kvValues(): IterableIterator<VALUE>;
     kvEntries(): IterableIterator<[[KEY1, KEY2, KEY3], VALUE]>;
-    [Symbol.iterator](): Generator<[KEY1, KEY2, KEY3, VALUE], void, any>;
+    [Symbol.iterator](): IterableIterator<[KEY1, KEY2, KEY3, VALUE]>;
     clone(): Map3<KEY1, KEY2, KEY3, VALUE>;
     merge(other: Map3<KEY1, KEY2, KEY3, VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, key1: KEY1, key2: KEY2, key3: KEY3) => VALUE): this;
     some(fn: (value: VALUE, key1: KEY1, key2: KEY2, key3: KEY3) => boolean): boolean;
@@ -1089,6 +1189,9 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> implements KVComponent<[KEY1, KEY2,
     toString(): string;
 }
 
+/**
+ * Wrapper class of a key-value container that contain array values.
+ */
 declare class MultiContainer<K extends any[], V> {
     private readonly base;
     constructor(base: KVComponent<K, V[]>);
@@ -1105,10 +1208,14 @@ declare class MultiContainer<K extends any[], V> {
     toString(): string;
 }
 /**
+ * Create a multi-container.
+ *
  * ```ts
  * // Usage:
  * const multi = asMulti(new Map2<string, string, number[]>());
- * multi.add("A", "B", 5);
+ * multi.add("a", "b", 5);
+ * multi.add("a", "b", 10);
+ * multi.add("a", "c", 15);
  * ```
  * @param base
  * @returns

package/dist/index.d.ts

@@ -143,15 +143,60 @@ declare namespace index$7 {
   export { type index$7_ErrorConstructor as ErrorConstructor, index$7_array_elem as array_elem, index$7_array_id as array_id, index$7_assert as assert, index$7_assertEnum as assertEnum, index$7_eq as eq, index$7_even as even, index$7_fail as fail, index$7_finite as finite, index$7_in_group as in_group, index$7_int as int, index$7_int_between as int_between, index$7_int_between_exclusive as int_between_exclusive, index$7_int_eq as int_eq, index$7_int_gt as int_gt, index$7_int_gte as int_gte, index$7_int_lt as int_lt, index$7_int_lte as int_lte, index$7_interrupt as interrupt, isArray$1 as isArray, isArrayIndex$1 as isArrayIndex, isArrayOrUndefined$1 as isArrayOrUndefined, isBoolean$1 as isBoolean, isBooleanOrUndefined$1 as isBooleanOrUndefined, isDeepEqual$1 as isDeepEqual, isEmptyArray$1 as isEmptyArray, isEmptyArrayOrUndefined$1 as isEmptyArrayOrUndefined, isEmptyString$1 as isEmptyString, isEmptyStringOrUndefined$1 as isEmptyStringOrUndefined, isEnumValue$1 as isEnumValue, isEnumValueOrUndefined$1 as isEnumValueOrUndefined, isEqual$1 as isEqual, isEvenNumber$1 as isEvenNumber, isFalse$1 as isFalse, isFalseOrUndefined$1 as isFalseOrUndefined, isFinite$1 as isFinite, isFunction$1 as isFunction, isFunctionOrUndefined$1 as isFunctionOrUndefined, isIncluded$1 as isIncluded, isInfinity$1 as isInfinity, isInteger$1 as isInteger, isIntegerBetween$1 as isIntegerBetween, isIntegerBetweenExclusive$1 as isIntegerBetweenExclusive, isIntegerEq$1 as isIntegerEq, isIntegerGt$1 as isIntegerGt, isIntegerGte$1 as isIntegerGte, isIntegerLt$1 as isIntegerLt, isIntegerLte$1 as isIntegerLte, isIntegerOrUndefined$1 as isIntegerOrUndefined, isNaNValue$1 as isNaNValue, isNegInfinity$1 as isNegInfinity, isNonEmptyArray$1 as isNonEmptyArray, isNonEmptyArrayOrUndefined$1 as isNonEmptyArrayOrUndefined, isNonEmptyString$1 as isNonEmptyString, isNonEmptyStringOrUndefined$1 as isNonEmptyStringOrUndefined, isNull$1 as isNull, isNullish$1 as isNullish, isNumber$1 as isNumber, isNumberBetween$1 as isNumberBetween, isNumberBetweenExclusive$1 as isNumberBetweenExclusive, isNumberOrUndefined$1 as isNumberOrUndefined, isObject$1 as isObject, isObjectOrUndefined$1 as isObjectOrUndefined, isOddNumber$1 as isOddNumber, isPosInfinity$1 as isPosInfinity, isString$1 as isString, isStringOrUndefined$1 as isStringOrUndefined, isThrowing$1 as isThrowing, isTrue$1 as isTrue, isTrueOrUndefined$1 as isTrueOrUndefined, isTypedObject$1 as isTypedObject, isUndefined$1 as isUndefined, index$7_odd as odd, index$7_require as require, index$7_requireDefined as requireDefined, index$7_setErrorClass as setErrorClass };
 }
 
+/**
+ * Set expiration time for cookies.
+ * @param days - Number of days until cookies expire.
+ */
 declare function setExpireDays(days: number): void;
+/**
+ * Is consent pending (cookies not yet accepted)?
+ * @returns
+ */
 declare function isConsentPending(): boolean;
+/**
+ * Consent cookies.
+ */
 declare function accept(): void;
+/**
+ * Decline cookies. This will reject all cookies than a single flags that cookies have been declined.
+ */
 declare function decline(): void;
+/**
+ * Save a cookie.
+ * @param name - Cookie name.
+ * @param value - Cookie value, can be string, number or boolean.
+ * @returns - Returns given value.
+ */
 declare function save<T extends string | number | boolean>(name: string, value: T): T;
+/**
+ * Read a string cookie.
+ * @param name - Cookie name.
+ * @param defaultValue - Default value returned when cookie with given name was not found.
+ * @returns - String cookie value.
+ */
 declare function read(name: string, defaultValue: string): string;
+/**
+ * Read an integer cookie.
+ * @param name - Cookie name.
+ * @param defaultValue - Default value returned when cookie with given name was not found.
+ * @returns - Integer cookie valus.
+ */
 declare function readInt(name: string, defaultValue: number): number;
+/**
+ * Read a boolean cookie.
+ * @param name - Cookie name.
+ * @param defaultValue - Default value returned when cookie with given name was not found.
+ * @returns - Boolean cookie value.
+ */
 declare function readBool(name: string, defaultValue: boolean): boolean;
+/**
+ * Erase cookie.
+ * @param name - Name of cookie to be erased.
+ */
 declare function erase(name: string): void;
+/**
+ * Erase all cookies.
+ */
 declare function eraseAll(): void;
 
 declare const cookies_accept: typeof accept;
@@ -168,15 +213,39 @@ declare namespace cookies {
   export { cookies_accept as accept, cookies_decline as decline, cookies_erase as erase, cookies_eraseAll as eraseAll, cookies_isConsentPending as isConsentPending, cookies_read as read, cookies_readBool as readBool, cookies_readInt as readInt, cookies_save as save, cookies_setExpireDays as setExpireDays };
 }
 
+/** Devices dots per inch. */
 declare const DPI: number;
+/** Devices pixels per millimeter. */
 declare const PxPerMm: number;
+/** Browsers scroll bar width. */
 declare const ScrollbarWidth: number;
+/** Browsers system font size. */
 declare const FontSize: number;
+/** Is touch device? */
 declare const IsTouchDevice: boolean;
+/** Is mobile device? */
 declare const IsMobileDevice: boolean;
+/** Host address. */
 declare const HostAddress: string;
+/**
+ * Convert pixels to millimeters on a device.
+ * @param px - Pixels.
+ * @returns - Millimeters.
+ */
 declare function pxToMm(px: number): number;
+/**
+ * Convert millimeters to pixels on a device.
+ * @param mm - Millimeters.
+ * @returns - Pixels.
+ */
 declare function mmToPx(mm: number): number;
+/**
+ * Convert input to pixels on a device. Input value is in html style form containing number
+ * followed by unit (e.g. "10px"). Supported units are "mm", "cm", "in", "inch", "em" and "px".
+ *
+ * @param input - Input value.
+ * @returns - Pixels.
+ */
 declare function toPx(input: string | number): number;
 
 declare const device_DPI: typeof DPI;
@@ -310,8 +379,9 @@ declare namespace Guard {
 
 declare function toArray<T>(a: T | T[]): Array<T>;
 declare function duplicate<T>(a: T[] | undefined): T[] | undefined;
-declare function removeDuplicates<T>(a: T[]): T[];
-declare function removeDuplicatesCmp<T>(arr: ReadonlyArray<T>, cmp: (t1: T, t2: T) => boolean): T[];
+declare function removeDuplicates<T>(arr: T[], compareFn?: (a: T, b: T) => boolean): T[];
+/** @deprecated - Use {@link removeDuplicates} with compareFn instead. */
+declare function removeDuplicatesCmp<T>(arr: ReadonlyArray<T>, compareFn: (t1: T, t2: T) => boolean): T[];
 declare function fillArray<T>(fillValue: T, fillCount: number): T[];
 declare function mapSequenceArray<T>(len: number, fn: (i: number) => T): T[];
 declare function getSequenceArray(len: number): number[];
@@ -545,18 +615,33 @@ declare namespace index {
   export { index$6 as Arr, index$5 as Dom, index$8 as Enum, index_Is as Is, index$4 as Map, index$3 as Math, index$2 as Obj, index$1 as Str };
 }
 
+/**
+ * This is a stack data structure.
+ */
 declare class Stack<T> {
-    private readonly list;
-    push(e: T): T;
+    private readonly data;
+    private assertId;
+    get length(): number;
+    push(el: T): T;
     pop(): T;
+    popOrUndef(): T | undefined;
+    popOr(defaultValueOrCreator: T | (() => T)): T;
     top(): T;
+    topOrUndef(): T | undefined;
+    topOr(defaultValueOrCreator: T | (() => T)): T;
+    peek(depth?: number): T;
+    peekOrUndef(depth?: number): T | undefined;
+    peekOr(depth: number | undefined, defaultValueOrCreator: T | (() => T)): T;
+    values(): IterableIterator<T>;
+    [Symbol.iterator](): IterableIterator<T>;
     toArray(): T[];
-    get length(): number;
+    isEmpty(): boolean;
     clear(): void;
+    toString(): string;
 }
 
 /**
- * Vector class.
+ * `Vec` is a generic vector class with two or more coordinates.
  *
  * ```ts
  * // Example usage:
@@ -606,7 +691,7 @@ declare class Vec {
 }
 
 /**
- * DivRect class, left, top, right, bottom rectangle divided into four sections by anchorX, anchorY.
+ * DivRect class is a rectangle (left, top, right, bottom) with an anchor point (anchorX, anchorY).
  */
 declare class DivRect {
     left: number;
@@ -830,7 +915,7 @@ declare class DivRect {
 }
 
 /**
- * LRUCache class: Least Recently Used cache with a fixed capacity
+ * LRUCache is an implementation of least recently used cache with a fixed capacity.
  */
 declare class LRUCache<K extends string, V> {
     private cache;
@@ -867,7 +952,8 @@ interface KVComponent<K extends any[], VALUE> {
 }
 
 /**
- * An array-like structure for non-negative indexes.
+ * `IndexArray` is a sparse array with non-negative indexes. It stores values
+ * to indexes, and each index also has flag telling it has a value.
  */
 declare class IndexArray<VALUE> implements KVComponent<[number], VALUE> {
     private static validateIndex;
@@ -879,6 +965,8 @@ declare class IndexArray<VALUE> implements KVComponent<[number], VALUE> {
     constructor(entries: Iterable<[number, VALUE]>);
     private get posLen();
     get size(): number;
+    get length(): number;
+    private trimRight;
     isEmpty(): boolean;
     has(id: number): boolean;
     set(id: number, value: VALUE): void;
@@ -898,7 +986,7 @@ declare class IndexArray<VALUE> implements KVComponent<[number], VALUE> {
     kvKeys(): IterableIterator<[number]>;
     kvValues(): IterableIterator<VALUE>;
     kvEntries(): IterableIterator<[[number], VALUE]>;
-    [Symbol.iterator](): Generator<[number, VALUE], void, any>;
+    [Symbol.iterator](): IterableIterator<[number, VALUE]>;
     clone(): IndexArray<VALUE>;
     merge(other: IndexArray<VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, id: number) => VALUE): this;
     some(fn: (value: VALUE, id: number) => boolean): boolean;
@@ -911,11 +999,13 @@ declare class IndexArray<VALUE> implements KVComponent<[number], VALUE> {
     map<R = VALUE>(fn: (value: VALUE, key1: number) => R): IndexArray<R>;
     equals(other: IndexArray<VALUE>): boolean;
     equals(other: IndexArray<VALUE>, eq: (a: VALUE, b: VALUE) => boolean): boolean;
+    toArray(): VALUE[];
     toString(): string;
 }
 
 /**
- * An array-like structure for signed indexes, including negatives.
+ * `IndexArray` is a sparse array with positive and negative indexes. It stores
+ * values to indexes, and each index also has flag telling it has a value.
  */
 declare class SignedIndexArray<VALUE> implements KVComponent<[number], VALUE> {
     private static toNegIndex;
@@ -950,7 +1040,7 @@ declare class SignedIndexArray<VALUE> implements KVComponent<[number], VALUE> {
     kvKeys(): IterableIterator<[number]>;
     kvValues(): IterableIterator<VALUE>;
     kvEntries(): IterableIterator<[[number], VALUE]>;
-    [Symbol.iterator](): Generator<[number, VALUE], void, any>;
+    [Symbol.iterator](): IterableIterator<[number, VALUE]>;
     clone(): SignedIndexArray<VALUE>;
     merge(other: SignedIndexArray<VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, id: number) => VALUE): this;
     some(fn: (value: VALUE, id: number) => boolean): boolean;
@@ -963,9 +1053,13 @@ declare class SignedIndexArray<VALUE> implements KVComponent<[number], VALUE> {
     map<R = VALUE>(fn: (value: VALUE, key1: number) => R): SignedIndexArray<R>;
     equals(other: SignedIndexArray<VALUE>): boolean;
     equals(other: SignedIndexArray<VALUE>, eq: (a: VALUE, b: VALUE) => boolean): boolean;
+    toArray(): VALUE[];
     toString(): string;
 }
 
+/**
+ * A Map implementation mapping a single key to a value.
+ */
 declare class Map1<KEY1, VALUE> implements KVComponent<[KEY1], VALUE> {
     private map1;
     constructor();
@@ -991,7 +1085,7 @@ declare class Map1<KEY1, VALUE> implements KVComponent<[KEY1], VALUE> {
     kvKeys(): IterableIterator<[KEY1]>;
     kvValues(): IterableIterator<VALUE>;
     kvEntries(): IterableIterator<[[KEY1], VALUE]>;
-    [Symbol.iterator](): Generator<[KEY1, VALUE], void, any>;
+    [Symbol.iterator](): IterableIterator<[KEY1, VALUE]>;
     clone(): Map1<KEY1, VALUE>;
     merge(other: Map1<KEY1, VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, key1: KEY1) => VALUE): this;
     some(fn: (value: VALUE, key1: KEY1) => boolean): boolean;
@@ -1006,6 +1100,9 @@ declare class Map1<KEY1, VALUE> implements KVComponent<[KEY1], VALUE> {
     toString(): string;
 }
 
+/**
+ * A Map implementation mapping a double key to a value.
+ */
 declare class Map2<KEY1, KEY2, VALUE> implements KVComponent<[KEY1, KEY2], VALUE> {
     private map1;
     constructor();
@@ -1032,7 +1129,7 @@ declare class Map2<KEY1, KEY2, VALUE> implements KVComponent<[KEY1, KEY2], VALUE
     kvKeys(): IterableIterator<[KEY1, KEY2]>;
     kvValues(): IterableIterator<VALUE>;
     kvEntries(): IterableIterator<[[KEY1, KEY2], VALUE]>;
-    [Symbol.iterator](): Generator<[KEY1, KEY2, VALUE], void, any>;
+    [Symbol.iterator](): IterableIterator<[KEY1, KEY2, VALUE]>;
     clone(): Map2<KEY1, KEY2, VALUE>;
     merge(other: Map2<KEY1, KEY2, VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, key1: KEY1, key2: KEY2) => VALUE): this;
     some(fn: (value: VALUE, key1: KEY1, key2: KEY2) => boolean): boolean;
@@ -1047,6 +1144,9 @@ declare class Map2<KEY1, KEY2, VALUE> implements KVComponent<[KEY1, KEY2], VALUE
     toString(): string;
 }
 
+/**
+ * A Map implementation mapping a triple key to a value.
+ */
 declare class Map3<KEY1, KEY2, KEY3, VALUE> implements KVComponent<[KEY1, KEY2, KEY3], VALUE> {
     private map1;
     constructor();
@@ -1074,7 +1174,7 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> implements KVComponent<[KEY1, KEY2,
     kvKeys(): IterableIterator<[KEY1, KEY2, KEY3]>;
     kvValues(): IterableIterator<VALUE>;
     kvEntries(): IterableIterator<[[KEY1, KEY2, KEY3], VALUE]>;
-    [Symbol.iterator](): Generator<[KEY1, KEY2, KEY3, VALUE], void, any>;
+    [Symbol.iterator](): IterableIterator<[KEY1, KEY2, KEY3, VALUE]>;
     clone(): Map3<KEY1, KEY2, KEY3, VALUE>;
     merge(other: Map3<KEY1, KEY2, KEY3, VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, key1: KEY1, key2: KEY2, key3: KEY3) => VALUE): this;
     some(fn: (value: VALUE, key1: KEY1, key2: KEY2, key3: KEY3) => boolean): boolean;
@@ -1089,6 +1189,9 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> implements KVComponent<[KEY1, KEY2,
     toString(): string;
 }
 
+/**
+ * Wrapper class of a key-value container that contain array values.
+ */
 declare class MultiContainer<K extends any[], V> {
     private readonly base;
     constructor(base: KVComponent<K, V[]>);
@@ -1105,10 +1208,14 @@ declare class MultiContainer<K extends any[], V> {
     toString(): string;
 }
 /**
+ * Create a multi-container.
+ *
  * ```ts
  * // Usage:
  * const multi = asMulti(new Map2<string, string, number[]>());
- * multi.add("A", "B", 5);
+ * multi.add("a", "b", 5);
+ * multi.add("a", "b", 10);
+ * multi.add("a", "c", 15);
  * ```
  * @param base
  * @returns

package/dist/index.js

@@ -1,4 +1,4 @@
-/* TsUtilsLib v1.18.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
+/* TsUtilsLib v1.19.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -516,21 +516,6 @@ var _consent;
 var _expires;
 var str = _read(ConsentCookieName);
 _consent = str === "accept" /* Accept */ || str === "decline" /* Decline */ ? str : void 0;
-function setExpireDays(days) {
-  _expires = /* @__PURE__ */ new Date();
-  _expires.setDate(_expires.getDate() + days);
-}
-function isConsentPending() {
-  return _consent === void 0;
-}
-function accept() {
-  _consent = "accept" /* Accept */;
-  _save(ConsentCookieName, _consent);
-}
-function decline() {
-  _consent = "decline" /* Decline */;
-  _save(ConsentCookieName, _consent);
-}
 function _getList() {
   let s = document.cookie;
   return s.split(";").map((c) => c.trim());
@@ -550,18 +535,31 @@ function _read(name, defaultValue) {
 function _erase(name) {
   document.cookie = name + "=;expires=Thu, 01 Jan 1970 00:00:00 UTC;";
 }
+function setExpireDays(days) {
+  _expires = /* @__PURE__ */ new Date();
+  _expires.setDate(_expires.getDate() + days);
+}
+function isConsentPending() {
+  return _consent === void 0;
+}
+function accept() {
+  _consent = "accept" /* Accept */;
+  _save(ConsentCookieName, _consent);
+}
+function decline() {
+  _consent = "decline" /* Decline */;
+  _save(ConsentCookieName, _consent);
+}
 function save(name, value) {
-  if (_consent === "accept" /* Accept */) {
+  if (_consent === "accept" /* Accept */)
     _save(name, value);
-  }
   return value;
 }
 function read(name, defaultValue) {
-  if (_consent === "accept" /* Accept */) {
-    return _read(name, defaultValue) || defaultValue;
-  } else {
+  if (_consent === "accept" /* Accept */)
+    return _read(name, defaultValue) ?? defaultValue;
+  else
     return defaultValue;
-  }
 }
 function readInt(name, defaultValue) {
   if (_consent === "accept" /* Accept */) {
@@ -580,9 +578,8 @@ function readBool(name, defaultValue) {
   }
 }
 function erase(name) {
-  if (_consent === "accept" /* Accept */ || name === ConsentCookieName) {
+  if (_consent === "accept" /* Accept */ || name === ConsentCookieName)
     _erase(name);
-  }
 }
 function eraseAll() {
   document.cookie.split(";").forEach((c) => erase(c.trim().split("=")[0]));
@@ -690,7 +687,7 @@ function toPx(input) {
   } else {
     value = parseFloat(input);
   }
-  assert_exports.finite(value, "value in function toPx");
+  assert_exports.isFinite(value, "value in function toPx");
   switch (unit) {
     case "mm":
       return mmToPx(value);
@@ -1038,11 +1035,11 @@ function toArray(a) {
 function duplicate(a) {
   return a === void 0 ? a : a.slice();
 }
-function removeDuplicates(a) {
-  return a.filter((item, pos, arr) => arr.indexOf(item) === pos);
+function removeDuplicates(arr, compareFn) {
+  return compareFn !== void 0 ? arr.filter((a, id, self) => id === self.findIndex((b) => compareFn(a, b))) : arr.filter((a, id, self) => id === self.indexOf(a));
 }
-function removeDuplicatesCmp(arr, cmp2) {
-  return arr.filter((t1, index, self) => index === self.findIndex((t2) => cmp2(t1, t2)));
+function removeDuplicatesCmp(arr, compareFn) {
+  return arr.filter((a, id, self) => id === self.findIndex((b) => compareFn(a, b)));
 }
 function fillArray(fillValue, fillCount) {
   if (!isInteger2(fillCount) || fillCount < 0) {
@@ -1505,30 +1502,83 @@ function makeSentenceFromPascal(PascalString) {
 // src/utils/index.ts
 var Is = guard_exports;
 
+// src/core/format-value.ts
+function formatValue(value) {
+  if (isString2(value)) {
+    return `"${value}"`;
+  } else if (isArray2(value)) {
+    return `[ ${value.map((e) => formatValue(e)).join(", ")} ]`.replaceAll("  ", " ");
+  } else if (isFunction2(value.toString)) {
+    return value.toString();
+  } else {
+    return JSON.stringify(value);
+  }
+}
+
 // src/core/stack.ts
 var Stack = class {
   constructor() {
-    __publicField(this, "list", []);
+    __publicField(this, "data", []);
+  }
+  assertId(id) {
+    assert_exports.isIntegerBetween(id, 0, this.length - 1, `Stack index ${id} out of range.`);
+    return id;
   }
-  push(e) {
-    this.list.push(e);
-    return e;
+  get length() {
+    return this.data.length;
+  }
+  push(el) {
+    this.data.push(el);
+    return el;
   }
   pop() {
-    assert_exports.int_gt(this.list.length, 0);
-    return this.list.pop();
+    this.assertId(this.length - 1);
+    return this.data.pop();
+  }
+  popOrUndef() {
+    return this.data.pop();
+  }
+  popOr(defaultValueOrCreator) {
+    return this.isEmpty() ? isFunction2(defaultValueOrCreator) ? defaultValueOrCreator() : defaultValueOrCreator : this.data.pop();
   }
   top() {
-    return assert_exports.array_elem(this.list, this.list.length - 1, "Stack is empty!");
+    return this.data[this.assertId(this.length - 1)];
+  }
+  topOrUndef() {
+    return this.data[this.length - 1];
+  }
+  topOr(defaultValueOrCreator) {
+    return this.isEmpty() ? isFunction2(defaultValueOrCreator) ? defaultValueOrCreator() : defaultValueOrCreator : this.data[this.length - 1];
+  }
+  peek(depth = 0) {
+    return this.data[this.assertId(this.data.length - 1 - depth)];
+  }
+  peekOrUndef(depth = 0) {
+    return this.data[this.data.length - 1 - depth];
+  }
+  peekOr(depth = 0, defaultValueOrCreator) {
+    const id = this.data.length - 1 - depth;
+    const value = id < 0 ? void 0 : this.data[id];
+    return value === void 0 ? isFunction2(defaultValueOrCreator) ? defaultValueOrCreator() : defaultValueOrCreator : value;
+  }
+  *values() {
+    for (let id = this.data.length - 1; id >= 0; id--)
+      yield this.data[id];
+  }
+  *[Symbol.iterator]() {
+    yield* this.values();
   }
   toArray() {
-    return this.list;
+    return [...this.data];
   }
-  get length() {
-    return this.list.length;
+  isEmpty() {
+    return this.length === 0;
   }
   clear() {
-    this.list.length = 0;
+    this.data.length = 0;
+  }
+  toString() {
+    return `Stack(${this.length})${formatValue(this.data)}`;
   }
 };
 
@@ -2112,6 +2162,14 @@ var IndexArray = class _IndexArray {
   get size() {
     return this.valCount;
   }
+  get length() {
+    return this.hasPos.length;
+  }
+  trimRight() {
+    let newLength = this.length;
+    while (newLength > 0 && this.hasPos[newLength - 1] !== true) newLength--;
+    if (newLength < this.length) this.posVal.length = this.hasPos.length = newLength;
+  }
   isEmpty() {
     return this.size === 0;
   }
@@ -2146,6 +2204,7 @@ var IndexArray = class _IndexArray {
     this.posVal[id] = void 0;
     this.hasPos[id] = false;
     this.valCount--;
+    this.trimRight();
     return true;
   }
   clear() {
@@ -2282,10 +2341,12 @@ var IndexArray = class _IndexArray {
     }
     return true;
   }
+  toArray() {
+    return this.valuesArray();
+  }
   toString() {
-    if (this.size === 0) return `IndexArray[ ]`;
-    const entries = this.entriesArray().map(([id, value]) => `${id}: ${value}`).join(", ");
-    return `IndexArray[ ${entries} ]`;
+    const entries = this.entriesArray().map(([id, v]) => `${formatValue(id)}: ${formatValue(v)}`).join(", ");
+    return `IndexArray[ ${entries} ]`.replaceAll("  ", " ");
   }
 };
 
@@ -2543,10 +2604,12 @@ var SignedIndexArray = class _SignedIndexArray {
     }
     return true;
   }
+  toArray() {
+    return this.valuesArray();
+  }
   toString() {
-    if (this.size === 0) return `SignedIndexArray[ ]`;
-    const entries = this.entriesArray().map(([id, value]) => `${id}: ${value}`).join(", ");
-    return `SignedIndexArray[ ${entries} ]`;
+    const entries = this.entriesArray().map(([id, v]) => `${formatValue(id)}: ${formatValue(v)}`).join(", ");
+    return `SignedIndexArray[ ${entries} ]`.replaceAll("  ", " ");
   }
 };
 
@@ -2703,8 +2766,8 @@ var Map1 = class _Map1 {
     return new Map(this.map1);
   }
   toString() {
-    const entries = [...this.map1].map(([k, v]) => `${k} => ${v}`).join(", ");
-    return entries.length === 0 ? `Map1(0){ }` : `Map1(${this.size}){ ${entries} }`;
+    const entries = [...this.map1].map(([k, v]) => `${formatValue(k)} => ${formatValue(v)}`).join(", ");
+    return `Map1(${this.size}){ ${entries} }`.replaceAll("  ", " ");
   }
 };
 
@@ -2897,10 +2960,10 @@ var Map2 = class _Map2 {
   toString() {
     const entries = [];
     for (const [key1, map2] of this.map1) {
-      const inner = [...map2].map(([key2, v]) => `${key2} => ${v}`).join(", ");
-      entries.push(`${key1} => { ${inner} }`);
+      const inner = [...map2].map(([key2, v]) => `${formatValue(key2)} => ${formatValue(v)}`).join(", ");
+      entries.push(`${formatValue(key1)} => { ${inner} }`);
     }
-    return entries.length === 0 ? `Map2(0){ }` : `Map2(${this.size}){ ${entries} }`;
+    return `Map2(${this.size}){ ${entries} }`.replaceAll("  ", " ");
   }
 };
 
@@ -3125,11 +3188,11 @@ var Map3 = class _Map3 {
     const entries = [];
     for (const [key1, map2] of this.map1) {
       for (const [key2, map3] of map2) {
-        const inner = [...map3].map(([key3, v]) => `${key3} => ${v}`).join(", ");
-        entries.push(`${key1} => ${key2} => { ${inner} }`);
+        const inner = [...map3].map(([key3, v]) => `${formatValue(key3)} => ${formatValue(v)}`).join(", ");
+        entries.push(`${formatValue(key1)} => ${formatValue(key2)} => { ${inner} }`);
       }
     }
-    return entries.length === 0 ? `Map3(0){ }` : `Map3(${this.size}){ ${entries.join(", ")} }`;
+    return `Map3(${this.size}){ ${entries.join(", ")} }`.replaceAll("  ", " ");
   }
 };
 
@@ -3191,11 +3254,11 @@ var MultiContainer = class {
     const entries = [];
     for (const keys of this.keys()) {
       const arr = this.getAll(...keys);
-      const keyStr = Array.isArray(keys) ? `[${keys.map((k) => JSON.stringify(k)).join(", ")}]` : `[${JSON.stringify(keys)}]`;
-      const valuesStr = Array.isArray(arr) ? `[${arr.map((v) => JSON.stringify(v)).join(", ")}]` : "[]";
+      const keyStr = Array.isArray(keys) ? formatValue(keys) : "[ ]";
+      const valuesStr = Array.isArray(arr) ? formatValue(arr) : "[ ]";
       entries.push(`${keyStr} => ${valuesStr}`);
     }
-    return `MultiContainer{ ${entries.join(", ")} }`;
+    return `MultiContainer{ ${entries.join(", ")} }`.replaceAll("  ", " ");
   }
 };
 function asMulti(base) {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-/* TsUtilsLib v1.18.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
+/* TsUtilsLib v1.19.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
@@ -479,21 +479,6 @@ var _consent;
 var _expires;
 var str = _read(ConsentCookieName);
 _consent = str === "accept" /* Accept */ || str === "decline" /* Decline */ ? str : void 0;
-function setExpireDays(days) {
-  _expires = /* @__PURE__ */ new Date();
-  _expires.setDate(_expires.getDate() + days);
-}
-function isConsentPending() {
-  return _consent === void 0;
-}
-function accept() {
-  _consent = "accept" /* Accept */;
-  _save(ConsentCookieName, _consent);
-}
-function decline() {
-  _consent = "decline" /* Decline */;
-  _save(ConsentCookieName, _consent);
-}
 function _getList() {
   let s = document.cookie;
   return s.split(";").map((c) => c.trim());
@@ -513,18 +498,31 @@ function _read(name, defaultValue) {
 function _erase(name) {
   document.cookie = name + "=;expires=Thu, 01 Jan 1970 00:00:00 UTC;";
 }
+function setExpireDays(days) {
+  _expires = /* @__PURE__ */ new Date();
+  _expires.setDate(_expires.getDate() + days);
+}
+function isConsentPending() {
+  return _consent === void 0;
+}
+function accept() {
+  _consent = "accept" /* Accept */;
+  _save(ConsentCookieName, _consent);
+}
+function decline() {
+  _consent = "decline" /* Decline */;
+  _save(ConsentCookieName, _consent);
+}
 function save(name, value) {
-  if (_consent === "accept" /* Accept */) {
+  if (_consent === "accept" /* Accept */)
     _save(name, value);
-  }
   return value;
 }
 function read(name, defaultValue) {
-  if (_consent === "accept" /* Accept */) {
-    return _read(name, defaultValue) || defaultValue;
-  } else {
+  if (_consent === "accept" /* Accept */)
+    return _read(name, defaultValue) ?? defaultValue;
+  else
     return defaultValue;
-  }
 }
 function readInt(name, defaultValue) {
   if (_consent === "accept" /* Accept */) {
@@ -543,9 +541,8 @@ function readBool(name, defaultValue) {
   }
 }
 function erase(name) {
-  if (_consent === "accept" /* Accept */ || name === ConsentCookieName) {
+  if (_consent === "accept" /* Accept */ || name === ConsentCookieName)
     _erase(name);
-  }
 }
 function eraseAll() {
   document.cookie.split(";").forEach((c) => erase(c.trim().split("=")[0]));
@@ -653,7 +650,7 @@ function toPx(input) {
   } else {
     value = parseFloat(input);
   }
-  assert_exports.finite(value, "value in function toPx");
+  assert_exports.isFinite(value, "value in function toPx");
   switch (unit) {
     case "mm":
       return mmToPx(value);
@@ -1001,11 +998,11 @@ function toArray(a) {
 function duplicate(a) {
   return a === void 0 ? a : a.slice();
 }
-function removeDuplicates(a) {
-  return a.filter((item, pos, arr) => arr.indexOf(item) === pos);
+function removeDuplicates(arr, compareFn) {
+  return compareFn !== void 0 ? arr.filter((a, id, self) => id === self.findIndex((b) => compareFn(a, b))) : arr.filter((a, id, self) => id === self.indexOf(a));
 }
-function removeDuplicatesCmp(arr, cmp2) {
-  return arr.filter((t1, index, self) => index === self.findIndex((t2) => cmp2(t1, t2)));
+function removeDuplicatesCmp(arr, compareFn) {
+  return arr.filter((a, id, self) => id === self.findIndex((b) => compareFn(a, b)));
 }
 function fillArray(fillValue, fillCount) {
   if (!isInteger2(fillCount) || fillCount < 0) {
@@ -1468,30 +1465,83 @@ function makeSentenceFromPascal(PascalString) {
 // src/utils/index.ts
 var Is = guard_exports;
 
+// src/core/format-value.ts
+function formatValue(value) {
+  if (isString2(value)) {
+    return `"${value}"`;
+  } else if (isArray2(value)) {
+    return `[ ${value.map((e) => formatValue(e)).join(", ")} ]`.replaceAll("  ", " ");
+  } else if (isFunction2(value.toString)) {
+    return value.toString();
+  } else {
+    return JSON.stringify(value);
+  }
+}
+
 // src/core/stack.ts
 var Stack = class {
   constructor() {
-    __publicField(this, "list", []);
+    __publicField(this, "data", []);
+  }
+  assertId(id) {
+    assert_exports.isIntegerBetween(id, 0, this.length - 1, `Stack index ${id} out of range.`);
+    return id;
   }
-  push(e) {
-    this.list.push(e);
-    return e;
+  get length() {
+    return this.data.length;
+  }
+  push(el) {
+    this.data.push(el);
+    return el;
   }
   pop() {
-    assert_exports.int_gt(this.list.length, 0);
-    return this.list.pop();
+    this.assertId(this.length - 1);
+    return this.data.pop();
+  }
+  popOrUndef() {
+    return this.data.pop();
+  }
+  popOr(defaultValueOrCreator) {
+    return this.isEmpty() ? isFunction2(defaultValueOrCreator) ? defaultValueOrCreator() : defaultValueOrCreator : this.data.pop();
   }
   top() {
-    return assert_exports.array_elem(this.list, this.list.length - 1, "Stack is empty!");
+    return this.data[this.assertId(this.length - 1)];
+  }
+  topOrUndef() {
+    return this.data[this.length - 1];
+  }
+  topOr(defaultValueOrCreator) {
+    return this.isEmpty() ? isFunction2(defaultValueOrCreator) ? defaultValueOrCreator() : defaultValueOrCreator : this.data[this.length - 1];
+  }
+  peek(depth = 0) {
+    return this.data[this.assertId(this.data.length - 1 - depth)];
+  }
+  peekOrUndef(depth = 0) {
+    return this.data[this.data.length - 1 - depth];
+  }
+  peekOr(depth = 0, defaultValueOrCreator) {
+    const id = this.data.length - 1 - depth;
+    const value = id < 0 ? void 0 : this.data[id];
+    return value === void 0 ? isFunction2(defaultValueOrCreator) ? defaultValueOrCreator() : defaultValueOrCreator : value;
+  }
+  *values() {
+    for (let id = this.data.length - 1; id >= 0; id--)
+      yield this.data[id];
+  }
+  *[Symbol.iterator]() {
+    yield* this.values();
   }
   toArray() {
-    return this.list;
+    return [...this.data];
   }
-  get length() {
-    return this.list.length;
+  isEmpty() {
+    return this.length === 0;
   }
   clear() {
-    this.list.length = 0;
+    this.data.length = 0;
+  }
+  toString() {
+    return `Stack(${this.length})${formatValue(this.data)}`;
   }
 };
 
@@ -2075,6 +2125,14 @@ var IndexArray = class _IndexArray {
   get size() {
     return this.valCount;
   }
+  get length() {
+    return this.hasPos.length;
+  }
+  trimRight() {
+    let newLength = this.length;
+    while (newLength > 0 && this.hasPos[newLength - 1] !== true) newLength--;
+    if (newLength < this.length) this.posVal.length = this.hasPos.length = newLength;
+  }
   isEmpty() {
     return this.size === 0;
   }
@@ -2109,6 +2167,7 @@ var IndexArray = class _IndexArray {
     this.posVal[id] = void 0;
     this.hasPos[id] = false;
     this.valCount--;
+    this.trimRight();
     return true;
   }
   clear() {
@@ -2245,10 +2304,12 @@ var IndexArray = class _IndexArray {
     }
     return true;
   }
+  toArray() {
+    return this.valuesArray();
+  }
   toString() {
-    if (this.size === 0) return `IndexArray[ ]`;
-    const entries = this.entriesArray().map(([id, value]) => `${id}: ${value}`).join(", ");
-    return `IndexArray[ ${entries} ]`;
+    const entries = this.entriesArray().map(([id, v]) => `${formatValue(id)}: ${formatValue(v)}`).join(", ");
+    return `IndexArray[ ${entries} ]`.replaceAll("  ", " ");
   }
 };
 
@@ -2506,10 +2567,12 @@ var SignedIndexArray = class _SignedIndexArray {
     }
     return true;
   }
+  toArray() {
+    return this.valuesArray();
+  }
   toString() {
-    if (this.size === 0) return `SignedIndexArray[ ]`;
-    const entries = this.entriesArray().map(([id, value]) => `${id}: ${value}`).join(", ");
-    return `SignedIndexArray[ ${entries} ]`;
+    const entries = this.entriesArray().map(([id, v]) => `${formatValue(id)}: ${formatValue(v)}`).join(", ");
+    return `SignedIndexArray[ ${entries} ]`.replaceAll("  ", " ");
   }
 };
 
@@ -2666,8 +2729,8 @@ var Map1 = class _Map1 {
     return new Map(this.map1);
   }
   toString() {
-    const entries = [...this.map1].map(([k, v]) => `${k} => ${v}`).join(", ");
-    return entries.length === 0 ? `Map1(0){ }` : `Map1(${this.size}){ ${entries} }`;
+    const entries = [...this.map1].map(([k, v]) => `${formatValue(k)} => ${formatValue(v)}`).join(", ");
+    return `Map1(${this.size}){ ${entries} }`.replaceAll("  ", " ");
   }
 };
 
@@ -2860,10 +2923,10 @@ var Map2 = class _Map2 {
   toString() {
     const entries = [];
     for (const [key1, map2] of this.map1) {
-      const inner = [...map2].map(([key2, v]) => `${key2} => ${v}`).join(", ");
-      entries.push(`${key1} => { ${inner} }`);
+      const inner = [...map2].map(([key2, v]) => `${formatValue(key2)} => ${formatValue(v)}`).join(", ");
+      entries.push(`${formatValue(key1)} => { ${inner} }`);
     }
-    return entries.length === 0 ? `Map2(0){ }` : `Map2(${this.size}){ ${entries} }`;
+    return `Map2(${this.size}){ ${entries} }`.replaceAll("  ", " ");
   }
 };
 
@@ -3088,11 +3151,11 @@ var Map3 = class _Map3 {
     const entries = [];
     for (const [key1, map2] of this.map1) {
       for (const [key2, map3] of map2) {
-        const inner = [...map3].map(([key3, v]) => `${key3} => ${v}`).join(", ");
-        entries.push(`${key1} => ${key2} => { ${inner} }`);
+        const inner = [...map3].map(([key3, v]) => `${formatValue(key3)} => ${formatValue(v)}`).join(", ");
+        entries.push(`${formatValue(key1)} => ${formatValue(key2)} => { ${inner} }`);
       }
     }
-    return entries.length === 0 ? `Map3(0){ }` : `Map3(${this.size}){ ${entries.join(", ")} }`;
+    return `Map3(${this.size}){ ${entries.join(", ")} }`.replaceAll("  ", " ");
   }
 };
 
@@ -3154,11 +3217,11 @@ var MultiContainer = class {
     const entries = [];
     for (const keys of this.keys()) {
       const arr = this.getAll(...keys);
-      const keyStr = Array.isArray(keys) ? `[${keys.map((k) => JSON.stringify(k)).join(", ")}]` : `[${JSON.stringify(keys)}]`;
-      const valuesStr = Array.isArray(arr) ? `[${arr.map((v) => JSON.stringify(v)).join(", ")}]` : "[]";
+      const keyStr = Array.isArray(keys) ? formatValue(keys) : "[ ]";
+      const valuesStr = Array.isArray(arr) ? formatValue(arr) : "[ ]";
       entries.push(`${keyStr} => ${valuesStr}`);
     }
-    return `MultiContainer{ ${entries.join(", ")} }`;
+    return `MultiContainer{ ${entries.join(", ")} }`.replaceAll("  ", " ");
   }
 };
 function asMulti(base) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tspro/ts-utils-lib",
-    "version": "1.18.0",
+    "version": "1.19.0",
     "author": "PahkaSoft",
     "license": "MIT",
     "private": false,