FSHSP-116 docs: document the two consumption modes and refocus the root README

[LBU4SH]

FSHSP-116

FSHSP-109 a livré le mode starter (ng add, sources copiées chez le consommateur) sans qu'il apparaisse nulle part sur la page npmjs — seule documentation d'un consommateur du kit. Cette PR le documente, et corrige au passage l'orientation du README racine, qui ne disait pas comment consommer le kit du tout.

README du package (= page npmjs)

Nouvelle section « Deux modes de consommation », placée avant Installation puisqu'elle conditionne toute la suite : tableau comparatif dépendance / starter (ce qui arrive dans le dépôt, imports, styles, personnalisation, mise à jour), une phrase de recommandation, puis les commandes ng add / add / add --all / update. Une ligne indique explicitement que la suite de la page décrit le mode dépendance.

README.md et README.fr.md étant des miroirs : les deux.

Détails vérifiés dans le code des schematics plutôt que devinés :

• les sources sont copiées dans src/app/shared/components/ui/<catégorie>/<composant> (utils/component-registry.ts) ;
• en mode starter, @4sh/ui-kit reste une devDependency — seules ses peerDependencies deviennent des dependencies directes (ng-add/index.ts).

README racine : 240 → 106 lignes

Il était entièrement orienté contributeur. Deux problèmes :

1. Aucune ligne ne disait comment consommer le kit.
2. L'arborescence documentée (projects/ui-kit/, ng-package.json, public-api.ts) n'existe que dans ce dépôt : ni npm install ni ng add ne la produisent. Pour un lecteur, elle décrivait un dépôt qu'il n'a pas.

Nouvelle structure : pitch → liens (Storybook / démo / npmjs) → Stack → Using the kit in an application (les deux modes, renvoi au README du package) → Working in this repo (les commandes, renvoi à AGENTS.md) → Going further.

Supprimé : Structure, CSS class conventions, Adding a new component, Storybook — file organization, CSS variable naming, Themes & modes. Tout est déjà dans AGENTS.md (## Architecture, ### CSS / SCSS, ### Theme, brand, modes, ## Workflows, la règle ng-packagr sur les imports, le nommage des variables), qui reste la source unique des conventions — pour les humains comme pour les agents. C'est exactement cette duplication qui avait laissé le nombre d'entry points annoncé devenir faux à deux endroits sur trois.

Seule exception, déplacée plutôt que supprimée : « la sidebar Storybook est pilotée par le title, pas par l'emplacement du fichier » → AGENTS.md.

Storybook « Package npm »

Même ajout, à sa profondeur : la commande ng add et le renvoi, sans recopier le tableau. La page délègue volontairement au README du package.

Portée

Documentation seule, aucun changement de code. Le README part avec le tarball : visible sur npmjs à la prochaine publication, d'où l'entrée CHANGELOG sous [Unreleased] › Added. Le README racine, AGENTS.md et la page Storybook ne sont pas dans le tarball.

🤖 Generated with Claude Code