@salespark/toolkit 2.1.8 → 2.1.10

package/README.md

@@ -26,9 +26,9 @@ npm i @salespark/toolkit
 
 - **Array utilities**: chunk, uniqBy, deep equality, flatten, groupBy, etc.
 - **Object utilities**: pick, omit, clean objects, deep merge, etc.
-- **String utilities**: slugify, template fill, deburr, sanitize, etc.
+- **String utilities**: slugify, template fill, deburr, sanitize, capitalize words/sentences.
 - **Number utilities**: clamp, round, safe arithmetic/comparisons, safe parse (locale-aware), random digits, etc.
-- **Function utilities**: debounce, throttle, formatCurrency, parseName, currency conversions, etc.
+- **Function utilities**: debounce, throttle, safeJSONParse, formatCurrency, parseName, currency conversions, etc.
 - **Boolean utilities**: safe boolean conversion with common representations
 - **Validation utilities**: IBAN validator (ISO 13616), Portuguese tax ID validator
 - **Security utilities**: Markdown XSS protection, content sanitization, risk assessment
@@ -317,6 +317,30 @@ deburr("café résumé naïve");
 // Result: "cafe resume naive"
 ```
 
+**`capitalizeFirst(input: string, options?: { lowerRest?: boolean; locale?: string | string[] }): string`** — Capitalizes only the first character; optionally lowercases the rest.
+
+```javascript
+capitalizeFirst("hELLO world");
+// Result: "Hello world"
+```
+
+**`capitalizeWords(input: string, options?: { lowerRest?: boolean; locale?: string | string[]; treatHyphenAsSeparator?: boolean }): string`** — Capitalizes each word; can treat hyphen as separator.
+
+```javascript
+capitalizeWords("e-mail marketing");
+// Result: "E-mail Marketing"
+
+capitalizeWords("e-mail marketing", { treatHyphenAsSeparator: true });
+// Result: "E-Mail Marketing"
+```
+
+**`sentenceCase(input: string, options?: { lowerRest?: boolean; locale?: string | string[] }): string`** — Capitalizes the start of each sentence (. ! ?); optionally lowercases the rest.
+
+```javascript
+sentenceCase("hello world. this is fine!");
+// Result: "Hello world. This is fine!"
+```
+
 **`sanitize(input: unknown, maxLength?: number): string`** — Sanitizes input by removing dangerous content.
 
 ```javascript
@@ -583,6 +607,19 @@ addThousandsSpace(1234567);
 // Result: "1 234 567"
 ```
 
+**`safeJSONParse<T>(input: unknown, defaultValue: T): T`** — Safely parses a JSON string or returns the object if already parsed. Falls back to default value on failure.
+
+```javascript
+safeJSONParse('{"key": "value"}', {});
+// Result: { key: "value" }
+
+safeJSONParse({ already: "object" }, {});
+// Result: { already: "object" }
+
+safeJSONParse("{invalid}", { fallback: true });
+// Result: { fallback: true }
+```
+
 **`formatCurrency(value: number | string | null | undefined, withoutCurrencySymbol?: boolean, currency?: string, locale?: string): string`** — Formats currency values with configurable currency and locale. Uses modern Intl.NumberFormat with automatic thousands separators, proper decimal handling, and graceful fallback for errors.
 
 ```javascript
@@ -871,5 +908,5 @@ MIT © [SalesPark](https://salespark.io)
 
 ---
 
-_Document version: 10_  
-_Last update: 11-12-2025_
+_Document version: 12_  
+_Last update: 21-12-2025_

package/dist/index.cjs

@@ -211,6 +211,12 @@ function cleanObject(obj, removeEmptyString = false) {
 }
 
 // src/utils/string.ts
+function upper(value, locale) {
+  return locale ? value.toLocaleUpperCase(locale) : value.toUpperCase();
+}
+function lower(value, locale) {
+  return locale ? value.toLocaleLowerCase(locale) : value.toLowerCase();
+}
 function slugify(input) {
   return input.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
@@ -224,6 +230,38 @@ function deburr(str) {
     return str;
   }
 }
+function capitalizeFirst(input, options) {
+  if (typeof input !== "string" || input.length === 0) return "";
+  const { lowerRest = true, locale } = options ?? {};
+  const first = upper(input[0], locale);
+  const rest = lowerRest ? lower(input.slice(1), locale) : input.slice(1);
+  return first + rest;
+}
+function capitalizeWords(input, options) {
+  if (typeof input !== "string" || input.length === 0) return "";
+  const {
+    lowerRest = true,
+    locale,
+    treatHyphenAsSeparator = false
+  } = options ?? {};
+  const wordPattern = treatHyphenAsSeparator ? /[\p{L}\p{N}]+(?:['’][\p{L}\p{N}]+)*/gu : /[\p{L}\p{N}]+(?:['’\-][\p{L}\p{N}]+)*/gu;
+  return input.replace(wordPattern, (word) => {
+    const first = upper(word[0], locale);
+    const rest = lowerRest ? lower(word.slice(1), locale) : word.slice(1);
+    return first + rest;
+  });
+}
+function sentenceCase(input, options) {
+  if (typeof input !== "string" || input.length === 0) return "";
+  const { lowerRest = true, locale } = options ?? {};
+  const base = lowerRest ? lower(input, locale) : input;
+  const sentencePattern = /(^\s*[\p{L}])|([.!?]\s*[\p{L}])/gu;
+  return base.replace(sentencePattern, (match) => {
+    const lastChar = match[match.length - 1];
+    const upperChar = upper(lastChar, locale);
+    return match.slice(0, -1) + upperChar;
+  });
+}
 var removeDiacritics = deburr;
 function sanitize(input, maxLength) {
   if (typeof input !== "string") return "";
@@ -412,6 +450,20 @@ var formatDecimalNumber = (value, decimals = 2) => {
 };
 
 // src/utils/func.ts
+function safeJSONParse(input, defaultValue) {
+  if (typeof input === "object" && input !== null) {
+    return input;
+  }
+  if (typeof input === "string") {
+    try {
+      const parsed = JSON.parse(input);
+      return parsed;
+    } catch {
+      return defaultValue;
+    }
+  }
+  return defaultValue;
+}
 function debounce(fn, wait = 250) {
   let t;
   return function(...args) {
@@ -1702,6 +1754,8 @@ exports.areArraysDeepEqualUnordered = areArraysDeepEqualUnordered;
 exports.areArraysEqual = areArraysEqual;
 exports.assessSecurityRisks = assessSecurityRisks;
 exports.basicSanitize = basicSanitize;
+exports.capitalizeFirst = capitalizeFirst;
+exports.capitalizeWords = capitalizeWords;
 exports.checkMarkdownSecurity = checkMarkdownSecurity;
 exports.chunk = chunk;
 exports.clamp = clamp;
@@ -1763,12 +1817,14 @@ exports.removeDiacritics = removeDiacritics;
 exports.round = round;
 exports.safeAdd = safeAdd;
 exports.safeDivide = safeDivide;
+exports.safeJSONParse = safeJSONParse;
 exports.safeMultiply = safeMultiply;
 exports.safeParseFloat = safeParseFloat;
 exports.safeParseInt = safeParseInt;
 exports.safeSubtract = safeSubtract;
 exports.sanitize = sanitize;
 exports.sanitizeMarkdown = sanitizeMarkdown;
+exports.sentenceCase = sentenceCase;
 exports.shuffle = shuffle;
 exports.slugify = slugify;
 exports.sortBy = sortBy;