Sezione Librerie

La sezione Librerie ti permette di sviluppare una libreria condivisa in locale e vederla nei micro che la consumano, senza pubblicarla in un registro. MicroLab costruisce il suo artefatto e lo collega sul node_modules di ogni consumatore. Oggi supporta librerie npm.

È una sezione con pattern lista + dettaglio (come Micro): sul lato, il catalogo di librerie; al centro, il dettaglio modificabile di quella selezionata.

Aggiungere una libreria

Dal pulsante di aggiunta (barra superiore) —offerto anche nello sfondo vuoto della sezione quando non ce ne sono ancora—:

• Aggiungi libreria — scegli la cartella del repo della libreria.
• Importa da Git — clona il repo e la aggiunge, ricavando il nome del pacchetto dal suo package.json.

Il dettaglio di una libreria

Identità e ricetta di build. Si salva da sola (autosave con un piccolo ritardo, come in Micro; si può disattivare in Impostazioni):

• Nome e Pacchetto (il nome del pacchetto npm che produce).
• Build — il comando che costruisce l’artefatto (dist) e il percorso dell’artefatto. Se non li dichiari, si usa quello del profilo npm: npm run build, con dist sotto l’ultimo segmento del pacchetto.
• Consumatori — i micro che usano la libreria. Per impostazione predefinita sono rilevati da soli cercando chi dichiara quel pacchetto; puoi fissarli a mano (id di micro separati da virgola).
• Sorveglia cambiamenti — ricostruisce e ricollega automaticamente al cambiare del codice.

Stato e azioni

Per libreria:

Azione	Cosa fa
Costruisci	Genera l’artefatto (dist).
Collega	Copia l’artefatto sul node_modules/<pacchetto> di ogni consumatore (sovrascrive la versione del registro).
Scollega	Ripristina in ogni consumatore la sua versione originale.
Sorveglia	Fa costruire + collegare a caldo a ogni cambiamento. Richiede il motore attivo.

Lo stato di ogni libreria (costruita / non costruita, collegata in N consumatori, in sorveglianza) si vede nell’elenco e nel dettaglio.

Repository (Git)

Come in Micro, il dettaglio di una libreria include il suo Git: cambiare ramo, fare fetch e pull (--ff-only). L’accesso è di sola lettura (non fa mai push), e se ci sono modifiche non confermate, MicroLab avvisa prima di cambiare ramo o aggiornare.

Se il repo non è su disco

Se la cartella di una libreria è stata spostata, il dettaglio lo segnala e propone di rilocalizzare: scegli la nuova cartella e il percorso viene salvato.

Non invasivo

Il collegamento tocca solo node_modules (che è fuori da Git) e si annulla allo scollegamento o con un npm ci: MicroLab non modifica il repo del consumatore né quello della libreria.

Eliminare una libreria dal catalogo non la scollega: se era collegata, scollegala prima dal dettaglio.

Dalla CLI e dal MCP

microlab library list/status/build/link/unlink/watch. Quelle di sola lettura (library_list, library_status) sono anche disponibili come tool del MCP.

Vedi anche

• Sezione Micro · Lo spazio di lavoro e .microlab/