nhb-toolbox 4.14.6 → 4.14.8

package/CHANGELOG.md

@@ -6,9 +6,10 @@ All notable changes to the package will be documented here.
 
 ---
 
-## [4.14.4-6] - 2025-08-13 - 2025-08-14
+## [4.14.4-8] - 2025-08-13 - 2025-08-14
 
 - **Updated** internal logic of `convertStringCase` utility, added new `options` parameter.
+- **Fixed** multiple internal issues and JSDoc; Optimized internal logic.
 
 ## [4.14.1-3] - 2025-08-11 - 2025-08-12
 

package/dist/cjs/string/case.js

@@ -20,7 +20,7 @@ const constants_1 = require("./constants");
  *   - `'Title Case'` → Title Case (e.g., `My Variable Name`)
  *   - `'lowercase'` → all lowercase [ It is recommended to use built-in string method `string.toLowerCase()` ]
  *   - `'UPPERCASE'` → all uppercase [ It is recommended to use built-in string method `string.toUpperCase()` ]
- * @param options - Optional configuration settings.
+ * @param options - Optional configuration options for more control.
  *
  * @returns The converted string, with leading/trailing punctuation preserved.
  *
@@ -92,7 +92,7 @@ function convertStringCase(value, format, options) {
     const core = value
         .replace(/^[^\p{L}\p{N}\s]+|[^\p{L}\p{N}\s]+$/gu, '')
         .trim();
-    const lower = (s) => s.toLowerCase();
+    const lowerCase = (s) => s.toLowerCase();
     const isAcronym = (s) => s.length >= 2 && /^[\p{Lu}]+$/u.test(s);
     const capitalize = (s) => s.length === 0 ?
         ''
@@ -121,49 +121,57 @@ function convertStringCase(value, format, options) {
     const smallSet = new Set(constants_1.LOWERCASE);
     switch (format) {
         case 'camelCase': {
-            const firstToken = tokens[0];
-            const first = lower(firstToken);
-            const rest = tokens
+            const middle = tokens
                 .slice(1)
-                .map((t) => {
-                if (preserveAcronyms && isAcronym(t)) {
-                    return t; // preserve acronym as-is
+                .map((token) => {
+                if (preserveAcronyms && isAcronym(token)) {
+                    return token; // preserve acronym as-is
                 }
-                return capitalize(t);
+                return capitalize(token);
             })
                 .join('');
-            return start.concat(first.concat(rest), end);
+            return start.concat(lowerCase(tokens[0]).concat(middle), end);
         }
         case 'PascalCase': {
             const body = tokens
-                .map((t) => {
-                if (preserveAcronyms && isAcronym(t))
-                    return t;
-                return capitalize(t);
+                .map((token) => {
+                if (preserveAcronyms && isAcronym(token))
+                    return token;
+                return capitalize(token);
             })
                 .join('');
             return start.concat(body, end);
         }
         case 'snake_case': {
-            const body = tokens.map((t) => lower(t)).join('_');
+            const body = tokens.map((token) => lowerCase(token)).join('_');
             return start.concat(body, end);
         }
         case 'kebab-case': {
-            const body = tokens.map((t) => lower(t)).join('-');
+            const body = tokens.map((token) => lowerCase(token)).join('-');
             return start.concat(body, end);
         }
         case 'Title Case': {
             const title = tokens
-                .map((t, i, arr) => {
-                const tlc = t.toLowerCase();
+                .map((token, idx, self) => {
+                const tokenLower = token.toLowerCase();
                 // keep small words lowercase unless first or last
-                if (i !== 0 && i !== arr.length - 1 && smallSet.has(tlc)) {
-                    return tlc;
+                if (idx !== 0 &&
+                    idx !== self.length - 1 &&
+                    smallSet.has(tokenLower)) {
+                    return tokenLower;
                 }
-                if (preserveAcronyms && isAcronym(t)) {
-                    return t;
+                // If preserveAcronyms is enabled, preserve acronym-like subparts inside hyphenated tokens.
+                // Example: "XML-HTTP" -> ["XML","HTTP"] -> preserved -> "XML-HTTP"
+                if (preserveAcronyms && token.includes('-')) {
+                    return token
+                        .split('-')
+                        .map((sub) => isAcronym(sub) ? sub : capitalize(sub))
+                        .join('-');
                 }
-                return capitalize(t);
+                if (preserveAcronyms && isAcronym(token)) {
+                    return token.split('-');
+                }
+                return capitalize(token);
             })
                 .join(' ');
             return start.concat(title, end);

package/dist/dts/string/case.d.ts

@@ -17,7 +17,7 @@ import type { CaseFormat, StringCaseOptions } from './types';
  *   - `'Title Case'` → Title Case (e.g., `My Variable Name`)
  *   - `'lowercase'` → all lowercase [ It is recommended to use built-in string method `string.toLowerCase()` ]
  *   - `'UPPERCASE'` → all uppercase [ It is recommended to use built-in string method `string.toUpperCase()` ]
- * @param options - Optional configuration settings.
+ * @param options - Optional configuration options for more control.
  *
  * @returns The converted string, with leading/trailing punctuation preserved.
  *

package/dist/dts/string/case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"case.d.ts","sourceRoot":"","sources":["../../../src/string/case.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,iBAAiB,GACzB,MAAM,CA2HR"}
+{"version":3,"file":"case.d.ts","sourceRoot":"","sources":["../../../src/string/case.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,iBAAiB,GACzB,MAAM,CAsIR"}

package/dist/dts/string/types.d.ts

@@ -31,7 +31,7 @@ export interface AnagramOptions {
 }
 /** - Case formats for converting a string */
 export type CaseFormat = 'camelCase' | 'snake_case' | 'kebab-case' | 'PascalCase' | 'Title Case' | 'UPPERCASE' | 'lowercase';
-/** * Options for convertStringCase. */
+/** * Options for `convertStringCase`. */
 export interface StringCaseOptions {
     /**
      * Preserve acronym-like tokens (tokens that are ALL UPPERCASE with length >= 2)

package/dist/dts/string/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/string/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IACjC,iGAAiG;IACjG,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qFAAqF;IACrF,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;CACtC;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC9B,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GACnB,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,WAAW,CAAC;AAEf,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IACjC;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC3B,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,IAAI,MAAM,EAAE,GAAG,EAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/string/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IACjC,iGAAiG;IACjG,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qFAAqF;IACrF,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;CACtC;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC9B,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GACnB,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,WAAW,CAAC;AAEf,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IACjC;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC3B,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,IAAI,MAAM,EAAE,GAAG,EAAE,CAAC"}

package/dist/esm/string/case.js

@@ -17,7 +17,7 @@ import { LOWERCASE } from './constants.js';
  *   - `'Title Case'` → Title Case (e.g., `My Variable Name`)
  *   - `'lowercase'` → all lowercase [ It is recommended to use built-in string method `string.toLowerCase()` ]
  *   - `'UPPERCASE'` → all uppercase [ It is recommended to use built-in string method `string.toUpperCase()` ]
- * @param options - Optional configuration settings.
+ * @param options - Optional configuration options for more control.
  *
  * @returns The converted string, with leading/trailing punctuation preserved.
  *
@@ -89,7 +89,7 @@ export function convertStringCase(value, format, options) {
     const core = value
         .replace(/^[^\p{L}\p{N}\s]+|[^\p{L}\p{N}\s]+$/gu, '')
         .trim();
-    const lower = (s) => s.toLowerCase();
+    const lowerCase = (s) => s.toLowerCase();
     const isAcronym = (s) => s.length >= 2 && /^[\p{Lu}]+$/u.test(s);
     const capitalize = (s) => s.length === 0 ?
         ''
@@ -118,49 +118,57 @@ export function convertStringCase(value, format, options) {
     const smallSet = new Set(LOWERCASE);
     switch (format) {
         case 'camelCase': {
-            const firstToken = tokens[0];
-            const first = lower(firstToken);
-            const rest = tokens
+            const middle = tokens
                 .slice(1)
-                .map((t) => {
-                if (preserveAcronyms && isAcronym(t)) {
-                    return t; // preserve acronym as-is
+                .map((token) => {
+                if (preserveAcronyms && isAcronym(token)) {
+                    return token; // preserve acronym as-is
                 }
-                return capitalize(t);
+                return capitalize(token);
             })
                 .join('');
-            return start.concat(first.concat(rest), end);
+            return start.concat(lowerCase(tokens[0]).concat(middle), end);
         }
         case 'PascalCase': {
             const body = tokens
-                .map((t) => {
-                if (preserveAcronyms && isAcronym(t))
-                    return t;
-                return capitalize(t);
+                .map((token) => {
+                if (preserveAcronyms && isAcronym(token))
+                    return token;
+                return capitalize(token);
             })
                 .join('');
             return start.concat(body, end);
         }
         case 'snake_case': {
-            const body = tokens.map((t) => lower(t)).join('_');
+            const body = tokens.map((token) => lowerCase(token)).join('_');
             return start.concat(body, end);
         }
         case 'kebab-case': {
-            const body = tokens.map((t) => lower(t)).join('-');
+            const body = tokens.map((token) => lowerCase(token)).join('-');
             return start.concat(body, end);
         }
         case 'Title Case': {
             const title = tokens
-                .map((t, i, arr) => {
-                const tlc = t.toLowerCase();
+                .map((token, idx, self) => {
+                const tokenLower = token.toLowerCase();
                 // keep small words lowercase unless first or last
-                if (i !== 0 && i !== arr.length - 1 && smallSet.has(tlc)) {
-                    return tlc;
+                if (idx !== 0 &&
+                    idx !== self.length - 1 &&
+                    smallSet.has(tokenLower)) {
+                    return tokenLower;
                 }
-                if (preserveAcronyms && isAcronym(t)) {
-                    return t;
+                // If preserveAcronyms is enabled, preserve acronym-like subparts inside hyphenated tokens.
+                // Example: "XML-HTTP" -> ["XML","HTTP"] -> preserved -> "XML-HTTP"
+                if (preserveAcronyms && token.includes('-')) {
+                    return token
+                        .split('-')
+                        .map((sub) => isAcronym(sub) ? sub : capitalize(sub))
+                        .join('-');
                 }
-                return capitalize(t);
+                if (preserveAcronyms && isAcronym(token)) {
+                    return token.split('-');
+                }
+                return capitalize(token);
             })
                 .join(' ');
             return start.concat(title, end);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.14.6",
+  "version": "4.14.8",
   "description": "A versatile collection of smart, efficient, and reusable utility functions and classes for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",