@kakasoo/deep-strict-types 2.0.2 → 2.0.4

package/README.md

@@ -1,20 +1,48 @@
-# How To Use
+# DeepStrictTypes Library Documentation
+
+- [한국어 설명](./docs/README_KO.md)
+
+## Table of Contents
+
+1. [Introduction](#introduction)
+2. [DeepStrictObjectKeys](#deepstrictobjectkeys)
+3. [DeepStrictOmit](#deepstrictomit)
+4. [DeepStrictPick](#deepstrictpick)
+5. [StringToDeepObject](#stringtodeepobject)
+6. [DeepStrictMerge](#deepstrictmerge)
+7. [DeepDateToString](#deepdatetostring)
+
+## Introduction
+
+DeepStrictTypes is a tool that takes TypeScript’s type manipulation to the next level.  
+It helps you safely perform tasks like `Omit` and `Pick` even with complex nested objects or arrays.  
+By addressing the limitations of TypeScript’s built-in utility types, it allows you to easily handle internal keys with strict and precise type inference.
+
+Key features include:
+
+- **Safe Nested Key Extraction:** It extracts all keys from within an object, boosting type safety.
+- **Precise Type Manipulation:** You can pick or omit only the keys you need even in deeply nested structures, making it easier to work with complex data.
+- **Unbranding and Merging:** It removes unnecessary constraints from branded types and safely merges multiple types.
+- **Utility Function Support (Experimental):** It even provides runtime functions to further ensure type safety during development.
+
+Below is a GIF showing an example of how to use the library.
 
 ![example](https://github.com/user-attachments/assets/28316425-8302-453e-b238-0c732606e6a7)
 
-```bash
-npm i @kakasoo/deep-strict-types
-```
+## DeepStrictObjectKeys
 
-# DeepStrictTypes
+`DeepStrictObjectKeys` extracts all keys from a nested object, preserving its hierarchical structure as a union of string paths.  
+That means you can access not only top-level keys but also nested keys using dot notation or, for arrays, using `[*]`.
 
-**DeepStrictTypes** extends TypeScript utility types, enabling safe operations like `Omit` and `Pick` on deeply nested objects or arrays by specifying keys to be inferred. It provides strict and accurate type checks, simplifying tasks like removing a single key from a nested object without recombining multiple types. Quickly and precisely omit or pick the internal keys you need!
+### Key Features
 
-## Key Features
+- **Preserves Hierarchy:** It retrieves every key from within an object so you can express paths like "user.address.city".
+- **Accurate Type Inference:** Instead of just using `keyof`, it thoroughly infers every nested key for enhanced type safety.
+- **Array Support:** For objects within arrays, it uses `[*]` instead of an index, so you cover all elements at once.
 
-### `DeepStrictObjectKeys`
+### Example
 
-Extract all nested keys from an object `T`, preserving its structure. Useful for safely handling specific keys at deeper levels of an object.
+The following example shows how to extract keys from a nested object using `DeepStrictObjectKeys`.
 
 ```typescript
 type Example = {
@@ -31,123 +59,304 @@ type Example = {
 type Keys = DeepStrictObjectKeys<Example>;
 ```
 
-Also, We create function for this type! Application of existing Object.keys to nested objects.
+The library also offers a utility function `deepStrictObjectKeys` based on this type, which works like `Object.keys` but correctly extracts nested paths.
 
-```ts
+```typescript
 type Target = { a: 1 }[][];
-const keys = deepStrictObjectKeys({} as Target); // "[*].[*].a"[]
+const keys = deepStrictObjectKeys({} as Target); // Result: ["[*].[*].a"]
 ```
 
-In arrays, elements are represented with the `[*]` symbol, ensuring perfect inference even for nested structures.
+## DeepStrictOmit
+
+`DeepStrictOmit` creates a new type by removing specified keys from a nested object type.
+Similar to the built-in `Omit`, it lets you precisely specify key paths—even in nested structures and arrays—to remove unwanted properties.
+
+### Key Features
+
+- **Omit Nested Keys:** You can specify a nested key path like `"user.profile.name"` to remove just that property.
+- **Handles Arrays:** It applies the same logic to objects within arrays, so you can remove a key from every element.
+- **Accurate Type Inference:** It preserves the rest of the object’s structure and types after omission.
+- **Supports Branded Types:** It works safely with branded types, removing unnecessary constraints.
 
-### `DeepStrictOmit`
+### Example
 
-Create a new type by excluding properties corresponding to key `K` from object `T`, preserving the nested structure.
+Below is an example of how to apply `DeepStrictOmit` to both nested objects and objects within arrays.
 
 ```typescript
+// Define an example object type
 type Example = {
   user: {
-    name: string;
-    age: number;
+    id: string;
+    profile: {
+      name: string;
+      age: number;
+      email: string;
+    };
+    posts: {
+      title: string;
+      content: string;
+      meta: {
+        likes: number;
+        shares: number;
+      };
+    }[];
   };
 };
 
-// Result: { user: { age: number; } }
-type Omitted = DeepStrictOmit<Example, 'user.name'>;
+// Remove the keys 'user.profile.email' and 'user.posts[*].meta.shares'
+type Omitted = DeepStrictOmit<Example, 'user.profile.email' | 'user.posts[*].meta.shares'>;
+
+/*
+  Resulting type Omitted:
+  {
+    user: {
+      id: string;
+      profile: {
+        name: string;
+        age: number;
+      };
+      posts: {
+        title: string;
+        content: string;
+        meta: {
+          likes: number;
+        };
+      }[];
+    };
+  }
+*/
 ```
 
-This is particularly effective for branded types. Below is an example using the `typia` library:
+In short, with `DeepStrictOmit` you can neatly remove only the keys you want from even the most complex nested objects or arrays.
 
-```typescript
-test('Apply DeepStrictOmit to branding types', () => {
-  type TestInterface = {
-    id: string;
-    thumbnails: {
-      name: string & MinLength<1> & MaxLength<255>;
-      url: string;
-    }[];
-  };
+## DeepStrictPick
 
-  type Question = DeepStrictOmit<TestInterface, 'id'>;
-  type IsAnswer = Equal<Question, { thumbnails: { name: string & MinLength<1> & MaxLength<255>; url: string }[] }>;
+`DeepStrictPick` creates a new type by selecting only the specified keys from a nested object type.
+It works like the built-in `Pick` but lets you precisely choose key paths—even in nested structures and arrays—so you only get the properties you need.
 
-  ok(typia.random<IsAnswer>());
-});
-```
+### Key Features
 
-### `DeepStrictPick`
+- **Pick Nested Keys:** Specify a nested key path like `"user.profile.name"` to pick only that property.
+- **Handles Arrays:** It also works on objects within arrays, allowing you to extract just the desired data.
+- **Accurate Type Inference:** It builds a type that only includes the selected properties, enhancing both type safety and readability.
+- **Flexible:** You can specify multiple nested keys at once.
 
-Select properties corresponding to key `K` from object `T`, preserving the nested structure.
+### Example
+
+Below is an example of using `DeepStrictPick` on nested objects and arrays.
 
 ```typescript
+// Define an example object type
 type Example = {
   user: {
-    name: string;
-    age: number;
+    id: string;
+    profile: {
+      name: string;
+      age: number;
+      email: string;
+    };
+    posts: {
+      title: string;
+      content: string;
+      meta: {
+        likes: number;
+        shares: number;
+      };
+    }[];
   };
 };
 
-// Result: { user: { name: string; } }
-type Picked = DeepStrictPick<Example, 'user.name'>;
+// Pick only the keys 'user.profile.name' and 'user.posts[*].meta.likes'
+type Picked = DeepStrictPick<Example, 'user.profile.name' | 'user.posts[*].meta.likes'>;
+
+/*
+  Resulting type Picked:
+  {
+    user: {
+      profile: {
+        name: string;
+      };
+      posts: {
+        meta: {
+          likes: number;
+        };
+      }[];
+    };
+  }
+*/
 ```
 
-### `DeepStrictUnbrand`
+So, `DeepStrictPick` lets you extract only the properties you want from even the most deeply nested structures.
 
-Remove branding from type `T`, even in deeply nested objects, simplifying the handling of branded types.
+## StringToDeepObject
 
-```typescript
-type BrandedType = { value: number & { unit: 'dollar' } };
+`StringToDeepObject` takes a string path in dot notation and generates a nested object type corresponding to that path.
+It parses the path string step by step, building a nested object and assigning the desired type to the final property.
+
+### Key Features
+
+- **Parses Path Strings:** Converts a string like "user.profile.name" into an object where each segment becomes a key.
+- **Dynamically Creates Objects:** Automatically builds a nested object based on the path, assigning the specified type at the end.
+- **Merges Union Types:** If you pass a union of path strings, it merges the resulting objects into one combined type.
+- **Type Safe:** Handles string paths safely within the type system to accurately represent nested structures.
+
+### Example
 
-// Result: { value: number; }
-type Unbranded = DeepStrictUnbrand<BrandedType>;
+```typescript
+// Example: Assigning a string type to the path 'user.profile.name'
+type DeepObj = StringToDeepObject<'user.profile.name', string>;
+
+/*
+  Resulting type DeepObj:
+  {
+    user: {
+      profile: {
+        name: string;
+      };
+    };
+  }
+*/
+
+// Another example: Assigning a number type at the end of a path
+type DeepNumberObj = StringToDeepObject<'settings.display.brightness', number>;
+
+/*
+  Resulting type DeepNumberObj:
+  {
+    settings: {
+      display: {
+        brightness: number;
+      };
+    };
+  }
+*/
+
+// Union type example: Two paths merge into one combined object type
+type MergedObj = StringToDeepObject<'user.profile.name' | 'user.profile.age', string | number>;
+
+/*
+  Resulting type MergedObj:
+  {
+    user: {
+      profile: {
+        name: string;
+        age: number;
+      };
+    };
+  }
+*/
 ```
 
-### `GetType`
+In short, `StringToDeepObject` lets you quickly create nested object types from a dot-delimited string, and even merge multiple paths if needed.
+
+## DeepStrictMerge
+
+`DeepStrictMerge` deeply merges two or more object types into a single unified type.
+It recursively combines every property in nested structures, and when the same key exists in multiple objects, it follows a set of rules to merge them.
+
+### Key Features
+
+- **Deep Merge:** Recursively merges not only top-level properties but also all nested objects.
+- **Accurate Type Inference:** Each object’s type information is retained in the merged result, ensuring type safety.
+- **Conflict Resolution:** When the same key exists in multiple objects, it resolves the conflict according to defined rules.
+- **Flexible:** You can merge several object types at once, making it easy to manage complex data structures.
 
-Get the type of a specific key path from a nested object type `T`. This is useful for extracting the type of deeply nested properties safely.
+### Example
 
 ```typescript
-type Example = {
+// Define two object types to merge
+type ObjA = {
   user: {
-    name: string;
-    address: {
-      city: string;
-      zip: number;
+    id: string;
+    profile: {
+      name: string;
+      age: number;
     };
   };
 };
 
-// Result: string
-type CityType = GetType<Example, 'user.address.city'>;
+type ObjB = {
+  user: {
+    profile: {
+      email: string;
+      // If both objects have the key 'age', the merge rule applies.
+      age: number;
+    };
+    settings: {
+      theme: string;
+    };
+  };
+};
 
-// Result: { city: string; zip: number; }
-type AddressType = GetType<Example, 'user.address'>;
+// Deep merge the two objects into one type
+type Merged = DeepStrictMerge<ObjA, ObjB>;
+
+/*
+  Resulting type Merged:
+  {
+    user: {
+      id: string;
+      profile: {
+        name: string;
+        age: number;  // Merged according to the rules
+        email: string;
+      };
+      settings: {
+        theme: string;
+      };
+    };
+  }
+*/
 ```
 
-## Utility functions (Experimental)
+So, `DeepStrictMerge` lets you seamlessly combine different object types into one, even when they have complex nested structures.
+
+## DeepDateToString
+
+`DeepDateToString` finds every `Date` type in an object and converts it to a `string` recursively.
+It locates all `Date` properties—even deep within nested objects or arrays—and converts them to strings, which is especially useful for serialization or JSON conversion.
+
+### Key Features
+
+- **Recursive Conversion:** It transforms every `Date` type found in the object, including those in nested objects and arrays.
+- **Ensures Type Consistency:** By explicitly converting `Date` to `string`, it prevents type mismatches during serialization or API responses.
+- **Handles Complex Structures:** Works reliably even with deeply nested objects and arrays containing `Date` values.
 
-### `DeepStrictAssert`
+### Example
 
 ```typescript
-interface Example {
-  a: number;
-  b: number;
-  c: {
-    d: string;
-    e: string;
-    f: {
-      g: boolean;
-      h: boolean;
+// Define an example object type
+type Example = {
+  createdAt: Date;
+  updatedAt: Date;
+  user: {
+    name: string;
+    birthDate: Date;
+    posts: {
+      title: string;
+      publishedAt: Date;
     }[];
-  }[];
-}
-
-declare const E: Example;
+  };
+};
 
-// Expected: { c: Array<{ d: string }> }
-const answer = deepStrictAssert(E)('c[*].d');
+// Convert all Date properties to string using DeepDateToString
+type StringifiedExample = DeepDateToString<Example>;
+
+/*
+  Resulting type StringifiedExample:
+  {
+    createdAt: string;
+    updatedAt: string;
+    user: {
+      name: string;
+      birthDate: string;
+      posts: {
+        title: string;
+        publishedAt: string;
+      }[];
+    };
+  }
+*/
 ```
 
----
-
-This is just a part of the features provided by **DeepStrictTypes**, designed to enhance TypeScript's type manipulation capabilities and improve developer productivity. For more details, check out the library's full documentation.
+In short, `DeepDateToString` makes sure that every `Date` inside an object is converted to a `string`, ensuring type consistency for operations like serialization or JSON conversion.

package/bin/src/functions/DeepStrictObjectKeys.d.ts

@@ -1,7 +1,6 @@
 import { DeepStrictObjectKeys } from '../types';
 type RemoveStartWithDot<T extends string> = T extends `.${infer R extends string}` ? R : T;
-type Replace<T extends string> = ReplaceWildcard<T>;
-type ReplaceWildcard<S extends string> = S extends '[*]' ? `${number}` : S extends `[*].${infer Rest}` ? `${number}.${ReplaceWildcard<Rest>}` : S extends `${infer Prefix extends string}.[*]${infer Rest}` ? `${Prefix}.${number}${ReplaceWildcard<Rest>}` : S extends `${infer Prefix extends string}[*]${infer Rest}` ? `${Prefix}.${number}${ReplaceWildcard<Rest>}` : S;
+type Replace<S extends string> = S extends '[*]' ? `${number}` : S extends `[*].${infer Rest}` ? `${number}.${Replace<Rest>}` : S extends `${infer Prefix extends string}.[*]${infer Rest}` ? `${Prefix}.${number}${Replace<Rest>}` : S extends `${infer Prefix extends string}[*]${infer Rest}` ? `${Prefix}.${number}${Replace<Rest>}` : S;
 type ReturnType<Target extends object, Joiner extends {
     array: string;
     object: string;

package/bin/src/functions/DeepStrictObjectKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeepStrictObjectKeys.d.ts","sourceRoot":"","sources":["../../../src/functions/DeepStrictObjectKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD,KAAK,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;AAE3F,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;AAEpD,KAAK,eAAe,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,KAAK,GACpD,GAAG,MAAM,EAAE,GACX,CAAC,SAAS,OAAO,MAAM,IAAI,EAAE,GAC3B,GAAG,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,GACpC,CAAC,SAAS,GAAG,MAAM,MAAM,SAAS,MAAM,OAAO,MAAM,IAAI,EAAE,GACzD,GAAG,MAAM,IAAI,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,GAC7C,CAAC,SAAS,GAAG,MAAM,MAAM,SAAS,MAAM,MAAM,MAAM,IAAI,EAAE,GACxD,GAAG,MAAM,IAAI,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,GAC7C,CAAC,CAAC;AAEZ,KAAK,UAAU,CACb,MAAM,SAAS,MAAM,EACrB,MAAM,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,IAC9E,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAE/G,wBAAgB,oBAAoB,CAClC,MAAM,SAAS,MAAM,EACrB,MAAM,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,EAChF,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAqB5C"}
+{"version":3,"file":"DeepStrictObjectKeys.d.ts","sourceRoot":"","sources":["../../../src/functions/DeepStrictObjectKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD,KAAK,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;AAE3F,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,KAAK,GAC5C,GAAG,MAAM,EAAE,GACX,CAAC,SAAS,OAAO,MAAM,IAAI,EAAE,GAC3B,GAAG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,GAC5B,CAAC,SAAS,GAAG,MAAM,MAAM,SAAS,MAAM,OAAO,MAAM,IAAI,EAAE,GACzD,GAAG,MAAM,IAAI,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,GACrC,CAAC,SAAS,GAAG,MAAM,MAAM,SAAS,MAAM,MAAM,MAAM,IAAI,EAAE,GACxD,GAAG,MAAM,IAAI,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,GACrC,CAAC,CAAC;AAEZ,KAAK,UAAU,CACb,MAAM,SAAS,MAAM,EACrB,MAAM,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,IAC9E,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAE/G,wBAAgB,oBAAoB,CAClC,MAAM,SAAS,MAAM,EACrB,MAAM,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,EAChF,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAqB5C"}

package/bin/src/functions/DeepStrictObjectKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"DeepStrictObjectKeys.js","sourceRoot":"","sources":["../../../src/functions/DeepStrictObjectKeys.ts"],"names":[],"mappings":";;AAqBA,oDAwBC;AAxBD,SAAgB,oBAAoB,CAGlC,MAAc;IACd,IAAI,MAAM,GAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAY,CAAC;IAC7D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAY,CAAC;IACnD,CAAC;IAED,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;YAClB,MAAM,KAAK,GAAI,MAAc,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;gBACzE,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAA+B,CAAC;AACrE,CAAC"}
+{"version":3,"file":"DeepStrictObjectKeys.js","sourceRoot":"","sources":["../../../src/functions/DeepStrictObjectKeys.ts"],"names":[],"mappings":";;AAmBA,oDAwBC;AAxBD,SAAgB,oBAAoB,CAGlC,MAAc;IACd,IAAI,MAAM,GAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAY,CAAC;IAC7D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAY,CAAC;IACnD,CAAC;IAED,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;YAClB,MAAM,KAAK,GAAI,MAAc,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;gBACzE,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAA+B,CAAC;AACrE,CAAC"}

package/bin/src/types/DeepStrictObjectKeys.d.ts

@@ -4,6 +4,13 @@ import type { IsAny } from './IsAny';
 import type { IsUnion } from './IsUnion';
 import type { ValueType } from './ValueType';
 declare namespace DeepStrictObjectKeys {
+    /**
+     * Internal helper type that recursively extracts all keys from nested objects
+     * @template Target - The object type to extract keys from
+     * @template Joiner - Defines the symbols used to join nested paths (array: '[*]', object: '.')
+     * @template IsSafe - Controls whether to explore union types that mix primitives and objects
+     * @template P - The current property keys being processed (excludes array methods)
+     */
     type Infer<Target extends object, Joiner extends {
         array: string;
         object: string;
@@ -33,6 +40,7 @@ export type DeepStrictObjectKeys<Target extends object, Joiner extends {
 } = {
     array: '[*]';
     object: '.';
-}, IsSafe extends boolean = true> = DeepStrictUnbrand<Target> extends Array<infer Element> ? IsAny<Element> extends true ? Joiner['array'] : Element extends object ? Joiner['array'] | `${Joiner['array']}.${DeepStrictObjectKeys<Element, Joiner, IsSafe>}` : Joiner['array'] : DeepStrictUnbrand<Target> extends readonly (infer Element)[] ? IsAny<Element> extends true ? Joiner['array'] : Element extends object ? Joiner['array'] | `${Joiner['array']}.${DeepStrictObjectKeys<Element, Joiner, IsSafe>}` : Joiner['array'] : DeepStrictObjectKeys.Infer<DeepStrictUnbrand<Target>, Joiner, IsSafe>;
+}, IsSafe extends boolean = true> = DeepStrictUnbrand<Target> extends Array<infer Element> ? IsAny<Element> extends true ? Joiner['array'] : Element extends object ? // For arrays of objects, return both the array key and nested object keys
+Joiner['array'] | `${Joiner['array']}.${DeepStrictObjectKeys<Element, Joiner, IsSafe>}` : Joiner['array'] : DeepStrictUnbrand<Target> extends readonly (infer Element)[] ? IsAny<Element> extends true ? Joiner['array'] : Element extends object ? Joiner['array'] | `${Joiner['array']}.${DeepStrictObjectKeys<Element, Joiner, IsSafe>}` : Joiner['array'] : DeepStrictObjectKeys.Infer<DeepStrictUnbrand<Target>, Joiner, IsSafe>;
 export {};
 //# sourceMappingURL=DeepStrictObjectKeys.d.ts.map

package/bin/src/types/DeepStrictObjectKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeepStrictObjectKeys.d.ts","sourceRoot":"","sources":["../../../src/types/DeepStrictObjectKeys.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DeepStrictObjectKeys.d.ts","sourceRoot":"","sources":["../../../src/types/DeepStrictObjectKeys.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kakasoo/deep-strict-types",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "typescript utility types including deep-strict-omit and pick type",
   "private": false,
   "publishConfig": {
@@ -13,7 +13,7 @@
   "types": "bin/src/index.d.ts",
   "scripts": {
     "build": "rimraf bin && tsc",
-    "build:test": "rimraf bin && tsc -p test/tsconfig.json --watch",
+    "build:test": "rimraf bin && tsc -p test/tsconfig.json",
     "prepare": "ts-patch install && typia patch",
     "test": "node bin/test/index.js",
     "prettier": "prettier src --write && prettier test --write"
@@ -47,6 +47,7 @@
   "author": "kakasoo",
   "license": "ISC",
   "devDependencies": {
+    "@nestia/e2e": "^7.3.0",
     "@samchon/shopping-api": "^0.14.1",
     "@types/inquirer": "^9.0.7",
     "@types/node": "^22.10.10",