@elyukai/utils 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 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.2](https://github.com/elyukai/ts-utils/compare/v0.2.1...v0.2.2) (2026-02-11)
+
+
+### Features
+
+* add FixedArray helper ([4a1b61a](https://github.com/elyukai/ts-utils/commit/4a1b61a51ad53c35767adf716d4a64ef10f4dc10))
+* add static groupBy method to dictionary ([2ee4802](https://github.com/elyukai/ts-utils/commit/2ee4802db8f1b821819f4ced5f79079153a6c11e))
+
+## [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)
 
 

package/dist/array/fixed.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A helper type that builds a tuple type of a desired length.
+ * @module
+ */
+/**
+ * A recursive type that constructs an array of type `T` with a length of `N`.
+ */
+type FixedArrayAux<T, N extends number, A extends T[]> = A["length"] extends N ? A : FixedArrayAux<T, N, [...A, T]>;
+/**
+ * A type representing an array of a fixed size `N` containing elements of type `T`.
+ */
+export type FixedArray<T, N extends number> = FixedArrayAux<T, N, []>;
+export {};

package/dist/array/fixed.js

@@ -0,0 +1,5 @@
+/**
+ * A helper type that builds a tuple type of a desired length.
+ * @module
+ */
+export {};

package/dist/dictionary.d.ts

@@ -21,6 +21,10 @@ export declare class Dictionary<T extends AnyNonNullish | null, K extends string
      * Constructs a dictionary from an array of key-value pairs.
      */
     static fromEntries<T extends AnyNonNullish | null, K extends string = string>(entries: [K, T][]): Dictionary<T, K>;
+    /**
+     * Groups the given items by the key returned by the given function and returns a dictionary mapping each key to an array of items with that key.
+     */
+    static groupBy<T, K extends string>(items: T[], keyFn: (item: T) => K): Dictionary<T[], K>;
     /**
      * Returns the value associated with the given key, or `undefined` if the key does not exist.
      */
@@ -89,7 +93,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.
      */
@@ -109,7 +113,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

@@ -25,6 +25,22 @@ export class Dictionary {
     static fromEntries(entries) {
         return new Dictionary(Object.fromEntries(entries));
     }
+    /**
+     * Groups the given items by the key returned by the given function and returns a dictionary mapping each key to an array of items with that key.
+     */
+    static groupBy(items, keyFn) {
+        const record = {};
+        for (const item of items) {
+            const key = keyFn(item);
+            if (record[key] === undefined) {
+                record[key] = [item];
+            }
+            else {
+                record[key].push(item);
+            }
+        }
+        return new Dictionary(record);
+    }
     /**
      * Returns the value associated with the given key, or `undefined` if the key does not exist.
      */

package/package.json

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