Section Bibliothèques

La section Bibliothèques vous permet de développer une bibliothèque partagée en local et de la voir dans les micros qui la consomment, sans la publier dans un registre. MicroLab construit son artefact et le lie sur le node_modules de chaque consommateur. Aujourd’hui, elle prend en charge les bibliothèques npm.

C’est une section avec un pattern liste + détail (comme Micros) : sur le côté, le catalogue de bibliothèques ; au centre, le détail éditable de celle sélectionnée.

Ajouter une bibliothèque

Depuis le bouton d’ajout (barre supérieure) —également proposé dans le fond vide de la section quand il n’y en a pas encore— :

• Ajouter une bibliothèque — vous choisissez le dossier du dépôt de la bibliothèque.
• Importer depuis Git — clone le dépôt et l’ajoute, en déduisant le nom du paquet de son package.json.

Le détail d’une bibliothèque

Identité et recette de build. Elle s’enregistre toute seule (autosave avec un léger délai, comme dans Micros ; ça peut être désactivé dans Paramètres) :

• Nom et Paquet (le nom du paquet npm qu’elle produit).
• Build — la commande qui construit l’artefact (dist) et le chemin de l’artefact. Si vous ne les déclarez pas, ceux du profil npm sont utilisés : npm run build, avec dist sous le dernier segment du paquet.
• Consommateurs — les micros qui utilisent la bibliothèque. Par défaut, ils sont détectés tout seuls en cherchant qui déclare ce paquet ; vous pouvez les fixer à la main (ids de micros séparés par des virgules).
• Surveiller les changements — reconstruit et relie automatiquement à chaque modification du code.

État et actions

Par bibliothèque :

Action	Ce qu’elle fait
Construire	Génère l’artefact (dist).
Lier	Copie l’artefact sur le node_modules/<paquet> de chaque consommateur (écrase la version du registre).
Délier	Restaure la version d’origine de chaque consommateur.
Surveiller	Fait construire + lier à chaud à chaque changement. Nécessite le moteur actif.

L’état de chaque bibliothèque (construite / non construite, liée dans N consommateurs, en surveillance) est affiché dans la liste et dans le détail.

Dépôt (Git)

Comme dans Micros, le détail d’une bibliothèque inclut son Git : changer de branche, faire fetch et pull (--ff-only). L’accès est en lecture seule (ne fait jamais de push), et s’il y a des changements non validés, MicroLab prévient avant de changer de branche ou de mettre à jour.

Si le dépôt n’est pas sur le disque

Si le dossier d’une bibliothèque a été déplacé, le détail le marque et propose de relocaliser : vous choisissez le nouveau dossier et le chemin est enregistré.

Non invasif

Le lien ne touche que node_modules (qui est hors de Git) et se révertit à la déliaison ou avec un npm ci : MicroLab ne modifie pas le dépôt du consommateur ni celui de la bibliothèque.

Supprimer une bibliothèque du catalogue ne la délie pas : si elle était liée, déliez-la d’abord depuis le détail.

Depuis le CLI et le MCP

microlab library list/status/build/link/unlink/watch. Les lectures seules (library_list, library_status) sont aussi disponibles comme outils du MCP.

Voir aussi

• Section Micros · L’espace de travail et .microlab/