ts-string-lite 2.0.0 → 2.0.16

package/README.md

@@ -0,0 +1,49 @@
+# ts-string-lite
+
+Lightweight, type-safe string utility library for web developers.
+
+## Installation
+
+```bash
+npm install ts-string-lite
+```
+
+## Usage
+
+```typescript
+import { Injectable } from '@angular/core';
+import { StringUtils } from 'ts-string-lite';
+
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  constructor(private str: StringUtils) { }
+  
+  myMethod(): void {
+    this.str.slugify('Hello World');       // 'hello-world'
+    this.str.camelCase('hello world');     // 'helloWorld'
+    this.str.kebabCase('HelloWorld');      // 'hello-world'
+    this.str.pascalCase('hello world');    // 'HelloWorld'
+    this.str.truncate('Hello World', 10);  // 'Hello W...'
+    this.str.capitalize('hello');          // 'Hello'
+    this.str.titleCase('hello world');     // 'Hello World'
+    this.str.escapeHtml('<script>');       // '&lt;script&gt;'
+  }
+}
+```
+
+## Methods
+
+| Method | Description | Example |
+|--------|-------------|---------|
+| `slugify` | Convert string to URL-friendly slug | `'Hello World'` → `'hello-world'` |
+| `camelCase` | Convert to camelCase | `'hello world'` → `'helloWorld'` |
+| `kebabCase` | Convert to kebab-case | `'HelloWorld'` → `'hello-world'` |
+| `pascalCase` | Convert to PascalCase | `'hello world'` → `'HelloWorld'` |
+| `truncate` | Truncate string to length | `'Hello World', 10` → `'Hello W...'` |
+| `capitalize` | Capitalize first letter | `'hello'` → `'Hello'` |
+| `titleCase` | Convert to Title Case | `'hello world'` → `'Hello World'` |
+| `escapeHtml` | Escape HTML characters | `'<script>'` → `'&lt;script&gt;'` |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './string';

package/dist/index.js

@@ -0,0 +1 @@
+export * from './string';

package/dist/string.d.ts

@@ -0,0 +1,23 @@
+export declare class StringUtils {
+    private readonly _html_escape_map;
+    slugify(input_text: string): string;
+    truncate(input_text: string, max_length: number, suffix?: string): string;
+    capitalize(input_text: string): string;
+    titleCase(input_text: string): string;
+    camelCase(input_text: string): string;
+    kebabCase(input_text: string): string;
+    snakeCase(input_text: string): string;
+    pascalCase(input_text: string): string;
+    escapeHtml(input_text: string): string;
+    unescapeHtml(input_text: string): string;
+    repeat(input_text: string, times: number): string;
+    reverse(input_text: string): string;
+    base64Encode(input_text: string): string;
+    base64Decode(encoded: string): string;
+    randomString(length: number): string;
+    trimStart(text: string, chars?: string): string;
+    trimEnd(text: string, chars?: string): string;
+    words(text: string, delimiter?: RegExp): string[];
+    countWords(text: string): number;
+    levenshtein(a: string, b: string): number;
+}

package/dist/string.js

@@ -0,0 +1,108 @@
+export class StringUtils {
+    constructor() {
+        this._html_escape_map = {
+            '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;'
+        };
+    }
+    slugify(input_text) {
+        if (!input_text)
+            return '';
+        return input_text.toLowerCase().trim()
+            .replace(/[^\w\s-]/g, '')
+            .replace(/[\s_-]+/g, '-')
+            .replace(/^-+|-+$/g, '');
+    }
+    truncate(input_text, max_length, suffix = '...') {
+        if (!input_text || input_text.length <= max_length)
+            return input_text;
+        return input_text.slice(0, max_length - suffix.length) + suffix;
+    }
+    capitalize(input_text) {
+        if (!input_text)
+            return '';
+        return input_text.charAt(0).toUpperCase() + input_text.slice(1).toLowerCase();
+    }
+    titleCase(input_text) {
+        if (!input_text)
+            return '';
+        return input_text.replace(/\w\S*/g, (word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase());
+    }
+    camelCase(input_text) {
+        if (!input_text)
+            return '';
+        return input_text.replace(/(?:^\w|[A-Z]|\b\w)/g, (word, index) => index === 0 ? word.toLowerCase() : word.toUpperCase()).replace(/[\s_-]+/g, '');
+    }
+    kebabCase(input_text) {
+        if (!input_text)
+            return '';
+        return input_text.replace(/([a-z])([A-Z])/g, '$1-$2').replace(/[\s_]+/g, '-').toLowerCase();
+    }
+    snakeCase(input_text) {
+        if (!input_text)
+            return '';
+        return input_text.replace(/([a-z])([A-Z])/g, '$1_$2').replace(/[\s-]+/g, '_').toLowerCase();
+    }
+    pascalCase(input_text) {
+        if (!input_text)
+            return '';
+        return input_text.replace(/(?:^\w|[A-Z]|\b\w)/g, (word) => word.toUpperCase()).replace(/[\s_-]+/g, '');
+    }
+    escapeHtml(input_text) {
+        if (!input_text)
+            return '';
+        return input_text.replace(/[&<>"']/g, (m) => this._html_escape_map[m] || m);
+    }
+    unescapeHtml(input_text) {
+        if (!input_text)
+            return '';
+        return input_text.replace(/&(amp|lt|gt|quot|#39);/g, (m) => this._html_escape_map[m] || m);
+    }
+    repeat(input_text, times) {
+        return input_text.repeat(Math.max(0, times));
+    }
+    reverse(input_text) {
+        return input_text.split('').reverse().join('');
+    }
+    base64Encode(input_text) {
+        return btoa(unescape(encodeURIComponent(input_text)));
+    }
+    base64Decode(encoded) {
+        try {
+            return decodeURIComponent(escape(atob(encoded)));
+        }
+        catch {
+            return '';
+        }
+    }
+    randomString(length) {
+        const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+        return Array(length).fill(0).map(() => chars[Math.floor(Math.random() * chars.length)]).join('');
+    }
+    trimStart(text, chars) {
+        return chars ? text.replace(new RegExp(`^[${chars}]+`, 'g'), '') : text.trimStart();
+    }
+    trimEnd(text, chars) {
+        return chars ? text.replace(new RegExp(`[${chars}]+$`, 'g'), '') : text.trimEnd();
+    }
+    words(text, delimiter = /\s+/) {
+        return text.split(delimiter).filter(Boolean);
+    }
+    countWords(text) {
+        return this.words(text).length;
+    }
+    levenshtein(a, b) {
+        if (!a || !b)
+            return Math.max(a?.length || 0, b?.length || 0);
+        const matrix = Array(b.length + 1).fill(null).map(() => Array(a.length + 1).fill(0));
+        for (let i = 0; i <= a.length; i++)
+            matrix[0][i] = i;
+        for (let j = 0; j <= b.length; j++)
+            matrix[j][0] = j;
+        for (let j = 1; j <= b.length; j++) {
+            for (let i = 1; i <= a.length; i++) {
+                matrix[j][i] = Math.min(matrix[j][i - 1] + 1, matrix[j - 1][i] + 1, matrix[j - 1][i - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+            }
+        }
+        return matrix[b.length][a.length];
+    }
+}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "ts-string-lite",
-  "version": "2.0.0",
+  "version": "2.0.16",
+  "deprecated": "Previous versions are deprecated. Please upgrade to 2.0.15 or later.",
   "description": "Lightweight, type-safe string utility library for web developers",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -26,5 +27,9 @@
     "lite"
   ],
   "author": "Gaurang Mody - G8X",
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gbmrocks/ts-utils-lite.git"
+  }
 }