@elyukai/utils 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 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)
 
 

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.
      */

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