FSHSP-121 Sources copiées autonomes, arborescence à plat, installation en une commande

[LBU4SH]

Trois tickets liés, inséparables techniquement : la réécriture des imports a besoin des chemins cibles définitifs, et l'arborescence a besoin de la porte d'entrée finale.

Ticket	Objet
FSHSP-119	Bug — les sources copiées importaient depuis node_modules
FSHSP-121	Arborescence aplatie, non-composants sortis de components/
FSHSP-122	Installation en une commande, sans installer le kit

Le bug d'origine

Un composant copié résolvait ses dépendances dans node_modules/@4sh/ui-kit, c'est-à-dire le code compilé. Modifier le ui-icon copié n'avait donc aucun effet sur les composants qui l'utilisent : le modèle « les sources t'appartiennent », seule raison d'être du starter, était annulé. 139 imports concernés.

Trois effets de bord partaient avec : les dépendances copiées n'étaient utilisées par personne (copies mortes, suivies par update pour rien), le bundle embarquait chaque composant deux fois, et du code applicatif dépendait d'une devDependency — cassant en npm ci --omit=dev.

Ce que ça donne

ng add @4sh/ui-kit-schematics

Une commande : fondation, puis sélection interactive des composants, puis npm install.

src/app/shared/
├── components/ui/{catégorie}/{ui-nom}/{ui-nom}.ts   ← uniquement des composants
└── ui-core/{forms|motion|overlay|theming|types}/    ← directives de base, services, utilitaires, types

Les src/lib/ et les barrels public-api.ts disparaissent : ce sont des artefacts de publication ng-packagr, sans objet une fois le fichier chez le consommateur.

@4sh/ui-kit n'entre jamais dans node_modules sur ce parcours — c'est ce qui empêche l'auto-complétion de l'IDE de proposer son code compilé à la place des copies locales. Le mode librairie (npm i @4sh/ui-kit) est inchangé ; chaque README documente son mode et pointe vers l'autre.

Ruptures pour un projet déjà en 0.2.0

• Les chemins des fichiers copiés changent tous : update ne reconnaîtra pas les anciens. Déplacer les fichiers, ou repartir d'un add propre.
• npm rm @4sh/ui-kit : les sources copiées n'en dépendent plus.

Le bump en 0.3.0 n'est pas dans cette PR — les entrées sont sous ## [Unreleased], conformément à docs/VERSIONING.md.

Vérifications

Sonde sur les 58 unités, 196 fichiers rendus : 0 import @4sh/ui-kit résiduel, 0 barrel, 0 chemin src/lib/.

Parcours complet sur un projet Angular 22 neuf, ng build lancé sans npm install intercalé :

• @angular/cdk, fontawesome et style-dictionary installés par le schematic
• @4sh/ui-kit absent de package.json et de node_modules
• build vert ; le bundle passe de 216 à 247 kB dès qu'on utilise deux composants copiés, donc templates et SCSS compilent bien depuis les sources locales
• --skip-install fait l'inverse, vérifié
• update répond « Rien à mettre à jour » sur un projet à jour

L'import groupé dont les symboles sont dispersés est scindé :

import { UiIcon } from '../../base/ui-icon/ui-icon';
import { UiIconType } from '../../base/ui-icon/ui-icon-families';

Revue

Une passe de revue a trouvé cinq problèmes, tous corrigés dans les deux derniers commits. Le sérieux : en vidant la façade du kit, j'avais supprimé le seul NodePackageInstallTask du dépôt, laissant ng add produire un projet qui ne compilait pas (Could not resolve sur les CSS de CDK et FontAwesome). Ma vérification initiale le masquait en lançant npm install entre le schematic et le build.

Les quatre autres : skipInstall déclaré mais ignoré ; endsWith('public-api.ts') qui écartait silencieusement un *-public-api.ts légitime ; une collision d'aplatissement qui écrasait sans un mot ; et du code mort.

🤖 Generated with Claude Code