@ls-stack/utils 3.30.0 → 3.31.0

package/docs/_media/modules.md

@@ -47,6 +47,8 @@
 - [timers](timers.md)
 - [tsResult](tsResult/README.md)
 - [typeGuards](typeGuards.md)
+- [typeUtils](typeUtils/README.md)
+- [typeUtils.typesTest](typeUtils.typesTest.md)
 - [typingFnUtils](typingFnUtils/README.md)
 - [typingTestUtils](typingTestUtils.md)
 - [typingUtils](typingUtils.md)

package/docs/modules.md

@@ -47,6 +47,8 @@
 - [timers](timers.md)
 - [tsResult](tsResult/README.md)
 - [typeGuards](typeGuards.md)
+- [typeUtils](typeUtils/README.md)
+- [typeUtils.typesTest](typeUtils.typesTest.md)
 - [typingFnUtils](typingFnUtils/README.md)
 - [typingTestUtils](typingTestUtils.md)
 - [typingUtils](typingUtils.md)

package/docs/stringUtils/README.md

@@ -76,13 +76,93 @@ joinStrings('a', addBString ? 'b' : null, 'c') // 'ac' if addBString is false, '
 
 ***
 
+### convertToCamelCase()
+
+```ts
+function convertToCamelCase(str): string;
+```
+
+Defined in: [packages/utils/src/stringUtils.ts:72](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L72)
+
+#### Parameters
+
+##### str
+
+`string`
+
+#### Returns
+
+`string`
+
+***
+
+### convertToPascalCase()
+
+```ts
+function convertToPascalCase(str): string;
+```
+
+Defined in: [packages/utils/src/stringUtils.ts:65](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L65)
+
+#### Parameters
+
+##### str
+
+`string`
+
+#### Returns
+
+`string`
+
+***
+
+### convertToSentenceCase()
+
+```ts
+function convertToSentenceCase(str): string;
+```
+
+Defined in: [packages/utils/src/stringUtils.ts:77](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L77)
+
+#### Parameters
+
+##### str
+
+`string`
+
+#### Returns
+
+`string`
+
+***
+
 ### convertToSnakeCase()
 
 ```ts
 function convertToSnakeCase(str): string;
 ```
 
-Defined in: [packages/utils/src/stringUtils.ts:47](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L47)
+Defined in: [packages/utils/src/stringUtils.ts:54](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L54)
+
+#### Parameters
+
+##### str
+
+`string`
+
+#### Returns
+
+`string`
+
+***
+
+### convertToTitleCase()
+
+```ts
+function convertToTitleCase(str): string;
+```
+
+Defined in: [packages/utils/src/stringUtils.ts:85](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L85)
 
 #### Parameters
 
@@ -99,7 +179,7 @@ Defined in: [packages/utils/src/stringUtils.ts:47](https://github.com/lucasols/u
 ### formatNum()
 
 ```ts
-function formatNum(num): string;
+function formatNum(num, maxDecimalsOrOptions): string;
 ```
 
 Defined in: [packages/utils/src/stringUtils.ts:36](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L36)
@@ -110,6 +190,10 @@ Defined in: [packages/utils/src/stringUtils.ts:36](https://github.com/lucasols/u
 
 `number`
 
+##### maxDecimalsOrOptions
+
+`number` | `NumberFormatOptions`
+
 #### Returns
 
 `string`
@@ -122,7 +206,7 @@ Defined in: [packages/utils/src/stringUtils.ts:36](https://github.com/lucasols/u
 function isSnakeCase(str): boolean;
 ```
 
-Defined in: [packages/utils/src/stringUtils.ts:43](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L43)
+Defined in: [packages/utils/src/stringUtils.ts:50](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L50)
 
 #### Parameters
 
@@ -145,7 +229,7 @@ function truncateString(
    ellipsis): string;
 ```
 
-Defined in: [packages/utils/src/stringUtils.ts:54](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L54)
+Defined in: [packages/utils/src/stringUtils.ts:92](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L92)
 
 #### Parameters
 

package/docs/typeUtils/-internal-.md

@@ -0,0 +1,99 @@
+[**@ls-stack/utils**](../README.md)
+
+***
+
+[@ls-stack/utils](../modules.md) / [typeUtils](README.md) / \<internal\>
+
+# \<internal\>
+
+## Type Aliases
+
+### BuildArrayPath\<BasePath\>
+
+```ts
+type BuildArrayPath<BasePath> = BasePath extends "$" ? "[*]" : `${BasePath}[*]`;
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:62](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L62)
+
+#### Type Parameters
+
+##### BasePath
+
+`BasePath` *extends* `string`
+
+***
+
+### BuildPath\<BasePath, Key\>
+
+```ts
+type BuildPath<BasePath, Key> = BasePath extends "$" ? Key extends string | number ? `${Key}` : never : Key extends string | number ? `${BasePath}.${Key}` : never;
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:54](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L54)
+
+#### Type Parameters
+
+##### BasePath
+
+`BasePath` *extends* `string`
+
+##### Key
+
+`Key` *extends* `PropertyKey`
+
+***
+
+### DeepReplaceValueImpl\<T, ReplaceType, NewType, SkipPaths, SkipType, Path\>
+
+```ts
+type DeepReplaceValueImpl<T, ReplaceType, NewType, SkipPaths, SkipType, Path> = SkipPaths extends string ? PathMatches<Path, SkipPaths> extends true ? T : T extends ReplaceType ? T extends SkipType ? T : NewType : T extends readonly infer U[] ? DeepReplaceValueImpl<U, ReplaceType, NewType, SkipPaths, SkipType, BuildArrayPath<Path>>[] : T extends SkipType ? T : T extends Record<string, any> ? { [K in keyof T]: DeepReplaceValueImpl<T[K], ReplaceType, NewType, SkipPaths, SkipType, BuildPath<Path, K>> } : T : T extends ReplaceType ? T extends SkipType ? T : NewType : T extends readonly infer U[] ? DeepReplaceValueImpl<U, ReplaceType, NewType, SkipPaths, SkipType, BuildArrayPath<Path>>[] : T extends SkipType ? T : T extends Record<string, any> ? { [K in keyof T]: DeepReplaceValueImpl<T[K], ReplaceType, NewType, SkipPaths, SkipType, BuildPath<Path, K>> } : T;
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:65](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L65)
+
+#### Type Parameters
+
+##### T
+
+`T`
+
+##### ReplaceType
+
+`ReplaceType`
+
+##### NewType
+
+`NewType`
+
+##### SkipPaths
+
+`SkipPaths` *extends* `string` \| `undefined`
+
+##### SkipType
+
+`SkipType`
+
+##### Path
+
+`Path` *extends* `string` = `"$"`
+
+***
+
+### PathMatches\<CurrentPath, SkipPaths\>
+
+```ts
+type PathMatches<CurrentPath, SkipPaths> = true extends SkipPaths extends any ? CurrentPath extends SkipPaths ? true : SkipPaths extends `${infer Prefix}[*]${infer Suffix}` ? CurrentPath extends `${Prefix}[${string}]${Suffix}` ? true : false : false : false ? true : false;
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:40](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L40)
+
+#### Type Parameters
+
+##### CurrentPath
+
+`CurrentPath` *extends* `string`
+
+##### SkipPaths
+
+`SkipPaths` *extends* `string`

package/docs/typeUtils/README.md

@@ -0,0 +1,177 @@
+[**@ls-stack/utils**](../README.md)
+
+***
+
+[@ls-stack/utils](../modules.md) / typeUtils
+
+# typeUtils
+
+## Modules
+
+- [\<internal\>](-internal-.md)
+
+## Type Aliases
+
+### DeepPrettify\<T\>
+
+```ts
+type DeepPrettify<T> = { [K in keyof T]: T[K] extends Record<string, unknown> ? DeepPrettify<T[K]> : T[K] } & object;
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:25](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L25)
+
+#### Type Parameters
+
+##### T
+
+`T`
+
+***
+
+### DeepReplaceValue\<T, ReplaceType, NewType, SkipPaths, SkipTypes\>
+
+```ts
+type DeepReplaceValue<T, ReplaceType, NewType, SkipPaths, SkipTypes> = DeepReplaceValueImpl<T, ReplaceType, NewType, SkipPaths, SkipTypes>;
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:141](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L141)
+
+Replaces all values that extends `ReplaceType` with `NewType` in a deeply nested object or array.
+
+#### Type Parameters
+
+##### T
+
+`T`
+
+The object or array to replace values in.
+
+##### ReplaceType
+
+`ReplaceType`
+
+The type to replace.
+
+##### NewType
+
+`NewType`
+
+The new type to replace with.
+
+##### SkipPaths
+
+`SkipPaths` *extends* `string` \| `undefined` = `undefined`
+
+The paths to skip in transverse. e.g. 'a.b.c' | 'array[*].b'
+
+##### SkipTypes
+
+`SkipTypes` = [`DefaultSkipTransverseDeepReplace`](#defaultskiptransversedeepreplace)
+
+The types to skip in transverse and replace.
+
+***
+
+### DefaultSkipTransverseDeepReplace
+
+```ts
+type DefaultSkipTransverseDeepReplace = 
+  | Date
+  | RegExp
+  | (...args) => any
+  | Error
+  | Set<any>
+  | Map<any, any>
+  | WeakSet<any>
+| WeakMap<any, any>;
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:30](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L30)
+
+***
+
+### IsAny\<T\>
+
+```ts
+type IsAny<T> = unknown extends T ? [keyof T] extends [never] ? false : true : false;
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:14](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L14)
+
+#### Type Parameters
+
+##### T
+
+`T`
+
+***
+
+### NonPartial\<T\>
+
+```ts
+type NonPartial<T> = { [K in keyof Required<T>]: T[K] };
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:5](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L5)
+
+#### Type Parameters
+
+##### T
+
+`T`
+
+***
+
+### ObjKeysWithValuesOfType\<Obj, ValueType\>
+
+```ts
+type ObjKeysWithValuesOfType<Obj, ValueType> = { [K in keyof Obj]: Obj[K] extends ValueType ? K : never }[keyof Obj];
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:7](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L7)
+
+#### Type Parameters
+
+##### Obj
+
+`Obj` *extends* `Record`\<`PropertyKey`, `unknown`\>
+
+##### ValueType
+
+`ValueType`
+
+***
+
+### PartialRecord\<K, T\>
+
+```ts
+type PartialRecord<K, T> = { [P in K]?: T };
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:1](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L1)
+
+#### Type Parameters
+
+##### K
+
+`K` *extends* keyof `any`
+
+##### T
+
+`T`
+
+***
+
+### Prettify\<T\>
+
+```ts
+type Prettify<T> = { [P in keyof T]: T[P] } & object;
+```
+
+Defined in: [packages/utils/src/typeUtils.ts:21](https://github.com/lucasols/utils/blob/main/packages/utils/src/typeUtils.ts#L21)
+
+#### Type Parameters
+
+##### T
+
+`T` *extends* `Record`\<`string`, `unknown`\>

package/docs/typeUtils.typesTest.md

@@ -0,0 +1,7 @@
+[**@ls-stack/utils**](README.md)
+
+***
+
+[@ls-stack/utils](modules.md) / typeUtils.typesTest
+
+# typeUtils.typesTest

package/docs/typingUtils.md

@@ -8,13 +8,13 @@
 
 ## Type Aliases
 
-### DeepPrettify\<T\>
+### ~~DeepPrettify\<T\>~~
 
 ```ts
 type DeepPrettify<T> = { [K in keyof T]: T[K] extends Record<string, unknown> ? DeepPrettify<T[K]> : T[K] } & object;
 ```
 
-Defined in: [packages/utils/src/typingUtils.ts:25](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L25)
+Defined in: [packages/utils/src/typingUtils.ts:31](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L31)
 
 #### Type Parameters
 
@@ -22,15 +22,19 @@ Defined in: [packages/utils/src/typingUtils.ts:25](https://github.com/lucasols/u
 
 `T`
 
+#### Deprecated
+
+Use `DeepPrettify` from `@ls-stack/utils/typeUtils` instead
+
 ***
 
-### IsAny\<T\>
+### ~~IsAny\<T\>~~
 
 ```ts
 type IsAny<T> = unknown extends T ? [keyof T] extends [never] ? false : true : false;
 ```
 
-Defined in: [packages/utils/src/typingUtils.ts:14](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L14)
+Defined in: [packages/utils/src/typingUtils.ts:18](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L18)
 
 #### Type Parameters
 
@@ -38,15 +42,19 @@ Defined in: [packages/utils/src/typingUtils.ts:14](https://github.com/lucasols/u
 
 `T`
 
+#### Deprecated
+
+Use `IsAny` from `@ls-stack/utils/typeUtils` instead
+
 ***
 
-### NonPartial\<T\>
+### ~~NonPartial\<T\>~~
 
 ```ts
 type NonPartial<T> = { [K in keyof Required<T>]: T[K] };
 ```
 
-Defined in: [packages/utils/src/typingUtils.ts:5](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L5)
+Defined in: [packages/utils/src/typingUtils.ts:7](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L7)
 
 #### Type Parameters
 
@@ -54,15 +62,19 @@ Defined in: [packages/utils/src/typingUtils.ts:5](https://github.com/lucasols/ut
 
 `T`
 
+#### Deprecated
+
+Use `NonPartial` from `@ls-stack/utils/typeUtils` instead
+
 ***
 
-### ObjKeysWithValuesOfType\<Obj, ValueType\>
+### ~~ObjKeysWithValuesOfType\<Obj, ValueType\>~~
 
 ```ts
 type ObjKeysWithValuesOfType<Obj, ValueType> = { [K in keyof Obj]: Obj[K] extends ValueType ? K : never }[keyof Obj];
 ```
 
-Defined in: [packages/utils/src/typingUtils.ts:7](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L7)
+Defined in: [packages/utils/src/typingUtils.ts:10](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L10)
 
 #### Type Parameters
 
@@ -74,15 +86,19 @@ Defined in: [packages/utils/src/typingUtils.ts:7](https://github.com/lucasols/ut
 
 `ValueType`
 
+#### Deprecated
+
+Use `ObjKeysWithValuesOfType` from `@ls-stack/utils/typeUtils` instead
+
 ***
 
-### PartialRecord\<K, T\>
+### ~~PartialRecord\<K, T\>~~
 
 ```ts
 type PartialRecord<K, T> = { [P in K]?: T };
 ```
 
-Defined in: [packages/utils/src/typingUtils.ts:1](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L1)
+Defined in: [packages/utils/src/typingUtils.ts:2](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L2)
 
 #### Type Parameters
 
@@ -94,18 +110,26 @@ Defined in: [packages/utils/src/typingUtils.ts:1](https://github.com/lucasols/ut
 
 `T`
 
+#### Deprecated
+
+Use `PartialRecord` from `@ls-stack/utils/typeUtils` instead
+
 ***
 
-### Prettify\<T\>
+### ~~Prettify\<T\>~~
 
 ```ts
 type Prettify<T> = { [P in keyof T]: T[P] } & object;
 ```
 
-Defined in: [packages/utils/src/typingUtils.ts:21](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L21)
+Defined in: [packages/utils/src/typingUtils.ts:26](https://github.com/lucasols/utils/blob/main/packages/utils/src/typingUtils.ts#L26)
 
 #### Type Parameters
 
 ##### T
 
 `T` *extends* `Record`\<`string`, `unknown`\>
+
+#### Deprecated
+
+Use `DeepPrettify` from `@ls-stack/utils/typeUtils` instead

package/lib/chunk-3LZQMZAS.js

@@ -0,0 +1,57 @@
+// src/stringUtils.ts
+function concatStrings(...args) {
+  const strings = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (!arg) continue;
+    if (Array.isArray(arg)) {
+      strings.push(concatStrings(...arg));
+      continue;
+    }
+    strings.push(arg);
+  }
+  return strings.join("");
+}
+var joinStrings = concatStrings;
+function formatNum(num, maxDecimalsOrOptions = 2) {
+  const options = typeof maxDecimalsOrOptions === "number" ? {
+    maximumFractionDigits: maxDecimalsOrOptions
+  } : maxDecimalsOrOptions;
+  return num.toLocaleString("en-US", options);
+}
+function isSnakeCase(str) {
+  return /^[a-z0-9_]+$/.test(str);
+}
+function convertToSnakeCase(str) {
+  return str.replace(/[\s\-.]+/g, "_").replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/([A-Z])([A-Z][a-z])/g, "$1_$2").toLowerCase().replace(/[^a-z0-9_]/g, "").replace(/^_+|_+$/g, "").replace(/_+/g, "_");
+}
+function convertToPascalCase(str) {
+  return str.split(/[\s_-]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+}
+function convertToCamelCase(str) {
+  const pascalCase = convertToPascalCase(str);
+  return pascalCase.charAt(0).toLowerCase() + pascalCase.slice(1);
+}
+function convertToSentenceCase(str) {
+  return str.split(/[\s_-]+/).map((word) => word.toLowerCase()).join(" ").replace(/^\w/, (char) => char.toUpperCase());
+}
+function convertToTitleCase(str) {
+  return str.split(/[\s_-]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
+}
+function truncateString(str, length, ellipsis = "\u2026") {
+  if (str.length <= length) return str;
+  return str.slice(0, length - 1) + ellipsis;
+}
+
+export {
+  concatStrings,
+  joinStrings,
+  formatNum,
+  isSnakeCase,
+  convertToSnakeCase,
+  convertToPascalCase,
+  convertToCamelCase,
+  convertToSentenceCase,
+  convertToTitleCase,
+  truncateString
+};

package/lib/{chunk-QLD7KG5I.js → chunk-IY3KYH32.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-IATIXMCE.js";
 import {
   truncateString
-} from "./chunk-4REIIZQY.js";
+} from "./chunk-3LZQMZAS.js";
 import {
   isObject,
   isPlainObject

package/lib/concurrentCalls.js

@@ -1,6 +1,6 @@
 import {
   truncateString
-} from "./chunk-4REIIZQY.js";
+} from "./chunk-3LZQMZAS.js";
 import {
   sleep
 } from "./chunk-5DZT3Z5Z.js";

package/lib/stringUtils.cjs

@@ -21,7 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var stringUtils_exports = {};
 __export(stringUtils_exports, {
   concatStrings: () => concatStrings,
+  convertToCamelCase: () => convertToCamelCase,
+  convertToPascalCase: () => convertToPascalCase,
+  convertToSentenceCase: () => convertToSentenceCase,
   convertToSnakeCase: () => convertToSnakeCase,
+  convertToTitleCase: () => convertToTitleCase,
   formatNum: () => formatNum,
   isSnakeCase: () => isSnakeCase,
   joinStrings: () => joinStrings,
@@ -42,17 +46,30 @@ function concatStrings(...args) {
   return strings.join("");
 }
 var joinStrings = concatStrings;
-function formatNum(num) {
-  return num.toLocaleString("en-US", {
-    minimumFractionDigits: 2,
-    maximumFractionDigits: 2
-  });
+function formatNum(num, maxDecimalsOrOptions = 2) {
+  const options = typeof maxDecimalsOrOptions === "number" ? {
+    maximumFractionDigits: maxDecimalsOrOptions
+  } : maxDecimalsOrOptions;
+  return num.toLocaleString("en-US", options);
 }
 function isSnakeCase(str) {
   return /^[a-z0-9_]+$/.test(str);
 }
 function convertToSnakeCase(str) {
-  return str.replace(/([A-Z])/g, "_$1").replace(/[^a-z0-9_]/g, "").toLowerCase();
+  return str.replace(/[\s\-.]+/g, "_").replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/([A-Z])([A-Z][a-z])/g, "$1_$2").toLowerCase().replace(/[^a-z0-9_]/g, "").replace(/^_+|_+$/g, "").replace(/_+/g, "_");
+}
+function convertToPascalCase(str) {
+  return str.split(/[\s_-]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+}
+function convertToCamelCase(str) {
+  const pascalCase = convertToPascalCase(str);
+  return pascalCase.charAt(0).toLowerCase() + pascalCase.slice(1);
+}
+function convertToSentenceCase(str) {
+  return str.split(/[\s_-]+/).map((word) => word.toLowerCase()).join(" ").replace(/^\w/, (char) => char.toUpperCase());
+}
+function convertToTitleCase(str) {
+  return str.split(/[\s_-]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
 }
 function truncateString(str, length, ellipsis = "\u2026") {
   if (str.length <= length) return str;
@@ -61,7 +78,11 @@ function truncateString(str, length, ellipsis = "\u2026") {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   concatStrings,
+  convertToCamelCase,
+  convertToPascalCase,
+  convertToSentenceCase,
   convertToSnakeCase,
+  convertToTitleCase,
   formatNum,
   isSnakeCase,
   joinStrings,

package/lib/stringUtils.d.cts

@@ -13,9 +13,13 @@ declare function concatStrings(...args: (Arg | Arg[])[]): string;
  * @deprecated Use {@link concatStrings} instead
  */
 declare const joinStrings: typeof concatStrings;
-declare function formatNum(num: number): string;
+declare function formatNum(num: number, maxDecimalsOrOptions?: number | Intl.NumberFormatOptions): string;
 declare function isSnakeCase(str: string): boolean;
 declare function convertToSnakeCase(str: string): string;
+declare function convertToPascalCase(str: string): string;
+declare function convertToCamelCase(str: string): string;
+declare function convertToSentenceCase(str: string): string;
+declare function convertToTitleCase(str: string): string;
 declare function truncateString(str: string, length: number, ellipsis?: string): string;
 
-export { concatStrings, convertToSnakeCase, formatNum, isSnakeCase, joinStrings, truncateString };
+export { concatStrings, convertToCamelCase, convertToPascalCase, convertToSentenceCase, convertToSnakeCase, convertToTitleCase, formatNum, isSnakeCase, joinStrings, truncateString };

package/lib/stringUtils.d.ts

@@ -13,9 +13,13 @@ declare function concatStrings(...args: (Arg | Arg[])[]): string;
  * @deprecated Use {@link concatStrings} instead
  */
 declare const joinStrings: typeof concatStrings;
-declare function formatNum(num: number): string;
+declare function formatNum(num: number, maxDecimalsOrOptions?: number | Intl.NumberFormatOptions): string;
 declare function isSnakeCase(str: string): boolean;
 declare function convertToSnakeCase(str: string): string;
+declare function convertToPascalCase(str: string): string;
+declare function convertToCamelCase(str: string): string;
+declare function convertToSentenceCase(str: string): string;
+declare function convertToTitleCase(str: string): string;
 declare function truncateString(str: string, length: number, ellipsis?: string): string;
 
-export { concatStrings, convertToSnakeCase, formatNum, isSnakeCase, joinStrings, truncateString };
+export { concatStrings, convertToCamelCase, convertToPascalCase, convertToSentenceCase, convertToSnakeCase, convertToTitleCase, formatNum, isSnakeCase, joinStrings, truncateString };

package/lib/stringUtils.js

@@ -1,14 +1,22 @@
 import {
   concatStrings,
+  convertToCamelCase,
+  convertToPascalCase,
+  convertToSentenceCase,
   convertToSnakeCase,
+  convertToTitleCase,
   formatNum,
   isSnakeCase,
   joinStrings,
   truncateString
-} from "./chunk-4REIIZQY.js";
+} from "./chunk-3LZQMZAS.js";
 export {
   concatStrings,
+  convertToCamelCase,
+  convertToPascalCase,
+  convertToSentenceCase,
   convertToSnakeCase,
+  convertToTitleCase,
   formatNum,
   isSnakeCase,
   joinStrings,

package/lib/testUtils.js

@@ -1,6 +1,6 @@
 import {
   yamlStringify
-} from "./chunk-QLD7KG5I.js";
+} from "./chunk-IY3KYH32.js";
 import {
   omit,
   pick
@@ -18,7 +18,7 @@ import {
 import {
   clampMin
 } from "./chunk-HTCYUMDR.js";
-import "./chunk-4REIIZQY.js";
+import "./chunk-3LZQMZAS.js";
 import {
   arrayWithPrevAndIndex,
   filterAndMap

package/lib/typeUtils.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/typeUtils.ts
+var typeUtils_exports = {};
+module.exports = __toCommonJS(typeUtils_exports);

package/lib/typeUtils.d.cts

@@ -0,0 +1,39 @@
+type PartialRecord<K extends keyof any, T> = {
+    [P in K]?: T;
+};
+type NonPartial<T> = {
+    [K in keyof Required<T>]: T[K];
+};
+type ObjKeysWithValuesOfType<Obj extends Record<PropertyKey, unknown>, ValueType> = {
+    [K in keyof Obj]: Obj[K] extends ValueType ? K : never;
+}[keyof Obj];
+type IsAny<T> = unknown extends T ? [
+    keyof T
+] extends [never] ? false : true : false;
+type Prettify<T extends Record<string, unknown>> = {
+    [P in keyof T]: T[P];
+} & {};
+type DeepPrettify<T> = {
+    [K in keyof T]: T[K] extends Record<string, unknown> ? DeepPrettify<T[K]> : T[K];
+} & {};
+type DefaultSkipTransverseDeepReplace = Date | RegExp | ((...args: any[]) => any) | Error | Set<any> | Map<any, any> | WeakSet<any> | WeakMap<any, any>;
+type PathMatches<CurrentPath extends string, SkipPaths extends string> = true extends (SkipPaths extends any ? CurrentPath extends SkipPaths ? true : SkipPaths extends `${infer Prefix}[*]${infer Suffix}` ? CurrentPath extends `${Prefix}[${string}]${Suffix}` ? true : false : false : false) ? true : false;
+type BuildPath<BasePath extends string, Key extends PropertyKey> = BasePath extends '$' ? Key extends string | number ? `${Key}` : never : Key extends string | number ? `${BasePath}.${Key}` : never;
+type BuildArrayPath<BasePath extends string> = BasePath extends '$' ? '[*]' : `${BasePath}[*]`;
+type DeepReplaceValueImpl<T, ReplaceType, NewType, SkipPaths extends string | undefined, SkipType, Path extends string = '$'> = SkipPaths extends string ? PathMatches<Path, SkipPaths> extends true ? T : T extends ReplaceType ? T extends SkipType ? T : NewType : T extends readonly (infer U)[] ? Array<DeepReplaceValueImpl<U, ReplaceType, NewType, SkipPaths, SkipType, BuildArrayPath<Path>>> : T extends SkipType ? T : T extends Record<string, any> ? {
+    [K in keyof T]: DeepReplaceValueImpl<T[K], ReplaceType, NewType, SkipPaths, SkipType, BuildPath<Path, K>>;
+} : T : T extends ReplaceType ? T extends SkipType ? T : NewType : T extends readonly (infer U)[] ? Array<DeepReplaceValueImpl<U, ReplaceType, NewType, SkipPaths, SkipType, BuildArrayPath<Path>>> : T extends SkipType ? T : T extends Record<string, any> ? {
+    [K in keyof T]: DeepReplaceValueImpl<T[K], ReplaceType, NewType, SkipPaths, SkipType, BuildPath<Path, K>>;
+} : T;
+/**
+ * Replaces all values that extends `ReplaceType` with `NewType` in a deeply nested object or array.
+ *
+ * @template T - The object or array to replace values in.
+ * @template ReplaceType - The type to replace.
+ * @template NewType - The new type to replace with.
+ * @template SkipPaths - The paths to skip in transverse. e.g. 'a.b.c' | 'array[*].b'
+ * @template SkipTypes - The types to skip in transverse and replace.
+ */
+type DeepReplaceValue<T, ReplaceType, NewType, SkipPaths extends string | undefined = undefined, SkipTypes = DefaultSkipTransverseDeepReplace> = DeepReplaceValueImpl<T, ReplaceType, NewType, SkipPaths, SkipTypes>;
+
+export type { DeepPrettify, DeepReplaceValue, DefaultSkipTransverseDeepReplace, IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord, Prettify };

package/lib/typeUtils.d.ts

@@ -0,0 +1,39 @@
+type PartialRecord<K extends keyof any, T> = {
+    [P in K]?: T;
+};
+type NonPartial<T> = {
+    [K in keyof Required<T>]: T[K];
+};
+type ObjKeysWithValuesOfType<Obj extends Record<PropertyKey, unknown>, ValueType> = {
+    [K in keyof Obj]: Obj[K] extends ValueType ? K : never;
+}[keyof Obj];
+type IsAny<T> = unknown extends T ? [
+    keyof T
+] extends [never] ? false : true : false;
+type Prettify<T extends Record<string, unknown>> = {
+    [P in keyof T]: T[P];
+} & {};
+type DeepPrettify<T> = {
+    [K in keyof T]: T[K] extends Record<string, unknown> ? DeepPrettify<T[K]> : T[K];
+} & {};
+type DefaultSkipTransverseDeepReplace = Date | RegExp | ((...args: any[]) => any) | Error | Set<any> | Map<any, any> | WeakSet<any> | WeakMap<any, any>;
+type PathMatches<CurrentPath extends string, SkipPaths extends string> = true extends (SkipPaths extends any ? CurrentPath extends SkipPaths ? true : SkipPaths extends `${infer Prefix}[*]${infer Suffix}` ? CurrentPath extends `${Prefix}[${string}]${Suffix}` ? true : false : false : false) ? true : false;
+type BuildPath<BasePath extends string, Key extends PropertyKey> = BasePath extends '$' ? Key extends string | number ? `${Key}` : never : Key extends string | number ? `${BasePath}.${Key}` : never;
+type BuildArrayPath<BasePath extends string> = BasePath extends '$' ? '[*]' : `${BasePath}[*]`;
+type DeepReplaceValueImpl<T, ReplaceType, NewType, SkipPaths extends string | undefined, SkipType, Path extends string = '$'> = SkipPaths extends string ? PathMatches<Path, SkipPaths> extends true ? T : T extends ReplaceType ? T extends SkipType ? T : NewType : T extends readonly (infer U)[] ? Array<DeepReplaceValueImpl<U, ReplaceType, NewType, SkipPaths, SkipType, BuildArrayPath<Path>>> : T extends SkipType ? T : T extends Record<string, any> ? {
+    [K in keyof T]: DeepReplaceValueImpl<T[K], ReplaceType, NewType, SkipPaths, SkipType, BuildPath<Path, K>>;
+} : T : T extends ReplaceType ? T extends SkipType ? T : NewType : T extends readonly (infer U)[] ? Array<DeepReplaceValueImpl<U, ReplaceType, NewType, SkipPaths, SkipType, BuildArrayPath<Path>>> : T extends SkipType ? T : T extends Record<string, any> ? {
+    [K in keyof T]: DeepReplaceValueImpl<T[K], ReplaceType, NewType, SkipPaths, SkipType, BuildPath<Path, K>>;
+} : T;
+/**
+ * Replaces all values that extends `ReplaceType` with `NewType` in a deeply nested object or array.
+ *
+ * @template T - The object or array to replace values in.
+ * @template ReplaceType - The type to replace.
+ * @template NewType - The new type to replace with.
+ * @template SkipPaths - The paths to skip in transverse. e.g. 'a.b.c' | 'array[*].b'
+ * @template SkipTypes - The types to skip in transverse and replace.
+ */
+type DeepReplaceValue<T, ReplaceType, NewType, SkipPaths extends string | undefined = undefined, SkipTypes = DefaultSkipTransverseDeepReplace> = DeepReplaceValueImpl<T, ReplaceType, NewType, SkipPaths, SkipTypes>;
+
+export type { DeepPrettify, DeepReplaceValue, DefaultSkipTransverseDeepReplace, IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord, Prettify };

package/lib/typingUtils.d.cts

@@ -1,18 +1,24 @@
+/** @deprecated Use `PartialRecord` from `@ls-stack/utils/typeUtils` instead */
 type PartialRecord<K extends keyof any, T> = {
     [P in K]?: T;
 };
+/** @deprecated Use `NonPartial` from `@ls-stack/utils/typeUtils` instead */
 type NonPartial<T> = {
     [K in keyof Required<T>]: T[K];
 };
+/** @deprecated Use `ObjKeysWithValuesOfType` from `@ls-stack/utils/typeUtils` instead */
 type ObjKeysWithValuesOfType<Obj extends Record<PropertyKey, unknown>, ValueType> = {
     [K in keyof Obj]: Obj[K] extends ValueType ? K : never;
 }[keyof Obj];
+/** @deprecated Use `IsAny` from `@ls-stack/utils/typeUtils` instead */
 type IsAny<T> = unknown extends T ? [
     keyof T
 ] extends [never] ? false : true : false;
+/** @deprecated Use `DeepPrettify` from `@ls-stack/utils/typeUtils` instead */
 type Prettify<T extends Record<string, unknown>> = {
     [P in keyof T]: T[P];
 } & {};
+/** @deprecated Use `DeepPrettify` from `@ls-stack/utils/typeUtils` instead */
 type DeepPrettify<T> = {
     [K in keyof T]: T[K] extends Record<string, unknown> ? DeepPrettify<T[K]> : T[K];
 } & {};

package/lib/typingUtils.d.ts

@@ -1,18 +1,24 @@
+/** @deprecated Use `PartialRecord` from `@ls-stack/utils/typeUtils` instead */
 type PartialRecord<K extends keyof any, T> = {
     [P in K]?: T;
 };
+/** @deprecated Use `NonPartial` from `@ls-stack/utils/typeUtils` instead */
 type NonPartial<T> = {
     [K in keyof Required<T>]: T[K];
 };
+/** @deprecated Use `ObjKeysWithValuesOfType` from `@ls-stack/utils/typeUtils` instead */
 type ObjKeysWithValuesOfType<Obj extends Record<PropertyKey, unknown>, ValueType> = {
     [K in keyof Obj]: Obj[K] extends ValueType ? K : never;
 }[keyof Obj];
+/** @deprecated Use `IsAny` from `@ls-stack/utils/typeUtils` instead */
 type IsAny<T> = unknown extends T ? [
     keyof T
 ] extends [never] ? false : true : false;
+/** @deprecated Use `DeepPrettify` from `@ls-stack/utils/typeUtils` instead */
 type Prettify<T extends Record<string, unknown>> = {
     [P in keyof T]: T[P];
 } & {};
+/** @deprecated Use `DeepPrettify` from `@ls-stack/utils/typeUtils` instead */
 type DeepPrettify<T> = {
     [K in keyof T]: T[K] extends Record<string, unknown> ? DeepPrettify<T[K]> : T[K];
 } & {};

package/lib/yamlStringify.js

@@ -1,8 +1,8 @@
 import {
   yamlStringify
-} from "./chunk-QLD7KG5I.js";
+} from "./chunk-IY3KYH32.js";
 import "./chunk-IATIXMCE.js";
-import "./chunk-4REIIZQY.js";
+import "./chunk-3LZQMZAS.js";
 import "./chunk-JF2MDHOJ.js";
 export {
   yamlStringify

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Universal TypeScript utilities for browser and Node.js",
-  "version": "3.30.0",
+  "version": "3.31.0",
   "license": "MIT",
   "files": [
     "lib",
@@ -184,6 +184,14 @@
       "import": "./lib/typeGuards.js",
       "require": "./lib/typeGuards.cjs"
     },
+    "./typeUtils": {
+      "import": "./lib/typeUtils.js",
+      "require": "./lib/typeUtils.cjs"
+    },
+    "./typeUtils.typesTest": {
+      "import": "./lib/typeUtils.typesTest.js",
+      "require": "./lib/typeUtils.typesTest.cjs"
+    },
     "./typingFnUtils": {
       "import": "./lib/typingFnUtils.js",
       "require": "./lib/typingFnUtils.cjs"

package/lib/chunk-4REIIZQY.js

@@ -1,40 +0,0 @@
-// src/stringUtils.ts
-function concatStrings(...args) {
-  const strings = [];
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (!arg) continue;
-    if (Array.isArray(arg)) {
-      strings.push(concatStrings(...arg));
-      continue;
-    }
-    strings.push(arg);
-  }
-  return strings.join("");
-}
-var joinStrings = concatStrings;
-function formatNum(num) {
-  return num.toLocaleString("en-US", {
-    minimumFractionDigits: 2,
-    maximumFractionDigits: 2
-  });
-}
-function isSnakeCase(str) {
-  return /^[a-z0-9_]+$/.test(str);
-}
-function convertToSnakeCase(str) {
-  return str.replace(/([A-Z])/g, "_$1").replace(/[^a-z0-9_]/g, "").toLowerCase();
-}
-function truncateString(str, length, ellipsis = "\u2026") {
-  if (str.length <= length) return str;
-  return str.slice(0, length - 1) + ellipsis;
-}
-
-export {
-  concatStrings,
-  joinStrings,
-  formatNum,
-  isSnakeCase,
-  convertToSnakeCase,
-  truncateString
-};