@ls-stack/utils 3.30.1 → 3.31.0

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/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/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.1",
+  "version": "3.31.0",
   "license": "MIT",
   "files": [
     "lib",

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
-};