# @binarydreams88/gf-fb-deb00001

A collection of useful string manipulation utilities for JavaScript/TypeScript projects.

## Installation

```bash
npm install @binarydreams88/gf-fb-deb00001
```

## Usage

```typescript
import {
  truncate,
  toTitleCase,
  removeWhitespace,
  toKebabCase,
  isValidEmail,
  generateRandomString
} from '@binarydreams88/gf-fb-deb00001';

// Truncate a string
truncate('Hello World', 5); // Returns: 'Hello...'

// Convert to title case
toTitleCase('hello world'); // Returns: 'Hello World'

// Remove whitespace
removeWhitespace('hello world'); // Returns: 'helloworld'

// Convert to kebab case
toKebabCase('helloWorld'); // Returns: 'hello-world'

// Validate email
isValidEmail('test@example.com'); // Returns: true

// Generate random string
generateRandomString(10); // Returns: random 10-character string
```

## API

### `truncate(str: string, length: number): string`
Truncates a string to a specified length and adds an ellipsis if truncated.

### `toTitleCase(str: string): string`
Converts a string to title case (e.g., "hello world" → "Hello World").

### `removeWhitespace(str: string): string`
Removes all whitespace from a string.

### `toKebabCase(str: string): string`
Converts a string to kebab case (e.g., "helloWorld" → "hello-world").

### `isValidEmail(email: string): boolean`
Checks if a string is a valid email address.

### `generateRandomString(length: number): string`
Generates a random string of specified length.

## License

MIT