ts-id-lite 0.0.2 → 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gaurang Mody
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,201 @@
+# ngx-utils-lite
+
+Everything you need, nothing you don't.
+
+## Features
+
+- **String Utils** - slugify, camelCase, kebabCase, pascalCase, truncate, capitalize, titleCase, escapeHtml
+- **Date Utils** - format, relative time, isToday, add, diff
+- **Array Utils** - unique, chunk, groupBy, shuffle, compact
+- **Object Utils** - deepGet, deepClone, merge, omit, pick, isEmpty
+- **Number Utils** - formatCurrency, formatBytes, formatPercent, clamp, round, randomInt
+- **Validation Utils** - isEmail, isUrl, isPhone, isPostalCode, isStrongPassword
+- **ID Utils** - uuid, nanoid, shortId, hash, snowflake, generateCode
+- **Cookie Utils** - get, set, delete, has
+- **Copy to Clipboard** - Directive to copy text to clipboard on click
+
+## Installation
+
+```bash
+npm install ngx-utils-lite
+```
+
+## Usage
+
+### String Utils
+
+```typescript
+import { Injectable } from '@angular/core';
+import { NgxStringUtils } from 'ngx-utils-lite';
+
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  constructor(private str: NgxStringUtils) { }
+  
+  myMethod(): void {
+    this.str.slugify('Hello World');       // 'hello-world'
+    this.str.camelCase('hello world');     // 'helloWorld'
+    this.str.truncate('Hello World', 10);  // 'Hello W...'
+  }
+}
+```
+
+### Date Utils
+
+```typescript
+import { Injectable } from '@angular/core';
+import { NgxDateUtils } from 'ngx-utils-lite';
+
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  constructor(private date: NgxDateUtils) { }
+  
+  myMethod(): void {
+    this.date.format(new Date(), 'YYYY-MM-DD');              // '2026-04-11'
+    this.date.relative(new Date(Date.now() - 3600000));      // '1 hour ago'
+    this.date.add(new Date(), 7, 'day');                     // +7 days
+  }
+}
+```
+
+### Array Utils
+
+```typescript
+import { Injectable } from '@angular/core';
+import { NgxArrayUtils } from 'ngx-utils-lite';
+
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  constructor(private arr: NgxArrayUtils) { }
+  
+  myMethod(): void {
+    this.arr.unique([1, 2, 2, 3]);                           // [1, 2, 3]
+    this.arr.chunk([1, 2, 3, 4], 2);                         // [[1,2], [3,4]]
+    this.arr.groupBy(['apple', 'banana'], s => s[0]);       // {a: ['apple'], b: ['banana']}
+  }
+}
+```
+
+### Object Utils
+
+```typescript
+import { Injectable } from '@angular/core';
+import { NgxObjectUtils } from 'ngx-utils-lite';
+
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  constructor(private obj: NgxObjectUtils) { }
+  
+  myMethod(): void {
+    this.obj.deepGet({a: {b: 42}}, 'a.b');    // 42
+    this.obj.deepClone({a: 1});               // {a: 1}
+    this.obj.merge({a: 1}, {b: 2});           // {a: 1, b: 2}
+  }
+}
+```
+
+### Number Utils
+
+```typescript
+import { Injectable } from '@angular/core';
+import { NgxNumberUtils } from 'ngx-utils-lite';
+
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  constructor(private num: NgxNumberUtils) { }
+  
+  myMethod(): void {
+    this.num.formatCurrency(1234.56);         // '$1,234.56'
+    this.num.formatBytes(1048576);            // '1 MB'
+    this.num.formatPercent(0.756);           // '75.6%'
+  }
+}
+```
+
+### Validation Utils
+
+```typescript
+import { Injectable } from '@angular/core';
+import { NgxValidationUtils } from 'ngx-utils-lite';
+
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  constructor(private val: NgxValidationUtils) { }
+  
+  myMethod(): void {
+    this.val.isEmail('test@example.com');    // true
+    this.val.isUrl('https://google.com');     // true
+    this.val.isStrongPassword('Test123!');    // {valid: true, score: 4}
+  }
+}
+```
+
+### ID Utils
+
+```typescript
+import { Injectable } from '@angular/core';
+import { NgxIdUtils } from 'ngx-utils-lite';
+
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  constructor(private id: NgxIdUtils) { }
+  
+  myMethod(): void {
+    this.id.uuid();                // '550e8400-e29b-41d4-a716-446655440000'
+    this.id.nanoid();              // 'V1StGXR8_Z'
+    this.id.generateCode(6, 'numeric');  // '482931'
+  }
+}
+```
+
+### Cookie Utils
+
+```typescript
+import { Injectable } from '@angular/core';
+import { NgxCookieUtils } from 'ngx-utils-lite';
+
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  constructor(private cookie: NgxCookieUtils) { }
+  
+  myMethod(): void {
+    this.cookie.set('theme', 'dark', 7);      // Set cookie for 7 days
+    const theme = this.cookie.get('theme');  // Get cookie
+    const has = this.cookie.has('theme');     // Check if exists
+    this.cookie.delete('theme');              // Delete cookie
+  }
+}
+```
+
+### Copy to Clipboard Directive
+
+```typescript
+import { Component } from '@angular/core';
+import { NgxCopyToClipboardDirective } from 'ngx-utils-lite';
+
+@Component({
+  selector: 'app-my-component',
+  standalone: true,
+  imports: [NgxCopyToClipboardDirective],
+  template: `
+    <input [(ngModel)]="text" placeholder="Enter text" />
+    <button [ngxCopyToClipboard]="text">Copy</button>
+  `
+})
+export class MyComponent {
+  text = 'Hello World';
+}
+```
+
+## Demo
+
+Visit the [demo page](http://localhost:4200/showcase) to see all utilities in action.
+
+## Compatibility
+
+- Angular 14+
+- Standalone components
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-id-lite",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Lightweight, type-safe ID generation utility library for web developers",
   "main": "./dist/index.js",
   "module": "./dist/index.js",