Merge pull request #60 from zuriscript:feature/minor-improvements

Support tuple types in Immutable<T> type definition

Author: zuriscript

packages/signalstory/src/lib/store-immutability/immutable-type.ts

@@ -1,4 +1,7 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/* eslint-disable @typescript-eslint/no-explicit-any */
 /* eslint-disable @typescript-eslint/ban-types */
+
 /**
  * Define a union type of built-in immutable primitives.
  */
@@ -14,24 +17,34 @@ type ImmutablePrimitive =
   | Date
   | RegExp;
 
+/**
+ * Checks if a given type is a tuple.
+ */
+type IsTuple<Type> = Type extends readonly any[]
+  ? any[] extends Type
+    ? never
+    : Type
+  : never;
+
+// Type wrappers for regular and readonly built-in container types
+type AnyArray<T = any> = Array<T> | ReadonlyArray<T>;
+type AnySet<T = any> = Set<T> | ReadonlySet<T>;
+type AnyMap<TKey = any, TVal = any> = Map<TKey, TVal> | ReadonlyMap<TKey, TVal>;
+
 /**
  * Recursively transforms a given type into its deep readonly equivalent.
  * This transformation makes sure that the resulting type and its nested properties are immutable.
  */
 export type Immutable<T> = T extends ImmutablePrimitive
   ? T // If the type is an immutable primitive, return it as is.
-  : T extends Map<infer Keys, infer Values>
+  : T extends AnyMap<infer Keys, infer Values>
     ? ReadonlyMap<Immutable<Keys>, Immutable<Values>>
-    : T extends ReadonlyMap<infer Keys, infer Values>
-      ? ReadonlyMap<Immutable<Keys>, Immutable<Values>>
-      : T extends Set<infer Values>
-        ? ReadonlySet<Immutable<Values>>
-        : T extends ReadonlySet<infer Values>
-          ? ReadonlySet<Immutable<Values>>
-          : T extends Array<infer Values>
-            ? ReadonlyArray<Immutable<Values>>
-            : T extends ReadonlyArray<infer Values>
-              ? ReadonlyArray<Immutable<Values>>
-              : T extends object
-                ? { readonly [Key in keyof T]: Immutable<T[Key]> } // Recursively transform object properties.
-                : Readonly<T>; // For other types, return them as Readonly to make them immutable.
+    : T extends AnySet<infer Values>
+      ? ReadonlySet<Immutable<Values>>
+      : T extends AnyArray<infer Values>
+        ? T extends IsTuple<T>
+          ? { readonly [Key in keyof T]: Immutable<T[Key]> }
+          : ReadonlyArray<Immutable<Values>>
+        : T extends object
+          ? { readonly [Key in keyof T]: Immutable<T[Key]> } // Recursively transform object properties.
+          : Readonly<T>; // For other types, return them as Readonly to make them immutable.

packages/signalstory/src/lib/store-immutability/immutable-utility.ts

@@ -19,10 +19,11 @@ export function naiveDeepClone<TState>(state: TState): TState {
  * @param {T} value - The value object to be cloned.
  * @returns {T} A deep clone of the provided value object.
  */
-export const deepClone = <TState>(state: TState) =>
-  window && 'structuredClone' in window
+export function deepClone<TState>(state: TState): TState {
+  return window && 'structuredClone' in window
     ? structuredClone(state)
     : naiveDeepClone(state);
+}
 
 /**
  * Creates a shallow clone of a given value object

packages/signalstory/src/lib/store-mediator.ts

@@ -25,7 +25,7 @@ export function createRegistry(): MediatorRegistry {
 /**
  * Root mediator registry instance.
  */
-export const rootRegistry: MediatorRegistry = createRegistry();
+export const rootRegistry: MediatorRegistry = /*@__PURE__*/ createRegistry();
 
 /**
  * Register an event handler for a specific event.