@ooneex/utils 0.1.0 → 0.2.1

package/README.md

@@ -1,90 +1,90 @@
 # @ooneex/utils
 
-A comprehensive TypeScript/JavaScript utility library providing essential helper functions for string manipulation, time formatting, data parsing, and more. This package offers a collection of lightweight, type-safe utilities designed to streamline common development tasks across web applications.
+General-purpose utility functions including unique ID generation with nanoid, type guards, and common helper methods.
 
 ![Browser](https://img.shields.io/badge/Browser-Compatible-green?style=flat-square&logo=googlechrome)
 ![Bun](https://img.shields.io/badge/Bun-Compatible-orange?style=flat-square&logo=bun)
-![Deno](https://img.shields.io/badge/Deno-Compatible-blue?style=flat-square&logo=deno)
-![Node.js](https://img.shields.io/badge/Node.js-Compatible-green?style=flat-square&logo=node.js)
 ![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript)
 ![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)
 
 ## Features
 
-✅ **String Manipulation** - Case conversion utilities (camelCase, PascalCase, kebab-case)
+✅ **ID Generation** - Generate unique IDs using nanoid with configurable length
 
-✅ **Time Formatting** - Convert seconds/milliseconds to human-readable formats
+✅ **String Case Conversion** - Convert between camelCase, kebab-case, snake_case, and PascalCase
 
-✅ **Data Parsing** - Intelligent string parsing with type inference
+✅ **String Utilities** - `trim`, `splitToWords`, `capitalizeWord` for common string operations
 
-✅ **Type-Safe** - Full TypeScript support with proper type definitions
+✅ **Value Parsing** - `parseString` to convert string values to boolean, number, or string types
 
-✅ **Lightweight** - Minimal dependencies and optimized bundle size
+✅ **Time Formatting** - `secondsToHMS`, `secondsToMS`, and `millisecondsToHMS` for duration display
 
-✅ **Cross-Platform** - Works in Browser, Node.js, Bun, and Deno
+✅ **Number Formatting** - `formatRelativeNumber` for human-readable numbers with K, M, B suffixes
 
-✅ **Environment Variables** - Parse and transform environment variables
+✅ **Data Conversion** - `dataURLtoFile` to convert data URLs to File objects
 
-✅ **File Utilities** - Convert data URLs to File objects
+✅ **Environment Variables** - `parseEnvVars` to parse .env file content into key-value pairs
 
-✅ **Random Generation** - Generate random IDs and strings
+✅ **Async Utilities** - `sleep` function for async/await workflows
 
-✅ **Number Formatting** - Format numbers with locale-aware compact notation
-
-✅ **Zero Dependencies** - Only one small dependency (nanoid) for random generation
+✅ **Zero Config** - Simple, pure functions with no configuration needed
 
 ## Installation
 
-### Bun
 ```bash
 bun add @ooneex/utils
 ```
 
-### pnpm
-```bash
-pnpm add @ooneex/utils
-```
+## Usage
 
-### Yarn
-```bash
-yarn add @ooneex/utils
-```
+### Unique ID Generation
 
-### npm
-```bash
-npm install @ooneex/utils
-```
+```typescript
+import { random } from '@ooneex/utils';
 
-## Usage
+// Generate a unique ID (default length: 21)
+const id = random();
+console.log(id); // "V1StGXR8_Z5jdHi6B-myT"
+
+// Generate with custom length
+const shortId = random(10);
+console.log(shortId); // "V1StGXR8_Z"
+```
 
-### String Manipulation
+### String Case Conversion
 
 ```typescript
 import {
-  capitalizeWord,
   toCamelCase,
-  toPascalCase,
   toKebabCase,
-  splitToWords,
-  trim
+  toSnakeCase,
+  toPascalCase,
+  capitalizeWord
 } from '@ooneex/utils';
 
-// Capitalize words
-console.log(capitalizeWord('hello')); // 'Hello'
-console.log(capitalizeWord('WORLD')); // 'World'
-
-// Case conversions
-console.log(toCamelCase('hello world')); // 'helloWorld'
-console.log(toPascalCase('hello world')); // 'HelloWorld'
-console.log(toKebabCase('Hello World')); // 'hello-world'
-
-// Split strings to words
-console.log(splitToWords('HelloWorldExample')); // ['Hello', 'World', 'Example']
-console.log(splitToWords('hello-world_example')); // ['hello', 'world', 'example']
-
-// Advanced trimming
-console.log(trim('...hello...', '\\.')); // 'hello'
-console.log(trim('[test]', '\\[|\\]')); // 'test'
+// Convert to camelCase
+toCamelCase('hello world');        // "helloWorld"
+toCamelCase('hello-world');        // "helloWorld"
+toCamelCase('hello_world');        // "helloWorld"
+
+// Convert to kebab-case
+toKebabCase('helloWorld');         // "hello-world"
+toKebabCase('HelloWorld');         // "hello-world"
+toKebabCase('hello_world');        // "hello-world"
+
+// Convert to snake_case
+toSnakeCase('helloWorld');         // "hello_world"
+toSnakeCase('HelloWorld');         // "hello_world"
+toSnakeCase('hello-world');        // "hello_world"
+
+// Convert to PascalCase
+toPascalCase('hello world');       // "HelloWorld"
+toPascalCase('hello-world');       // "HelloWorld"
+toPascalCase('hello_world');       // "HelloWorld"
+
+// Capitalize first letter
+capitalizeWord('hello');           // "Hello"
+capitalizeWord('hello world');     // "Hello world"
 ```
 
 ### Time Formatting
@@ -93,555 +93,391 @@ console.log(trim('[test]', '\\[|\\]')); // 'test'
 import {
   secondsToHMS,
   secondsToMS,
-  millisecondsToHMS,
-  sleep
+  millisecondsToHMS
 } from '@ooneex/utils';
 
-// Convert seconds to time formats
-console.log(secondsToHMS(3661)); // '1:01:01'
-console.log(secondsToHMS(125)); // '2:05'
-console.log(secondsToHMS(45)); // '45'
+// Seconds to Hours:Minutes:Seconds
+secondsToHMS(3661);     // "1:01:01"
+secondsToHMS(125);      // "0:02:05"
+
+// Seconds to Minutes:Seconds
+secondsToMS(125);       // "2:05"
+secondsToMS(65);        // "1:05"
+
+// Milliseconds to Hours:Minutes:Seconds
+millisecondsToHMS(3661000);  // "1:01:01"
+millisecondsToHMS(125000);   // "0:02:05"
+```
 
-console.log(secondsToMS(125)); // '2:05'
-console.log(secondsToMS(45)); // '0:45'
+### Number Formatting
 
-// Convert milliseconds to time format
-console.log(millisecondsToHMS(3661000)); // '1:01:01'
-console.log(millisecondsToHMS(125000)); // '2:05'
+```typescript
+import { formatRelativeNumber } from '@ooneex/utils';
 
-// Async sleep utility
-await sleep(1000); // Wait 1 second
+// Format large numbers with suffixes
+formatRelativeNumber(1000);        // "1K"
+formatRelativeNumber(1500);        // "1.5K"
+formatRelativeNumber(1000000);     // "1M"
+formatRelativeNumber(1500000);     // "1.5M"
+formatRelativeNumber(1000000000);  // "1B"
+formatRelativeNumber(999);         // "999"
 ```
 
-### Data Parsing
+### Async Sleep
 
 ```typescript
-import { parseString, parseEnvVars } from '@ooneex/utils';
-
-// Intelligent string parsing with type inference
-console.log(parseString('123')); // 123 (number)
-console.log(parseString('12.34')); // 12.34 (number)
-console.log(parseString('true')); // true (boolean)
-console.log(parseString('false')); // false (boolean)
-console.log(parseString('null')); // null
-console.log(parseString('[1,2,3]')); // [1, 2, 3] (array)
-console.log(parseString('{"name":"John"}')); // {name: "John"} (object)
-console.log(parseString('1e5')); // 100000 (scientific notation)
-console.log(parseString('hello')); // 'hello' (string fallback)
-
-// Parse environment variables
-const envs = {
-  'API_PORT': '3000',
-  'DEBUG_MODE': 'true',
-  'ALLOWED_HOSTS': '["localhost", "127.0.0.1"]'
-};
-
-const parsed = parseEnvVars(envs);
-// Result: { apiPort: 3000, debugMode: true, allowedHosts: ['localhost', '127.0.0.1'] }
+import { sleep } from '@ooneex/utils';
+
+async function example() {
+  console.log('Starting...');
+  
+  // Wait for 2 seconds
+  await sleep(2000);
+  
+  console.log('2 seconds later...');
+}
 ```
 
-### Number Formatting
+### String Utilities
 
 ```typescript
-import { formatRelativeNumber } from '@ooneex/utils';
+import { trim, splitToWords, parseString } from '@ooneex/utils';
 
-// Format numbers with compact notation
-console.log(formatRelativeNumber(1000)); // '1K'
-console.log(formatRelativeNumber(1500)); // '1.5K'
-console.log(formatRelativeNumber(1000000)); // '1M'
-console.log(formatRelativeNumber(2500000)); // '2.5M'
-console.log(formatRelativeNumber(1000000000)); // '1B'
-
-// Custom precision
-console.log(formatRelativeNumber(1234, { precision: 2 })); // '1.23K'
-console.log(formatRelativeNumber(1234, { precision: 0 })); // '1K'
-
-// Different locales
-console.log(formatRelativeNumber(1500, { lang: 'de-DE' })); // '1500'
-console.log(formatRelativeNumber(1500000, { lang: 'de-DE' })); // '1,5 Mio.'
-console.log(formatRelativeNumber(1500, { lang: 'fr-FR' })); // '1,5 k'
+// Trim whitespace and normalize
+trim('  hello   world  ');  // "hello world"
+
+// Split string into words
+splitToWords('helloWorld');    // ["hello", "World"]
+splitToWords('hello-world');   // ["hello", "world"]
+splitToWords('hello_world');   // ["hello", "world"]
+
+// Parse string values
+parseString('true');    // true (boolean)
+parseString('false');   // false (boolean)
+parseString('123');     // 123 (number)
+parseString('hello');   // "hello" (string)
 ```
 
-### File Utilities
+### Data URL Conversion
 
 ```typescript
 import { dataURLtoFile } from '@ooneex/utils';
 
-// Convert data URL to File object
-const dataUrl = 'data:text/plain;base64,SGVsbG8gV29ybGQ=';
-const file = dataURLtoFile(dataUrl, 'hello.txt');
+// Convert a data URL to a File object
+const dataUrl = 'data:image/png;base64,iVBORw0KGgo...';
+const file = dataURLtoFile(dataUrl, 'image.png');
 
-console.log(file.name); // 'hello.txt'
-console.log(file.type); // 'text/plain'
-console.log(file.size); // 11
+console.log(file.name); // "image.png"
+console.log(file.type); // "image/png"
 ```
 
-### Random Generation
+### Environment Variable Parsing
 
 ```typescript
-import { random } from '@ooneex/utils';
-
-// Generate random hex strings
-console.log(random.nanoid()); // 'a1b2c3d4e5' (10 chars default)
-console.log(random.nanoid(8)); // 'f6e5d4c3' (8 chars)
+import { parseEnvVars } from '@ooneex/utils';
 
-// Generate numeric strings
-console.log(random.stringInt()); // '1234567890' (10 digits default)
-console.log(random.stringInt(6)); // '123456' (6 digits)
+// Parse environment variable content
+const envContent = `
+DATABASE_URL=postgresql://localhost:5432/mydb
+API_KEY=secret-key-123
+DEBUG=true
+PORT=3000
+`;
 
-// Create a factory function
-const generateId = random.nanoidFactory(12);
-console.log(generateId()); // 12-character hex string
-console.log(generateId(8)); // 8-character hex string (overrides factory size)
+const vars = parseEnvVars(envContent);
+// {
+//   DATABASE_URL: 'postgresql://localhost:5432/mydb',
+//   API_KEY: 'secret-key-123',
+//   DEBUG: 'true',
+//   PORT: '3000'
+// }
 ```
 
 ## API Reference
 
-### String Utilities
+### Functions
 
-#### `capitalizeWord(word: string): string`
-Capitalizes the first letter and lowercases the rest.
+#### `random(size?: number): string`
+
+Generates a unique ID using nanoid.
 
 **Parameters:**
-- `word` - The word to capitalize
+- `size` - Optional length of the ID (default: 21)
 
-**Returns:** Capitalized word
+**Returns:** A unique string ID
 
 **Example:**
 ```typescript
-capitalizeWord('hello'); // 'Hello'
-capitalizeWord('WORLD'); // 'World'
-capitalizeWord(''); // ''
+const id = random();      // "V1StGXR8_Z5jdHi6B-myT"
+const short = random(8);  // "V1StGXR8"
 ```
 
-#### `toCamelCase(input: string): string`
-Converts string to camelCase.
+---
+
+#### `toCamelCase(str: string): string`
+
+Converts a string to camelCase.
 
 **Parameters:**
-- `input` - The string to convert
+- `str` - The input string
 
-**Returns:** camelCase string
+**Returns:** camelCase formatted string
 
-**Example:**
-```typescript
-toCamelCase('hello world'); // 'helloWorld'
-toCamelCase('Hello-World_Example'); // 'helloWorldExample'
-toCamelCase('API_KEY'); // 'apiKey'
-```
+---
+
+#### `toKebabCase(str: string): string`
 
-#### `toPascalCase(input: string): string`
-Converts string to PascalCase.
+Converts a string to kebab-case.
 
 **Parameters:**
-- `input` - The string to convert
+- `str` - The input string
 
-**Returns:** PascalCase string
+**Returns:** kebab-case formatted string
 
-**Example:**
-```typescript
-toPascalCase('hello world'); // 'HelloWorld'
-toPascalCase('api-key'); // 'ApiKey'
-toPascalCase('user_name'); // 'UserName'
-```
+---
+
+#### `toSnakeCase(str: string): string`
 
-#### `toKebabCase(input: string): string`
-Converts string to kebab-case.
+Converts a string to snake_case.
 
 **Parameters:**
-- `input` - The string to convert
+- `str` - The input string
 
-**Returns:** kebab-case string
+**Returns:** snake_case formatted string
 
-**Example:**
-```typescript
-toKebabCase('Hello World'); // 'hello-world'
-toKebabCase('camelCaseString'); // 'camel-case-string'
-toKebabCase('PascalCaseString'); // 'pascal-case-string'
-```
+---
+
+#### `toPascalCase(str: string): string`
 
-#### `splitToWords(input: string): string[]`
-Splits a string into individual words, handling various naming conventions.
+Converts a string to PascalCase.
 
 **Parameters:**
-- `input` - The string to split
+- `str` - The input string
 
-**Returns:** Array of words
+**Returns:** PascalCase formatted string
 
-**Example:**
-```typescript
-splitToWords('HelloWorld'); // ['Hello', 'World']
-splitToWords('hello-world_example'); // ['hello', 'world', 'example']
-splitToWords('XMLHttpRequest'); // ['XML', 'Http', 'Request']
-splitToWords('user123Name'); // ['user', '123', 'Name']
-```
+---
+
+#### `capitalizeWord(str: string): string`
 
-#### `trim(text: string, char?: string): string`
-Trims specified characters from the beginning and end of a string.
+Capitalizes the first letter of a string.
 
 **Parameters:**
-- `text` - The string to trim
-- `char` - Characters to trim (default: space). Supports regex patterns.
+- `str` - The input string
 
-**Returns:** Trimmed string
+**Returns:** String with first letter capitalized
 
-**Example:**
-```typescript
-trim('  hello  '); // 'hello'
-trim('...hello...', '\\.'); // 'hello'
-trim('[test]', '\\[|\\]'); // 'test'
-trim('!!hello!!', '!'); // 'hello'
-```
+---
 
-### Time Utilities
+#### `splitToWords(str: string): string[]`
 
-#### `secondsToHMS(seconds: number): string`
-Converts seconds to HH:MM:SS or MM:SS or SS format.
+Splits a string into an array of words.
 
 **Parameters:**
-- `seconds` - Number of seconds
+- `str` - The input string (camelCase, kebab-case, snake_case, or space-separated)
 
-**Returns:** Formatted time string
+**Returns:** Array of words
 
-**Example:**
-```typescript
-secondsToHMS(3661); // '1:01:01' (1 hour, 1 minute, 1 second)
-secondsToHMS(125); // '2:05' (2 minutes, 5 seconds)
-secondsToHMS(45); // '45' (45 seconds)
-secondsToHMS(0); // '0'
-```
+---
 
-#### `secondsToMS(seconds: number): string`
-Converts seconds to MM:SS format.
+#### `trim(str: string): string`
+
+Trims whitespace and normalizes internal spacing.
 
 **Parameters:**
-- `seconds` - Number of seconds
+- `str` - The input string
 
-**Returns:** MM:SS formatted string
+**Returns:** Trimmed and normalized string
 
-**Example:**
-```typescript
-secondsToMS(125); // '2:05'
-secondsToMS(45); // '0:45'
-secondsToMS(3661); // '61:01'
-```
+---
+
+#### `secondsToHMS(seconds: number): string`
 
-#### `millisecondsToHMS(ms: number): string`
-Converts milliseconds to HH:MM:SS or MM:SS or SS format.
+Converts seconds to H:MM:SS format.
 
 **Parameters:**
-- `ms` - Number of milliseconds
+- `seconds` - Number of seconds
 
 **Returns:** Formatted time string
 
-**Example:**
-```typescript
-millisecondsToHMS(3661000); // '1:01:01'
-millisecondsToHMS(125000); // '2:05'
-millisecondsToHMS(45000); // '45'
-millisecondsToHMS(500); // '0'
-```
+---
 
-#### `sleep(ms: number): Promise<void>`
-Creates a promise that resolves after the specified number of milliseconds.
+#### `secondsToMS(seconds: number): string`
 
-**Parameters:**
-- `ms` - Number of milliseconds to wait
+Converts seconds to M:SS format.
 
-**Returns:** Promise that resolves after the delay
+**Parameters:**
+- `seconds` - Number of seconds
 
-**Example:**
-```typescript
-await sleep(1000); // Wait 1 second
-await sleep(500); // Wait 0.5 seconds
+**Returns:** Formatted time string
 
-// Usage in async function
-async function delayedLog() {
-  console.log('First');
-  await sleep(2000);
-  console.log('Second (2 seconds later)');
-}
-```
+---
 
-### Data Parsing
+#### `millisecondsToHMS(milliseconds: number): string`
 
-#### `parseString<T>(text: string): T`
-Intelligently parses a string and returns the appropriate type.
+Converts milliseconds to H:MM:SS format.
 
 **Parameters:**
-- `text` - The string to parse
+- `milliseconds` - Number of milliseconds
 
-**Returns:** Parsed value with inferred type
+**Returns:** Formatted time string
 
-**Supported Formats:**
-- Integers: `"123"` → `123`
-- Floats: `"12.34"` → `12.34`
-- Scientific notation: `"1e5"` → `100000`
-- Booleans: `"true"`, `"false"` (case insensitive)
-- Null: `"null"` (case insensitive)
-- Arrays: `"[1,2,3]"` → `[1, 2, 3]`
-- Objects: `'{"key":"value"}'` → `{key: "value"}`
-- JSON strings: `'"hello"'` → `"hello"`
+---
 
-**Example:**
-```typescript
-parseString('123'); // 123 (number)
-parseString('12.34'); // 12.34 (number)
-parseString('1e3'); // 1000 (number)
-parseString('true'); // true (boolean)
-parseString('null'); // null
-parseString('[1,2,3]'); // [1, 2, 3] (array)
-parseString('{"name":"John"}'); // {name: "John"} (object)
-parseString('hello'); // 'hello' (string fallback)
-
-// With type annotation
-const num = parseString<number>('123'); // TypeScript knows it's a number
-const arr = parseString<number[]>('[1,2,3]'); // TypeScript knows it's number[]
-```
+#### `formatRelativeNumber(num: number): string`
 
-#### `parseEnvVars<T>(envs: Record<string, string>): T`
-Parses environment variables, converting keys to camelCase and values using `parseString`.
+Formats a number with K, M, or B suffix.
 
 **Parameters:**
-- `envs` - Object with environment variable key-value pairs
+- `num` - The number to format
 
-**Returns:** Object with camelCase keys and parsed values
+**Returns:** Formatted number string with suffix
 
-**Example:**
-```typescript
-const envVars = {
-  'API_PORT': '3000',
-  'DEBUG_MODE': 'true',
-  'ALLOWED_HOSTS': '["localhost", "127.0.0.1"]',
-  'MAX_CONNECTIONS': '100',
-  'ENABLE_SSL': 'false'
-};
-
-const config = parseEnvVars(envVars);
-// Result:
-// {
-//   apiPort: 3000,
-//   debugMode: true,
-//   allowedHosts: ['localhost', '127.0.0.1'],
-//   maxConnections: 100,
-//   enableSsl: false
-// }
-
-// With type annotation
-interface Config {
-  apiPort: number;
-  debugMode: boolean;
-  allowedHosts: string[];
-}
-const typedConfig = parseEnvVars<Config>(envVars);
-```
+---
 
-### Number Utilities
+#### `sleep(ms: number): Promise<void>`
 
-#### `formatRelativeNumber(num: number, config?: { precision?: number; lang?: string }): string`
-Formats numbers using compact notation with locale support.
+Pauses execution for the specified duration.
 
 **Parameters:**
-- `num` - The number to format
-- `config.precision` - Maximum decimal places (default: 1)
-- `config.lang` - Locale code (default: 'en-GB')
+- `ms` - Duration in milliseconds
 
-**Returns:** Formatted number string
+**Returns:** Promise that resolves after the duration
 
-**Example:**
-```typescript
-formatRelativeNumber(1000); // '1K'
-formatRelativeNumber(1500); // '1.5K'
-formatRelativeNumber(1000000); // '1M'
-formatRelativeNumber(1000000000); // '1B'
-
-// Custom precision
-formatRelativeNumber(1234, { precision: 2 }); // '1.23K'
-formatRelativeNumber(1234, { precision: 0 }); // '1K'
-
-// Different locales
-formatRelativeNumber(1500, { lang: 'de-DE' }); // '1500'
-formatRelativeNumber(1500000, { lang: 'de-DE' }); // '1,5 Mio.'
-formatRelativeNumber(1500, { lang: 'fr-FR' }); // '1,5 k'
-formatRelativeNumber(1500, { lang: 'es-ES' }); // '1,5 mil'
-```
+---
 
-### File Utilities
+#### `dataURLtoFile(dataUrl: string, filename: string): File`
 
-#### `dataURLtoFile(dataurl: string, filename: string): File`
 Converts a data URL to a File object.
 
 **Parameters:**
-- `dataurl` - The data URL string
-- `filename` - The desired filename for the File object
+- `dataUrl` - The data URL string
+- `filename` - Name for the resulting file
 
 **Returns:** File object
 
-**Example:**
-```typescript
-// Text file
-const textDataUrl = 'data:text/plain;base64,SGVsbG8gV29ybGQ=';
-const textFile = dataURLtoFile(textDataUrl, 'hello.txt');
-console.log(textFile.name); // 'hello.txt'
-console.log(textFile.type); // 'text/plain'
-console.log(textFile.size); // 11
-
-// Image file
-const imgDataUrl = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg==';
-const imgFile = dataURLtoFile(imgDataUrl, 'pixel.png');
-console.log(imgFile.type); // 'image/png'
-
-// Usage with FileReader
-const reader = new FileReader();
-reader.onload = (e) => console.log(e.target?.result);
-reader.readAsText(textFile);
-```
+---
 
-### Random Generation
+#### `parseString(value: string): string | number | boolean`
 
-#### `random.nanoid(size?: number): string`
-Generates a random hexadecimal string.
+Parses a string value to its appropriate type.
 
 **Parameters:**
-- `size` - Length of the generated string (default: 10)
-
-**Returns:** Random hex string
-
-**Example:**
-```typescript
-random.nanoid(); // 'a1b2c3d4e5' (10 characters)
-random.nanoid(8); // 'f6e5d4c3' (8 characters)
-random.nanoid(16); // '1a2b3c4d5e6f7890' (16 characters)
-```
+- `value` - The string to parse
 
-#### `random.stringInt(size?: number): string`
-Generates a random numeric string.
+**Returns:** Parsed value (boolean, number, or string)
 
-**Parameters:**
-- `size` - Length of the generated string (default: 10)
-
-**Returns:** Random numeric string
+---
 
-**Example:**
-```typescript
-random.stringInt(); // '1234567890' (10 digits)
-random.stringInt(6); // '123456' (6 digits)
-random.stringInt(4); // '9876' (4 digits)
-```
+#### `parseEnvVars(content: string): Record<string, string>`
 
-#### `random.nanoidFactory(size?: number): (size?: number) => string`
-Creates a factory function for generating random hex strings.
+Parses environment variable content.
 
 **Parameters:**
-- `size` - Default length for the factory (default: 10)
+- `content` - Raw environment variable content
 
-**Returns:** Factory function that accepts optional size parameter
-
-**Example:**
-```typescript
-const generateId = random.nanoidFactory(12);
-generateId(); // 12-character hex string
-generateId(8); // 8-character hex string (overrides factory default)
-generateId(16); // 16-character hex string
-
-const generateShortId = random.nanoidFactory(6);
-generateShortId(); // 6-character hex string
-```
+**Returns:** Object with key-value pairs
 
 ## Advanced Usage
 
-### Environment Configuration
+### Building File Names
 
 ```typescript
-import { parseEnvVars } from '@ooneex/utils';
+import { toKebabCase, random } from '@ooneex/utils';
 
-// Define your configuration interface
-interface AppConfig {
-  port: number;
-  host: string;
-  debug: boolean;
-  features: string[];
-  dbConfig: {
-    host: string;
-    port: number;
-  };
+function generateFileName(title: string, extension: string): string {
+  const slug = toKebabCase(title);
+  const uniqueId = random(8);
+  return `${slug}-${uniqueId}.${extension}`;
 }
 
-// Parse environment variables
-const envConfig = parseEnvVars<Partial<AppConfig>>(process.env);
-
-// Merge with defaults
-const config: AppConfig = {
-  port: 3000,
-  host: 'localhost',
-  debug: false,
-  features: [],
-  dbConfig: { host: 'localhost', port: 5432 },
-  ...envConfig
-};
+const fileName = generateFileName('My Awesome Photo', 'jpg');
+// "my-awesome-photo-V1StGXR8.jpg"
 ```
 
-### String Processing Pipeline
+### Formatting Display Values
 
 ```typescript
-import { splitToWords, toCamelCase, capitalizeWord } from '@ooneex/utils';
+import { formatRelativeNumber, capitalizeWord } from '@ooneex/utils';
 
-function processUserInput(input: string): {
-  words: string[];
-  camelCase: string;
-  title: string;
-  kebabCase: string;
-} {
-  const words = splitToWords(input);
+interface SocialStats {
+  followers: number;
+  likes: number;
+  views: number;
+}
 
+function formatStats(stats: SocialStats): Record<string, string> {
   return {
-    words,
-    camelCase: toCamelCase(input),
-    title: words.map(capitalizeWord).join(' '),
-    kebabCase: toKebabCase(input)
+    followers: formatRelativeNumber(stats.followers),
+    likes: formatRelativeNumber(stats.likes),
+    views: formatRelativeNumber(stats.views)
   };
 }
 
-const result = processUserInput('user-profile_settings');
-// {
-//   words: ['user', 'profile', 'settings'],
-//   camelCase: 'userProfileSettings',
-//   title: 'User Profile Settings',
-//   kebabCase: 'user-profile-settings'
-// }
+const stats = formatStats({
+  followers: 15600,
+  likes: 1200000,
+  views: 45000
+});
+// { followers: "15.6K", likes: "1.2M", views: "45K" }
 ```
 
-### Time-based Progress Tracking
+### Video Duration Display
 
 ```typescript
-import { millisecondsToHMS, formatRelativeNumber } from '@ooneex/utils';
+import { secondsToHMS, secondsToMS } from '@ooneex/utils';
 
-class ProgressTracker {
-  private startTime: number;
-  private itemsProcessed: number = 0;
-  private totalItems: number;
+function formatDuration(seconds: number): string {
+  // Use H:MM:SS for videos over an hour, otherwise M:SS
+  return seconds >= 3600 
+    ? secondsToHMS(seconds)
+    : secondsToMS(seconds);
+}
 
-  constructor(totalItems: number) {
-    this.startTime = Date.now();
-    this.totalItems = totalItems;
-  }
+console.log(formatDuration(90));    // "1:30"
+console.log(formatDuration(3700));  // "1:01:40"
+```
+
+### Retry with Delay
 
-  update(processed: number): string {
-    this.itemsProcessed = processed;
-    const elapsed = Date.now() - this.startTime;
-    const rate = processed / (elapsed / 1000);
-    const remaining = (this.totalItems - processed) / rate * 1000;
-
-    return [
-      `Processed: ${formatRelativeNumber(processed)}/${formatRelativeNumber(this.totalItems)}`,
-      `Elapsed: ${millisecondsToHMS(elapsed)}`,
-      `ETA: ${millisecondsToHMS(remaining)}`
-    ].join(' | ');
+```typescript
+import { sleep } from '@ooneex/utils';
+
+async function retryWithBackoff<T>(
+  fn: () => Promise<T>,
+  maxRetries: number = 3,
+  baseDelay: number = 1000
+): Promise<T> {
+  let lastError: Error;
+  
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error as Error;
+      const delay = baseDelay * Math.pow(2, attempt);
+      console.log(`Attempt ${attempt + 1} failed, retrying in ${delay}ms...`);
+      await sleep(delay);
+    }
   }
+  
+  throw lastError!;
+}
+```
+
+### API Route Slug Generation
+
+```typescript
+import { toKebabCase } from '@ooneex/utils';
+
+function generateApiSlug(resourceName: string, action: string): string {
+  const resource = toKebabCase(resourceName);
+  const actionSlug = toKebabCase(action);
+  return `/api/${resource}/${actionSlug}`;
 }
 
-const tracker = new ProgressTracker(100000);
-console.log(tracker.update(15000));
-// "Processed: 15K/100K | Elapsed: 2:30 | ETA: 14:10"
+generateApiSlug('UserProfile', 'getById');  // "/api/user-profile/get-by-id"
+generateApiSlug('BlogPost', 'create');       // "/api/blog-post/create"
 ```
 
 ## License

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 declare const capitalizeWord: (word: string) => string;
-declare const dataURLtoFile: (dataurl: string, filename: string) => File;
+declare const dataURLtoFile: (dataUrl: string, filename: string) => File;
 declare const formatRelativeNumber: (num: number, config?: {
 	precision?: number;
 	lang?: string;

package/dist/index.js

@@ -1,3 +1,3 @@
-var i=(r)=>r?r[0]?.toUpperCase()+r.slice(1).toLowerCase():r;var u=(r,t)=>{let o=r.split(","),e=o[0]?.match(/:(.*?);/)?.[1]||"",f=atob(o[1]),a=f.length,g=new Uint8Array(a);while(a--)g[a]=f.charCodeAt(a);return new File([g],t,{type:e})};var d=(r,t)=>new Intl.NumberFormat(t?.lang??"en-GB",{notation:"compact",compactDisplay:"short",maximumFractionDigits:t?.precision??1}).format(r);var S=(r)=>{let t=Math.floor(r/1000),o=Math.floor(t/3600),s=Math.floor(t%3600/60),e=t%60;if(o>0)return`${o}:${s.toString().padStart(2,"0")}:${e.toString().padStart(2,"0")}`;if(s>0)return`${s}:${e.toString().padStart(2,"0")}`;return e.toString()};var p=(r,t=" ")=>{if([".","[","]","(",")","+","*","^","$","?","/","\\"].includes(t))t=`\\${t}`;let o=new RegExp(`^${t}+|${t}+$`,"g");return r.replace(o,"")};var m=(r)=>{if(/^[0-9]+$/.test(r))return Number.parseInt(r,10);if(/^[0-9]+[.][0-9]+$/.test(r))return Number.parseFloat(r);if(/^true$/i.test(r))return!0;if(/^false$/i.test(r))return!1;if(/^null$/i.test(r))return null;if(/^\[/.test(r)&&/]$/.test(r)){let o=p(r,"\\[|\\]").split(/, */);return o=o.map((s)=>m(s)),o}try{let t=JSON.parse(r);if(t===Number.POSITIVE_INFINITY||t===Number.NEGATIVE_INFINITY)return r;return t}catch{return r}};var T=/\p{Lu}\p{Ll}+/u,b=/\p{Lu}+(?=(\p{Lu}\p{Ll})|\P{L}|\b)/u,x=/(\p{Ll}+)/u,$=/\p{L}+/u,C=/\p{N}+/u,M=new RegExp(`${T.source}|${b.source}|${x.source}|${$.source}|${C.source}`,"gu"),n=(r)=>r.match(M)??[];var c=(r)=>{r=r.trim();let[t="",...o]=n(r);return[t.toLowerCase(),...o.map(i)].join("")};var h=(r)=>{let t={};for(let o in r){let s=c(o),e=m(r[o]);t[s]=e}return t};import{customAlphabet as l}from"nanoid";var F={nanoid(r){return l("1234567890abcdef",r??10)()},stringInt(r){return l("1234567890",r??10)()},nanoidFactory(r){return l("1234567890abcdef",r??10)}};var N=(r)=>{let t=Math.floor(r),o=Math.floor(t/3600),s=Math.floor(t%3600/60),e=t%60;if(o>0)return`${o}:${s.toString().padStart(2,"0")}:${e.toString().padStart(2,"0")}`;if(s>0)return`${s}:${e.toString().padStart(2,"0")}`;return e.toString()};var w=(r)=>{let t=Math.floor(r/60),o=r%60;return`${t}:${o.toString().padStart(2,"0")}`};var I=(r)=>new Promise((t)=>setTimeout(t,r));var v=(r)=>{return r=r.trim(),n(r).join("-").toLowerCase()};var k=(r)=>{return r=r.trim(),n(r).map(i).join("")};var y=(r)=>{return r=r.trim(),n(r).map((o)=>o.toLowerCase()).join("_")};export{p as trim,y as toSnakeCase,k as toPascalCase,v as toKebabCase,c as toCamelCase,n as splitToWords,I as sleep,w as secondsToMS,N as secondsToHMS,F as random,m as parseString,h as parseEnvVars,S as millisecondsToHMS,d as formatRelativeNumber,u as dataURLtoFile,i as capitalizeWord};
+var i=(r)=>r?r[0]?.toUpperCase()+r.slice(1).toLowerCase():r;var u=(r,t)=>{let o=r.split(","),s=o[0]?.match(/:(.*?);/)?.[1]||"",g=atob(o[1]),a=g.length,f=new Uint8Array(a);while(a--)f[a]=g.charCodeAt(a);return new File([f],t,{type:s})};var d=(r,t)=>new Intl.NumberFormat(t?.lang??"en-GB",{notation:"compact",compactDisplay:"short",maximumFractionDigits:t?.precision??1}).format(r);var S=(r)=>{let t=Math.floor(r/1000),o=Math.floor(t/3600),e=Math.floor(t%3600/60),s=t%60;if(o>0)return`${o}:${e.toString().padStart(2,"0")}:${s.toString().padStart(2,"0")}`;if(e>0)return`${e}:${s.toString().padStart(2,"0")}`;return s.toString()};var p=(r,t=" ")=>{if([".","[","]","(",")","+","*","^","$","?","/","\\"].includes(t))t=`\\${t}`;let o=new RegExp(`^${t}+|${t}+$`,"g");return r.replace(o,"")};var m=(r)=>{if(/^[0-9]+$/.test(r))return Number.parseInt(r,10);if(/^[0-9]+[.][0-9]+$/.test(r))return Number.parseFloat(r);if(/^true$/i.test(r))return!0;if(/^false$/i.test(r))return!1;if(/^null$/i.test(r))return null;if(/^\[/.test(r)&&/]$/.test(r)){let o=p(r,"\\[|\\]").split(/, */);return o=o.map((e)=>m(e)),o}try{let t=JSON.parse(r);if(t===Number.POSITIVE_INFINITY||t===Number.NEGATIVE_INFINITY)return r;return t}catch{return r}};var T=/\p{Lu}\p{Ll}+\p{N}+/u,b=/\p{Lu}\p{Ll}+/u,x=/\p{Lu}+\p{N}+/u,$=/\p{Lu}+(?=(\p{Lu}\p{Ll})|\P{L}|\b)/u,C=/\p{Ll}+\p{N}+/u,M=/(\p{Ll}+)/u,h=/\p{L}+/u,N=/\p{N}+/u,w=new RegExp(`${T.source}|${b.source}|${x.source}|${$.source}|${C.source}|${M.source}|${h.source}|${N.source}`,"gu"),n=(r)=>r.match(w)??[];var c=(r)=>{r=r.trim();let[t="",...o]=n(r);return[t.toLowerCase(),...o.map(i)].join("")};var F=(r)=>{let t={};for(let o in r){let e=c(o),s=m(r[o]);t[e]=s}return t};import{customAlphabet as l}from"nanoid";var v={nanoid(r){return l("1234567890abcdef",r??10)()},stringInt(r){return l("1234567890",r??10)()},nanoidFactory(r){return l("1234567890abcdef",r??10)}};var I=(r)=>{let t=Math.floor(r),o=Math.floor(t/3600),e=Math.floor(t%3600/60),s=t%60;if(o>0)return`${o}:${e.toString().padStart(2,"0")}:${s.toString().padStart(2,"0")}`;if(e>0)return`${e}:${s.toString().padStart(2,"0")}`;return s.toString()};var W=(r)=>{let t=Math.floor(r/60),o=r%60;return`${t}:${o.toString().padStart(2,"0")}`};var k=(r)=>new Promise((t)=>setTimeout(t,r));var y=(r)=>{return r=r.trim(),n(r).join("-").toLowerCase()};var R=(r)=>{return r=r.trim(),n(r).map(i).join("")};var z=(r)=>{return r=r.trim(),n(r).map((o)=>o.toLowerCase()).join("_")};export{p as trim,z as toSnakeCase,R as toPascalCase,y as toKebabCase,c as toCamelCase,n as splitToWords,k as sleep,W as secondsToMS,I as secondsToHMS,v as random,m as parseString,F as parseEnvVars,S as millisecondsToHMS,d as formatRelativeNumber,u as dataURLtoFile,i as capitalizeWord};
 
-//# debugId=4BD1C3DDAD8FB3AF64756E2164756E21
+//# debugId=5E119ED4001884A964756E2164756E21

package/dist/index.js.map

@@ -3,12 +3,12 @@
   "sources": ["src/capitalizeWord.ts", "src/dataURLtoFile.ts", "src/formatRelativeNumber.ts", "src/millisecondsToHMS.ts", "src/trim.ts", "src/parseString.ts", "src/splitToWords.ts", "src/toCamelCase.ts", "src/parseEnvVars.ts", "src/random.ts", "src/secondsToHMS.ts", "src/secondsToMS.ts", "src/sleep.ts", "src/toKebabCase.ts", "src/toPascalCase.ts", "src/toSnakeCase.ts"],
   "sourcesContent": [
     "export const capitalizeWord = (word: string): string =>\n  word ? word[0]?.toUpperCase() + word.slice(1).toLowerCase() : word;\n",
-    "export const dataURLtoFile = (dataurl: string, filename: string): File => {\n  const arr = dataurl.split(\",\");\n  const mimeMatch = arr[0]?.match(/:(.*?);/);\n  const mime = mimeMatch?.[1] || \"\";\n  const bstr = atob(arr[1] as string);\n  let n = bstr.length;\n  const u8arr = new Uint8Array(n);\n  while (n--) {\n    u8arr[n] = bstr.charCodeAt(n);\n  }\n  return new File([u8arr], filename, { type: mime });\n};\n",
+    "export const dataURLtoFile = (dataUrl: string, filename: string): File => {\n  const arr = dataUrl.split(\",\");\n  const mimeMatch = arr[0]?.match(/:(.*?);/);\n  const mime = mimeMatch?.[1] || \"\";\n  const bstr = atob(arr[1] as string);\n  let n = bstr.length;\n  const u8arr = new Uint8Array(n);\n  while (n--) {\n    u8arr[n] = bstr.charCodeAt(n);\n  }\n  return new File([u8arr], filename, { type: mime });\n};\n",
     "export const formatRelativeNumber = (num: number, config?: { precision?: number; lang?: string }): string =>\n  new Intl.NumberFormat(config?.lang ?? \"en-GB\", {\n    notation: \"compact\",\n    compactDisplay: \"short\",\n    maximumFractionDigits: config?.precision ?? 1,\n  }).format(num);\n",
     "export const millisecondsToHMS = (ms: number): string => {\n  const totalSeconds = Math.floor(ms / 1000);\n  const hours = Math.floor(totalSeconds / 3600);\n  const minutes = Math.floor((totalSeconds % 3600) / 60);\n  const seconds = totalSeconds % 60;\n\n  if (hours > 0) {\n    return `${hours}:${minutes.toString().padStart(2, \"0\")}:${seconds.toString().padStart(2, \"0\")}`;\n  }\n\n  if (minutes > 0) {\n    return `${minutes}:${seconds.toString().padStart(2, \"0\")}`;\n  }\n\n  return seconds.toString();\n};\n",
     "export const trim = (text: string, char = \" \"): string => {\n  if ([\".\", \"[\", \"]\", \"(\", \")\", \"+\", \"*\", \"^\", \"$\", \"?\", \"/\", \"\\\\\"].includes(char)) {\n    char = `\\\\${char}`;\n  }\n\n  const reg = new RegExp(`^${char}+|${char}+$`, \"g\");\n  return text.replace(reg, \"\");\n};\n",
     "import { trim } from \"./trim\";\n\nexport const parseString = <T = unknown>(text: string): T => {\n  if (/^[0-9]+$/.test(text)) {\n    return Number.parseInt(text, 10) as T;\n  }\n\n  if (/^[0-9]+[.][0-9]+$/.test(text)) {\n    return Number.parseFloat(text) as T;\n  }\n\n  if (/^true$/i.test(text)) {\n    return true as T;\n  }\n\n  if (/^false$/i.test(text)) {\n    return false as T;\n  }\n\n  if (/^null$/i.test(text)) {\n    return null as T;\n  }\n\n  if (/^\\[/.test(text) && /]$/.test(text)) {\n    const trimmedText = trim(text, \"\\\\[|\\\\]\");\n\n    let values: unknown[] = trimmedText.split(/, */);\n\n    values = values.map((value) => parseString(value as string));\n\n    return values as T;\n  }\n\n  try {\n    const result = JSON.parse(text);\n\n    if (result === Number.POSITIVE_INFINITY || result === Number.NEGATIVE_INFINITY) {\n      return text as T;\n    }\n\n    return result;\n  } catch {\n    return text as T;\n  }\n};\n",
-    "const CAPITALIZED_WORD_REGEXP = /\\p{Lu}\\p{Ll}+/u; // e.g. Apple\nconst ACRONYM_REGEXP = /\\p{Lu}+(?=(\\p{Lu}\\p{Ll})|\\P{L}|\\b)/u; // e.g. ID, URL, handles an acronym followed by a capitalized word e.g. HTMLElement\nconst LOWERCASED_WORD_REGEXP = /(\\p{Ll}+)/u; // e.g. apple\nconst ANY_LETTERS = /\\p{L}+/u; // will match any sequence of letters, including in languages without a concept of upper/lower case\nconst DIGITS_REGEXP = /\\p{N}+/u; // e.g. 123\n\nconst WORD_OR_NUMBER_REGEXP = new RegExp(\n  `${CAPITALIZED_WORD_REGEXP.source}|${ACRONYM_REGEXP.source}|${LOWERCASED_WORD_REGEXP.source}|${ANY_LETTERS.source}|${DIGITS_REGEXP.source}`,\n  \"gu\",\n);\n\nexport const splitToWords = (input: string): string[] => input.match(WORD_OR_NUMBER_REGEXP) ?? [];\n",
+    "const CAPITALIZED_WORD_WITH_DIGITS_REGEXP = /\\p{Lu}\\p{Ll}+\\p{N}+/u; // e.g. Apple123\nconst CAPITALIZED_WORD_REGEXP = /\\p{Lu}\\p{Ll}+/u; // e.g. Apple\nconst ACRONYM_WITH_DIGITS_REGEXP = /\\p{Lu}+\\p{N}+/u; // e.g. ID1, URL2\nconst ACRONYM_REGEXP = /\\p{Lu}+(?=(\\p{Lu}\\p{Ll})|\\P{L}|\\b)/u; // e.g. ID, URL, handles an acronym followed by a capitalized word e.g. HTMLElement\nconst LOWERCASED_WORD_WITH_DIGITS_REGEXP = /\\p{Ll}+\\p{N}+/u; // e.g. v1, abc123\nconst LOWERCASED_WORD_REGEXP = /(\\p{Ll}+)/u; // e.g. apple\nconst ANY_LETTERS = /\\p{L}+/u; // will match any sequence of letters, including in languages without a concept of upper/lower case\nconst DIGITS_REGEXP = /\\p{N}+/u; // e.g. 123\n\nconst WORD_OR_NUMBER_REGEXP = new RegExp(\n  `${CAPITALIZED_WORD_WITH_DIGITS_REGEXP.source}|${CAPITALIZED_WORD_REGEXP.source}|${ACRONYM_WITH_DIGITS_REGEXP.source}|${ACRONYM_REGEXP.source}|${LOWERCASED_WORD_WITH_DIGITS_REGEXP.source}|${LOWERCASED_WORD_REGEXP.source}|${ANY_LETTERS.source}|${DIGITS_REGEXP.source}`,\n  \"gu\",\n);\n\nexport const splitToWords = (input: string): string[] => input.match(WORD_OR_NUMBER_REGEXP) ?? [];\n",
     "import { capitalizeWord } from \"./capitalizeWord\";\nimport { splitToWords } from \"./splitToWords\";\n\nexport const toCamelCase = (input: string): string => {\n  input = input.trim();\n  const [first = \"\", ...rest] = splitToWords(input);\n  return [first.toLowerCase(), ...rest.map(capitalizeWord)].join(\"\");\n};\n",
     "import { parseString } from \"./parseString\";\nimport { toCamelCase } from \"./toCamelCase\";\n\nexport const parseEnvVars = <T = Record<string, string>>(envs: Record<string, string>): T => {\n  const vars: Record<string, string> = {};\n\n  for (const key in envs) {\n    const k = toCamelCase(key);\n    const value = parseString(envs[key] as string) as string;\n    vars[k] = value;\n  }\n\n  return vars as T;\n};\n",
     "import { customAlphabet } from \"nanoid\";\n\nexport const random = {\n  nanoid(size?: number): string {\n    return customAlphabet(\"1234567890abcdef\", size ?? 10)();\n  },\n  stringInt(size?: number): string {\n    return customAlphabet(\"1234567890\", size ?? 10)();\n  },\n  nanoidFactory(size?: number): (size?: number) => string {\n    return customAlphabet(\"1234567890abcdef\", size ?? 10);\n  },\n};\n",
@@ -19,7 +19,7 @@
     "import { capitalizeWord } from \"./capitalizeWord\";\nimport { splitToWords } from \"./splitToWords\";\n\nexport const toPascalCase = (input: string): string => {\n  input = input.trim();\n  return splitToWords(input).map(capitalizeWord).join(\"\");\n};\n",
     "import { splitToWords } from \"./splitToWords\";\n\nexport const toSnakeCase = (input: string): string => {\n  input = input.trim();\n  const words = splitToWords(input);\n  return words.map((word) => word.toLowerCase()).join(\"_\");\n};\n"
   ],
-  "mappings": "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",
-  "debugId": "4BD1C3DDAD8FB3AF64756E2164756E21",
+  "mappings": "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",
+  "debugId": "5E119ED4001884A964756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ooneex/utils",
-  "description": "Common utility functions including unique ID generation with nanoid and helper methods",
-  "version": "0.1.0",
+  "description": "General-purpose utility functions including unique ID generation with nanoid, type guards, and common helper methods",
+  "version": "0.2.1",
   "type": "module",
   "files": [
     "dist",
@@ -25,10 +25,20 @@
     "test": "bun test tests",
     "build": "bunup",
     "lint": "tsgo --noEmit && bunx biome lint",
-    "publish": "bun publish --tolerate-republish --access public"
+    "npm:publish": "bun publish --tolerate-republish --force --production --access public"
   },
   "dependencies": {
     "nanoid": "^5.1.6"
   },
-  "devDependencies": {}
+  "devDependencies": {},
+  "keywords": [
+    "bun",
+    "helpers",
+    "nanoid",
+    "ooneex",
+    "tools",
+    "typescript",
+    "utilities",
+    "utils"
+  ]
 }