@types/lodash 4.17.4 → 4.17.6

lodash/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for lodash (https://lodash.com).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/lodash.
 
 ### Additional Details
- * Last updated: Fri, 17 May 2024 02:16:49 GMT
+ * Last updated: Thu, 27 Jun 2024 16:07:29 GMT
  * Dependencies: none
 
 # Credits

lodash/common/object.d.ts

@@ -1021,41 +1021,98 @@ declare module "../index" {
         functionsIn(): CollectionChain<string>;
     }
 
-    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 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 FieldWithPossiblyUndefined<T, Key> =
-        | GetFieldType<Exclude<T, undefined>, Key>
-        | Extract<T, 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 IndexedFieldWithPossiblyUndefined<T, Key> =
-        | GetIndexedField<Exclude<T, undefined>, Key>
-        | Extract<T, 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 GetFieldType<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>;
+    /** Internal. Assumes P is a dot-delimited path. */
+    type GetFieldTypeOfNarrowedByDotPath<T, P> =
+        P extends `${infer L}.${infer R}`
+        ? GetFieldType<GetFieldTypeOfNarrowedByKey<T, L>, R, 'DotPath'>
+        : GetFieldTypeOfNarrowedByKey<T, P>;
+
+    /** Internal. This is a piece of GetFieldTypeOfNarrowedByLKR logic,
+     *  assuming that Lc isn't to be ignored, and does not end with dot. */
+    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>
+
+    /** Internal. Assumes T has been narrowed; L is a dot-delimited path,
+     *  and should be ignored if an empty string; K is a key name; and R is
+     *  a dot-delimetered path, to be ignored if an empty string. Also if
+     *  L has a tail dot, or R has a front dot, these dots should be discarded,
+     *  however when L or R is just a dot, they should be interpreted as empty
+     *  key name (rather than ignored). */
+    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>
+
+    /** Internal. Assumes T has been narrowed. */
+    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>;
+
+    /** Internal. Assumes T has been narrowed to an object type. */
+    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>;
+
+    /** Internal. Assumes T has been narrowed to a primitive type. */
+    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>;
+
+    /**
+     * Deduces the type of value at the path P of type T,
+     * so that _.get<T, P>(t: T, p: P): GetFieldType<T, P>.
+     * XT specifies the exact meaning of X:
+     * - 'Path' (default) - X is a path type to be fully parsed;
+     * - 'DotPath - X is a dot-delimitered path, without square (indexing) brackets;
+     * - 'Key' - X is a simple key, and needs no parsing.
+     */
+    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>;
 
     interface LoDashStatic {
         /**
@@ -1579,6 +1636,10 @@ declare module "../index" {
         * @return Returns the new mapped object.
          */
         mapValues<TResult>(obj: string | null | undefined, callback: StringIterator<TResult>): NumericDictionary<TResult>;
+        /**
+         * @see _.mapValues
+         */
+        mapValues<T, TResult>(array: T[], callback: ArrayIterator<T, TResult>): NumericDictionary<TResult>;
         /**
          * @see _.mapValues
          */
@@ -1634,7 +1695,7 @@ declare module "../index" {
         /**
          * @see _.mapValues
          */
-        mapValues<TResult>(callback: DictionaryIterator<T, TResult>): Object<Dictionary<TResult>>;
+        mapValues<TResult>(callback: ArrayIterator<T, TResult>): NumericDictionary<TResult>;
         /**
          * @see _.mapValues
          */
@@ -1702,7 +1763,7 @@ declare module "../index" {
         /**
          * @see _.mapValues
          */
-        mapValues<TResult>(callback: DictionaryIterator<T, TResult>): ObjectChain<Dictionary<TResult>>;
+        mapValues<TResult>(callback: ArrayIterator<T, TResult>): ObjectChain<NumericDictionary<TResult>>;
         /**
          * @see _.mapValues
          */

lodash/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/lodash",
-    "version": "4.17.4",
+    "version": "4.17.6",
     "description": "TypeScript definitions for lodash",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/lodash",
     "license": "MIT",
@@ -55,6 +55,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "29aeb85b95cd7d3be7579ea9938820eb2d06fcb68095fd735ad9abbbc5148766",
-    "typeScriptVersion": "4.7"
+    "typesPublisherContentHash": "7b3079d1429e9e75e2d4c67aa9a96e2b37b73f32ccc26b1d4f25bf72d7b27f0f",
+    "typeScriptVersion": "4.8"
 }