@tspro/ts-utils-lib 1.13.0 → 1.14.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [1.14.0] - 2025-10-19
+### Added
+- Map1, Map2 and Map3.getOrCreate() accepts value and creator.
+- SignedIndexArray<ELEM>
+
+## Fixed
+- Map1, Map2 and Map3.getOrCreate()
+
 ## [1.13.0] - 2025-10-18
 ### Added
 - Added even more functionality to Map1, Map2 and Map3.

package/dist/index.d.mts

@@ -446,6 +446,48 @@ declare class SmallIntCache<V> {
     clear(): void;
 }
 
+/**
+ * An array-like structure for signed indexes, including negatives.
+ */
+declare class SignedIndexArray<EL> {
+    private posEl;
+    private hasPos;
+    private negEl;
+    private hasNeg;
+    private elCount;
+    private static toNegIndex;
+    constructor();
+    constructor(arr: SignedIndexArray<EL>);
+    constructor(entries: Iterable<[number, EL]>);
+    get size(): number;
+    has(id: number): boolean;
+    set(id: number, el: EL): void;
+    get(id: number): EL | undefined;
+    getOrDefault(id: number, defaultValue: EL): EL;
+    getOrCreate(id: number, value: EL): EL;
+    getOrCreate(id: number, creator: () => EL): EL;
+    delete(id: number): boolean;
+    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]>;
+    entriesArray(): [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;
+    some(fn: (el: EL, id: number) => boolean): boolean;
+    every(fn: (value: EL, key1: number) => boolean): boolean;
+    filter(fn: (value: EL, key1: number) => boolean): SignedIndexArray<EL>;
+    reduce(fn: (acc: EL, el: EL, id: number) => EL): EL;
+    reduce<R>(fn: (acc: R, el: EL, id: number) => R, init: R): R;
+    mapToArray<R>(fn: (value: EL, key1: number) => R): R[];
+    map<R = EL>(fn: (value: EL, key1: number) => R): SignedIndexArray<R>;
+    toString(): string;
+}
+
 declare class Map1<KEY1, VALUE> {
     private map1;
     constructor();
@@ -455,6 +497,7 @@ declare class Map1<KEY1, VALUE> {
     set(key1: KEY1, value: VALUE): VALUE;
     get(key1: KEY1): VALUE | undefined;
     getOrDefault(key1: KEY1, defaultValue: VALUE): VALUE;
+    getOrCreate(key1: KEY1, value: VALUE): VALUE;
     getOrCreate(key1: KEY1, creator: () => VALUE): VALUE;
     delete(key1: KEY1): boolean;
     clear(): void;
@@ -487,6 +530,7 @@ declare class Map2<KEY1, KEY2, VALUE> {
     set(key1: KEY1, key2: KEY2, value: VALUE): VALUE;
     get(key1: KEY1, key2: KEY2): VALUE | undefined;
     getOrDefault(key1: KEY1, key2: KEY2, defaultValue: VALUE): VALUE;
+    getOrCreate(key1: KEY1, key2: KEY2, value: VALUE): VALUE;
     getOrCreate(key1: KEY1, key2: KEY2, creator: () => VALUE): VALUE;
     delete(key1: KEY1): boolean;
     delete(key1: KEY1, key2: KEY2): boolean;
@@ -520,6 +564,7 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> {
     set(key1: KEY1, key2: KEY2, key3: KEY3, value: VALUE): VALUE;
     get(key1: KEY1, key2: KEY2, key3: KEY3): VALUE | undefined;
     getOrDefault(key1: KEY1, key2: KEY2, key3: KEY3, defaultValue: VALUE): VALUE;
+    getOrCreate(key1: KEY1, key2: KEY2, key3: KEY3, value: VALUE): VALUE;
     getOrCreate(key1: KEY1, key2: KEY2, key3: KEY3, creator: () => VALUE): VALUE;
     delete(key1: KEY1): boolean;
     delete(key1: KEY1, key2: KEY2): boolean;
@@ -546,4 +591,4 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> {
     toString(): string;
 }
 
-export { Assert, Cookies, Device, LRUCache, Map1, Map2, Map3, SmallIntCache, Stack, index as Utils, Vec2 };
+export { Assert, Cookies, Device, LRUCache, Map1, Map2, Map3, SignedIndexArray, SmallIntCache, Stack, index as Utils, Vec2 };

package/dist/index.d.ts

@@ -446,6 +446,48 @@ declare class SmallIntCache<V> {
     clear(): void;
 }
 
+/**
+ * An array-like structure for signed indexes, including negatives.
+ */
+declare class SignedIndexArray<EL> {
+    private posEl;
+    private hasPos;
+    private negEl;
+    private hasNeg;
+    private elCount;
+    private static toNegIndex;
+    constructor();
+    constructor(arr: SignedIndexArray<EL>);
+    constructor(entries: Iterable<[number, EL]>);
+    get size(): number;
+    has(id: number): boolean;
+    set(id: number, el: EL): void;
+    get(id: number): EL | undefined;
+    getOrDefault(id: number, defaultValue: EL): EL;
+    getOrCreate(id: number, value: EL): EL;
+    getOrCreate(id: number, creator: () => EL): EL;
+    delete(id: number): boolean;
+    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]>;
+    entriesArray(): [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;
+    some(fn: (el: EL, id: number) => boolean): boolean;
+    every(fn: (value: EL, key1: number) => boolean): boolean;
+    filter(fn: (value: EL, key1: number) => boolean): SignedIndexArray<EL>;
+    reduce(fn: (acc: EL, el: EL, id: number) => EL): EL;
+    reduce<R>(fn: (acc: R, el: EL, id: number) => R, init: R): R;
+    mapToArray<R>(fn: (value: EL, key1: number) => R): R[];
+    map<R = EL>(fn: (value: EL, key1: number) => R): SignedIndexArray<R>;
+    toString(): string;
+}
+
 declare class Map1<KEY1, VALUE> {
     private map1;
     constructor();
@@ -455,6 +497,7 @@ declare class Map1<KEY1, VALUE> {
     set(key1: KEY1, value: VALUE): VALUE;
     get(key1: KEY1): VALUE | undefined;
     getOrDefault(key1: KEY1, defaultValue: VALUE): VALUE;
+    getOrCreate(key1: KEY1, value: VALUE): VALUE;
     getOrCreate(key1: KEY1, creator: () => VALUE): VALUE;
     delete(key1: KEY1): boolean;
     clear(): void;
@@ -487,6 +530,7 @@ declare class Map2<KEY1, KEY2, VALUE> {
     set(key1: KEY1, key2: KEY2, value: VALUE): VALUE;
     get(key1: KEY1, key2: KEY2): VALUE | undefined;
     getOrDefault(key1: KEY1, key2: KEY2, defaultValue: VALUE): VALUE;
+    getOrCreate(key1: KEY1, key2: KEY2, value: VALUE): VALUE;
     getOrCreate(key1: KEY1, key2: KEY2, creator: () => VALUE): VALUE;
     delete(key1: KEY1): boolean;
     delete(key1: KEY1, key2: KEY2): boolean;
@@ -520,6 +564,7 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> {
     set(key1: KEY1, key2: KEY2, key3: KEY3, value: VALUE): VALUE;
     get(key1: KEY1, key2: KEY2, key3: KEY3): VALUE | undefined;
     getOrDefault(key1: KEY1, key2: KEY2, key3: KEY3, defaultValue: VALUE): VALUE;
+    getOrCreate(key1: KEY1, key2: KEY2, key3: KEY3, value: VALUE): VALUE;
     getOrCreate(key1: KEY1, key2: KEY2, key3: KEY3, creator: () => VALUE): VALUE;
     delete(key1: KEY1): boolean;
     delete(key1: KEY1, key2: KEY2): boolean;
@@ -546,4 +591,4 @@ declare class Map3<KEY1, KEY2, KEY3, VALUE> {
     toString(): string;
 }
 
-export { Assert, Cookies, Device, LRUCache, Map1, Map2, Map3, SmallIntCache, Stack, index as Utils, Vec2 };
+export { Assert, Cookies, Device, LRUCache, Map1, Map2, Map3, SignedIndexArray, SmallIntCache, Stack, index as Utils, Vec2 };

package/dist/index.js

@@ -1,4 +1,4 @@
-/* TsUtilsLib v1.13.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
+/* TsUtilsLib v1.14.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -30,6 +30,7 @@ __export(index_exports, {
   Map1: () => Map1,
   Map2: () => Map2,
   Map3: () => Map3,
+  SignedIndexArray: () => SignedIndexArray,
   SmallIntCache: () => SmallIntCache,
   Stack: () => Stack,
   Utils: () => utils_exports,
@@ -1292,6 +1293,226 @@ var SmallIntCache = class {
   }
 };
 
+// src/core/signed-index-array.ts
+var SignedIndexArray = class _SignedIndexArray {
+  constructor(entries) {
+    // for indexes >= 0
+    __publicField(this, "posEl");
+    __publicField(this, "hasPos");
+    // for indexes < 0
+    __publicField(this, "negEl");
+    __publicField(this, "hasNeg");
+    // number of elems
+    __publicField(this, "elCount");
+    if (entries instanceof _SignedIndexArray) {
+      this.negEl = entries.negEl.slice();
+      this.hasNeg = entries.hasNeg.slice();
+      this.posEl = entries.posEl.slice();
+      this.hasPos = entries.hasPos.slice();
+      this.elCount = entries.elCount;
+    } else {
+      this.negEl = [];
+      this.hasNeg = [];
+      this.posEl = [];
+      this.hasPos = [];
+      this.elCount = 0;
+      if (entries) {
+        for (const [id, el] of entries) {
+          this.set(id, el);
+        }
+      }
+    }
+  }
+  static toNegIndex(id) {
+    return -id - 1;
+  }
+  get size() {
+    return this.elCount;
+  }
+  has(id) {
+    if (!isInteger(id)) {
+      return false;
+    } else if (id >= 0) {
+      return this.hasPos[id] === true;
+    } else {
+      return this.hasNeg[_SignedIndexArray.toNegIndex(id)] === true;
+    }
+  }
+  set(id, el) {
+    if (!isInteger(id)) {
+      throw new Error("Index must be an integer");
+    } else if (id >= 0) {
+      if (this.hasPos[id] !== true) this.elCount++;
+      this.posEl[id] = el;
+      this.hasPos[id] = true;
+    } else {
+      if (this.hasNeg[_SignedIndexArray.toNegIndex(id)] !== true) this.elCount++;
+      this.negEl[_SignedIndexArray.toNegIndex(id)] = el;
+      this.hasNeg[_SignedIndexArray.toNegIndex(id)] = true;
+    }
+  }
+  get(id) {
+    if (!isInteger(id)) {
+      throw new Error("Index must be an integer");
+    } else if (id >= 0) {
+      return this.hasPos[id] ? this.posEl[id] : void 0;
+    } else {
+      return this.hasNeg[_SignedIndexArray.toNegIndex(id)] ? this.negEl[_SignedIndexArray.toNegIndex(id)] : void 0;
+    }
+  }
+  getOrDefault(id, defaultValue) {
+    return this.get(id) ?? defaultValue;
+  }
+  getOrCreate(id, creatorOrValue) {
+    if (!this.has(id)) {
+      const value = isFunction(creatorOrValue) ? creatorOrValue() : creatorOrValue;
+      this.set(id, value);
+      return value;
+    }
+    return this.get(id);
+  }
+  delete(id) {
+    if (!isInteger(id)) return false;
+    const isPos = id >= 0;
+    const arr = isPos ? this.posEl : this.negEl;
+    const has = isPos ? this.hasPos : this.hasNeg;
+    const idx = isPos ? id : _SignedIndexArray.toNegIndex(id);
+    if (!has[idx]) return false;
+    arr[idx] = void 0;
+    has[idx] = false;
+    this.elCount--;
+    return true;
+  }
+  clear() {
+    this.negEl = [];
+    this.hasNeg = [];
+    this.posEl = [];
+    this.hasPos = [];
+    this.elCount = 0;
+  }
+  forEach(callbackfn, thisArg) {
+    for (const [id, el] of this.entries()) {
+      callbackfn.call(thisArg, el, id, this);
+    }
+  }
+  indices() {
+    function* gen(self) {
+      for (let id = self.negEl.length - 1; id >= 0; id--) {
+        if (self.hasNeg[id]) yield _SignedIndexArray.toNegIndex(id);
+      }
+      for (let id = 0; id < self.posEl.length; id++) {
+        if (self.hasPos[id]) yield id;
+      }
+    }
+    return gen(this);
+  }
+  indicesArray() {
+    return [...this.indices()];
+  }
+  values() {
+    function* gen(self) {
+      for (let id = self.negEl.length - 1; id >= 0; id--) {
+        if (self.hasNeg[id]) yield self.negEl[id];
+      }
+      for (let id = 0; id < self.posEl.length; id++) {
+        if (self.hasPos[id]) yield self.posEl[id];
+      }
+    }
+    return gen(this);
+  }
+  valuesArray() {
+    return [...this.values()];
+  }
+  *entries() {
+    for (let id = this.negEl.length - 1; id >= 0; id--) {
+      if (this.hasNeg[id]) yield [_SignedIndexArray.toNegIndex(id), this.negEl[id]];
+    }
+    for (let id = 0; id < this.posEl.length; id++) {
+      if (this.hasPos[id]) yield [id, this.posEl[id]];
+    }
+  }
+  entriesArray() {
+    return [...this.entries()];
+  }
+  *[Symbol.iterator]() {
+    yield* this.entries();
+  }
+  clone() {
+    return new _SignedIndexArray(this);
+  }
+  merge(other, conflictResolver) {
+    for (const [id, value] of other.entries()) {
+      if (this.has(id) && conflictResolver) {
+        this.set(id, conflictResolver(this.get(id), value, id));
+      } else {
+        this.set(id, value);
+      }
+    }
+    return this;
+  }
+  some(fn) {
+    for (const [id, el] of this.entries()) {
+      if (fn(el, id)) return true;
+    }
+    return false;
+  }
+  every(fn) {
+    for (const [id, el] of this.entries()) {
+      if (!fn(el, id)) return false;
+    }
+    return true;
+  }
+  filter(fn) {
+    let result = new _SignedIndexArray();
+    for (const [id, el] of this.entries()) {
+      if (fn(el, id)) result.set(id, el);
+    }
+    return result;
+  }
+  reduce(fn, init) {
+    let iterator = this.entries();
+    let first = iterator.next();
+    if (first.done) {
+      if (arguments.length < 2) {
+        throw new TypeError("Reduce of empty SignedIndexArray with no initial value!");
+      }
+      return init;
+    }
+    let acc;
+    let start;
+    if (arguments.length < 2) {
+      acc = first.value[1];
+      start = iterator.next();
+    } else {
+      acc = init;
+      start = first;
+    }
+    for (let current = start; !current.done; current = iterator.next()) {
+      const [id, el] = current.value;
+      acc = fn(acc, el, id);
+    }
+    return acc;
+  }
+  mapToArray(fn) {
+    let result = [];
+    for (const [id, el] of this.entries()) {
+      result.push(fn(el, id));
+    }
+    return result;
+  }
+  map(fn) {
+    let result = new _SignedIndexArray();
+    for (const [id, el] of this.entries()) {
+      result.set(id, fn(el, id));
+    }
+    return result;
+  }
+  toString() {
+    const entries = this.entriesArray().map(([id, el]) => `${id}: ${el}`).join(", ");
+    return `SignedIndexArray[ ${entries} ]`;
+  }
+};
+
 // src/core/map.ts
 var Map1 = class _Map1 {
   constructor(entries) {
@@ -1311,12 +1532,13 @@ var Map1 = class _Map1 {
   getOrDefault(key1, defaultValue) {
     return this.get(key1) ?? defaultValue;
   }
-  getOrCreate(key1, creator) {
-    let value = this.get(key1);
-    if (!value) {
-      this.set(key1, value = creator());
+  getOrCreate(key1, creatorOrValue) {
+    if (!this.has(key1)) {
+      const value = isFunction(creatorOrValue) ? creatorOrValue() : creatorOrValue;
+      this.set(key1, value);
+      return value;
     }
-    return value;
+    return this.get(key1);
   }
   delete(key1) {
     return this.map1.delete(key1);
@@ -1440,12 +1662,13 @@ var Map2 = class _Map2 {
   getOrDefault(key1, key2, defaultValue) {
     return this.get(key1, key2) ?? defaultValue;
   }
-  getOrCreate(key1, key2, creator) {
-    let value = this.get(key1, key2);
-    if (!value) {
-      this.set(key1, key2, value = creator());
+  getOrCreate(key1, key2, creatorOrValue) {
+    if (!this.has(key1, key2)) {
+      const value = isFunction(creatorOrValue) ? creatorOrValue() : creatorOrValue;
+      this.set(key1, key2, value);
+      return value;
     }
-    return value;
+    return this.get(key1, key2);
   }
   delete(key1, key2) {
     if (key2 === void 0) return this.map1.delete(key1);
@@ -1616,12 +1839,13 @@ var Map3 = class _Map3 {
   getOrDefault(key1, key2, key3, defaultValue) {
     return this.get(key1, key2, key3) ?? defaultValue;
   }
-  getOrCreate(key1, key2, key3, creator) {
-    let value = this.get(key1, key2, key3);
-    if (!value) {
-      this.set(key1, key2, key3, value = creator());
+  getOrCreate(key1, key2, key3, creatorOrValue) {
+    if (!this.has(key1, key2, key3)) {
+      const value = isFunction(creatorOrValue) ? creatorOrValue() : creatorOrValue;
+      this.set(key1, key2, key3, value);
+      return value;
     }
-    return value;
+    return this.get(key1, key2, key3);
   }
   delete(key1, key2, key3) {
     if (key3 === void 0) {
@@ -1795,6 +2019,7 @@ var Map3 = class _Map3 {
   Map1,
   Map2,
   Map3,
+  SignedIndexArray,
   SmallIntCache,
   Stack,
   Utils,

package/dist/index.mjs

@@ -1,4 +1,4 @@
-/* TsUtilsLib v1.13.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
+/* TsUtilsLib v1.14.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) => {
@@ -1262,6 +1262,226 @@ var SmallIntCache = class {
   }
 };
 
+// src/core/signed-index-array.ts
+var SignedIndexArray = class _SignedIndexArray {
+  constructor(entries) {
+    // for indexes >= 0
+    __publicField(this, "posEl");
+    __publicField(this, "hasPos");
+    // for indexes < 0
+    __publicField(this, "negEl");
+    __publicField(this, "hasNeg");
+    // number of elems
+    __publicField(this, "elCount");
+    if (entries instanceof _SignedIndexArray) {
+      this.negEl = entries.negEl.slice();
+      this.hasNeg = entries.hasNeg.slice();
+      this.posEl = entries.posEl.slice();
+      this.hasPos = entries.hasPos.slice();
+      this.elCount = entries.elCount;
+    } else {
+      this.negEl = [];
+      this.hasNeg = [];
+      this.posEl = [];
+      this.hasPos = [];
+      this.elCount = 0;
+      if (entries) {
+        for (const [id, el] of entries) {
+          this.set(id, el);
+        }
+      }
+    }
+  }
+  static toNegIndex(id) {
+    return -id - 1;
+  }
+  get size() {
+    return this.elCount;
+  }
+  has(id) {
+    if (!isInteger(id)) {
+      return false;
+    } else if (id >= 0) {
+      return this.hasPos[id] === true;
+    } else {
+      return this.hasNeg[_SignedIndexArray.toNegIndex(id)] === true;
+    }
+  }
+  set(id, el) {
+    if (!isInteger(id)) {
+      throw new Error("Index must be an integer");
+    } else if (id >= 0) {
+      if (this.hasPos[id] !== true) this.elCount++;
+      this.posEl[id] = el;
+      this.hasPos[id] = true;
+    } else {
+      if (this.hasNeg[_SignedIndexArray.toNegIndex(id)] !== true) this.elCount++;
+      this.negEl[_SignedIndexArray.toNegIndex(id)] = el;
+      this.hasNeg[_SignedIndexArray.toNegIndex(id)] = true;
+    }
+  }
+  get(id) {
+    if (!isInteger(id)) {
+      throw new Error("Index must be an integer");
+    } else if (id >= 0) {
+      return this.hasPos[id] ? this.posEl[id] : void 0;
+    } else {
+      return this.hasNeg[_SignedIndexArray.toNegIndex(id)] ? this.negEl[_SignedIndexArray.toNegIndex(id)] : void 0;
+    }
+  }
+  getOrDefault(id, defaultValue) {
+    return this.get(id) ?? defaultValue;
+  }
+  getOrCreate(id, creatorOrValue) {
+    if (!this.has(id)) {
+      const value = isFunction(creatorOrValue) ? creatorOrValue() : creatorOrValue;
+      this.set(id, value);
+      return value;
+    }
+    return this.get(id);
+  }
+  delete(id) {
+    if (!isInteger(id)) return false;
+    const isPos = id >= 0;
+    const arr = isPos ? this.posEl : this.negEl;
+    const has = isPos ? this.hasPos : this.hasNeg;
+    const idx = isPos ? id : _SignedIndexArray.toNegIndex(id);
+    if (!has[idx]) return false;
+    arr[idx] = void 0;
+    has[idx] = false;
+    this.elCount--;
+    return true;
+  }
+  clear() {
+    this.negEl = [];
+    this.hasNeg = [];
+    this.posEl = [];
+    this.hasPos = [];
+    this.elCount = 0;
+  }
+  forEach(callbackfn, thisArg) {
+    for (const [id, el] of this.entries()) {
+      callbackfn.call(thisArg, el, id, this);
+    }
+  }
+  indices() {
+    function* gen(self) {
+      for (let id = self.negEl.length - 1; id >= 0; id--) {
+        if (self.hasNeg[id]) yield _SignedIndexArray.toNegIndex(id);
+      }
+      for (let id = 0; id < self.posEl.length; id++) {
+        if (self.hasPos[id]) yield id;
+      }
+    }
+    return gen(this);
+  }
+  indicesArray() {
+    return [...this.indices()];
+  }
+  values() {
+    function* gen(self) {
+      for (let id = self.negEl.length - 1; id >= 0; id--) {
+        if (self.hasNeg[id]) yield self.negEl[id];
+      }
+      for (let id = 0; id < self.posEl.length; id++) {
+        if (self.hasPos[id]) yield self.posEl[id];
+      }
+    }
+    return gen(this);
+  }
+  valuesArray() {
+    return [...this.values()];
+  }
+  *entries() {
+    for (let id = this.negEl.length - 1; id >= 0; id--) {
+      if (this.hasNeg[id]) yield [_SignedIndexArray.toNegIndex(id), this.negEl[id]];
+    }
+    for (let id = 0; id < this.posEl.length; id++) {
+      if (this.hasPos[id]) yield [id, this.posEl[id]];
+    }
+  }
+  entriesArray() {
+    return [...this.entries()];
+  }
+  *[Symbol.iterator]() {
+    yield* this.entries();
+  }
+  clone() {
+    return new _SignedIndexArray(this);
+  }
+  merge(other, conflictResolver) {
+    for (const [id, value] of other.entries()) {
+      if (this.has(id) && conflictResolver) {
+        this.set(id, conflictResolver(this.get(id), value, id));
+      } else {
+        this.set(id, value);
+      }
+    }
+    return this;
+  }
+  some(fn) {
+    for (const [id, el] of this.entries()) {
+      if (fn(el, id)) return true;
+    }
+    return false;
+  }
+  every(fn) {
+    for (const [id, el] of this.entries()) {
+      if (!fn(el, id)) return false;
+    }
+    return true;
+  }
+  filter(fn) {
+    let result = new _SignedIndexArray();
+    for (const [id, el] of this.entries()) {
+      if (fn(el, id)) result.set(id, el);
+    }
+    return result;
+  }
+  reduce(fn, init) {
+    let iterator = this.entries();
+    let first = iterator.next();
+    if (first.done) {
+      if (arguments.length < 2) {
+        throw new TypeError("Reduce of empty SignedIndexArray with no initial value!");
+      }
+      return init;
+    }
+    let acc;
+    let start;
+    if (arguments.length < 2) {
+      acc = first.value[1];
+      start = iterator.next();
+    } else {
+      acc = init;
+      start = first;
+    }
+    for (let current = start; !current.done; current = iterator.next()) {
+      const [id, el] = current.value;
+      acc = fn(acc, el, id);
+    }
+    return acc;
+  }
+  mapToArray(fn) {
+    let result = [];
+    for (const [id, el] of this.entries()) {
+      result.push(fn(el, id));
+    }
+    return result;
+  }
+  map(fn) {
+    let result = new _SignedIndexArray();
+    for (const [id, el] of this.entries()) {
+      result.set(id, fn(el, id));
+    }
+    return result;
+  }
+  toString() {
+    const entries = this.entriesArray().map(([id, el]) => `${id}: ${el}`).join(", ");
+    return `SignedIndexArray[ ${entries} ]`;
+  }
+};
+
 // src/core/map.ts
 var Map1 = class _Map1 {
   constructor(entries) {
@@ -1281,12 +1501,13 @@ var Map1 = class _Map1 {
   getOrDefault(key1, defaultValue) {
     return this.get(key1) ?? defaultValue;
   }
-  getOrCreate(key1, creator) {
-    let value = this.get(key1);
-    if (!value) {
-      this.set(key1, value = creator());
+  getOrCreate(key1, creatorOrValue) {
+    if (!this.has(key1)) {
+      const value = isFunction(creatorOrValue) ? creatorOrValue() : creatorOrValue;
+      this.set(key1, value);
+      return value;
     }
-    return value;
+    return this.get(key1);
   }
   delete(key1) {
     return this.map1.delete(key1);
@@ -1410,12 +1631,13 @@ var Map2 = class _Map2 {
   getOrDefault(key1, key2, defaultValue) {
     return this.get(key1, key2) ?? defaultValue;
   }
-  getOrCreate(key1, key2, creator) {
-    let value = this.get(key1, key2);
-    if (!value) {
-      this.set(key1, key2, value = creator());
+  getOrCreate(key1, key2, creatorOrValue) {
+    if (!this.has(key1, key2)) {
+      const value = isFunction(creatorOrValue) ? creatorOrValue() : creatorOrValue;
+      this.set(key1, key2, value);
+      return value;
     }
-    return value;
+    return this.get(key1, key2);
   }
   delete(key1, key2) {
     if (key2 === void 0) return this.map1.delete(key1);
@@ -1586,12 +1808,13 @@ var Map3 = class _Map3 {
   getOrDefault(key1, key2, key3, defaultValue) {
     return this.get(key1, key2, key3) ?? defaultValue;
   }
-  getOrCreate(key1, key2, key3, creator) {
-    let value = this.get(key1, key2, key3);
-    if (!value) {
-      this.set(key1, key2, key3, value = creator());
+  getOrCreate(key1, key2, key3, creatorOrValue) {
+    if (!this.has(key1, key2, key3)) {
+      const value = isFunction(creatorOrValue) ? creatorOrValue() : creatorOrValue;
+      this.set(key1, key2, key3, value);
+      return value;
     }
-    return value;
+    return this.get(key1, key2, key3);
   }
   delete(key1, key2, key3) {
     if (key3 === void 0) {
@@ -1764,6 +1987,7 @@ export {
   Map1,
   Map2,
   Map3,
+  SignedIndexArray,
   SmallIntCache,
   Stack,
   utils_exports as Utils,

package/package.json

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