@elyukai/utils 0.1.7 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [0.2.1](https://github.com/elyukai/ts-utils/compare/v0.2.0...v0.2.1) (2026-02-07)
+
+
+### Bug Fixes
+
+* specific key type ([a8a7975](https://github.com/elyukai/ts-utils/commit/a8a79750d4323e44b17b9ba01152150de12b7792))
+
+## [0.2.0](https://github.com/elyukai/ts-utils/compare/v0.1.7...v0.2.0) (2026-02-05)
+
+
+### ⚠ BREAKING CHANGES
+
+* merge forEach and forEachAsync
+
+### Features
+
+* merge forEach and forEachAsync ([15b419f](https://github.com/elyukai/ts-utils/commit/15b419fa962218a74133ff7ee85ca817c1fc989c))
+
 ## [0.1.7](https://github.com/elyukai/ts-utils/compare/v0.1.6...v0.1.7) (2026-02-05)
 
 

package/dist/dictionary.d.ts

@@ -7,6 +7,7 @@ import type { AnyNonNullish } from "./nullable.js";
  * An immutable dictionary mapping strings to values.
  */
 export declare class Dictionary<T extends AnyNonNullish | null, K extends string = string> {
+    #private;
     private record;
     /**
      * Creates a new dictionary from an indexed object.
@@ -62,14 +63,11 @@ export declare class Dictionary<T extends AnyNonNullish | null, K extends string
     keys(): K[];
     /**
      * Calls the given function for each key-value pair in the dictionary.
-     */
-    forEach(fn: (value: T, key: K) => void): void;
-    /**
-     * Calls the given async function for each key-value pair in the dictionary.
      *
-     * The calls are made sequentially.
+     * If the `async` flag is used, the function calls the function with the values sequentially.
      */
-    forEachAsync(fn: (value: T, key: K) => Promise<void>): Promise<void>;
+    forEach(fn: (value: T, key: K) => Promise<void>, async: true): Promise<void>;
+    forEach(fn: (value: T, key: K) => void, async?: false): void;
     /**
      * Create, modify, or remove the value for the given key based on its current value.
      *
@@ -91,7 +89,7 @@ export declare class Dictionary<T extends AnyNonNullish | null, K extends string
     /**
      * Returns the first key that matches the given predicate, or `undefined` if no such key exists.
      */
-    findKey(predicate: (value: T, key: K) => boolean): string | undefined;
+    findKey(predicate: (value: T, key: K) => boolean): K | undefined;
     /**
      * Returns the first key-value pair that matches the given predicate, or `undefined` if no such key-value pair exists.
      */
@@ -111,7 +109,7 @@ export declare class Dictionary<T extends AnyNonNullish | null, K extends string
     /**
      * Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
      */
-    reduce<U>(reducer: (acc: U, value: T, key: string) => U, initialValue: U): U;
+    reduce<U>(reducer: (acc: U, value: T, key: K) => U, initialValue: U): U;
     /**
      * Converts the dictionary to a plain object.
      *

package/dist/dictionary.js

@@ -2,6 +2,7 @@
  * Introduces a Dictionary class that represents an immutable mapping from strings to values.
  * @module
  */
+import { Lazy } from "./lazy.js";
 import { omitKeys, omitUndefinedKeys } from "./object.js";
 /**
  * An immutable dictionary mapping strings to values.
@@ -64,11 +65,12 @@ export class Dictionary {
             return this;
         }
     }
+    #size = Lazy.of(() => this.keys().length);
     /**
      * The number of entries in the dictionary.
      */
     get size() {
-        return this.keys().length;
+        return this.#size.value;
     }
     /**
      * Returns an array of key-value pairs in the dictionary.
@@ -88,22 +90,19 @@ export class Dictionary {
     keys() {
         return Object.keys(this.record);
     }
-    /**
-     * Calls the given function for each key-value pair in the dictionary.
-     */
-    forEach(fn) {
-        for (const [key, value] of this.entries()) {
-            fn(value, key);
+    forEach(...args) {
+        const [fn, async] = args;
+        if (async === true) {
+            return (async () => {
+                for (const [key, value] of this.entries()) {
+                    await fn(value, key);
+                }
+            })();
         }
-    }
-    /**
-     * Calls the given async function for each key-value pair in the dictionary.
-     *
-     * The calls are made sequentially.
-     */
-    async forEachAsync(fn) {
-        for (const [key, value] of this.entries()) {
-            await fn(value, key);
+        else {
+            for (const [key, value] of this.entries()) {
+                fn(value, key);
+            }
         }
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elyukai/utils",
-  "version": "0.1.7",
+  "version": "0.2.1",
   "description": "A set of JavaScript helper functions.",
   "files": [
     "dist",