afroicons-ui 0.0.0-stage → 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 THAFAM HOLDING SARL and Afroicons contributors
+
+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

@@ -1,3 +1,37 @@
-# Temporary Holding Version
+# afroicons-ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Les icônes d'interface [Afroicons](https://afroicons.org), **compatibles `lucide-react`** : mêmes noms de composants, mêmes props.
+
+```bash
+npm install afroicons-ui lucide-react
+```
+
+```diff
+- import { Plus, Wallet, ShoppingCart } from "lucide-react";
++ import { Plus, Wallet, ShoppingCart } from "afroicons-ui";
+```
+
+Ou, sans toucher aux imports, avec un alias (Vite) :
+
+```js
+// vite.config.js
+resolve: { alias: { "lucide-react": "afroicons-ui" } }
+```
+
+Avec l'alias, `afroicons-ui` doit lui-même pouvoir importer le vrai `lucide-react`. Préférez donc le remplacement des imports, ou un alias limité à votre code source.
+
+## Ce qui change
+
+- **163 icônes redessinées** (les plus utilisées par NAFA ERP : priorités P1 et P2) : trait 1,75 arrondi, grille 24 × 24.
+- **18 métaphores africaines** : `Home` → la case, `ShoppingCart` → le panier tressé, `Store` → la boutique de quartier, `Wallet` → un portefeuille fermé par un cauri, `DollarSign` → le cauri, `Truck` → la moto de livraison, `Bus` → le taxi-brousse, `BedDouble` → le lit sous moustiquaire, `Shirt` → le dashiki, `UtensilsCrossed` → la marmite, `Fuel` → le bidon, `Users` → deux personnes dont une coiffée d'un gele, `Globe` → un globe centré sur l'Afrique, `ShoppingBag` → le sac de marché en raphia tressé…
+- **Toutes les autres** icônes Lucide restent disponibles sous leur nom : elles viennent directement de `lucide-react`.
+
+`afroiconNames` donne la liste des icônes redessinées.
+
+## Props
+
+Comme Lucide : `size` (24), `color` (`currentColor`), `strokeWidth` (**1,75** au lieu de 2), `absoluteStrokeWidth`, `className`, plus toutes les props SVG. Les classes `lucide lucide-<nom>` sont conservées, avec `afroicon` en plus. Les alias `PlusIcon` et `LucidePlus` existent aussi, et le type `LucideIcon` vient de `lucide-react`.
+
+Les SVG sont aussi fournis à part : `afroicons-ui/svg/Wallet.svg`.
+
+Licence MIT. Les icônes reprises de Lucide restent sous licence ISC.