@abdokouta/react-support 1.1.0 → 2.0.0

package/CHANGELOG.md

@@ -2,6 +2,40 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.0.0] - 2026-04-05
+
+### Stable Release
+
+- First production-grade stable release
+- All features from previous versions are now considered stable and production-ready
+- API is now stabilized — breaking changes will follow semver from this point forward
+
+## [1.2.0] - 2026-04-05
+
+### Refactored
+
+- Centralized all types and interfaces into `src/types/` with `.type.ts`
+  convention
+- Extracted utility functions into `src/utils/` with `.util.ts` convention
+- Moved `MultipleInstanceManager` into `src/managers/` module
+- Removed `RegistryCollection` adapter — `BaseRegistry` now uses `MapCollection`
+  directly
+- Switched all internal imports to `@/*` path aliases
+- Removed facade source files (types extracted to `src/types/`)
+- Updated root barrel to only export types from `src/types/`
+
+### Fixed
+
+- Added `ES2020` and `DOM` libs to tsconfig for `Map`, `URL`, `Buffer`, and
+  `btoa` support
+- Added `node` to tsconfig types for Node.js globals
+- Fixed strict null checks in `Str.pluralStudly` and `Str.replaceArray`
+
+### Changed
+
+- Migrated ESLint config from JS to TypeScript
+- Added `.prettierrc.ts` configuration
+
 ## [1.0.0] - 2024-03-31
 
 ### Added

package/README.md

@@ -1,58 +1,79 @@
-# @abdokouta/support
+<p align="center">
+  <img src="https://raw.githubusercontent.com/pixielity-inc/react-support/main/assets/banner.svg" alt="@abdokouta/react-support" width="100%" />
+</p>
 
-Laravel-style utilities for JavaScript/TypeScript. Provides powerful string manipulation, collection handling, and registry patterns inspired by Laravel's support package.
+<h1 align="center">@abdokouta/react-support</h1>
 
-## Features
+<p align="center">
+  <strong>Laravel-style utilities for JavaScript/TypeScript</strong>
+</p>
 
-- 🎯 **Str Class**: 100+ string manipulation methods matching Laravel's API
-- 📦 **Collection**: Array collection with 50+ chainable methods (powered by collect.js)
-- 🗺️ **MapCollection**: Map data structure with collection methods
-- 🎲 **SetCollection**: Set data structure with collection methods
-- 🏗️ **BaseRegistry**: Generic registry pattern for building extensible systems
-- 💪 **TypeScript**: Full type safety with comprehensive type definitions
-- 🔗 **Chainable**: Fluent, chainable API for elegant code
-- 🚀 **Zero Config**: Works out of the box
+<p align="center">
+  <a href="https://www.npmjs.com/package/@abdokouta/react-support"><img src="https://img.shields.io/npm/v/@abdokouta/react-support.svg?style=flat-square" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@abdokouta/react-support"><img src="https://img.shields.io/npm/dm/@abdokouta/react-support.svg?style=flat-square" alt="npm downloads" /></a>
+  <a href="https://github.com/pixielity-inc/react-support/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@abdokouta/react-support.svg?style=flat-square" alt="license" /></a>
+  <a href="https://github.com/pixielity-inc/react-support"><img src="https://img.shields.io/github/stars/pixielity-inc/react-support?style=flat-square" alt="GitHub stars" /></a>
+</p>
 
-## Installation
+<p align="center">
+  Powerful string manipulation, collection handling, facades, and registry patterns inspired by Laravel
+</p>
+
+---
+
+## ✨ Features
+
+- 🎯 **Str Class** - 100+ string manipulation methods matching Laravel's API
+- 📦 **Collection** - Array collection with 50+ chainable methods (powered by
+  collect.js)
+- 🗺️ **MapCollection** - Map data structure with collection methods
+- 🎲 **SetCollection** - Set data structure with collection methods
+- 🏗️ **BaseRegistry** - Generic registry pattern for building extensible systems
+- 🎭 **Facades** - Laravel-style facades for clean service access
+- 💪 **TypeScript** - Full type safety with comprehensive type definitions
+- 🔗 **Chainable** - Fluent, chainable API for elegant code
+- 🚀 **Zero Config** - Works out of the box
+
+## 📦 Installation
 
 ```bash
-npm install @abdokouta/support
+npm install @abdokouta/react-support
 # or
-pnpm add @abdokouta/support
+pnpm add @abdokouta/react-support
 # or
-yarn add @abdokouta/support
+yarn add @abdokouta/react-support
 ```
 
-## Usage
+## 🚀 Usage
 
 ### Str Class
 
 ```typescript
-import { Str } from '@abdokouta/support';
+import { Str } from '@abdokouta/react-support';
 
 // String manipulation
-Str.camel('foo_bar');                    // 'fooBar'
-Str.snake('fooBar');                     // 'foo_bar'
-Str.kebab('fooBar');                     // 'foo-bar'
-Str.studly('foo_bar');                   // 'FooBar'
-Str.title('a nice title');               // 'A Nice Title'
+Str.camel('foo_bar'); // 'fooBar'
+Str.snake('fooBar'); // 'foo_bar'
+Str.kebab('fooBar'); // 'foo-bar'
+Str.studly('foo_bar'); // 'FooBar'
+Str.title('a nice title'); // 'A Nice Title'
 
 // String inspection
-Str.contains('This is my name', 'my');   // true
-Str.startsWith('Hello World', 'Hello');  // true
-Str.endsWith('Hello World', 'World');    // true
-Str.isJson('{"key": "value"}');          // true
-Str.isUrl('https://example.com');        // true
+Str.contains('This is my name', 'my'); // true
+Str.startsWith('Hello World', 'Hello'); // true
+Str.endsWith('Hello World', 'World'); // true
+Str.isJson('{"key": "value"}'); // true
+Str.isUrl('https://example.com'); // true
 Str.isUuid('a0a2a2d2-0b87-4a18-83f2-2529882be2de'); // true
 
 // String extraction
 Str.after('This is my name', 'This is'); // ' my name'
-Str.before('This is my name', 'my');     // 'This is '
+Str.before('This is my name', 'my'); // 'This is '
 Str.between('This is my name', 'This', 'name'); // ' is my '
 
 // String modification
-Str.limit('The quick brown fox', 10);    // 'The quick...'
-Str.slug('Laravel 5 Framework', '-');    // 'laravel-5-framework'
+Str.limit('The quick brown fox', 10); // 'The quick...'
+Str.slug('Laravel 5 Framework', '-'); // 'laravel-5-framework'
 
 // And 80+ more methods!
 ```
@@ -60,65 +81,82 @@ Str.slug('Laravel 5 Framework', '-');    // 'laravel-5-framework'
 ### Collection (Array)
 
 ```typescript
-import { collect } from '@abdokouta/support';
+import { collect } from '@abdokouta/react-support';
 
 // Create a collection
 const collection = collect([1, 2, 3, 4, 5]);
 
 // Chainable methods
 collection
-  .filter(item => item > 2)
-  .map(item => item * 2)
-  .sum();  // 24
+  .filter((item) => item > 2)
+  .map((item) => item * 2)
+  .sum(); // 24
 
 // Working with objects
 const users = collect([
   { name: 'John', age: 30 },
   { name: 'Jane', age: 25 },
-  { name: 'Bob', age: 35 }
+  { name: 'Bob', age: 35 },
 ]);
 
 users.where('age', '>', 25).pluck('name').all();
 // ['John', 'Bob']
 
 // Aggregation
-collect([1, 2, 3, 4, 5]).sum();          // 15
-collect([1, 2, 3, 4, 5]).avg();          // 3
-collect([1, 2, 3, 4, 5]).max();          // 5
-collect([1, 2, 3, 4, 5]).min();          // 1
+collect([1, 2, 3, 4, 5]).sum(); // 15
+collect([1, 2, 3, 4, 5]).avg(); // 3
+collect([1, 2, 3, 4, 5]).max(); // 5
+collect([1, 2, 3, 4, 5]).min(); // 1
+```
+
+### Facades
+
+```typescript
+import { Facade, createFacade } from '@abdokouta/react-support';
+import { Container } from '@abdokouta/react-di';
+
+// Set the container for facades
+Facade.setFacadeContainer(Container.getContainer());
+
+// Create a facade for a service
+const Config = createFacade<IConfigService>('ConfigService');
+
+// Use the facade
+Config.get('app.name');
+Config.set('app.debug', true);
 ```
 
 ### MapCollection
 
 ```typescript
-import { collectMap } from '@abdokouta/support';
+import { collectMap } from '@abdokouta/react-support';
 
 const map = collectMap({ name: 'John', age: 30 });
 
 map.set('city', 'New York');
-map.get('name');                         // 'John'
-map.has('age');                          // true
-map.keys();                              // ['name', 'age', 'city']
-map.values();                            // ['John', 30, 'New York']
+map.get('name'); // 'John'
+map.has('age'); // true
+map.keys(); // ['name', 'age', 'city']
+map.values(); // ['John', 30, 'New York']
 ```
 
 ### SetCollection
 
 ```typescript
-import { collectSet } from '@abdokouta/support';
+import { collectSet } from '@abdokouta/react-support';
 
 const set1 = collectSet([1, 2, 3]);
 const set2 = collectSet([2, 3, 4]);
 
-set1.union(set2).all();                  // [1, 2, 3, 4]
-set1.intersect(set2).all();              // [2, 3]
-set1.diff(set2).all();                   // [1]
+set1.union(set2).all(); // [1, 2, 3, 4]
+set1.intersect(set2).all(); // [2, 3]
+set1.diff(set2).all(); // [1]
 ```
 
 ### BaseRegistry
 
 ```typescript
-import { BaseRegistry } from '@abdokouta/support';
+import { BaseRegistry } from '@abdokouta/react-support';
 
 // Create a typed registry
 interface Theme {
@@ -135,7 +173,7 @@ const themeRegistry = new BaseRegistry<Theme>({
   },
   afterAdd: (key, theme) => {
     console.log(`Registered theme: ${theme.name}`);
-  }
+  },
 });
 
 // Register items
@@ -148,12 +186,18 @@ const allThemes = themeRegistry.getAll();
 const hasTheme = themeRegistry.has('dark');
 ```
 
-## TypeScript Support
+## 📘 TypeScript Support
 
 Full TypeScript support with comprehensive type definitions:
 
 ```typescript
-import { Str, Collection, MapCollection, SetCollection, BaseRegistry } from '@abdokouta/support';
+import {
+  Str,
+  Collection,
+  MapCollection,
+  SetCollection,
+  BaseRegistry,
+} from '@abdokouta/react-support';
 
 // Type-safe collections
 const numbers: Collection<number> = collect([1, 2, 3]);
@@ -168,11 +212,11 @@ const tags: SetCollection<string> = collectSet(['tag1', 'tag2']);
 const registry = new BaseRegistry<MyType>();
 ```
 
-## License
+## 📄 License
 
 MIT
 
-## Credits
+## 🙏 Credits
 
 - Inspired by [Laravel](https://laravel.com)'s support package
 - Array collections powered by [collect.js](https://collect.js.org/)