mochikao 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.fr.md +15 -0
  2. package/README.md +15 -0
  3. package/package.json +1 -1
package/README.fr.md CHANGED
@@ -20,6 +20,21 @@ Un visage pour chaque nom. `mochikao` transforme n'importe quelle chaîne (pseud
20
20
 
21
21
  Inspiré de [blobatar](https://blobatar.dev).
22
22
 
23
+ ## Quand l'utiliser
24
+
25
+ - **Avatars par défaut** pour les utilisateurs sans photo : donne-lui un pseudo ou un id et chaque compte a un visage, sans rien à stocker.
26
+ - **Personnes anonymes ou pseudonymes** : commentateurs, participants d'un chat ou d'un jeu multijoueur, invités, relecteurs. Chacun se reconnaît d'un coup d'œil sans révéler qui il est.
27
+ - **Maquettes et données de test** dans des listes, démos et captures d'écran, à la place des ronds gris ou des photos de banque d'images.
28
+ - **Partout où l'on ne peut pas ou ne veut pas appeler un service** : l'avatar se calcule à partir de la seule chaîne, donc il s'affiche pareil dans le navigateur, sur le serveur, en edge ou dans un script, sans requête réseau.
29
+ - **Un visage qui montre une humeur** : les 8 expressions collent à des statuts (`thinking` pendant un chargement, `sick` sur une erreur, `happy` après un succès) sans que le personnage change.
30
+ - **Un style ludique et reconnaissable** pour une communauté, un jeu ou un projet perso, quand un identicon générique paraît trop froid.
31
+
32
+ Quand **ne pas** l'utiliser :
33
+
34
+ - Il te faut une vraie photo ou une identité vérifiée. Un mochikao est un remplaçant, pas une preuve de qui est la personne.
35
+ - Il te faut une unicité garantie pour chaque utilisateur. Deux noms différents peuvent, en théorie, se ressembler.
36
+ - Choisis une **clé stable** (un id plutôt qu'un pseudo que l'utilisateur peut renommer) : si la chaîne change, le visage change.
37
+
23
38
  ## Démarrer
24
39
 
25
40
  ```bash
package/README.md CHANGED
@@ -20,6 +20,21 @@ A face for every name. `mochikao` turns any string (username, email, ID) into a
20
20
 
21
21
  Inspired by [blobatar](https://blobatar.dev).
22
22
 
23
+ ## When to use it
24
+
25
+ - **Default avatars** for users who haven't uploaded a photo: feed it a username or an ID and every account gets a face, with nothing to store.
26
+ - **Anonymous or pseudonymous people**: commenters, chat and multiplayer participants, guest users, reviewers. Each one is recognizable at a glance without revealing who they are.
27
+ - **Placeholders and seed data** in lists, mockups, demos and screenshots, instead of grey circles or stock photos.
28
+ - **Anywhere you can't or don't want to call a service**: the avatar is computed from the string alone, so it renders the same in the browser, on the server, at the edge or in a script, with no network request.
29
+ - **A face that shows a mood**: the 8 expressions fit statuses (`thinking` while loading, `sick` on an error, `happy` on success) while the character stays the same.
30
+ - **A playful, recognizable look** for a community, a game or a side project, where a generic identicon feels too cold.
31
+
32
+ When **not** to use it:
33
+
34
+ - You need a real photo or a verified identity. A mochikao is a stand-in, not proof of who someone is.
35
+ - You need every user to be guaranteed unique. Two different names can, in theory, look alike.
36
+ - Pick a **stable key** (an ID rather than a pseudonym a user can rename): change the string and the face changes.
37
+
23
38
  ## Getting started
24
39
 
25
40
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mochikao",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "Deterministic avatars: any string becomes a cute, unique SVG character. Zero dependencies, React / Vue / Svelte / Solid / web component.",
5
5
  "keywords": [
6
6
  "avatar",