@valkyriestudios/utils 12.40.0 → 12.41.0

package/README.md

@@ -12,6 +12,11 @@ Zero-dependency collection of single-function utilities for common tasks
 ## Installation
 `npm install @valkyriestudios/utils`
 
+## 🧊 TriFrost is powered by utils
+Many of the utilities in this package are optimized and tested as foundational building blocks of [TriFrost](https://www.trifrost.dev) — a high-performance, type-safe framework for building fullstack TypeScript applications.
+
+If you're looking to go beyond utilities and build fully modular backends with deep type integration, check out TriFrost.
+
 ## Available Functions
 ### array/is(val:unknown)
 Check if a variable is of type Array
@@ -1498,7 +1503,7 @@ pick({a: 1, b: 2, c: 3}, ['a','b']); // {a: 1, b: 2}
 ### object/omit(obj:Object={}, keys:Array[string]=[])
 Returns an object with the keys provided in the keys array stripped from the provided object.
 ```typescript
-import { omit } from "@valkyriestudios/utils/object"; /* Or @valkyriestudios/utils/object/omit; */
+import { omit } from "@valkyriestudios/utils/object";
 const redacted = omit({
     firstName: "Peter",
     lastName: "Vermeulen",
@@ -1519,6 +1524,89 @@ Its type will be
 */
 ```
 
+Also works with wildcards (take note, only as **prefix**):
+```typescript
+import { omit } from "@valkyriestudios/utils/object";
+const redacted = omit({
+    firstName: "Peter",
+    lastName: "Vermeulen",
+    age: 34,
+    details: {
+        phone: "...",
+        email: "...",
+        isActive: true,
+        password: "...",
+    },
+    meta: {
+        phone: "...",
+    },
+}, ["age", "*.phone", "*.email", "*.password"]);
+/**
+Redacted here will be:
+{
+    firstName: "Peter",
+    lastName: "Vermeulen",
+    details: {isActive: true},
+    meta: {}
+}
+*/
+```
+
+### object/scramble(obj:Object={}, keys:Array[string]=[], options?:{replacement?:string})
+Returns an object with the keys provided in the keys array scrambled.
+```typescript
+import { scramble } from "@valkyriestudios/utils/object";
+const redacted = scramble({
+    firstName: "Peter",
+    lastName: "Vermeulen",
+    age: 34,
+    details: {
+        phone: "...",
+        email: "...",
+        isActive: true,
+        password: "...",
+    },
+}, ["age", "details.phone", "details.email", "details.password"]);
+/**
+Redacted here will be:
+{
+    firstName: "Peter",
+    lastName: "Vermeulen",
+    age: "***",
+    details: {phone: "***", email: "***", isActive: true, password: "***"}
+}
+*/
+```
+
+Also works with wildcards (take note, only as **prefix**):
+```typescript
+import { scramble } from "@valkyriestudios/utils/object";
+const redacted = scramble({
+    firstName: "Peter",
+    lastName: "Vermeulen",
+    age: 34,
+    details: {
+        phone: "...",
+        email: "...",
+        isActive: true,
+        password: "...",
+    },
+    meta: {
+        phone: "...",
+    },
+}, ["age", "*.phone", "*.email", "*.password"]);
+/**
+Redacted here will be:
+{
+    firstName: "Peter",
+    lastName: "Vermeulen",
+    age: "***",
+    details: {phone: "***", email: "***", isActive: true, password: "***"},
+    meta: {phone: "***"}
+}
+*/
+```
+
 ### object/merge(target:Object={},obj:Object|Object[]={}, opts?:{union?:boolean})
 Merges two objects together, with the preference over the second object.
 ```typescript

package/cjs/formdata/toObject.js

@@ -6,7 +6,7 @@ const isFormat_1 = require("../date/isFormat");
 const RGX_TOKENS = /[^.[\]]+/g;
 function assign(acc, rawkey, value, single) {
     let cursor = acc;
-    const keys = rawkey.match(RGX_TOKENS) || [];
+    const keys = rawkey.match(RGX_TOKENS);
     const keys_len = keys.length;
     for (let i = 0; i < keys_len; i++) {
         const key = keys[i];

package/cjs/object/omit.js

@@ -2,32 +2,84 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.omit = omit;
 exports.default = omit;
-function innerOmit(obj, keys) {
-    const result = { ...obj };
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        if (typeof key !== 'string')
-            continue;
-        let target = result;
-        const parts = key.split('.');
-        const last = parts.length - 1;
-        for (let j = 0; j < last; j++) {
-            const part = parts[j];
-            const val = target[part];
-            if (Object.prototype.toString.call(val) === '[object Object]') {
-                if (target[part] === obj[part]) {
-                    target[part] = { ...val };
+function wildcardProp(target, source, prop) {
+    if (Array.isArray(target)) {
+        for (let i = 0; i < target.length; i++) {
+            const t = target[i];
+            const s = source[i];
+            if (typeof t === 'object' && t !== null && typeof s === 'object' && s !== null) {
+                if (t === s)
+                    target[i] = { ...t };
+                wildcardProp(target[i], s, prop);
+            }
+        }
+    }
+    else if (Object.prototype.toString.call(target) === '[object Object]') {
+        for (const key in target) {
+            if (key === prop && key in source) {
+                delete target[key];
+            }
+            else {
+                const val = target[key];
+                const s_val = source?.[key];
+                if (typeof val === 'object' && typeof s_val === 'object' && val !== null && s_val !== null) {
+                    if (val === s_val) {
+                        target[key] = Array.isArray(val) ? [...val] : { ...val };
+                    }
+                    wildcardProp(target[key], s_val, prop);
                 }
-                target = target[part];
             }
         }
-        delete target[parts[last]];
     }
-    return result;
+}
+function standardProp(target, source, path) {
+    const last = path.length - 1;
+    for (let i = 0; i < last; i++) {
+        const key = path[i];
+        const val = target[key];
+        const src_val = source?.[key];
+        if (Array.isArray(val)) {
+            target[key] = val.map((item, idx) => {
+                const src_item = src_val[idx];
+                if (Object.prototype.toString.call(item) === '[object Object]') {
+                    const clone = { ...item };
+                    standardProp(clone, src_item, path.slice(i + 1));
+                    return clone;
+                }
+                return item;
+            });
+            return;
+        }
+        if (Object.prototype.toString.call(val) === '[object Object]') {
+            if (val === src_val) {
+                target[key] = { ...val };
+            }
+            target = target[key];
+            source = src_val;
+        }
+        else {
+            return;
+        }
+    }
+    if (target && typeof target === 'object' && path[last] in source) {
+        delete target[path[last]];
+    }
 }
 function omit(obj, keys) {
     if (Object.prototype.toString.call(obj) !== '[object Object]' ||
         !Array.isArray(keys))
         throw new TypeError('Please pass an object to omit from and a keys array');
-    return innerOmit(obj, keys);
+    const result = { ...obj };
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        if (typeof key === 'string') {
+            if (key.length > 2 && key[0] === '*' && key[1] === '.') {
+                wildcardProp(result, obj, key.slice(2));
+            }
+            else {
+                standardProp(result, obj, key.split('.'));
+            }
+        }
+    }
+    return result;
 }

package/cjs/object/scramble.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function wildcardProp(target, source, prop, repl) {
+    if (Array.isArray(target)) {
+        for (let i = 0; i < target.length; i++) {
+            const t = target[i];
+            const s = source[i];
+            if (typeof t === 'object' && t !== null && typeof s === 'object' && s !== null) {
+                if (t === s)
+                    target[i] = { ...t };
+                wildcardProp(target[i], s, prop, repl);
+            }
+        }
+    }
+    else if (Object.prototype.toString.call(target) === '[object Object]') {
+        for (const key in target) {
+            if (key === prop && key in source) {
+                target[key] = repl;
+            }
+            else {
+                const val = target[key];
+                const s_val = source?.[key];
+                if (typeof val === 'object' && typeof s_val === 'object' && val !== null && s_val !== null) {
+                    if (val === s_val) {
+                        target[key] = Array.isArray(val) ? [...val] : { ...val };
+                    }
+                    wildcardProp(target[key], s_val, prop, repl);
+                }
+            }
+        }
+    }
+}
+function standardProp(target, source, path, repl) {
+    const last = path.length - 1;
+    for (let i = 0; i < last; i++) {
+        const key = path[i];
+        const val = target[key];
+        const src_val = source?.[key];
+        if (Array.isArray(val)) {
+            target[key] = val.map((item, idx) => {
+                const src_item = src_val[idx];
+                if (Object.prototype.toString.call(item) === '[object Object]') {
+                    const clone = { ...item };
+                    standardProp(clone, src_item, path.slice(i + 1), repl);
+                    return clone;
+                }
+                return item;
+            });
+            return;
+        }
+        else if (Object.prototype.toString.call(val) === '[object Object]') {
+            if (val === src_val) {
+                target[key] = { ...val };
+            }
+            target = target[key];
+            source = src_val;
+        }
+        else {
+            return;
+        }
+    }
+    if (target && typeof target === 'object' && path[last] in source) {
+        target[path[last]] = repl;
+    }
+}
+function scramble(obj, keys, options) {
+    if (Object.prototype.toString.call(obj) !== '[object Object]' ||
+        !Array.isArray(keys))
+        throw new TypeError('Please pass an object to scramble and a keys array');
+    const repl = typeof options?.replacement === 'string' ? options.replacement : '***';
+    const result = { ...obj };
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        if (typeof key === 'string') {
+            if (key.length > 2 && key[0] === '*' && key[1] === '.') {
+                wildcardProp(result, obj, key.slice(2), repl);
+            }
+            else {
+                standardProp(result, obj, key.split('.'), repl);
+            }
+        }
+    }
+    return result;
+}
+exports.default = scramble;

package/cjs/object/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/esm/formdata/toObject.js

@@ -2,7 +2,7 @@ import { isDateFormat } from '../date/isFormat';
 const RGX_TOKENS = /[^.[\]]+/g;
 function assign(acc, rawkey, value, single) {
     let cursor = acc;
-    const keys = rawkey.match(RGX_TOKENS) || [];
+    const keys = rawkey.match(RGX_TOKENS);
     const keys_len = keys.length;
     for (let i = 0; i < keys_len; i++) {
         const key = keys[i];

package/esm/object/omit.js

@@ -1,30 +1,82 @@
-function innerOmit(obj, keys) {
-    const result = { ...obj };
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        if (typeof key !== 'string')
-            continue;
-        let target = result;
-        const parts = key.split('.');
-        const last = parts.length - 1;
-        for (let j = 0; j < last; j++) {
-            const part = parts[j];
-            const val = target[part];
-            if (Object.prototype.toString.call(val) === '[object Object]') {
-                if (target[part] === obj[part]) {
-                    target[part] = { ...val };
+function wildcardProp(target, source, prop) {
+    if (Array.isArray(target)) {
+        for (let i = 0; i < target.length; i++) {
+            const t = target[i];
+            const s = source[i];
+            if (typeof t === 'object' && t !== null && typeof s === 'object' && s !== null) {
+                if (t === s)
+                    target[i] = { ...t };
+                wildcardProp(target[i], s, prop);
+            }
+        }
+    }
+    else if (Object.prototype.toString.call(target) === '[object Object]') {
+        for (const key in target) {
+            if (key === prop && key in source) {
+                delete target[key];
+            }
+            else {
+                const val = target[key];
+                const s_val = source?.[key];
+                if (typeof val === 'object' && typeof s_val === 'object' && val !== null && s_val !== null) {
+                    if (val === s_val) {
+                        target[key] = Array.isArray(val) ? [...val] : { ...val };
+                    }
+                    wildcardProp(target[key], s_val, prop);
                 }
-                target = target[part];
             }
         }
-        delete target[parts[last]];
     }
-    return result;
+}
+function standardProp(target, source, path) {
+    const last = path.length - 1;
+    for (let i = 0; i < last; i++) {
+        const key = path[i];
+        const val = target[key];
+        const src_val = source?.[key];
+        if (Array.isArray(val)) {
+            target[key] = val.map((item, idx) => {
+                const src_item = src_val[idx];
+                if (Object.prototype.toString.call(item) === '[object Object]') {
+                    const clone = { ...item };
+                    standardProp(clone, src_item, path.slice(i + 1));
+                    return clone;
+                }
+                return item;
+            });
+            return;
+        }
+        if (Object.prototype.toString.call(val) === '[object Object]') {
+            if (val === src_val) {
+                target[key] = { ...val };
+            }
+            target = target[key];
+            source = src_val;
+        }
+        else {
+            return;
+        }
+    }
+    if (target && typeof target === 'object' && path[last] in source) {
+        delete target[path[last]];
+    }
 }
 function omit(obj, keys) {
     if (Object.prototype.toString.call(obj) !== '[object Object]' ||
         !Array.isArray(keys))
         throw new TypeError('Please pass an object to omit from and a keys array');
-    return innerOmit(obj, keys);
+    const result = { ...obj };
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        if (typeof key === 'string') {
+            if (key.length > 2 && key[0] === '*' && key[1] === '.') {
+                wildcardProp(result, obj, key.slice(2));
+            }
+            else {
+                standardProp(result, obj, key.split('.'));
+            }
+        }
+    }
+    return result;
 }
 export { omit, omit as default };

package/esm/object/scramble.js

@@ -0,0 +1,83 @@
+function wildcardProp(target, source, prop, repl) {
+    if (Array.isArray(target)) {
+        for (let i = 0; i < target.length; i++) {
+            const t = target[i];
+            const s = source[i];
+            if (typeof t === 'object' && t !== null && typeof s === 'object' && s !== null) {
+                if (t === s)
+                    target[i] = { ...t };
+                wildcardProp(target[i], s, prop, repl);
+            }
+        }
+    }
+    else if (Object.prototype.toString.call(target) === '[object Object]') {
+        for (const key in target) {
+            if (key === prop && key in source) {
+                target[key] = repl;
+            }
+            else {
+                const val = target[key];
+                const s_val = source?.[key];
+                if (typeof val === 'object' && typeof s_val === 'object' && val !== null && s_val !== null) {
+                    if (val === s_val) {
+                        target[key] = Array.isArray(val) ? [...val] : { ...val };
+                    }
+                    wildcardProp(target[key], s_val, prop, repl);
+                }
+            }
+        }
+    }
+}
+function standardProp(target, source, path, repl) {
+    const last = path.length - 1;
+    for (let i = 0; i < last; i++) {
+        const key = path[i];
+        const val = target[key];
+        const src_val = source?.[key];
+        if (Array.isArray(val)) {
+            target[key] = val.map((item, idx) => {
+                const src_item = src_val[idx];
+                if (Object.prototype.toString.call(item) === '[object Object]') {
+                    const clone = { ...item };
+                    standardProp(clone, src_item, path.slice(i + 1), repl);
+                    return clone;
+                }
+                return item;
+            });
+            return;
+        }
+        else if (Object.prototype.toString.call(val) === '[object Object]') {
+            if (val === src_val) {
+                target[key] = { ...val };
+            }
+            target = target[key];
+            source = src_val;
+        }
+        else {
+            return;
+        }
+    }
+    if (target && typeof target === 'object' && path[last] in source) {
+        target[path[last]] = repl;
+    }
+}
+function scramble(obj, keys, options) {
+    if (Object.prototype.toString.call(obj) !== '[object Object]' ||
+        !Array.isArray(keys))
+        throw new TypeError('Please pass an object to scramble and a keys array');
+    const repl = typeof options?.replacement === 'string' ? options.replacement : '***';
+    const result = { ...obj };
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        if (typeof key === 'string') {
+            if (key.length > 2 && key[0] === '*' && key[1] === '.') {
+                wildcardProp(result, obj, key.slice(2), repl);
+            }
+            else {
+                standardProp(result, obj, key.split('.'), repl);
+            }
+        }
+    }
+    return result;
+}
+export default scramble;

package/esm/object/types.js

@@ -0,0 +1 @@
+export {};

package/index.d.ts

@@ -379,13 +379,25 @@ declare module "deep/get" {
     function deepGet<T extends ObjectType | ArrayType, P extends string>(obj: T, path: P, get_parent?: boolean): DeepGetResult<T, P> | undefined;
     export { deepGet, deepGet as default };
 }
+declare module "object/types" {
+    export type DottedKeys<T> = (T extends Record<string, any> ? {
+        [K in keyof T & string]: T[K] extends Record<string, any> ? K | `${K}.${DottedKeys<T[K]>}` : K;
+    }[keyof T & string] : string) & string;
+    export type DottedKeysWithArray<T> = (T extends Record<string, any> ? {
+        [K in keyof T & string]: T[K] extends (infer U)[] ? U extends Record<string, any> ? K | `${K}.${DottedKeysWithArray<U>}` : K : T[K] extends Record<string, any> ? K | `${K}.${DottedKeysWithArray<T[K]>}` : K;
+    }[keyof T & string] : string) & string;
+    export type ExpandWildcard<T, P extends string> = P extends `*.${infer Key}` ? {
+        [K in keyof T]: T[K] extends Record<string, any> ? `${K & string}.${Key}` : never;
+    }[keyof T] : P;
+    export type ExpandWildcardWithArray<T, P extends string> = P extends `*.${infer Key}` ? {
+        [K in keyof T]: T[K] extends (infer U)[] ? U extends Record<string, any> ? `${K & string}.${Key}` : never : T[K] extends Record<string, any> ? `${K & string}.${Key}` : never;
+    }[keyof T] : P;
+}
 declare module "object/pick" {
+    import { type DottedKeys } from "object/types";
     type ObjectType = {
         [key: string]: any;
     };
-    type DottedKeys<T> = (T extends ObjectType ? {
-        [K in keyof T & string]: T[K] extends ObjectType ? K | `${K}.${DottedKeys<T[K]>}` : K;
-    }[keyof T & string] : string) & string;
     type PickFromObject<T, K extends string> = K extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? T[Key] extends ObjectType ? {
         [P in Key]: PickFromObject<T[Key], Rest>;
     } : object : object : K extends keyof T ? {
@@ -396,16 +408,11 @@ declare module "object/pick" {
     export { pick, pick as default };
 }
 declare module "object/omit" {
-    type ObjectType = {
-        [key: string]: any;
-    };
-    type DottedKeys<T> = (T extends ObjectType ? {
-        [K in keyof T & string]: T[K] extends ObjectType ? K | `${K}.${DottedKeys<T[K]>}` : K;
-    }[keyof T & string] : string) & string;
-    type OmitFromObject<T, K extends string> = K extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? T[Key] extends ObjectType ? {
+    import { type DottedKeysWithArray, type ExpandWildcardWithArray } from "object/types";
+    type OmitFromObject<T, K extends string> = T extends (infer U)[] ? OmitFromObject<U, K>[] : T extends Record<string, any> ? K extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? T[Key] extends Record<string, any> | any[] ? {
         [P in keyof T]: P extends Key ? OmitFromObject<T[Key], Rest> : T[P];
-    } : T : T : Omit<T, K>;
-    function omit<T extends Record<string, any>, K extends readonly DottedKeys<T>[]>(obj: T, keys: K): OmitFromObject<T, K[number]>;
+    } : T : T : Omit<T, K> : T;
+    function omit<T extends Record<string, any>, K extends readonly (DottedKeysWithArray<T> | `*.${string}`)[]>(obj: T, keys: K): OmitFromObject<T, ExpandWildcardWithArray<T, K[number]>>;
     export { omit, omit as default };
 }
 declare module "object/index" {
@@ -777,3 +784,10 @@ declare module "modules/index" {
     export { PubSub } from "modules/PubSub";
     export { Scheduler } from "modules/Scheduler";
 }
+declare module "object/scramble" {
+    import { type DottedKeysWithArray } from "object/types";
+    function scramble<T extends Record<string, any>, K extends readonly (DottedKeysWithArray<T> | `*.${string}`)[]>(obj: T, keys: K, options?: {
+        replacement?: string;
+    }): T;
+    export default scramble;
+}

package/object/omit.d.ts

@@ -1,17 +1,16 @@
-type ObjectType = {
-    [key: string]: any;
-};
-type DottedKeys<T> = (T extends ObjectType ? {
-    [K in keyof T & string]: T[K] extends ObjectType ? K | `${K}.${DottedKeys<T[K]>}` : K;
-}[keyof T & string] : string) & string;
-type OmitFromObject<T, K extends string> = K extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? T[Key] extends ObjectType ? {
+import { type DottedKeysWithArray, type ExpandWildcardWithArray } from './types';
+type OmitFromObject<T, K extends string> = T extends (infer U)[] ? OmitFromObject<U, K>[] : T extends Record<string, any> ? K extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? T[Key] extends Record<string, any> | any[] ? {
     [P in keyof T]: P extends Key ? OmitFromObject<T[Key], Rest> : T[P];
-} : T : T : Omit<T, K>;
+} : T : T : Omit<T, K> : T;
 /**
- * Returns a new object with the keys omitted from the passed object, handling nested keys recursively
+ * Returns a new object with the provided keys omitted
+ * Supports:
+ * - omitting keys in nested arrays
+ * - omitting wildcard patterns: '*.password'
+ * - omitting standard keys
  *
  * @param {Record<string, any>} obj - Object to omit from
  * @param {string[]} keys - Array of keys to omit from object
  */
-declare function omit<T extends Record<string, any>, K extends readonly DottedKeys<T>[]>(obj: T, keys: K): OmitFromObject<T, K[number]>;
+declare function omit<T extends Record<string, any>, K extends readonly (DottedKeysWithArray<T> | `*.${string}`)[]>(obj: T, keys: K): OmitFromObject<T, ExpandWildcardWithArray<T, K[number]>>;
 export { omit, omit as default };

package/object/pick.d.ts

@@ -1,9 +1,7 @@
+import { type DottedKeys } from './types';
 type ObjectType = {
     [key: string]: any;
 };
-type DottedKeys<T> = (T extends ObjectType ? {
-    [K in keyof T & string]: T[K] extends ObjectType ? K | `${K}.${DottedKeys<T[K]>}` : K;
-}[keyof T & string] : string) & string;
 type PickFromObject<T, K extends string> = K extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? T[Key] extends ObjectType ? {
     [P in Key]: PickFromObject<T[Key], Rest>;
 } : object : object : K extends keyof T ? {

package/object/scramble.d.ts

@@ -0,0 +1,15 @@
+import { type DottedKeysWithArray } from './types';
+/**
+ * Returns a new object with the provided keys obfuscated
+ * Supports:
+ * - scrambling keys in nested arrays
+ * - scrambling wildcard patterns: '*.password'
+ * - scrambling standard keys
+ *
+ * @param {Record<string, any>} obj - Object to omit from
+ * @param {string[]} keys - Array of keys to omit from object
+ */
+declare function scramble<T extends Record<string, any>, K extends readonly (DottedKeysWithArray<T> | `*.${string}`)[]>(obj: T, keys: K, options?: {
+    replacement?: string;
+}): T;
+export default scramble;

package/object/types.d.ts

@@ -0,0 +1,12 @@
+export type DottedKeys<T> = (T extends Record<string, any> ? {
+    [K in keyof T & string]: T[K] extends Record<string, any> ? K | `${K}.${DottedKeys<T[K]>}` : K;
+}[keyof T & string] : string) & string;
+export type DottedKeysWithArray<T> = (T extends Record<string, any> ? {
+    [K in keyof T & string]: T[K] extends (infer U)[] ? U extends Record<string, any> ? K | `${K}.${DottedKeysWithArray<U>}` : K : T[K] extends Record<string, any> ? K | `${K}.${DottedKeysWithArray<T[K]>}` : K;
+}[keyof T & string] : string) & string;
+export type ExpandWildcard<T, P extends string> = P extends `*.${infer Key}` ? {
+    [K in keyof T]: T[K] extends Record<string, any> ? `${K & string}.${Key}` : never;
+}[keyof T] : P;
+export type ExpandWildcardWithArray<T, P extends string> = P extends `*.${infer Key}` ? {
+    [K in keyof T]: T[K] extends (infer U)[] ? U extends Record<string, any> ? `${K & string}.${Key}` : never : T[K] extends Record<string, any> ? `${K & string}.${Key}` : never;
+}[keyof T] : P;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@valkyriestudios/utils",
-    "version": "12.40.0",
+    "version": "12.41.0",
     "description": "A collection of single-function utilities for common tasks",
     "author": {
         "name": "Peter Vermeulen",
@@ -457,6 +457,11 @@
             "import": "./esm/object/pick.js",
             "require": "./cjs/object/pick.js"
         },
+        "./object/scramble": {
+            "types": "./object/scramble.d.ts",
+            "import": "./esm/object/scramble.js",
+            "require": "./cjs/object/scramble.js"
+        },
         "./regexp": {
             "types": "./regexp/index.d.ts",
             "import": "./esm/regexp/index.js",
@@ -509,12 +514,12 @@
         }
     },
     "devDependencies": {
-        "@types/node": "^22.15.29",
-        "@vitest/coverage-v8": "^3.2.1",
+        "@types/node": "^22.15.30",
+        "@vitest/coverage-v8": "^3.2.2",
         "esbuild-register": "^3.6.0",
         "eslint": "^9.28.0",
         "typescript": "^5.8.3",
         "typescript-eslint": "^8.33.1",
-        "vitest": "^3.2.1"
+        "vitest": "^3.2.2"
     }
 }