es-toolkit 1.39.5-dev.1388 → 1.39.5-dev.1389

package/dist/compat/_internal/GetFieldType.d.mts

@@ -0,0 +1,12 @@
+type GetFieldTypeOfArrayLikeByKey<T extends unknown[], K> = K extends number ? T[K] : K extends `${infer N extends number}` ? T[N] : K extends keyof T ? T[K] : undefined;
+type GetFieldTypeOfStringByKey<T extends string, K> = K extends number ? T[K] : K extends `${infer N extends number}` ? T[N] : K extends keyof T ? T[K] : undefined;
+type GetFieldTypeOfNarrowedByKey<T, K> = T extends unknown[] ? GetFieldTypeOfArrayLikeByKey<T, K> : T extends string ? GetFieldTypeOfStringByKey<T, K> : K extends keyof T ? T[K] : K extends number ? `${K}` extends keyof T ? T[`${K}`] : undefined : K extends `${infer N extends number}` ? N extends keyof T ? T[N] : undefined : undefined;
+type GetFieldTypeOfNarrowedByDotPath<T, P> = P extends `${infer L}.${infer R}` ? GetFieldType<GetFieldTypeOfNarrowedByKey<T, L>, R, 'DotPath'> : GetFieldTypeOfNarrowedByKey<T, P>;
+type GetFieldTypeOfNarrowedByLcKR<T, Lc, K, R> = '' extends R ? GetFieldType<GetFieldTypeOfNarrowedByDotPath<T, Lc>, K, 'Key'> : R extends `.${infer Rc}` ? GetFieldType<GetFieldType<GetFieldTypeOfNarrowedByDotPath<T, Lc>, K, 'Key'>, Rc> : GetFieldType<GetFieldType<GetFieldTypeOfNarrowedByDotPath<T, Lc>, K, 'Key'>, R>;
+type GetFieldTypeOfNarrowedByLKR<T, L, K, R> = '' extends L ? '' extends R ? GetFieldTypeOfNarrowedByKey<T, K> : R extends `.${infer Rc}` ? GetFieldType<GetFieldTypeOfNarrowedByKey<T, K>, Rc> : GetFieldType<GetFieldTypeOfNarrowedByKey<T, K>, R> : L extends `${infer Lc}.` ? GetFieldTypeOfNarrowedByLcKR<T, Lc, K, R> : GetFieldTypeOfNarrowedByLcKR<T, L, K, R>;
+type GetFieldTypeOfNarrowed<T, X, XT extends 'DotPath' | 'Key' | 'Path'> = XT extends 'Key' ? GetFieldTypeOfNarrowedByKey<T, X> : XT extends 'DotPath' ? GetFieldTypeOfNarrowedByDotPath<T, X> : X extends `${infer L}['${infer K}']${infer R}` ? GetFieldTypeOfNarrowedByLKR<T, L, K, R> : X extends `${infer L}["${infer K}"]${infer R}` ? GetFieldTypeOfNarrowedByLKR<T, L, K, R> : X extends `${infer L}[${infer K}]${infer R}` ? GetFieldTypeOfNarrowedByLKR<T, L, K, R> : GetFieldTypeOfNarrowedByDotPath<T, X>;
+type GetFieldTypeOfObject<T, X, XT extends 'DotPath' | 'Key' | 'Path'> = Extract<T, unknown[]> extends never ? GetFieldTypeOfNarrowed<T, X, XT> : GetFieldTypeOfNarrowed<Exclude<T, unknown[]>, X, XT> | GetFieldTypeOfNarrowed<Extract<T, unknown[]>, X, XT>;
+type GetFieldTypeOfPrimitive<T, X, XT extends 'DotPath' | 'Key' | 'Path'> = Extract<T, string> extends never ? T extends never ? never : undefined : (Exclude<T, string> extends never ? never : undefined) | GetFieldTypeOfNarrowed<Extract<T, string>, X, XT>;
+type GetFieldType<T, X, XT extends 'DotPath' | 'Key' | 'Path' = 'Path'> = Extract<T, object> extends never ? GetFieldTypeOfPrimitive<T, X, XT> : GetFieldTypeOfPrimitive<Exclude<T, object>, X, XT> | GetFieldTypeOfObject<Extract<T, object>, X, XT>;
+
+export type { GetFieldType };

package/dist/compat/_internal/GetFieldType.d.ts

@@ -0,0 +1,12 @@
+type GetFieldTypeOfArrayLikeByKey<T extends unknown[], K> = K extends number ? T[K] : K extends `${infer N extends number}` ? T[N] : K extends keyof T ? T[K] : undefined;
+type GetFieldTypeOfStringByKey<T extends string, K> = K extends number ? T[K] : K extends `${infer N extends number}` ? T[N] : K extends keyof T ? T[K] : undefined;
+type GetFieldTypeOfNarrowedByKey<T, K> = T extends unknown[] ? GetFieldTypeOfArrayLikeByKey<T, K> : T extends string ? GetFieldTypeOfStringByKey<T, K> : K extends keyof T ? T[K] : K extends number ? `${K}` extends keyof T ? T[`${K}`] : undefined : K extends `${infer N extends number}` ? N extends keyof T ? T[N] : undefined : undefined;
+type GetFieldTypeOfNarrowedByDotPath<T, P> = P extends `${infer L}.${infer R}` ? GetFieldType<GetFieldTypeOfNarrowedByKey<T, L>, R, 'DotPath'> : GetFieldTypeOfNarrowedByKey<T, P>;
+type GetFieldTypeOfNarrowedByLcKR<T, Lc, K, R> = '' extends R ? GetFieldType<GetFieldTypeOfNarrowedByDotPath<T, Lc>, K, 'Key'> : R extends `.${infer Rc}` ? GetFieldType<GetFieldType<GetFieldTypeOfNarrowedByDotPath<T, Lc>, K, 'Key'>, Rc> : GetFieldType<GetFieldType<GetFieldTypeOfNarrowedByDotPath<T, Lc>, K, 'Key'>, R>;
+type GetFieldTypeOfNarrowedByLKR<T, L, K, R> = '' extends L ? '' extends R ? GetFieldTypeOfNarrowedByKey<T, K> : R extends `.${infer Rc}` ? GetFieldType<GetFieldTypeOfNarrowedByKey<T, K>, Rc> : GetFieldType<GetFieldTypeOfNarrowedByKey<T, K>, R> : L extends `${infer Lc}.` ? GetFieldTypeOfNarrowedByLcKR<T, Lc, K, R> : GetFieldTypeOfNarrowedByLcKR<T, L, K, R>;
+type GetFieldTypeOfNarrowed<T, X, XT extends 'DotPath' | 'Key' | 'Path'> = XT extends 'Key' ? GetFieldTypeOfNarrowedByKey<T, X> : XT extends 'DotPath' ? GetFieldTypeOfNarrowedByDotPath<T, X> : X extends `${infer L}['${infer K}']${infer R}` ? GetFieldTypeOfNarrowedByLKR<T, L, K, R> : X extends `${infer L}["${infer K}"]${infer R}` ? GetFieldTypeOfNarrowedByLKR<T, L, K, R> : X extends `${infer L}[${infer K}]${infer R}` ? GetFieldTypeOfNarrowedByLKR<T, L, K, R> : GetFieldTypeOfNarrowedByDotPath<T, X>;
+type GetFieldTypeOfObject<T, X, XT extends 'DotPath' | 'Key' | 'Path'> = Extract<T, unknown[]> extends never ? GetFieldTypeOfNarrowed<T, X, XT> : GetFieldTypeOfNarrowed<Exclude<T, unknown[]>, X, XT> | GetFieldTypeOfNarrowed<Extract<T, unknown[]>, X, XT>;
+type GetFieldTypeOfPrimitive<T, X, XT extends 'DotPath' | 'Key' | 'Path'> = Extract<T, string> extends never ? T extends never ? never : undefined : (Exclude<T, string> extends never ? never : undefined) | GetFieldTypeOfNarrowed<Extract<T, string>, X, XT>;
+type GetFieldType<T, X, XT extends 'DotPath' | 'Key' | 'Path' = 'Path'> = Extract<T, object> extends never ? GetFieldTypeOfPrimitive<T, X, XT> : GetFieldTypeOfPrimitive<Exclude<T, object>, X, XT> | GetFieldTypeOfObject<Extract<T, object>, X, XT>;
+
+export type { GetFieldType };

package/dist/compat/object/get.d.mts

@@ -1,4 +1,4 @@
-import { Get } from './get.types.mjs';
+import { GetFieldType } from '../_internal/GetFieldType.mjs';
 import { PropertyPath } from '../_internal/PropertyPath.mjs';
 
 /**
@@ -132,24 +132,6 @@ declare function get<TObject extends object, TKey1 extends keyof TObject, TKey2
  * // => 3
  */
 declare function get<TObject extends object, TKey1 extends keyof TObject, TKey2 extends keyof NonNullable<TObject[TKey1]>, TKey3 extends keyof NonNullable<NonNullable<TObject[TKey1]>[TKey2]>>(object: TObject | null | undefined, path: [TKey1, TKey2, TKey3]): NonNullable<NonNullable<TObject[TKey1]>[TKey2]>[TKey3] | undefined;
-/**
- * Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.
- *
- * @template TObject
- * @template TKey1
- * @template TKey2
- * @template TKey3
- * @template TDefault
- * @param {TObject | null | undefined} object - The object to query.
- * @param {[TKey1, TKey2, TKey3]} path - The path of the property to get.
- * @param {TDefault} defaultValue - The value returned if the resolved value is undefined.
- * @returns {Exclude<NonNullable<NonNullable<TObject[TKey1]>[TKey2]>[TKey3], undefined> | TDefault} Returns the resolved value.
- *
- * @example
- * const object = { 'a': { 'b': { 'c': 3 } } };
- * get(object, ['a', 'b', 'c'], 'default');
- * // => 3
- */
 /**
  * Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.
  *
@@ -302,14 +284,14 @@ declare function get(object: null | undefined, path: PropertyPath): undefined;
  * @template TPath
  * @param {TObject} data - The object to query.
  * @param {TPath} path - The path of the property to get.
- * @returns {string extends TPath ? any : Get<TObject, TPath>} Returns the resolved value.
+ * @returns {string extends TPath ? any : GetFieldType<TObject, TPath>} Returns the resolved value.
  *
  * @example
  * const object = { a: { b: { c: 1 } } };
  * get(object, 'a.b.c');
  * // => 1
  */
-declare function get<TObject, TPath extends string>(data: TObject, path: TPath): string extends TPath ? any : Get<TObject, TPath>;
+declare function get<TObject, TPath extends string>(data: TObject, path: TPath): string extends TPath ? any : GetFieldType<TObject, TPath>;
 /**
  * Gets the value at path of object using type-safe path. If the resolved value is undefined, the defaultValue is returned.
  *
@@ -319,14 +301,14 @@ declare function get<TObject, TPath extends string>(data: TObject, path: TPath):
  * @param {TObject} data - The object to query.
  * @param {TPath} path - The path of the property to get.
  * @param {TDefault} defaultValue - The value returned if the resolved value is undefined.
- * @returns {Exclude<Get<TObject, TPath>, null | undefined> | TDefault} Returns the resolved value.
+ * @returns {Exclude<GetFieldType<TObject, TPath>, null | undefined> | TDefault} Returns the resolved value.
  *
  * @example
  * const object = { a: { b: { c: 1 } } };
  * get(object, 'a.b.d', 'default');
  * // => 'default'
  */
-declare function get<TObject, TPath extends string, TDefault = Get<TObject, TPath>>(data: TObject, path: TPath, defaultValue: TDefault): Exclude<Get<TObject, TPath>, null | undefined> | TDefault;
+declare function get<TObject, TPath extends string, TDefault = GetFieldType<TObject, TPath>>(data: TObject, path: TPath, defaultValue: TDefault): Exclude<GetFieldType<TObject, TPath>, null | undefined> | TDefault;
 /**
  * Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned.
  *

package/dist/compat/object/get.d.ts

@@ -1,4 +1,4 @@
-import { Get } from './get.types.js';
+import { GetFieldType } from '../_internal/GetFieldType.js';
 import { PropertyPath } from '../_internal/PropertyPath.js';
 
 /**
@@ -132,24 +132,6 @@ declare function get<TObject extends object, TKey1 extends keyof TObject, TKey2
  * // => 3
  */
 declare function get<TObject extends object, TKey1 extends keyof TObject, TKey2 extends keyof NonNullable<TObject[TKey1]>, TKey3 extends keyof NonNullable<NonNullable<TObject[TKey1]>[TKey2]>>(object: TObject | null | undefined, path: [TKey1, TKey2, TKey3]): NonNullable<NonNullable<TObject[TKey1]>[TKey2]>[TKey3] | undefined;
-/**
- * Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.
- *
- * @template TObject
- * @template TKey1
- * @template TKey2
- * @template TKey3
- * @template TDefault
- * @param {TObject | null | undefined} object - The object to query.
- * @param {[TKey1, TKey2, TKey3]} path - The path of the property to get.
- * @param {TDefault} defaultValue - The value returned if the resolved value is undefined.
- * @returns {Exclude<NonNullable<NonNullable<TObject[TKey1]>[TKey2]>[TKey3], undefined> | TDefault} Returns the resolved value.
- *
- * @example
- * const object = { 'a': { 'b': { 'c': 3 } } };
- * get(object, ['a', 'b', 'c'], 'default');
- * // => 3
- */
 /**
  * Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.
  *
@@ -302,14 +284,14 @@ declare function get(object: null | undefined, path: PropertyPath): undefined;
  * @template TPath
  * @param {TObject} data - The object to query.
  * @param {TPath} path - The path of the property to get.
- * @returns {string extends TPath ? any : Get<TObject, TPath>} Returns the resolved value.
+ * @returns {string extends TPath ? any : GetFieldType<TObject, TPath>} Returns the resolved value.
  *
  * @example
  * const object = { a: { b: { c: 1 } } };
  * get(object, 'a.b.c');
  * // => 1
  */
-declare function get<TObject, TPath extends string>(data: TObject, path: TPath): string extends TPath ? any : Get<TObject, TPath>;
+declare function get<TObject, TPath extends string>(data: TObject, path: TPath): string extends TPath ? any : GetFieldType<TObject, TPath>;
 /**
  * Gets the value at path of object using type-safe path. If the resolved value is undefined, the defaultValue is returned.
  *
@@ -319,14 +301,14 @@ declare function get<TObject, TPath extends string>(data: TObject, path: TPath):
  * @param {TObject} data - The object to query.
  * @param {TPath} path - The path of the property to get.
  * @param {TDefault} defaultValue - The value returned if the resolved value is undefined.
- * @returns {Exclude<Get<TObject, TPath>, null | undefined> | TDefault} Returns the resolved value.
+ * @returns {Exclude<GetFieldType<TObject, TPath>, null | undefined> | TDefault} Returns the resolved value.
  *
  * @example
  * const object = { a: { b: { c: 1 } } };
  * get(object, 'a.b.d', 'default');
  * // => 'default'
  */
-declare function get<TObject, TPath extends string, TDefault = Get<TObject, TPath>>(data: TObject, path: TPath, defaultValue: TDefault): Exclude<Get<TObject, TPath>, null | undefined> | TDefault;
+declare function get<TObject, TPath extends string, TDefault = GetFieldType<TObject, TPath>>(data: TObject, path: TPath, defaultValue: TDefault): Exclude<GetFieldType<TObject, TPath>, null | undefined> | TDefault;
 /**
  * Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned.
  *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.39.5-dev.1388+16709839",
+  "version": "1.39.5-dev.1389+b281cab8",
   "homepage": "https://es-toolkit.dev",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {

package/dist/compat/object/get.types.d.mts

@@ -1,9 +0,0 @@
-/**
- * See the definition of `@types/lodash`.
- */
-type GetIndexedField<T, K> = K extends keyof T ? T[K] : K extends `${number}` ? 'length' extends keyof T ? number extends T['length'] ? number extends keyof T ? T[number] : undefined : undefined : undefined : undefined;
-type FieldWithPossiblyUndefined<T, Key> = Get<Exclude<T, undefined>, Key> | Extract<T, undefined>;
-type IndexedFieldWithPossiblyUndefined<T, Key> = GetIndexedField<Exclude<T, undefined>, Key> | Extract<T, undefined>;
-type Get<T, P> = P extends `${infer Left}.${infer Right}` ? Left extends keyof Exclude<T, undefined> ? FieldWithPossiblyUndefined<Exclude<T, undefined>[Left], Right> | Extract<T, undefined> : Left extends `${infer FieldKey}[${infer IndexKey}]` ? FieldKey extends keyof T ? FieldWithPossiblyUndefined<IndexedFieldWithPossiblyUndefined<T[FieldKey], IndexKey>, Right> : undefined : undefined : P extends keyof T ? T[P] : P extends `${infer FieldKey}[${infer IndexKey}]` ? FieldKey extends keyof T ? IndexedFieldWithPossiblyUndefined<T[FieldKey], IndexKey> : undefined : IndexedFieldWithPossiblyUndefined<T, P>;
-
-export type { Get };

package/dist/compat/object/get.types.d.ts

@@ -1,9 +0,0 @@
-/**
- * See the definition of `@types/lodash`.
- */
-type GetIndexedField<T, K> = K extends keyof T ? T[K] : K extends `${number}` ? 'length' extends keyof T ? number extends T['length'] ? number extends keyof T ? T[number] : undefined : undefined : undefined : undefined;
-type FieldWithPossiblyUndefined<T, Key> = Get<Exclude<T, undefined>, Key> | Extract<T, undefined>;
-type IndexedFieldWithPossiblyUndefined<T, Key> = GetIndexedField<Exclude<T, undefined>, Key> | Extract<T, undefined>;
-type Get<T, P> = P extends `${infer Left}.${infer Right}` ? Left extends keyof Exclude<T, undefined> ? FieldWithPossiblyUndefined<Exclude<T, undefined>[Left], Right> | Extract<T, undefined> : Left extends `${infer FieldKey}[${infer IndexKey}]` ? FieldKey extends keyof T ? FieldWithPossiblyUndefined<IndexedFieldWithPossiblyUndefined<T[FieldKey], IndexKey>, Right> : undefined : undefined : P extends keyof T ? T[P] : P extends `${infer FieldKey}[${infer IndexKey}]` ? FieldKey extends keyof T ? IndexedFieldWithPossiblyUndefined<T[FieldKey], IndexKey> : undefined : IndexedFieldWithPossiblyUndefined<T, P>;
-
-export type { Get };