minor improvements

Author: alessiofrittoli

__tests__/storage/index.test.ts

@@ -1,4 +1,4 @@
-import { toCamelCase, toKebabCase, ucFirst } from '@/strings'
+import { parseValue, stringifyValue, toCamelCase, toKebabCase, ucFirst } from '@/strings'
 
 describe( 'ucFirst', () => {
 
@@ -26,27 +26,27 @@ describe( 'ucFirst', () => {
 
 		// @ts-expect-error negative testing
 		expect( () => ucFirst( false ) )
-			.toThrow( 'string.charAt is not a function' )
+			.toThrow( 'input.charAt is not a function' )
 
 		// @ts-expect-error negative testing
 		expect( () => ucFirst( true ) )
-			.toThrow( 'string.charAt is not a function' )
+			.toThrow( 'input.charAt is not a function' )
 
 		// @ts-expect-error negative testing
 		expect( () => ucFirst( 1 ) )
-			.toThrow( 'string.charAt is not a function' )
+			.toThrow( 'input.charAt is not a function' )
 
 		// @ts-expect-error negative testing
 		expect( () => ucFirst( {} ) )
-			.toThrow( 'string.charAt is not a function' )
+			.toThrow( 'input.charAt is not a function' )
 
 		// @ts-expect-error negative testing
 		expect( () => ucFirst( () => {} ) )
-			.toThrow( 'string.charAt is not a function' )
+			.toThrow( 'input.charAt is not a function' )
 
 		// @ts-expect-error negative testing
 		expect( () => ucFirst( [] ) )
-			.toThrow( 'string.charAt is not a function' )
+			.toThrow( 'input.charAt is not a function' )
 
 	} )
 
@@ -72,6 +72,12 @@ describe( 'toCamelCase', () => {
 		expect( toCamelCase( 'some_value' ) )
 			.toBe( 'someValue' )
 
+		expect( toCamelCase( 'some value_with mixed_Cases' ) )
+			.toBe( 'someValueWithMixedCases' )
+
+		expect( toCamelCase( '-string@with#special$characters' ) )
+			.toBe( 'StringWithSpecialCharacters' )
+
 	} )
 
 } )
@@ -87,9 +93,134 @@ describe( 'toKebabCase', () => {
 		expect( toKebabCase( 'backgroundColor' ) )
 			.toBe( 'background-color' )
 
+		expect( toKebabCase( 'string with spaces' ) )
+			.toBe( 'string-with-spaces' )
+		
+		expect( toKebabCase( 'string_with_underscores' ) )
+			.toBe( 'string-with-underscores' )
+		
 		expect( toKebabCase( 'WebkitAlignContent' ) )
 			.toBe( '-webkit-align-content' )
 
+		expect( toKebabCase( 'some value_with mixed_Cases' ) )
+			.toBe( 'some-value-with-mixed-cases' )
+
+		expect( toKebabCase( '-string@with#special$characters' ) )
+			.toBe( '-string-with-special-characters' )
+
+	} )
+
+} )
+
+
+describe( 'stringifyValue', () => {
+
+	it( 'stringifies Date objects', () => {
+
+		expect( stringifyValue( new Date( 'Sat, 20 Apr 2025 16:20:00 GMT' ) ) )
+			.toBe( '2025-04-20T16:20:00.000Z' )
+
+	} )
+	
+	
+	it( 'stringifies objects with `JSON.stringify()`', () => {
+
+		expect( stringifyValue( null ) )
+			.toBe( 'null' )
+		
+		expect( stringifyValue( { prop: 'value', prop2: true } ) )
+			.toBe( '{"prop":"value","prop2":true}' )
+		
+		expect( stringifyValue( [ 1, 2, true, null, () => {} ] ) )
+			.toBe( '[1,2,true,null,null]' )
+
+		expect( stringifyValue( new Map( [
+			[ 'key', 'value' ],
+			[ 'key2', 'value' ],
+		] ) ) ).toBe( '[["key","value"],["key2","value"]]' )
+
+		expect( stringifyValue( new Headers( {
+			key		: 'value',
+			key2	: 'value',
+		} ) ) ).toBe( '[["key","value"],["key2","value"]]' )
+
+	} )
+	
+	
+	it( 'stringifies other value types', () => {
+
+		expect( stringifyValue( true ) )
+			.toBe( 'true' )
+		expect( stringifyValue( false ) )
+			.toBe( 'false' )
+		
+		expect( stringifyValue( 0 ) )
+			.toBe( '0' )
+		expect( stringifyValue( 420 ) )
+			.toBe( '420' )
+
+	} )
+
+
+	it( 'returns empty string with un-serializable valuee', () => {
+		expect( stringifyValue( undefined ) )
+			.toBe( '' )
+		
+		expect( stringifyValue( () => {} ) )
+			.toBe( '' )
+
+		expect( stringifyValue( new Promise<void>( resolve => resolve() ) ) )
+			.toBe( '' )
+	} )
+
+} )
+
+
+describe( 'parseValue', () => {
+
+	it( 'parses Date strings to Date objects', () => {
+		expect( parseValue<Date>(
+			stringifyValue( new Date() )
+		) ).toBeInstanceOf( Date )
+	} )
+	
+	
+	it( 'parses numeric strings to `number`', () => {
+		expect( parseValue<number>( '12345' ) ).toBe( 12345 )
+	} )
+	
+	
+	it( 'returns `undefined` if no value has been given', () => {
+		expect( parseValue() ).toBeUndefined()
+	} )
+	
+	
+	it( 'returns `undefined` if empty `string` has been given', () => {
+		expect( parseValue( ' ' ) ).toBeUndefined()
+	} )
+
+
+	it( 'returns parsed value using JSON.parse() for valid JSON strings', () => {
+
+		expect( parseValue<true>(
+			stringifyValue( true )
+		) ).toBe( true )
+		
+		expect( parseValue(
+			stringifyValue( { key: 'value' } )
+		) ).toEqual( { key: 'value' } )
+		
+		expect( parseValue(
+			stringifyValue( [ 1, 2, 3, 4, 5 ] )
+		) ).toEqual( [ 1, 2, 3, 4, 5 ] )
+
+	} )
+	
+	
+	it( 'returns value as is if JSON.parse() fails', () => {
+
+		expect( parseValue( 'String value' ) ).toBe( 'String value' )
+
 	} )
 
 } )

__tests__/strings.test.ts

@@ -63,9 +63,9 @@
 			"require": "./dist/validation.js"
 		},
 		"./storage": {
-			"types": "./dist/storage/Storage.d.ts",
-			"import": "./dist/storage/Storage.mjs",
-			"require": "./dist/storage/Storage.js"
+			"types": "./dist/storage/index.d.ts",
+			"import": "./dist/storage/index.mjs",
+			"require": "./dist/storage/index.js"
 		},
 		"./storage/Cookie": {
 			"types": "./dist/storage/Cookie.d.ts",

package.json

@@ -1,4 +1,7 @@
+export * from './storage'
 export * from './blob'
 export * from './generators'
 export * from './map'
-export * from './strings'
+export * from './strings'
+export * from './types'
+export * from './validation'

src/index.ts

@@ -37,6 +37,9 @@ export interface TypedMap<
  *
  * @template T The object type defining the key-value relationships.
  * @template P Defines whether the `Map.get()` method should return a possibily undefined value.
+ * 
+ * @param iterable Initial `Map` constructor iterable object.
+ * 
  * @returns A new instance of a type-safe Map.
  */
 export const getTypedMap = <

src/map.ts

@@ -1,8 +1,7 @@
 import { isValidDate } from '@alessiofrittoli/date-utils'
-import { toCamelCase, ucFirst } from '@/strings'
+import { parseValue, stringifyValue, toCamelCase, ucFirst } from '@/strings'
 
 import { getTypedMap, type TypedMap } from '@/map'
-import { Storage } from './Storage'
 
 
 /** The Cookie Priority. */
@@ -251,7 +250,7 @@ export class Cookie
 					}
 					if ( key === 'MaxAge' ) key = 'Max-Age' as K
 
-					return [ key, Storage.stringifyValue( value ) ].join( '=' )
+					return [ key, stringifyValue( value ) ].join( '=' )
 				} )
 				.join( ';' )
 		)
@@ -338,6 +337,6 @@ export class Cookie
 			return ( value !== 'false' ) as T
 		}
 
-		return Storage.parseValue<T>( value )
+		return parseValue<T>( value )
 	}
 }

src/storage/Cookie.ts

@@ -1,5 +1,4 @@
-import { Storage } from './Storage'
-
+import { parseValue, stringifyValue } from '@/strings'
 
 /**
  * A browser-compatible implementation of [`localStorage`](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage). Data is stored
@@ -33,7 +32,7 @@ export class LocalStorage
 	static get<T>( name: string )
 	{
 		return (
-			Storage.parseValue<T>( localStorage.getItem( name ) || undefined )
+			parseValue<T>( localStorage.getItem( name ) || undefined )
 		)
 	}
 
@@ -49,7 +48,7 @@ export class LocalStorage
 	 */
 	static set<T>( name: string, value: T )
 	{
-		return localStorage.setItem( name, Storage.stringifyValue( value ) )
+		return localStorage.setItem( name, stringifyValue( value ) )
 	}