@elyukai/utils 0.1.7 → 0.2.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 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.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.
      *

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.0",
   "description": "A set of JavaScript helper functions.",
   "files": [
     "dist",