@tspro/ts-utils-lib 1.15.0 → 1.16.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [1.16.0] - 2025-10-20
+### Added
+- Add isEmpty() to interface and containers.
+- Add more functions and iterators to MultiContainer.
+
 ## [1.15.0] - 2025-10-20
 ### Added
 - SignedIndexArray.equals()

package/dist/index.d.mts

@@ -452,6 +452,7 @@ declare class SmallIntCache<V> {
 
 interface KVComponent<K extends any[], EL> {
     get size(): number;
+    isEmpty(): boolean;
     has(...keys: K): boolean;
     get(...keys: K): EL | undefined;
     getOrDefault(...keysAndDefault: [...K, EL]): EL;
@@ -460,6 +461,9 @@ interface KVComponent<K extends any[], EL> {
     delete(...keys: K): boolean;
     clear?(): void;
     toString(): string;
+    kvValues(): IterableIterator<EL>;
+    kvKeys(): IterableIterator<K>;
+    kvEntries(): IterableIterator<[K, EL]>;
 }
 
 /**
@@ -474,8 +478,9 @@ declare class IndexArray<EL> implements KVComponent<[number], EL> {
     constructor();
     constructor(arr: IndexArray<EL>);
     constructor(entries: Iterable<[number, EL]>);
-    get size(): number;
     private get posLen();
+    get size(): number;
+    isEmpty(): boolean;
     has(id: number): boolean;
     set(id: number, el: EL): void;
     get(id: number): EL | undefined;
@@ -486,11 +491,14 @@ declare class IndexArray<EL> implements KVComponent<[number], EL> {
     clear(): void;
     forEach(callbackfn: (el: EL, id: number, arr: IndexArray<EL>) => void, thisArg?: any): void;
     indices(): IterableIterator<number>;
-    indicesArray(): number[];
     values(): IterableIterator<EL>;
-    valuesArray(): EL[];
     entries(): IterableIterator<[number, EL]>;
+    indicesArray(): number[];
+    valuesArray(): EL[];
     entriesArray(): [number, EL][];
+    kvKeys(): IterableIterator<[number]>;
+    kvValues(): IterableIterator<EL>;
+    kvEntries(): IterableIterator<[[number], EL]>;
     [Symbol.iterator](): Generator<[number, EL], void, any>;
     clone(): IndexArray<EL>;
     merge(other: IndexArray<EL>, conflictResolver?: (oldValue: EL, newValue: EL, id: number) => EL): this;
@@ -521,6 +529,7 @@ declare class SignedIndexArray<EL> implements KVComponent<[number], EL> {
     constructor(arr: SignedIndexArray<EL>);
     constructor(entries: Iterable<[number, EL]>);
     get size(): number;
+    isEmpty(): boolean;
     private get posLen();
     private get negLen();
     has(id: number): boolean;
@@ -533,11 +542,14 @@ declare class SignedIndexArray<EL> implements KVComponent<[number], EL> {
     clear(): void;
     forEach(callbackfn: (el: EL, id: number, arr: SignedIndexArray<EL>) => void, thisArg?: any): void;
     indices(): IterableIterator<number>;
-    indicesArray(): number[];
     values(): IterableIterator<EL>;
-    valuesArray(): EL[];
     entries(): IterableIterator<[number, EL]>;
+    indicesArray(): number[];
+    valuesArray(): EL[];
     entriesArray(): [number, EL][];
+    kvKeys(): IterableIterator<[number]>;
+    kvValues(): IterableIterator<EL>;
+    kvEntries(): IterableIterator<[[number], EL]>;
     [Symbol.iterator](): Generator<[number, EL], void, any>;
     clone(): SignedIndexArray<EL>;
     merge(other: SignedIndexArray<EL>, conflictResolver?: (oldValue: EL, newValue: EL, id: number) => EL): this;
@@ -567,13 +579,17 @@ declare class Map1<KEY1, VALUE> implements KVComponent<[KEY1], VALUE> {
     delete(key1: KEY1): boolean;
     clear(): void;
     get size(): number;
+    isEmpty(): boolean;
     forEach(callbackfn: (value: VALUE, key1: KEY1, map1: Map1<KEY1, VALUE>) => void, thisArg?: any): void;
     keys(): IterableIterator<KEY1>;
-    keysArray(): KEY1[];
     values(): IterableIterator<VALUE>;
-    valuesArray(): VALUE[];
     entries(): IterableIterator<[KEY1, VALUE]>;
+    keysArray(): KEY1[];
+    valuesArray(): VALUE[];
     entriesArray(): [KEY1, VALUE][];
+    kvKeys(): IterableIterator<[KEY1]>;
+    kvValues(): IterableIterator<VALUE>;
+    kvEntries(): IterableIterator<[[KEY1], VALUE]>;
     [Symbol.iterator](): Generator<[KEY1, VALUE], void, any>;
     clone(): Map1<KEY1, VALUE>;
     merge(other: Map1<KEY1, VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, key1: KEY1) => VALUE): this;
@@ -601,13 +617,17 @@ declare class Map2<KEY1, KEY2, VALUE> implements KVComponent<[KEY1, KEY2], VALUE
     delete(key1: KEY1, key2: KEY2): boolean;
     clear(): void;
     get size(): number;
+    isEmpty(): boolean;
     forEach(callbackfn: (value: VALUE, key1: KEY1, key2: KEY2, map2: Map2<KEY1, KEY2, VALUE>) => void, thisArg?: any): void;
     keys(): IterableIterator<[KEY1, KEY2]>;
-    keysArray(): [KEY1, KEY2][];
     values(): IterableIterator<VALUE>;
-    valuesArray(): VALUE[];
     entries(): IterableIterator<[KEY1, KEY2, VALUE]>;
+    keysArray(): [KEY1, KEY2][];
+    valuesArray(): VALUE[];
     entriesArray(): [KEY1, KEY2, VALUE][];
+    kvKeys(): IterableIterator<[KEY1, KEY2]>;
+    kvValues(): IterableIterator<VALUE>;
+    kvEntries(): IterableIterator<[[KEY1, KEY2], VALUE]>;
     [Symbol.iterator](): Generator<[KEY1, KEY2, VALUE], void, any>;
     clone(): Map2<KEY1, KEY2, VALUE>;
     merge(other: Map2<KEY1, KEY2, VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, key1: KEY1, key2: KEY2) => VALUE): this;
@@ -636,13 +656,17 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> implements KVComponent<[KEY1, KEY2,
     delete(key1: KEY1, key2: KEY2, key3: KEY3): boolean;
     clear(): void;
     get size(): number;
+    isEmpty(): boolean;
     forEach(callbackfn: (value: VALUE, key1: KEY1, key2: KEY2, key3: KEY3, map2: Map3<KEY1, KEY2, KEY3, VALUE>) => void, thisArg?: any): void;
     keys(): IterableIterator<[KEY1, KEY2, KEY3]>;
-    keysArray(): [KEY1, KEY2, KEY3][];
     values(): IterableIterator<VALUE>;
-    valuesArray(): VALUE[];
     entries(): IterableIterator<[KEY1, KEY2, KEY3, VALUE]>;
+    keysArray(): [KEY1, KEY2, KEY3][];
+    valuesArray(): VALUE[];
     entriesArray(): [KEY1, KEY2, KEY3, VALUE][];
+    kvKeys(): IterableIterator<[KEY1, KEY2, KEY3]>;
+    kvValues(): IterableIterator<VALUE>;
+    kvEntries(): IterableIterator<[[KEY1, KEY2, KEY3], VALUE]>;
     [Symbol.iterator](): Generator<[KEY1, KEY2, KEY3, VALUE], void, any>;
     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;
@@ -659,11 +683,17 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> implements KVComponent<[KEY1, KEY2,
 declare class MultiContainer<K extends any[], V> {
     private readonly base;
     constructor(base: KVComponent<K, V[]>);
+    isEmpty(): boolean;
+    clear(): void;
     add(...keysAndValue: [...K, V]): V;
     remove(...keysAndValue: [...K, V]): boolean;
     getAll(...keys: K): V[];
     iterAll(...keys: K): IterableIterator<V>;
-    clear(): void;
+    values(): IterableIterator<V>;
+    keys(): IterableIterator<K>;
+    entries(): IterableIterator<[K, V[]]>;
+    [Symbol.iterator](): IterableIterator<[K, V[]]>;
+    toString(): string;
 }
 /**
  * ```ts

package/dist/index.d.ts

@@ -452,6 +452,7 @@ declare class SmallIntCache<V> {
 
 interface KVComponent<K extends any[], EL> {
     get size(): number;
+    isEmpty(): boolean;
     has(...keys: K): boolean;
     get(...keys: K): EL | undefined;
     getOrDefault(...keysAndDefault: [...K, EL]): EL;
@@ -460,6 +461,9 @@ interface KVComponent<K extends any[], EL> {
     delete(...keys: K): boolean;
     clear?(): void;
     toString(): string;
+    kvValues(): IterableIterator<EL>;
+    kvKeys(): IterableIterator<K>;
+    kvEntries(): IterableIterator<[K, EL]>;
 }
 
 /**
@@ -474,8 +478,9 @@ declare class IndexArray<EL> implements KVComponent<[number], EL> {
     constructor();
     constructor(arr: IndexArray<EL>);
     constructor(entries: Iterable<[number, EL]>);
-    get size(): number;
     private get posLen();
+    get size(): number;
+    isEmpty(): boolean;
     has(id: number): boolean;
     set(id: number, el: EL): void;
     get(id: number): EL | undefined;
@@ -486,11 +491,14 @@ declare class IndexArray<EL> implements KVComponent<[number], EL> {
     clear(): void;
     forEach(callbackfn: (el: EL, id: number, arr: IndexArray<EL>) => void, thisArg?: any): void;
     indices(): IterableIterator<number>;
-    indicesArray(): number[];
     values(): IterableIterator<EL>;
-    valuesArray(): EL[];
     entries(): IterableIterator<[number, EL]>;
+    indicesArray(): number[];
+    valuesArray(): EL[];
     entriesArray(): [number, EL][];
+    kvKeys(): IterableIterator<[number]>;
+    kvValues(): IterableIterator<EL>;
+    kvEntries(): IterableIterator<[[number], EL]>;
     [Symbol.iterator](): Generator<[number, EL], void, any>;
     clone(): IndexArray<EL>;
     merge(other: IndexArray<EL>, conflictResolver?: (oldValue: EL, newValue: EL, id: number) => EL): this;
@@ -521,6 +529,7 @@ declare class SignedIndexArray<EL> implements KVComponent<[number], EL> {
     constructor(arr: SignedIndexArray<EL>);
     constructor(entries: Iterable<[number, EL]>);
     get size(): number;
+    isEmpty(): boolean;
     private get posLen();
     private get negLen();
     has(id: number): boolean;
@@ -533,11 +542,14 @@ declare class SignedIndexArray<EL> implements KVComponent<[number], EL> {
     clear(): void;
     forEach(callbackfn: (el: EL, id: number, arr: SignedIndexArray<EL>) => void, thisArg?: any): void;
     indices(): IterableIterator<number>;
-    indicesArray(): number[];
     values(): IterableIterator<EL>;
-    valuesArray(): EL[];
     entries(): IterableIterator<[number, EL]>;
+    indicesArray(): number[];
+    valuesArray(): EL[];
     entriesArray(): [number, EL][];
+    kvKeys(): IterableIterator<[number]>;
+    kvValues(): IterableIterator<EL>;
+    kvEntries(): IterableIterator<[[number], EL]>;
     [Symbol.iterator](): Generator<[number, EL], void, any>;
     clone(): SignedIndexArray<EL>;
     merge(other: SignedIndexArray<EL>, conflictResolver?: (oldValue: EL, newValue: EL, id: number) => EL): this;
@@ -567,13 +579,17 @@ declare class Map1<KEY1, VALUE> implements KVComponent<[KEY1], VALUE> {
     delete(key1: KEY1): boolean;
     clear(): void;
     get size(): number;
+    isEmpty(): boolean;
     forEach(callbackfn: (value: VALUE, key1: KEY1, map1: Map1<KEY1, VALUE>) => void, thisArg?: any): void;
     keys(): IterableIterator<KEY1>;
-    keysArray(): KEY1[];
     values(): IterableIterator<VALUE>;
-    valuesArray(): VALUE[];
     entries(): IterableIterator<[KEY1, VALUE]>;
+    keysArray(): KEY1[];
+    valuesArray(): VALUE[];
     entriesArray(): [KEY1, VALUE][];
+    kvKeys(): IterableIterator<[KEY1]>;
+    kvValues(): IterableIterator<VALUE>;
+    kvEntries(): IterableIterator<[[KEY1], VALUE]>;
     [Symbol.iterator](): Generator<[KEY1, VALUE], void, any>;
     clone(): Map1<KEY1, VALUE>;
     merge(other: Map1<KEY1, VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, key1: KEY1) => VALUE): this;
@@ -601,13 +617,17 @@ declare class Map2<KEY1, KEY2, VALUE> implements KVComponent<[KEY1, KEY2], VALUE
     delete(key1: KEY1, key2: KEY2): boolean;
     clear(): void;
     get size(): number;
+    isEmpty(): boolean;
     forEach(callbackfn: (value: VALUE, key1: KEY1, key2: KEY2, map2: Map2<KEY1, KEY2, VALUE>) => void, thisArg?: any): void;
     keys(): IterableIterator<[KEY1, KEY2]>;
-    keysArray(): [KEY1, KEY2][];
     values(): IterableIterator<VALUE>;
-    valuesArray(): VALUE[];
     entries(): IterableIterator<[KEY1, KEY2, VALUE]>;
+    keysArray(): [KEY1, KEY2][];
+    valuesArray(): VALUE[];
     entriesArray(): [KEY1, KEY2, VALUE][];
+    kvKeys(): IterableIterator<[KEY1, KEY2]>;
+    kvValues(): IterableIterator<VALUE>;
+    kvEntries(): IterableIterator<[[KEY1, KEY2], VALUE]>;
     [Symbol.iterator](): Generator<[KEY1, KEY2, VALUE], void, any>;
     clone(): Map2<KEY1, KEY2, VALUE>;
     merge(other: Map2<KEY1, KEY2, VALUE>, conflictResolver?: (oldValue: VALUE, newValue: VALUE, key1: KEY1, key2: KEY2) => VALUE): this;
@@ -636,13 +656,17 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> implements KVComponent<[KEY1, KEY2,
     delete(key1: KEY1, key2: KEY2, key3: KEY3): boolean;
     clear(): void;
     get size(): number;
+    isEmpty(): boolean;
     forEach(callbackfn: (value: VALUE, key1: KEY1, key2: KEY2, key3: KEY3, map2: Map3<KEY1, KEY2, KEY3, VALUE>) => void, thisArg?: any): void;
     keys(): IterableIterator<[KEY1, KEY2, KEY3]>;
-    keysArray(): [KEY1, KEY2, KEY3][];
     values(): IterableIterator<VALUE>;
-    valuesArray(): VALUE[];
     entries(): IterableIterator<[KEY1, KEY2, KEY3, VALUE]>;
+    keysArray(): [KEY1, KEY2, KEY3][];
+    valuesArray(): VALUE[];
     entriesArray(): [KEY1, KEY2, KEY3, VALUE][];
+    kvKeys(): IterableIterator<[KEY1, KEY2, KEY3]>;
+    kvValues(): IterableIterator<VALUE>;
+    kvEntries(): IterableIterator<[[KEY1, KEY2, KEY3], VALUE]>;
     [Symbol.iterator](): Generator<[KEY1, KEY2, KEY3, VALUE], void, any>;
     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;
@@ -659,11 +683,17 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> implements KVComponent<[KEY1, KEY2,
 declare class MultiContainer<K extends any[], V> {
     private readonly base;
     constructor(base: KVComponent<K, V[]>);
+    isEmpty(): boolean;
+    clear(): void;
     add(...keysAndValue: [...K, V]): V;
     remove(...keysAndValue: [...K, V]): boolean;
     getAll(...keys: K): V[];
     iterAll(...keys: K): IterableIterator<V>;
-    clear(): void;
+    values(): IterableIterator<V>;
+    keys(): IterableIterator<K>;
+    entries(): IterableIterator<[K, V[]]>;
+    [Symbol.iterator](): IterableIterator<[K, V[]]>;
+    toString(): string;
 }
 /**
  * ```ts

package/dist/index.js

@@ -1,4 +1,4 @@
-/* TsUtilsLib v1.15.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
+/* TsUtilsLib v1.16.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -1321,11 +1321,14 @@ var IndexArray = class _IndexArray {
     if (!isIntegerGte(id, 0)) throw new Error(`Invalid index ${id} - must be an integer >= 0!`);
     return id;
   }
+  get posLen() {
+    return this.hasPos.length;
+  }
   get size() {
     return this.elCount;
   }
-  get posLen() {
-    return this.hasPos.length;
+  isEmpty() {
+    return this.size === 0;
   }
   has(id) {
     _IndexArray.validateIndex(id);
@@ -1375,25 +1378,40 @@ var IndexArray = class _IndexArray {
       if (this.hasPos[id]) yield id;
     }
   }
-  indicesArray() {
-    return [...this.indices()];
-  }
   *values() {
     for (let id = 0; id < this.posLen; id++) {
       if (this.hasPos[id]) yield this.posEl[id];
     }
   }
-  valuesArray() {
-    return [...this.values()];
-  }
   *entries() {
     for (let id = 0; id < this.posLen; id++) {
       if (this.hasPos[id]) yield [id, this.posEl[id]];
     }
   }
+  indicesArray() {
+    return [...this.indices()];
+  }
+  valuesArray() {
+    return [...this.values()];
+  }
   entriesArray() {
     return [...this.entries()];
   }
+  *kvKeys() {
+    for (const id of this.indices()) {
+      yield [id];
+    }
+  }
+  *kvValues() {
+    for (const el of this.values()) {
+      yield el;
+    }
+  }
+  *kvEntries() {
+    for (const [id, el] of this.entries()) {
+      yield [[id], el];
+    }
+  }
   *[Symbol.iterator]() {
     yield* this.entries();
   }
@@ -1526,6 +1544,9 @@ var SignedIndexArray = class _SignedIndexArray {
   get size() {
     return this.elCount;
   }
+  isEmpty() {
+    return this.size === 0;
+  }
   get posLen() {
     return this.hasPos.length;
   }
@@ -1605,9 +1626,6 @@ var SignedIndexArray = class _SignedIndexArray {
       if (this.hasPos[id]) yield id;
     }
   }
-  indicesArray() {
-    return [...this.indices()];
-  }
   *values() {
     for (let id = this.negLen - 1; id >= 0; id--) {
       if (this.hasNeg[id]) yield this.negEl[id];
@@ -1616,9 +1634,6 @@ var SignedIndexArray = class _SignedIndexArray {
       if (this.hasPos[id]) yield this.posEl[id];
     }
   }
-  valuesArray() {
-    return [...this.values()];
-  }
   *entries() {
     for (let id = this.negLen - 1; id >= 0; id--) {
       if (this.hasNeg[id]) yield [_SignedIndexArray.toNegIndex(id), this.negEl[id]];
@@ -1627,9 +1642,30 @@ var SignedIndexArray = class _SignedIndexArray {
       if (this.hasPos[id]) yield [id, this.posEl[id]];
     }
   }
+  indicesArray() {
+    return [...this.indices()];
+  }
+  valuesArray() {
+    return [...this.values()];
+  }
   entriesArray() {
     return [...this.entries()];
   }
+  *kvKeys() {
+    for (const id of this.indices()) {
+      yield [id];
+    }
+  }
+  *kvValues() {
+    for (const el of this.values()) {
+      yield el;
+    }
+  }
+  *kvEntries() {
+    for (const [id, el] of this.entries()) {
+      yield [[id], el];
+    }
+  }
   *[Symbol.iterator]() {
     yield* this.entries();
   }
@@ -1765,28 +1801,46 @@ var Map1 = class _Map1 {
   get size() {
     return this.map1.size;
   }
+  isEmpty() {
+    return this.size === 0;
+  }
   forEach(callbackfn, thisArg) {
     this.map1.forEach((value, key1) => callbackfn.call(thisArg, value, key1, this));
   }
-  keys() {
-    return this.map1.keys();
+  *keys() {
+    yield* this.map1.keys();
+  }
+  *values() {
+    yield* this.map1.values();
+  }
+  *entries() {
+    for (const [key1, value] of this.map1)
+      yield [key1, value];
   }
   keysArray() {
     return [...this.keys()];
   }
-  values() {
-    return this.map1.values();
-  }
   valuesArray() {
     return [...this.values()];
   }
-  *entries() {
-    for (const [key1, value] of this.map1)
-      yield [key1, value];
-  }
   entriesArray() {
     return [...this.entries()];
   }
+  *kvKeys() {
+    for (const key of this.keys()) {
+      yield [key];
+    }
+  }
+  *kvValues() {
+    for (const el of this.values()) {
+      yield el;
+    }
+  }
+  *kvEntries() {
+    for (const [key, el] of this.entries()) {
+      yield [[key], el];
+    }
+  }
   *[Symbol.iterator]() {
     yield* this.entries();
   }
@@ -1902,39 +1956,48 @@ var Map2 = class _Map2 {
     }
     return count;
   }
+  isEmpty() {
+    return this.size === 0;
+  }
   forEach(callbackfn, thisArg) {
     this.map1.forEach((map2, key1) => map2.forEach((value, key2) => callbackfn.call(thisArg, value, key1, key2, this)));
   }
-  keys() {
-    function* gen(map1) {
-      for (const [key1, map2] of map1)
-        for (const key2 of map2.keys())
-          yield [key1, key2];
-    }
-    return gen(this.map1);
-  }
-  keysArray() {
-    return [...this.keys()];
-  }
-  values() {
-    function* gen(map1) {
-      for (const map2 of map1.values())
-        for (const value of map2.values())
-          yield value;
-    }
-    return gen(this.map1);
+  *keys() {
+    for (const [key1, map2] of this.map1)
+      for (const key2 of map2.keys())
+        yield [key1, key2];
   }
-  valuesArray() {
-    return [...this.values()];
+  *values() {
+    for (const map2 of this.map1.values())
+      for (const value of map2.values())
+        yield value;
   }
   *entries() {
     for (const [key1, map2] of this.map1)
       for (const [key2, value] of map2)
         yield [key1, key2, value];
   }
+  keysArray() {
+    return [...this.keys()];
+  }
+  valuesArray() {
+    return [...this.values()];
+  }
   entriesArray() {
     return [...this.entries()];
   }
+  *kvKeys() {
+    for (const [key1, key2] of this.keys())
+      yield [key1, key2];
+  }
+  *kvValues() {
+    for (const el of this.values())
+      yield el;
+  }
+  *kvEntries() {
+    for (const [key1, key2, el] of this.entries())
+      yield [[key1, key2], el];
+  }
   *[Symbol.iterator]() {
     yield* this.entries();
   }
@@ -2088,32 +2151,23 @@ var Map3 = class _Map3 {
     }
     return count;
   }
+  isEmpty() {
+    return this.size === 0;
+  }
   forEach(callbackfn, thisArg) {
     this.map1.forEach((map2, key1) => map2.forEach((map3, key2) => map3.forEach((value, key3) => callbackfn.call(thisArg, value, key1, key2, key3, this))));
   }
-  keys() {
-    function* gen(map1) {
-      for (const [key1, map2] of map1)
-        for (const [key2, map3] of map2)
-          for (const key3 of map3.keys())
-            yield [key1, key2, key3];
-    }
-    return gen(this.map1);
-  }
-  keysArray() {
-    return [...this.keys()];
-  }
-  values() {
-    function* gen(map1) {
-      for (const map2 of map1.values())
-        for (const map3 of map2.values())
-          for (const value of map3.values())
-            yield value;
-    }
-    return gen(this.map1);
+  *keys() {
+    for (const [key1, map2] of this.map1)
+      for (const [key2, map3] of map2)
+        for (const key3 of map3.keys())
+          yield [key1, key2, key3];
   }
-  valuesArray() {
-    return [...this.values()];
+  *values() {
+    for (const map2 of this.map1.values())
+      for (const map3 of map2.values())
+        for (const value of map3.values())
+          yield value;
   }
   *entries() {
     for (const [key1, map2] of this.map1)
@@ -2121,9 +2175,27 @@ var Map3 = class _Map3 {
         for (const [key3, value] of map3)
           yield [key1, key2, key3, value];
   }
+  keysArray() {
+    return [...this.keys()];
+  }
+  valuesArray() {
+    return [...this.values()];
+  }
   entriesArray() {
     return [...this.entries()];
   }
+  *kvKeys() {
+    for (const [key1, key2, key3] of this.keys())
+      yield [key1, key2, key3];
+  }
+  *kvValues() {
+    for (const el of this.values())
+      yield el;
+  }
+  *kvEntries() {
+    for (const [key1, key2, key3, el] of this.entries())
+      yield [[key1, key2, key3], el];
+  }
   *[Symbol.iterator]() {
     yield* this.entries();
   }
@@ -2232,6 +2304,12 @@ var MultiContainer = class {
   constructor(base) {
     this.base = base;
   }
+  isEmpty() {
+    return this.base.isEmpty();
+  }
+  clear() {
+    this.base.clear?.();
+  }
   add(...keysAndValue) {
     const keys = keysAndValue.slice(0, -1);
     const value = keysAndValue[keysAndValue.length - 1];
@@ -2254,13 +2332,36 @@ var MultiContainer = class {
     return this.base.get(...keys) ?? [];
   }
   *iterAll(...keys) {
-    const arr = this.getAll(...keys);
-    for (const v of arr) {
-      yield v;
+    yield* this.getAll(...keys);
+  }
+  *values() {
+    for (const keys of this.keys()) {
+      yield* this.getAll(...keys);
     }
   }
-  clear() {
-    this.base.clear?.();
+  *keys() {
+    for (const keys of this.base.kvKeys()) {
+      yield keys;
+    }
+  }
+  *entries() {
+    for (const keys of this.keys()) {
+      const arr = this.getAll(...keys);
+      if (arr.length > 0) yield [keys, arr];
+    }
+  }
+  [Symbol.iterator]() {
+    return this.entries();
+  }
+  toString() {
+    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(", ")}]` : "[]";
+      entries.push(`${keyStr} => ${valuesStr}`);
+    }
+    return `MultiContainer{ ${entries.join(", ")} }`;
   }
 };
 function asMulti(base) {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-/* TsUtilsLib v1.15.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
+/* TsUtilsLib v1.16.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) => {
@@ -1287,11 +1287,14 @@ var IndexArray = class _IndexArray {
     if (!isIntegerGte(id, 0)) throw new Error(`Invalid index ${id} - must be an integer >= 0!`);
     return id;
   }
+  get posLen() {
+    return this.hasPos.length;
+  }
   get size() {
     return this.elCount;
   }
-  get posLen() {
-    return this.hasPos.length;
+  isEmpty() {
+    return this.size === 0;
   }
   has(id) {
     _IndexArray.validateIndex(id);
@@ -1341,25 +1344,40 @@ var IndexArray = class _IndexArray {
       if (this.hasPos[id]) yield id;
     }
   }
-  indicesArray() {
-    return [...this.indices()];
-  }
   *values() {
     for (let id = 0; id < this.posLen; id++) {
       if (this.hasPos[id]) yield this.posEl[id];
     }
   }
-  valuesArray() {
-    return [...this.values()];
-  }
   *entries() {
     for (let id = 0; id < this.posLen; id++) {
       if (this.hasPos[id]) yield [id, this.posEl[id]];
     }
   }
+  indicesArray() {
+    return [...this.indices()];
+  }
+  valuesArray() {
+    return [...this.values()];
+  }
   entriesArray() {
     return [...this.entries()];
   }
+  *kvKeys() {
+    for (const id of this.indices()) {
+      yield [id];
+    }
+  }
+  *kvValues() {
+    for (const el of this.values()) {
+      yield el;
+    }
+  }
+  *kvEntries() {
+    for (const [id, el] of this.entries()) {
+      yield [[id], el];
+    }
+  }
   *[Symbol.iterator]() {
     yield* this.entries();
   }
@@ -1492,6 +1510,9 @@ var SignedIndexArray = class _SignedIndexArray {
   get size() {
     return this.elCount;
   }
+  isEmpty() {
+    return this.size === 0;
+  }
   get posLen() {
     return this.hasPos.length;
   }
@@ -1571,9 +1592,6 @@ var SignedIndexArray = class _SignedIndexArray {
       if (this.hasPos[id]) yield id;
     }
   }
-  indicesArray() {
-    return [...this.indices()];
-  }
   *values() {
     for (let id = this.negLen - 1; id >= 0; id--) {
       if (this.hasNeg[id]) yield this.negEl[id];
@@ -1582,9 +1600,6 @@ var SignedIndexArray = class _SignedIndexArray {
       if (this.hasPos[id]) yield this.posEl[id];
     }
   }
-  valuesArray() {
-    return [...this.values()];
-  }
   *entries() {
     for (let id = this.negLen - 1; id >= 0; id--) {
       if (this.hasNeg[id]) yield [_SignedIndexArray.toNegIndex(id), this.negEl[id]];
@@ -1593,9 +1608,30 @@ var SignedIndexArray = class _SignedIndexArray {
       if (this.hasPos[id]) yield [id, this.posEl[id]];
     }
   }
+  indicesArray() {
+    return [...this.indices()];
+  }
+  valuesArray() {
+    return [...this.values()];
+  }
   entriesArray() {
     return [...this.entries()];
   }
+  *kvKeys() {
+    for (const id of this.indices()) {
+      yield [id];
+    }
+  }
+  *kvValues() {
+    for (const el of this.values()) {
+      yield el;
+    }
+  }
+  *kvEntries() {
+    for (const [id, el] of this.entries()) {
+      yield [[id], el];
+    }
+  }
   *[Symbol.iterator]() {
     yield* this.entries();
   }
@@ -1731,28 +1767,46 @@ var Map1 = class _Map1 {
   get size() {
     return this.map1.size;
   }
+  isEmpty() {
+    return this.size === 0;
+  }
   forEach(callbackfn, thisArg) {
     this.map1.forEach((value, key1) => callbackfn.call(thisArg, value, key1, this));
   }
-  keys() {
-    return this.map1.keys();
+  *keys() {
+    yield* this.map1.keys();
+  }
+  *values() {
+    yield* this.map1.values();
+  }
+  *entries() {
+    for (const [key1, value] of this.map1)
+      yield [key1, value];
   }
   keysArray() {
     return [...this.keys()];
   }
-  values() {
-    return this.map1.values();
-  }
   valuesArray() {
     return [...this.values()];
   }
-  *entries() {
-    for (const [key1, value] of this.map1)
-      yield [key1, value];
-  }
   entriesArray() {
     return [...this.entries()];
   }
+  *kvKeys() {
+    for (const key of this.keys()) {
+      yield [key];
+    }
+  }
+  *kvValues() {
+    for (const el of this.values()) {
+      yield el;
+    }
+  }
+  *kvEntries() {
+    for (const [key, el] of this.entries()) {
+      yield [[key], el];
+    }
+  }
   *[Symbol.iterator]() {
     yield* this.entries();
   }
@@ -1868,39 +1922,48 @@ var Map2 = class _Map2 {
     }
     return count;
   }
+  isEmpty() {
+    return this.size === 0;
+  }
   forEach(callbackfn, thisArg) {
     this.map1.forEach((map2, key1) => map2.forEach((value, key2) => callbackfn.call(thisArg, value, key1, key2, this)));
   }
-  keys() {
-    function* gen(map1) {
-      for (const [key1, map2] of map1)
-        for (const key2 of map2.keys())
-          yield [key1, key2];
-    }
-    return gen(this.map1);
-  }
-  keysArray() {
-    return [...this.keys()];
-  }
-  values() {
-    function* gen(map1) {
-      for (const map2 of map1.values())
-        for (const value of map2.values())
-          yield value;
-    }
-    return gen(this.map1);
+  *keys() {
+    for (const [key1, map2] of this.map1)
+      for (const key2 of map2.keys())
+        yield [key1, key2];
   }
-  valuesArray() {
-    return [...this.values()];
+  *values() {
+    for (const map2 of this.map1.values())
+      for (const value of map2.values())
+        yield value;
   }
   *entries() {
     for (const [key1, map2] of this.map1)
       for (const [key2, value] of map2)
         yield [key1, key2, value];
   }
+  keysArray() {
+    return [...this.keys()];
+  }
+  valuesArray() {
+    return [...this.values()];
+  }
   entriesArray() {
     return [...this.entries()];
   }
+  *kvKeys() {
+    for (const [key1, key2] of this.keys())
+      yield [key1, key2];
+  }
+  *kvValues() {
+    for (const el of this.values())
+      yield el;
+  }
+  *kvEntries() {
+    for (const [key1, key2, el] of this.entries())
+      yield [[key1, key2], el];
+  }
   *[Symbol.iterator]() {
     yield* this.entries();
   }
@@ -2054,32 +2117,23 @@ var Map3 = class _Map3 {
     }
     return count;
   }
+  isEmpty() {
+    return this.size === 0;
+  }
   forEach(callbackfn, thisArg) {
     this.map1.forEach((map2, key1) => map2.forEach((map3, key2) => map3.forEach((value, key3) => callbackfn.call(thisArg, value, key1, key2, key3, this))));
   }
-  keys() {
-    function* gen(map1) {
-      for (const [key1, map2] of map1)
-        for (const [key2, map3] of map2)
-          for (const key3 of map3.keys())
-            yield [key1, key2, key3];
-    }
-    return gen(this.map1);
-  }
-  keysArray() {
-    return [...this.keys()];
-  }
-  values() {
-    function* gen(map1) {
-      for (const map2 of map1.values())
-        for (const map3 of map2.values())
-          for (const value of map3.values())
-            yield value;
-    }
-    return gen(this.map1);
+  *keys() {
+    for (const [key1, map2] of this.map1)
+      for (const [key2, map3] of map2)
+        for (const key3 of map3.keys())
+          yield [key1, key2, key3];
   }
-  valuesArray() {
-    return [...this.values()];
+  *values() {
+    for (const map2 of this.map1.values())
+      for (const map3 of map2.values())
+        for (const value of map3.values())
+          yield value;
   }
   *entries() {
     for (const [key1, map2] of this.map1)
@@ -2087,9 +2141,27 @@ var Map3 = class _Map3 {
         for (const [key3, value] of map3)
           yield [key1, key2, key3, value];
   }
+  keysArray() {
+    return [...this.keys()];
+  }
+  valuesArray() {
+    return [...this.values()];
+  }
   entriesArray() {
     return [...this.entries()];
   }
+  *kvKeys() {
+    for (const [key1, key2, key3] of this.keys())
+      yield [key1, key2, key3];
+  }
+  *kvValues() {
+    for (const el of this.values())
+      yield el;
+  }
+  *kvEntries() {
+    for (const [key1, key2, key3, el] of this.entries())
+      yield [[key1, key2, key3], el];
+  }
   *[Symbol.iterator]() {
     yield* this.entries();
   }
@@ -2198,6 +2270,12 @@ var MultiContainer = class {
   constructor(base) {
     this.base = base;
   }
+  isEmpty() {
+    return this.base.isEmpty();
+  }
+  clear() {
+    this.base.clear?.();
+  }
   add(...keysAndValue) {
     const keys = keysAndValue.slice(0, -1);
     const value = keysAndValue[keysAndValue.length - 1];
@@ -2220,13 +2298,36 @@ var MultiContainer = class {
     return this.base.get(...keys) ?? [];
   }
   *iterAll(...keys) {
-    const arr = this.getAll(...keys);
-    for (const v of arr) {
-      yield v;
+    yield* this.getAll(...keys);
+  }
+  *values() {
+    for (const keys of this.keys()) {
+      yield* this.getAll(...keys);
     }
   }
-  clear() {
-    this.base.clear?.();
+  *keys() {
+    for (const keys of this.base.kvKeys()) {
+      yield keys;
+    }
+  }
+  *entries() {
+    for (const keys of this.keys()) {
+      const arr = this.getAll(...keys);
+      if (arr.length > 0) yield [keys, arr];
+    }
+  }
+  [Symbol.iterator]() {
+    return this.entries();
+  }
+  toString() {
+    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(", ")}]` : "[]";
+      entries.push(`${keyStr} => ${valuesStr}`);
+    }
+    return `MultiContainer{ ${entries.join(", ")} }`;
   }
 };
 function asMulti(base) {

package/package.json

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