nhb-toolbox 4.28.4 → 4.28.6

package/CHANGELOG.md

@@ -6,6 +6,10 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.28.6] - 2025-12-02
+
+- **Updated** *tsdoc* for `stableStringify` + *type augmentation* for `String` methods: `toLowerCase` and `toUpperCase`
+
 ## [4.28.4] - 2025-12-02
 
 - **Updated** *implementation* and *tsdoc* for:
@@ -32,7 +36,7 @@ All notable changes to the package will be documented here.
 
 ## [4.27.10] - 2025-11-28
 
-- **Updated** type augmentation for `String` methods: `toLowerCase` and `toUpperCase` (type level only, implementation remains intact).
+- **Updated** *type augmentation* for `String` methods: `toLowerCase` and `toUpperCase` (type level only, implementation remains intact).
 
 ## [4.27.1] - 2025-11-28
 

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

@@ -4,9 +4,27 @@ import type { LOWERCASE } from './constants';
 declare global {
     interface String {
         toLowerCase(): string;
-        toLowerCase<C extends 'T' | string>(): C extends 'T' ? Lowercase<string> : Lowercase<C>;
+        /**
+         * * Converts all the alphabetic characters in a string to lowercase.
+         *
+         * @typeParam `Lower` - A type-level flag. If `'T'`, returns the lowercase string type (`Lowercase<string>`). Otherwise, returns literal `Lower` (must be Lowercase type).
+         *
+         * @remarks
+         * - This augmentation only affects TypeScript type inference.
+         * - Runtime behavior remains identical to the standard `toLowerCase()` method.
+         */
+        toLowerCase<Lower extends 'T' | Lowercase<string>>(): Lower extends 'T' ? Lowercase<string> : Lower;
         toUpperCase(): string;
-        toUpperCase<C extends 'T' | string>(): C extends 'T' ? Uppercase<string> : Uppercase<C>;
+        /**
+         * * Converts all the alphabetic characters in a string to uppercase.
+         *
+         * @typeParam `Upper` - A type-level flag. If `'T'`, returns the uppercase string type (`Uppercase<string>`). Otherwise, returns literal `Upper` (must be Uppercase type).
+         *
+         * @remarks
+         * - This augmentation only affects TypeScript type inference.
+         * - Runtime behavior remains identical to the standard `toUpperCase()` method.
+         */
+        toUpperCase<Upper extends 'T' | Uppercase<string>>(): Upper extends 'T' ? Uppercase<string> : Upper;
     }
 }
 /** - Options for generating anagrams. */

package/dist/dts/utils/index.d.ts

@@ -122,7 +122,7 @@ export declare function getStaticGetterNames(cls: Constructor): string[];
 export declare function getClassDetails(cls: Constructor): ClassDetails;
 /**
  * * Create a deterministic JSON string representation of any value.
- * - The output format matches standard JSON but with guaranteed sorted keys.
+ *   - The output format matches standard JSON but with guaranteed sorted keys.
  *
  *
  * @remarks
@@ -131,7 +131,7 @@ export declare function getClassDetails(cls: Constructor): ClassDetails;
  * 	 - Recursively stabilizing nested objects and arrays.
  * 	 - Converting all `undefined` values into `null` so the output remains valid JSON.
  *   - Converting date-like objects (`Date`, `Chronos`, `Moment.js`, `Day.js`, `Luxon`, `JS-Joda`, `Temporal`) **in the same way that {@link JSON.stringify} would serialize them**, ensuring predictable and JSON-compliant output.
- * 	 - Falling back to native JSON serialization for primitives.
+ *   - Falling back to native JSON serialization for primitives.
  *
  * - **Useful for:**
  *   - Hash generation (e.g., signatures, cache keys)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.4",
+  "version": "4.28.6",
   "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",