nhb-toolbox 4.30.24 → 4.30.26

package/CHANGELOG.md

@@ -4,6 +4,10 @@
 
 All notable changes to the package will be documented here.
 
+## [4.30.26] - 2026-06-09
+
+- **Fixed** issues with *delimiter normalizer* and *updated return types* for *non-literal strings* in *string case converter* utilities.
+
 ## [4.30.20-24] - 2026-05-26
 
 - **Updated** `isValidUTCOffset`: Strict matching of offset format `+HH:MM` or `-HH:MM` (00-14h, 00/15/30/45m).

package/dist/cjs/string/case.js

@@ -70,11 +70,11 @@ function convertStringCase(value, format, options) {
             return start.concat(body, end);
         }
         case 'snake_case': {
-            const body = tokens.map((token) => lowerCase(token)).join('_');
+            const body = tokens.map(lowerCase).join('_');
             return start.concat(body, end);
         }
         case 'kebab-case': {
-            const body = tokens.map((token) => lowerCase(token)).join('-');
+            const body = tokens.map(lowerCase).join('-');
             return start.concat(body, end);
         }
         case 'Title Case': {
@@ -169,7 +169,7 @@ function _getDelimiterRegex(delims) {
 function _normalizeDelimiters(str, delims) {
     const delRegExp = _getDelimiterRegex(delims);
     return str
-        .replace(/(\p{Ll}?\d+|(?<=\p{Lu}))(\p{Lu})/gu, '$1 $2')
+        .replace(/(\p{Ll}?\d+|(?<=\p{Lu}|\p{Ll}))(\p{Lu})/gu, '$1 $2')
         .replace(delRegExp, ' ')
         .replace(/\s+/g, ' ')
         .trim()

package/dist/dts/guards/specials.d.ts

@@ -72,7 +72,7 @@ export declare function isIPAddress(value: unknown): value is string;
 /**
  * * Type guard to check if the current environment matches a given string.
  * @param env - The expected environment (e.g., "production", "development").
- * @returns `true` if the value is a numeric string parsable by `Number()`, otherwise `false`.
+ * @returns `true` if the value equals to `process.env.NODE_ENV`, otherwise `false`.
  */
 export declare function isEnvironment(env: string): boolean;
 /**

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

@@ -1,4 +1,4 @@
-import type { CamelCase, CapitalizeOptions, CaseFormat, ConstantCase, DotCase, KebabCase, PascalCase, PascalSnakeCase, PathCase, SentenceCase, SnakeCase, StringCaseOptions, TitleCase, TrainCase } from './types';
+import type { $WidenEmpty, CamelCase, CapitalizeOptions, CaseFormat, ConstantCase, DotCase, KebabCase, PascalCase, PascalSnakeCase, PathCase, SentenceCase, SnakeCase, StringCaseOptions, TitleCase, TrainCase } from './types';
 /**
  * * Converts a string to a specified case format with advanced handling for word boundaries, punctuation, acronyms, and Unicode characters.
  *
@@ -83,7 +83,7 @@ export declare function convertStringCase(value: string, format: CaseFormat, opt
  *
  * @param string String to be capitalized.
  * @param options Options to customize the capitalization.
- * @returns Capitalized string or fully uppercased string depending on `capitalizeAll` option.
+ * @returns Capitalized string or fully upper-cased string depending on `capitalizeAll` option.
  */
 export declare function capitalizeString(string: string, options?: CapitalizeOptions): string;
 /**
@@ -106,7 +106,7 @@ export declare function capitalizeString(string: string, options?: CapitalizeOpt
  * @param del Additional delimiter characters to recognize.
  * @returns The `camelCase` formatted string.
  */
-export declare function toCamelCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): CamelCase<Str, Del>;
+export declare function toCamelCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<CamelCase<Str, Del>>;
 /**
  * * Converts a string into `PascalCase`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -127,7 +127,7 @@ export declare function toCamelCase<Str extends string, Del extends string = ''>
  * @param del Additional delimiter characters to recognize.
  * @returns The `PascalCase` formatted string.
  */
-export declare function toPascalCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): PascalCase<Str, Del>;
+export declare function toPascalCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<PascalCase<Str, Del>>;
 /**
  * * Converts a string into `snake_case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -147,7 +147,7 @@ export declare function toPascalCase<Str extends string, Del extends string = ''
  * @param del Additional delimiter characters to recognize.
  * @returns The `snake_case` formatted string.
  */
-export declare function toSnakeCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): SnakeCase<Str, Del>;
+export declare function toSnakeCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<SnakeCase<Str, Del>>;
 /**
  * * Converts a string into `kebab-case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -167,7 +167,7 @@ export declare function toSnakeCase<Str extends string, Del extends string = ''>
  * @param del Additional delimiter characters to recognize.
  * @returns The `kebab-case` formatted string.
  */
-export declare function toKebabCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): KebabCase<Str, Del>;
+export declare function toKebabCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<KebabCase<Str, Del>>;
 /**
  * * Converts a string into `Train-Case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -186,7 +186,7 @@ export declare function toKebabCase<Str extends string, Del extends string = ''>
  * @param del Additional delimiter characters to recognize.
  * @returns The `Train-Case` formatted string.
  */
-export declare function toTrainCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): TrainCase<Str, Del>;
+export declare function toTrainCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<TrainCase<Str, Del>>;
 /**
  * * Converts a string into `dot.case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -205,7 +205,7 @@ export declare function toTrainCase<Str extends string, Del extends string = ''>
  * @param del Additional delimiter characters to recognize.
  * @returns The `dot.case` formatted string.
  */
-export declare function toDotCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): DotCase<Str, Del>;
+export declare function toDotCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<DotCase<Str, Del>>;
 /**
  * * Converts a string into `path/case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -224,7 +224,7 @@ export declare function toDotCase<Str extends string, Del extends string = ''>(s
  * @param del Additional delimiter characters to recognize.
  * @returns The `path/case` formatted string.
  */
-export declare function toPathCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): PathCase<Str, Del>;
+export declare function toPathCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<PathCase<Str, Del>>;
 /**
  * * Converts a string into `CONSTANT_CASE`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -243,7 +243,7 @@ export declare function toPathCase<Str extends string, Del extends string = ''>(
  * @param del Additional delimiter characters to recognize.
  * @returns The `CONSTANT_CASE` formatted string.
  */
-export declare function toConstantCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): ConstantCase<Str, Del>;
+export declare function toConstantCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<ConstantCase<Str, Del>>;
 /**
  * * Converts a string into `Pascal_Snake_Case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -262,7 +262,7 @@ export declare function toConstantCase<Str extends string, Del extends string =
  * @param del Additional delimiter characters to recognize.
  * @returns The `Pascal_Snake_Case` formatted string.
  */
-export declare function toPascalSnakeCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): PascalSnakeCase<Str, Del>;
+export declare function toPascalSnakeCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<PascalSnakeCase<Str, Del>>;
 /**
  * * Converts a string into `Title Case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -283,7 +283,7 @@ export declare function toPascalSnakeCase<Str extends string, Del extends string
  * @param del Additional delimiter characters to recognize.
  * @returns The `Title Case` formatted string.
  */
-export declare function toTitleCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): TitleCase<Str, Del>;
+export declare function toTitleCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<TitleCase<Str, Del>>;
 /**
  * * Converts a string into `Sentence case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -304,4 +304,4 @@ export declare function toTitleCase<Str extends string, Del extends string = ''>
  * @param del Additional delimiter characters to recognize.
  * @returns The `Sentence case` formatted string.
  */
-export declare function toSentenceCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): SentenceCase<Str, Del>;
+export declare function toSentenceCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<SentenceCase<Str, Del>>;

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

@@ -218,6 +218,8 @@ export type SentenceCase<Str extends string, Del extends string = ''> = Split<$N
     infer F extends string,
     ...infer R extends string[]
 ] ? `${Capitalize<Lowercase<F>>} ${Join<$LowercaseWords<R>, ' '>}` : ' ';
+/** Helper type to convert an empty string to `string` while maintaining the literal type otherwise. */
+export type $WidenEmpty<T extends string> = T extends '' ? string : T;
 /** Matches any non-Latin character. */
 export type SpecialCharacter = Lowercase<string> & Uppercase<string>;
 /** Evaluates whether a string consists only of Latin alphabet characters. */

package/dist/esm/string/case.js

@@ -55,11 +55,11 @@ export function convertStringCase(value, format, options) {
             return start.concat(body, end);
         }
         case 'snake_case': {
-            const body = tokens.map((token) => lowerCase(token)).join('_');
+            const body = tokens.map(lowerCase).join('_');
             return start.concat(body, end);
         }
         case 'kebab-case': {
-            const body = tokens.map((token) => lowerCase(token)).join('-');
+            const body = tokens.map(lowerCase).join('-');
             return start.concat(body, end);
         }
         case 'Title Case': {
@@ -154,7 +154,7 @@ function _getDelimiterRegex(delims) {
 function _normalizeDelimiters(str, delims) {
     const delRegExp = _getDelimiterRegex(delims);
     return str
-        .replace(/(\p{Ll}?\d+|(?<=\p{Lu}))(\p{Lu})/gu, '$1 $2')
+        .replace(/(\p{Ll}?\d+|(?<=\p{Lu}|\p{Ll}))(\p{Lu})/gu, '$1 $2')
         .replace(delRegExp, ' ')
         .replace(/\s+/g, ' ')
         .trim()

package/package.json

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